@jesscss/scss-parser 2.0.0-alpha.10 → 2.0.0-alpha.12

package/lib/grammar.d.ts

@@ -1,336 +1,6 @@
-import type { Combinator, FusedRule } from 'parseman';
-import { cssSyntax } from '@jesscss/parser-shared/recognition';
-import { cssPseudoSyntax } from '@jesscss/parser-shared/pseudo-consts';
-import { opaqueAtRuleRecognition } from '@jesscss/parser-shared/opaque-at-rule';
-import type { AtRuleBlock, AtRuleStatement, Collection, Color, Comment, ComplexSelector, CompoundSelector, Declaration, Dimension, ExtendInstruction, For, ForBinding, FunctionCall, GeneralEnclosed, GuardNode, If, ImportAtRule, Interpolation, Keyword, MixinCall, MixinDef, ModuleImport, OpaqueAtRuleBlock, Param, Quoted, Stylesheet, Rule, SelectorList, SimpleSelector, SimpleToken, Statement, StyleImport, Url, ValueNode, ValueSlot, VariableDeclaration, VariableReference } from '@jesscss/core/ast';
-type Token = {
-    readonly value: string;
-};
-type ScssValuePair = {
-    readonly separator: string;
-    readonly value: ValueSlot;
-};
-type ScssCallArg = {
-    readonly value: ValueSlot;
-    readonly name?: string;
-    readonly spread?: boolean;
-};
-type ScssComplexTail = {
-    readonly comb: ' ' | '>' | '+' | '~' | '||';
-    readonly compound: CompoundSelector;
-};
-type ScssRules = {
-    Stylesheet: Combinator<Stylesheet>;
-    ScssAstDocument: Combinator<Stylesheet>;
-    VariableDeclaration: Combinator<VariableDeclaration>;
-    DirectScssComment: Combinator<Comment>;
-    DirectScssVarReference: Combinator<VariableReference>;
-    SassInterpolation: Combinator<Interpolation>;
-    DirectScssQuoted: Combinator<Quoted | Interpolation>;
-    DirectScssStaticQuoted: Combinator<Quoted>;
-    DirectScssKeyword: Combinator<Keyword>;
-    DirectScssCustomPropertyValue: Combinator<Keyword>;
-    DirectScssColor: Combinator<Color>;
-    DirectScssUnicodeRange: Combinator<ValueNode>;
-    DirectScssDimension: Combinator<Dimension>;
-    DirectScssInterpolatedUrlValue: Combinator<Interpolation>;
-    DirectScssInterpolatedValue: Combinator<Interpolation>;
-    DirectScssParen: Combinator<ValueNode>;
-    DirectScssMapEntry: Combinator<Declaration>;
-    DirectScssMap: Combinator<Collection>;
-    DirectScssReturn: Combinator<Declaration>;
-    DirectScssFunction: Combinator<VariableDeclaration>;
-    DirectScssSquare: Combinator<ValueNode>;
-    ScssValueAtom: Combinator<ValueNode>;
-    DirectScssMathUnary: Combinator<ValueNode>;
-    DirectScssMathProduct: Combinator<ValueNode>;
-    DirectScssMathSum: Combinator<ValueNode>;
-    DirectScssMathTopProduct: Combinator<ValueNode>;
-    DirectScssMathTopSum: Combinator<ValueNode>;
-    DirectScssValueTerm: Combinator<ValueSlot>;
-    DirectScssValuePair: Combinator<ScssValuePair>;
-    DirectScssValue: Combinator<ValueSlot>;
-    DirectScssImportant: Combinator<true>;
-    DirectScssInterpolatedProperty: Combinator<Interpolation>;
-    DirectScssCustomPropertyName: Combinator<string | Interpolation>;
-    DirectScssCustomPart: Combinator<unknown>;
-    DirectScssCustomInnerPart: Combinator<unknown>;
-    DirectScssCustomParen: Combinator<readonly unknown[]>;
-    DirectScssCustomSquare: Combinator<readonly unknown[]>;
-    DirectScssCustomCurly: Combinator<readonly unknown[]>;
-    DirectScssCustomValue: Combinator<ValueNode>;
-    DirectScssCustomDeclaration: Combinator<Declaration>;
-    DirectScssDeclaration: Combinator<Declaration>;
-    DirectScssStaticNestedPropertyLeaf: Combinator<Declaration>;
-    DirectScssStaticNestedProperty: Combinator<Declaration>;
-    ScssImport: Combinator<ImportAtRule>;
-    DirectScssUseAs: Combinator<string>;
-    DirectScssUse: Combinator<StyleImport | ModuleImport>;
-    DirectScssForward: Combinator<StyleImport>;
-    DirectScssStaticImportUrl: Combinator<Url>;
-    DirectScssStaticImportLayer: Combinator<ValueNode>;
-    DirectScssStaticImportDeclaration: Combinator<ValueNode>;
-    DirectScssStaticImportSupports: Combinator<FunctionCall>;
-    DirectScssStaticImportQualifier: Combinator<ValueNode>;
-    DirectScssStaticImportMediaFeature: Combinator<ValueNode>;
-    DirectScssStaticImportMediaInParens: Combinator<ValueNode>;
-    DirectScssStaticImportMediaCondition: Combinator<ValueNode>;
-    DirectScssStaticImportMediaOnlyClause: Combinator<ValueNode>;
-    DirectScssStaticImportMediaClause: Combinator<ValueNode>;
-    DirectScssStaticImportMediaPrelude: Combinator<ValueNode>;
-    DirectScssStaticImportTail: Combinator<ValueNode>;
-    DirectScssMixinParam: Combinator<Param>;
-    DirectScssMixinParams: Combinator<Param[]>;
-    ScssMixinCallArg: Combinator<ScssCallArg>;
-    DirectScssMixinCall: Combinator<MixinCall>;
-    DirectScssMixinDef: Combinator<MixinDef>;
-    DirectScssEachName: Combinator<string>;
-    DirectScssEachBinding: Combinator<ForBinding>;
-    DirectScssEach: Combinator<For>;
-    DirectScssFor: Combinator<For>;
-    DirectScssIfCondition: Combinator<GuardNode>;
-    DirectScssIfAnd: Combinator<GuardNode>;
-    DirectScssIfTerm: Combinator<GuardNode>;
-    DirectScssIfAtom: Combinator<GuardNode>;
-    DirectScssIfComparison: Combinator<GuardNode>;
-    DirectScssIfBody: Combinator<Statement[]>;
-    DirectScssIfStaticRule: Combinator<Rule>;
-    DirectScssIfStaticConditionalBlock: Combinator<AtRuleBlock>;
-    DirectScssIf: Combinator<If>;
-    DirectScssQueryFeature: Combinator<ValueNode>;
-    DirectScssQueryFunction: Combinator<FunctionCall>;
-    DirectScssQueryInParens: Combinator<ValueNode>;
-    DirectScssQueryCondition: Combinator<ValueNode>;
-    DirectScssQueryClause: Combinator<ValueNode>;
-    DirectScssQueryPreludeTail: Combinator<ValueNode>;
-    DirectScssQueryPrelude: Combinator<ValueNode>;
-    DirectScssSupportsAtom: Combinator<ValueNode>;
-    DirectScssGeneralTemplate: Combinator<Interpolation>;
-    DirectScssGeneralTemplateParen: Combinator<Interpolation>;
-    DirectScssGeneralTemplateSquare: Combinator<Interpolation>;
-    DirectScssGeneralTemplateBrace: Combinator<Interpolation>;
-    DirectScssGeneralTemplateDoubleQuoted: Combinator<Interpolation>;
-    DirectScssGeneralTemplateSingleQuoted: Combinator<Interpolation>;
-    DirectScssGeneralEnclosed: Combinator<GeneralEnclosed>;
-    DirectScssSupportsFeature: Combinator<ValueNode>;
-    DirectScssSupportsInParens: Combinator<ValueNode>;
-    DirectScssSupportsNot: Combinator<Keyword>;
-    DirectScssSupportsAndOr: Combinator<Keyword>;
-    DirectScssSupportsCondition: Combinator<ValueNode>;
-    DirectScssSupportsPrelude: Combinator<ValueNode>;
-    DirectScssStaticMediaPrelude: Combinator<ValueNode>;
-    /** Static-only generic CSS header capture for known passthrough blocks. */
-    DirectScssStaticAtPrelude: Combinator<ValueNode | null>;
-    DirectScssStaticAtPreludeAtom: Combinator<Token>;
-    DirectScssStaticAtPreludeParen: Combinator<Token>;
-    DirectScssStaticAtPreludeSquare: Combinator<Token>;
-    DirectScssStaticAtPreludeDoubleQuoted: Combinator<Token>;
-    DirectScssStaticAtPreludeSingleQuoted: Combinator<Token>;
-    DirectScssAtRuleStatement: Combinator<AtRuleStatement>;
-    DirectScssScopeBlock: Combinator<AtRuleBlock>;
-    DirectScssNestedScopeBlock: Combinator<AtRuleBlock>;
-    DirectScssConditionalBlock: Combinator<AtRuleBlock>;
-    DirectScssStartingStyleBlock: Combinator<AtRuleBlock>;
-    DirectScssLayerBlock: Combinator<AtRuleBlock>;
-    /** Static `@document` / `@-moz-document` with a frame-one stylesheet body. */
-    DirectScssDocumentBlock: Combinator<AtRuleBlock>;
-    DirectScssPageMarginBox: Combinator<AtRuleBlock>;
-    DirectScssPageBlock: Combinator<AtRuleBlock>;
-    DirectScssFontFeatureValueBlock: Combinator<AtRuleBlock>;
-    DirectScssFontFeatureValuesBlock: Combinator<AtRuleBlock>;
-    DirectScssFontFace: Combinator<AtRuleBlock>;
-    DirectScssCounterStyle: Combinator<AtRuleBlock>;
-    DirectScssPropertyName: Combinator<Keyword>;
-    DirectScssPropertyAtRule: Combinator<AtRuleBlock>;
-    DirectScssKeyframeSelector: Combinator<SimpleSelector>;
-    DirectScssKeyframeBlock: Combinator<Rule>;
-    DirectScssKeyframes: Combinator<AtRuleBlock>;
-    DirectScssNestedConditionalBlock: Combinator<AtRuleBlock>;
-    DirectScssNestedStartingStyleBlock: Combinator<AtRuleBlock>;
-    DirectScssNestedLayerBlock: Combinator<AtRuleBlock>;
-    DirectScssSimple: Combinator<SimpleSelector>;
-    DirectScssInterpolatedSimple: Combinator<SimpleSelector>;
-    DirectScssPlaceholder: Combinator<SimpleSelector>;
-    DirectScssAttribute: Combinator<SimpleSelector>;
-    DirectScssPseudoArgument: Combinator<string>;
-    DirectScssStaticSelectorPseudoArgument: Combinator<string>;
-    DirectScssStaticSelectorPseudoItem: Combinator<string>;
-    DirectScssStaticSelectorPseudoTail: Combinator<string>;
-    DirectScssStaticPseudoArgument: Combinator<string>;
-    DirectScssStaticPseudoGroup: Combinator<string>;
-    DirectScssStaticPseudoSquare: Combinator<string>;
-    DirectScssPseudo: Combinator<SimpleToken>;
-    DirectScssNestingSelector: Combinator<SimpleSelector>;
-    DirectScssCompound: Combinator<CompoundSelector>;
-    DirectScssComplexTail: Combinator<ScssComplexTail>;
-    DirectScssComplex: Combinator<ComplexSelector>;
-    DirectScssSelectorTail: Combinator<ComplexSelector>;
-    DirectScssSelector: Combinator<SelectorList>;
-    DirectScssExtend: Combinator<ExtendInstruction>;
-    DirectScssOpaquePrelude: Combinator<string | null>;
-    DirectScssOpaqueBody: Combinator<string>;
-    DirectScssOpaqueAtRuleBlock: Combinator<OpaqueAtRuleBlock>;
-    DirectScssOpaqueAtRuleStatement: Combinator<AtRuleStatement>;
-    DirectScssRule: Combinator<Rule>;
-    rw: Combinator<unknown>;
-    whitespace: Combinator<unknown>;
-};
-type ScssInputRules = ScssRules & typeof cssSyntax & typeof cssPseudoSyntax & typeof opaqueAtRuleRecognition;
-export declare const scssFactory: (g: ScssInputRules) => {
-    Stylesheet: Combinator<Stylesheet>;
-    ScssAstDocument: Combinator<Stylesheet>;
-    VariableDeclaration: Combinator<VariableDeclaration>;
-    DirectScssComment: Combinator<Comment>;
-    DirectScssVarReference: Combinator<VariableReference>;
-    SassInterpolation: Combinator<Interpolation>;
-    DirectScssQuoted: Combinator<Interpolation | Quoted>;
-    DirectScssStaticQuoted: Combinator<Quoted>;
-    DirectScssKeyword: Combinator<Keyword>;
-    DirectScssCustomPropertyValue: Combinator<Keyword>;
-    DirectScssColor: Combinator<Color>;
-    DirectScssUnicodeRange: Combinator<ValueNode>;
-    DirectScssDimension: Combinator<Dimension>;
-    DirectScssInterpolatedUrlValue: Combinator<Interpolation>;
-    DirectScssInterpolatedValue: Combinator<Interpolation>;
-    DirectScssParen: Combinator<ValueNode>;
-    DirectScssMapEntry: Combinator<Declaration>;
-    DirectScssMap: Combinator<Collection>;
-    DirectScssReturn: Combinator<Declaration>;
-    DirectScssFunction: Combinator<VariableDeclaration>;
-    DirectScssSquare: Combinator<ValueNode>;
-    ScssValueAtom: Combinator<ValueNode>;
-    DirectScssMathUnary: Combinator<ValueNode>;
-    DirectScssMathProduct: Combinator<ValueNode>;
-    DirectScssMathSum: Combinator<ValueNode>;
-    DirectScssMathTopProduct: Combinator<ValueNode>;
-    DirectScssMathTopSum: Combinator<ValueNode>;
-    DirectScssValueTerm: Combinator<ValueSlot>;
-    DirectScssValuePair: Combinator<ScssValuePair>;
-    DirectScssValue: Combinator<ValueSlot>;
-    DirectScssImportant: Combinator<true>;
-    DirectScssInterpolatedProperty: Combinator<Interpolation>;
-    DirectScssCustomPropertyName: Combinator<string | Interpolation>;
-    DirectScssCustomPart: Combinator<unknown>;
-    DirectScssCustomInnerPart: Combinator<unknown>;
-    DirectScssCustomParen: Combinator<readonly unknown[]>;
-    DirectScssCustomSquare: Combinator<readonly unknown[]>;
-    DirectScssCustomCurly: Combinator<readonly unknown[]>;
-    DirectScssCustomValue: Combinator<ValueNode>;
-    DirectScssCustomDeclaration: Combinator<Declaration>;
-    DirectScssDeclaration: Combinator<Declaration>;
-    DirectScssStaticNestedPropertyLeaf: Combinator<Declaration>;
-    DirectScssStaticNestedProperty: Combinator<Declaration>;
-    ScssImport: Combinator<ImportAtRule>;
-    DirectScssUseAs: Combinator<string>;
-    DirectScssUse: Combinator<ModuleImport | StyleImport>;
-    DirectScssForward: Combinator<StyleImport>;
-    DirectScssStaticImportUrl: Combinator<Url>;
-    DirectScssStaticImportLayer: Combinator<ValueNode>;
-    DirectScssStaticImportDeclaration: Combinator<ValueNode>;
-    DirectScssStaticImportSupports: Combinator<FunctionCall>;
-    DirectScssStaticImportQualifier: Combinator<ValueNode>;
-    DirectScssStaticImportMediaFeature: Combinator<ValueNode>;
-    DirectScssStaticImportMediaInParens: Combinator<ValueNode>;
-    DirectScssStaticImportMediaCondition: Combinator<ValueNode>;
-    DirectScssStaticImportMediaOnlyClause: Combinator<ValueNode>;
-    DirectScssStaticImportMediaClause: Combinator<ValueNode>;
-    DirectScssStaticImportMediaPrelude: Combinator<ValueNode>;
-    DirectScssStaticImportTail: Combinator<ValueNode>;
-    DirectScssMixinParam: Combinator<Param>;
-    DirectScssMixinParams: Combinator<Param[]>;
-    ScssMixinCallArg: Combinator<ScssCallArg>;
-    DirectScssMixinCall: Combinator<MixinCall>;
-    DirectScssMixinDef: Combinator<MixinDef>;
-    DirectScssEachName: Combinator<string>;
-    DirectScssEachBinding: Combinator<ForBinding>;
-    DirectScssEach: Combinator<For>;
-    DirectScssFor: Combinator<For>;
-    DirectScssIfCondition: Combinator<GuardNode>;
-    DirectScssIfAnd: Combinator<GuardNode>;
-    DirectScssIfTerm: Combinator<GuardNode>;
-    DirectScssIfAtom: Combinator<GuardNode>;
-    DirectScssIfComparison: Combinator<GuardNode>;
-    DirectScssIfBody: Combinator<Statement[]>;
-    DirectScssIfStaticRule: Combinator<Rule>;
-    DirectScssIfStaticConditionalBlock: Combinator<AtRuleBlock>;
-    DirectScssIf: Combinator<If>;
-    DirectScssQueryFeature: Combinator<ValueNode>;
-    DirectScssQueryFunction: Combinator<FunctionCall>;
-    DirectScssQueryInParens: Combinator<ValueNode>;
-    DirectScssQueryCondition: Combinator<ValueNode>;
-    DirectScssQueryClause: Combinator<ValueNode>;
-    DirectScssQueryPreludeTail: Combinator<ValueNode>;
-    DirectScssQueryPrelude: Combinator<ValueNode>;
-    DirectScssSupportsAtom: Combinator<ValueNode>;
-    DirectScssGeneralTemplate: Combinator<Interpolation>;
-    DirectScssGeneralTemplateParen: Combinator<Interpolation>;
-    DirectScssGeneralTemplateSquare: Combinator<Interpolation>;
-    DirectScssGeneralTemplateBrace: Combinator<Interpolation>;
-    DirectScssGeneralTemplateDoubleQuoted: Combinator<Interpolation>;
-    DirectScssGeneralTemplateSingleQuoted: Combinator<Interpolation>;
-    DirectScssGeneralEnclosed: Combinator<GeneralEnclosed>;
-    DirectScssSupportsFeature: Combinator<ValueNode>;
-    DirectScssSupportsInParens: Combinator<ValueNode>;
-    DirectScssSupportsNot: Combinator<Keyword>;
-    DirectScssSupportsAndOr: Combinator<Keyword>;
-    DirectScssSupportsCondition: Combinator<ValueNode>;
-    DirectScssSupportsPrelude: Combinator<ValueNode>;
-    DirectScssStaticMediaPrelude: Combinator<ValueNode>;
-    DirectScssStaticAtPrelude: Combinator<ValueNode | null>;
-    DirectScssStaticAtPreludeAtom: Combinator<Token>;
-    DirectScssStaticAtPreludeParen: Combinator<Token>;
-    DirectScssStaticAtPreludeSquare: Combinator<Token>;
-    DirectScssStaticAtPreludeDoubleQuoted: Combinator<Token>;
-    DirectScssStaticAtPreludeSingleQuoted: Combinator<Token>;
-    DirectScssAtRuleStatement: Combinator<AtRuleStatement>;
-    DirectScssScopeBlock: Combinator<AtRuleBlock>;
-    DirectScssNestedScopeBlock: Combinator<AtRuleBlock>;
-    DirectScssConditionalBlock: Combinator<AtRuleBlock>;
-    DirectScssStartingStyleBlock: Combinator<AtRuleBlock>;
-    DirectScssLayerBlock: Combinator<AtRuleBlock>;
-    DirectScssDocumentBlock: Combinator<AtRuleBlock>;
-    DirectScssPageMarginBox: Combinator<AtRuleBlock>;
-    DirectScssPageBlock: Combinator<AtRuleBlock>;
-    DirectScssFontFeatureValueBlock: Combinator<AtRuleBlock>;
-    DirectScssFontFeatureValuesBlock: Combinator<AtRuleBlock>;
-    DirectScssNestedConditionalBlock: Combinator<AtRuleBlock>;
-    DirectScssNestedStartingStyleBlock: Combinator<AtRuleBlock>;
-    DirectScssNestedLayerBlock: Combinator<AtRuleBlock>;
-    DirectScssFontFace: Combinator<AtRuleBlock>;
-    DirectScssCounterStyle: Combinator<AtRuleBlock>;
-    DirectScssPropertyName: Combinator<Keyword>;
-    DirectScssPropertyAtRule: Combinator<AtRuleBlock>;
-    DirectScssKeyframeSelector: Combinator<SimpleSelector>;
-    DirectScssKeyframeBlock: Combinator<Rule>;
-    DirectScssKeyframes: Combinator<AtRuleBlock>;
-    DirectScssOpaquePrelude: Combinator<string | null>;
-    DirectScssOpaqueBody: Combinator<string>;
-    DirectScssOpaqueAtRuleBlock: Combinator<OpaqueAtRuleBlock>;
-    DirectScssOpaqueAtRuleStatement: Combinator<AtRuleStatement>;
-    DirectScssSimple: Combinator<SimpleSelector>;
-    DirectScssInterpolatedSimple: Combinator<SimpleSelector>;
-    DirectScssPlaceholder: Combinator<SimpleSelector>;
-    DirectScssAttribute: Combinator<SimpleSelector>;
-    DirectScssPseudoArgument: Combinator<string>;
-    DirectScssStaticSelectorPseudoArgument: Combinator<string>;
-    DirectScssStaticSelectorPseudoItem: Combinator<string>;
-    DirectScssStaticSelectorPseudoTail: Combinator<string>;
-    DirectScssStaticPseudoArgument: Combinator<string>;
-    DirectScssStaticPseudoGroup: Combinator<string>;
-    DirectScssStaticPseudoSquare: Combinator<string>;
-    DirectScssPseudo: Combinator<SimpleToken>;
-    DirectScssNestingSelector: Combinator<SimpleSelector>;
-    DirectScssCompound: Combinator<CompoundSelector>;
-    DirectScssComplexTail: Combinator<ScssComplexTail>;
-    DirectScssComplex: Combinator<ComplexSelector>;
-    DirectScssSelectorTail: Combinator<ComplexSelector>;
-    DirectScssSelector: Combinator<SelectorList>;
-    DirectScssExtend: Combinator<ExtendInstruction>;
-    DirectScssRule: Combinator<Rule>;
-    rw: Combinator<string[]>;
-    whitespace: Combinator<string[]>;
-};
-export declare const scssGrammar: Record<keyof ScssRules, FusedRule>;
-export declare const scssAstGrammar: Record<keyof ScssRules, FusedRule>;
-export declare const scssCstGrammar: Record<keyof ScssRules, FusedRule>;
-export {};
+export declare const scssGrammar: Record<string, import("parseman").Runnable>;
+/** AST artifact with Parseman line/column tracking enabled. */
+export declare const scssPositionsGrammar: Record<string, import("parseman").Runnable>;
+export declare const scssCstGrammar: Record<string, import("parseman").Runnable>;
+/** CST artifact with Parseman line/column tracking enabled. */
+export declare const scssCstPositionsGrammar: Record<string, import("parseman").Runnable>;

package/lib/index.cjs

@@ -1,111 +1,18 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_grammar = require("./grammar.cjs");
-let parseman = require("parseman");
-let _jesscss_core_ast = require("@jesscss/core/ast");
-//#region src/ast/lower-user-function-calls.ts
+const require_parse_with = require("./chunks/parse-with.cjs");
+let src_grammar_ast_js = require("./grammar/ast.cjs");
+//#region src/index.ts
 /**
-* SCSS call-site lowering: a user `@function f(...)` was lowered (in the grammar)
-* to a `$var`-bound value lambda (`AnonymousMixin` with `params`). A CALL to that
-* function — `f(2)` — parses as an ordinary `FunctionCall`, indistinguishable at
-* the leaf from a builtin Sass call (`darken(...)`). This post-parse pass rewrites
-* every `FunctionCall` whose name is a USER-defined `@function` into the shared
-* `$f(args)` invoke form (a `Reference` with a `Call` step on the bound variable),
-* so it reaches the general "call a value-lambda" evaluator path. Builtin Sass
-* functions are left as `FunctionCall`s and continue to route to `fns`.
+* Parse SCSS directly into the canonical AST v2 document.
 *
-* User-function names are collected from the WHOLE document first (Sass hoists and
-* effectively globalises function definitions), so a call may precede its `@function`.
-* The only SCSS construct that binds an `AnonymousMixin` to a `$var` is `@function`,
-* so "a VariableDeclaration whose value is an AnonymousMixin" is an exact marker.
-*/
-function isRecord(value) {
-	return typeof value === "object" && value !== null;
-}
-function isFunctionCall(value) {
-	return isRecord(value) && value.type === "FunctionCall" && typeof value.name === "string" && Array.isArray(value.args);
-}
-/** A non-array value slot is a single value node. */
-function isValueNode(slot) {
-	return !Array.isArray(slot);
-}
-function isStylesheet$1(value) {
-	return isRecord(value) && value.type === "Stylesheet" && Array.isArray(value.children);
-}
-/** Collect every user `@function` name: a VariableDeclaration bound to an
-*  AnonymousMixin (the only SCSS shape that produces one). */
-function collectUserFunctionNames(node, into) {
-	if (Array.isArray(node)) {
-		for (const child of node) collectUserFunctionNames(child, into);
-		return;
-	}
-	if (!isRecord(node)) return;
-	if (node.type === "VariableDeclaration" && typeof node.name === "string" && isRecord(node.value) && node.value.type === "AnonymousMixin") into.add(node.name);
-	for (const key of Object.keys(node)) collectUserFunctionNames(node[key], into);
-}
-/** Best-effort authored spelling of a call argument, for a Reference `raw`
-*  fallback (only ever emitted if the invoke fails to resolve). */
-function argRaw(slot) {
-	if (!isValueNode(slot)) return slot.map(argRaw).join(" ");
-	if (slot.type === "VariableReference") return `$${slot.name}`;
-	if ("src" in slot && typeof slot.src === "string") return slot.src;
-	return "";
-}
-/** Deep-transform the tree, rewriting user-function `FunctionCall`s (post-order,
-*  so nested user calls inside the args lower first). Non-AST scalars pass through. */
-function rewrite(node, userFns) {
-	if (Array.isArray(node)) return node.map((child) => rewrite(child, userFns));
-	if (!isRecord(node)) return node;
-	const out = {};
-	for (const key of Object.keys(node)) out[key] = rewrite(node[key], userFns);
-	if (isFunctionCall(out) && userFns.has(out.name)) {
-		const args = out.args.map((value) => ({ value }));
-		const raw = `${out.name}(${out.args.map(argRaw).join(", ")})`;
-		return (0, _jesscss_core_ast.reference)((0, _jesscss_core_ast.variableReference)(out.name, "live"), [{
-			type: "Call",
-			args
-		}], raw);
-	}
-	return out;
-}
-/**
-* Rewrite user-`@function` call sites in a parsed SCSS document to `$f(args)`
-* lambda invokes. Returns the document unchanged when it defines no user function.
+* Spans carry offsets only. For `startLine`/`startColumn` facts import `parse`
+* from `@jesscss/scss-parser/positions` — the same function bound to the
+* line-aware compiled table. This entry never loads that table.
 */
-function lowerUserFunctionCalls(sheet) {
-	const userFns = /* @__PURE__ */ new Set();
-	collectUserFunctionNames(sheet.children, userFns);
-	if (userFns.size === 0) return sheet;
-	const lowered = rewrite(sheet, userFns);
-	if (!isStylesheet$1(lowered)) throw new TypeError("SCSS user-function lowering did not preserve the Stylesheet root.");
-	return lowered;
-}
-//#endregion
-//#region src/index.ts
-/** Structured failure from the public direct SCSS parser. */
-var ScssParseError = class extends SyntaxError {
-	code = "parse/syntax-error";
-	offset;
-	expected;
-	constructor(offset, expected) {
-		const detail = expected.length > 0 ? ` Expected: ${expected.join(", ")}.` : "";
-		super(`SCSS parser error.${detail}`);
-		this.name = "ScssParseError";
-		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 SCSS directly into the canonical AST v2 document. */
 function parse(input) {
-	const entry = require_grammar.scssAstGrammar.Stylesheet;
-	const trivia = require_grammar.scssAstGrammar.whitespace;
-	if (entry === void 0 || trivia === void 0) throw new TypeError("SCSS AST grammar is missing its public document entry.");
-	const result = (0, parseman.run)(entry, input, { trivia });
-	if (!result.ok || result.unconsumedFrom !== null || !isStylesheet(result.value)) throw new ScssParseError(result.ok ? result.unconsumedFrom ?? result.span.end : result.span.start, result.expected);
-	return (0, _jesscss_core_ast.withTriviaMap)((0, _jesscss_core_ast.withSourceSpan)(lowerUserFunctionCalls(result.value), result.span), (0, _jesscss_core_ast.createTriviaMapFromParseman)(input, result.triviaMap));
+	return require_parse_with.parseWith(src_grammar_ast_js.scssGrammar, input);
 }
 //#endregion
-exports.ScssParseError = ScssParseError;
+exports.ScssImportPostludeError = require_parse_with.ScssImportPostludeError;
+exports.ScssParseError = require_parse_with.ScssParseError;
 exports.parse = parse;

package/lib/index.d.ts

@@ -1,10 +1,10 @@
-import { type Stylesheet } from '@jesscss/core/ast';
-/** Structured failure from the public direct SCSS parser. */
-export declare class ScssParseError extends SyntaxError {
-    readonly code: 'parse/syntax-error';
-    readonly offset: number;
-    readonly expected: readonly string[];
-    constructor(offset: number, expected: readonly string[]);
-}
-/** Parse SCSS directly into the canonical AST v2 document. */
+import type { Stylesheet } from '@jesscss/core/ast';
+export { ScssImportPostludeError, ScssParseError } from './parse-error.js';
+/**
+ * Parse SCSS directly into the canonical AST v2 document.
+ *
+ * Spans carry offsets only. For `startLine`/`startColumn` facts import `parse`
+ * from `@jesscss/scss-parser/positions` — the same function bound to the
+ * line-aware compiled table. This entry never loads that table.
+ */
 export declare function parse(input: string): Stylesheet;

package/lib/index.js

@@ -1,109 +1,15 @@
-import { scssAstGrammar } from "./grammar.js";
-import { run } from "parseman";
-import { createTriviaMapFromParseman, reference, variableReference, withSourceSpan, withTriviaMap } from "@jesscss/core/ast";
-//#region src/ast/lower-user-function-calls.ts
+import { n as ScssImportPostludeError, r as ScssParseError, t as parseWith } from "./chunks/parse-with.js";
+import { scssGrammar } from "./grammar/ast.js";
+//#region src/index.ts
 /**
-* SCSS call-site lowering: a user `@function f(...)` was lowered (in the grammar)
-* to a `$var`-bound value lambda (`AnonymousMixin` with `params`). A CALL to that
-* function — `f(2)` — parses as an ordinary `FunctionCall`, indistinguishable at
-* the leaf from a builtin Sass call (`darken(...)`). This post-parse pass rewrites
-* every `FunctionCall` whose name is a USER-defined `@function` into the shared
-* `$f(args)` invoke form (a `Reference` with a `Call` step on the bound variable),
-* so it reaches the general "call a value-lambda" evaluator path. Builtin Sass
-* functions are left as `FunctionCall`s and continue to route to `fns`.
+* Parse SCSS directly into the canonical AST v2 document.
 *
-* User-function names are collected from the WHOLE document first (Sass hoists and
-* effectively globalises function definitions), so a call may precede its `@function`.
-* The only SCSS construct that binds an `AnonymousMixin` to a `$var` is `@function`,
-* so "a VariableDeclaration whose value is an AnonymousMixin" is an exact marker.
-*/
-function isRecord(value) {
-	return typeof value === "object" && value !== null;
-}
-function isFunctionCall(value) {
-	return isRecord(value) && value.type === "FunctionCall" && typeof value.name === "string" && Array.isArray(value.args);
-}
-/** A non-array value slot is a single value node. */
-function isValueNode(slot) {
-	return !Array.isArray(slot);
-}
-function isStylesheet$1(value) {
-	return isRecord(value) && value.type === "Stylesheet" && Array.isArray(value.children);
-}
-/** Collect every user `@function` name: a VariableDeclaration bound to an
-*  AnonymousMixin (the only SCSS shape that produces one). */
-function collectUserFunctionNames(node, into) {
-	if (Array.isArray(node)) {
-		for (const child of node) collectUserFunctionNames(child, into);
-		return;
-	}
-	if (!isRecord(node)) return;
-	if (node.type === "VariableDeclaration" && typeof node.name === "string" && isRecord(node.value) && node.value.type === "AnonymousMixin") into.add(node.name);
-	for (const key of Object.keys(node)) collectUserFunctionNames(node[key], into);
-}
-/** Best-effort authored spelling of a call argument, for a Reference `raw`
-*  fallback (only ever emitted if the invoke fails to resolve). */
-function argRaw(slot) {
-	if (!isValueNode(slot)) return slot.map(argRaw).join(" ");
-	if (slot.type === "VariableReference") return `$${slot.name}`;
-	if ("src" in slot && typeof slot.src === "string") return slot.src;
-	return "";
-}
-/** Deep-transform the tree, rewriting user-function `FunctionCall`s (post-order,
-*  so nested user calls inside the args lower first). Non-AST scalars pass through. */
-function rewrite(node, userFns) {
-	if (Array.isArray(node)) return node.map((child) => rewrite(child, userFns));
-	if (!isRecord(node)) return node;
-	const out = {};
-	for (const key of Object.keys(node)) out[key] = rewrite(node[key], userFns);
-	if (isFunctionCall(out) && userFns.has(out.name)) {
-		const args = out.args.map((value) => ({ value }));
-		const raw = `${out.name}(${out.args.map(argRaw).join(", ")})`;
-		return reference(variableReference(out.name, "live"), [{
-			type: "Call",
-			args
-		}], raw);
-	}
-	return out;
-}
-/**
-* Rewrite user-`@function` call sites in a parsed SCSS document to `$f(args)`
-* lambda invokes. Returns the document unchanged when it defines no user function.
+* Spans carry offsets only. For `startLine`/`startColumn` facts import `parse`
+* from `@jesscss/scss-parser/positions` — the same function bound to the
+* line-aware compiled table. This entry never loads that table.
 */
-function lowerUserFunctionCalls(sheet) {
-	const userFns = /* @__PURE__ */ new Set();
-	collectUserFunctionNames(sheet.children, userFns);
-	if (userFns.size === 0) return sheet;
-	const lowered = rewrite(sheet, userFns);
-	if (!isStylesheet$1(lowered)) throw new TypeError("SCSS user-function lowering did not preserve the Stylesheet root.");
-	return lowered;
-}
-//#endregion
-//#region src/index.ts
-/** Structured failure from the public direct SCSS parser. */
-var ScssParseError = class extends SyntaxError {
-	code = "parse/syntax-error";
-	offset;
-	expected;
-	constructor(offset, expected) {
-		const detail = expected.length > 0 ? ` Expected: ${expected.join(", ")}.` : "";
-		super(`SCSS parser error.${detail}`);
-		this.name = "ScssParseError";
-		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 SCSS directly into the canonical AST v2 document. */
 function parse(input) {
-	const entry = scssAstGrammar.Stylesheet;
-	const trivia = scssAstGrammar.whitespace;
-	if (entry === void 0 || trivia === void 0) throw new TypeError("SCSS AST grammar is missing its public document entry.");
-	const result = run(entry, input, { trivia });
-	if (!result.ok || result.unconsumedFrom !== null || !isStylesheet(result.value)) throw new ScssParseError(result.ok ? result.unconsumedFrom ?? result.span.end : result.span.start, result.expected);
-	return withTriviaMap(withSourceSpan(lowerUserFunctionCalls(result.value), result.span), createTriviaMapFromParseman(input, result.triviaMap));
+	return parseWith(scssGrammar, input);
 }
 //#endregion
-export { ScssParseError, parse };
+export { ScssImportPostludeError, ScssParseError, parse };

package/lib/parse-error.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The public SCSS 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 SCSS parser. */
+export declare class ScssParseError 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;
+    });
+}
+/**
+ * A media/layer/supports postlude belongs to the plain CSS `@import` form only.
+ *
+ * Once the parser has decided an `@import` is compile-time — a Sass partial
+ * rather than a `.css` file or a URL — a trailing query has nothing left to
+ * describe: the partial's rules are spliced into this document, not linked as a
+ * separate CSS resource.
+ */
+export declare class ScssImportPostludeError 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);
+}

package/lib/parse-with.d.ts

@@ -0,0 +1,5 @@
+import { type Stylesheet } from '@jesscss/core/ast';
+import type { scssGrammar } from './grammar/ast.js';
+/** The rule map both compiled SCSS AST variants expose. */
+export type ScssAstGrammar = typeof scssGrammar;
+export declare function parseWith(grammar: ScssAstGrammar, input: string): Stylesheet;