@jesscss/less-parser 1.0.8-alpha.6 → 2.0.0-alpha.2

package/README.md

@@ -1,3 +1,36 @@
 # Jess - Less parser
 
-As Jess started as a re-write of Less, this package represents a portion of that work, and is therefore a fully-functional Less CST parser.
+Translates a Less string to a Jess AST.
+
+## Ideas
+
+### Converting Less 1.x-5.x to Less 6
+
+1. Auto-wrap parens around division to dis-ambiguate.
+2. Convert `@import` to `@use` and `@include` syntax.
+3. Throw errors on `@plugin` and ask to refactor with `@from`
+4. Convert function references to `@from '#less' ([func])`
+5. Add parentheses after mixin calls e.g. `.ns > .mixin;` to `.ns.mixin();`
+6. Convert local imports from `@import 'local'` to `@include './local.less'`
+7. Convert `@import (less) './file.css';` to `@include './file.css' as less;`
+8. Convert `@import (inline) './file.css';` to `@include './file.css' as text;`
+9. Convert `@import (reference) './file.less';` to `@use './file.less';`
+10. Files that consume variables, mixins, or rules (like with extend) should have a `@use` added.
+11. Don't allow `.class` as a value in a declaration. Convert to `\.class` e.g. `@foo: .class` should be converted to `@foo: \.class` (or `selector(.class)`?).
+12. In a custom property value, convert `@variable` to `@{variable}`.
+
+
+### Converting Less 1.x-4.x to Jess
+
+1. Auto-wrap expressions (like math) with `$()`
+2. Convert mixin definitions `.my-mixin()` to `@mixin my-mixin()`
+3. Convert mixin calls to function calls: `#ns > .mixin()` to `$ns.mixin()`
+4. Throw errors on mixed case mixins: `.my-mixin()` and `.myMixin()`
+5. Throw errors on mixed hash and class mixins: `#my-mixin()` and `.my-mixin()`
+5. Convert variable declarations `@my-var` with `$my-var`
+6. Convert interpolated vars `@{my-var}` to `$(my-var)`
+7. Convert property references `$prop` to `$[prop]`
+8. Convert color names in expressions to hex values (or wrapped in `color()`?) (because Jess doesn't support color keywords in expressions). Alternatively, should Jess allow `keyword` to denote keywords?
+9. Convert `@rest...` to `...rest`
+10. Convert `.rules()` to `@include .rules()` if `.rules` is a selector. What if it's a selector and mixin? Maybe something like `@include .rules, $rules();`? This might change the execution order from Less though.
+11. Convert `@foo: extract(@bar, 1)` to `@let foo: $bar[0];`?

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

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

package/lib/__tests__/debug-log.js

@@ -0,0 +1,34 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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.d.ts

@@ -1,11 +1,33 @@
-import { Lexer } from 'chevrotain';
-import { IParseResult } from '@jesscss/css-parser';
-import { LessParser } from './lessParser';
-export * from './lessParser';
-export * from './lessTokens';
+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;
-    parser: LessParser;
-    constructor();
-    parse(text: string): IParseResult<LessParser>;
+    /** @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[];
 }

package/lib/index.js

@@ -1,38 +1,75 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Parser = void 0;
-const chevrotain_1 = require("chevrotain");
-const lessTokens_1 = require("./lessTokens");
-const css_parser_1 = require("@jesscss/css-parser");
-const lessParser_1 = require("./lessParser");
-__exportStar(require("./lessParser"), exports);
-__exportStar(require("./lessTokens"), exports);
-class Parser {
-    constructor() {
-        const { tokens, T } = css_parser_1.createTokens(lessTokens_1.Fragments, lessTokens_1.Tokens);
-        this.lexer = new chevrotain_1.Lexer(tokens, {
+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['JESS_TESTING_MODE'] !== 'true'
+            skipValidations: process.env.TEST !== 'true'
         });
-        this.parser = new lessParser_1.LessParser(tokens, T);
+        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) {
+    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 cst = parser.root();
-        return { cst, lexerResult, parser };
+        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 [];
+        }
     }
 }
-exports.Parser = Parser;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/lessActionsParser.d.ts

@@ -0,0 +1,156 @@
+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;
+}

package/lib/lessActionsParser.js

@@ -0,0 +1,145 @@
+import { tokenMatcher } from 'chevrotain';
+// import { LLStarLookaheadStrategy } from 'chevrotain-allstar'
+import { CssActionsParser, productions as cssProductions } from '@jesscss/css-parser';
+import { Reference, DefaultGuard, Interpolated, Any, Bool } from '@jesscss/core';
+import { getInterpolatedOrString } from './utils.js';
+import * as productions from './productions.js';
+/**
+ * Unlike the historical Less parser, this parser
+ * avoids all backtracking
+ */
+export class LessActionsParser extends CssActionsParser {
+    looseMode;
+    leakyRules;
+    /** Warnings collected during parsing */
+    warnings = [];
+    expressionSum;
+    expressionProduct;
+    expressionValue;
+    functionValueList;
+    booleanFunction;
+    wrappedDeclarationList;
+    varDeclarationOrCall;
+    varName;
+    selectorCapture;
+    valueReference;
+    varReference;
+    // mixins
+    mixinReference;
+    mixinName;
+    mixinOrQualifiedRule;
+    qualifiedRuleBody;
+    // mixinDefinition!: Rule;
+    // mixinCall!: Rule;
+    // mixinCallStatement!: Rule;
+    mixinArgs;
+    mixinArgList;
+    mixinArg;
+    anonymousMixinDefinition;
+    callArgument;
+    extend;
+    ampersandExtend;
+    // namespaces
+    // accessors!: Rule;
+    lookupOrCall;
+    comparison;
+    guard;
+    guardDefault;
+    guardOr;
+    guardAnd;
+    guardInParens;
+    guardInner;
+    guardWithCondition;
+    guardWithConditionValue;
+    exportAtRule;
+    /** See `LessParserConfig.mathMode` */
+    mathMode;
+    /** See `LessParserConfig.wrapOuterExpressions` */
+    wrapOuterExpressions;
+    constructor(tokenVocabulary, T, config = {}) {
+        let { legacyMode, looseMode = true, leakyRules = true, mathMode = 'parens-division', wrapOuterExpressions = true, ...rest } = config;
+        legacyMode = legacyMode ?? looseMode;
+        super(tokenVocabulary, T, { legacyMode, ...rest });
+        this.looseMode = looseMode;
+        this.leakyRules = leakyRules;
+        this.mathMode = mathMode;
+        this.wrapOuterExpressions = wrapOuterExpressions;
+        this.warnings = [];
+        const $ = this;
+        /** Less extensions */
+        for (let [key, value] of Object.entries(productions)) {
+            // @ts-expect-error - this is fine
+            let rule = value.call(this, T);
+            if (key in cssProductions) {
+                this.OVERRIDE_RULE(key, rule);
+            }
+            else {
+                this.RULE(key, rule);
+            }
+        }
+        if ($.constructor === LessActionsParser) {
+            $.performSelfAnalysis();
+        }
+    }
+    processValueToken(token, ctx) {
+        let tokenType = token.tokenType;
+        const TT = this.T;
+        const tokenName = tokenType.name;
+        // Check if this is an AtKeyword token (can be consumed via T.AtName category or T.Value category)
+        // Also check tokenMatcher in case the token type name check doesn't work
+        if (tokenType.name === 'AtKeyword' || tokenMatcher(token, this.T.AtKeyword)) {
+            if (!this.RECORDING_PHASE && ctx?.inCustomPropertyValue) {
+                const atName = token.image;
+                const ident = token.image.slice(1);
+                this.warnDeprecation(`"${atName}" in custom property values is treated as literal text, not a variable reference. Use "\@{${ident}}" if you want it to be evaluated.`, token, 'variable-in-unknown-value');
+                return new Any(token.image, { role: 'any' }, this.getLocationInfo(token), this.context);
+            }
+            return new Reference(token.image.slice(1), { type: 'variable' }, this.getLocationInfo(token), this.context);
+        }
+        else if (tokenType.name === 'PropertyReference') {
+            if (!this.RECORDING_PHASE) {
+                if (ctx?.inCustomPropertyValue) {
+                    const atName = token.image;
+                    const ident = token.image.slice(1);
+                    this.warnDeprecation(`"${atName}" in custom property values is treated as literal text, not a property reference. Use "\${${ident}}" if you want it to be evaluated.`, token, 'property-in-unknown-value');
+                    return new Any(token.image, { role: 'any' }, this.getLocationInfo(token), this.context);
+                }
+            }
+            return super.processValueToken(token, ctx);
+        }
+        else if (tokenType === TT['DefaultGuardFunc']) {
+            return new DefaultGuard(token.image, undefined, this.getLocationInfo(token), this.context);
+        }
+        else if (tokenType.name === 'JavaScript'
+            || (TT['JavaScript'] && tokenMatcher(token, TT['JavaScript']))) {
+            throw new Error('Inline JavaScript using backticks is not supported. Use @use to import a JavaScript/TypeScript module instead. Script-module documentation is coming soon.');
+        }
+        else if (tokenType === TT['InterpolatedIdent']) {
+            const result = getInterpolatedOrString(token.image, this.getLocationInfo(token), this.context);
+            if (result instanceof Interpolated) {
+                return result;
+            }
+            else {
+                return new Any(result, { role: 'ident' }, this.getLocationInfo(token), this.context);
+            }
+        }
+        else if (tokenType === TT['PlainIdent']) {
+            // Parse true/false as Bool nodes in Less
+            const image = token.image;
+            if (image === 'true' || image === 'false') {
+                return new Bool(image === 'true', undefined, this.getLocationInfo(token), this.context);
+            }
+        }
+        return super.processValueToken(token, ctx);
+    }
+    /**
+     * Emits a deprecation warning during parsing.
+     * Only collects warnings during the non-recording phase.
+     */
+    warnDeprecation(message, token, deprecationId) {
+        if (!this.RECORDING_PHASE) {
+            this.warnings.push({ message, token, deprecation: deprecationId });
+        }
+    }
+}
+//# sourceMappingURL=lessActionsParser.js.map

package/lib/lessActionsParser.js.map

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

package/lib/lessErrorMessageProvider.d.ts

@@ -0,0 +1,3 @@
+import { CssErrorMessageProvider } from '@jesscss/css-parser';
+export declare class LessErrorMessageProvider extends CssErrorMessageProvider {
+}

package/lib/lessErrorMessageProvider.js

@@ -0,0 +1,4 @@
+import { CssErrorMessageProvider } from '@jesscss/css-parser';
+export class LessErrorMessageProvider extends CssErrorMessageProvider {
+}
+//# sourceMappingURL=lessErrorMessageProvider.js.map

package/lib/lessErrorMessageProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lessErrorMessageProvider.js","sourceRoot":"","sources":["../src/lessErrorMessageProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,MAAM,OAAO,wBAAyB,SAAQ,uBAAuB;CAAG"}

package/lib/lessTokens.d.ts

@@ -1,3 +1,22 @@
-import { rawTokenConfig } from '@jesscss/css-parser';
-export declare const Fragments: [string, string][];
-export declare let Tokens: rawTokenConfig[];
+import { type RawModeConfig, type TokenNames } from '@jesscss/css-parser';
+/**
+ * Less-specific token names introduced by merges below
+ *
+ * @todo - Can't we infer this from the tokens?
+ */
+export type LessExtraTokenType = 'Ellipsis' | 'AtKeywordLessExtension' | 'Interpolated' | 'LineComment' | 'PlusAssign' | 'UnderscoreAssign' | 'AnonMixinStart' | 'GtEqAlias' | 'LtEqAlias' | 'Extend' | 'AmpersandExtend' | 'AllFlag' | 'When' | 'WhenFunctionStart' | 'VarOrProp' | 'NestedReference' | 'PropertyReference' | 'Percent' | 'FormatFunction' | 'IfFunction' | 'BooleanFunction' | 'DefaultGuardIdent' | 'DefaultGuardFunc' | 'JavaScript' | 'InterpolatedIdent' | 'InterpolatedCustomProperty' | 'InterpolatedSelector';
+declare function $preBuildTokens(): {
+    modes: any;
+    defaultMode: "Default";
+};
+export declare const Fragments: string[][];
+export declare const Tokens: {
+    modes: any;
+    defaultMode: "Default";
+};
+type ReturnTokens = ReturnType<typeof $preBuildTokens>;
+type TokenModes = ReturnTokens['modes'];
+export type LessTokenType = TokenNames<TokenModes[keyof TokenModes]>;
+export declare const lessFragments: () => ReadonlyArray<Readonly<[string, string]>>;
+export declare const lessTokens: () => RawModeConfig;
+export {};