@jesscss/less-parser 2.0.0-alpha.1 → 2.0.0-alpha.11

package/lib/index.cjs

@@ -0,0 +1,72 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_grammar = require("./grammar2.cjs");
+let parseman = require("parseman");
+let _jesscss_core = require("@jesscss/core");
+let _jesscss_core_ast = require("@jesscss/core/ast");
+//#region src/index.ts
+function isStylesheet(value) {
+	return typeof value === "object" && value !== null && "type" in value && value.type === "Stylesheet" && "children" in value && Array.isArray(value.children);
+}
+/** Parse Less directly into the canonical AST v2 document. */
+function parse(input) {
+	const entry = require_grammar.lessAstGrammar.Stylesheet;
+	const trivia = require_grammar.lessAstGrammar.whitespace;
+	if (entry === void 0 || trivia === void 0) throw new TypeError("Less AST grammar is missing its public document entry.");
+	const result = (0, parseman.run)(entry, input, {
+		trivia,
+		state: { source: input }
+	});
+	if (!result.ok) throw new require_grammar.LessParseError(result.span.start, result.expected);
+	if (result.unconsumedFrom !== null) {
+		if (result.unconsumedFrom > result.span.start) throw new require_grammar.LessParseError(result.unconsumedFrom, [], {
+			message: "Unexpected Less input after a complete stylesheet.",
+			reason: "The parser consumed a complete Less stylesheet before this token, so the remaining text is not part of any rule, declaration, or at-rule.",
+			fix: "Remove the extra input or wrap it in valid Less syntax."
+		});
+		throw new require_grammar.LessParseError(result.unconsumedFrom, [], {
+			message: "Unexpected Less syntax.",
+			reason: "The parser could not match this token as the start of a Less rule, declaration, or at-rule.",
+			fix: "Remove the token or rewrite it as valid Less syntax."
+		});
+	}
+	if (!isStylesheet(result.value)) throw new require_grammar.LessParseError(result.span.end, [], {
+		message: "Less parser did not produce a stylesheet.",
+		reason: "The Less parser matched the input but returned a value that is not a stylesheet document.",
+		fix: "Report this as a parser bug with the source that triggered it."
+	});
+	return (0, _jesscss_core_ast.withTriviaMap)((0, _jesscss_core_ast.withSourceSpan)(result.value, result.span), (0, _jesscss_core_ast.createTriviaMapFromParseman)(input, result.triviaMap));
+}
+/**
+* Parse Less for the product plugin path. Parser packages own recognition facts;
+* this boundary attaches file/source context once and returns normalized
+* diagnostics for compiler and CLI consumers to render.
+*/
+function safeParse(filePath, input) {
+	try {
+		return {
+			document: parse(input),
+			errors: [],
+			warnings: []
+		};
+	} catch (error) {
+		return {
+			errors: [(0, _jesscss_core.parserDiagnostic)({
+				dialect: "Less",
+				error,
+				filePath,
+				source: input
+			})],
+			warnings: []
+		};
+	}
+}
+//#endregion
+exports.LessBareVariableInterpolationError = require_grammar.LessBareVariableInterpolationError;
+exports.LessDynamicCharsetError = require_grammar.LessDynamicCharsetError;
+exports.LessInlineJavaScriptError = require_grammar.LessInlineJavaScriptError;
+exports.LessParseError = require_grammar.LessParseError;
+exports.LessUnparenthesizedMixinGuardError = require_grammar.LessUnparenthesizedMixinGuardError;
+exports.LessUnsupportedMixinNameError = require_grammar.LessUnsupportedMixinNameError;
+exports.LessUnsupportedVariableNameError = require_grammar.LessUnsupportedVariableNameError;
+exports.parse = parse;
+exports.safeParse = safeParse;

package/lib/index.d.ts

@@ -1,33 +1,12 @@
-import { type CstNode, Lexer } from 'chevrotain';
-import { LessActionsParser, type LessParserConfig } from './lessActionsParser.js';
-import type { ConditionalPick } from 'type-fest';
-import type { Rules, IParseResult } from '@jesscss/core';
-export * from './lessActionsParser.js';
-export * from './lessTokens.js';
-export type LessRules = keyof ConditionalPick<LessActionsParser, () => CstNode>;
-export type SyntacticContentAssistSuggestion = {
-    nextTokenType: string;
-    nextTokenLabel?: string;
-    ruleStack: string[];
-    occurrenceStack: number[];
-};
-export declare class Parser {
-    lexer: Lexer;
-    /** @todo - return Jess AST as parser */
-    parser: LessActionsParser;
-    constructor(config?: LessParserConfig);
-    parse(text: string): IParseResult<Rules>;
-    parse(text: string, rule: 'stylesheet', ...args: Parameters<LessActionsParser['stylesheet']>): IParseResult<Rules>;
-    parse<T extends LessRules = LessRules>(text: string, rule?: T, ...args: Parameters<LessActionsParser[T]>): IParseResult;
-    /**
-     * IDE helper: suggest next possible token types at `offset` using Chevrotain's
-     * syntactic content assist. This is syntactic-only (not semantic completion).
-     *
-     * Note: content assist is significantly slower than normal parsing, so it
-     * should be called on-demand (e.g. near the cursor).
-     */
-    suggest(text: string, init: {
-        offset: number;
-        rule?: LessRules;
-    }): SyntacticContentAssistSuggestion[];
-}
+import { type ISafeParseResult } from '@jesscss/core';
+import { type Stylesheet } from '@jesscss/core/ast';
+export { LessBareVariableInterpolationError, LessDynamicCharsetError, LessInlineJavaScriptError, LessParseError, LessUnparenthesizedMixinGuardError, LessUnsupportedMixinNameError, LessUnsupportedVariableNameError } from './parse-error.js';
+/** Parse Less directly into the canonical AST v2 document. */
+export declare function parse(input: string): Stylesheet;
+/**
+ * Parse Less for the product plugin path. Parser packages own recognition facts;
+ * this boundary attaches file/source context once and returns normalized
+ * diagnostics for compiler and CLI consumers to render.
+ */
+export declare function safeParse(filePath: string, input: string): ISafeParseResult;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EACL,kCAAkC,EAClC,uBAAuB,EACvB,yBAAyB,EACzB,cAAc,EACd,kCAAkC,EAClC,6BAA6B,EAC7B,gCAAgC,EACjC,MAAM,kBAAkB,CAAC;AAa1B,8DAA8D;AAC9D,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAwC/C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAW3E"}

package/lib/index.js

@@ -1,75 +1,63 @@
-import { Lexer } from 'chevrotain';
-import { lessTokens, lessFragments } from './lessTokens.js';
-import { createLexerDefinition } from '@jesscss/css-parser';
-import { LessActionsParser } from './lessActionsParser.js';
-import { LessErrorMessageProvider } from './lessErrorMessageProvider.js';
-export * from './lessActionsParser.js';
-export * from './lessTokens.js';
-const errorMessageProvider = new LessErrorMessageProvider();
-export class Parser {
-    lexer;
-    /** @todo - return Jess AST as parser */
-    parser;
-    constructor(config = {}) {
-        config = {
-            errorMessageProvider,
-            /**
-             * Override this if you want a stricter Less/CSS parser.
-             * @todo - Allow overriding when parsing a single rule.
-             */
-            looseMode: true,
-            skipValidations: process.env.TEST !== 'true',
-            ...config
-        };
-        const { lexer, T } = createLexerDefinition(lessFragments(), lessTokens());
-        this.lexer = new Lexer(lexer, {
-            ensureOptimizations: true,
-            skipValidations: process.env.TEST !== 'true'
-        });
-        this.parser = new LessActionsParser(lexer, T, config);
-        /** Not sure why this is necessary, but Less tests were a problem */
-        this.parse = this.parse.bind(this);
-    }
-    parse(text, rule = 'stylesheet', ...args) {
-        const parser = this.parser;
-        const lexerResult = this.lexer.tokenize(text);
-        const lexedTokens = lexerResult.tokens;
-        // Reset warnings BEFORE setting input, in case input setter does something that affects warnings
-        parser.warnings = [];
-        parser.input = lexedTokens;
-        const tree = parser[rule](...args);
-        // Capture warnings immediately after parsing to ensure they're not lost
-        const warnings = [...parser.warnings];
-        if (parser.errors.length > 0) {
-            const firstError = parser.errors[0];
-            const firstToken = firstError?.token;
-        }
-        return { tree, lexerResult, errors: parser.errors, warnings };
-    }
-    /**
-     * IDE helper: suggest next possible token types at `offset` using Chevrotain's
-     * syntactic content assist. This is syntactic-only (not semantic completion).
-     *
-     * Note: content assist is significantly slower than normal parsing, so it
-     * should be called on-demand (e.g. near the cursor).
-     */
-    suggest(text, init) {
-        const { offset, rule = 'stylesheet' } = init;
-        const prefix = text.slice(0, Math.max(0, offset));
-        const lexerResult = this.lexer.tokenize(prefix);
-        const tokens = lexerResult.tokens;
-        try {
-            const paths = this.parser.computeContentAssist(rule, tokens);
-            return paths.map(p => ({
-                nextTokenType: p.nextTokenType.name,
-                nextTokenLabel: p.nextTokenType.LABEL,
-                ruleStack: p.ruleStack,
-                occurrenceStack: p.occurrenceStack
-            }));
-        }
-        catch {
-            return [];
-        }
-    }
+import { a as LessDynamicCharsetError, c as LessUnparenthesizedMixinGuardError, i as LessBareVariableInterpolationError, l as LessUnsupportedMixinNameError, o as LessInlineJavaScriptError, s as LessParseError, t as lessAstGrammar, u as LessUnsupportedVariableNameError } from "./grammar2.js";
+import { run } from "parseman";
+import { parserDiagnostic } from "@jesscss/core";
+import { createTriviaMapFromParseman, withSourceSpan, withTriviaMap } from "@jesscss/core/ast";
+//#region src/index.ts
+function isStylesheet(value) {
+	return typeof value === "object" && value !== null && "type" in value && value.type === "Stylesheet" && "children" in value && Array.isArray(value.children);
 }
-//# sourceMappingURL=index.js.map
+/** Parse Less directly into the canonical AST v2 document. */
+function parse(input) {
+	const entry = lessAstGrammar.Stylesheet;
+	const trivia = lessAstGrammar.whitespace;
+	if (entry === void 0 || trivia === void 0) throw new TypeError("Less AST grammar is missing its public document entry.");
+	const result = run(entry, input, {
+		trivia,
+		state: { source: input }
+	});
+	if (!result.ok) throw new LessParseError(result.span.start, result.expected);
+	if (result.unconsumedFrom !== null) {
+		if (result.unconsumedFrom > result.span.start) throw new LessParseError(result.unconsumedFrom, [], {
+			message: "Unexpected Less input after a complete stylesheet.",
+			reason: "The parser consumed a complete Less stylesheet before this token, so the remaining text is not part of any rule, declaration, or at-rule.",
+			fix: "Remove the extra input or wrap it in valid Less syntax."
+		});
+		throw new LessParseError(result.unconsumedFrom, [], {
+			message: "Unexpected Less syntax.",
+			reason: "The parser could not match this token as the start of a Less rule, declaration, or at-rule.",
+			fix: "Remove the token or rewrite it as valid Less syntax."
+		});
+	}
+	if (!isStylesheet(result.value)) throw new LessParseError(result.span.end, [], {
+		message: "Less parser did not produce a stylesheet.",
+		reason: "The Less parser matched the input but returned a value that is not a stylesheet document.",
+		fix: "Report this as a parser bug with the source that triggered it."
+	});
+	return withTriviaMap(withSourceSpan(result.value, result.span), createTriviaMapFromParseman(input, result.triviaMap));
+}
+/**
+* Parse Less for the product plugin path. Parser packages own recognition facts;
+* this boundary attaches file/source context once and returns normalized
+* diagnostics for compiler and CLI consumers to render.
+*/
+function safeParse(filePath, input) {
+	try {
+		return {
+			document: parse(input),
+			errors: [],
+			warnings: []
+		};
+	} catch (error) {
+		return {
+			errors: [parserDiagnostic({
+				dialect: "Less",
+				error,
+				filePath,
+				source: input
+			})],
+			warnings: []
+		};
+	}
+}
+//#endregion
+export { LessBareVariableInterpolationError, LessDynamicCharsetError, LessInlineJavaScriptError, LessParseError, LessUnparenthesizedMixinGuardError, LessUnsupportedMixinNameError, LessUnsupportedVariableNameError, parse, safeParse };

package/lib/parse-error.d.ts

@@ -0,0 +1,68 @@
+/** Structured failure from the public direct Less parser. */
+export declare class LessParseError extends SyntaxError {
+    readonly code: 'parse/syntax-error';
+    readonly offset: number;
+    readonly expected: readonly string[];
+    readonly reason?: string;
+    readonly fix?: string;
+    constructor(offset: number, expected: readonly string[], options?: {
+        message?: string;
+        reason?: string;
+        fix?: string;
+    });
+}
+/** Interpolation is rejected inside the CSS @charset token. */
+export declare class LessDynamicCharsetError extends SyntaxError {
+    readonly code: 'parse/dynamic-charset';
+    readonly offset: number;
+    readonly endOffset: number;
+    readonly reason = "Interpolation is not valid inside the CSS @charset token.";
+    readonly fix = "Use a static declaration such as @charset \"UTF-8\";";
+    constructor(offset: number, endOffset: number);
+}
+/** Executable inline backtick JavaScript is recognized so diagnostics can be precise. */
+export declare class LessInlineJavaScriptError extends SyntaxError {
+    readonly code: 'parse/unsupported-inline-javascript';
+    readonly offset: number;
+    readonly endOffset: number;
+    readonly reason = "Backtick JavaScript expressions are not evaluated.";
+    readonly fix = "Move the expression into an explicit @from/@-from script import or a plugin function.";
+    constructor(offset: number, endOffset: number);
+}
+/** Syntax/prelude slots require explicit @{name} interpolation. */
+export declare class LessBareVariableInterpolationError extends SyntaxError {
+    readonly code: 'parse/unsupported-bare-variable-interpolation';
+    readonly offset: number;
+    readonly endOffset: number;
+    readonly reason: string;
+    readonly fix: string;
+    constructor(offset: number, endOffset: number, name: string);
+}
+/** Legacy Less variable names are recognized so diagnostics can be precise. */
+export declare class LessUnsupportedVariableNameError extends SyntaxError {
+    readonly code: 'parse/unsupported-variable-name';
+    readonly offset: number;
+    readonly endOffset: number;
+    readonly reason = "Less variable names must not be numeric-leading or dash-only.";
+    readonly fix: string;
+    constructor(offset: number, endOffset: number, name: string);
+}
+/** Legacy dash-only mixin names are recognized so diagnostics can be precise. */
+export declare class LessUnsupportedMixinNameError extends SyntaxError {
+    readonly code: 'parse/unsupported-mixin-name';
+    readonly offset: number;
+    readonly endOffset: number;
+    readonly reason = "Dash-only Less mixin names are not supported.";
+    readonly fix = "Rename the mixin to a descriptive selector-like name, for example .mixin().";
+    constructor(offset: number, endOffset: number);
+}
+/** Ungrouped Less mixin guards are recognized so diagnostics can point at the guard. */
+export declare class LessUnparenthesizedMixinGuardError extends SyntaxError {
+    readonly code: 'parse/unparenthesized-mixin-guard';
+    readonly offset: number;
+    readonly endOffset: number;
+    readonly reason = "Top-level Less mixin guards require each condition after when to be wrapped in parentheses.";
+    readonly fix = "Wrap the guard condition, for example: when (default()).";
+    constructor(offset: number, endOffset: number);
+}
+//# sourceMappingURL=parse-error.d.ts.map

package/lib/parse-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-error.d.ts","sourceRoot":"","sources":["../src/parse-error.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,22 +1,31 @@
 {
   "name": "@jesscss/less-parser",
+  "type": "module",
   "publishConfig": {
     "access": "public"
   },
-  "version": "2.0.0-alpha.1",
+  "version": "2.0.0-alpha.11",
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
   "description": "Jess LESS parser",
-  "main": "lib/index.js",
+  "main": "lib/index.cjs",
   "types": "lib/index.d.ts",
   "exports": {
     ".": {
-      "import": "./lib/index.js",
       "types": "./lib/index.d.ts",
-      "source": "./src/index.ts"
+      "import": "./lib/index.js",
+      "require": "./lib/index.cjs"
     },
-    "./*": {
-      "types": "./lib/*.d.ts",
-      "import": "./lib/*.js",
-      "source": "./src/*.ts"
+    "./cst": {
+      "types": "./lib/cst.d.ts",
+      "import": "./lib/cst.js",
+      "require": "./lib/cst.cjs"
+    },
+    "./grammar": {
+      "types": "./lib/grammar.d.ts",
+      "import": "./lib/grammar.js",
+      "require": "./lib/grammar.cjs"
     },
     "./package.json": "./package.json"
   },
@@ -24,15 +33,27 @@
     "lib"
   ],
   "dependencies": {
-    "chevrotain": "^11.0.3",
-    "chevrotain-allstar": "~0.3.0",
     "known-css-properties": "~0.37.0",
-    "@jesscss/css-parser": "2.0.0-alpha.1",
-    "@jesscss/core": "2.0.0-alpha.1"
+    "@jesscss/css-parser": "2.0.0-alpha.11"
+  },
+  "peerDependencies": {
+    "parseman": "^0.41.0",
+    "@jesscss/core": "2.0.0-alpha.11"
+  },
+  "peerDependenciesMeta": {
+    "@jesscss/core": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@types/node": "^18.19.31",
-    "@jesscss/shared": "2.0.0-alpha.1"
+    "less": "^4.6.3",
+    "parseman": "^0.41.0",
+    "postcss-less": "~6.0.0",
+    "tsx": "~4.21.0",
+    "@jesscss/core": "2.0.0-alpha.11",
+    "@jesscss/shared": "2.0.0-alpha.1",
+    "@jesscss/parser-shared": "0.0.0"
   },
   "author": "Matthew Dean <matthew-dean@users.noreply.github.com>",
   "license": "MIT",
@@ -40,14 +61,17 @@
     "url": "https://github.com/jesscss/jess/issues"
   },
   "homepage": "https://github.com/jesscss/jess#readme",
+  "module": "lib/index.js",
   "scripts": {
     "ci": "pnpm build && pnpm test",
-    "build": "pnpm compile",
-    "compile": "tsc -p tsconfig.build.json",
-    "dev": "tsc -p tsconfig.build.json -w",
+    "build": "pnpm --filter @jesscss/parser-shared build && pnpm compile",
+    "compile": "tsdown --tsconfig tsconfig.build.json --no-dts && tsc -p tsconfig.build.json --emitDeclarationOnly --noCheck",
+    "dev": "tsdown --tsconfig tsconfig.build.json --watch",
     "test": "cross-env TEST=true vitest --watch=false",
     "test:coverage": "cross-env TEST=true vitest --coverage",
     "lint:fix": "eslint --fix '**/*.{js,ts}'",
-    "lint": "eslint '**/*.{js,ts}'"
+    "lint": "eslint '**/*.{js,ts}'",
+    "oracle:postcss-less": "node test/postcss-less-oracle.mjs",
+    "bench:postcss-less": "node test/postcss-less-oracle.mjs --bench"
   }
 }

package/lib/__tests__/debug-log.d.ts

@@ -1 +0,0 @@
-export declare const syncLog: (data: object) => void;

package/lib/__tests__/debug-log.js

@@ -1,34 +0,0 @@
-/**
- * Synchronous debug logging utility for tests.
- * This file is in __tests__ so it won't be included in the public API.
- */
-import { appendFileSync, existsSync, mkdirSync } from 'fs';
-import { join, dirname } from 'path';
-// Find monorepo root by looking for pnpm-workspace.yaml
-function findMonorepoRoot(start) {
-    let dir = start;
-    while (dir !== '/') {
-        if (existsSync(join(dir, 'pnpm-workspace.yaml'))) {
-            return dir;
-        }
-        dir = dirname(dir);
-    }
-    return process.cwd();
-}
-const ROOT = findMonorepoRoot(__dirname);
-const LOG_DIR = join(ROOT, '.cursor');
-const LOG_PATH = process.env.DEBUG_LOG_PATH || join(LOG_DIR, 'debug.log');
-// Ensure directory exists
-try {
-    mkdirSync(LOG_DIR, { recursive: true });
-}
-catch { }
-export const syncLog = (data) => {
-    try {
-        appendFileSync(LOG_PATH, JSON.stringify(data) + '\n');
-    }
-    catch {
-        // Ignore errors
-    }
-};
-//# sourceMappingURL=debug-log.js.map

package/lib/__tests__/debug-log.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"debug-log.js","sourceRoot":"","sources":["../../src/__tests__/debug-log.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAErC,wDAAwD;AACxD,SAAS,gBAAgB,CAAC,KAAa;IACrC,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,OAAO,GAAG,KAAK,GAAG,EAAE,CAAC;QACnB,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC,EAAE,CAAC;YACjD,OAAO,GAAG,CAAC;QACb,CAAC;QACD,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;AACvB,CAAC;AAED,MAAM,IAAI,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;AACzC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AAE1E,0BAA0B;AAC1B,IAAI,CAAC;IAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAAC,CAAC;AAAC,MAAM,CAAC,CAAA,CAAC;AAEzD,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,EAAE;IACtC,IAAI,CAAC;QACH,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,gBAAgB;IAClB,CAAC;AACH,CAAC,CAAC"}

package/lib/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/lib/lessActionsParser.d.ts

@@ -1,156 +0,0 @@
-import type { TokenVocabulary, TokenType, IToken } from 'chevrotain';
-import { type Rule, type RuleContext as CssRuleContext, type CssParserConfig, CssActionsParser, type CssTokenType, type TokenMap as CssTokenMap } from '@jesscss/css-parser';
-import { Reference, type MathMode, type Node, type Extend, type ComplexSelector, type Selector } from '@jesscss/core';
-import { type LessExtraTokenType } from './lessTokens.js';
-export type LessParserConfig = CssParserConfig & {
-    /**
-     * Is less strict with certain CSS rules and Less syntax
-     * that the old Less parser allowed.
-     *
-     * @note This will also enable CSS legacyMode unless
-     * legacyMode is explicitly false.
-     */
-    looseMode?: boolean;
-    /**
-     * Controls whether mixins and detached rulesets "leak" their inner rules.
-     * When true (default):
-     * - Mixins: Mixin and VarDeclaration nodes are 'public' and 'optional' respectively
-     * - Detached rulesets: Mixin and VarDeclaration nodes are 'public' and 'private' respectively
-     * When false:
-     * - Both mixins and detached rulesets: Mixin and VarDeclaration nodes are 'private'
-     */
-    leakyRules?: boolean;
-    /**
-     * Less math evaluation mode. Used during parsing to decide whether a given
-     * `Operation` should be represented as an `Expression` for Less→Jess conversion.
-     *
-     * Mirrors runtime behavior in `Context.shouldOperate()`.
-     *
-     * @default 'parens-division'
-     */
-    mathMode?: MathMode;
-    /**
-     * When enabled (default), the parser will wrap the *outermost* Less math/value
-     * expressions (math operations, variable references, and chained mixin/variable
-     * calls) in an `Expression({ parens: true })`.
-     *
-     * This is purely a parse-time AST shape choice to support Less→Jess conversion.
-     *
-     * @default true
-     */
-    wrapOuterExpressions?: boolean;
-};
-export type CombinedTokenMap = Record<CssTokenType, TokenType> & Record<LessExtraTokenType, TokenType>;
-export type TokenMap = CombinedTokenMap;
-export interface ExtendTarget {
-    selector?: Selector;
-    target: Selector;
-    flag: IToken | undefined;
-}
-export type RuleContext = CssRuleContext & {
-    selector?: Selector;
-    hasDefault?: boolean;
-    /** Selectors in a selector sequence are extended */
-    allExtended?: boolean;
-    /** Mixin definition */
-    isDefinition?: boolean;
-    allowAnonymousMixins?: boolean;
-    requireAccessorsAfterMixinCall?: boolean;
-    inValueList?: boolean;
-    allowComma?: boolean;
-    /** Allow passing in the currently constructed Node */
-    node?: Node;
-    ruleIsFinished?: boolean;
-    sequences?: Array<ComplexSelector | Extend>;
-    asReference?: boolean;
-    /** For :extend(...) */
-    extendTargets?: ExtendTarget[];
-    extendNodes?: Extend[];
-    /** Inside an extend production - prevents 'all' from being consumed as selector */
-    inExtend?: boolean;
-    /** Inside a custom property value - used for deprecation warnings */
-    inCustomPropertyValue?: boolean;
-    /**
-     * When true, the current production should wrap the *outermost* parsed value
-     * (if it is a Less expression) in `Expression({ parens: true })`.
-     *
-     * This flag should only be set by value-entry productions (e.g. `valueSequence`)
-     * and must be cleared for nested parsing so Expressions never contain Expressions.
-     */
-    wrapInExpression?: boolean;
-    /**
-     * Parse-time equivalent of `Context.parenFrames`. This is a boolean stack
-     * (not a depth counter) because some productions (notably `Call`) intentionally
-     * push `false` to disable the ambient "in parens" math behavior.
-     */
-    parenFrames?: boolean[];
-    /**
-     * Parse-time equivalent of `Context.calcFrames`.
-     */
-    calcFrames?: number;
-    /**
-     * Tracks where a detached ruleset literal is parsed from so we can
-     * disambiguate Collection vs anonymous mixin semantics.
-     */
-    detachedRulesetUsage?: 'function-arg' | 'mixin-arg' | 'default-param';
-};
-/**
- * Unlike the historical Less parser, this parser
- * avoids all backtracking
- */
-export declare class LessActionsParser extends CssActionsParser {
-    T: CssTokenMap;
-    looseMode: boolean;
-    leakyRules: boolean;
-    /** Warnings collected during parsing */
-    warnings: Array<{
-        message: string;
-        token?: IToken;
-        deprecation?: string;
-    }>;
-    expressionSum: Rule;
-    expressionProduct: Rule;
-    expressionValue: Rule;
-    functionValueList: Rule;
-    ifFunction: Rule;
-    booleanFunction: Rule;
-    wrappedDeclarationList: Rule;
-    varDeclarationOrCall: Rule;
-    varName: Rule;
-    selectorCapture: Rule;
-    valueReference: Rule;
-    varReference: Rule;
-    mixinReference: Rule;
-    mixinName: Rule;
-    mixinOrQualifiedRule: Rule;
-    qualifiedRuleBody: Rule;
-    mixinArgs: Rule;
-    mixinArgList: Rule;
-    mixinArg: Rule;
-    anonymousMixinDefinition: Rule;
-    callArgument: Rule;
-    extend: Rule;
-    ampersandExtend: Rule;
-    lookupOrCall: Rule;
-    comparison: Rule;
-    guard: Rule;
-    guardDefault: Rule;
-    guardOr: Rule;
-    guardAnd: Rule;
-    guardInParens: Rule;
-    guardInner: Rule;
-    guardWithCondition: Rule;
-    guardWithConditionValue: Rule;
-    exportAtRule: Rule;
-    /** See `LessParserConfig.mathMode` */
-    mathMode: MathMode;
-    /** See `LessParserConfig.wrapOuterExpressions` */
-    wrapOuterExpressions: boolean;
-    constructor(tokenVocabulary: TokenVocabulary, T: any, config?: LessParserConfig);
-    protected processValueToken(token: IToken, ctx?: RuleContext): Reference | Node<unknown, import("core/lib/tree/node-base.js").NodeOptions>;
-    /**
-     * Emits a deprecation warning during parsing.
-     * Only collects warnings during the non-recording phase.
-     */
-    protected warnDeprecation(message: string, token?: IToken, deprecationId?: string): void;
-}