docs: def flatten_items(items, recurse=False):
      """
      Expands inner lists (tuples, sets, Etc.) within items so that each extends its parent.
      If items is None or empty after filtering, the default is returned.
      If recurse is False, only the first level of items is flattened, otherwise all levels.
      """
  
      if not items:
          return items
      elif not hasattr(items, '__iter__'):
          return items
      elif isinstance(items, _flattened_types):
          return items
  
      flattened = []
      for item in items:
          if item and hasattr(item, '__iter__') and not isinstance(item, _flattened_types):
              flattened.extend(flatten_items(item, True) if recurse else item)
          else:
              flattened.append(item)
  
      return type(items)(flattened) if isinstance(items, _flatten_types) else flattened