@jesscss/css-parser 1.0.8-alpha.6 → 2.0.0-alpha.1

package/lib/cssActionsParser.js

@@ -0,0 +1,376 @@
+import { tokenMatcher } from 'chevrotain';
+// import { AdvancedCstParser } from './advancedCstParser'
+import { LLStarLookaheadStrategy } from 'chevrotain-allstar';
+import { AdvancedActionsParser } from './advancedActionsParser.js';
+import * as productions from './productions.js';
+import { Node, Comment, F_VISIBLE, Color, ColorFormat, Dimension, Num, Rules, Any } from '@jesscss/core';
+import colors from 'color-name';
+const { isArray } = Array;
+/**
+ * @note - we use an EmbeddedActionsParser for a few reasons:
+ *   1. Jess's AST is essentially a CST; that is, it records
+ *      all whitespace and comments. (The one difference may
+ *      be that some nodes are "simplified" in the Jess AST.)
+ *   2. Chevrotain's CST is not the most efficient structure
+ *      for a CST.
+ *   3. We can avoid the overhead of a CST visitor by creating
+ *      the Jess nodes directly.
+ *   4. In some cases, we need some additional business logic
+ *      about what the intended structure of the AST is, based
+ *      on the presence of certain tokens.
+ */
+export class CssActionsParser extends AdvancedActionsParser {
+    T;
+    legacyMode;
+    ruleIndex = 0;
+    /** Rewire, declaring class fields in constructor with `public` */
+    stylesheet;
+    main;
+    qualifiedRule;
+    atRule;
+    selectorList;
+    declarationList;
+    forgivingSelectorList;
+    classSelector;
+    idSelector;
+    pseudoSelector;
+    attributeSelector;
+    nthValue;
+    complexSelector;
+    simpleSelector;
+    compoundSelector;
+    relativeSelector;
+    declaration;
+    valueList;
+    /** Often a space-separated sequence */
+    valueSequence;
+    value;
+    squareValue;
+    customValue;
+    innerCustomValue;
+    functionCall;
+    functionCallLike;
+    functionCallArgs;
+    ifFunction;
+    ifFunctionArgs;
+    knownFunctions;
+    varFunction;
+    calcFunction;
+    urlFunction;
+    unknownValue;
+    string;
+    // expression: Rule
+    // calc()
+    mathSum;
+    mathProduct;
+    mathValue;
+    mathParen;
+    /** At Rules */
+    innerAtRule;
+    importAtRule;
+    importPrelude;
+    importPostlude;
+    mediaAtRule;
+    supportsAtRule;
+    containerAtRule;
+    containerName;
+    containerQueryList;
+    containerQuery;
+    containerCondition;
+    containerInParens;
+    containerFeature;
+    containerAnd;
+    containerOr;
+    atRuleBody;
+    pageAtRule;
+    keyframesAtRule;
+    keyframesName;
+    layerAtRule;
+    layerName;
+    scopeAtRule;
+    documentAtRule;
+    pageSelector;
+    fontFaceAtRule;
+    nestedAtRule;
+    nonNestedAtRule;
+    unknownAtRule;
+    /** `@media` syntax */
+    mediaQueryList;
+    mediaQuery;
+    mediaCondition;
+    mediaType;
+    mediaConditionWithoutOr;
+    mediaNot;
+    mediaInParens;
+    mediaAnd;
+    mediaOr;
+    mediaFeature;
+    mfValue;
+    mediaRange;
+    mfComparison;
+    mfNonIdentifierValue;
+    /** `@container` syntax - declarations are above */
+    /**
+     * `@supports` syntax - the parsing is defined differently
+     * from `@media`, which is fortunate, because it's much
+     * simpler.
+    */
+    supportsCondition;
+    supportsInParens;
+    /** General purpose subrules */
+    anyOuterValue;
+    anyInnerValue;
+    extraTokens;
+    customBlock;
+    constructor(tokenVocabulary, T, config = {}) {
+        const defaultConfig = {
+            maxLookahead: 1,
+            lookaheadStrategy: new LLStarLookaheadStrategy({
+            // suppress ambiguity logging
+            // logging() {}
+            })
+        };
+        const { legacyMode = true, ...rest } = { ...defaultConfig, ...config };
+        super(tokenVocabulary, rest);
+        this.T = T;
+        this.legacyMode = legacyMode;
+        for (let [key, value] of Object.entries(productions)) {
+            let rule = value.call(this, T);
+            this.RULE(key, rule);
+        }
+        if (this.constructor === CssActionsParser) {
+            this.performSelfAnalysis();
+        }
+    }
+    set input(value) {
+        this.ruleIndex = 0;
+        super.input = value;
+    }
+    getLocationFromNodes(nodes) {
+        let startNode = nodes[0];
+        let lastNode = nodes[nodes.length - 1];
+        let startOffset;
+        let startLine;
+        let startColumn;
+        let endOffset;
+        let endLine;
+        let endColumn;
+        if (startNode === undefined) {
+            return undefined;
+        }
+        if (startNode instanceof Node) {
+            ([startOffset, startLine, startColumn] = startNode.location);
+        }
+        else {
+            ({ startOffset, startLine, startColumn } = startNode);
+        }
+        if (lastNode instanceof Node) {
+            ([, , , endOffset, endLine, endColumn] = lastNode.location);
+        }
+        else {
+            ({ endOffset, endLine, endColumn } = lastNode);
+        }
+        if (startOffset === undefined) {
+            throw new Error(`Node "${startNode instanceof Node ? startNode.type : startNode.tokenType.name}" has no location info`);
+        }
+        else if (endOffset === undefined) {
+            throw new Error(`Node "${lastNode instanceof Node ? lastNode.type : lastNode.tokenType.name}" has no location info`);
+        }
+        let location = [startOffset, startLine, startColumn, endOffset, endLine, endColumn];
+        return location;
+    }
+    getRulesWithComments(existingRules = [], nextTokenLocation) {
+        if (!nextTokenLocation) {
+            nextTokenLocation = this.getLocationInfo(this.LA(1));
+        }
+        let rules = [];
+        /**
+         * @todo - I think this pattern means that comments after
+         * the last rule will be tossed out, so we need to figure
+         * out a way to get comments when comments are the only
+         * content in a file.
+         */
+        // let rule: Node | undefined
+        const processPrePost = (prePost) => {
+            if (isArray(prePost)) {
+                // Build a new remainder array while moving comment nodes to top-level rules
+                const remainder = [];
+                for (let i = 0; i < prePost.length; i++) {
+                    const item = prePost[i];
+                    if (item instanceof Node) {
+                        // Attach immediately preceding whitespace (if any) to the comment
+                        const prev = remainder.length > 0 ? remainder[remainder.length - 1] : undefined;
+                        if (typeof prev === 'string') {
+                            item.pre = [prev];
+                            remainder.pop();
+                        }
+                        // Attach immediately following whitespace (if any) to comment.post
+                        const next = prePost[i + 1];
+                        if (typeof next === 'string') {
+                            item.post = [next];
+                            i++; // consume the following whitespace
+                        }
+                        rules.push(item);
+                    }
+                    else {
+                        remainder.push(item);
+                    }
+                }
+                return remainder.length === 0 ? 0 : remainder;
+            }
+            return prePost;
+        };
+        for (let rule of existingRules) {
+            if (rule.pre === undefined) {
+                let pre = this.getPrePost(rule.location[0]);
+                const processed = processPrePost(pre);
+                rule.pre = processed;
+            }
+            rules.push(rule);
+        }
+        // Do not mutate lastRule.post here; lift only at tail capture time to avoid duplication/newlines.
+        // Then capture any remaining EOF tail via preSkipped at LA(1).startOffset.
+        const tail = this.getPrePost(nextTokenLocation[0]);
+        const remainder = processPrePost(tail);
+        let returnRules = new Rules(rules, undefined, rules.length ? this.getLocationFromNodes(rules) : undefined, this.context);
+        returnRules.post = remainder;
+        return returnRules;
+    }
+    getPrePost(offset, post, ctx) {
+        let skipped = post ? this.postSkippedTokenMap.get(offset) : this.preSkippedTokenMap.get(offset);
+        if (!skipped) {
+            return 0;
+        }
+        if (this.usedSkippedTokens.has(skipped)) {
+            return 0;
+        }
+        this.usedSkippedTokens.add(skipped);
+        let pre = skipped.map((token) => {
+            let name = token.tokenType.name;
+            if (name === 'WS') {
+                return token.image;
+            }
+            else {
+                const comment = new Comment(token.image, { lineComment: name.includes('Line') }, this.getLocationInfo(token), this.context);
+                if (ctx?.inCustomPropertyValue && comment.options.lineComment) {
+                    comment.addFlag(F_VISIBLE);
+                }
+                return comment;
+            }
+        });
+        if (pre.length === 1 && pre[0] === ' ') {
+            pre = 1;
+        }
+        return pre;
+    }
+    /**
+     * Attaches pre / post whitespace and comments.
+     * Note that nodes can be wrapped more than once.
+     *
+     * @note Some nodes can't be wrapped because they
+     * don't represent a location. For instance, a
+     * Rules node may be empty, and hence doesn't
+     * have a location.
+     */
+    wrap(node, post, ctx) {
+        if (!(node instanceof Node)) {
+            return node;
+        }
+        // let skipValidations = this.skipValidations
+        if (post) {
+            if (node.post === undefined) {
+                let offset = node.location[3];
+                if (offset !== undefined) {
+                    node.post = this.getPrePost(offset, true, ctx);
+                    // throw new Error(`Node "${node.type}" can't be wrapped`)
+                }
+            }
+            if (post !== 'both') {
+                return node;
+            }
+        }
+        if ((!post || post === 'both')) {
+            // Always record pre for a node, but if it is the leading child
+            // of a parent that will itself own pre (e.g., first selector in a qualified rule),
+            // allow callers to reassign this pre to the parent Rules/Ruleset.
+            let offset = node.location[0];
+            if (offset !== undefined && node.pre === undefined) {
+                const pre = this.getPrePost(offset, false, ctx);
+                // Narrow to allowed type: Array<Comment | Nil | string> | 1 | 0 | undefined
+                node.pre = pre;
+            }
+        }
+        return node;
+    }
+    processValueToken(token, _ctx) {
+        let tokValue = token.image;
+        let tokType = token.tokenType;
+        let tokName = tokType.name;
+        let T = this.T;
+        let dimValue;
+        let numValue;
+        const getDimension = (finalValue) => new Dimension(finalValue, undefined, this.getLocationInfo(token), this.context);
+        const getNumber = (finalValue) => new Num(finalValue, undefined, this.getLocationInfo(token), this.context);
+        let result;
+        if (tokenMatcher(token, T.Ident)) {
+            // Check if it's a color keyword
+            const colorKey = tokValue.toLowerCase();
+            if (colorKey === 'transparent') {
+                result = new Color({
+                    node: 'transparent',
+                    rgb: [0, 0, 0],
+                    alpha: 0
+                }, { format: ColorFormat.HEX }, this.getLocationInfo(token), this.context);
+            }
+            else if (colors[colorKey]) {
+                // Create a Color node with the keyword data
+                const colorValue = colors[colorKey];
+                const colorNode = new Color({
+                    node: tokValue, // Store the original keyword string
+                    rgb: colorValue,
+                    alpha: 1
+                }, { format: ColorFormat.HEX }, this.getLocationInfo(token), this.context);
+                result = colorNode;
+            }
+            else {
+                // In value position, treat as a generic identifier
+                result = new Any(tokValue, { role: 'ident' }, this.getLocationInfo(token), this.context);
+            }
+        }
+        else if (tokenMatcher(token, T.Dimension)) {
+            dimValue = { number: parseFloat(token.payload[0]), unit: token.payload[1] };
+            result = getDimension(dimValue);
+        }
+        else if (tokName === 'MathConstant') {
+            switch (tokValue.toLowerCase()) {
+                case 'pi':
+                    numValue = Math.PI;
+                    break;
+                case 'infinity':
+                    numValue = Infinity;
+                    break;
+                case '-infinity':
+                    numValue = -Infinity;
+                    break;
+                case 'e':
+                    numValue = Math.E;
+                    break;
+                case 'nan':
+                    numValue = NaN;
+            }
+            result = getNumber(numValue);
+        }
+        else if (tokenMatcher(token, T.Number)) {
+            numValue = parseFloat(tokValue);
+            result = getNumber(numValue);
+        }
+        else if (tokenMatcher(token, T.Color)) {
+            result = new Color(tokValue, undefined, this.getLocationInfo(token), this.context);
+        }
+        else {
+            result = new Any(tokValue, { type: token.tokenType.name }, this.getLocationInfo(token), this.context);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=cssActionsParser.js.map

package/lib/cssActionsParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cssActionsParser.js","sourceRoot":"","sources":["../src/cssActionsParser.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,YAAY,EAEb,MAAM,YAAY,CAAC;AAEpB,0DAA0D;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAEL,IAAI,EACJ,OAAO,EACP,SAAS,EACT,KAAK,EACL,WAAW,EACX,SAAS,EACT,GAAG,EACH,KAAK,EACL,GAAG,EAEJ,MAAM,eAAe,CAAC;AACvB,OAAO,MAAM,MAAM,YAAY,CAAC;AAEhC,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;AA6B1B;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,gBAAiB,SAAQ,qBAAqB;IACzD,CAAC,CAAW;IACZ,UAAU,CAAU;IACpB,SAAS,GAAG,CAAC,CAAC;IAMd,kEAAkE;IAClE,UAAU,CAAiD;IAC3D,IAAI,CAAQ;IACZ,aAAa,CAAQ;IACrB,MAAM,CAAQ;IACd,YAAY,CAAQ;IACpB,eAAe,CAAQ;IACvB,qBAAqB,CAAQ;IAC7B,aAAa,CAAQ;IACrB,UAAU,CAAQ;IAClB,cAAc,CAAQ;IACtB,iBAAiB,CAAQ;IACzB,QAAQ,CAAQ;IAChB,eAAe,CAAQ;IACvB,cAAc,CAAQ;IACtB,gBAAgB,CAAQ;IACxB,gBAAgB,CAAQ;IAExB,WAAW,CAAQ;IACnB,SAAS,CAAQ;IACjB,uCAAuC;IACvC,aAAa,CAAQ;IACrB,KAAK,CAAQ;IACb,WAAW,CAAQ;IACnB,WAAW,CAAQ;IACnB,gBAAgB,CAAQ;IAExB,YAAY,CAAQ;IACpB,gBAAgB,CAAQ;IACxB,gBAAgB,CAAQ;IACxB,UAAU,CAAQ;IAClB,cAAc,CAAQ;IACtB,cAAc,CAAQ;IACtB,WAAW,CAAQ;IACnB,YAAY,CAAQ;IACpB,WAAW,CAAQ;IACnB,YAAY,CAAQ;IACpB,MAAM,CAAQ;IAEd,mBAAmB;IACnB,SAAS;IACT,OAAO,CAAQ;IACf,WAAW,CAAQ;IACnB,SAAS,CAAQ;IACjB,SAAS,CAAQ;IAEjB,eAAe;IACf,WAAW,CAAQ;IACnB,YAAY,CAAQ;IACpB,aAAa,CAAQ;IACrB,cAAc,CAAQ;IACtB,WAAW,CAAQ;IACnB,cAAc,CAAQ;IACtB,eAAe,CAAQ;IACvB,aAAa,CAAQ;IACrB,kBAAkB,CAAQ;IAC1B,cAAc,CAAQ;IACtB,kBAAkB,CAAQ;IAC1B,iBAAiB,CAAQ;IACzB,gBAAgB,CAAQ;IACxB,YAAY,CAAQ;IACpB,WAAW,CAAQ;IACnB,UAAU,CAAQ;IAClB,UAAU,CAAQ;IAClB,eAAe,CAAQ;IACvB,aAAa,CAAQ;IACrB,WAAW,CAAQ;IACnB,SAAS,CAAQ;IACjB,WAAW,CAAQ;IACnB,cAAc,CAAQ;IACtB,YAAY,CAAQ;IACpB,cAAc,CAAQ;IACtB,YAAY,CAAQ;IACpB,eAAe,CAAQ;IACvB,aAAa,CAAQ;IAErB,sBAAsB;IACtB,cAAc,CAAQ;IACtB,UAAU,CAAQ;IAClB,cAAc,CAAQ;IACtB,SAAS,CAAQ;IACjB,uBAAuB,CAAQ;IAC/B,QAAQ,CAAQ;IAChB,aAAa,CAAQ;IACrB,QAAQ,CAAQ;IAChB,OAAO,CAAQ;IACf,YAAY,CAAQ;IAEpB,OAAO,CAAQ;IACf,UAAU,CAAQ;IAClB,YAAY,CAAQ;IACpB,oBAAoB,CAAQ;IAE5B,mDAAmD;IAEnD;;;;MAIE;IACF,iBAAiB,CAAQ;IACzB,gBAAgB,CAAQ;IAExB,+BAA+B;IAC/B,aAAa,CAAQ;IACrB,aAAa,CAAQ;IACrB,WAAW,CAAQ;IACnB,WAAW,CAAQ;IAEnB,YACE,eAAgC,EAChC,CAAW,EACX,SAA0B,EAAE;QAE5B,MAAM,aAAa,GAAoB;YACrC,YAAY,EAAE,CAAC;YACf,iBAAiB,EAAE,IAAI,uBAAuB,CAAC;YAC7C,6BAA6B;YAC7B,eAAe;aAChB,CAAC;SACH,CAAC;QAEF,MAAM,EAAE,UAAU,GAAG,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,aAAa,EAAE,GAAG,MAAM,EAAE,CAAC;QAEvE,KAAK,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;QAE7B,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAE7B,KAAK,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YACrD,IAAI,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACvB,CAAC;QAED,IAAI,IAAI,CAAC,WAAW,KAAK,gBAAgB,EAAE,CAAC;YAC1C,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,KAAe;QACvB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;IACtB,CAAC;IAES,oBAAoB,CAAC,KAA2B;QACxD,IAAI,SAAS,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QAC1B,IAAI,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;QACxC,IAAI,WAAmB,CAAC;QACxB,IAAI,SAAiB,CAAC;QACtB,IAAI,WAAmB,CAAC;QACxB,IAAI,SAAiB,CAAC;QACtB,IAAI,OAAe,CAAC;QACpB,IAAI,SAAiB,CAAC;QAEtB,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,SAAS,YAAY,IAAI,EAAE,CAAC;YAC9B,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,GAAG,SAAS,CAAC,QAAwB,CAAC,CAAC;QAC/E,CAAC;aAAM,CAAC;YACN,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,SAA6B,CAAC,CAAC;QAC5E,CAAC;QAED,IAAI,QAAQ,YAAY,IAAI,EAAE,CAAC;YAC7B,CAAC,CAAC,EAAC,EAAC,EAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,QAAwB,CAAC,CAAC;QAC3E,CAAC;aAAM,CAAC;YACN,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,QAA4B,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,SAAS,SAAS,YAAY,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,wBAAwB,CAAC,CAAC;QAC1H,CAAC;aAAM,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,SAAS,QAAQ,YAAY,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,wBAAwB,CAAC,CAAC;QACvH,CAAC;QACD,IAAI,QAAQ,GAAiB,CAAC,WAAW,EAAE,SAAU,EAAE,WAAY,EAAE,SAAS,EAAE,OAAQ,EAAE,SAAU,CAAC,CAAC;QACtG,OAAO,QAAQ,CAAC;IAClB,CAAC;IAES,oBAAoB,CAC5B,gBAAwB,EAAE,EAC1B,iBAAgC;QAEhC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,iBAAiB,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,KAAK,GAAG,EAAE,CAAC;QACf;;;;;WAKG;QACH,6BAA6B;QAE7B,MAAM,cAAc,GAAG,CAAC,OAAoB,EAAE,EAAE;YAC9C,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACrB,4EAA4E;gBAC5E,MAAM,SAAS,GAAyB,EAAE,CAAC;gBAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACxC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;oBACzB,IAAI,IAAI,YAAY,IAAI,EAAE,CAAC;wBACzB,kEAAkE;wBAClE,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;wBAChF,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;4BAC7B,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;4BAClB,SAAS,CAAC,GAAG,EAAE,CAAC;wBAClB,CAAC;wBACD,mEAAmE;wBACnE,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;wBAC5B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;4BAC5B,IAAY,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;4BAC5B,CAAC,EAAE,CAAC,CAAC,mCAAmC;wBAC1C,CAAC;wBACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACnB,CAAC;yBAAM,CAAC;wBACN,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACvB,CAAC;gBACH,CAAC;gBACD,OAAO,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAChD,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC;QAEF,KAAK,IAAI,IAAI,IAAI,aAAa,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;gBAC3B,IAAI,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC;gBAC7C,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAsD,CAAC;gBAC3F,IAAI,CAAC,GAAG,GAAG,SAAS,CAAC;YACvB,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QACD,kGAAkG;QAClG,2EAA2E;QAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAE,CAAC,CAAC;QACpD,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAsD,CAAC;QAC5F,IAAI,WAAW,GAAU,IAAI,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAChI,WAAW,CAAC,IAAI,GAAG,SAAS,CAAC;QAC7B,OAAO,WAAW,CAAC;IACrB,CAAC;IAES,UAAU,CAAC,MAAc,EAAE,IAAc,EAAE,GAAiB;QACpE,IAAI,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChG,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACxC,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEpC,IAAI,GAAG,GAAgB,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YAC3C,IAAI,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC;YAChC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,OAAO,KAAK,CAAC,KAAK,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACN,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC5H,IAAI,GAAG,EAAE,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;oBAC9D,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBAC7B,CAAC;gBACD,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACvC,GAAG,GAAG,CAAC,CAAC;QACV,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;;;;OAQG;IACO,IAAI,CAAwB,IAAO,EAAE,IAAuB,EAAE,GAAiB;QACvF,IAAI,CAAC,CAAC,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,6CAA6C;QAC7C,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC5B,IAAI,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAC9B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;oBAC/C,0DAA0D;gBAC5D,CAAC;YACH,CAAC;YACD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBACpB,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,KAAK,MAAM,CAAC,EAAE,CAAC;YAC/B,+DAA+D;YAC/D,mFAAmF;YACnF,kEAAkE;YAClE,IAAI,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC9B,IAAI,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;gBACnD,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;gBAChD,4EAA4E;gBAC5E,IAAI,CAAC,GAAG,GAAG,GAAU,CAAC;YACxB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAES,iBAAiB,CACzB,KAAa,EACb,IAAkB;QAElB,IAAI,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC;QAC3B,IAAI,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC;QAC9B,IAAI,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;QAC3B,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QACf,IAAI,QAAuD,CAAC;QAC5D,IAAI,QAA4B,CAAC;QACjC,MAAM,YAAY,GAAG,CAAC,UAA+C,EAAE,EAAE,CACvE,IAAI,SAAS,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAClF,MAAM,SAAS,GAAG,CAAC,UAAkB,EAAE,EAAE,CACvC,IAAI,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAE5E,IAAI,MAAY,CAAC;QACjB,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,gCAAgC;YAChC,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;YACxC,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;gBAC/B,MAAM,GAAG,IAAI,KAAK,CAChB;oBACE,IAAI,EAAE,aAAa;oBACnB,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;oBACd,KAAK,EAAE,CAAC;iBACT,EACD,EAAE,MAAM,EAAE,WAAW,CAAC,GAAG,EAAE,EAC3B,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAC3B,IAAI,CAAC,OAAO,CACb,CAAC;YACJ,CAAC;iBAAM,IAAI,MAAM,CAAC,QAA+B,CAAC,EAAE,CAAC;gBACnD,4CAA4C;gBAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,QAA+B,CAAC,CAAC;gBAC3D,MAAM,SAAS,GAAG,IAAI,KAAK,CACzB;oBACE,IAAI,EAAE,QAAQ,EAAE,oCAAoC;oBACpD,GAAG,EAAE,UAAU;oBACf,KAAK,EAAE,CAAC;iBACT,EACD,EAAE,MAAM,EAAE,WAAW,CAAC,GAAG,EAAE,EAC3B,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAC3B,IAAI,CAAC,OAAO,CACb,CAAC;gBACF,MAAM,GAAG,SAAS,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACN,mDAAmD;gBACnD,MAAM,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAC3F,CAAC;QACH,CAAC;aAAM,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5C,QAAQ,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5E,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC;aAAM,IAAI,OAAO,KAAK,cAAc,EAAE,CAAC;YACtC,QAAQ,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC/B,KAAK,IAAI;oBACP,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC;oBACnB,MAAM;gBACR,KAAK,UAAU;oBACb,QAAQ,GAAG,QAAQ,CAAC;oBACpB,MAAM;gBACR,KAAK,WAAW;oBACd,QAAQ,GAAG,CAAC,QAAQ,CAAC;oBACrB,MAAM;gBACR,KAAK,GAAG;oBACN,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC;oBAClB,MAAM;gBACR,KAAK,KAAK;oBACR,QAAQ,GAAG,GAAG,CAAC;YACnB,CAAC;YACD,MAAM,GAAG,SAAS,CAAC,QAAS,CAAC,CAAC;QAChC,CAAC;aAAM,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;YACzC,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YAChC,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC/B,CAAC;aAAM,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YACxC,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACrF,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACxG,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/lib/cssErrorMessageProvider.d.ts

@@ -0,0 +1,14 @@
+import { type IParserErrorMessageProvider } from 'chevrotain';
+export declare class CssErrorMessageProvider implements IParserErrorMessageProvider {
+    buildMismatchTokenMessage(options: Parameters<IParserErrorMessageProvider['buildMismatchTokenMessage']>[0]): string;
+    buildNotAllInputParsedMessage(options: Parameters<IParserErrorMessageProvider['buildNotAllInputParsedMessage']>[0]): string;
+    /**
+     * This error message needs to be reduced, because the lookahead strategy
+     * can generate thousands of possible paths.
+     *
+     * @todo - we may be able to eliminate this by addressing all ambiguity in the parser
+     * from chevrotain-allstar
+     */
+    buildNoViableAltMessage(options: Parameters<IParserErrorMessageProvider['buildNoViableAltMessage']>[0]): string;
+    buildEarlyExitMessage(options: Parameters<IParserErrorMessageProvider['buildEarlyExitMessage']>[0]): string;
+}

package/lib/cssErrorMessageProvider.js

@@ -0,0 +1,40 @@
+import { defaultParserErrorProvider } from 'chevrotain';
+const camelToSpaces = (str) => str.replace(/([A-Z])/g, ' $1').toLowerCase();
+export class CssErrorMessageProvider {
+    buildMismatchTokenMessage(options) {
+        return defaultParserErrorProvider.buildMismatchTokenMessage(options);
+    }
+    buildNotAllInputParsedMessage(options) {
+        return defaultParserErrorProvider.buildNotAllInputParsedMessage(options);
+    }
+    /**
+     * This error message needs to be reduced, because the lookahead strategy
+     * can generate thousands of possible paths.
+     *
+     * @todo - we may be able to eliminate this by addressing all ambiguity in the parser
+     * from chevrotain-allstar
+     */
+    buildNoViableAltMessage(options) {
+        const initialTokens = [];
+        options.expectedPathsPerAlt.forEach((expectedPath) => {
+            expectedPath.forEach((path) => {
+                let pathStr = path[0]?.name;
+                if (path && !initialTokens.includes(pathStr)) {
+                    initialTokens.push(pathStr);
+                }
+            });
+        });
+        const firstOfTokens = initialTokens.slice(0, 4);
+        const rest = initialTokens.slice(5);
+        let err = `Error in ${camelToSpaces(options.ruleName)}: Expected '${firstOfTokens.join(`', '`)}' `;
+        if (rest.length > 0) {
+            err += `(and ${rest.length} more) `;
+        }
+        err += `but found '${options.actual[0].image}'`;
+        return err;
+    }
+    buildEarlyExitMessage(options) {
+        return `Expected a ${camelToSpaces(options.ruleName)}, but found '${options.actual[0].image}'`;
+    }
+}
+//# sourceMappingURL=cssErrorMessageProvider.js.map

package/lib/cssErrorMessageProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cssErrorMessageProvider.js","sourceRoot":"","sources":["../src/cssErrorMessageProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAEpB,MAAM,aAAa,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;AAEpF,MAAM,OAAO,uBAAuB;IAClC,yBAAyB,CACvB,OAAgF;QAEhF,OAAO,0BAA0B,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACvE,CAAC;IAED,6BAA6B,CAC3B,OAAoF;QAEpF,OAAO,0BAA0B,CAAC,6BAA6B,CAAC,OAAO,CAAC,CAAC;IAC3E,CAAC;IAED;;;;;;OAMG;IACH,uBAAuB,CACrB,OAA8E;QAE9E,MAAM,aAAa,GAAa,EAAE,CAAC;QACnC,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE;YACnD,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;gBAC5B,IAAI,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;gBAC5B,IAAI,IAAI,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAQ,CAAC,EAAE,CAAC;oBAC9C,aAAa,CAAC,IAAI,CAAC,OAAQ,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,MAAM,aAAa,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpC,IAAI,GAAG,GAAG,YAAY,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAe,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QACnG,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,GAAG,IAAI,QAAQ,IAAI,CAAC,MAAM,SAAS,CAAC;QACtC,CAAC;QACD,GAAG,IAAI,cAAc,OAAO,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,KAAK,GAAG,CAAC;QACjD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,qBAAqB,CACnB,OAA4E;QAE5E,OAAO,cAAc,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,KAAK,GAAG,CAAC;IAClG,CAAC;CACF"}

package/lib/cssParser.d.ts

@@ -1,106 +1,39 @@
-import { TokenType, IParserConfig, BaseParser, IRuleConfig, IToken } from 'chevrotain';
-import { EmbeddedActionsParser } from 'chevrotain';
-import { TokenMap } from './util';
-export type { IToken };
-export declare type Rule<T extends any = any> = (idxInCallingRule?: number, ...args: any[]) => T;
+import { Lexer } from 'chevrotain';
+import { type CssParserConfig, CssActionsParser } from './cssActionsParser.js';
+import type { ConditionalPick } from 'type-fest';
+import { type Node, type Rules, type IParseResult } from '@jesscss/core';
+export type CssRules = keyof ConditionalPick<CssActionsParser, () => Node>;
+export type SyntacticContentAssistSuggestion = {
+    nextTokenType: string;
+    nextTokenLabel?: string;
+    ruleStack: string[];
+    occurrenceStack: number[];
+};
 /**
- * CST structure as follows
- *
- * @example
- * ```
- * {
- *   name: 'root'
- *   children: [
- *     {
- *       name: 'AtRule',
- *       children: [...]
- *       location: {...}
- *     },
- *     {
- *       name: 'WS',
- *       value: '\n',
- *       location: {...}
- *     }
- *   ]
- *   location: {...}
- * }
- * ```
+ * If we're not extending the CSS parser,
+ * this is the friendlier interface for returning
+ * a CST, as it assigns tokens to the parser automatically.
  */
-export declare type ILocationInfo = {
-    startOffset: number;
-    startLine: number;
-    startColumn: number;
-    endOffset: number;
-    endLine: number;
-    endColumn: number;
-};
-export declare type CstChild = CstNode | IToken;
-export declare type CstNode = {
-    name: string;
-    children: CstChild[];
-    location?: ILocationInfo;
-};
-export declare class CssParser extends EmbeddedActionsParser {
-    T: TokenMap;
-    _: Function;
-    option: BaseParser['option'];
-    consume: BaseParser['consume'];
-    /** Productions */
-    root: Rule<CstNode>;
-    primary: Rule;
-    rule: Rule;
-    atRule: Rule;
-    knownAtRule: Rule;
-    unknownAtRule: Rule;
-    atImport: Rule;
-    atMedia: Rule;
-    atSupports: Rule;
-    atNested: Rule;
-    atNonNested: Rule;
-    /** @media */
-    mediaQueryList: Rule;
-    mediaQuery: Rule;
-    mediaCondition: Rule;
-    mediaFeature: Rule;
-    mediaAnd: Rule;
-    /** blocks */
-    qualifiedRule: Rule;
-    testQualifiedRule: Rule;
-    testQualifiedRuleExpression: Rule;
-    block: Rule;
-    curlyBlock: Rule;
-    customBlock: Rule;
-    customPreludeBlock: Rule;
-    /** Selector rules */
-    selectorList: Rule;
-    complexSelector: Rule;
-    combinatorSelector: Rule;
-    compoundSelector: Rule;
-    simpleSelector: Rule;
-    pseudoSelector: Rule;
-    attrSelector: Rule;
-    attrIdent: Rule;
-    nameSelector: Rule;
-    /** declarations */
-    declaration: Rule;
-    customDeclaration: Rule;
-    property: Rule;
-    customProperty: Rule;
-    /** expressions */
-    expressionList: Rule;
-    expression: Rule;
-    /** values */
-    value: Rule;
-    atomicValue: Rule;
-    customValue: Rule;
-    customPrelude: Rule;
-    customValueOrSemi: Rule;
-    anyToken: Rule;
-    extraTokens: Rule;
-    protected currIdx: number;
-    constructor(tokens: TokenType[], T: TokenMap, config?: IParserConfig);
-    /** Capture location information for CST nodes */
-    CAPTURE(func: () => any): any;
-    protected RULE<T>(name: string, impl: (...implArgs: any[]) => T, config?: IRuleConfig<T>): (idxInCallingRule?: number, ...args: any[]) => any;
-    protected OVERRIDE_RULE<T>(name: string, impl: (...implArgs: any[]) => T, config?: IRuleConfig<T>): (idxInCallingRule?: number, ...args: any[]) => any;
+export declare class CssParser {
+    lexer: Lexer;
+    parser: CssActionsParser;
+    /**
+     * @note `recoveryEnabled` should be set to true for
+     * linting and language services.
+     */
+    constructor(config?: CssParserConfig);
+    parse(text: string): IParseResult<Rules>;
+    parse(text: string, rule: 'stylesheet'): IParseResult<Rules>;
+    parse(text: string, rule?: CssRules): 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?: CssRules;
+    }): SyntacticContentAssistSuggestion[];
 }