@projectwallace/css-parser 0.8.4 → 0.8.6

package/dist/arena.js

@@ -1,4 +1,4 @@
-let BYTES_PER_NODE = 32;
+let BYTES_PER_NODE = 36;
 const STYLESHEET = 1;
 const STYLE_RULE = 2;
 const AT_RULE = 3;
@@ -37,6 +37,7 @@ const LAYER_NAME = 37;
 const PRELUDE_OPERATOR = 38;
 const FLAG_IMPORTANT = 1 << 0;
 const FLAG_HAS_ERROR = 1 << 1;
+const FLAG_LENGTH_OVERFLOW = 1 << 2;
 const FLAG_HAS_BLOCK = 1 << 3;
 const FLAG_HAS_DECLARATIONS = 1 << 5;
 const FLAG_HAS_PARENS = 1 << 6;
@@ -57,17 +58,23 @@ class CSSDataArena {
   // Number of nodes that can fit
   count;
   // Number of nodes currently allocated
+  growth_count;
+  // Number of times the arena has grown
+  overflow_lengths;
+  // Stores actual lengths for nodes > 65535 chars
   // 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 = 60;
+  static NODES_PER_KB = 270;
   // Buffer to avoid frequent growth (15%)
-  static CAPACITY_BUFFER = 1.15;
+  static CAPACITY_BUFFER = 1.2;
   constructor(initial_capacity = 1024) {
     this.capacity = initial_capacity;
     this.count = 1;
+    this.growth_count = 0;
     this.buffer = new ArrayBuffer(initial_capacity * BYTES_PER_NODE);
     this.view = new DataView(this.buffer);
+    this.overflow_lengths = /* @__PURE__ */ new Map();
   }
   // Calculate recommended initial capacity based on CSS source size
   static capacity_for_source(source_length) {
@@ -84,6 +91,10 @@ class CSSDataArena {
   get_capacity() {
     return this.capacity;
   }
+  // Get the number of times the arena has grown
+  get_growth_count() {
+    return this.growth_count;
+  }
   // Calculate byte offset for a node
   node_offset(node_index) {
     return node_index * BYTES_PER_NODE;
@@ -102,6 +113,12 @@ class CSSDataArena {
   }
   // Read length in source
   get_length(node_index) {
+    if (this.has_flag(node_index, FLAG_LENGTH_OVERFLOW)) {
+      const overflow_length = this.overflow_lengths.get(node_index);
+      if (overflow_length !== void 0) {
+        return overflow_length;
+      }
+    }
     return this.view.getUint16(this.node_offset(node_index) + 2, true);
   }
   // Read content start offset (stored as delta from startOffset)
@@ -116,11 +133,11 @@ class CSSDataArena {
   }
   // Read attribute operator (for NODE_SELECTOR_ATTRIBUTE)
   get_attr_operator(node_index) {
-    return this.view.getUint8(this.node_offset(node_index) + 30);
+    return this.view.getUint8(this.node_offset(node_index) + 32);
   }
   // Read attribute flags (for NODE_SELECTOR_ATTRIBUTE)
   get_attr_flags(node_index) {
-    return this.view.getUint8(this.node_offset(node_index) + 31);
+    return this.view.getUint8(this.node_offset(node_index) + 33);
   }
   // Read first child index (0 = no children)
   get_first_child(node_index) {
@@ -136,7 +153,7 @@ class CSSDataArena {
   }
   // Read start column
   get_start_column(node_index) {
-    return this.view.getUint16(this.node_offset(node_index) + 28, true);
+    return this.view.getUint32(this.node_offset(node_index) + 28, true);
   }
   // Read value start offset (stored as delta from startOffset, declaration value / at-rule prelude)
   get_value_start(node_index) {
@@ -157,13 +174,15 @@ class CSSDataArena {
   set_flags(node_index, flags) {
     this.view.setUint8(this.node_offset(node_index) + 1, flags);
   }
-  // Write start offset in source
-  set_start_offset(node_index, offset) {
-    this.view.setUint32(this.node_offset(node_index) + 12, offset, true);
-  }
   // Write length in source
   set_length(node_index, length) {
-    this.view.setUint16(this.node_offset(node_index) + 2, length, true);
+    if (length > 65535) {
+      this.view.setUint16(this.node_offset(node_index) + 2, 65535, true);
+      this.set_flag(node_index, FLAG_LENGTH_OVERFLOW);
+      this.overflow_lengths.set(node_index, length);
+    } else {
+      this.view.setUint16(this.node_offset(node_index) + 2, length, true);
+    }
   }
   // Write content start delta (offset from startOffset)
   set_content_start_delta(node_index, delta) {
@@ -175,11 +194,11 @@ class CSSDataArena {
   }
   // Write attribute operator (for NODE_SELECTOR_ATTRIBUTE)
   set_attr_operator(node_index, operator) {
-    this.view.setUint8(this.node_offset(node_index) + 30, operator);
+    this.view.setUint8(this.node_offset(node_index) + 32, operator);
   }
   // Write attribute flags (for NODE_SELECTOR_ATTRIBUTE)
   set_attr_flags(node_index, flags) {
-    this.view.setUint8(this.node_offset(node_index) + 31, flags);
+    this.view.setUint8(this.node_offset(node_index) + 33, flags);
   }
   // Write first child index
   set_first_child(node_index, childIndex) {
@@ -189,14 +208,6 @@ class CSSDataArena {
   set_next_sibling(node_index, siblingIndex) {
     this.view.setUint32(this.node_offset(node_index) + 8, siblingIndex, true);
   }
-  // Write start line
-  set_start_line(node_index, line) {
-    this.view.setUint32(this.node_offset(node_index) + 24, line, true);
-  }
-  // Write start column
-  set_start_column(node_index, column) {
-    this.view.setUint16(this.node_offset(node_index) + 28, column, true);
-  }
   // Write value start delta (offset from startOffset, declaration value / at-rule prelude)
   set_value_start_delta(node_index, delta) {
     this.view.setUint16(this.node_offset(node_index) + 18, delta, true);
@@ -208,6 +219,7 @@ class CSSDataArena {
   // --- Node Creation ---
   // Grow the arena by 1.3x when capacity is exceeded
   grow() {
+    this.growth_count++;
     let new_capacity = Math.ceil(this.capacity * CSSDataArena.GROWTH_FACTOR);
     let new_buffer = new ArrayBuffer(new_capacity * BYTES_PER_NODE);
     new Uint8Array(new_buffer).set(new Uint8Array(this.buffer));
@@ -225,10 +237,10 @@ class CSSDataArena {
     this.count++;
     const offset = node_index * BYTES_PER_NODE;
     this.view.setUint8(offset, type);
-    this.view.setUint16(offset + 2, length, true);
     this.view.setUint32(offset + 12, start_offset, true);
     this.view.setUint32(offset + 24, start_line, true);
-    this.view.setUint16(offset + 28, start_column, true);
+    this.view.setUint32(offset + 28, start_column, true);
+    this.set_length(node_index, length);
     return node_index;
   }
   // --- Tree Building Helpers ---
@@ -267,4 +279,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, FLAG_HAS_BLOCK, FLAG_HAS_DECLARATIONS, FLAG_HAS_ERROR, FLAG_HAS_PARENS, 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 };
+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, 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 };

package/dist/css-node.d.ts

@@ -80,6 +80,8 @@ export declare class CSSNode {
     private source;
     private index;
     constructor(arena: CSSDataArena, source: string, index: number);
+    /** Get the arena (for internal/advanced use only) */
+    __get_arena(): CSSDataArena;
     /** Get node type as number (for performance) */
     get type(): CSSNodeType;
     /** Get node type as human-readable string */
@@ -200,25 +202,12 @@ export declare class CSSNode {
     /** Get text of first compound selector (no node allocation) */
     get first_compound_text(): string;
     /**
-     * Clone this node as a mutable plain JavaScript object
-     *
-     * Extracts all properties from the arena into a plain object with children as an array.
-     * The resulting object can be freely modified.
+     * 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)
-     * @returns Plain object with children as array
-     *
-     * @example
-     * const ast = parse('div { color: red; }')
-     * const decl = ast.first_child.block.first_child
-     * const plain = decl.clone()
-     *
-     * // Access children as array
-     * plain.children.length
-     * plain.children[0]
-     * plain.children.push(newChild)
      */
     clone(options?: CloneOptions): PlainCSSNode;
 }

package/dist/css-node.js

@@ -49,6 +49,10 @@ class CSSNode {
     this.source = source;
     this.index = index;
   }
+  /** Get the arena (for internal/advanced use only) */
+  __get_arena() {
+    return this.arena;
+  }
   /** Get node type as number (for performance) */
   get type() {
     return this.arena.get_type(this.index);
@@ -450,25 +454,12 @@ class CSSNode {
   }
   // --- Node Cloning ---
   /**
-   * Clone this node as a mutable plain JavaScript object
-   *
-   * Extracts all properties from the arena into a plain object with children as an array.
-   * The resulting object can be freely modified.
+   * 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)
-   * @returns Plain object with children as array
-   *
-   * @example
-   * const ast = parse('div { color: red; }')
-   * const decl = ast.first_child.block.first_child
-   * const plain = decl.clone()
-   *
-   * // Access children as array
-   * plain.children.length
-   * plain.children[0]
-   * plain.children.push(newChild)
    */
   clone(options = {}) {
     const { deep = true, locations = false } = options;

package/dist/index.d.ts

@@ -5,9 +5,10 @@ export { parse_declaration } from './parse-declaration';
 export { parse_value } from './parse-value';
 export { tokenize } from './tokenize';
 export { walk, traverse, SKIP, BREAK } from './walk';
+export { is_custom, is_vendor_prefixed, str_equals, str_starts_with, str_index_of } from './string-utils';
 export { type ParserOptions } from './parse';
 export { CSSNode, type CSSNodeType, TYPE_NAMES, type CloneOptions, type PlainCSSNode } from './css-node';
-export type { LexerPosition } from './lexer';
+export type { LexerPosition } from './tokenize';
 export { 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 * from './constants';
 export * from './token-types';

package/dist/index.js

@@ -5,6 +5,7 @@ export { parse_declaration } from './parse-declaration.js';
 export { parse_value } from './parse-value.js';
 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, 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 { NODE_TYPES } from './constants.js';

package/dist/parse-anplusb.js

@@ -1,4 +1,4 @@
-import { Lexer } from './lexer.js';
+import { Lexer } from './tokenize.js';
 import { NTH_SELECTOR, CSSDataArena } from './arena.js';
 import { TOKEN_IDENT, TOKEN_DELIM, TOKEN_DIMENSION, TOKEN_NUMBER } from './token-types.js';
 import { str_equals, CHAR_MINUS_HYPHEN, CHAR_PLUS, str_index_of } from './string-utils.js';

package/dist/parse-atrule-prelude.js

@@ -1,4 +1,4 @@
-import { Lexer } from './lexer.js';
+import { Lexer } from './tokenize.js';
 import { CSSDataArena, PRELUDE_OPERATOR, MEDIA_TYPE, MEDIA_QUERY, MEDIA_FEATURE, IDENTIFIER, CONTAINER_QUERY, SUPPORTS_QUERY, LAYER_NAME, URL } from './arena.js';
 import { TOKEN_COMMA, TOKEN_IDENT, TOKEN_LEFT_PAREN, TOKEN_RIGHT_PAREN, TOKEN_WHITESPACE, TOKEN_URL, TOKEN_FUNCTION, TOKEN_STRING, TOKEN_EOF } from './token-types.js';
 import { str_equals } from './string-utils.js';

package/dist/parse-declaration.js

@@ -1,4 +1,4 @@
-import { Lexer } from './lexer.js';
+import { Lexer } from './tokenize.js';
 import { CSSDataArena, DECLARATION, FLAG_IMPORTANT } from './arena.js';
 import { ValueParser } from './parse-value.js';
 import { TOKEN_IDENT, TOKEN_COLON, TOKEN_EOF, TOKEN_SEMICOLON, TOKEN_RIGHT_BRACE, TOKEN_LEFT_BRACE, TOKEN_DELIM } from './token-types.js';

package/dist/parse-selector.js

@@ -1,4 +1,4 @@
-import { Lexer } from './lexer.js';
+import { Lexer } from './tokenize.js';
 import { CSSDataArena, SELECTOR_LIST, SELECTOR, COMBINATOR, NESTING_SELECTOR, ID_SELECTOR, TYPE_SELECTOR, UNIVERSAL_SELECTOR, CLASS_SELECTOR, ATTRIBUTE_SELECTOR, ATTR_OPERATOR_NONE, ATTR_FLAG_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_CASE_INSENSITIVE, ATTR_FLAG_CASE_SENSITIVE, PSEUDO_ELEMENT_SELECTOR, PSEUDO_CLASS_SELECTOR, FLAG_HAS_PARENS, LANG_SELECTOR, NTH_OF_SELECTOR } from './arena.js';
 import { TOKEN_COMMA, TOKEN_DELIM, TOKEN_EOF, TOKEN_WHITESPACE, TOKEN_FUNCTION, TOKEN_COLON, TOKEN_LEFT_BRACKET, TOKEN_HASH, TOKEN_IDENT, TOKEN_RIGHT_BRACKET, TOKEN_LEFT_PAREN, TOKEN_RIGHT_PAREN, TOKEN_STRING } from './token-types.js';
 import { skip_whitespace_and_comments_forward, skip_whitespace_and_comments_backward, skip_whitespace_forward } from './parse-utils.js';

package/dist/parse-value.js

@@ -1,4 +1,4 @@
-import { Lexer } from './lexer.js';
+import { Lexer } from './tokenize.js';
 import { CSSDataArena, 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';

package/dist/parse.js

@@ -1,4 +1,4 @@
-import { Lexer } from './lexer.js';
+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 { CSSNode } from './css-node.js';
 import { SelectorParser } from './parse-selector.js';

package/dist/string-utils.d.ts

@@ -67,3 +67,17 @@ export declare function str_index_of(str: string, searchChar: string): number;
  */
 export declare function is_vendor_prefixed(text: string): boolean;
 export declare function is_vendor_prefixed(source: string, start: number, end: number): boolean;
+/**
+ * Check if a string is a CSS custom property (starts with --)
+ *
+ * @param str - The string to check
+ * @returns true if the string starts with -- (custom property)
+ *
+ * Examples:
+ * - `--primary-color` → true
+ * - `--my-var` → true
+ * - `-webkit-transform` → false (vendor prefix, not custom)
+ * - `border-radius` → false (standard property)
+ * - `color` → false
+ */
+export declare function is_custom(str: string): boolean;

package/dist/string-utils.js

@@ -109,5 +109,9 @@ function is_vendor_prefixed(source, start, end) {
   }
   return false;
 }
+function is_custom(str) {
+  if (str.length < 3) return false;
+  return str.charCodeAt(0) === CHAR_MINUS_HYPHEN && str.charCodeAt(1) === CHAR_MINUS_HYPHEN;
+}
 
-export { CHAR_AMPERSAND, CHAR_ASTERISK, CHAR_CARET, CHAR_CARRIAGE_RETURN, CHAR_COLON, CHAR_DOLLAR, CHAR_DOUBLE_QUOTE, CHAR_EQUALS, CHAR_FORM_FEED, CHAR_FORWARD_SLASH, CHAR_GREATER_THAN, CHAR_MINUS_HYPHEN, CHAR_NEWLINE, CHAR_PERIOD, CHAR_PIPE, CHAR_PLUS, CHAR_SINGLE_QUOTE, CHAR_SPACE, CHAR_TAB, CHAR_TILDE, is_combinator, is_digit, is_vendor_prefixed, is_whitespace, str_equals, str_index_of, str_starts_with };
+export { CHAR_AMPERSAND, CHAR_ASTERISK, CHAR_CARET, CHAR_CARRIAGE_RETURN, CHAR_COLON, CHAR_DOLLAR, CHAR_DOUBLE_QUOTE, CHAR_EQUALS, CHAR_FORM_FEED, CHAR_FORWARD_SLASH, CHAR_GREATER_THAN, CHAR_MINUS_HYPHEN, CHAR_NEWLINE, CHAR_PERIOD, CHAR_PIPE, CHAR_PLUS, CHAR_SINGLE_QUOTE, CHAR_SPACE, CHAR_TAB, CHAR_TILDE, is_combinator, is_custom, is_digit, is_vendor_prefixed, is_whitespace, str_equals, str_index_of, str_starts_with };

package/dist/tokenize.d.ts

@@ -1,4 +1,14 @@
-import type { Token } from './token-types';
+import { type Token, type TokenType } from './token-types';
+export interface LexerPosition {
+    pos: number;
+    line: number;
+    column: number;
+    token_type: TokenType;
+    token_start: number;
+    token_end: number;
+    token_line: number;
+    token_column: number;
+}
 /**
  * Tokenize CSS source code
  * @param source - The CSS source code to tokenize