@projectwallace/css-parser 0.13.5 → 0.13.8

package/dist/css-node-DqyvMXBN.d.ts

@@ -0,0 +1,313 @@
+//#region src/arena.d.ts
+declare const STYLESHEET = 1;
+declare const STYLE_RULE = 2;
+declare const AT_RULE = 3;
+declare const DECLARATION = 4;
+declare const SELECTOR = 5;
+declare const COMMENT = 6;
+declare const BLOCK = 7;
+declare const RAW = 8;
+declare const IDENTIFIER = 10;
+declare const NUMBER = 11;
+declare const DIMENSION = 12;
+declare const STRING = 13;
+declare const HASH = 14;
+declare const FUNCTION = 15;
+declare const OPERATOR = 16;
+declare const PARENTHESIS = 17;
+declare const URL = 18;
+declare const SELECTOR_LIST = 20;
+declare const TYPE_SELECTOR = 21;
+declare const CLASS_SELECTOR = 22;
+declare const ID_SELECTOR = 23;
+declare const ATTRIBUTE_SELECTOR = 24;
+declare const PSEUDO_CLASS_SELECTOR = 25;
+declare const PSEUDO_ELEMENT_SELECTOR = 26;
+declare const COMBINATOR = 27;
+declare const UNIVERSAL_SELECTOR = 28;
+declare const NESTING_SELECTOR = 29;
+declare const NTH_SELECTOR = 30;
+declare const NTH_OF_SELECTOR = 31;
+declare const LANG_SELECTOR = 56;
+declare const MEDIA_QUERY = 32;
+declare const MEDIA_FEATURE = 33;
+declare const MEDIA_TYPE = 34;
+declare const CONTAINER_QUERY = 35;
+declare const SUPPORTS_QUERY = 36;
+declare const LAYER_NAME = 37;
+declare const PRELUDE_OPERATOR = 38;
+declare const FEATURE_RANGE = 39;
+declare const AT_RULE_PRELUDE = 40;
+declare const VALUE = 50;
+declare const FLAG_IMPORTANT: number;
+declare const ATTR_OPERATOR_NONE = 0;
+declare const ATTR_OPERATOR_EQUAL = 1;
+declare const ATTR_OPERATOR_TILDE_EQUAL = 2;
+declare const ATTR_OPERATOR_PIPE_EQUAL = 3;
+declare const ATTR_OPERATOR_CARET_EQUAL = 4;
+declare const ATTR_OPERATOR_DOLLAR_EQUAL = 5;
+declare const ATTR_OPERATOR_STAR_EQUAL = 6;
+declare const ATTR_FLAG_NONE = 0;
+declare const ATTR_FLAG_CASE_INSENSITIVE = 1;
+declare const ATTR_FLAG_CASE_SENSITIVE = 2;
+/** @internal */
+declare class CSSDataArena {
+  private buffer;
+  private view;
+  private capacity;
+  private count;
+  private growth_count;
+  private overflow_lengths;
+  private static readonly GROWTH_FACTOR;
+  private static readonly NODES_PER_KB;
+  private static readonly CAPACITY_BUFFER;
+  constructor(initial_capacity?: number);
+  static capacity_for_source(source_length: number): number;
+  get_count(): number;
+  get_capacity(): number;
+  get_growth_count(): number;
+  private node_offset;
+  get_type(node_index: number): number;
+  get_flags(node_index: number): number;
+  get_start_offset(node_index: number): number;
+  get_length(node_index: number): number;
+  get_content_start(node_index: number): number;
+  get_content_length(node_index: number): number;
+  get_attr_operator(node_index: number): number;
+  get_attr_flags(node_index: number): number;
+  get_first_child(node_index: number): number;
+  get_next_sibling(node_index: number): number;
+  get_start_line(node_index: number): number;
+  get_start_column(node_index: number): number;
+  get_value_start(node_index: number): number;
+  get_value_length(node_index: number): number;
+  set_type(node_index: number, type: number): void;
+  set_flags(node_index: number, flags: number): void;
+  set_length(node_index: number, length: number): void;
+  set_content_start_delta(node_index: number, delta: number): void;
+  set_content_length(node_index: number, length: number): void;
+  set_attr_operator(node_index: number, operator: number): void;
+  set_attr_flags(node_index: number, flags: number): void;
+  set_first_child(node_index: number, childIndex: number): void;
+  set_next_sibling(node_index: number, siblingIndex: number): void;
+  set_value_start_delta(node_index: number, delta: number): void;
+  set_value_length(node_index: number, length: number): void;
+  private grow;
+  create_node(type: number, start_offset: number, length: number, start_line: number, start_column: number): number;
+  append_children(parent_index: number, children: number[]): void;
+  has_children(node_index: number): boolean;
+  has_next_sibling(node_index: number): boolean;
+  set_flag(node_index: number, flag: number): void;
+  clear_flag(node_index: number, flag: number): void;
+  has_flag(node_index: number, flag: number): boolean;
+}
+//#endregion
+//#region src/css-node.d.ts
+declare const TYPE_NAMES: {
+  readonly 1: "StyleSheet";
+  readonly 2: "Rule";
+  readonly 3: "Atrule";
+  readonly 4: "Declaration";
+  readonly 5: "Selector";
+  readonly 6: "Comment";
+  readonly 7: "Block";
+  readonly 8: "Raw";
+  readonly 10: "Identifier";
+  readonly 11: "Number";
+  readonly 12: "Dimension";
+  readonly 13: "String";
+  readonly 14: "Hash";
+  readonly 15: "Function";
+  readonly 16: "Operator";
+  readonly 17: "Parentheses";
+  readonly 18: "Url";
+  readonly 19: "UnicodeRange";
+  readonly 50: "Value";
+  readonly 20: "SelectorList";
+  readonly 21: "TypeSelector";
+  readonly 22: "ClassSelector";
+  readonly 23: "IdSelector";
+  readonly 24: "AttributeSelector";
+  readonly 25: "PseudoClassSelector";
+  readonly 26: "PseudoElementSelector";
+  readonly 27: "Combinator";
+  readonly 28: "UniversalSelector";
+  readonly 29: "NestingSelector";
+  readonly 30: "Nth";
+  readonly 31: "NthOf";
+  readonly 56: "Lang";
+  readonly 32: "MediaQuery";
+  readonly 33: "Feature";
+  readonly 34: "MediaType";
+  readonly 35: "ContainerQuery";
+  readonly 36: "SupportsQuery";
+  readonly 37: "Layer";
+  readonly 38: "Operator";
+  readonly 39: "MediaFeatureRange";
+  readonly 40: "AtrulePrelude";
+};
+type TypeName = (typeof TYPE_NAMES)[keyof typeof TYPE_NAMES] | 'unknown';
+declare const ATTR_OPERATOR_NAMES: Record<number, string | null>;
+declare const ATTR_FLAG_NAMES: Record<number, string | null>;
+type CSSNodeType = typeof STYLESHEET | typeof STYLE_RULE | typeof AT_RULE | typeof DECLARATION | typeof SELECTOR | typeof COMMENT | typeof BLOCK | typeof RAW | typeof IDENTIFIER | typeof NUMBER | typeof DIMENSION | typeof STRING | typeof HASH | typeof FUNCTION | typeof OPERATOR | typeof PARENTHESIS | typeof URL | typeof VALUE | typeof SELECTOR_LIST | typeof TYPE_SELECTOR | typeof CLASS_SELECTOR | typeof ID_SELECTOR | typeof ATTRIBUTE_SELECTOR | typeof PSEUDO_CLASS_SELECTOR | typeof PSEUDO_ELEMENT_SELECTOR | typeof COMBINATOR | typeof UNIVERSAL_SELECTOR | typeof NESTING_SELECTOR | typeof NTH_SELECTOR | typeof NTH_OF_SELECTOR | typeof LANG_SELECTOR | typeof MEDIA_QUERY | typeof MEDIA_FEATURE | typeof MEDIA_TYPE | typeof CONTAINER_QUERY | typeof SUPPORTS_QUERY | typeof LAYER_NAME | typeof PRELUDE_OPERATOR | typeof FEATURE_RANGE | typeof AT_RULE_PRELUDE;
+interface CloneOptions {
+  /**
+   * Recursively clone all children
+   * @default true
+   */
+  deep?: boolean;
+  /**
+   * Include location information (line, column, start, length)
+   * @default false
+   */
+  locations?: boolean;
+}
+type PlainCSSNode = {
+  type: number;
+  type_name: TypeName;
+  text: string;
+  children?: PlainCSSNode[];
+  name?: string;
+  property?: string;
+  value?: PlainCSSNode | string | number | null;
+  unit?: string;
+  prelude?: PlainCSSNode | null;
+  is_important?: boolean;
+  is_vendor_prefixed?: boolean;
+  is_browserhack?: boolean;
+  has_error?: boolean;
+  attr_operator?: string | null;
+  attr_flags?: string | null;
+  nth_a?: string | null;
+  nth_b?: string | null;
+  line?: number;
+  column?: number;
+  start?: number;
+  length?: number;
+  end?: number;
+};
+declare class CSSNode {
+  private arena;
+  private source;
+  private index;
+  constructor(arena: CSSDataArena, source: string, index: number);
+  /**
+   * @internal
+   * Get the arena (for internal/advanced use only)
+   */
+  __get_arena(): CSSDataArena;
+  private get_content;
+  /** Get node type as number (for performance) */
+  get type(): CSSNodeType;
+  /** Get node type as human-readable string */
+  get type_name(): TypeName;
+  /** Get the full text of this node from source */
+  get text(): string;
+  /** Get the "content" text (at-rule name for at-rules, layer name for import layers) */
+  get name(): string | undefined;
+  /**
+   * Alias for name (for declarations: "color" in "color: blue")
+   * More semantic than `name` for declaration nodes
+   */
+  get property(): string | undefined;
+  /**
+   * Get the value text (for declarations: "blue" in "color: blue")
+   * For dimension/number nodes: returns the numeric value as a number
+   * For string nodes: returns the string content without quotes
+   * For URL nodes with quoted string: returns the string with quotes (consistent with STRING node)
+   * For URL nodes with unquoted URL: returns the URL content without quotes
+   */
+  get value(): CSSNode | string | number | null | undefined;
+  /** Get the numeric value for NUMBER and DIMENSION nodes, or null for other node types */
+  get value_as_number(): number | null;
+  /**
+   * Get the prelude node:
+   * - For at-rules: AT_RULE_PRELUDE wrapper containing structured prelude children (media queries, layer names, etc.)
+   * - For style rules: SELECTOR_LIST or SELECTOR node
+   * Returns null if no prelude exists
+   */
+  get prelude(): CSSNode | null | undefined;
+  /**
+   * Get the attribute operator (for attribute selectors: =, ~=, |=, ^=, $=, *=)
+   * Returns one of the ATTR_OPERATOR_* constants
+   */
+  get attr_operator(): number | undefined;
+  /**
+   * Get the attribute flags (for attribute selectors: i, s)
+   * Returns one of the ATTR_FLAG_* constants
+   */
+  get attr_flags(): number | undefined;
+  /** Get the unit for dimension nodes (e.g., "px" from "100px", "%" from "50%") */
+  get unit(): string | undefined;
+  /** Check if this declaration has !important */
+  get is_important(): boolean | undefined;
+  /** Check if this declaration has a browser hack prefix */
+  get is_browserhack(): boolean | undefined;
+  /** Check if this has a vendor prefix (computed on-demand) */
+  get is_vendor_prefixed(): boolean;
+  /** Check if this node has an error */
+  get has_error(): boolean;
+  /** Check if this node has a prelude (at-rules and style rules) */
+  get has_prelude(): boolean;
+  /** Check if this rule has a block { } */
+  get has_block(): boolean;
+  /** Check if this style rule has declarations */
+  get has_declarations(): boolean;
+  /** Get the block node (for style rules and at-rules with blocks) */
+  get block(): CSSNode | null;
+  /** Check if this block is empty (no declarations or rules, only comments allowed) */
+  get is_empty(): boolean | undefined;
+  /** Get start line number */
+  get line(): number;
+  /** Get start column number */
+  get column(): number;
+  /** Get start offset in source */
+  get start(): number;
+  /** Get length in source */
+  get length(): number;
+  /**
+   * Get end offset in source
+   * End is not stored, must be calculated
+   */
+  get end(): number;
+  /** Get first child node */
+  get first_child(): CSSNode | null;
+  /** Get next sibling node */
+  get next_sibling(): CSSNode | null;
+  /** Check if this node has a next sibling */
+  get has_next(): boolean;
+  /**
+   * Check if this node has children
+   * For pseudo-class/pseudo-element functions, returns true if FLAG_HAS_PARENS is set
+   * This allows formatters to distinguish :lang() from :hover
+   */
+  get has_children(): boolean;
+  /** Get all children as an array */
+  get children(): CSSNode[];
+  /** Make CSSNode iterable over its children */
+  [Symbol.iterator](): Iterator<CSSNode>;
+  /** Get the 'a' coefficient from An+B expression (e.g., "2n" from "2n+1", "odd" from "odd") */
+  get nth_a(): string | undefined;
+  /** Get the 'b' coefficient from An+B expression (e.g., "+1" from "2n+1") */
+  get nth_b(): string | undefined;
+  /** Get the An+B formula node from :nth-child(2n+1 of .foo) */
+  get nth(): CSSNode | undefined;
+  /** Get the selector list from :nth-child(2n+1 of .foo) */
+  get selector(): CSSNode | undefined;
+  /**
+   * Get selector list from pseudo-class functions
+   * Works for :is(.a), :not(.b), :has(.c), :where(.d), :nth-child(2n of .e)
+   */
+  get selector_list(): CSSNode | undefined;
+  /**
+   * Clone this node as a mutable plain JavaScript object with children as arrays.
+   * See API.md for examples.
+   *
+   * @param options - Cloning configuration
+   * @param options.deep - Recursively clone children (default: true)
+   * @param options.locations - Include line/column/start/length (default: false)
+   */
+  clone(options?: CloneOptions): PlainCSSNode;
+}
+//#endregion
+export { STYLESHEET as $, FLAG_IMPORTANT as A, NESTING_SELECTOR as B, COMBINATOR as C, DECLARATION as D, CSSDataArena as E, LANG_SELECTOR as F, PARENTHESIS as G, NTH_SELECTOR as H, LAYER_NAME as I, PSEUDO_ELEMENT_SELECTOR as J, PRELUDE_OPERATOR as K, MEDIA_FEATURE as L, HASH as M, IDENTIFIER as N, DIMENSION as O, ID_SELECTOR as P, STRING as Q, MEDIA_QUERY as R, CLASS_SELECTOR as S, CONTAINER_QUERY as T, NUMBER as U, NTH_OF_SELECTOR as V, OPERATOR as W, SELECTOR as X, RAW as Y, SELECTOR_LIST as Z, ATTR_OPERATOR_STAR_EQUAL as _, CloneOptions as a, VALUE as at, AT_RULE_PRELUDE as b, ATTRIBUTE_SELECTOR as c, ATTR_FLAG_NONE as d, STYLE_RULE as et, ATTR_OPERATOR_CARET_EQUAL as f, ATTR_OPERATOR_PIPE_EQUAL as g, ATTR_OPERATOR_NONE as h, CSSNodeType as i, URL as it, FUNCTION as j, FEATURE_RANGE as k, ATTR_FLAG_CASE_INSENSITIVE as l, ATTR_OPERATOR_EQUAL as m, ATTR_OPERATOR_NAMES as n, TYPE_SELECTOR as nt, PlainCSSNode as o, ATTR_OPERATOR_DOLLAR_EQUAL as p, PSEUDO_CLASS_SELECTOR as q, CSSNode as r, UNIVERSAL_SELECTOR as rt, TYPE_NAMES as s, ATTR_FLAG_NAMES as t, SUPPORTS_QUERY as tt, ATTR_FLAG_CASE_SENSITIVE as u, ATTR_OPERATOR_TILDE_EQUAL as v, COMMENT as w, BLOCK as x, AT_RULE as y, MEDIA_TYPE as z };