declare function createItem<T>(data: T): ListItem<T>;
/**
 * Convenience constructor matching `csstree.List()` (callable without `new`).
 */
export declare function makeList<T>(): CssList<T>;
/**
 * Doubly linked list used as the children container for every CSS AST node.
 *
 * Mirrors css-tree's `List` so `csstree.List` import sites can switch to
 * `import { CssList as List } from '@stacksjs/ts-css/parse'` without changing
 * call sites. The list owns its `ListItem<T>` cells; items can be moved
 * between lists by detach/insert pairs.
 */
export declare interface ListItem<T> {
  prev: ListItem<T> | null
  next: ListItem<T> | null
  data: T
}
export declare class CssList<T> {
  head: ListItem<T> | null;
  tail: ListItem<T> | null;
  static createItem<U>(data: U): ListItem<U>;
  createItem(data: T): ListItem<T>;
  get isEmpty(): boolean;
  get first(): T | null;
  get last(): T | null;
  [Symbol.iterator](): Iterator<T>;
  fromArray(items: ReadonlyArray<T>): this;
  toArray(): T[];
  toJSON(): T[];
  forEach(fn: (data: T, item: ListItem<T>, list: CssList<T>) => void, thisArg?: any): void;
  forEachRight(fn: (data: T, item: ListItem<T>, list: CssList<T>) => void, thisArg?: any): void;
  reduce<U>(fn: (acc: U, data: T, index: number, list: CssList<T>) => U, initial: U): U;
  some(fn: (item: T, index: number, list: CssList<T>) => boolean): boolean;
  map<U>(fn: (item: T, index: number, list: CssList<T>) => U): CssList<U>;
  filter(fn: (item: T, index: number, list: CssList<T>) => boolean): CssList<T>;
  clear(): void;
  copy(): CssList<T>;
  prepend(item: ListItem<T>): this;
  prependData(data: T): this;
  append(item: ListItem<T>): this;
  appendData(data: T): this;
  insert(item: ListItem<T>, before?: ListItem<T> | null | undefined): this;
  insertData(data: T, before?: ListItem<T> | null): this;
  remove(item: ListItem<T>): ListItem<T>;
  push(data: T): void;
  pop(): ListItem<T> | null;
  unshift(data: T): void;
  shift(): ListItem<T> | null;
  prependList(list: CssList<T>): this;
  appendList(list: CssList<T>): this;
  insertList(list: CssList<T>, before?: ListItem<T> | null): this;
  replace(oldItem: ListItem<T>, newItemOrList: ListItem<T> | CssList<T>): void;
}