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

package/lib/grammar.d.ts

@@ -1,5 +1,8 @@
-export declare const lessGrammar: Record<string, import("parseman").FusedRule>;
-export declare const lessAstGrammar: Record<string, import("parseman").FusedRule>;
+export declare const lessGrammar: Record<string, import("parseman").Runnable>;
+/** AST artifact with Parseman line/column tracking enabled. */
+export declare const lessPositionsGrammar: Record<string, import("parseman").Runnable>;
 /** Public Less CST artifact: the same grammar factory compiled in CST mode. */
-export declare const lessCstGrammar: Record<string, import("parseman").FusedRule>;
+export declare const lessCstGrammar: Record<string, import("parseman").Runnable>;
+/** CST artifact with Parseman line/column tracking enabled. */
+export declare const lessCstPositionsGrammar: Record<string, import("parseman").Runnable>;
 //# sourceMappingURL=grammar.d.ts.map

package/lib/grammar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grammar.d.ts","sourceRoot":"","sources":["../src/grammar.ts"],"names":[],"mappings":"AAuvLA,eAAO,MAAM,WAAW,8CAAwL,CAAC;AACjN,eAAO,MAAM,cAAc,8CAAc,CAAC;AAE1C,+EAA+E;AAC/E,eAAO,MAAM,cAAc,8CAAyM,CAAC"}
+{"version":3,"file":"grammar.d.ts","sourceRoot":"","sources":["../src/grammar.ts"],"names":[],"mappings":"AA0qNA,eAAO,MAAM,WAAW,6CAA4L,CAAC;AAErN,+DAA+D;AAC/D,eAAO,MAAM,oBAAoB,6CAA8M,CAAC;AAEhP,+EAA+E;AAC/E,eAAO,MAAM,cAAc,6CAA6M,CAAC;AAEzO,+DAA+D;AAC/D,eAAO,MAAM,uBAAuB,6CAA+N,CAAC"}

package/lib/index.cjs

@@ -1,72 +1,34 @@
 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");
+const require_parse_with = require("./chunks/parse-with.cjs");
+const require_parse_error = require("./parse-error.cjs");
+let src_grammar_ast_js = require("./grammar/ast.cjs");
 //#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 directly into the canonical AST v2 document.
+*
+* Spans carry offsets only. For `startLine`/`startColumn` facts import `parse`
+* from `@jesscss/less-parser/positions` — the same function bound to the
+* line-aware compiled table. This entry never loads that table.
+*/
+function parse(input, options = {}) {
+	return require_parse_with.parseWith(src_grammar_ast_js.lessGrammar, input, options);
 }
 /**
-* 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.
+* 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: []
-		};
-	}
+function safeParse(filePath, input, options = {}) {
+	return require_parse_with.safeParseWith(src_grammar_ast_js.lessGrammar, filePath, input, options);
 }
 //#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.LessBareVariableInterpolationError = require_parse_error.LessBareVariableInterpolationError;
+exports.LessDynamicCharsetError = require_parse_error.LessDynamicCharsetError;
+exports.LessImportPostludeError = require_parse_error.LessImportPostludeError;
+exports.LessInlineJavaScriptError = require_parse_error.LessInlineJavaScriptError;
+exports.LessParseError = require_parse_error.LessParseError;
+exports.LessUnparenthesizedMixinGuardError = require_parse_error.LessUnparenthesizedMixinGuardError;
+exports.LessUnsupportedMixinNameError = require_parse_error.LessUnsupportedMixinNameError;
+exports.LessUnsupportedVariableNameError = require_parse_error.LessUnsupportedVariableNameError;
 exports.parse = parse;
 exports.safeParse = safeParse;

package/lib/index.d.ts

@@ -1,12 +1,20 @@
-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;
+import type { ISafeParseResult } from '@jesscss/core';
+import type { Stylesheet } from '@jesscss/core/ast';
+import { type LessParseOptions } from './parse-with.js';
+export type { LessParseOptions } from './parse-with.js';
+export { LessBareVariableInterpolationError, LessDynamicCharsetError, LessImportPostludeError, LessInlineJavaScriptError, LessParseError, LessUnparenthesizedMixinGuardError, LessUnsupportedMixinNameError, LessUnsupportedVariableNameError } from './parse-error.js';
 /**
- * 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.
+ * Parse Less directly into the canonical AST v2 document.
+ *
+ * Spans carry offsets only. For `startLine`/`startColumn` facts import `parse`
+ * from `@jesscss/less-parser/positions` — the same function bound to the
+ * line-aware compiled table. This entry never loads that table.
  */
-export declare function safeParse(filePath: string, input: string): ISafeParseResult;
+export declare function parse(input: string, options?: LessParseOptions): 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, options?: LessParseOptions): ISafeParseResult;
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAA4B,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAElF,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,EACL,kCAAkC,EAClC,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,cAAc,EACd,kCAAkC,EAClC,6BAA6B,EAC7B,gCAAgC,EACjC,MAAM,kBAAkB,CAAC;AAE1B;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,UAAU,CAE/E;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,gBAAqB,GAC7B,gBAAgB,CAElB"}

package/lib/index.js

@@ -1,63 +1,24 @@
-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";
+import { n as safeParseWith, t as parseWith } from "./chunks/parse-with.js";
+import { LessBareVariableInterpolationError, LessDynamicCharsetError, LessImportPostludeError, LessInlineJavaScriptError, LessParseError, LessUnparenthesizedMixinGuardError, LessUnsupportedMixinNameError, LessUnsupportedVariableNameError } from "./parse-error.js";
+import { lessGrammar } from "./grammar/ast.js";
 //#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 = 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 directly into the canonical AST v2 document.
+*
+* Spans carry offsets only. For `startLine`/`startColumn` facts import `parse`
+* from `@jesscss/less-parser/positions` — the same function bound to the
+* line-aware compiled table. This entry never loads that table.
+*/
+function parse(input, options = {}) {
+	return parseWith(lessGrammar, input, options);
 }
 /**
-* 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.
+* 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: []
-		};
-	}
+function safeParse(filePath, input, options = {}) {
+	return safeParseWith(lessGrammar, filePath, input, options);
 }
 //#endregion
-export { LessBareVariableInterpolationError, LessDynamicCharsetError, LessInlineJavaScriptError, LessParseError, LessUnparenthesizedMixinGuardError, LessUnsupportedMixinNameError, LessUnsupportedVariableNameError, parse, safeParse };
+export { LessBareVariableInterpolationError, LessDynamicCharsetError, LessImportPostludeError, LessInlineJavaScriptError, LessParseError, LessUnparenthesizedMixinGuardError, LessUnsupportedMixinNameError, LessUnsupportedVariableNameError, parse, safeParse };

package/lib/parse-error.cjs

@@ -0,0 +1,160 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/parse-error.ts
+function expectedIncludes(expected, value) {
+	return expected.has(value);
+}
+function expectedMessage(expected) {
+	if (expected.length === 0) return "Unexpected Less syntax.";
+	const expectedSet = new Set(expected);
+	if (expectedIncludes(expectedSet, "\")\"")) return "Missing closing parenthesis.";
+	if (expectedSet.size === 1) {
+		if (expectedIncludes(expectedSet, "\"]\"")) return "Missing closing bracket.";
+		if (expectedIncludes(expectedSet, "\"}\"")) return "Missing closing brace.";
+	}
+	if (expectedIncludes(expectedSet, "NumberToken") && expectedIncludes(expectedSet, "DimensionUnit") && expectedIncludes(expectedSet, "not(regex)") && (expectedIncludes(expectedSet, "ValueIdentifier") || expectedIncludes(expectedSet, "HexColor"))) return "Unexpected Less syntax. Expected a Less value.";
+	if (expectedIncludes(expectedSet, "\";\"")) return "Missing semicolon.";
+	return "Unexpected Less syntax. Expected valid Less syntax here.";
+}
+/** Structured failure from the public direct Less parser. */
+var LessParseError = class extends SyntaxError {
+	code = "parse/syntax-error";
+	offset;
+	expected;
+	line;
+	column;
+	endLine;
+	endColumn;
+	reason;
+	fix;
+	constructor(offset, expected, options = {}) {
+		super(options.message ?? expectedMessage(expected));
+		this.name = "LessParseError";
+		this.offset = offset;
+		this.expected = expected;
+		this.line = options.line;
+		this.column = options.column;
+		this.endLine = options.endLine;
+		this.endColumn = options.endColumn;
+		this.reason = options.reason;
+		this.fix = options.fix;
+	}
+};
+/** Interpolation is rejected inside the CSS @charset token. */
+var LessDynamicCharsetError = class extends SyntaxError {
+	code = "parse/dynamic-charset";
+	offset;
+	endOffset;
+	reason = "Interpolation is not valid inside the CSS @charset token.";
+	fix = "Use a static declaration such as @charset \"UTF-8\";";
+	constructor(offset, endOffset) {
+		super("Interpolation is not valid in @charset.");
+		this.name = "LessDynamicCharsetError";
+		this.offset = offset;
+		this.endOffset = endOffset;
+	}
+};
+/** Executable inline backtick JavaScript is recognized so diagnostics can be precise. */
+var LessInlineJavaScriptError = class extends SyntaxError {
+	code = "parse/unsupported-inline-javascript";
+	offset;
+	endOffset;
+	reason = "Backtick JavaScript expressions are not evaluated.";
+	fix = "Move the expression into an explicit @from/@-from script import or a plugin function.";
+	constructor(offset, endOffset) {
+		super("Inline backtick JavaScript is not supported.");
+		this.name = "LessInlineJavaScriptError";
+		this.offset = offset;
+		this.endOffset = endOffset;
+	}
+};
+/** Syntax/prelude slots require explicit @{name} interpolation. */
+var LessBareVariableInterpolationError = class extends SyntaxError {
+	code = "parse/unsupported-bare-variable-interpolation";
+	offset;
+	endOffset;
+	reason;
+	fix;
+	constructor(offset, endOffset, name) {
+		super("Bare @variable interpolation is not valid here.");
+		this.name = "LessBareVariableInterpolationError";
+		this.offset = offset;
+		this.endOffset = endOffset;
+		this.reason = "Bare @variable references are values; syntax and prelude interpolation must use @{variable}.";
+		this.fix = `Use @{${name}} instead of @${name}.`;
+	}
+};
+/** Legacy Less variable names are recognized so diagnostics can be precise. */
+var LessUnsupportedVariableNameError = class extends SyntaxError {
+	code = "parse/unsupported-variable-name";
+	offset;
+	endOffset;
+	reason = "Less variable names must not be numeric-leading or dash-only.";
+	fix;
+	constructor(offset, endOffset, name) {
+		super("This Less variable name is not supported.");
+		this.name = "LessUnsupportedVariableNameError";
+		this.offset = offset;
+		this.endOffset = endOffset;
+		this.fix = `Rename @${name} to a descriptive variable name and update its references.`;
+	}
+};
+/** Legacy dash-only mixin names are recognized so diagnostics can be precise. */
+var LessUnsupportedMixinNameError = class extends SyntaxError {
+	code = "parse/unsupported-mixin-name";
+	offset;
+	endOffset;
+	reason = "Dash-only Less mixin names are not supported.";
+	fix = "Rename the mixin to a descriptive selector-like name, for example .mixin().";
+	constructor(offset, endOffset) {
+		super("This Less mixin name is not supported.");
+		this.name = "LessUnsupportedMixinNameError";
+		this.offset = offset;
+		this.endOffset = endOffset;
+	}
+};
+/** Ungrouped Less mixin guards are recognized so diagnostics can point at the guard. */
+var LessUnparenthesizedMixinGuardError = class extends SyntaxError {
+	code = "parse/unparenthesized-mixin-guard";
+	offset;
+	endOffset;
+	reason = "Top-level Less mixin guards require each condition after when to be wrapped in parentheses.";
+	fix = "Wrap the guard condition, for example: when (default()).";
+	constructor(offset, endOffset) {
+		super("Less mixin guard conditions must be parenthesized.");
+		this.name = "LessUnparenthesizedMixinGuardError";
+		this.offset = offset;
+		this.endOffset = endOffset;
+	}
+};
+/**
+* A media/layer/supports postlude belongs to the plain CSS `@import` form only.
+*
+* Once the parser has decided an `@import` is compile-time — it carries options,
+* or its target is a loadable (non-`.css`) path — a trailing query has nothing
+* left to describe: the loaded rules are spliced into this document, not linked
+* as a separate CSS resource. This DIVERGES deliberately from Less 4.x, which
+* accepts `@import "foo.less" screen;` and wraps the loaded rules in
+* `@media screen`.
+*/
+var LessImportPostludeError = class extends SyntaxError {
+	code = "parse/import-postlude-on-compile-time-import";
+	offset;
+	endOffset;
+	reason = "A media, layer, or supports query is only valid on a plain CSS @import.";
+	fix = "Drop the query, or wrap the import in an explicit @media/@supports/@layer block.";
+	constructor(offset, endOffset) {
+		super("A compile-time @import cannot carry a media query.");
+		this.name = "LessImportPostludeError";
+		this.offset = offset;
+		this.endOffset = endOffset;
+	}
+};
+//#endregion
+exports.LessBareVariableInterpolationError = LessBareVariableInterpolationError;
+exports.LessDynamicCharsetError = LessDynamicCharsetError;
+exports.LessImportPostludeError = LessImportPostludeError;
+exports.LessInlineJavaScriptError = LessInlineJavaScriptError;
+exports.LessParseError = LessParseError;
+exports.LessUnparenthesizedMixinGuardError = LessUnparenthesizedMixinGuardError;
+exports.LessUnsupportedMixinNameError = LessUnsupportedMixinNameError;
+exports.LessUnsupportedVariableNameError = LessUnsupportedVariableNameError;

package/lib/parse-error.d.ts

@@ -3,12 +3,20 @@ export declare class LessParseError extends SyntaxError {
     readonly code: 'parse/syntax-error';
     readonly offset: number;
     readonly expected: readonly string[];
+    readonly line?: number;
+    readonly column?: number;
+    readonly endLine?: number;
+    readonly endColumn?: number;
     readonly reason?: string;
     readonly fix?: string;
     constructor(offset: number, expected: readonly string[], options?: {
         message?: string;
         reason?: string;
         fix?: string;
+        line?: number;
+        column?: number;
+        endLine?: number;
+        endColumn?: number;
     });
 }
 /** Interpolation is rejected inside the CSS @charset token. */
@@ -65,4 +73,22 @@ export declare class LessUnparenthesizedMixinGuardError extends SyntaxError {
     readonly fix = "Wrap the guard condition, for example: when (default()).";
     constructor(offset: number, endOffset: number);
 }
+/**
+ * A media/layer/supports postlude belongs to the plain CSS `@import` form only.
+ *
+ * Once the parser has decided an `@import` is compile-time — it carries options,
+ * or its target is a loadable (non-`.css`) path — a trailing query has nothing
+ * left to describe: the loaded rules are spliced into this document, not linked
+ * as a separate CSS resource. This DIVERGES deliberately from Less 4.x, which
+ * accepts `@import "foo.less" screen;` and wraps the loaded rules in
+ * `@media screen`.
+ */
+export declare class LessImportPostludeError extends SyntaxError {
+    readonly code: 'parse/import-postlude-on-compile-time-import';
+    readonly offset: number;
+    readonly endOffset: number;
+    readonly reason = "A media, layer, or supports query is only valid on a plain CSS @import.";
+    readonly fix = "Drop the query, or wrap the import in an explicit @media/@supports/@layer block.";
+    constructor(offset: number, endOffset: number);
+}
 //# sourceMappingURL=parse-error.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"parse-error.d.ts","sourceRoot":"","sources":["../src/parse-error.ts"],"names":[],"mappings":"AA0BA,6DAA6D;AAC7D,qBAAa,cAAe,SAAQ,WAAW;IAC7C,QAAQ,CAAC,IAAI,EAAG,oBAAoB,CAAU;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEtB,YACE,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAO,EASlE;CACF;AAED,+DAA+D;AAC/D,qBAAa,uBAAwB,SAAQ,WAAW;IACtD,QAAQ,CAAC,IAAI,EAAG,uBAAuB,CAAU;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,+DAA+D;IAC9E,QAAQ,CAAC,GAAG,0DAAwD;IAEpE,YAAY,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAK5C;CACF;AAED,yFAAyF;AACzF,qBAAa,yBAA0B,SAAQ,WAAW;IACxD,QAAQ,CAAC,IAAI,EAAG,qCAAqC,CAAU;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,wDAAwD;IACvE,QAAQ,CAAC,GAAG,2FAC8E;IAE1F,YAAY,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAK5C;CACF;AAED,mEAAmE;AACnE,qBAAa,kCAAmC,SAAQ,WAAW;IACjE,QAAQ,CAAC,IAAI,EAAG,+CAA+C,CAAU;IACzE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,YAAY,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAQ1D;CACF;AAED,+EAA+E;AAC/E,qBAAa,gCAAiC,SAAQ,WAAW;IAC/D,QAAQ,CAAC,IAAI,EAAG,iCAAiC,CAAU;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,mEAAmE;IAClF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,YAAY,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAM1D;CACF;AAED,iFAAiF;AACjF,qBAAa,6BAA8B,SAAQ,WAAW;IAC5D,QAAQ,CAAC,IAAI,EAAG,8BAA8B,CAAU;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,mDAAmD;IAClE,QAAQ,CAAC,GAAG,iFAAiF;IAE7F,YAAY,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAK5C;CACF;AAED,wFAAwF;AACxF,qBAAa,kCAAmC,SAAQ,WAAW;IACjE,QAAQ,CAAC,IAAI,EAAG,mCAAmC,CAAU;IAC7D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,iGAAiG;IAChH,QAAQ,CAAC,GAAG,8DAA8D;IAE1E,YAAY,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAK5C;CACF"}
+{"version":3,"file":"parse-error.d.ts","sourceRoot":"","sources":["../src/parse-error.ts"],"names":[],"mappings":"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"}

package/lib/parse-error.js

@@ -0,0 +1,152 @@
+//#region src/parse-error.ts
+function expectedIncludes(expected, value) {
+	return expected.has(value);
+}
+function expectedMessage(expected) {
+	if (expected.length === 0) return "Unexpected Less syntax.";
+	const expectedSet = new Set(expected);
+	if (expectedIncludes(expectedSet, "\")\"")) return "Missing closing parenthesis.";
+	if (expectedSet.size === 1) {
+		if (expectedIncludes(expectedSet, "\"]\"")) return "Missing closing bracket.";
+		if (expectedIncludes(expectedSet, "\"}\"")) return "Missing closing brace.";
+	}
+	if (expectedIncludes(expectedSet, "NumberToken") && expectedIncludes(expectedSet, "DimensionUnit") && expectedIncludes(expectedSet, "not(regex)") && (expectedIncludes(expectedSet, "ValueIdentifier") || expectedIncludes(expectedSet, "HexColor"))) return "Unexpected Less syntax. Expected a Less value.";
+	if (expectedIncludes(expectedSet, "\";\"")) return "Missing semicolon.";
+	return "Unexpected Less syntax. Expected valid Less syntax here.";
+}
+/** Structured failure from the public direct Less parser. */
+var LessParseError = class extends SyntaxError {
+	code = "parse/syntax-error";
+	offset;
+	expected;
+	line;
+	column;
+	endLine;
+	endColumn;
+	reason;
+	fix;
+	constructor(offset, expected, options = {}) {
+		super(options.message ?? expectedMessage(expected));
+		this.name = "LessParseError";
+		this.offset = offset;
+		this.expected = expected;
+		this.line = options.line;
+		this.column = options.column;
+		this.endLine = options.endLine;
+		this.endColumn = options.endColumn;
+		this.reason = options.reason;
+		this.fix = options.fix;
+	}
+};
+/** Interpolation is rejected inside the CSS @charset token. */
+var LessDynamicCharsetError = class extends SyntaxError {
+	code = "parse/dynamic-charset";
+	offset;
+	endOffset;
+	reason = "Interpolation is not valid inside the CSS @charset token.";
+	fix = "Use a static declaration such as @charset \"UTF-8\";";
+	constructor(offset, endOffset) {
+		super("Interpolation is not valid in @charset.");
+		this.name = "LessDynamicCharsetError";
+		this.offset = offset;
+		this.endOffset = endOffset;
+	}
+};
+/** Executable inline backtick JavaScript is recognized so diagnostics can be precise. */
+var LessInlineJavaScriptError = class extends SyntaxError {
+	code = "parse/unsupported-inline-javascript";
+	offset;
+	endOffset;
+	reason = "Backtick JavaScript expressions are not evaluated.";
+	fix = "Move the expression into an explicit @from/@-from script import or a plugin function.";
+	constructor(offset, endOffset) {
+		super("Inline backtick JavaScript is not supported.");
+		this.name = "LessInlineJavaScriptError";
+		this.offset = offset;
+		this.endOffset = endOffset;
+	}
+};
+/** Syntax/prelude slots require explicit @{name} interpolation. */
+var LessBareVariableInterpolationError = class extends SyntaxError {
+	code = "parse/unsupported-bare-variable-interpolation";
+	offset;
+	endOffset;
+	reason;
+	fix;
+	constructor(offset, endOffset, name) {
+		super("Bare @variable interpolation is not valid here.");
+		this.name = "LessBareVariableInterpolationError";
+		this.offset = offset;
+		this.endOffset = endOffset;
+		this.reason = "Bare @variable references are values; syntax and prelude interpolation must use @{variable}.";
+		this.fix = `Use @{${name}} instead of @${name}.`;
+	}
+};
+/** Legacy Less variable names are recognized so diagnostics can be precise. */
+var LessUnsupportedVariableNameError = class extends SyntaxError {
+	code = "parse/unsupported-variable-name";
+	offset;
+	endOffset;
+	reason = "Less variable names must not be numeric-leading or dash-only.";
+	fix;
+	constructor(offset, endOffset, name) {
+		super("This Less variable name is not supported.");
+		this.name = "LessUnsupportedVariableNameError";
+		this.offset = offset;
+		this.endOffset = endOffset;
+		this.fix = `Rename @${name} to a descriptive variable name and update its references.`;
+	}
+};
+/** Legacy dash-only mixin names are recognized so diagnostics can be precise. */
+var LessUnsupportedMixinNameError = class extends SyntaxError {
+	code = "parse/unsupported-mixin-name";
+	offset;
+	endOffset;
+	reason = "Dash-only Less mixin names are not supported.";
+	fix = "Rename the mixin to a descriptive selector-like name, for example .mixin().";
+	constructor(offset, endOffset) {
+		super("This Less mixin name is not supported.");
+		this.name = "LessUnsupportedMixinNameError";
+		this.offset = offset;
+		this.endOffset = endOffset;
+	}
+};
+/** Ungrouped Less mixin guards are recognized so diagnostics can point at the guard. */
+var LessUnparenthesizedMixinGuardError = class extends SyntaxError {
+	code = "parse/unparenthesized-mixin-guard";
+	offset;
+	endOffset;
+	reason = "Top-level Less mixin guards require each condition after when to be wrapped in parentheses.";
+	fix = "Wrap the guard condition, for example: when (default()).";
+	constructor(offset, endOffset) {
+		super("Less mixin guard conditions must be parenthesized.");
+		this.name = "LessUnparenthesizedMixinGuardError";
+		this.offset = offset;
+		this.endOffset = endOffset;
+	}
+};
+/**
+* A media/layer/supports postlude belongs to the plain CSS `@import` form only.
+*
+* Once the parser has decided an `@import` is compile-time — it carries options,
+* or its target is a loadable (non-`.css`) path — a trailing query has nothing
+* left to describe: the loaded rules are spliced into this document, not linked
+* as a separate CSS resource. This DIVERGES deliberately from Less 4.x, which
+* accepts `@import "foo.less" screen;` and wraps the loaded rules in
+* `@media screen`.
+*/
+var LessImportPostludeError = class extends SyntaxError {
+	code = "parse/import-postlude-on-compile-time-import";
+	offset;
+	endOffset;
+	reason = "A media, layer, or supports query is only valid on a plain CSS @import.";
+	fix = "Drop the query, or wrap the import in an explicit @media/@supports/@layer block.";
+	constructor(offset, endOffset) {
+		super("A compile-time @import cannot carry a media query.");
+		this.name = "LessImportPostludeError";
+		this.offset = offset;
+		this.endOffset = endOffset;
+	}
+};
+//#endregion
+export { LessBareVariableInterpolationError, LessDynamicCharsetError, LessImportPostludeError, LessInlineJavaScriptError, LessParseError, LessUnparenthesizedMixinGuardError, LessUnsupportedMixinNameError, LessUnsupportedVariableNameError };

package/lib/parse-state.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The parseman `ctx.state` the Less grammar reads, and its one validator.
+ *
+ * It lives in its own module because BOTH ends need it and neither may import
+ * the other: `parse-with.ts` constructs the state and names the compiled grammar
+ * table only as a type, while `grammar.ts` consumes it inside reducers. A shared
+ * third module keeps that a straight line rather than a cycle.
+ */
+import type { MathMode } from '@jesscss/core';
+export interface LessParseState {
+    /**
+     * The input text, the trivia machinery's back-reference for slicing.
+     *
+     * OPTIONAL, because the grammar already treats it so — `sourceFromState`
+     * returns `undefined` when it is absent and the trivia helpers fall back to
+     * structural layout. A caller that only wants grammar facts (the AST-grammar
+     * tests drive `run()` directly) may omit it. `mathMode` remains required on
+     * this resolved internal shape; raw callers are normalized by
+     * `requireLessParseState` below.
+     */
+    readonly source?: string;
+    /**
+     * Less's `math:` policy, a PARSE-TIME input (ledger P1). The grammar resolves
+     * it per operation and writes the answer onto `Operation.mathOutsideParens`;
+     * the evaluator never sees the mode.
+     */
+    readonly mathMode: MathMode;
+}
+/** The public Less default, shared by wrapper and raw-grammar entry points. */
+export declare const DEFAULT_LESS_MATH_MODE: MathMode;
+/**
+ * Recover the typed state parseman hands reducers as `unknown`.
+ *
+ * Missing state uses the same public default as `parseWith`, so the exported
+ * AST/CST grammars remain directly runnable. An explicitly supplied invalid
+ * mode still throws instead of hiding a broken threading path.
+ */
+export declare function requireLessParseState(state: unknown): LessParseState;
+//# sourceMappingURL=parse-state.d.ts.map