@projectwallace/css-parser 0.9.0 → 0.11.0

package/dist/arena.d.ts

@@ -14,6 +14,7 @@ export declare const FUNCTION = 15;
 export declare const OPERATOR = 16;
 export declare const PARENTHESIS = 17;
 export declare const URL = 18;
+export declare const VALUE = 19;
 export declare const SELECTOR_LIST = 20;
 export declare const TYPE_SELECTOR = 21;
 export declare const CLASS_SELECTOR = 22;
@@ -35,6 +36,7 @@ export declare const SUPPORTS_QUERY = 36;
 export declare const LAYER_NAME = 37;
 export declare const PRELUDE_OPERATOR = 38;
 export declare const FEATURE_RANGE = 39;
+export declare const AT_RULE_PRELUDE = 40;
 export declare const FLAG_IMPORTANT: number;
 export declare const FLAG_HAS_ERROR: number;
 export declare const FLAG_LENGTH_OVERFLOW: number;

package/dist/arena.js

@@ -15,6 +15,7 @@ const FUNCTION = 15;
 const OPERATOR = 16;
 const PARENTHESIS = 17;
 const URL = 18;
+const VALUE = 19;
 const SELECTOR_LIST = 20;
 const TYPE_SELECTOR = 21;
 const CLASS_SELECTOR = 22;
@@ -36,6 +37,7 @@ const SUPPORTS_QUERY = 36;
 const LAYER_NAME = 37;
 const PRELUDE_OPERATOR = 38;
 const FEATURE_RANGE = 39;
+const AT_RULE_PRELUDE = 40;
 const FLAG_IMPORTANT = 1 << 0;
 const FLAG_HAS_ERROR = 1 << 1;
 const FLAG_LENGTH_OVERFLOW = 1 << 2;
@@ -67,7 +69,9 @@ class CSSDataArena {
   // Growth multiplier when capacity is exceeded
   static GROWTH_FACTOR = 1.3;
   // Estimated nodes per KB of CSS (based on real-world data)
-  static NODES_PER_KB = 270;
+  // Increased from 270 to 325 to account for VALUE wrapper nodes
+  // (~20% of nodes are declarations, +1 VALUE node per declaration = +20% nodes)
+  static NODES_PER_KB = 325;
   // Buffer to avoid frequent growth (15%)
   static CAPACITY_BUFFER = 1.2;
   constructor(initial_capacity = 1024) {
@@ -281,4 +285,4 @@ class CSSDataArena {
   }
 }
 
-export { ATTRIBUTE_SELECTOR, ATTR_FLAG_CASE_INSENSITIVE, ATTR_FLAG_CASE_SENSITIVE, ATTR_FLAG_NONE, ATTR_OPERATOR_CARET_EQUAL, ATTR_OPERATOR_DOLLAR_EQUAL, ATTR_OPERATOR_EQUAL, ATTR_OPERATOR_NONE, ATTR_OPERATOR_PIPE_EQUAL, ATTR_OPERATOR_STAR_EQUAL, ATTR_OPERATOR_TILDE_EQUAL, AT_RULE, BLOCK, CLASS_SELECTOR, COMBINATOR, COMMENT, CONTAINER_QUERY, CSSDataArena, DECLARATION, DIMENSION, FEATURE_RANGE, FLAG_BROWSERHACK, FLAG_HAS_BLOCK, FLAG_HAS_DECLARATIONS, FLAG_HAS_ERROR, FLAG_HAS_PARENS, FLAG_IMPORTANT, FLAG_LENGTH_OVERFLOW, FUNCTION, HASH, IDENTIFIER, ID_SELECTOR, LANG_SELECTOR, LAYER_NAME, MEDIA_FEATURE, MEDIA_QUERY, MEDIA_TYPE, NESTING_SELECTOR, NTH_OF_SELECTOR, NTH_SELECTOR, NUMBER, OPERATOR, PARENTHESIS, PRELUDE_OPERATOR, PSEUDO_CLASS_SELECTOR, PSEUDO_ELEMENT_SELECTOR, SELECTOR, SELECTOR_LIST, STRING, STYLESHEET, STYLE_RULE, SUPPORTS_QUERY, TYPE_SELECTOR, UNIVERSAL_SELECTOR, URL };
+export { ATTRIBUTE_SELECTOR, ATTR_FLAG_CASE_INSENSITIVE, ATTR_FLAG_CASE_SENSITIVE, ATTR_FLAG_NONE, ATTR_OPERATOR_CARET_EQUAL, ATTR_OPERATOR_DOLLAR_EQUAL, ATTR_OPERATOR_EQUAL, ATTR_OPERATOR_NONE, ATTR_OPERATOR_PIPE_EQUAL, ATTR_OPERATOR_STAR_EQUAL, ATTR_OPERATOR_TILDE_EQUAL, AT_RULE, AT_RULE_PRELUDE, BLOCK, CLASS_SELECTOR, COMBINATOR, COMMENT, CONTAINER_QUERY, CSSDataArena, DECLARATION, DIMENSION, FEATURE_RANGE, FLAG_BROWSERHACK, FLAG_HAS_BLOCK, FLAG_HAS_DECLARATIONS, FLAG_HAS_ERROR, FLAG_HAS_PARENS, FLAG_IMPORTANT, FLAG_LENGTH_OVERFLOW, FUNCTION, HASH, IDENTIFIER, ID_SELECTOR, LANG_SELECTOR, LAYER_NAME, MEDIA_FEATURE, MEDIA_QUERY, MEDIA_TYPE, NESTING_SELECTOR, NTH_OF_SELECTOR, NTH_SELECTOR, NUMBER, OPERATOR, PARENTHESIS, PRELUDE_OPERATOR, PSEUDO_CLASS_SELECTOR, PSEUDO_ELEMENT_SELECTOR, SELECTOR, SELECTOR_LIST, STRING, STYLESHEET, STYLE_RULE, SUPPORTS_QUERY, TYPE_SELECTOR, UNIVERSAL_SELECTOR, URL, VALUE };

package/dist/char-types.d.ts

@@ -1,3 +1,9 @@
+export declare let CHAR_ALPHA: number;
+export declare let CHAR_DIGIT: number;
+export declare let CHAR_HEX: number;
+export declare let CHAR_WHITESPACE: number;
+export declare let CHAR_NEWLINE: number;
+export declare let char_types: Uint8Array<ArrayBuffer>;
 export declare function is_digit(ch: number): boolean;
 export declare function is_hex_digit(ch: number): boolean;
 export declare function is_alpha(ch: number): boolean;

package/dist/char-types.js

@@ -52,4 +52,4 @@ function is_ident_char(ch) {
   return is_ident_start(ch) || is_digit(ch);
 }
 
-export { is_alpha, is_digit, is_hex_digit, is_ident_char, is_ident_start, is_newline, is_whitespace };
+export { CHAR_ALPHA, CHAR_DIGIT, CHAR_HEX, CHAR_NEWLINE, CHAR_WHITESPACE, char_types, is_alpha, is_digit, is_hex_digit, is_ident_char, is_ident_start, is_newline, is_whitespace };

package/dist/constants.d.ts

@@ -1,5 +1,5 @@
-import { STYLESHEET, STYLE_RULE, AT_RULE, DECLARATION, SELECTOR, COMMENT, BLOCK, IDENTIFIER, NUMBER, DIMENSION, STRING, HASH, FUNCTION, OPERATOR, PARENTHESIS, URL, SELECTOR_LIST, TYPE_SELECTOR, CLASS_SELECTOR, ID_SELECTOR, ATTRIBUTE_SELECTOR, PSEUDO_CLASS_SELECTOR, PSEUDO_ELEMENT_SELECTOR, COMBINATOR, UNIVERSAL_SELECTOR, NESTING_SELECTOR, NTH_SELECTOR, NTH_OF_SELECTOR, LANG_SELECTOR, MEDIA_QUERY, MEDIA_FEATURE, MEDIA_TYPE, CONTAINER_QUERY, SUPPORTS_QUERY, LAYER_NAME, PRELUDE_OPERATOR, FEATURE_RANGE, FLAG_IMPORTANT, ATTR_OPERATOR_NONE, ATTR_OPERATOR_EQUAL, ATTR_OPERATOR_TILDE_EQUAL, ATTR_OPERATOR_PIPE_EQUAL, ATTR_OPERATOR_CARET_EQUAL, ATTR_OPERATOR_DOLLAR_EQUAL, ATTR_OPERATOR_STAR_EQUAL, ATTR_FLAG_NONE, ATTR_FLAG_CASE_INSENSITIVE, ATTR_FLAG_CASE_SENSITIVE } from './arena';
-export { STYLESHEET, STYLE_RULE, AT_RULE, DECLARATION, SELECTOR, COMMENT, BLOCK, IDENTIFIER, NUMBER, DIMENSION, STRING, HASH, FUNCTION, OPERATOR, PARENTHESIS, URL, SELECTOR_LIST, TYPE_SELECTOR, CLASS_SELECTOR, ID_SELECTOR, ATTRIBUTE_SELECTOR, PSEUDO_CLASS_SELECTOR, PSEUDO_ELEMENT_SELECTOR, COMBINATOR, UNIVERSAL_SELECTOR, NESTING_SELECTOR, NTH_SELECTOR, NTH_OF_SELECTOR, LANG_SELECTOR, MEDIA_QUERY, MEDIA_FEATURE, MEDIA_TYPE, CONTAINER_QUERY, SUPPORTS_QUERY, LAYER_NAME, PRELUDE_OPERATOR, FEATURE_RANGE, FLAG_IMPORTANT, ATTR_OPERATOR_NONE, ATTR_OPERATOR_EQUAL, ATTR_OPERATOR_TILDE_EQUAL, ATTR_OPERATOR_PIPE_EQUAL, ATTR_OPERATOR_CARET_EQUAL, ATTR_OPERATOR_DOLLAR_EQUAL, ATTR_OPERATOR_STAR_EQUAL, ATTR_FLAG_NONE, ATTR_FLAG_CASE_INSENSITIVE, ATTR_FLAG_CASE_SENSITIVE, };
+import { STYLESHEET, STYLE_RULE, AT_RULE, DECLARATION, SELECTOR, COMMENT, BLOCK, IDENTIFIER, NUMBER, DIMENSION, STRING, HASH, FUNCTION, OPERATOR, PARENTHESIS, URL, VALUE, SELECTOR_LIST, TYPE_SELECTOR, CLASS_SELECTOR, ID_SELECTOR, ATTRIBUTE_SELECTOR, PSEUDO_CLASS_SELECTOR, PSEUDO_ELEMENT_SELECTOR, COMBINATOR, UNIVERSAL_SELECTOR, NESTING_SELECTOR, NTH_SELECTOR, NTH_OF_SELECTOR, LANG_SELECTOR, MEDIA_QUERY, MEDIA_FEATURE, MEDIA_TYPE, CONTAINER_QUERY, SUPPORTS_QUERY, LAYER_NAME, PRELUDE_OPERATOR, FEATURE_RANGE, AT_RULE_PRELUDE, FLAG_IMPORTANT, ATTR_OPERATOR_NONE, ATTR_OPERATOR_EQUAL, ATTR_OPERATOR_TILDE_EQUAL, ATTR_OPERATOR_PIPE_EQUAL, ATTR_OPERATOR_CARET_EQUAL, ATTR_OPERATOR_DOLLAR_EQUAL, ATTR_OPERATOR_STAR_EQUAL, ATTR_FLAG_NONE, ATTR_FLAG_CASE_INSENSITIVE, ATTR_FLAG_CASE_SENSITIVE } from './arena';
+export { STYLESHEET, STYLE_RULE, AT_RULE, DECLARATION, SELECTOR, COMMENT, BLOCK, IDENTIFIER, NUMBER, DIMENSION, STRING, HASH, FUNCTION, OPERATOR, PARENTHESIS, URL, VALUE, SELECTOR_LIST, TYPE_SELECTOR, CLASS_SELECTOR, ID_SELECTOR, ATTRIBUTE_SELECTOR, PSEUDO_CLASS_SELECTOR, PSEUDO_ELEMENT_SELECTOR, COMBINATOR, UNIVERSAL_SELECTOR, NESTING_SELECTOR, NTH_SELECTOR, NTH_OF_SELECTOR, LANG_SELECTOR, MEDIA_QUERY, MEDIA_FEATURE, MEDIA_TYPE, CONTAINER_QUERY, SUPPORTS_QUERY, LAYER_NAME, PRELUDE_OPERATOR, FEATURE_RANGE, AT_RULE_PRELUDE, FLAG_IMPORTANT, ATTR_OPERATOR_NONE, ATTR_OPERATOR_EQUAL, ATTR_OPERATOR_TILDE_EQUAL, ATTR_OPERATOR_PIPE_EQUAL, ATTR_OPERATOR_CARET_EQUAL, ATTR_OPERATOR_DOLLAR_EQUAL, ATTR_OPERATOR_STAR_EQUAL, ATTR_FLAG_NONE, ATTR_FLAG_CASE_INSENSITIVE, ATTR_FLAG_CASE_SENSITIVE, };
 export declare const NODE_TYPES: {
     readonly STYLESHEET: 1;
     readonly STYLE_RULE: 2;
@@ -17,6 +17,7 @@ export declare const NODE_TYPES: {
     readonly OPERATOR: 16;
     readonly PARENTHESIS: 17;
     readonly URL: 18;
+    readonly VALUE: 19;
     readonly SELECTOR_LIST: 20;
     readonly TYPE_SELECTOR: 21;
     readonly CLASS_SELECTOR: 22;
@@ -38,4 +39,5 @@ export declare const NODE_TYPES: {
     readonly LAYER_NAME: 37;
     readonly PRELUDE_OPERATOR: 38;
     readonly FEATURE_RANGE: 39;
+    readonly AT_RULE_PRELUDE: 40;
 };

package/dist/constants.js

@@ -1,4 +1,4 @@
-import { FEATURE_RANGE, PRELUDE_OPERATOR, LAYER_NAME, SUPPORTS_QUERY, CONTAINER_QUERY, MEDIA_TYPE, MEDIA_FEATURE, MEDIA_QUERY, LANG_SELECTOR, NTH_OF_SELECTOR, NTH_SELECTOR, NESTING_SELECTOR, UNIVERSAL_SELECTOR, COMBINATOR, PSEUDO_ELEMENT_SELECTOR, PSEUDO_CLASS_SELECTOR, ATTRIBUTE_SELECTOR, ID_SELECTOR, CLASS_SELECTOR, TYPE_SELECTOR, SELECTOR_LIST, URL, PARENTHESIS, OPERATOR, FUNCTION, HASH, STRING, DIMENSION, NUMBER, IDENTIFIER, BLOCK, COMMENT, SELECTOR, DECLARATION, AT_RULE, STYLE_RULE, STYLESHEET } from './arena.js';
+import { AT_RULE_PRELUDE, FEATURE_RANGE, PRELUDE_OPERATOR, LAYER_NAME, SUPPORTS_QUERY, CONTAINER_QUERY, MEDIA_TYPE, MEDIA_FEATURE, MEDIA_QUERY, LANG_SELECTOR, NTH_OF_SELECTOR, NTH_SELECTOR, NESTING_SELECTOR, UNIVERSAL_SELECTOR, COMBINATOR, PSEUDO_ELEMENT_SELECTOR, PSEUDO_CLASS_SELECTOR, ATTRIBUTE_SELECTOR, ID_SELECTOR, CLASS_SELECTOR, TYPE_SELECTOR, SELECTOR_LIST, VALUE, URL, PARENTHESIS, OPERATOR, FUNCTION, HASH, STRING, DIMENSION, NUMBER, IDENTIFIER, BLOCK, COMMENT, SELECTOR, DECLARATION, AT_RULE, STYLE_RULE, STYLESHEET } from './arena.js';
 export { ATTR_FLAG_CASE_INSENSITIVE, ATTR_FLAG_CASE_SENSITIVE, ATTR_FLAG_NONE, ATTR_OPERATOR_CARET_EQUAL, ATTR_OPERATOR_DOLLAR_EQUAL, ATTR_OPERATOR_EQUAL, ATTR_OPERATOR_NONE, ATTR_OPERATOR_PIPE_EQUAL, ATTR_OPERATOR_STAR_EQUAL, ATTR_OPERATOR_TILDE_EQUAL, FLAG_IMPORTANT } from './arena.js';
 
 const NODE_TYPES = {
@@ -20,6 +20,7 @@ const NODE_TYPES = {
   OPERATOR,
   PARENTHESIS,
   URL,
+  VALUE,
   // Selector nodes
   SELECTOR_LIST,
   TYPE_SELECTOR,
@@ -42,7 +43,8 @@ const NODE_TYPES = {
   SUPPORTS_QUERY,
   LAYER_NAME,
   PRELUDE_OPERATOR,
-  FEATURE_RANGE
+  FEATURE_RANGE,
+  AT_RULE_PRELUDE
 };
 
-export { ATTRIBUTE_SELECTOR, AT_RULE, BLOCK, CLASS_SELECTOR, COMBINATOR, COMMENT, CONTAINER_QUERY, DECLARATION, DIMENSION, FEATURE_RANGE, FUNCTION, HASH, IDENTIFIER, ID_SELECTOR, LANG_SELECTOR, LAYER_NAME, MEDIA_FEATURE, MEDIA_QUERY, MEDIA_TYPE, NESTING_SELECTOR, NODE_TYPES, NTH_OF_SELECTOR, NTH_SELECTOR, NUMBER, OPERATOR, PARENTHESIS, PRELUDE_OPERATOR, PSEUDO_CLASS_SELECTOR, PSEUDO_ELEMENT_SELECTOR, SELECTOR, SELECTOR_LIST, STRING, STYLESHEET, STYLE_RULE, SUPPORTS_QUERY, TYPE_SELECTOR, UNIVERSAL_SELECTOR, URL };
+export { ATTRIBUTE_SELECTOR, AT_RULE, AT_RULE_PRELUDE, BLOCK, CLASS_SELECTOR, COMBINATOR, COMMENT, CONTAINER_QUERY, DECLARATION, DIMENSION, FEATURE_RANGE, FUNCTION, HASH, IDENTIFIER, ID_SELECTOR, LANG_SELECTOR, LAYER_NAME, MEDIA_FEATURE, MEDIA_QUERY, MEDIA_TYPE, NESTING_SELECTOR, NODE_TYPES, NTH_OF_SELECTOR, NTH_SELECTOR, NUMBER, OPERATOR, PARENTHESIS, PRELUDE_OPERATOR, PSEUDO_CLASS_SELECTOR, PSEUDO_ELEMENT_SELECTOR, SELECTOR, SELECTOR_LIST, STRING, STYLESHEET, STYLE_RULE, SUPPORTS_QUERY, TYPE_SELECTOR, UNIVERSAL_SELECTOR, URL, VALUE };

package/dist/css-node.d.ts

@@ -1,5 +1,5 @@
 import type { CSSDataArena } from './arena';
-import { STYLESHEET, STYLE_RULE, AT_RULE, DECLARATION, SELECTOR, COMMENT, BLOCK, IDENTIFIER, NUMBER, DIMENSION, STRING, HASH, FUNCTION, OPERATOR, PARENTHESIS, URL, SELECTOR_LIST, TYPE_SELECTOR, CLASS_SELECTOR, ID_SELECTOR, ATTRIBUTE_SELECTOR, PSEUDO_CLASS_SELECTOR, PSEUDO_ELEMENT_SELECTOR, COMBINATOR, UNIVERSAL_SELECTOR, NESTING_SELECTOR, NTH_SELECTOR, NTH_OF_SELECTOR, LANG_SELECTOR, MEDIA_QUERY, MEDIA_FEATURE, MEDIA_TYPE, CONTAINER_QUERY, SUPPORTS_QUERY, LAYER_NAME, PRELUDE_OPERATOR, FEATURE_RANGE } from './arena';
+import { STYLESHEET, STYLE_RULE, AT_RULE, DECLARATION, SELECTOR, COMMENT, BLOCK, IDENTIFIER, NUMBER, DIMENSION, STRING, HASH, FUNCTION, OPERATOR, PARENTHESIS, URL, VALUE, SELECTOR_LIST, TYPE_SELECTOR, CLASS_SELECTOR, ID_SELECTOR, ATTRIBUTE_SELECTOR, PSEUDO_CLASS_SELECTOR, PSEUDO_ELEMENT_SELECTOR, COMBINATOR, UNIVERSAL_SELECTOR, NESTING_SELECTOR, NTH_SELECTOR, NTH_OF_SELECTOR, LANG_SELECTOR, MEDIA_QUERY, MEDIA_FEATURE, MEDIA_TYPE, CONTAINER_QUERY, SUPPORTS_QUERY, LAYER_NAME, PRELUDE_OPERATOR, FEATURE_RANGE, AT_RULE_PRELUDE } from './arena';
 export declare const TYPE_NAMES: {
     readonly 1: "StyleSheet";
     readonly 2: "Rule";
@@ -17,6 +17,7 @@ export declare const TYPE_NAMES: {
     readonly 16: "Operator";
     readonly 17: "Parentheses";
     readonly 18: "Url";
+    readonly 19: "Value";
     readonly 20: "SelectorList";
     readonly 21: "TypeSelector";
     readonly 22: "ClassSelector";
@@ -38,9 +39,10 @@ export declare const TYPE_NAMES: {
     readonly 37: "Layer";
     readonly 38: "Operator";
     readonly 39: "MediaFeatureRange";
+    readonly 40: "AtrulePrelude";
 };
 export type TypeName = (typeof TYPE_NAMES)[keyof typeof TYPE_NAMES] | 'unknown';
-export type CSSNodeType = typeof STYLESHEET | typeof STYLE_RULE | typeof AT_RULE | typeof DECLARATION | typeof SELECTOR | typeof COMMENT | typeof BLOCK | typeof IDENTIFIER | typeof NUMBER | typeof DIMENSION | typeof STRING | typeof HASH | typeof FUNCTION | typeof OPERATOR | typeof PARENTHESIS | typeof URL | 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;
+export type CSSNodeType = typeof STYLESHEET | typeof STYLE_RULE | typeof AT_RULE | typeof DECLARATION | typeof SELECTOR | typeof COMMENT | typeof BLOCK | 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;
 export interface CloneOptions {
     /**
      * Recursively clone all children
@@ -62,7 +64,7 @@ export type PlainCSSNode = {
     property?: string;
     value?: string | number | null;
     unit?: string;
-    prelude?: string;
+    prelude?: PlainCSSNode | null;
     is_important?: boolean;
     is_vendor_prefixed?: boolean;
     is_browserhack?: boolean;
@@ -102,35 +104,37 @@ export declare class CSSNode {
      * 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(): string | number | null;
+    get value(): CSSNode | string | number | null;
     /** Get the numeric value for NUMBER and DIMENSION nodes, or null for other node types */
     get value_as_number(): number | null;
     /**
-     * Get the prelude text (for at-rules: "(min-width: 768px)" in "@media (min-width: 768px)")
-     * This is an alias for `value` to make at-rule usage more semantic
+     * 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(): string | null;
+    get prelude(): CSSNode | null | undefined;
     /**
      * Get the attribute operator (for attribute selectors: =, ~=, |=, ^=, $=, *=)
      * Returns one of the ATTR_OPERATOR_* constants
      */
-    get attr_operator(): number;
+    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;
+    get attr_flags(): number | undefined;
     /** Get the unit for dimension nodes (e.g., "px" from "100px", "%" from "50%") */
-    get unit(): string | null;
+    get unit(): string | undefined;
     /** Check if this declaration has !important */
-    get is_important(): boolean | null;
+    get is_important(): boolean | undefined;
     /** Check if this declaration has a browser hack prefix */
-    get is_browserhack(): boolean | null;
+    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 at-rule has a prelude */
+    /** 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;
@@ -139,9 +143,7 @@ export declare class CSSNode {
     /** 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;
-    /** Get array of parsed value nodes (for declarations only) */
-    get values(): CSSNode[];
+    get is_empty(): boolean | undefined;
     /** Get start line number */
     get line(): number;
     /** Get start column number */
@@ -172,37 +174,18 @@ export declare class 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 | null;
+    get nth_a(): string | undefined;
     /** Get the 'b' coefficient from An+B expression (e.g., "+1" from "2n+1") */
-    get nth_b(): string | null;
+    get nth_b(): string | undefined;
     /** Get the An+B formula node from :nth-child(2n+1 of .foo) */
-    get nth(): CSSNode | null;
+    get nth(): CSSNode | undefined;
     /** Get the selector list from :nth-child(2n+1 of .foo) */
-    get selector(): CSSNode | null;
+    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 | null;
-    /**
-     * Iterator over first compound selector parts (zero allocation)
-     * Yields parts before the first combinator
-     */
-    compound_parts(): IterableIterator<CSSNode>;
-    /**
-     * Get first compound selector as array
-     * Returns array of parts before first combinator
-     */
-    get first_compound(): CSSNode[];
-    /**
-     * Split selector into compound selectors
-     * Returns array of compound arrays split by combinators
-     */
-    get all_compounds(): CSSNode[][];
-    /** Check if selector is compound (no combinators) */
-    get is_compound(): boolean;
-    /** Get text of first compound selector (no node allocation) */
-    get first_compound_text(): string;
+    get selector_list(): CSSNode | undefined;
     /**
      * Clone this node as a mutable plain JavaScript object with children as arrays.
      * See API.md for examples.

package/dist/css-node.js

@@ -1,4 +1,4 @@
-import { DIMENSION, NUMBER, URL, STRING, DECLARATION, FLAG_IMPORTANT, FLAG_BROWSERHACK, IDENTIFIER, FUNCTION, AT_RULE, PSEUDO_ELEMENT_SELECTOR, PSEUDO_CLASS_SELECTOR, FLAG_HAS_ERROR, FLAG_HAS_BLOCK, FLAG_HAS_DECLARATIONS, STYLE_RULE, BLOCK, COMMENT, FLAG_HAS_PARENS, NTH_SELECTOR, NTH_OF_SELECTOR, SELECTOR_LIST, SELECTOR, COMBINATOR, ATTRIBUTE_SELECTOR, FEATURE_RANGE, PRELUDE_OPERATOR, LAYER_NAME, SUPPORTS_QUERY, CONTAINER_QUERY, MEDIA_TYPE, MEDIA_FEATURE, MEDIA_QUERY, LANG_SELECTOR, NESTING_SELECTOR, UNIVERSAL_SELECTOR, ID_SELECTOR, CLASS_SELECTOR, TYPE_SELECTOR, PARENTHESIS, OPERATOR, HASH, STYLESHEET } from './arena.js';
+import { DECLARATION, DIMENSION, NUMBER, URL, STRING, AT_RULE, AT_RULE_PRELUDE, STYLE_RULE, ATTRIBUTE_SELECTOR, FLAG_IMPORTANT, FLAG_BROWSERHACK, IDENTIFIER, FUNCTION, PSEUDO_ELEMENT_SELECTOR, PSEUDO_CLASS_SELECTOR, FLAG_HAS_ERROR, FLAG_HAS_BLOCK, FLAG_HAS_DECLARATIONS, BLOCK, COMMENT, FLAG_HAS_PARENS, NTH_SELECTOR, NTH_OF_SELECTOR, SELECTOR_LIST, FEATURE_RANGE, PRELUDE_OPERATOR, LAYER_NAME, SUPPORTS_QUERY, CONTAINER_QUERY, MEDIA_TYPE, MEDIA_FEATURE, MEDIA_QUERY, LANG_SELECTOR, NESTING_SELECTOR, UNIVERSAL_SELECTOR, COMBINATOR, ID_SELECTOR, CLASS_SELECTOR, TYPE_SELECTOR, VALUE, PARENTHESIS, OPERATOR, HASH, SELECTOR, STYLESHEET } from './arena.js';
 import { str_starts_with, is_vendor_prefixed, is_whitespace, CHAR_MINUS_HYPHEN, CHAR_PLUS } from './string-utils.js';
 import { parse_dimension } from './parse-utils.js';
 
@@ -19,6 +19,7 @@ const TYPE_NAMES = {
   [OPERATOR]: "Operator",
   [PARENTHESIS]: "Parentheses",
   [URL]: "Url",
+  [VALUE]: "Value",
   [SELECTOR_LIST]: "SelectorList",
   [TYPE_SELECTOR]: "TypeSelector",
   [CLASS_SELECTOR]: "ClassSelector",
@@ -39,7 +40,8 @@ const TYPE_NAMES = {
   [SUPPORTS_QUERY]: "SupportsQuery",
   [LAYER_NAME]: "Layer",
   [PRELUDE_OPERATOR]: "Operator",
-  [FEATURE_RANGE]: "MediaFeatureRange"
+  [FEATURE_RANGE]: "MediaFeatureRange",
+  [AT_RULE_PRELUDE]: "AtrulePrelude"
 };
 class CSSNode {
   arena;
@@ -94,6 +96,9 @@ class CSSNode {
    */
   get value() {
     let { type, text } = this;
+    if (type === DECLARATION && this.first_child) {
+      return this.first_child;
+    }
     if (type === DIMENSION) {
       return parse_dimension(text).value;
     }
@@ -133,18 +138,30 @@ class CSSNode {
     return null;
   }
   /**
-   * Get the prelude text (for at-rules: "(min-width: 768px)" in "@media (min-width: 768px)")
-   * This is an alias for `value` to make at-rule usage more semantic
+   * 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() {
-    let val = this.value;
-    return typeof val === "string" ? val : null;
+    if (this.type === AT_RULE) {
+      let first = this.first_child;
+      if (first && first.type === AT_RULE_PRELUDE) {
+        return first;
+      }
+      return null;
+    }
+    if (this.type === STYLE_RULE) {
+      return this.first_child;
+    }
+    return void 0;
   }
   /**
    * Get the attribute operator (for attribute selectors: =, ~=, |=, ^=, $=, *=)
    * Returns one of the ATTR_OPERATOR_* constants
    */
   get attr_operator() {
+    if (this.type !== ATTRIBUTE_SELECTOR) return void 0;
     return this.arena.get_attr_operator(this.index);
   }
   /**
@@ -152,21 +169,22 @@ class CSSNode {
    * Returns one of the ATTR_FLAG_* constants
    */
   get attr_flags() {
+    if (this.type !== ATTRIBUTE_SELECTOR) return void 0;
     return this.arena.get_attr_flags(this.index);
   }
   /** Get the unit for dimension nodes (e.g., "px" from "100px", "%" from "50%") */
   get unit() {
-    if (this.type !== DIMENSION) return null;
+    if (this.type !== DIMENSION) return void 0;
     return parse_dimension(this.text).unit;
   }
   /** Check if this declaration has !important */
   get is_important() {
-    if (this.type !== DECLARATION) return null;
+    if (this.type !== DECLARATION) return void 0;
     return this.arena.has_flag(this.index, FLAG_IMPORTANT);
   }
   /** Check if this declaration has a browser hack prefix */
   get is_browserhack() {
-    if (this.type !== DECLARATION) return null;
+    if (this.type !== DECLARATION) return void 0;
     return this.arena.has_flag(this.index, FLAG_BROWSERHACK);
   }
   /** Check if this has a vendor prefix (computed on-demand) */
@@ -191,9 +209,15 @@ class CSSNode {
   get has_error() {
     return this.arena.has_flag(this.index, FLAG_HAS_ERROR);
   }
-  /** Check if this at-rule has a prelude */
+  /** Check if this node has a prelude (at-rules and style rules) */
   get has_prelude() {
-    return this.arena.get_value_length(this.index) > 0;
+    if (this.type === AT_RULE) {
+      return this.arena.get_value_length(this.index) > 0;
+    }
+    if (this.type === STYLE_RULE) {
+      return this.first_child !== null;
+    }
+    return false;
   }
   /** Check if this rule has a block { } */
   get has_block() {
@@ -228,7 +252,7 @@ class CSSNode {
   }
   /** Check if this block is empty (no declarations or rules, only comments allowed) */
   get is_empty() {
-    if (this.type !== BLOCK) return false;
+    if (this.type !== BLOCK) return void 0;
     let child = this.first_child;
     while (child) {
       if (child.type !== COMMENT) {
@@ -238,17 +262,6 @@ class CSSNode {
     }
     return true;
   }
-  // --- Value Node Access (for declarations) ---
-  /** Get array of parsed value nodes (for declarations only) */
-  get values() {
-    let result = [];
-    let child = this.first_child;
-    while (child) {
-      result.push(child);
-      child = child.next_sibling;
-    }
-    return result;
-  }
   /** Get start line number */
   get line() {
     return this.arena.get_start_line(this.index);
@@ -324,17 +337,17 @@ class CSSNode {
   // --- An+B Expression Helpers (for NODE_SELECTOR_NTH) ---
   /** Get the 'a' coefficient from An+B expression (e.g., "2n" from "2n+1", "odd" from "odd") */
   get nth_a() {
-    if (this.type !== NTH_SELECTOR) return null;
+    if (this.type !== NTH_SELECTOR && this.type !== NTH_OF_SELECTOR) return void 0;
     let len = this.arena.get_content_length(this.index);
-    if (len === 0) return null;
+    if (len === 0) return void 0;
     let start = this.arena.get_content_start(this.index);
     return this.source.substring(start, start + len);
   }
   /** Get the 'b' coefficient from An+B expression (e.g., "+1" from "2n+1") */
   get nth_b() {
-    if (this.type !== NTH_SELECTOR) return null;
+    if (this.type !== NTH_SELECTOR && this.type !== NTH_OF_SELECTOR) return void 0;
     let len = this.arena.get_value_length(this.index);
-    if (len === 0) return null;
+    if (len === 0) return void 0;
     let start = this.arena.get_value_start(this.index);
     let value = this.source.substring(start, start + len);
     let check_pos = start - 1;
@@ -356,14 +369,14 @@ class CSSNode {
   // --- Pseudo-Class Nth-Of Helpers (for NODE_SELECTOR_NTH_OF) ---
   /** Get the An+B formula node from :nth-child(2n+1 of .foo) */
   get nth() {
-    if (this.type !== NTH_OF_SELECTOR) return null;
-    return this.first_child;
+    if (this.type !== NTH_OF_SELECTOR) return void 0;
+    return this.first_child ?? void 0;
   }
   /** Get the selector list from :nth-child(2n+1 of .foo) */
   get selector() {
-    if (this.type !== NTH_OF_SELECTOR) return null;
+    if (this.type !== NTH_OF_SELECTOR) return void 0;
     let first = this.first_child;
-    return first ? first.next_sibling : null;
+    return first?.next_sibling ?? void 0;
   }
   // --- Pseudo-Class Selector List Helper ---
   /**
@@ -371,95 +384,16 @@ class CSSNode {
    * Works for :is(.a), :not(.b), :has(.c), :where(.d), :nth-child(2n of .e)
    */
   get selector_list() {
-    if (this.type !== PSEUDO_CLASS_SELECTOR) return null;
+    if (this.type !== PSEUDO_CLASS_SELECTOR) return void 0;
     let child = this.first_child;
-    if (!child) return null;
+    if (!child) return void 0;
     if (child.type === SELECTOR_LIST) {
       return child;
     }
     if (child.type === NTH_OF_SELECTOR) {
       return child.selector;
     }
-    return null;
-  }
-  // --- Compound Selector Helpers (for NODE_SELECTOR) ---
-  /**
-   * Iterator over first compound selector parts (zero allocation)
-   * Yields parts before the first combinator
-   */
-  *compound_parts() {
-    if (this.type !== SELECTOR) return;
-    let child = this.first_child;
-    while (child) {
-      if (child.type === COMBINATOR) break;
-      yield child;
-      child = child.next_sibling;
-    }
-  }
-  /**
-   * Get first compound selector as array
-   * Returns array of parts before first combinator
-   */
-  get first_compound() {
-    if (this.type !== SELECTOR) return [];
-    let result = [];
-    let child = this.first_child;
-    while (child) {
-      if (child.type === COMBINATOR) break;
-      result.push(child);
-      child = child.next_sibling;
-    }
-    return result;
-  }
-  /**
-   * Split selector into compound selectors
-   * Returns array of compound arrays split by combinators
-   */
-  get all_compounds() {
-    if (this.type !== SELECTOR) return [];
-    let compounds = [];
-    let current_compound = [];
-    let child = this.first_child;
-    while (child) {
-      if (child.type === COMBINATOR) {
-        if (current_compound.length > 0) {
-          compounds.push(current_compound);
-          current_compound = [];
-        }
-      } else {
-        current_compound.push(child);
-      }
-      child = child.next_sibling;
-    }
-    if (current_compound.length > 0) {
-      compounds.push(current_compound);
-    }
-    return compounds;
-  }
-  /** Check if selector is compound (no combinators) */
-  get is_compound() {
-    if (this.type !== SELECTOR) return false;
-    let child = this.first_child;
-    while (child) {
-      if (child.type === COMBINATOR) return false;
-      child = child.next_sibling;
-    }
-    return true;
-  }
-  /** Get text of first compound selector (no node allocation) */
-  get first_compound_text() {
-    if (this.type !== SELECTOR) return "";
-    let start = -1;
-    let end = -1;
-    let child = this.first_child;
-    while (child) {
-      if (child.type === COMBINATOR) break;
-      if (start === -1) start = child.start;
-      end = child.start + child.length;
-      child = child.next_sibling;
-    }
-    if (start === -1) return "";
-    return this.source.substring(start, end);
+    return void 0;
   }
   // --- Node Cloning ---
   /**
@@ -484,9 +418,6 @@ class CSSNode {
       plain.value = this.value;
       if (this.unit) plain.unit = this.unit;
     }
-    if (this.type === AT_RULE && this.prelude) {
-      plain.prelude = this.prelude;
-    }
     if (this.type === DECLARATION) {
       plain.is_important = this.is_important;
       plain.is_browserhack = this.is_browserhack;

package/dist/index.js

@@ -7,6 +7,6 @@ export { tokenize } from './tokenize.js';
 export { BREAK, SKIP, traverse, walk } from './walk.js';
 export { is_custom, is_vendor_prefixed, str_equals, str_index_of, str_starts_with } from './string-utils.js';
 export { CSSNode, TYPE_NAMES } from './css-node.js';
-export { ATTRIBUTE_SELECTOR, ATTR_FLAG_CASE_INSENSITIVE, ATTR_FLAG_CASE_SENSITIVE, ATTR_FLAG_NONE, ATTR_OPERATOR_CARET_EQUAL, ATTR_OPERATOR_DOLLAR_EQUAL, ATTR_OPERATOR_EQUAL, ATTR_OPERATOR_NONE, ATTR_OPERATOR_PIPE_EQUAL, ATTR_OPERATOR_STAR_EQUAL, ATTR_OPERATOR_TILDE_EQUAL, AT_RULE, BLOCK, CLASS_SELECTOR, COMBINATOR, COMMENT, CONTAINER_QUERY, DECLARATION, DIMENSION, FEATURE_RANGE, FLAG_IMPORTANT, FUNCTION, HASH, IDENTIFIER, ID_SELECTOR, LANG_SELECTOR, LAYER_NAME, MEDIA_FEATURE, MEDIA_QUERY, MEDIA_TYPE, NESTING_SELECTOR, NTH_OF_SELECTOR, NTH_SELECTOR, NUMBER, OPERATOR, PARENTHESIS, PRELUDE_OPERATOR, PSEUDO_CLASS_SELECTOR, PSEUDO_ELEMENT_SELECTOR, SELECTOR, SELECTOR_LIST, STRING, STYLESHEET, STYLE_RULE, SUPPORTS_QUERY, TYPE_SELECTOR, UNIVERSAL_SELECTOR, URL } from './arena.js';
+export { ATTRIBUTE_SELECTOR, ATTR_FLAG_CASE_INSENSITIVE, ATTR_FLAG_CASE_SENSITIVE, ATTR_FLAG_NONE, ATTR_OPERATOR_CARET_EQUAL, ATTR_OPERATOR_DOLLAR_EQUAL, ATTR_OPERATOR_EQUAL, ATTR_OPERATOR_NONE, ATTR_OPERATOR_PIPE_EQUAL, ATTR_OPERATOR_STAR_EQUAL, ATTR_OPERATOR_TILDE_EQUAL, AT_RULE, AT_RULE_PRELUDE, BLOCK, CLASS_SELECTOR, COMBINATOR, COMMENT, CONTAINER_QUERY, DECLARATION, DIMENSION, FEATURE_RANGE, FLAG_IMPORTANT, FUNCTION, HASH, IDENTIFIER, ID_SELECTOR, LANG_SELECTOR, LAYER_NAME, MEDIA_FEATURE, MEDIA_QUERY, MEDIA_TYPE, NESTING_SELECTOR, NTH_OF_SELECTOR, NTH_SELECTOR, NUMBER, OPERATOR, PARENTHESIS, PRELUDE_OPERATOR, PSEUDO_CLASS_SELECTOR, PSEUDO_ELEMENT_SELECTOR, SELECTOR, SELECTOR_LIST, STRING, STYLESHEET, STYLE_RULE, SUPPORTS_QUERY, TYPE_SELECTOR, UNIVERSAL_SELECTOR, URL, VALUE } from './arena.js';
 export { NODE_TYPES } from './constants.js';
 export { TOKEN_AT_KEYWORD, TOKEN_BAD_STRING, TOKEN_BAD_URL, TOKEN_CDC, TOKEN_CDO, TOKEN_COLON, TOKEN_COMMA, TOKEN_COMMENT, TOKEN_DELIM, TOKEN_DIMENSION, TOKEN_EOF, TOKEN_FUNCTION, TOKEN_HASH, TOKEN_IDENT, TOKEN_LEFT_BRACE, TOKEN_LEFT_BRACKET, TOKEN_LEFT_PAREN, TOKEN_NUMBER, TOKEN_PERCENTAGE, TOKEN_RIGHT_BRACE, TOKEN_RIGHT_BRACKET, TOKEN_RIGHT_PAREN, TOKEN_SEMICOLON, TOKEN_STRING, TOKEN_URL, TOKEN_WHITESPACE } from './token-types.js';

package/dist/parse-declaration.js

@@ -124,12 +124,16 @@ class DeclarationParser {
       this.arena.set_value_start_delta(declaration, trimmed[0] - prop_start);
       this.arena.set_value_length(declaration, trimmed[1] - trimmed[0]);
       if (this.value_parser) {
-        let valueNodes = this.value_parser.parse_value(value_start, trimmed[1], value_start_line, value_start_column);
-        this.arena.append_children(declaration, valueNodes);
+        let valueNode = this.value_parser.parse_value(value_start, trimmed[1], value_start_line, value_start_column);
+        this.arena.append_children(declaration, [valueNode]);
       }
     } else {
       this.arena.set_value_start_delta(declaration, value_start - prop_start);
       this.arena.set_value_length(declaration, 0);
+      if (this.value_parser) {
+        let valueNode = this.value_parser.parse_value(value_start, value_start, value_start_line, value_start_column);
+        this.arena.append_children(declaration, [valueNode]);
+      }
     }
     if (has_important) {
       this.arena.set_flag(declaration, FLAG_IMPORTANT);

package/dist/parse-selector.js

@@ -34,9 +34,13 @@ class SelectorParser {
     let list_column = this.lexer.column;
     while (this.lexer.pos < this.selector_end) {
       let selector_start = this.lexer.pos;
+      let selector_line = this.lexer.line;
+      let selector_column = this.lexer.column;
       let complex_selector = this.parse_complex_selector(allow_relative);
       if (complex_selector !== null) {
-        let selector_wrapper = this.create_node(SELECTOR, selector_start, this.lexer.pos);
+        let selector_wrapper = this.arena.create_node(SELECTOR, selector_start, this.lexer.pos - selector_start, selector_line, selector_column);
+        this.arena.set_content_start_delta(selector_wrapper, 0);
+        this.arena.set_content_length(selector_wrapper, this.lexer.pos - selector_start);
         let last_component = complex_selector;
         let next_sibling = this.arena.get_next_sibling(last_component);
         while (next_sibling !== 0) {
@@ -573,9 +577,11 @@ class SelectorParser {
     this.arena.set_content_length(node, end - start);
     return node;
   }
-  // Helper to skip whitespace
+  // Helper to skip whitespace and update line/column
   skip_whitespace() {
-    this.lexer.pos = skip_whitespace_forward(this.source, this.lexer.pos, this.selector_end);
+    while (this.lexer.pos < this.selector_end && is_whitespace(this.source.charCodeAt(this.lexer.pos))) {
+      this.lexer.advance();
+    }
   }
 }
 function parse_selector(source) {

package/dist/parse-value.d.ts

@@ -1,7 +1,7 @@
 import { CSSNode } from './css-node';
 /**
- * Parse a CSS declaration value string and return an array of value AST nodes
+ * Parse a CSS declaration value string and return a VALUE node
  * @param value_string - The CSS value to parse (e.g., "1px solid red")
- * @returns An array of CSSNode objects representing the parsed value
+ * @returns A CSSNode VALUE wrapper containing the parsed value tokens as children
  */
-export declare function parse_value(value_string: string): CSSNode[];
+export declare function parse_value(value_string: string): CSSNode;

package/dist/parse-value.js

@@ -1,5 +1,5 @@
 import { Lexer } from './tokenize.js';
-import { CSSDataArena, OPERATOR, HASH, STRING, DIMENSION, NUMBER, IDENTIFIER, URL, FUNCTION, PARENTHESIS } from './arena.js';
+import { CSSDataArena, VALUE, OPERATOR, HASH, STRING, DIMENSION, NUMBER, IDENTIFIER, URL, FUNCTION, PARENTHESIS } from './arena.js';
 import { TOKEN_EOF, TOKEN_LEFT_PAREN, TOKEN_COMMA, TOKEN_DELIM, TOKEN_FUNCTION, TOKEN_HASH, TOKEN_STRING, TOKEN_DIMENSION, TOKEN_PERCENTAGE, TOKEN_NUMBER, TOKEN_IDENT, TOKEN_RIGHT_PAREN } from './token-types.js';
 import { is_whitespace, CHAR_PLUS, CHAR_MINUS_HYPHEN, CHAR_ASTERISK, CHAR_FORWARD_SLASH, str_equals } from './string-utils.js';
 import { CSSNode } from './css-node.js';
@@ -15,14 +15,24 @@ class ValueParser {
     this.lexer = new Lexer(source, false);
     this.value_end = 0;
   }
-  // Parse a declaration value range into value nodes (standalone use)
-  // Returns array of value node indices
+  // Parse a declaration value range into a VALUE wrapper node
+  // Returns single VALUE node index
   parse_value(start, end, start_line, start_column) {
     this.value_end = end;
     this.lexer.pos = start;
     this.lexer.line = start_line;
     this.lexer.column = start_column;
-    return this.parse_value_tokens();
+    let value_nodes = this.parse_value_tokens();
+    if (value_nodes.length === 0) {
+      let value_node2 = this.arena.create_node(VALUE, start, 0, start_line, start_column);
+      return value_node2;
+    }
+    let first_node_start = this.arena.get_start_offset(value_nodes[0]);
+    let last_node_index = value_nodes[value_nodes.length - 1];
+    let last_node_end = this.arena.get_start_offset(last_node_index) + this.arena.get_length(last_node_index);
+    let value_node = this.arena.create_node(VALUE, first_node_start, last_node_end - first_node_start, start_line, start_column);
+    this.arena.append_children(value_node, value_nodes);
+    return value_node;
   }
   // Core token parsing logic
   parse_value_tokens() {
@@ -210,8 +220,8 @@ class ValueParser {
 function parse_value(value_string) {
   const arena = new CSSDataArena(CSSDataArena.capacity_for_source(value_string.length));
   const value_parser = new ValueParser(arena, value_string);
-  const node_indices = value_parser.parse_value(0, value_string.length, 1, 1);
-  return node_indices.map((index) => new CSSNode(arena, value_string, index));
+  const value_node_index = value_parser.parse_value(0, value_string.length, 1, 1);
+  return new CSSNode(arena, value_string, value_node_index);
 }
 
 export { ValueParser, parse_value };

package/dist/parse.js

@@ -1,5 +1,5 @@
 import { Lexer } from './tokenize.js';
-import { CSSDataArena, STYLESHEET, STYLE_RULE, FLAG_HAS_BLOCK, BLOCK, FLAG_HAS_DECLARATIONS, SELECTOR_LIST, AT_RULE } from './arena.js';
+import { CSSDataArena, STYLESHEET, STYLE_RULE, FLAG_HAS_BLOCK, BLOCK, FLAG_HAS_DECLARATIONS, SELECTOR_LIST, AT_RULE, AT_RULE_PRELUDE } from './arena.js';
 import { CSSNode } from './css-node.js';
 import { SelectorParser } from './parse-selector.js';
 import { AtRulePreludeParser } from './parse-atrule-prelude.js';
@@ -167,13 +167,13 @@ class Parser {
       this.next_token();
     }
     if (this.parse_selectors_enabled && this.selector_parser) {
-      let selectorNode = this.selector_parser.parse_selector(selector_start, last_end, selector_line, selector_column);
-      if (selectorNode !== null) {
-        return selectorNode;
+      let selector = this.selector_parser.parse_selector(selector_start, last_end, selector_line, selector_column);
+      if (selector !== null) {
+        return selector;
       }
     }
-    let selector = this.arena.create_node(SELECTOR_LIST, selector_start, last_end - selector_start, selector_line, selector_column);
-    return selector;
+    let selector_list = this.arena.create_node(SELECTOR_LIST, selector_start, last_end - selector_start, selector_line, selector_column);
+    return selector_list;
   }
   // Parse a declaration: property: value;
   parse_declaration() {
@@ -221,12 +221,16 @@ class Parser {
       this.next_token();
     }
     let trimmed = trim_boundaries(this.source, prelude_start, prelude_end);
-    let prelude_nodes = [];
+    let prelude_wrapper = null;
     if (trimmed) {
       this.arena.set_value_start_delta(at_rule, trimmed[0] - at_rule_start);
       this.arena.set_value_length(at_rule, trimmed[1] - trimmed[0]);
       if (this.prelude_parser) {
-        prelude_nodes = this.prelude_parser.parse_prelude(at_rule_name, trimmed[0], trimmed[1], at_rule_line, at_rule_column);
+        let prelude_nodes = this.prelude_parser.parse_prelude(at_rule_name, trimmed[0], trimmed[1], at_rule_line, at_rule_column);
+        if (prelude_nodes.length > 0) {
+          prelude_wrapper = this.arena.create_node(AT_RULE_PRELUDE, trimmed[0], trimmed[1] - trimmed[0], at_rule_line, at_rule_column);
+          this.arena.append_children(prelude_wrapper, prelude_nodes);
+        }
       }
     }
     let last_end = this.lexer.token_end;
@@ -304,13 +308,26 @@ class Parser {
         this.arena.set_length(block_node, last_end - block_start);
       }
       this.arena.append_children(block_node, block_children);
-      prelude_nodes.push(block_node);
+      let at_rule_children = [];
+      if (prelude_wrapper !== null) {
+        at_rule_children.push(prelude_wrapper);
+      }
+      at_rule_children.push(block_node);
+      this.arena.set_length(at_rule, last_end - at_rule_start);
+      this.arena.append_children(at_rule, at_rule_children);
     } else if (this.peek_type() === TOKEN_SEMICOLON) {
       last_end = this.lexer.token_end;
       this.next_token();
+      this.arena.set_length(at_rule, last_end - at_rule_start);
+      if (prelude_wrapper !== null) {
+        this.arena.append_children(at_rule, [prelude_wrapper]);
+      }
+    } else {
+      this.arena.set_length(at_rule, last_end - at_rule_start);
+      if (prelude_wrapper !== null) {
+        this.arena.append_children(at_rule, [prelude_wrapper]);
+      }
     }
-    this.arena.set_length(at_rule, last_end - at_rule_start);
-    this.arena.append_children(at_rule, prelude_nodes);
     return at_rule;
   }
   // Determine if an at-rule contains declarations or nested rules

package/dist/tokenize.js

@@ -1,5 +1,5 @@
-import { is_whitespace, is_newline, is_digit, is_ident_start, is_hex_digit, is_ident_char } from './char-types.js';
-import { TOKEN_EOF, TOKEN_LEFT_BRACE, TOKEN_RIGHT_BRACE, TOKEN_COLON, TOKEN_SEMICOLON, TOKEN_COMMA, TOKEN_LEFT_BRACKET, TOKEN_RIGHT_BRACKET, TOKEN_LEFT_PAREN, TOKEN_RIGHT_PAREN, TOKEN_CDO, TOKEN_CDC, TOKEN_DELIM, TOKEN_WHITESPACE, TOKEN_COMMENT, TOKEN_STRING, TOKEN_BAD_STRING, TOKEN_PERCENTAGE, TOKEN_DIMENSION, TOKEN_NUMBER, TOKEN_FUNCTION, TOKEN_IDENT, TOKEN_AT_KEYWORD, TOKEN_HASH } from './token-types.js';
+import { char_types, CHAR_WHITESPACE, CHAR_NEWLINE, CHAR_DIGIT, is_ident_start, is_newline, is_hex_digit, is_whitespace, is_ident_char } from './char-types.js';
+import { TOKEN_EOF, TOKEN_RIGHT_PAREN, TOKEN_LEFT_PAREN, TOKEN_RIGHT_BRACKET, TOKEN_LEFT_BRACKET, TOKEN_COMMA, TOKEN_SEMICOLON, TOKEN_COLON, TOKEN_RIGHT_BRACE, TOKEN_LEFT_BRACE, TOKEN_CDO, TOKEN_CDC, TOKEN_DELIM, TOKEN_WHITESPACE, TOKEN_COMMENT, TOKEN_STRING, TOKEN_BAD_STRING, TOKEN_PERCENTAGE, TOKEN_DIMENSION, TOKEN_NUMBER, TOKEN_FUNCTION, TOKEN_IDENT, TOKEN_AT_KEYWORD, TOKEN_HASH } from './token-types.js';
 
 const CHAR_LEFT_BRACE = 123;
 const CHAR_RIGHT_BRACE = 125;
@@ -57,7 +57,7 @@ class Lexer {
     if (skip_whitespace) {
       while (this.pos < this.source.length) {
         let ch2 = this.source.charCodeAt(this.pos);
-        if (!is_whitespace(ch2) && !is_newline(ch2)) break;
+        if (ch2 >= 128 || (char_types[ch2] & (CHAR_WHITESPACE | CHAR_NEWLINE)) === 0) break;
         this.advance();
       }
     }
@@ -68,43 +68,36 @@ class Lexer {
     let start = this.pos;
     let start_line = this.line;
     let start_column = this.column;
-    if (ch === CHAR_LEFT_BRACE) {
-      this.advance();
-      return this.make_token(TOKEN_LEFT_BRACE, start, this.pos, start_line, start_column);
-    }
-    if (ch === CHAR_RIGHT_BRACE) {
-      this.advance();
-      return this.make_token(TOKEN_RIGHT_BRACE, start, this.pos, start_line, start_column);
-    }
-    if (ch === CHAR_COLON) {
-      this.advance();
-      return this.make_token(TOKEN_COLON, start, this.pos, start_line, start_column);
-    }
-    if (ch === CHAR_SEMICOLON) {
-      this.advance();
-      return this.make_token(TOKEN_SEMICOLON, start, this.pos, start_line, start_column);
-    }
-    if (ch === CHAR_COMMA) {
-      this.advance();
-      return this.make_token(TOKEN_COMMA, start, this.pos, start_line, start_column);
-    }
-    if (ch === CHAR_LEFT_BRACKET) {
-      this.advance();
-      return this.make_token(TOKEN_LEFT_BRACKET, start, this.pos, start_line, start_column);
-    }
-    if (ch === CHAR_RIGHT_BRACKET) {
-      this.advance();
-      return this.make_token(TOKEN_RIGHT_BRACKET, start, this.pos, start_line, start_column);
-    }
-    if (ch === CHAR_LEFT_PAREN) {
-      this.advance();
-      return this.make_token(TOKEN_LEFT_PAREN, start, this.pos, start_line, start_column);
-    }
-    if (ch === CHAR_RIGHT_PAREN) {
-      this.advance();
-      return this.make_token(TOKEN_RIGHT_PAREN, start, this.pos, start_line, start_column);
+    switch (ch) {
+      case CHAR_LEFT_BRACE:
+        this.advance();
+        return this.make_token(TOKEN_LEFT_BRACE, start, this.pos, start_line, start_column);
+      case CHAR_RIGHT_BRACE:
+        this.advance();
+        return this.make_token(TOKEN_RIGHT_BRACE, start, this.pos, start_line, start_column);
+      case CHAR_COLON:
+        this.advance();
+        return this.make_token(TOKEN_COLON, start, this.pos, start_line, start_column);
+      case CHAR_SEMICOLON:
+        this.advance();
+        return this.make_token(TOKEN_SEMICOLON, start, this.pos, start_line, start_column);
+      case CHAR_COMMA:
+        this.advance();
+        return this.make_token(TOKEN_COMMA, start, this.pos, start_line, start_column);
+      case CHAR_LEFT_BRACKET:
+        this.advance();
+        return this.make_token(TOKEN_LEFT_BRACKET, start, this.pos, start_line, start_column);
+      case CHAR_RIGHT_BRACKET:
+        this.advance();
+        return this.make_token(TOKEN_RIGHT_BRACKET, start, this.pos, start_line, start_column);
+      case CHAR_LEFT_PAREN:
+        this.advance();
+        return this.make_token(TOKEN_LEFT_PAREN, start, this.pos, start_line, start_column);
+      case CHAR_RIGHT_PAREN:
+        this.advance();
+        return this.make_token(TOKEN_RIGHT_PAREN, start, this.pos, start_line, start_column);
     }
-    if (is_whitespace(ch) || is_newline(ch)) {
+    if (ch < 128 && (char_types[ch] & (CHAR_WHITESPACE | CHAR_NEWLINE)) !== 0) {
       return this.consume_whitespace(start_line, start_column);
     }
     if (ch === CHAR_FORWARD_SLASH && this.peek() === CHAR_ASTERISK) {
@@ -112,7 +105,7 @@ class Lexer {
         this.advance(2);
         while (this.pos < this.source.length - 1) {
           let ch2 = this.source.charCodeAt(this.pos);
-          if (ch2 === CHAR_ASTERISK && this.source.charCodeAt(this.pos + 1) === CHAR_FORWARD_SLASH) {
+          if (ch2 === CHAR_ASTERISK && this.peek() === CHAR_FORWARD_SLASH) {
             this.advance(2);
             break;
           }
@@ -125,20 +118,23 @@ class Lexer {
     if (ch === CHAR_DOUBLE_QUOTE || ch === CHAR_SINGLE_QUOTE) {
       return this.consume_string(ch, start_line, start_column);
     }
-    if (is_digit(ch)) {
+    if (ch < 128 && (char_types[ch] & CHAR_DIGIT) !== 0) {
       return this.consume_number(start_line, start_column);
     }
-    if (ch === CHAR_DOT && is_digit(this.peek())) {
-      return this.consume_number(start_line, start_column);
+    if (ch === CHAR_DOT) {
+      let next = this.peek();
+      if (next < 128 && (char_types[next] & CHAR_DIGIT) !== 0) {
+        return this.consume_number(start_line, start_column);
+      }
     }
     if (ch === CHAR_LESS_THAN && this.pos + 3 < this.source.length) {
-      if (this.source.charCodeAt(this.pos + 1) === CHAR_EXCLAMATION && this.source.charCodeAt(this.pos + 2) === CHAR_HYPHEN && this.source.charCodeAt(this.pos + 3) === CHAR_HYPHEN) {
+      if (this.peek() === CHAR_EXCLAMATION && this.peek(2) === CHAR_HYPHEN && this.peek(3) === CHAR_HYPHEN) {
         this.advance(4);
         return this.make_token(TOKEN_CDO, start, this.pos, start_line, start_column);
       }
     }
     if (ch === CHAR_HYPHEN && this.pos + 2 < this.source.length) {
-      if (this.source.charCodeAt(this.pos + 1) === CHAR_HYPHEN && this.source.charCodeAt(this.pos + 2) === CHAR_GREATER_THAN) {
+      if (this.peek() === CHAR_HYPHEN && this.peek(2) === CHAR_GREATER_THAN) {
         this.advance(3);
         return this.make_token(TOKEN_CDC, start, this.pos, start_line, start_column);
       }
@@ -166,9 +162,16 @@ class Lexer {
     }
     if (ch === CHAR_HYPHEN || ch === CHAR_PLUS) {
       let next = this.peek();
-      if (is_digit(next) || next === CHAR_DOT && is_digit(this.peek(2))) {
+      let is_next_digit = next < 128 && (char_types[next] & CHAR_DIGIT) !== 0;
+      if (is_next_digit) {
         return this.consume_number(start_line, start_column);
       }
+      if (next === CHAR_DOT) {
+        let next2 = this.peek(2);
+        if (next2 < 128 && (char_types[next2] & CHAR_DIGIT) !== 0) {
+          return this.consume_number(start_line, start_column);
+        }
+      }
     }
     this.advance();
     return this.make_token(TOKEN_DELIM, start, this.pos, start_line, start_column);
@@ -177,7 +180,7 @@ class Lexer {
     let start = this.pos;
     while (this.pos < this.source.length) {
       let ch = this.source.charCodeAt(this.pos);
-      if (!is_whitespace(ch) && !is_newline(ch)) break;
+      if (ch >= 128 || (char_types[ch] & (CHAR_WHITESPACE | CHAR_NEWLINE)) === 0) break;
       this.advance();
     }
     return this.make_token(TOKEN_WHITESPACE, start, this.pos, start_line, start_column);
@@ -187,7 +190,7 @@ class Lexer {
     this.advance(2);
     while (this.pos < this.source.length - 1) {
       let ch = this.source.charCodeAt(this.pos);
-      if (ch === CHAR_ASTERISK && this.source.charCodeAt(this.pos + 1) === CHAR_FORWARD_SLASH) {
+      if (ch === CHAR_ASTERISK && this.peek() === CHAR_FORWARD_SLASH) {
         this.advance(2);
         break;
       }
@@ -246,20 +249,30 @@ class Lexer {
     if (ch === CHAR_PLUS || ch === CHAR_HYPHEN) {
       this.advance();
     }
-    while (this.pos < this.source.length && is_digit(this.source.charCodeAt(this.pos))) {
+    while (this.pos < this.source.length) {
+      let ch2 = this.source.charCodeAt(this.pos);
+      if (ch2 >= 128 || (char_types[ch2] & CHAR_DIGIT) === 0) break;
       this.advance();
     }
-    if (this.pos < this.source.length && this.source.charCodeAt(this.pos) === CHAR_DOT && this.pos + 1 < this.source.length && is_digit(this.source.charCodeAt(this.pos + 1))) {
-      this.advance();
-      while (this.pos < this.source.length && is_digit(this.source.charCodeAt(this.pos))) {
+    if (this.pos < this.source.length && this.source.charCodeAt(this.pos) === CHAR_DOT && this.pos + 1 < this.source.length) {
+      let next = this.peek();
+      if (next < 128 && (char_types[next] & CHAR_DIGIT) !== 0) {
         this.advance();
+        while (this.pos < this.source.length) {
+          let ch2 = this.source.charCodeAt(this.pos);
+          if (ch2 >= 128 || (char_types[ch2] & CHAR_DIGIT) === 0) break;
+          this.advance();
+        }
       }
     }
     if (this.pos < this.source.length) {
       let ch2 = this.source.charCodeAt(this.pos);
       if (ch2 === CHAR_LOWERCASE_E || ch2 === CHAR_UPPERCASE_E) {
         let next = this.peek();
-        if (is_digit(next) || (next === CHAR_PLUS || next === CHAR_HYPHEN) && is_digit(this.peek(2))) {
+        let is_next_digit = next < 128 && (char_types[next] & CHAR_DIGIT) !== 0;
+        let next2 = this.peek(2);
+        let is_next2_digit = next2 < 128 && (char_types[next2] & CHAR_DIGIT) !== 0;
+        if (is_next_digit || (next === CHAR_PLUS || next === CHAR_HYPHEN) && is_next2_digit) {
           this.advance();
           if (this.pos < this.source.length) {
             let sign = this.source.charCodeAt(this.pos);
@@ -267,7 +280,9 @@ class Lexer {
               this.advance();
             }
           }
-          while (this.pos < this.source.length && is_digit(this.source.charCodeAt(this.pos))) {
+          while (this.pos < this.source.length) {
+            let ch3 = this.source.charCodeAt(this.pos);
+            if (ch3 >= 128 || (char_types[ch3] & CHAR_DIGIT) === 0) break;
             this.advance();
           }
         }
@@ -294,7 +309,7 @@ class Lexer {
       let ch = this.source.charCodeAt(this.pos);
       if (ch === CHAR_BACKSLASH) {
         if (this.pos + 1 >= this.source.length) break;
-        let next = this.source.charCodeAt(this.pos + 1);
+        let next = this.peek();
         if (is_newline(next)) break;
         this.advance();
         if (is_hex_digit(next)) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@projectwallace/css-parser",
-	"version": "0.9.0",
+	"version": "0.11.0",
 	"description": "High-performance CSS lexer and parser, optimized for CSS inspection and analysis",
 	"author": "Bart Veneman <bart@projectwallace.com>",
 	"license": "MIT",
@@ -60,7 +60,8 @@
 		"benchmark:memory": "npm run build && node --expose-gc benchmark/memory.ts",
 		"lint": "oxlint --config .oxlintrc.json",
 		"lint-package": "publint",
-		"check": "tsc --noEmit"
+		"check": "tsc --noEmit",
+		"precommit": "npm run test -- --run; npm run lint; npm run check"
 	},
 	"keywords": [
 		"css",