@projectwallace/css-parser 0.18.12 → 0.19.1

package/README.md

@@ -14,7 +14,7 @@ Heavily influenced by [CSSTree](https://github.com/csstree/csstree). Some parsin
 - **Full modern CSS** — CSS Nesting, `:is()`, `:where()`, `:has()`, `@layer`, `@container`
 - **Error-tolerant** — keeps parsing through malformed input; one bad rule won't kill the file
 - **Precise source locations** — line, column, offset, and length on every node
-- **Tiny footprint** — tree-shakeable subparsers; as small as 278 bytes gzipped, < 16 kB kB worst case
+- **Tiny footprint** — tree-shakeable subparsers; as small as 278 bytes gzipped, < 16 kB worst case
 
 ## Installation
 
@@ -65,34 +65,30 @@ for (const rule of ast) {
 
 ## API
 
-Everything is exported from the package root. Each part is also available from its own entry point, so you can import only what you need and skip evaluating the rest of the package. Node properties and return types ship as TypeScript types, so this section sticks to short examples.
+Everything is exported from the package root. Each part is also available from its own entry point, so you can import only what you need. Node properties and return types ship as TypeScript types.
 
 ### Entry points
 
-| Import                                            | Exports                                                                                                   |
-| ------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
-| `@projectwallace/css-parser`                      | Everything below, except the `Lexer` and `Parser` classes                                                 |
-| `@projectwallace/css-parser/parse`                | `parse`, `Parser`, `ParserOptions`                                                                        |
-| `@projectwallace/css-parser/parse-selector`       | `parse_selector`, `parse_selector_list`                                                                   |
-| `@projectwallace/css-parser/parse-atrule-prelude` | `parse_atrule_prelude`                                                                                    |
-| `@projectwallace/css-parser/parse-declaration`    | `parse_declaration`                                                                                       |
-| `@projectwallace/css-parser/parse-value`          | `parse_value`                                                                                             |
-| `@projectwallace/css-parser/parse-anplusb`        | `parse_anplusb`                                                                                           |
-| `@projectwallace/css-parser/parse-dimension`      | `parse_dimension`                                                                                         |
-| `@projectwallace/css-parser/tokenizer`            | `tokenize`, `Lexer`                                                                                       |
-| `@projectwallace/css-parser/walker`               | `walk`, `traverse`, `SKIP`, `BREAK`                                                                       |
-| `@projectwallace/css-parser/nodes`                | Node type constants (`STYLE_RULE`, `DECLARATION`, …), `NODE_TYPES`                                        |
-| `@projectwallace/css-parser/node-types`           | Type guards (`is_declaration`, `is_rule`, …) and node types (`CSSNode`, `Rule`, `Declaration`, …)         |
-| `@projectwallace/css-parser/string-utils`         | `is_custom`, `is_vendor_prefixed`, `strip_vendor_prefix`, `str_equals`, `str_starts_with`, `str_index_of` |
-| `@projectwallace/css-parser/token-types`          | Token type constants (`TOKEN_*`)                                                                          |
+- `@projectwallace/css-parser` — everything below, except the `Lexer` and `Parser` classes
+- `/parse` — `parse`, `Parser`, `ParserOptions`
+- `/parse-selector` — `parse_selector`, `parse_selector_list`
+- `/parse-atrule-prelude` — `parse_atrule_prelude`
+- `/parse-declaration` — `parse_declaration`
+- `/parse-value` — `parse_value`
+- `/parse-anplusb` — `parse_anplusb`
+- `/parse-dimension` — `parse_dimension`
+- `/tokenizer` — `tokenize`, `Lexer`
+- `/walker` — `walk`, `traverse`, `SKIP`, `BREAK`
+- `/nodes` — node type constants (`STYLE_RULE`, `DECLARATION`, …), `NODE_TYPES`
+- `/node-types` — type guards (`is_declaration`, `is_rule`, …) and node types (`CSSNode`, `Rule`, …)
+- `/string-utils` — `is_custom`, `is_vendor_prefixed`, `strip_vendor_prefix`, `str_equals`, `str_starts_with`, `str_index_of`
+- `/token-types` — token type constants (`TOKEN_*`)
 
 ### `parse(source, options?)`
 
-Parses a full stylesheet and returns the root `StyleSheet` node. Nodes are iterable and expose `first_child`, `next_sibling`, `children`, `text`, `line`, `column`, `start`, `end` and `length`.
+Returns the root `StyleSheet` node. Nodes are iterable and expose `first_child`, `next_sibling`, `children`, `text`, `line`, `column`, `start`, `end` and `length`.
 
 ```typescript
-import { parse } from '@projectwallace/css-parser'
-
 const ast = parse('body { color: red; }')
 const rule = ast.first_child
 rule.block.first_child.property // "color"
@@ -104,72 +100,26 @@ Options:
 - `parse_values` (default `true`) — parse declaration values into nodes
 - `parse_selectors` (default `true`) — parse selectors into nodes
 - `parse_atrule_preludes` (default `true`) — parse at-rule preludes into nodes
-- `on_comment` — called for every comment; comments are never part of the tree
-
-```typescript
-const comments = []
-parse('/* hi */ a { color: red }', {
-	parse_values: false,
-	on_comment: (info) => comments.push(info), // { start, end, length, line, column }
-})
-```
-
-### `parse_selector(source)` and `parse_selector_list(source)`
+- `on_comment` — called for every comment (`{ start, end, length, line, column }`); comments are never part of the tree
 
-`parse_selector` returns the first selector, `parse_selector_list` the whole `SelectorList`.
+### Sub-parsers
 
 ```typescript
-import { parse_selector, parse_selector_list } from '@projectwallace/css-parser'
-
 parse_selector('a.b > c').children.map((part) => part.text) // ["a", ".b", ">", "c"]
 parse_selector_list('h1, h2').children.map((s) => s.text) // ["h1", "h2"]
-```
-
-### `parse_declaration(source)`
-
-```typescript
-import { parse_declaration } from '@projectwallace/css-parser'
 
 const decl = parse_declaration('color: red !important')
 decl.property // "color"
 decl.is_important // true
-decl.value.text // "red"
-```
-
-### `parse_value(source)`
-
-Parses a declaration value into a `Value` node with one child per component.
-
-```typescript
-import { parse_value } from '@projectwallace/css-parser'
 
 for (const node of parse_value('10px 20px')) {
-	console.log(node.type_name, node.value, node.unit) // "Dimension" 10 "px", then "Dimension" 20 "px"
+	node.type_name // "Dimension"
 }
-```
-
-### `parse_atrule_prelude(name, prelude)`
-
-Returns an array of nodes for the prelude of the at-rule called `name` (without the `@`).
-
-```typescript
-import { parse_atrule_prelude } from '@projectwallace/css-parser'
 
-const [query] = parse_atrule_prelude('media', '(min-width: 768px)')
+const [query] = parse_atrule_prelude('media', '(min-width: 768px)') // name without the `@`
 query.type_name // "MediaQuery"
-```
-
-### `parse_dimension(text)`
-
-Splits a number from its unit. It works for anything shaped like a number followed by a unit: lengths (`100px`), percentages (`2%`), durations (`200ms`) and so on. It does not validate; text without a leading number gives `value: 0`.
 
-```typescript
-import { parse_dimension } from '@projectwallace/css-parser'
-
-parse_dimension('100px') // { value: 100, unit: "px" }
-parse_dimension('2%') // { value: 2, unit: "%" }
-parse_dimension('1.5e3s') // { value: 1500, unit: "s" }
-parse_dimension('5') // { value: 5, unit: "" }
+parse_dimension('1.5e3s') // { value: 1500, unit: "s" } (no validation; no leading number gives `value: 0`)
 ```
 
 ### `walk(node, callback)` and `traverse(node, { enter, leave })`
@@ -177,28 +127,13 @@ parse_dimension('5') // { value: 5, unit: "" }
 Both walk the tree depth-first. Return `SKIP` to skip the children of a node and `BREAK` to stop entirely. `walk` also passes a `depth` that counts rule and at-rule nesting. `traverse` calls `enter` before and `leave` after the children (`leave` still runs after `SKIP`, but not after `BREAK`).
 
 ```typescript
-import {
-	parse,
-	walk,
-	traverse,
-	SKIP,
-	BREAK,
-	DECLARATION,
-	AT_RULE,
-} from '@projectwallace/css-parser'
-
-const ast = parse('@media screen { a { color: red; margin: 0 } }')
-
 walk(ast, (node) => {
-	if (node.type === DECLARATION) {
-		console.log(node.property) // "color"
-		return BREAK
-	}
+	if (node.type === DECLARATION) return BREAK
 })
 
 traverse(ast, {
 	enter(node) {
-		if (node.type === AT_RULE) return SKIP // leave() still runs for this node
+		if (node.type === AT_RULE) return SKIP
 	},
 	leave(node) {},
 })
@@ -209,8 +144,6 @@ traverse(ast, {
 A generator of tokens; comments are skipped and reported through `on_comment`.
 
 ```typescript
-import { tokenize } from '@projectwallace/css-parser'
-
 for (const token of tokenize('a { color: red }')) {
 	console.log(token.type, token.start, token.end)
 }
@@ -218,37 +151,25 @@ for (const token of tokenize('a { color: red }')) {
 
 ### Node types, type guards and `clone()`
 
-Node type constants (`STYLE_RULE`, `DECLARATION`, `DIMENSION`, …) and `NODE_TYPES` are exported from the root and from `@projectwallace/css-parser/nodes`. Type guards such as `is_declaration()` and `is_dimension()` that narrow a node to its specific type are exported from the root and from `@projectwallace/css-parser/node-types`. `node.clone({ deep?, locations? })` returns a mutable plain-object copy of a node.
+Type guards such as `is_declaration()` narrow a node to its specific type. `node.clone({ deep?, locations? })` returns a mutable plain-object copy of a node.
 
 ```typescript
-import { parse, is_declaration } from '@projectwallace/css-parser'
-
 const decl = parse('a { color: red }').first_child.block.first_child
 is_declaration(decl) // true
 decl.type_name // "Declaration"
-decl.clone({ deep: false }).property // "color"
 ```
 
 ### String helpers
 
-Allocation-free helpers, handy when working with node names. Also available from `@projectwallace/css-parser/string-utils`; token type constants (`TOKEN_*`) are available from `@projectwallace/css-parser/token-types`. The lowercase argument is the first one for `str_equals` and the second one for `str_starts_with` and `str_index_of`. This inconsistency will be fixed in a future breaking change.
+Allocation-free helpers, handy when working with node names. The lowercase argument is always the first one.
 
 ```typescript
-import {
-	is_custom,
-	is_vendor_prefixed,
-	strip_vendor_prefix,
-	str_equals,
-	str_starts_with,
-	str_index_of,
-} from '@projectwallace/css-parser'
-
 is_custom('--primary') // true
 is_vendor_prefixed('-webkit-transform') // true
 strip_vendor_prefix('-webkit-transform') // "transform"
 str_equals('media', 'MEDIA') // true
-str_starts_with('WEBKIT-transform', 'webkit') // true
-str_index_of('background-COLOR', 'color') // 11
+str_starts_with('webkit', 'WEBKIT-transform') // true
+str_index_of('color', 'background-COLOR') // 11
 ```
 
 ## Non-goals

package/dist/{arena-DvT75bvK.d.ts → arena-7RLvyGPB.d.ts}

@@ -89,7 +89,6 @@ declare class CSSDataArena {
   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;
-  /** Shrink the buffer to the live node count, releasing wasted capacity. Call once after parsing; no-op if already tight. */
   trim(): void;
   get_last_sibling(node_index: number): number;
   has_children(node_index: number): boolean;

package/dist/{arena-Bsf96CQK.js → arena-CsJhQRUX.js}

@@ -189,7 +189,6 @@ var CSSDataArena = class CSSDataArena {
 		this.view.setUint32(offset + 4, children[0], true);
 		for (let i = 0; i < children.length - 1; i++) this.set_next_sibling(children[i], children[i + 1]);
 	}
-	/** Shrink the buffer to the live node count, releasing wasted capacity. Call once after parsing; no-op if already tight. */
 	trim() {
 		if (this.count === this.capacity) return;
 		const byte_count = this.count * BYTES_PER_NODE;

package/dist/constants.d.ts

@@ -1,4 +1,4 @@
-import { A as PARENTHESIS, B as STYLESHEET, C as MEDIA_QUERY, D as NTH_SELECTOR, E as NTH_OF_SELECTOR, F as RATIO, G as UNICODE_RANGE, H as SUPPORTS_DECLARATION, I as RAW, J as VALUE, K as UNIVERSAL_SELECTOR, L as SELECTOR, N as PSEUDO_CLASS_SELECTOR, O as NUMBER, P as PSEUDO_ELEMENT_SELECTOR, R as SELECTOR_LIST, S as MEDIA_FEATURE, T as NESTING_SELECTOR, U as SUPPORTS_QUERY, V as STYLE_RULE, W as TYPE_SELECTOR, _ as ID_SELECTOR, a as CLASS_SELECTOR, b as LANG_SELECTOR, c as CONTAINER_QUERY, d as DIMENSION, f as FEATURE_RANGE, g as IDENTIFIER, h as HASH, i as BLOCK, j as PRELUDE_OPERATOR, k as OPERATOR, m as FUNCTION, n as AT_RULE, o as COMBINATOR, p as FLAG_IMPORTANT, q as URL, r as AT_RULE_PRELUDE, s as COMMENT, t as ATTRIBUTE_SELECTOR, u as DECLARATION, v as IF_BRANCH, w as MEDIA_TYPE, x as LAYER_NAME, y as IF_CONDITION, z as STRING } from "./arena-DvT75bvK.js";
+import { A as PARENTHESIS, B as STYLESHEET, C as MEDIA_QUERY, D as NTH_SELECTOR, E as NTH_OF_SELECTOR, F as RATIO, G as UNICODE_RANGE, H as SUPPORTS_DECLARATION, I as RAW, J as VALUE, K as UNIVERSAL_SELECTOR, L as SELECTOR, N as PSEUDO_CLASS_SELECTOR, O as NUMBER, P as PSEUDO_ELEMENT_SELECTOR, R as SELECTOR_LIST, S as MEDIA_FEATURE, T as NESTING_SELECTOR, U as SUPPORTS_QUERY, V as STYLE_RULE, W as TYPE_SELECTOR, _ as ID_SELECTOR, a as CLASS_SELECTOR, b as LANG_SELECTOR, c as CONTAINER_QUERY, d as DIMENSION, f as FEATURE_RANGE, g as IDENTIFIER, h as HASH, i as BLOCK, j as PRELUDE_OPERATOR, k as OPERATOR, m as FUNCTION, n as AT_RULE, o as COMBINATOR, p as FLAG_IMPORTANT, q as URL, r as AT_RULE_PRELUDE, s as COMMENT, t as ATTRIBUTE_SELECTOR, u as DECLARATION, v as IF_BRANCH, w as MEDIA_TYPE, x as LAYER_NAME, y as IF_CONDITION, z as STRING } from "./arena-7RLvyGPB.js";
 //#region src/constants.d.ts
 export declare const NODE_TYPES: {
   readonly STYLESHEET: 1;

package/dist/constants.js

@@ -1,4 +1,4 @@
-import { A as PARENTHESIS, B as STYLE_RULE, C as MEDIA_QUERY, D as NTH_SELECTOR, E as NTH_OF_SELECTOR, F as RAW, G as UNIVERSAL_SELECTOR, H as SUPPORTS_QUERY, I as SELECTOR, K as URL, L as SELECTOR_LIST, M as PSEUDO_CLASS_SELECTOR, N as PSEUDO_ELEMENT_SELECTOR, O as NUMBER, P as RATIO, R as STRING, S as MEDIA_FEATURE, T as NESTING_SELECTOR, U as TYPE_SELECTOR, V as SUPPORTS_DECLARATION, W as UNICODE_RANGE, _ as ID_SELECTOR, a as CLASS_SELECTOR, b as LANG_SELECTOR, c as CONTAINER_QUERY, d as DIMENSION, f as FEATURE_RANGE, g as IDENTIFIER, h as HASH, i as BLOCK, j as PRELUDE_OPERATOR, k as OPERATOR, m as FUNCTION, n as AT_RULE, o as COMBINATOR, p as FLAG_IMPORTANT, q as VALUE, r as AT_RULE_PRELUDE, s as COMMENT, t as ATTRIBUTE_SELECTOR, u as DECLARATION, v as IF_BRANCH, w as MEDIA_TYPE, x as LAYER_NAME, y as IF_CONDITION, z as STYLESHEET } from "./arena-Bsf96CQK.js";
+import { A as PARENTHESIS, B as STYLE_RULE, C as MEDIA_QUERY, D as NTH_SELECTOR, E as NTH_OF_SELECTOR, F as RAW, G as UNIVERSAL_SELECTOR, H as SUPPORTS_QUERY, I as SELECTOR, K as URL, L as SELECTOR_LIST, M as PSEUDO_CLASS_SELECTOR, N as PSEUDO_ELEMENT_SELECTOR, O as NUMBER, P as RATIO, R as STRING, S as MEDIA_FEATURE, T as NESTING_SELECTOR, U as TYPE_SELECTOR, V as SUPPORTS_DECLARATION, W as UNICODE_RANGE, _ as ID_SELECTOR, a as CLASS_SELECTOR, b as LANG_SELECTOR, c as CONTAINER_QUERY, d as DIMENSION, f as FEATURE_RANGE, g as IDENTIFIER, h as HASH, i as BLOCK, j as PRELUDE_OPERATOR, k as OPERATOR, m as FUNCTION, n as AT_RULE, o as COMBINATOR, p as FLAG_IMPORTANT, q as VALUE, r as AT_RULE_PRELUDE, s as COMMENT, t as ATTRIBUTE_SELECTOR, u as DECLARATION, v as IF_BRANCH, w as MEDIA_TYPE, x as LAYER_NAME, y as IF_CONDITION, z as STYLESHEET } from "./arena-CsJhQRUX.js";
 //#region src/constants.ts
 const NODE_TYPES = {
 	STYLESHEET: 1,

package/dist/{css-node-yoUdFtNg.js → css-node-BJnbanUS.js}

@@ -1,5 +1,5 @@
-import "./arena-Bsf96CQK.js";
-import { a as is_vendor_prefixed, o as is_whitespace, s as str_equals, u as str_starts_with } from "./string-utils-DiRRd28d.js";
+import "./arena-CsJhQRUX.js";
+import { a as is_vendor_prefixed, o as is_whitespace, s as str_equals, u as str_starts_with } from "./string-utils-aEEsA2CS.js";
 import { dimension_number_end } from "./parse-dimension.js";
 //#region src/css-node.ts
 const nodes_with_name = /* @__PURE__ */ new Set([
@@ -36,7 +36,8 @@ const nodes_with_children = /* @__PURE__ */ new Set([
 	36,
 	57,
 	59,
-	60
+	60,
+	41
 ]);
 const enumerable_properties = [
 	"name",
@@ -82,11 +83,9 @@ var CSSNode = class CSSNode {
 		if (length === 0) return "";
 		return this.source.substring(start, start + length);
 	}
-	/** Get node type as number (for performance) */
 	get type() {
 		return this.arena.get_type(this.index);
 	}
-	/** Get node type as human-readable string */
 	get type_name() {
 		switch (this.type) {
 			case 1: return "StyleSheet";
@@ -138,13 +137,11 @@ var CSSNode = class CSSNode {
 			default: return "unknown";
 		}
 	}
-	/** Get the full text of this node from source */
 	get text() {
 		const start = this.arena.get_start_offset(this.index);
 		const length = this.arena.get_length(this.index);
 		return this.source.substring(start, start + length);
 	}
-	/** Get the "content" text (at-rule name for at-rules, layer name for import layers) */
 	get name() {
 		if (!nodes_with_name.has(this.type)) return;
 		const { type } = this;
@@ -153,7 +150,6 @@ var CSSNode = class CSSNode {
 		if (type === 56 && content === "") return null;
 		return content;
 	}
-	/** Namespace prefix for type/universal selectors: null (none), '' (`|div`), 'ns' (`ns|div`), or '*' (`*|div`). */
 	get namespace() {
 		const { type } = this;
 		if (type !== 21 && type !== 28) return void 0;
@@ -162,16 +158,11 @@ var CSSNode = class CSSNode {
 		const length = this.arena.get_value_length(this.index);
 		return this.source.substring(start, start + length);
 	}
-	/** Alias for `name` on declarations ("color" in "color: blue"), more semantic than `name` there. */
 	get property() {
 		const { type } = this;
 		if (type !== 4 && type !== 33 && type !== 57) return;
 		return this.get_content();
 	}
-	/**
-	* Declarations: the value text ("1px solid blue"). Dimension/number: the numeric value.
-	* String: content without quotes. URL: quoted string keeps quotes, unquoted URL doesn't.
-	*/
 	get value() {
 		const { type, text, first_child } = this;
 		if (type === 3) return void 0;
@@ -187,7 +178,7 @@ var CSSNode = class CSSNode {
 		if (type === 11) return Number(text);
 		if (type === 18) {
 			if (first_child?.type === 13) return first_child.text;
-			if (str_starts_with(text, "url(")) {
+			if (str_starts_with("url(", text)) {
 				const open_paren = text.indexOf("(");
 				const close_paren = text.lastIndexOf(")");
 				if (open_paren !== -1 && close_paren !== -1 && close_paren > open_paren) return text.substring(open_paren + 1, close_paren).trim();
@@ -200,7 +191,6 @@ var CSSNode = class CSSNode {
 		if (length === 0) return null;
 		return this.source.substring(start, start + length);
 	}
-	/** At-rules: AT_RULE_PRELUDE wrapper (media queries, layer names, …). Style rules: SELECTOR_LIST/SELECTOR. Null if none. */
 	get prelude() {
 		if (this.type === 3) {
 			const first = this.first_child;
@@ -209,7 +199,6 @@ var CSSNode = class CSSNode {
 		}
 		if (this.type === 2) return this.first_child;
 	}
-	/** Attribute selector operator (=, ~=, |=, ^=, $=, *=), or null for the bare `[attr]` form. */
 	get attr_operator() {
 		if (this.type !== 24) return void 0;
 		const content_end = this.arena.get_content_start(this.index) + this.arena.get_content_length(this.index);
@@ -227,7 +216,6 @@ var CSSNode = class CSSNode {
 		if (ch1 === 42 && ch2 === 61) return this.source.substring(pos, pos + 2);
 		return null;
 	}
-	/** Attribute selector flag: "i" (case-insensitive), "s" (case-sensitive), or null if absent. */
 	get attr_flags() {
 		if (this.type !== 24) return void 0;
 		const value_len = this.arena.get_value_length(this.index);
@@ -241,43 +229,35 @@ var CSSNode = class CSSNode {
 		if (flag_ch === 105 || flag_ch === 73 || flag_ch === 115 || flag_ch === 83) return this.source.at(pos);
 		return null;
 	}
-	/** Get the unit for dimension nodes (e.g., "px" from "100px", "%" from "50%") */
 	get unit() {
 		if (this.type !== 12) return void 0;
 		const text = this.text;
 		return text.substring(dimension_number_end(text));
 	}
-	/** Numerator for ratio values, e.g. the Number "16" in `aspect-ratio: 16/9` */
 	get left() {
 		if (this.type !== 58) return void 0;
 		return this.first_child ?? void 0;
 	}
-	/** Denominator for ratio values, e.g. the Number "9" in `aspect-ratio: 16/9` */
 	get right() {
 		if (this.type !== 58) return void 0;
 		return this.first_child?.next_sibling ?? void 0;
 	}
-	/** Get the parsed condition node of an if() branch, e.g. the Function "style(--active: 1)" or the Identifier "else" */
 	get condition() {
 		if (this.type !== 59) return;
 		return this.first_child ?? void 0;
 	}
-	/** True when this is the else branch of an if() function */
 	get is_else() {
 		if (this.type !== 59) return void 0;
 		return str_equals("else", this.get_content());
 	}
-	/** Check if this declaration has !important */
 	get is_important() {
 		if (this.type !== 4) return void 0;
 		return this.arena.has_flag(this.index, 1);
 	}
-	/** Check if this declaration has a browser hack prefix */
 	get is_browserhack() {
 		if (this.type !== 4) return void 0;
 		return this.arena.has_flag(this.index, 128);
 	}
-	/** Check if this has a vendor prefix (computed on-demand) */
 	get is_vendor_prefixed() {
 		switch (this.type) {
 			case 4: return is_vendor_prefixed(this.get_content());
@@ -290,28 +270,23 @@ var CSSNode = class CSSNode {
 			default: return false;
 		}
 	}
-	/** Check if this node has an error */
 	get has_error() {
 		return this.arena.has_flag(this.index, 2);
 	}
-	/** Check if this node has a prelude (at-rules and style rules) */
 	get has_prelude() {
 		const { type } = this;
 		if (type === 3) return this.first_child !== null && this.first_child.type !== 7;
 		if (type === 2) return this.first_child !== null;
 		return false;
 	}
-	/** Check if this rule has a block { } */
 	get has_block() {
 		return this.arena.has_flag(this.index, 8);
 	}
-	/** Check if this style rule has declarations */
 	get has_declarations() {
 		const { type } = this;
 		if (type !== 3 && type !== 2) return void 0;
 		return this.arena.has_flag(this.index, 32);
 	}
-	/** Get the block node (for style rules and at-rules with blocks) */
 	get block() {
 		const { type } = this;
 		if (type === 2) {
@@ -331,7 +306,6 @@ var CSSNode = class CSSNode {
 		}
 		return null;
 	}
-	/** Check if this block is empty (no declarations or rules, only comments allowed) */
 	get is_empty() {
 		if (this.type !== 7) return void 0;
 		let child = this.first_child;
@@ -341,46 +315,34 @@ var CSSNode = class CSSNode {
 		}
 		return true;
 	}
-	/** Get start line number */
 	get line() {
 		return this.arena.get_start_line(this.index);
 	}
-	/** Get start column number */
 	get column() {
 		return this.arena.get_start_column(this.index);
 	}
-	/** Get start offset in source */
 	get start() {
 		return this.arena.get_start_offset(this.index);
 	}
-	/** Get length in source */
 	get length() {
 		return this.arena.get_length(this.index);
 	}
-	/**
-	* Get end offset in source
-	* End is not stored, must be calculated
-	*/
 	get end() {
 		return this.start + this.length;
 	}
-	/** Get first child node */
 	get first_child() {
 		const child_index = this.arena.get_first_child(this.index);
 		if (child_index === 0) return null;
 		return new CSSNode(this.arena, this.source, child_index);
 	}
-	/** Get next sibling node */
 	get next_sibling() {
 		const sibling_index = this.arena.get_next_sibling(this.index);
 		if (sibling_index === 0) return null;
 		return new CSSNode(this.arena, this.source, sibling_index);
 	}
-	/** Check if this node has a next sibling */
 	get has_next() {
 		return this.arena.get_next_sibling(this.index) !== 0;
 	}
-	/** Whether this node has children. For pseudo-class/element functions, tracks FLAG_HAS_PARENS so formatters can tell `:lang()` from `:hover`. */
 	get has_children() {
 		const { type } = this;
 		if (type === 25 || type === 26) {
@@ -388,7 +350,6 @@ var CSSNode = class CSSNode {
 		}
 		return this.arena.has_children(this.index);
 	}
-	/** Count children without allocating an intermediate array */
 	get child_count() {
 		let count = 0;
 		let child_index = this.arena.get_first_child(this.index);
@@ -398,7 +359,6 @@ var CSSNode = class CSSNode {
 		}
 		return count;
 	}
-	/** Get all children as an array */
 	get children() {
 		const result = [];
 		let child = this.first_child;
@@ -408,7 +368,6 @@ var CSSNode = class CSSNode {
 		}
 		return result;
 	}
-	/** Make CSSNode iterable over its children */
 	*[Symbol.iterator]() {
 		let child = this.first_child;
 		while (child) {
@@ -416,7 +375,6 @@ var CSSNode = class CSSNode {
 			child = child.next_sibling;
 		}
 	}
-	/** Get the 'a' coefficient from An+B expression (e.g., "2n" from "2n+1", "odd" from "odd") */
 	get nth_a() {
 		const { type, arena, index } = this;
 		if (type !== 30 && type !== 31) return void 0;
@@ -425,7 +383,6 @@ var CSSNode = class CSSNode {
 		const start = arena.get_content_start(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() {
 		const { type, arena, index, source } = this;
 		if (type !== 30 && type !== 31) return void 0;
@@ -446,20 +403,14 @@ var CSSNode = class CSSNode {
 		}
 		return value;
 	}
-	/** Get the An+B formula node from :nth-child(2n+1 of .foo) */
 	get nth() {
 		if (this.type !== 31) 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 !== 31) return void 0;
 		return this.first_child?.next_sibling ?? void 0;
 	}
-	/**
-	* Clone this node as a mutable plain object with children as arrays.
-	* Use sparingly — can consume a lot of memory.
-	*/
 	clone(options = {}) {
 		const { deep = true, locations = false } = options;
 		const { type } = this;

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { A as PARENTHESIS, B as STYLESHEET, C as MEDIA_QUERY, D as NTH_SELECTOR, E as NTH_OF_SELECTOR, F as RATIO, G as UNICODE_RANGE, H as SUPPORTS_DECLARATION, I as RAW, J as VALUE, K as UNIVERSAL_SELECTOR, L as SELECTOR, N as PSEUDO_CLASS_SELECTOR, O as NUMBER, P as PSEUDO_ELEMENT_SELECTOR, R as SELECTOR_LIST, S as MEDIA_FEATURE, T as NESTING_SELECTOR, U as SUPPORTS_QUERY, V as STYLE_RULE, W as TYPE_SELECTOR, _ as ID_SELECTOR, a as CLASS_SELECTOR, b as LANG_SELECTOR, c as CONTAINER_QUERY, d as DIMENSION, f as FEATURE_RANGE, g as IDENTIFIER, h as HASH, i as BLOCK, j as PRELUDE_OPERATOR, k as OPERATOR, m as FUNCTION, n as AT_RULE, o as COMBINATOR, p as FLAG_IMPORTANT, q as URL, r as AT_RULE_PRELUDE, s as COMMENT, t as ATTRIBUTE_SELECTOR, u as DECLARATION, v as IF_BRANCH, w as MEDIA_TYPE, x as LAYER_NAME, y as IF_CONDITION, z as STRING } from "./arena-DvT75bvK.js";
+import { A as PARENTHESIS, B as STYLESHEET, C as MEDIA_QUERY, D as NTH_SELECTOR, E as NTH_OF_SELECTOR, F as RATIO, G as UNICODE_RANGE, H as SUPPORTS_DECLARATION, I as RAW, J as VALUE, K as UNIVERSAL_SELECTOR, L as SELECTOR, N as PSEUDO_CLASS_SELECTOR, O as NUMBER, P as PSEUDO_ELEMENT_SELECTOR, R as SELECTOR_LIST, S as MEDIA_FEATURE, T as NESTING_SELECTOR, U as SUPPORTS_QUERY, V as STYLE_RULE, W as TYPE_SELECTOR, _ as ID_SELECTOR, a as CLASS_SELECTOR, b as LANG_SELECTOR, c as CONTAINER_QUERY, d as DIMENSION, f as FEATURE_RANGE, g as IDENTIFIER, h as HASH, i as BLOCK, j as PRELUDE_OPERATOR, k as OPERATOR, m as FUNCTION, n as AT_RULE, o as COMBINATOR, p as FLAG_IMPORTANT, q as URL, r as AT_RULE_PRELUDE, s as COMMENT, t as ATTRIBUTE_SELECTOR, u as DECLARATION, v as IF_BRANCH, w as MEDIA_TYPE, x as LAYER_NAME, y as IF_CONDITION, z as STRING } from "./arena-7RLvyGPB.js";
 import { NODE_TYPES } from "./constants.js";
 import { C as TOKEN_SEMICOLON, D as TOKEN_WHITESPACE, E as TOKEN_URL, O as Token, S as TOKEN_RIGHT_PAREN, T as TOKEN_UNICODE_RANGE, _ as TOKEN_LEFT_PAREN, a as TOKEN_CDO, b as TOKEN_RIGHT_BRACE, c as TOKEN_COMMENT, d as TOKEN_EOF, f as TOKEN_FUNCTION, g as TOKEN_LEFT_BRACKET, h as TOKEN_LEFT_BRACE, i as TOKEN_CDC, k as TokenType, l as TOKEN_DELIM, m as TOKEN_IDENT, n as TOKEN_BAD_STRING, o as TOKEN_COLON, p as TOKEN_HASH, r as TOKEN_BAD_URL, s as TOKEN_COMMA, t as TOKEN_AT_KEYWORD, u as TOKEN_DIMENSION, v as TOKEN_NUMBER, w as TOKEN_STRING, x as TOKEN_RIGHT_BRACKET, y as TOKEN_PERCENTAGE } from "./token-types-Bqsf5FX-.js";
 import { CommentInfo, LexerPosition, tokenize } from "./tokenize.js";
-import { $ as is_atrule, A as Operator, At as is_pseudo_element_selector, B as SelectorList, Bt as is_type_selector, C as MediaFeature, Ct as is_nth_selector, D as NthOfSelector, Dt as is_prelude_operator, E as NestingSelector, Et as is_parenthesis, F as PseudoElementSelector, Ft as is_selector_list, G as SupportsQuery, Gt as CloneOptions, H as String, Ht as is_universal_selector, I as Ratio, It as is_string, J as UnicodeRange, K as ToPlain, Kt as PlainCSSNode, L as Raw, Lt as is_stylesheet, M as PreludeOperator, Mt as is_raw, N as PreludeSelectorList, Nt as is_rule, O as NthSelector, Ot as is_prelude_selectorlist, P as PseudoClassSelector, Pt as is_selector, Q as WithChildren, R as Rule, Rt as is_supports_declaration, S as LayerName, St as is_nth_of_selector, T as MediaType, Tt as is_operator, U as StyleSheet, Ut as is_url, V as SelectorNode, Vt as is_unicode_range, W as SupportsDeclaration, Wt as is_value, X as Url, Y as UniversalSelector, Z as Value, _ as IdSelector, _t as is_layer_name, a as Block, at as is_comment, b as IfCondition, bt as is_media_type, c as ClassSelector, ct as is_dimension, d as ContainerQuery, dt as is_hash, et as is_atrule_prelude, f as Declaration, ft as is_id_selector, g as Hash, gt as is_lang_selector, h as Function, ht as is_if_condition, i as AttributeSelector, it as is_combinator, j as Parenthesis, jt as is_ratio, k as Number, kt as is_pseudo_class_selector, l as Combinator, lt as is_feature_range, m as FeatureRange, mt as is_if_branch, n as Atrule, nt as is_block, ot as is_container_query, p as Dimension, pt as is_identifier, q as TypeSelector, r as AtrulePrelude, rt as is_class_selector, s as CSSNode, st as is_declaration, t as AnyNode, tt as is_attribute_selector, u as Comment, ut as is_function, v as Identifier, vt as is_media_feature, w as MediaQuery, wt as is_number, x as LangSelector, xt as is_nesting_selector, y as IfBranch, yt as is_media_query, z as Selector, zt as is_supports_query } from "./node-types-CY0JK9_a.js";
+import { $ as is_atrule, A as Operator, At as is_pseudo_element_selector, B as SelectorList, Bt as is_type_selector, C as MediaFeature, Ct as is_nth_selector, D as NthOfSelector, Dt as is_prelude_operator, E as NestingSelector, Et as is_parenthesis, F as PseudoElementSelector, Ft as is_selector_list, G as SupportsQuery, Gt as CloneOptions, H as String, Ht as is_universal_selector, I as Ratio, It as is_string, J as UnicodeRange, K as ToPlain, Kt as PlainCSSNode, L as Raw, Lt as is_stylesheet, M as PreludeOperator, Mt as is_raw, N as PreludeSelectorList, Nt as is_rule, O as NthSelector, Ot as is_prelude_selectorlist, P as PseudoClassSelector, Pt as is_selector, Q as WithChildren, R as Rule, Rt as is_supports_declaration, S as LayerName, St as is_nth_of_selector, T as MediaType, Tt as is_operator, U as StyleSheet, Ut as is_url, V as SelectorNode, Vt as is_unicode_range, W as SupportsDeclaration, Wt as is_value, X as Url, Y as UniversalSelector, Z as Value, _ as IdSelector, _t as is_layer_name, a as Block, at as is_comment, b as IfCondition, bt as is_media_type, c as ClassSelector, ct as is_dimension, d as ContainerQuery, dt as is_hash, et as is_atrule_prelude, f as Declaration, ft as is_id_selector, g as Hash, gt as is_lang_selector, h as Function, ht as is_if_condition, i as AttributeSelector, it as is_combinator, j as Parenthesis, jt as is_ratio, k as Number, kt as is_pseudo_class_selector, l as Combinator, lt as is_feature_range, m as FeatureRange, mt as is_if_branch, n as Atrule, nt as is_block, ot as is_container_query, p as Dimension, pt as is_identifier, q as TypeSelector, r as AtrulePrelude, rt as is_class_selector, s as CSSNode, st as is_declaration, t as AnyNode, tt as is_attribute_selector, u as Comment, ut as is_function, v as Identifier, vt as is_media_feature, w as MediaQuery, wt as is_number, x as LangSelector, xt as is_nesting_selector, y as IfBranch, yt as is_media_query, z as Selector, zt as is_supports_query } from "./node-types-BZGPDESt.js";
 import { ParserOptions, parse } from "./parse.js";
 import { parse_selector, parse_selector_list } from "./parse-selector.js";
 import { parse_atrule_prelude } from "./parse-atrule-prelude.js";
@@ -10,5 +10,5 @@ import { parse_declaration } from "./parse-declaration.js";
 import { parse_value } from "./parse-value.js";
 import { parse_dimension } from "./parse-dimension.js";
 import { BREAK, SKIP, traverse, walk } from "./walk.js";
-import { a as str_starts_with, i as str_index_of, n as is_vendor_prefixed, o as strip_vendor_prefix, r as str_equals, t as is_custom } from "./string-helpers-BMWJduts.js";
+import { a as str_starts_with, i as str_index_of, n as is_vendor_prefixed, o as strip_vendor_prefix, r as str_equals, t as is_custom } from "./string-helpers-t7UofIfp.js";
 export { ATTRIBUTE_SELECTOR, AT_RULE, AT_RULE_PRELUDE, type AnyNode, type Atrule, type AtrulePrelude, type AttributeSelector, BLOCK, BREAK, type Block, CLASS_SELECTOR, COMBINATOR, COMMENT, CONTAINER_QUERY, type CSSNode, type ClassSelector, type CloneOptions, type Combinator, type Comment, type CommentInfo, type ContainerQuery, DECLARATION, DIMENSION, type Declaration, type Dimension, FEATURE_RANGE, FLAG_IMPORTANT, FUNCTION, type FeatureRange, type Function, HASH, type Hash, IDENTIFIER, ID_SELECTOR, IF_BRANCH, IF_CONDITION, type IdSelector, type Identifier, type IfBranch, type IfCondition, LANG_SELECTOR, LAYER_NAME, type LangSelector, type LayerName, type LexerPosition, MEDIA_FEATURE, MEDIA_QUERY, MEDIA_TYPE, type MediaFeature, type MediaQuery, type MediaType, NESTING_SELECTOR, NODE_TYPES, NTH_OF_SELECTOR, NTH_SELECTOR, NUMBER, type NestingSelector, type NthOfSelector, type NthSelector, type Number, OPERATOR, type Operator, PARENTHESIS, PRELUDE_OPERATOR, PSEUDO_CLASS_SELECTOR, PSEUDO_ELEMENT_SELECTOR, type Parenthesis, type ParserOptions, type PlainCSSNode, type PreludeOperator, type PreludeSelectorList, type PseudoClassSelector, type PseudoElementSelector, RATIO, RAW, type Ratio, type Raw, type Rule, SELECTOR, SELECTOR_LIST, SKIP, STRING, STYLESHEET, STYLE_RULE, SUPPORTS_DECLARATION, SUPPORTS_QUERY, type Selector, type SelectorList, type SelectorNode, type String, type StyleSheet, type SupportsDeclaration, type SupportsQuery, 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_UNICODE_RANGE, TOKEN_URL, TOKEN_WHITESPACE, TYPE_SELECTOR, type ToPlain, Token, TokenType, type TypeSelector, UNICODE_RANGE, UNIVERSAL_SELECTOR, URL, type UnicodeRange, type UniversalSelector, type Url, VALUE, type Value, type WithChildren, is_atrule, is_atrule_prelude, is_attribute_selector, is_block, is_class_selector, is_combinator, is_comment, is_container_query, is_custom, is_declaration, is_dimension, is_feature_range, is_function, is_hash, is_id_selector, is_identifier, is_if_branch, is_if_condition, is_lang_selector, is_layer_name, is_media_feature, is_media_query, is_media_type, is_nesting_selector, is_nth_of_selector, is_nth_selector, is_number, is_operator, is_parenthesis, is_prelude_operator, is_prelude_selectorlist, is_pseudo_class_selector, is_pseudo_element_selector, is_ratio, is_raw, is_rule, is_selector, is_selector_list, is_string, is_stylesheet, is_supports_declaration, is_supports_query, is_type_selector, is_unicode_range, is_universal_selector, is_url, is_value, is_vendor_prefixed, parse, parse_atrule_prelude, parse_declaration, parse_dimension, parse_selector, parse_selector_list, parse_value, str_equals, str_index_of, str_starts_with, strip_vendor_prefix, tokenize, traverse, walk };

package/dist/index.js

@@ -1,9 +1,9 @@
-import { n as tokenize } from "./tokenize-Ccg58Z_k.js";
+import { n as tokenize } from "./tokenize-B2QSzdrM.js";
 import { 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_UNICODE_RANGE, TOKEN_URL, TOKEN_WHITESPACE } from "./token-types.js";
-import { A as PARENTHESIS, B as STYLE_RULE, C as MEDIA_QUERY, D as NTH_SELECTOR, E as NTH_OF_SELECTOR, F as RAW, G as UNIVERSAL_SELECTOR, H as SUPPORTS_QUERY, I as SELECTOR, K as URL, L as SELECTOR_LIST, M as PSEUDO_CLASS_SELECTOR, N as PSEUDO_ELEMENT_SELECTOR, O as NUMBER, P as RATIO, R as STRING, S as MEDIA_FEATURE, T as NESTING_SELECTOR, U as TYPE_SELECTOR, V as SUPPORTS_DECLARATION, W as UNICODE_RANGE, _ as ID_SELECTOR, a as CLASS_SELECTOR, b as LANG_SELECTOR, c as CONTAINER_QUERY, d as DIMENSION, f as FEATURE_RANGE, g as IDENTIFIER, h as HASH, i as BLOCK, j as PRELUDE_OPERATOR, k as OPERATOR, m as FUNCTION, n as AT_RULE, o as COMBINATOR, p as FLAG_IMPORTANT, q as VALUE, r as AT_RULE_PRELUDE, s as COMMENT, t as ATTRIBUTE_SELECTOR, u as DECLARATION, v as IF_BRANCH, w as MEDIA_TYPE, x as LAYER_NAME, y as IF_CONDITION, z as STYLESHEET } from "./arena-Bsf96CQK.js";
-import { a as is_vendor_prefixed, d as strip_vendor_prefix, l as str_index_of, r as is_custom, s as str_equals, u as str_starts_with } from "./string-utils-DiRRd28d.js";
+import { A as PARENTHESIS, B as STYLE_RULE, C as MEDIA_QUERY, D as NTH_SELECTOR, E as NTH_OF_SELECTOR, F as RAW, G as UNIVERSAL_SELECTOR, H as SUPPORTS_QUERY, I as SELECTOR, K as URL, L as SELECTOR_LIST, M as PSEUDO_CLASS_SELECTOR, N as PSEUDO_ELEMENT_SELECTOR, O as NUMBER, P as RATIO, R as STRING, S as MEDIA_FEATURE, T as NESTING_SELECTOR, U as TYPE_SELECTOR, V as SUPPORTS_DECLARATION, W as UNICODE_RANGE, _ as ID_SELECTOR, a as CLASS_SELECTOR, b as LANG_SELECTOR, c as CONTAINER_QUERY, d as DIMENSION, f as FEATURE_RANGE, g as IDENTIFIER, h as HASH, i as BLOCK, j as PRELUDE_OPERATOR, k as OPERATOR, m as FUNCTION, n as AT_RULE, o as COMBINATOR, p as FLAG_IMPORTANT, q as VALUE, r as AT_RULE_PRELUDE, s as COMMENT, t as ATTRIBUTE_SELECTOR, u as DECLARATION, v as IF_BRANCH, w as MEDIA_TYPE, x as LAYER_NAME, y as IF_CONDITION, z as STYLESHEET } from "./arena-CsJhQRUX.js";
+import { a as is_vendor_prefixed, d as strip_vendor_prefix, l as str_index_of, r as is_custom, s as str_equals, u as str_starts_with } from "./string-utils-aEEsA2CS.js";
 import { parse_dimension } from "./parse-dimension.js";
-import { n as parse_selector, r as parse_selector_list } from "./parse-selector-CqIpnBrQ.js";
+import { n as parse_selector, r as parse_selector_list } from "./parse-selector-B59fV-Ya.js";
 import { parse_atrule_prelude } from "./parse-atrule-prelude.js";
 import { parse_value } from "./parse-value.js";
 import { parse_declaration } from "./parse-declaration.js";