@jesscss/less-parser 2.0.0-alpha.8 → 2.0.0-alpha.9

package/src/index.ts

@@ -1,19 +0,0 @@
-export * from './lessTokens.js';
-
-// The legacy Chevrotain parser (lessRecursiveParser / lessParser / productions) is
-// no longer exported — the functional macro parser (LessParser / lessGrammar below)
-// IS the parser now. Dropping these re-exports lets the bundler tree-shake ~130 KB
-// of the old parser out of the shipped library. (The source files can be deleted
-// as a follow-up.)
-
-export { LessGrammar } from './builders.js';
-
-import { LessParser } from './functional-parser.js';
-export { LessParser };
-export { lessGrammar } from './grammar.js';
-export { parseLessFn, type LessFnParseResult } from './functional-parser.js';
-export { parseLessCst, parseLessDoc } from './cst.js';
-export type {
-  LessCstChild, LessCstError, LessCstLeaf, LessCstNode, LessCstParseResult, LessCstType
-} from './cst.js';
-export const Parser = LessParser;

package/src/jess.ts

@@ -1,6 +0,0 @@
-export * from './lessRecursiveParser.js';
-export type { LessRules, SyntacticContentAssistSuggestion } from './lessParser.js';
-export { LessParser as LessParserChevrotain } from './lessParser.js';
-export { LessGrammar } from './builders.js';
-export { LessParser, parseLessFn, type LessFnParseResult } from './functional-parser.js';
-export { LessParser as Parser } from './functional-parser.js';

package/src/lessParser.ts

@@ -1,120 +0,0 @@
-import { Lexer, type IToken, type IRecognitionException } from 'chevrotain';
-import { lessTokens, lessFragments } from './lessTokens.js';
-import { createLexerDefinition } from '@jesscss/css-parser';
-import { LessRecursiveParser, type LessParserConfig, type TokenMap } from './lessRecursiveParser.js';
-import { nil, type Node, type Rules, type IParseResult, type TreeContext } from '@jesscss/core';
-
-export type LessRules = keyof {
-  [K in keyof LessRecursiveParser as LessRecursiveParser[K] extends (...args: any[]) => Node ? K : never]: true;
-};
-
-export type SyntacticContentAssistSuggestion = {
-  nextTokenType: string;
-  nextTokenLabel?: string;
-  ruleStack: string[];
-};
-
-/**
- * Cached lexer + parser singletons. Chevrotain initialization (~500ms)
- * only happens once — config changes are applied via instance properties
- * before each parse.
- */
-let cachedLexer: Lexer | undefined;
-let cachedParser: LessRecursiveParser | undefined;
-let cachedTokenMap: TokenMap | undefined;
-
-function getSharedLexerAndParser(config: LessParserConfig): { lexer: Lexer; parser: LessRecursiveParser } {
-  if (!cachedLexer || !cachedParser) {
-    const { lexer, T } = createLexerDefinition(
-      lessFragments(),
-      lessTokens()
-    );
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
-    cachedTokenMap = T as TokenMap;
-    cachedLexer = new Lexer(lexer, {
-      ensureOptimizations: true,
-      skipValidations: process.env.TEST !== 'true'
-    });
-    cachedParser = new LessRecursiveParser(cachedTokenMap, config);
-  }
-  // Apply per-parse config to the cached parser instance
-  const {
-    looseMode = true,
-    leakyScope = true,
-    mathMode = 'parens-division',
-    wrapOuterExpressions = true,
-    legacyMode = looseMode
-  } = config;
-  cachedParser.looseMode = looseMode;
-  cachedParser.leakyScope = leakyScope;
-  cachedParser.mathMode = mathMode;
-  cachedParser.wrapOuterExpressions = wrapOuterExpressions;
-  cachedParser.legacyMode = legacyMode;
-
-  return { lexer: cachedLexer, parser: cachedParser };
-}
-
-/**
- * @deprecated LEGACY — Chevrotain-lexer + recursive-descent Less parser. Superseded
- * by the functional macro grammar (`LessParser` in ./grammar.ts). Kept only for
- * benchmarking / migration reference; TO BE DELETED once the functional parser
- * fully lands.
- */
-export class LessParser {
-  lexer: Lexer;
-  parser: LessRecursiveParser;
-
-  constructor(
-    config: LessParserConfig = {}
-  ) {
-    config = {
-      looseMode: true,
-      ...config
-    };
-    const shared = getSharedLexerAndParser(config);
-    this.lexer = shared.lexer;
-    this.parser = shared.parser;
-    this.parse = this.parse.bind(this);
-  }
-
-  parse(text: string): IParseResult<Rules>;
-  parse(text: string, rule: 'stylesheet'): IParseResult<Rules>;
-  parse(text: string, rule: 'stylesheet', options: { context?: TreeContext }): IParseResult<Rules>;
-  parse(text: string, rule?: LessRules, options?: { context?: TreeContext }): IParseResult;
-  parse(text: string, rule: LessRules = 'stylesheet', options?: { context?: TreeContext }): IParseResult {
-    const parser = this.parser;
-    const lexerResult = this.lexer.tokenize(text);
-    parser.warnings = [];
-    if (options?.context) {
-      parser.context = options.context;
-    }
-    parser.context.opts.trivia = undefined;
-    parser.input = lexerResult.tokens;
-    const ruleMethod = parser[rule];
-    if (typeof ruleMethod !== 'function') {
-      throw new Error(`Unknown parser rule: ${rule}`);
-    }
-    const tree = ruleMethod.call(parser);
-    const trivia = (parser as LessRecursiveParser & { trivia: IParseResult['trivia'] }).trivia;
-    parser.context.opts.trivia = trivia;
-    const resultTree = tree ?? nil();
-    (resultTree.sourceRoot?._treeContext ?? parser.context).opts.trivia = trivia;
-
-    const warnings = [...parser.warnings];
-
-    return {
-      tree: resultTree,
-      lexerResult,
-      errors: parser.errors,
-      trivia,
-      warnings
-    };
-  }
-
-  /**
-   * @todo Implement content assist for the new parser
-   */
-  suggest(text: string, init: { offset: number; rule?: LessRules }): SyntacticContentAssistSuggestion[] {
-    return [];
-  }
-}

package/src/lessRecursiveParser.ts

@@ -1,279 +0,0 @@
-import {
-  type IToken,
-  type TokenType,
-  tokenMatcher
-} from 'chevrotain';
-
-import {
-  CssRecursiveParser,
-  type CssRecursiveParserConfig,
-  type RuleContext as CssRuleContext,
-  type CssTokenType,
-  productions as cssProductions
-} from '@jesscss/css-parser/jess';
-
-import {
-  Reference,
-  DefaultGuard,
-  Interpolated,
-  INTERPOLATION_PLACEHOLDER,
-  Any,
-  Bool,
-  type MathMode,
-  type Node,
-  type Extend,
-  type ComplexSelector,
-  type Selector
-} from '@jesscss/core';
-import { createInterpolatedReference, getInterpolatedOrString } from './utils.js';
-
-import { type LessExtraTokenType } from './lessTokens.js';
-
-import * as productions from './productions/index.js';
-
-export type LessParserConfig = CssRecursiveParserConfig & {
-  /**
-   * 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'
-   */
-  leakyScope?: 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;
-};
-
-// Concrete TokenMap: union of CSS and Less token names
-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;
-  allExtended?: boolean;
-  isDefinition?: boolean;
-  allowAnonymousMixins?: boolean;
-  requireAccessorsAfterMixinCall?: boolean;
-  inValueList?: boolean;
-  allowComma?: boolean;
-  node?: Node;
-  ruleIsFinished?: boolean;
-  sequences?: Array<ComplexSelector | Extend>;
-  asReference?: boolean;
-  extendTargets?: ExtendTarget[];
-  extendNodes?: Extend[];
-  inExtend?: boolean;
-  wrapInExpression?: boolean;
-  parenFrames?: boolean[];
-  calcFrames?: number;
-  detachedRulesetUsage?: 'function-arg' | 'mixin-arg' | 'default-param';
-  inFunctionArgs?: boolean;
-  allowMixinCallWithoutAccessor?: boolean;
-  startValue?: Node;
-  atRulePreludeBareVariableAs?: 'index';
-};
-
-/**
- * @deprecated LEGACY — Chevrotain-based Less parser engine (extends the deprecated
- * CssRecursiveParser). Superseded by the functional macro grammar in ./grammar.ts.
- * Kept only for benchmarking; TO BE DELETED once the functional parser fully lands.
- */
-export class LessRecursiveParser extends CssRecursiveParser {
-  declare T: TokenMap;
-  looseMode: boolean;
-  leakyScope: boolean;
-  /** Warnings collected during parsing */
-  warnings: Array<{ message: string; token?: IToken; deprecation?: string }> = [];
-
-  /** See `LessParserConfig.mathMode` */
-  mathMode: MathMode;
-  /** See `LessParserConfig.wrapOuterExpressions` */
-  wrapOuterExpressions: boolean;
-
-  private processLegacyMSFilterToken(token: IToken): Node {
-    const location = this.getLocationInfo(token);
-    const source = token.image.replace(/\s*=\s*/g, '=');
-    const matches = [...source.matchAll(/@([_a-zA-Z\xA0-\uFFFF][-_a-zA-Z0-9\xA0-\uFFFF]*)/g)];
-
-    if (matches.length === 0) {
-      return new Any(source, { type: token.tokenType?.name }, location);
-    }
-
-    const templatedSource = source.replace(
-      /@([_a-zA-Z\xA0-\uFFFF][-_a-zA-Z0-9\xA0-\uFFFF]*)/g,
-      (_full, _name, offset: number, fullSource: string) => {
-        const prefix = fullSource.slice(0, offset);
-        const key = prefix.match(/([A-Za-z]+)=$/)?.[1];
-        if (key && /colorstr$/i.test(key)) {
-          return `"${INTERPOLATION_PLACEHOLDER}"`;
-        }
-        return INTERPOLATION_PLACEHOLDER;
-      }
-    );
-
-    return new Interpolated(
-      {
-        source: templatedSource,
-        replacements: matches.map(match =>
-          createInterpolatedReference('@', match[1]!, location, this.context)
-        )
-      },
-      { role: 'any' },
-      location
-    );
-  }
-
-  constructor(
-    T: TokenMap,
-    config: LessParserConfig = {}
-  ) {
-    let {
-      legacyMode,
-      looseMode = true,
-      leakyScope = true,
-      mathMode = 'parens-division',
-      wrapOuterExpressions = true,
-      ...rest
-    } = config;
-    legacyMode = legacyMode ?? looseMode;
-    super(T, { legacyMode, ...rest });
-
-    this.T = T;
-    this.looseMode = looseMode;
-    this.leakyScope = leakyScope;
-    this.mathMode = mathMode;
-    this.wrapOuterExpressions = wrapOuterExpressions;
-    this.warnings = [];
-
-    for (const [key, factory] of Object.entries(productions)) {
-      if (typeof factory !== 'function') {
-        continue;
-      }
-      const rule = (factory as Function).call(this, this.T);
-      if (key in cssProductions) {
-        this.OVERRIDE_RULE(key, rule);
-      } else {
-        this.RULE(key, rule);
-      }
-    }
-
-    if (this.constructor === LessRecursiveParser) {
-      this.performSelfAnalysis();
-    }
-  }
-
-  protected override processValueToken(token: IToken, ctx?: RuleContext): Node {
-    let tokenType = token.tokenType;
-    const T = this.T;
-
-    if (tokenType.name === 'AtKeyword' || tokenMatcher(token, T.AtKeyword)) {
-      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 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));
-      }
-      if (ctx?.atRulePreludeBareVariableAs === 'index') {
-        const nextToken = this.LA(1).tokenType;
-        const hasExplicitAccessorOrCall = this.noSep()
-          && (nextToken === T.LSquare || nextToken === T.LParen);
-        if (hasExplicitAccessorOrCall) {
-          return new Reference(token.image.slice(1), { type: 'variable' }, this.getLocationInfo(token));
-        }
-        const atName = token.image;
-        const ident = token.image.slice(1);
-        this.warnDeprecation(
-          `"${atName}" in at-rule preludes is deprecated. Use "@{${ident}}" in Less; outside declaration values this is normalized to indexed lookup syntax.`,
-          token,
-          'at-rule-prelude-variable'
-        );
-        return new Reference(
-          { key: ident },
-          { type: 'index', role: 'ident' },
-          this.getLocationInfo(token)
-        );
-      }
-      return new Reference(token.image.slice(1), { type: 'variable' }, this.getLocationInfo(token));
-    } else if (tokenType.name === 'PropertyReference') {
-      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));
-      }
-      return super.processValueToken(token, ctx);
-    } else if (tokenType === T['DefaultGuardFunc']) {
-      return new DefaultGuard(token.image, undefined, this.getLocationInfo(token));
-    } else if (
-      tokenType.name === 'JavaScript'
-      || (T['JavaScript'] && tokenMatcher(token, T['JavaScript']))
-    ) {
-      throw new Error(
-        'Inline JavaScript using backticks is not supported. Use @use / @-use to import a script module instead. Script-module documentation is coming soon.'
-      );
-    } else if (tokenType === T['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));
-      }
-    } else if (tokenType === T['LegacyMSFilter']) {
-      return this.processLegacyMSFilterToken(token);
-    } else if (tokenType === T['PlainIdent']) {
-      const image = token.image;
-      if (image === 'true' || image === 'false') {
-        return new Bool(image === 'true', undefined, this.getLocationInfo(token));
-      }
-    }
-    return super.processValueToken(token, ctx);
-  }
-
-  warnDeprecation(message: string, token?: IToken, deprecationId?: string): void {
-    this.warnings.push({ message, token, deprecation: deprecationId });
-  }
-}