@projectwallace/css-parser 0.16.2 → 0.18.0

package/dist/parse-value.d.ts

@@ -1,23 +1,12 @@
-import { l as CSSDataArena } from "./arena-DfpuGV9Y.js";
-import { q as Value } from "./node-types-BrZu8T2C.js";
-
+import { l as CSSDataArena } from "./arena-Bx5vp6Sl.js";
+import { q as Value } from "./node-types-BRnQyc9B.js";
 //#region src/parse-value.d.ts
 /** @internal */
 declare class ValueParser {
-  private lexer;
+  private nodes;
   private arena;
-  private source;
-  private value_end;
   constructor(arena: CSSDataArena, source: string);
   parse_value(start: number, end: number, start_line: number, start_column: number): number;
-  private parse_value_tokens;
-  private is_whitespace_inline;
-  private parse_value_node;
-  private create_node;
-  private create_operator_node;
-  private parse_operator_node;
-  private parse_function_node;
-  private parse_parenthesis_node;
 }
 /**
  * Parse a CSS declaration value string and return a VALUE node

package/dist/parse-value.js

@@ -1,171 +1,25 @@
-import { t as Lexer } from "./tokenize-BiRLfVbm.js";
-import { l as CSSDataArena } from "./arena-CCye9VYE.js";
-import { a as is_whitespace, o as str_equals } from "./parse-dimension-B0AZRxxt.js";
-import { t as CSSNode } from "./css-node-TR2T5Q7D.js";
+import { l as CSSDataArena } from "./arena-CFwM4uQs.js";
+import { t as CSSNode } from "./css-node-B3EzCweR.js";
+import { t as ValueNodeParser } from "./value-node-parser-CZ47v3hp.js";
 //#region src/parse-value.ts
 /** @internal */
 var ValueParser = class {
-	lexer;
+	nodes;
 	arena;
-	source;
-	value_end;
 	constructor(arena, source) {
 		this.arena = arena;
-		this.source = source;
-		this.lexer = new Lexer(source);
-		this.value_end = 0;
+		this.nodes = new ValueNodeParser(arena, source);
 	}
 	parse_value(start, end, start_line, start_column) {
-		this.value_end = end;
-		this.lexer.seek(start, start_line, start_column);
-		let value_nodes = this.parse_value_tokens();
-		if (value_nodes.length === 0) return this.arena.create_node(50, start, 0, start_line, start_column);
-		let first_node_start = this.arena.get_start_offset(value_nodes[0]);
-		let last_node_index = value_nodes.at(-1);
-		let last_node_end = this.arena.get_start_offset(last_node_index) + this.arena.get_length(last_node_index);
+		let first_node = this.nodes.parse_chain(start, end, start_line, start_column);
+		if (first_node === 0) return this.arena.create_node(50, start, 0, start_line, start_column);
+		let last_node = this.nodes.last_chain_node;
+		let first_node_start = this.arena.get_start_offset(first_node);
+		let last_node_end = this.arena.get_start_offset(last_node) + this.arena.get_length(last_node);
 		let value_node = this.arena.create_node(50, first_node_start, last_node_end - first_node_start, start_line, start_column);
-		this.arena.append_children(value_node, value_nodes);
+		this.arena.set_first_child(value_node, first_node);
 		return value_node;
 	}
-	parse_value_tokens() {
-		let nodes = [];
-		while (this.lexer.pos < this.value_end) {
-			this.lexer.next_token_fast(false);
-			if (this.lexer.token_start >= this.value_end) break;
-			if (this.lexer.token_type === 26) break;
-			if (this.is_whitespace_inline()) continue;
-			let node = this.parse_value_node();
-			if (node !== null) nodes.push(node);
-		}
-		return nodes;
-	}
-	is_whitespace_inline() {
-		if (this.lexer.token_start >= this.lexer.token_end) return false;
-		for (let i = this.lexer.token_start; i < this.lexer.token_end; i++) if (!is_whitespace(this.source.charCodeAt(i))) return false;
-		return true;
-	}
-	parse_value_node() {
-		let token_type = this.lexer.token_type;
-		let start = this.lexer.token_start;
-		let end = this.lexer.token_end;
-		switch (token_type) {
-			case 1: return this.create_node(10, start, end);
-			case 10: return this.create_node(11, start, end);
-			case 11:
-			case 12: return this.create_node(12, start, end);
-			case 5: return this.create_node(13, start, end);
-			case 4: return this.create_node(14, start, end);
-			case 27: return this.create_node(19, start, end);
-			case 2: return this.parse_function_node(start, end);
-			case 9: return this.parse_operator_node(start, end);
-			case 18: return this.create_node(16, start, end);
-			case 21: return this.parse_parenthesis_node(start, end);
-			default: return null;
-		}
-	}
-	create_node(node_type, start, end) {
-		let node = this.arena.create_node(node_type, start, end - start, this.lexer.token_line, this.lexer.token_column);
-		this.arena.set_content_length(node, end - start);
-		return node;
-	}
-	create_operator_node(start, end) {
-		return this.create_node(16, start, end);
-	}
-	parse_operator_node(start, end) {
-		let ch = this.source.charCodeAt(start);
-		if (ch === 43 || ch === 45 || ch === 42 || ch === 47) return this.create_operator_node(start, end);
-		return null;
-	}
-	parse_function_node(start, end) {
-		let name_end = end - 1;
-		let func_name_substr = this.source.substring(start, name_end);
-		let node = this.arena.create_node(str_equals("url", func_name_substr) ? 18 : 15, start, 0, this.lexer.token_line, this.lexer.token_column);
-		this.arena.set_content_start_delta(node, 0);
-		this.arena.set_content_length(node, name_end - start);
-		if (str_equals("url", func_name_substr) || str_equals("src", func_name_substr)) {
-			let save_pos = this.lexer.save_position();
-			this.lexer.next_token_fast(false);
-			while (this.is_whitespace_inline() && this.lexer.pos < this.value_end) this.lexer.next_token_fast(false);
-			let first_token_type = this.lexer.token_type;
-			this.lexer.restore_position(save_pos);
-			if (first_token_type === 5) {} else {
-				let paren_depth = 1;
-				let func_end = end;
-				let content_start = end;
-				let content_end = end;
-				while (paren_depth > 0) {
-					this.lexer.next_token_fast(false);
-					let token_type = this.lexer.token_type;
-					if (token_type === 26) break;
-					if (token_type === 21 || token_type === 2) paren_depth++;
-					else if (token_type === 22) {
-						paren_depth--;
-						if (paren_depth === 0) {
-							content_end = this.lexer.token_start;
-							func_end = this.lexer.token_end;
-							break;
-						}
-					}
-				}
-				this.arena.set_length(node, func_end - start);
-				this.arena.set_value_start_delta(node, content_start - start);
-				this.arena.set_value_length(node, content_end - content_start);
-				return node;
-			}
-		}
-		let args = [];
-		let paren_depth = 1;
-		let func_end = end;
-		let content_start = end;
-		let content_end = end;
-		while (this.lexer.pos < this.value_end && paren_depth > 0) {
-			this.lexer.next_token_fast(false);
-			let token_type = this.lexer.token_type;
-			if (token_type === 26) break;
-			if (this.lexer.token_start >= this.value_end) break;
-			if (token_type === 22) {
-				paren_depth--;
-				if (paren_depth === 0) {
-					content_end = this.lexer.token_start;
-					func_end = this.lexer.token_end;
-					break;
-				}
-			}
-			if (this.is_whitespace_inline()) continue;
-			let arg_node = this.parse_value_node();
-			if (arg_node !== null) args.push(arg_node);
-		}
-		this.arena.set_length(node, func_end - start);
-		this.arena.set_value_start_delta(node, content_start - start);
-		this.arena.set_value_length(node, content_end - content_start);
-		this.arena.append_children(node, args);
-		return node;
-	}
-	parse_parenthesis_node(start, end) {
-		let node = this.arena.create_node(17, start, 0, this.lexer.token_line, this.lexer.token_column);
-		let children = [];
-		let paren_depth = 1;
-		let paren_end = end;
-		while (this.lexer.pos < this.value_end && paren_depth > 0) {
-			this.lexer.next_token_fast(false);
-			let token_type = this.lexer.token_type;
-			if (token_type === 26) break;
-			if (this.lexer.token_start >= this.value_end) break;
-			if (token_type === 22) {
-				paren_depth--;
-				if (paren_depth === 0) {
-					paren_end = this.lexer.token_end;
-					break;
-				}
-			}
-			if (this.is_whitespace_inline()) continue;
-			let child_node = this.parse_value_node();
-			if (child_node !== null) children.push(child_node);
-		}
-		this.arena.set_length(node, paren_end - start);
-		this.arena.append_children(node, children);
-		return node;
-	}
 };
 /**
 * Parse a CSS declaration value string and return a VALUE node

package/dist/parse.d.ts

@@ -1,7 +1,6 @@
-import { l as CSSDataArena } from "./arena-DfpuGV9Y.js";
+import { l as CSSDataArena } from "./arena-Bx5vp6Sl.js";
 import { t as CommentInfo } from "./tokenize-DeZYFa9R.js";
-import { z as StyleSheet } from "./node-types-BrZu8T2C.js";
-
+import { z as StyleSheet } from "./node-types-BRnQyc9B.js";
 //#region src/parse.d.ts
 interface ParserOptions {
   parse_values?: boolean;

package/dist/parse.js

@@ -1,7 +1,7 @@
 import { t as Lexer } from "./tokenize-BiRLfVbm.js";
-import { l as CSSDataArena } from "./arena-CCye9VYE.js";
-import { t as CSSNode } from "./css-node-TR2T5Q7D.js";
-import { i as trim_boundaries } from "./parse-utils-BmXnziOy.js";
+import { l as CSSDataArena } from "./arena-CFwM4uQs.js";
+import { t as CSSNode } from "./css-node-B3EzCweR.js";
+import { i as trim_boundaries } from "./parse-utils-D7srNG13.js";
 import { SelectorParser } from "./parse-selector.js";
 import { AtRulePreludeParser } from "./parse-atrule-prelude.js";
 import { DeclarationParser } from "./parse-declaration.js";
@@ -59,13 +59,18 @@ var Parser = class {
 	parse() {
 		this.next_token();
 		let stylesheet = this.arena.create_node(1, 0, this.source.length, 1, 1);
-		let rules = [];
+		let first_rule = 0;
+		let last_rule = 0;
 		while (!this.is_eof()) {
 			let rule = this.parse_rule();
 			if (rule === null) this.next_token();
-			else rules.push(rule);
+			else {
+				if (first_rule === 0) first_rule = rule;
+				else this.arena.set_next_sibling(last_rule, rule);
+				last_rule = rule;
+			}
 		}
-		this.arena.append_children(stylesheet, rules);
+		if (first_rule !== 0) this.arena.set_first_child(stylesheet, first_rule);
 		this.arena.trim();
 		return new CSSNode(this.arena, this.source, stylesheet);
 	}
@@ -88,25 +93,27 @@ var Parser = class {
 		let block_line = this.lexer.token_line;
 		let block_column = this.lexer.token_column;
 		let block_node = this.arena.create_node(7, block_start, 0, block_line, block_column);
-		let block_children = [];
+		let first_child = 0;
+		let last_child = 0;
 		while (!this.is_eof()) {
 			let token_type = this.peek_type();
 			if (token_type === 24) break;
+			let child = null;
 			if (token_type === 3) {
-				let nested_at_rule = this.parse_atrule();
-				if (nested_at_rule === null) this.next_token();
-				else block_children.push(nested_at_rule);
-				continue;
+				child = this.parse_atrule();
+				if (child === null) this.next_token();
+			} else {
+				child = this.parse_declaration();
+				if (child === null) {
+					child = this.parse_style_rule();
+					if (child === null) this.next_token();
+				} else this.arena.set_flag(style_rule, 32);
 			}
-			let declaration = this.parse_declaration();
-			if (declaration !== null) {
-				this.arena.set_flag(style_rule, 32);
-				block_children.push(declaration);
-				continue;
+			if (child !== null) {
+				if (first_child === 0) first_child = child;
+				else this.arena.set_next_sibling(last_child, child);
+				last_child = child;
 			}
-			let nested_rule = this.parse_style_rule();
-			if (nested_rule === null) this.next_token();
-			else block_children.push(nested_rule);
 		}
 		let block_end = this.lexer.token_start;
 		let rule_end = this.lexer.token_end;
@@ -116,12 +123,13 @@ var Parser = class {
 			this.next_token();
 		}
 		this.arena.set_length(block_node, block_end - block_start);
-		this.arena.append_children(block_node, block_children);
+		if (first_child !== 0) this.arena.set_first_child(block_node, first_child);
 		this.arena.set_length(style_rule, rule_end - rule_start);
-		let style_rule_children = [];
-		if (selector !== null) style_rule_children.push(selector);
-		style_rule_children.push(block_node);
-		this.arena.append_children(style_rule, style_rule_children);
+		if (selector === null) this.arena.set_first_child(style_rule, block_node);
+		else {
+			this.arena.set_first_child(style_rule, selector);
+			this.arena.set_next_sibling(selector, block_node);
+		}
 		return style_rule;
 	}
 	parse_selector() {
@@ -193,30 +201,37 @@ var Parser = class {
 			let block_column = this.lexer.token_column;
 			let block_node = this.arena.create_node(7, block_start, 0, block_line, block_column);
 			let has_declarations = this.atrule_has_declarations(at_rule_name);
-			let block_children = [];
+			let first_child = 0;
+			let last_child = 0;
 			if (has_declarations) while (!this.is_eof()) {
 				if (this.peek_type() === 24) break;
 				let declaration = this.parse_declaration();
 				if (declaration === null) this.next_token();
-				else block_children.push(declaration);
+				else {
+					if (first_child === 0) first_child = declaration;
+					else this.arena.set_next_sibling(last_child, declaration);
+					last_child = declaration;
+				}
 			}
 			else while (!this.is_eof()) {
 				let token_type = this.peek_type();
 				if (token_type === 24) break;
+				let child = null;
 				if (token_type === 3) {
-					let nested_at_rule = this.parse_atrule();
-					if (nested_at_rule === null) this.next_token();
-					else block_children.push(nested_at_rule);
-					continue;
+					child = this.parse_atrule();
+					if (child === null) this.next_token();
+				} else {
+					child = this.parse_declaration();
+					if (child === null) {
+						child = this.parse_style_rule();
+						if (child === null) this.next_token();
+					}
 				}
-				let declaration = this.parse_declaration();
-				if (declaration !== null) {
-					block_children.push(declaration);
-					continue;
+				if (child !== null) {
+					if (first_child === 0) first_child = child;
+					else this.arena.set_next_sibling(last_child, child);
+					last_child = child;
 				}
-				let nested_rule = this.parse_style_rule();
-				if (nested_rule === null) this.next_token();
-				else block_children.push(nested_rule);
 			}
 			if (this.peek_type() === 24) {
 				let block_end = this.lexer.token_start;
@@ -224,19 +239,20 @@ var Parser = class {
 				this.next_token();
 				this.arena.set_length(block_node, block_end - block_start);
 			} else this.arena.set_length(block_node, last_end - block_start);
-			this.arena.append_children(block_node, block_children);
-			let at_rule_children = [];
-			if (prelude_wrapper !== null) at_rule_children.push(prelude_wrapper);
-			at_rule_children.push(block_node);
+			if (first_child !== 0) this.arena.set_first_child(block_node, first_child);
 			this.arena.set_length(at_rule, last_end - at_rule_start);
-			this.arena.append_children(at_rule, at_rule_children);
+			if (prelude_wrapper === null) this.arena.set_first_child(at_rule, block_node);
+			else {
+				this.arena.set_first_child(at_rule, prelude_wrapper);
+				this.arena.set_next_sibling(prelude_wrapper, block_node);
+			}
 		} else {
 			if (this.peek_type() === 17) {
 				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]);
+			if (prelude_wrapper !== null) this.arena.set_first_child(at_rule, prelude_wrapper);
 		}
 		return at_rule;
 	}

package/dist/value-node-parser-CZ47v3hp.js

@@ -0,0 +1,176 @@
+import { t as Lexer } from "./tokenize-BiRLfVbm.js";
+import "./arena-CFwM4uQs.js";
+import { a as is_whitespace, o as str_equals } from "./parse-dimension-ouWXNHdx.js";
+//#region src/value-node-parser.ts
+/** @internal */
+var ValueNodeParser = class {
+	lexer;
+	arena;
+	source;
+	end = 0;
+	last_chain_node = 0;
+	constructor(arena, source) {
+		this.arena = arena;
+		this.source = source;
+		this.lexer = new Lexer(source);
+	}
+	parse_chain(start, end, start_line, start_column) {
+		this.end = end;
+		this.lexer.seek(start, start_line, start_column);
+		let first_node = 0;
+		let last_node = 0;
+		while (this.lexer.pos < this.end) {
+			this.lexer.next_token_fast(false);
+			if (this.lexer.token_start >= this.end) break;
+			if (this.lexer.token_type === 26) break;
+			if (this.is_whitespace_inline()) continue;
+			let node = this.parse_value_node();
+			if (node !== null) {
+				if (first_node === 0) first_node = node;
+				else this.arena.set_next_sibling(last_node, node);
+				last_node = node;
+			}
+		}
+		this.last_chain_node = last_node;
+		return first_node;
+	}
+	is_whitespace_inline() {
+		if (this.lexer.token_start >= this.lexer.token_end) return false;
+		for (let i = this.lexer.token_start; i < this.lexer.token_end; i++) if (!is_whitespace(this.source.charCodeAt(i))) return false;
+		return true;
+	}
+	parse_value_node() {
+		let token_type = this.lexer.token_type;
+		let start = this.lexer.token_start;
+		let end = this.lexer.token_end;
+		switch (token_type) {
+			case 1: return this.create_node(10, start, end);
+			case 10: return this.create_node(11, start, end);
+			case 11:
+			case 12: return this.create_node(12, start, end);
+			case 5: return this.create_node(13, start, end);
+			case 4: return this.create_node(14, start, end);
+			case 27: return this.create_node(19, start, end);
+			case 2: return this.parse_function_node(start, end);
+			case 9: return this.parse_operator_node(start, end);
+			case 18: return this.create_node(16, start, end);
+			case 21: return this.parse_parenthesis_node(start, end);
+			default: return null;
+		}
+	}
+	create_node(node_type, start, end) {
+		let node = this.arena.create_node(node_type, start, end - start, this.lexer.token_line, this.lexer.token_column);
+		this.arena.set_content_length(node, end - start);
+		return node;
+	}
+	create_operator_node(start, end) {
+		return this.create_node(16, start, end);
+	}
+	parse_operator_node(start, end) {
+		let ch = this.source.charCodeAt(start);
+		if (ch === 43 || ch === 45 || ch === 42 || ch === 47) return this.create_operator_node(start, end);
+		return null;
+	}
+	parse_function_node(start, end) {
+		let name_end = end - 1;
+		let func_name_substr = this.source.substring(start, name_end);
+		let node = this.arena.create_node(str_equals("url", func_name_substr) ? 18 : 15, start, 0, this.lexer.token_line, this.lexer.token_column);
+		this.arena.set_content_start_delta(node, 0);
+		this.arena.set_content_length(node, name_end - start);
+		if (str_equals("url", func_name_substr) || str_equals("src", func_name_substr)) {
+			let save_pos = this.lexer.save_position();
+			this.lexer.next_token_fast(false);
+			while (this.is_whitespace_inline() && this.lexer.pos < this.end) this.lexer.next_token_fast(false);
+			let first_token_type = this.lexer.token_type;
+			this.lexer.restore_position(save_pos);
+			if (first_token_type === 5) {} else {
+				let paren_depth = 1;
+				let func_end = end;
+				let content_start = end;
+				let content_end = end;
+				while (paren_depth > 0) {
+					this.lexer.next_token_fast(false);
+					let token_type = this.lexer.token_type;
+					if (token_type === 26) break;
+					if (token_type === 21 || token_type === 2) paren_depth++;
+					else if (token_type === 22) {
+						paren_depth--;
+						if (paren_depth === 0) {
+							content_end = this.lexer.token_start;
+							func_end = this.lexer.token_end;
+							break;
+						}
+					}
+				}
+				this.arena.set_length(node, func_end - start);
+				this.arena.set_value_start_delta(node, content_start - start);
+				this.arena.set_value_length(node, content_end - content_start);
+				return node;
+			}
+		}
+		let first_arg = 0;
+		let last_arg = 0;
+		let paren_depth = 1;
+		let func_end = end;
+		let content_start = end;
+		let content_end = end;
+		while (this.lexer.pos < this.end && paren_depth > 0) {
+			this.lexer.next_token_fast(false);
+			let token_type = this.lexer.token_type;
+			if (token_type === 26) break;
+			if (this.lexer.token_start >= this.end) break;
+			if (token_type === 22) {
+				paren_depth--;
+				if (paren_depth === 0) {
+					content_end = this.lexer.token_start;
+					func_end = this.lexer.token_end;
+					break;
+				}
+			}
+			if (this.is_whitespace_inline()) continue;
+			let arg_node = this.parse_value_node();
+			if (arg_node !== null) {
+				if (first_arg === 0) first_arg = arg_node;
+				else this.arena.set_next_sibling(last_arg, arg_node);
+				last_arg = arg_node;
+			}
+		}
+		this.arena.set_length(node, func_end - start);
+		this.arena.set_value_start_delta(node, content_start - start);
+		this.arena.set_value_length(node, content_end - content_start);
+		if (first_arg !== 0) this.arena.set_first_child(node, first_arg);
+		return node;
+	}
+	parse_parenthesis_node(start, end) {
+		let node = this.arena.create_node(17, start, 0, this.lexer.token_line, this.lexer.token_column);
+		let first_child = 0;
+		let last_child = 0;
+		let paren_depth = 1;
+		let paren_end = end;
+		while (this.lexer.pos < this.end && paren_depth > 0) {
+			this.lexer.next_token_fast(false);
+			let token_type = this.lexer.token_type;
+			if (token_type === 26) break;
+			if (this.lexer.token_start >= this.end) break;
+			if (token_type === 22) {
+				paren_depth--;
+				if (paren_depth === 0) {
+					paren_end = this.lexer.token_end;
+					break;
+				}
+			}
+			if (this.is_whitespace_inline()) continue;
+			let child_node = this.parse_value_node();
+			if (child_node !== null) {
+				if (first_child === 0) first_child = child_node;
+				else this.arena.set_next_sibling(last_child, child_node);
+				last_child = child_node;
+			}
+		}
+		this.arena.set_length(node, paren_end - start);
+		if (first_child !== 0) this.arena.set_first_child(node, first_child);
+		return node;
+	}
+};
+//#endregion
+export { ValueNodeParser as t };

package/dist/walk.d.ts

@@ -1,17 +1,12 @@
-import { o as CSSNode, t as AnyNode } from "./node-types-BrZu8T2C.js";
-
+import { o as CSSNode, t as AnyNode } from "./node-types-BRnQyc9B.js";
 //#region src/walk.d.ts
 declare const SKIP: unique symbol;
 declare const BREAK: unique symbol;
 type WalkCallback = (node: AnyNode, depth: number) => void | typeof SKIP | typeof BREAK;
 /**
- * Walk the AST in depth-first order, calling the callback for each node.
- * Return SKIP to skip children, BREAK to stop traversal. See API.md for examples.
- *
- * @param node - The root node to start walking from
- * @param callback - Function called for each node. Receives the node and its nesting depth.
- *                   Depth increments only for STYLE_RULE and AT_RULE nodes (tracks rule nesting, not tree depth).
- * @param depth - Starting depth (default: 0)
+ * Walk the AST depth-first, calling `callback` for each node. Return SKIP to skip
+ * children, BREAK to stop. `depth` tracks rule nesting (STYLE_RULE/AT_RULE only),
+ * not tree depth.
  */
 declare function walk(node: CSSNode, callback: WalkCallback, depth?: number): boolean;
 type WalkEnterLeaveCallback = (node: AnyNode) => void | typeof SKIP | typeof BREAK;
@@ -20,15 +15,9 @@ interface WalkEnterLeaveOptions {
   leave?: WalkEnterLeaveCallback;
 }
 /**
- * Walk the AST in depth-first order, calling enter before visiting children and leave after.
- * Return SKIP in enter to skip children (leave still called), BREAK to stop (leave NOT called). See API.md for examples.
- *
- * @param node - The root node to start walking from
- * @param options - Object with optional enter and leave callback functions
+ * Walk the AST depth-first, calling `enter` before children and `leave` after.
+ * SKIP in enter skips children (leave still runs); BREAK stops (leave doesn't run).
  */
-declare function traverse(node: CSSNode, {
-  enter,
-  leave
-}?: WalkEnterLeaveOptions): boolean;
+declare function traverse(node: CSSNode, { enter, leave }?: WalkEnterLeaveOptions): boolean;
 //#endregion
 export { BREAK, SKIP, traverse, walk };

package/dist/walk.js

@@ -1,17 +1,13 @@
-import "./arena-CCye9VYE.js";
-import { t as CSSNode } from "./css-node-TR2T5Q7D.js";
+import "./arena-CFwM4uQs.js";
+import { t as CSSNode } from "./css-node-B3EzCweR.js";
 import "./constants.js";
 //#region src/walk.ts
 const SKIP = Symbol("SKIP");
 const BREAK = Symbol("BREAK");
 /**
-* Walk the AST in depth-first order, calling the callback for each node.
-* Return SKIP to skip children, BREAK to stop traversal. See API.md for examples.
-*
-* @param node - The root node to start walking from
-* @param callback - Function called for each node. Receives the node and its nesting depth.
-*                   Depth increments only for STYLE_RULE and AT_RULE nodes (tracks rule nesting, not tree depth).
-* @param depth - Starting depth (default: 0)
+* Walk the AST depth-first, calling `callback` for each node. Return SKIP to skip
+* children, BREAK to stop. `depth` tracks rule nesting (STYLE_RULE/AT_RULE only),
+* not tree depth.
 */
 function walk(node, callback, depth = 0) {
 	const result = callback(node, depth);
@@ -45,11 +41,8 @@ function _walk(arena, source, index, callback, depth) {
 }
 const NOOP = function() {};
 /**
-* Walk the AST in depth-first order, calling enter before visiting children and leave after.
-* Return SKIP in enter to skip children (leave still called), BREAK to stop (leave NOT called). See API.md for examples.
-*
-* @param node - The root node to start walking from
-* @param options - Object with optional enter and leave callback functions
+* Walk the AST depth-first, calling `enter` before children and `leave` after.
+* SKIP in enter skips children (leave still runs); BREAK stops (leave doesn't run).
 */
 function traverse(node, { enter = NOOP, leave = NOOP } = {}) {
 	const enter_result = enter(node);