@projectwallace/css-parser 0.13.8 → 0.13.10

package/dist/tokenize.js

@@ -1,2 +1,2 @@
-import { n as tokenize, t as Lexer } from "./tokenize-BQFB1jXg.js";
+import { n as tokenize, t as Lexer } from "./tokenize-BSycRGm0.js";
 export { Lexer, tokenize };

package/dist/walk.d.ts

@@ -0,0 +1,34 @@
+import { r as CSSNode } from "./css-node-B9tSb6YD.js";
+
+//#region src/walk.d.ts
+declare const SKIP: unique symbol;
+declare const BREAK: unique symbol;
+type WalkCallback = (node: CSSNode, 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)
+ */
+declare function walk(node: CSSNode, callback: WalkCallback, depth?: number): boolean;
+type WalkEnterLeaveCallback = (node: CSSNode) => void | typeof SKIP | typeof BREAK;
+interface WalkEnterLeaveOptions {
+  enter?: WalkEnterLeaveCallback;
+  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
+ */
+declare function traverse(node: CSSNode, {
+  enter,
+  leave
+}?: WalkEnterLeaveOptions): boolean;
+//#endregion
+export { BREAK, SKIP, traverse, walk };

package/dist/walk.js

@@ -0,0 +1,53 @@
+import "./arena-CDAx4eAB.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)
+*/
+function walk(node, callback, depth = 0) {
+	const result = callback(node, depth);
+	if (result === BREAK) return false;
+	if (result === SKIP) return true;
+	let child_depth = depth;
+	if (node.type === 2 || node.type === 3) child_depth = depth + 1;
+	let child = node.first_child;
+	while (child) {
+		if (!walk(child, callback, child_depth)) return false;
+		child = child.next_sibling;
+	}
+	return true;
+}
+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
+*/
+function traverse(node, { enter = NOOP, leave = NOOP } = {}) {
+	const enter_result = enter(node);
+	if (enter_result === BREAK) return false;
+	if (enter_result !== SKIP) {
+		let child = node.first_child;
+		while (child) {
+			if (!traverse(child, {
+				enter,
+				leave
+			})) return false;
+			child = child.next_sibling;
+		}
+	}
+	if (leave(node) === BREAK) return false;
+	return true;
+}
+//#endregion
+export { BREAK, SKIP, traverse, walk };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@projectwallace/css-parser",
-	"version": "0.13.8",
+	"version": "0.13.10",
 	"description": "High-performance CSS lexer and parser, optimized for CSS inspection and analysis",
 	"keywords": [
 		"ast",
@@ -60,6 +60,14 @@
 		"./parse-dimension": {
 			"types": "./dist/parse-dimension.d.ts",
 			"import": "./dist/parse-dimension.js"
+		},
+		"./walker": {
+			"types": "./dist/walk.d.ts",
+			"import": "./dist/walk.js"
+		},
+		"./nodes": {
+			"types": "./dist/constants.d.ts",
+			"import": "./dist/constants.js"
 		}
 	},
 	"scripts": {
@@ -71,6 +79,7 @@
 		"benchmark:memory": "npm run build && node --expose-gc benchmark/memory.ts",
 		"lint": "oxlint --config .oxlintrc.json && oxfmt --check",
 		"check": "tsc --noEmit",
+		"knip": "knip",
 		"precommit": "npm run test -- --run; npm run lint; npm run check"
 	},
 	"devDependencies": {
@@ -80,12 +89,13 @@
 		"@vitest/coverage-v8": "^4.0.8",
 		"bootstrap": "^5.3.8",
 		"css-tree": "^3.1.0",
-		"oxfmt": "^0.36.0",
+		"knip": "^6.0.1",
+		"oxfmt": "^0.41.0",
 		"oxlint": "^1.28.0",
 		"postcss": "^8.5.6",
 		"publint": "^0.3.18",
 		"tailwindcss": "^2.2.8",
-		"tinybench": "^2.9.0",
+		"tinybench": "^6.0.0",
 		"tsdown": "^0.21.0",
 		"typescript": "^5.9.3",
 		"vitest": "^4.0.8"