@jesscss/jess-parser 2.0.0-alpha.11 → 2.0.0-alpha.13

package/lib/index.d.ts

@@ -1,13 +1,13 @@
-export { jessGrammar } from './grammar.js';
-export { parseJessCst, parseJessDoc } from './cst.js';
 export type { JessCstChild, JessCstError, JessCstLeaf, JessCstNode, JessCstParseResult, JessCstType } from './cst.js';
-import { type Stylesheet } from '@jesscss/core/ast';
-/** Structured failure from the public direct Jess parser. */
-export declare class JessParseError extends SyntaxError {
-    readonly code: 'parse/syntax-error';
-    readonly offset: number;
-    readonly expected: readonly string[];
-    constructor(offset: number, expected: readonly string[]);
-}
-/** Parse Jess directly into the canonical AST v2 document. */
-export declare function parse(input: string): Stylesheet;
+import type { Stylesheet } from '@jesscss/core/ast';
+import { type JessParseOptions } from './parse-with.js';
+export type { JessParseOptions } from './parse-with.js';
+export { JessParseError } from './parse-error.js';
+/**
+ * Parse Jess directly into the canonical AST v2 document.
+ *
+ * Spans carry offsets only. For `startLine`/`startColumn` facts import `parse`
+ * from `@jesscss/jess-parser/positions` — the same function bound to the
+ * line-aware compiled table. This entry never loads that table.
+ */
+export declare function parse(input: string, options?: JessParseOptions): Stylesheet;

package/lib/index.js

@@ -1,36 +1,15 @@
-import { jessAstGrammar, jessGrammar } from "./grammar.js";
-import { parseJessCst, parseJessDoc } from "./cst.js";
-import { createTriviaMapFromParseman, withSourceSpan, withTriviaMap } from "@jesscss/core/ast";
-import { run } from "parseman";
+import { n as JessParseError, t as parseWith } from "./chunks/parse-with.js";
+import { jessGrammar } from "./grammar/ast.js";
 //#region src/index.ts
-/** Structured failure from the public direct Jess parser. */
-var JessParseError = class extends SyntaxError {
-	code = "parse/syntax-error";
-	offset;
-	expected;
-	constructor(offset, expected) {
-		const detail = expected.length > 0 ? ` Expected: ${expected.join(", ")}.` : "";
-		super(`Jess parser error.${detail}`);
-		this.name = "JessParseError";
-		this.offset = offset;
-		this.expected = expected;
-	}
-};
-function isStylesheet(value) {
-	return typeof value === "object" && value !== null && "type" in value && value.type === "Stylesheet" && "children" in value && Array.isArray(value.children);
-}
-/** Parse Jess directly into the canonical AST v2 document. */
-function parse(input) {
-	const entry = jessAstGrammar.Stylesheet;
-	const trivia = jessAstGrammar.whitespace;
-	if (entry === void 0 || trivia === void 0) throw new TypeError("Jess AST grammar is missing its public document entry.");
-	const result = run(entry, input, { trivia });
-	if (!result.ok || result.unconsumedFrom !== null || !isStylesheet(result.value)) {
-		const offset = result.ok ? result.unconsumedFrom ?? result.span.end : result.span.start;
-		const expected = result.expected;
-		throw new JessParseError(offset, expected);
-	}
-	return withTriviaMap(withSourceSpan(result.value, result.span), createTriviaMapFromParseman(input, result.triviaMap));
+/**
+* Parse Jess directly into the canonical AST v2 document.
+*
+* Spans carry offsets only. For `startLine`/`startColumn` facts import `parse`
+* from `@jesscss/jess-parser/positions` — the same function bound to the
+* line-aware compiled table. This entry never loads that table.
+*/
+function parse(input, options = {}) {
+	return parseWith(jessGrammar, input, options);
 }
 //#endregion
-export { JessParseError, jessGrammar, parse, parseJessCst, parseJessDoc };
+export { JessParseError, parse };

package/lib/parse-error.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The public Jess parse failure lives in its own module so that both AST
+ * entries — `.` and `./positions` — can export it without either one reaching
+ * the other's compiled grammar table. A class declared in an entry cannot be
+ * re-exported by a sibling entry without dragging that entry's imports along.
+ */
+/** Structured failure from the public direct Jess parser. */
+export declare class JessParseError 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;
+    });
+}

package/lib/parse-with.d.ts

@@ -0,0 +1,14 @@
+import { type Stylesheet } from '@jesscss/core/ast';
+import type { ApplySelectorKind, ExtendSelectorKind } from '@jesscss/core';
+import type { jessGrammar } from './grammar/ast.js';
+/** The rule map both compiled Jess AST variants expose. */
+export type JessAstGrammar = typeof jessGrammar;
+export interface JessParseOptions {
+    readonly allowExtendSelectors?: readonly ExtendSelectorKind[];
+    /**
+     * Selector kinds accepted by `$apply`. Jess treats `$apply` as a utility-class
+     * composition feature by default, so unset means class selectors only.
+     */
+    readonly allowApplySelectors?: readonly ApplySelectorKind[];
+}
+export declare function parseWith(grammar: JessAstGrammar, input: string, options?: JessParseOptions): Stylesheet;

package/lib/positions.cjs

@@ -0,0 +1,11 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_parse_with = require("./chunks/parse-with.cjs");
+let src_grammar_ast_positions_js = require("./grammar/ast/positions.cjs");
+//#region src/positions.ts
+/** Parse Jess into the canonical AST v2 document with line/column facts. */
+function parse(input, options = {}) {
+	return require_parse_with.parseWith(src_grammar_ast_positions_js.jessPositionsGrammar, input, options);
+}
+//#endregion
+exports.JessParseError = require_parse_with.JessParseError;
+exports.parse = parse;

package/lib/positions.js

@@ -0,0 +1,9 @@
+import { n as JessParseError, t as parseWith } from "./chunks/parse-with.js";
+import { jessPositionsGrammar } from "./grammar/ast/positions.js";
+//#region src/positions.ts
+/** Parse Jess into the canonical AST v2 document with line/column facts. */
+function parse(input, options = {}) {
+	return parseWith(jessPositionsGrammar, input, options);
+}
+//#endregion
+export { JessParseError, parse };

package/lib/trivia-labels.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Root-trivia label selection for the Jess grammar.
+ *
+ * This is a plain fact about the grammar's trivia arm labels, so it lives in a
+ * leaf module with no imports. Reading it from the CST entry instead would make
+ * every consumer of the package entry load the compiled CST grammar tables:
+ * Node's ESM loader does not tree-shake, so an unused named import still
+ * executes the module it is taken from, and each table is multiple megabytes.
+ */
+export declare const commentTriviaLabels: readonly ['comment'];

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "2.0.0-alpha.11",
+  "version": "2.0.0-alpha.13",
   "engines": {
     "node": "^20.19.0 || >=22.12.0"
   },
@@ -16,15 +16,45 @@
       "import": "./lib/index.js",
       "require": "./lib/index.cjs"
     },
+    "./positions": {
+      "types": "./lib/positions.d.ts",
+      "import": "./lib/positions.js",
+      "require": "./lib/positions.cjs"
+    },
     "./cst": {
       "types": "./lib/cst.d.ts",
       "import": "./lib/cst.js",
       "require": "./lib/cst.cjs"
     },
+    "./cst/positions": {
+      "types": "./lib/cst/positions.d.ts",
+      "import": "./lib/cst/positions.js",
+      "require": "./lib/cst/positions.cjs"
+    },
     "./grammar": {
-      "types": "./lib/grammar.d.ts",
-      "import": "./lib/grammar.js",
-      "require": "./lib/grammar.cjs"
+      "types": "./lib/grammar/ast.d.ts",
+      "import": "./lib/grammar/ast.js",
+      "require": "./lib/grammar/ast.cjs"
+    },
+    "./grammar/ast": {
+      "types": "./lib/grammar/ast.d.ts",
+      "import": "./lib/grammar/ast.js",
+      "require": "./lib/grammar/ast.cjs"
+    },
+    "./grammar/ast/positions": {
+      "types": "./lib/grammar/ast/positions.d.ts",
+      "import": "./lib/grammar/ast/positions.js",
+      "require": "./lib/grammar/ast/positions.cjs"
+    },
+    "./grammar/cst": {
+      "types": "./lib/grammar/cst.d.ts",
+      "import": "./lib/grammar/cst.js",
+      "require": "./lib/grammar/cst.cjs"
+    },
+    "./grammar/cst/positions": {
+      "types": "./lib/grammar/cst/positions.d.ts",
+      "import": "./lib/grammar/cst/positions.js",
+      "require": "./lib/grammar/cst/positions.cjs"
     },
     "./package.json": "./package.json"
   },
@@ -35,11 +65,11 @@
   "license": "MIT",
   "dependencies": {
     "color-name": "~2.0.0",
-    "@jesscss/css-parser": "2.0.0-alpha.11"
+    "@jesscss/css-parser": "2.0.0-alpha.13"
   },
   "peerDependencies": {
-    "parseman": "^0.41.0",
-    "@jesscss/core": "2.0.0-alpha.11"
+    "parseman": "^0.50.5",
+    "@jesscss/core": "2.0.0-alpha.13"
   },
   "peerDependenciesMeta": {
     "@jesscss/core": {
@@ -48,9 +78,9 @@
   },
   "devDependencies": {
     "@types/color-name": "^1.1.1",
-    "parseman": "^0.41.0",
-    "@jesscss/parser-shared": "0.0.0",
-    "@jesscss/core": "2.0.0-alpha.11"
+    "parseman": "^0.50.5",
+    "@jesscss/core": "2.0.0-alpha.13",
+    "@jesscss/parser-shared": "2.0.0-alpha.13"
   },
   "type": "module",
   "module": "lib/index.js",
@@ -58,7 +88,7 @@
     "ci": "pnpm build && pnpm test",
     "build": "pnpm --filter @jesscss/parser-shared build && pnpm clean && pnpm compile",
     "clean": "shx rm -rf ./lib tsconfig.tsbuildinfo",
-    "compile": "tsdown --tsconfig tsconfig.build.json --no-dts && tsc -p tsconfig.build.json --emitDeclarationOnly --noCheck",
+    "compile": "node -e \"require('node:fs').rmSync('lib',{recursive:true,force:true})\" && tsdown --tsconfig tsconfig.build.json --no-dts && tsc -p tsconfig.build.json --emitDeclarationOnly --noCheck",
     "test": "vitest --run --passWithNoTests",
     "lint:fix": "eslint --fix '**/*.{js,ts}'",
     "lint": "eslint '**/*.{js,ts}'"