@tbela99/css-parser 0.5.4 → 0.7.0

package/dist/lib/validation/parser/parse.js

@@ -0,0 +1,16 @@
+import { ValidationTokenEnum } from './types.js';
+import '../../ast/types.js';
+import '../../ast/minify.js';
+import '../../parser/parse.js';
+import '../../parser/utils/config.js';
+import '../../renderer/color/utils/constants.js';
+import '../../renderer/sourcemap/lib/encode.js';
+
+[
+    ValidationTokenEnum.Star,
+    ValidationTokenEnum.HashMark,
+    ValidationTokenEnum.AtLeastOnce,
+    ValidationTokenEnum.Exclamation,
+    ValidationTokenEnum.QuestionMark,
+    ValidationTokenEnum.OpenCurlyBrace
+];

package/dist/lib/validation/parser/types.js

@@ -0,0 +1,39 @@
+var ValidationTokenEnum;
+(function (ValidationTokenEnum) {
+    ValidationTokenEnum[ValidationTokenEnum["Root"] = 0] = "Root";
+    ValidationTokenEnum[ValidationTokenEnum["Keyword"] = 1] = "Keyword";
+    ValidationTokenEnum[ValidationTokenEnum["PropertyType"] = 2] = "PropertyType";
+    ValidationTokenEnum[ValidationTokenEnum["DeclarationType"] = 3] = "DeclarationType";
+    ValidationTokenEnum[ValidationTokenEnum["AtRule"] = 4] = "AtRule";
+    ValidationTokenEnum[ValidationTokenEnum["ValidationFunctionDefinition"] = 5] = "ValidationFunctionDefinition";
+    ValidationTokenEnum[ValidationTokenEnum["OpenBracket"] = 6] = "OpenBracket";
+    ValidationTokenEnum[ValidationTokenEnum["CloseBracket"] = 7] = "CloseBracket";
+    ValidationTokenEnum[ValidationTokenEnum["OpenParenthesis"] = 8] = "OpenParenthesis";
+    ValidationTokenEnum[ValidationTokenEnum["CloseParenthesis"] = 9] = "CloseParenthesis";
+    ValidationTokenEnum[ValidationTokenEnum["Comma"] = 10] = "Comma";
+    ValidationTokenEnum[ValidationTokenEnum["Pipe"] = 11] = "Pipe";
+    ValidationTokenEnum[ValidationTokenEnum["Column"] = 12] = "Column";
+    ValidationTokenEnum[ValidationTokenEnum["Star"] = 13] = "Star";
+    ValidationTokenEnum[ValidationTokenEnum["OpenCurlyBrace"] = 14] = "OpenCurlyBrace";
+    ValidationTokenEnum[ValidationTokenEnum["CloseCurlyBrace"] = 15] = "CloseCurlyBrace";
+    ValidationTokenEnum[ValidationTokenEnum["HashMark"] = 16] = "HashMark";
+    ValidationTokenEnum[ValidationTokenEnum["QuestionMark"] = 17] = "QuestionMark";
+    ValidationTokenEnum[ValidationTokenEnum["Function"] = 18] = "Function";
+    ValidationTokenEnum[ValidationTokenEnum["Number"] = 19] = "Number";
+    ValidationTokenEnum[ValidationTokenEnum["Whitespace"] = 20] = "Whitespace";
+    ValidationTokenEnum[ValidationTokenEnum["Parenthesis"] = 21] = "Parenthesis";
+    ValidationTokenEnum[ValidationTokenEnum["Bracket"] = 22] = "Bracket";
+    ValidationTokenEnum[ValidationTokenEnum["AtLeastOnce"] = 23] = "AtLeastOnce";
+    ValidationTokenEnum[ValidationTokenEnum["Separator"] = 24] = "Separator";
+    ValidationTokenEnum[ValidationTokenEnum["Exclamation"] = 25] = "Exclamation";
+    ValidationTokenEnum[ValidationTokenEnum["Ampersand"] = 26] = "Ampersand";
+    ValidationTokenEnum[ValidationTokenEnum["PipeToken"] = 27] = "PipeToken";
+    ValidationTokenEnum[ValidationTokenEnum["ColumnToken"] = 28] = "ColumnToken";
+    ValidationTokenEnum[ValidationTokenEnum["AmpersandToken"] = 29] = "AmpersandToken";
+    ValidationTokenEnum[ValidationTokenEnum["Parens"] = 30] = "Parens";
+    ValidationTokenEnum[ValidationTokenEnum["PseudoClassToken"] = 31] = "PseudoClassToken";
+    ValidationTokenEnum[ValidationTokenEnum["PseudoClassFunctionToken"] = 32] = "PseudoClassFunctionToken";
+    ValidationTokenEnum[ValidationTokenEnum["StringToken"] = 33] = "StringToken";
+})(ValidationTokenEnum || (ValidationTokenEnum = {}));
+
+export { ValidationTokenEnum };

package/dist/lib/validation/selector.js

@@ -0,0 +1,459 @@
+import { EnumToken, ValidationLevel } from '../ast/types.js';
+import '../ast/minify.js';
+import '../parser/parse.js';
+import '../renderer/color/utils/constants.js';
+import '../renderer/sourcemap/lib/encode.js';
+import '../parser/utils/config.js';
+import { getConfig } from './config.js';
+
+const expressions = [
+    EnumToken.DelimTokenType, EnumToken.IncludeMatchTokenType, EnumToken.DashMatchTokenType,
+    EnumToken.StartMatchTokenType, EnumToken.EndMatchTokenType, EnumToken.ContainMatchTokenType
+];
+const selectorTokens = [
+    EnumToken.IdenTokenType, EnumToken.ClassSelectorTokenType, EnumToken.AttrTokenType,
+    EnumToken.PseudoClassTokenType, EnumToken.PseudoClassFuncTokenType, EnumToken.HashTokenType,
+    EnumToken.UniversalSelectorTokenType
+];
+const combinatorTokens = [
+    EnumToken.ChildCombinatorTokenType, EnumToken.NextSiblingCombinatorTokenType,
+    EnumToken.SubsequentSiblingCombinatorTokenType
+];
+function validateSelector(selector, options, root) {
+    if (selector.length == 0) {
+        return {
+            valid: ValidationLevel.Drop,
+            node: null,
+            error: 'The selector is empty.'
+        };
+    }
+    return doValidateSelector(selector, options, root);
+}
+function doValidateSelector(selector, options, root) {
+    let result;
+    if (combinatorTokens.includes(selector[0].typ)) {
+        if (root == null || root.typ == EnumToken.StyleSheetNodeType) {
+            return {
+                valid: ValidationLevel.Drop,
+                node: null,
+                error: 'The selector cannot start with a combinator.'
+            };
+        }
+        selector = selector.slice(1);
+    }
+    while ((selector?.length ?? 0) > 0) {
+        result = validateSimpleSelector(selector, options, root);
+        if (result.valid == ValidationLevel.Drop) {
+            return {
+                valid: ValidationLevel.Drop,
+                node: result.nodes[0] ?? null,
+                error: result.error
+            };
+        }
+        if (result.nodes.length == 0) {
+            return {
+                valid: result.valid,
+                node: result.nodes[0] ?? null,
+                error: result.error
+            };
+        }
+        selector = result.nodes;
+        result = validateCombinator(selector);
+        if (result.valid == ValidationLevel.Drop) {
+            while (result.valid == ValidationLevel.Drop && selector.length > 0) {
+                if (selector[0].typ == EnumToken.CommaTokenType) {
+                    selector = consumeWhitespace(selector.slice(1));
+                    if (selector.length == 0) {
+                        return {
+                            valid: ValidationLevel.Drop,
+                            node: selector[0],
+                            error: 'unexpected token'
+                        };
+                    }
+                    if (selector.length > 0 && combinatorTokens.includes(selector[0].typ)) {
+                        if (root == null || root.typ == EnumToken.StyleSheetNodeType) {
+                            return {
+                                valid: ValidationLevel.Drop,
+                                node: selector[0],
+                                error: 'Unexpected token'
+                            };
+                        }
+                        selector = selector.slice(1);
+                    }
+                    result = validateSimpleSelector(selector, options, root);
+                    if (result.valid == ValidationLevel.Drop) {
+                        return {
+                            valid: ValidationLevel.Drop,
+                            node: null,
+                            error: 'Invalid selector'
+                        };
+                    }
+                    if (result.nodes.length == 0) {
+                        return {
+                            valid: result.valid,
+                            node: null,
+                            error: result.error
+                        };
+                    }
+                    selector = result.nodes;
+                    result = validateCombinator(selector);
+                    if (result.nodes.length == 0) {
+                        return {
+                            valid: result.valid,
+                            node: null,
+                            error: result.error
+                        };
+                    }
+                    selector = result.nodes;
+                }
+                else {
+                    break;
+                }
+            }
+        }
+        else {
+            selector = result.nodes;
+        }
+    }
+    return {
+        valid: ValidationLevel.Valid,
+        node: null,
+        error: ''
+    };
+}
+function consumeWhitespace(selector) {
+    let i = 0;
+    while (i < selector.length &&
+        (selector[i].typ == EnumToken.WhitespaceTokenType ||
+            selector[i].typ == EnumToken.CommentTokenType)) {
+        i++;
+    }
+    return selector.slice(i);
+}
+function validateSimpleSelector(selector, options, root) {
+    let i = 0;
+    if (i >= selector.length) {
+        return {
+            valid: ValidationLevel.Valid,
+            nodes: selector.slice(i),
+            error: 'empty selector'
+        };
+    }
+    if (root?.typ == EnumToken.AtRuleNodeType && null != root.nam.match(/(-[a-zA-Z]+-)?keyframes/)) {
+        while (i < selector.length) {
+            if ([EnumToken.PercentageTokenType, EnumToken.CommentTokenType].includes(selector[i].typ)) {
+                i++;
+                continue;
+            }
+            if ((selector[i].typ == EnumToken.IdenTokenType && ['from', 'to'].includes(selector[i].val))) {
+                i++;
+                continue;
+            }
+            if (selector[i].typ == EnumToken.CommaTokenType) {
+                break;
+            }
+            return {
+                valid: ValidationLevel.Drop,
+                nodes: selector.slice(i),
+                error: 'invalid selector'
+            };
+        }
+        return {
+            valid: ValidationLevel.Valid,
+            nodes: selector.slice(i),
+            error: 'empty selector'
+        };
+    }
+    while (i < selector.length && [EnumToken.WhitespaceTokenType, EnumToken.CommentTokenType].includes(selector[i].typ)) {
+        i++;
+    }
+    if (i >= selector.length) {
+        return {
+            valid: ValidationLevel.Valid,
+            nodes: selector.slice(i),
+            error: 'empty selector'
+        };
+    }
+    if (selectorTokens.includes(selector[i].typ)) {
+        let result;
+        if (selector[i].typ == EnumToken.PseudoClassTokenType) {
+            result = validatePseudoClass(selector[i], options);
+            if (result.valid != ValidationLevel.Valid) {
+                return result;
+            }
+        }
+        if (selector[i].typ == EnumToken.PseudoClassFuncTokenType) {
+            result = validatePseudoClassFunction(selector[i], options);
+            if (result.valid != ValidationLevel.Valid) {
+                return result;
+            }
+        }
+        if (selector[i].typ == EnumToken.AttrTokenType) {
+            result = validateAttributeSelector(selector[i], options);
+            if (result.valid != ValidationLevel.Valid) {
+                return result;
+            }
+        }
+        return {
+            valid: ValidationLevel.Valid,
+            nodes: selector.slice(i + 1),
+            error: ''
+        };
+    }
+    if (selector[i].typ == EnumToken.LiteralTokenType && selector[i].val.startsWith('\\')) {
+        return {
+            valid: ValidationLevel.Valid,
+            nodes: selector.slice(i + 1),
+            error: ''
+        };
+    }
+    if (selector[i].typ == EnumToken.NestingSelectorTokenType && root != null && root.typ != EnumToken.StyleSheetNodeType) {
+        return {
+            valid: ValidationLevel.Valid,
+            nodes: selector.slice(i + 1),
+            error: 'Compound selector not allowed here'
+        };
+    }
+    return {
+        valid: ValidationLevel.Drop,
+        nodes: selector.slice(i + 1, 1),
+        error: 'unexpected token'
+    };
+}
+function validatePseudoClass(selector, options) {
+    const name = selector.val.slice(selector.val[1] == ':' ? 2 : 1);
+    if (name.match(/^-[a-zA-Z]+-/) || selector.val == ':before' || selector.val == ':after') {
+        return {
+            valid: ValidationLevel.Valid,
+            nodes: [selector],
+            error: ''
+        };
+    }
+    const config = getConfig();
+    const isValid = selector.val in config.selectors;
+    return {
+        valid: isValid || !options.validation ? ValidationLevel.Valid : ValidationLevel.Drop,
+        nodes: [selector],
+        error: isValid ? '' : 'invalid selector'
+    };
+}
+function validatePseudoClassFunction(selector, options) {
+    const name = selector.val.slice(1);
+    if (name.match(/^-[a-zA-Z]+-/)) {
+        const isValid = name == '-webkit-any' || name == '-moz-any';
+        return {
+            valid: isValid ? ValidationLevel.Valid : ValidationLevel.Drop,
+            nodes: [selector],
+            error: isValid ? '' : 'invalid pseudo class'
+        };
+    }
+    const config = getConfig();
+    if (selector.val in config.selectors) {
+        if (!('chi' in config.selectors[selector.val].ast[0])) {
+            return {
+                valid: !options.validation ? ValidationLevel.Valid : ValidationLevel.Drop,
+                nodes: [selector],
+                error: ''
+            };
+        }
+    }
+    else if (!(selector.val + '()' in config.selectors)) {
+        return {
+            valid: !options.validation ? ValidationLevel.Valid : ValidationLevel.Drop,
+            nodes: [selector],
+            error: ''
+        };
+    }
+    // TODO: validate params
+    return {
+        valid: ValidationLevel.Valid,
+        nodes: [selector],
+        error: ''
+    };
+}
+function validateAttributeSelector(selector, options) {
+    let i = 0;
+    let isMatchExpression = false;
+    let expression;
+    while (i < selector.chi.length) {
+        if ([EnumToken.WhitespaceTokenType, EnumToken.CommentTokenType].includes(selector.chi[i].typ)) {
+            i++;
+            continue;
+        }
+        if (EnumToken.IdenTokenType == selector.chi[i].typ ||
+            EnumToken.MatchExpressionTokenType == selector.chi[i].typ ||
+            EnumToken.NameSpaceAttributeTokenType == selector.chi[i].typ) {
+            isMatchExpression = EnumToken.MatchExpressionTokenType == selector.chi[i].typ;
+            if (isMatchExpression) {
+                expression = selector.chi[i];
+            }
+            if (EnumToken.NameSpaceAttributeTokenType == selector.chi[i].typ) {
+                if (selector.chi[i].r.typ != EnumToken.IdenTokenType) {
+                    return {
+                        valid: ValidationLevel.Drop,
+                        nodes: [selector],
+                        error: 'identifier expected'
+                    };
+                }
+                if (selector.chi[i].l != null) {
+                    // @ts-ignore
+                    if (selector.chi[i].l.typ != EnumToken.IdenTokenType &&
+                        // @ts-ignore
+                        selector.chi[i].l.typ != EnumToken.LiteralTokenType) {
+                        return {
+                            valid: ValidationLevel.Drop,
+                            nodes: [selector],
+                            error: 'invalid namespace prefix'
+                        };
+                    }
+                    if (
+                    // @ts-ignore
+                    selector.chi[i].l.typ == EnumToken.LiteralTokenType &&
+                        selector.chi[i].l.val != '*') {
+                        return {
+                            valid: ValidationLevel.Drop,
+                            nodes: [selector],
+                            error: 'exoected universal selector or namespace prefix'
+                        };
+                    }
+                }
+            }
+            i++;
+            break;
+        }
+        return {
+            valid: ValidationLevel.Drop,
+            nodes: [selector],
+            error: 'invalid selector'
+        };
+    }
+    if (!isMatchExpression) {
+        while (i < selector.chi.length) {
+            if ([EnumToken.WhitespaceTokenType, EnumToken.CommentTokenType].includes(selector.chi[i].typ)) {
+                i++;
+                continue;
+            }
+            break;
+        }
+        if (i < selector.chi.length) {
+            if (!expressions.includes(selector.chi[i].typ)) {
+                return {
+                    valid: ValidationLevel.Drop,
+                    nodes: [selector],
+                    error: 'invalid selector'
+                };
+            }
+            i++;
+            while (i < selector.chi.length) {
+                if ([EnumToken.WhitespaceTokenType, EnumToken.CommentTokenType].includes(selector.chi[i].typ)) {
+                    i++;
+                    continue;
+                }
+                break;
+            }
+            if (i >= selector.chi.length || ![EnumToken.IdenTokenType, EnumToken.StringTokenType].includes(selector.chi[i].typ)) {
+                return {
+                    valid: ValidationLevel.Drop,
+                    nodes: [selector],
+                    error: 'expected identifier or string'
+                };
+            }
+            i++;
+        }
+    }
+    else {
+        if (expression.l.typ != EnumToken.IdenTokenType ||
+            ![EnumToken.IdenTokenType, EnumToken.StringTokenType].includes(expression.r.typ) ||
+            !expressions.includes(expression.op)) {
+            return {
+                valid: ValidationLevel.Drop,
+                nodes: [selector],
+                error: 'expected identifier or string'
+            };
+        }
+    }
+    if (i < selector.chi.length) {
+        let hasWhitespace = false;
+        while (i < selector.chi.length) {
+            if ([EnumToken.WhitespaceTokenType, EnumToken.CommentTokenType].includes(selector.chi[i].typ)) {
+                if (!hasWhitespace) {
+                    hasWhitespace = selector.chi[i].typ == EnumToken.WhitespaceTokenType;
+                }
+                i++;
+                continue;
+            }
+            break;
+        }
+        // @ts-ignore
+        if (!hasWhitespace || i >= selector.chi.length || selector.chi[i].typ != EnumToken.IdenTokenType || !['i', 's'].includes(selector.chi[i].val)) {
+            const valid = !options.validation && selector.chi[i].typ == EnumToken.IdenTokenType && selector.chi[i].val.match(/^[a-z]$/);
+            return {
+                valid: valid ? ValidationLevel.Valid : ValidationLevel.Drop,
+                nodes: [selector],
+                error: valid ? '' : 'invalid attribute selector'
+            };
+        }
+        i++;
+        while (i < selector.chi.length) {
+            if (![EnumToken.WhitespaceTokenType, EnumToken.CommentTokenType].includes(selector.chi[i].typ)) {
+                return {
+                    valid: ValidationLevel.Drop,
+                    nodes: [selector],
+                    error: 'invalid attribute selector'
+                };
+            }
+            i++;
+        }
+    }
+    return {
+        valid: ValidationLevel.Valid,
+        nodes: [selector],
+        error: ''
+    };
+}
+function validateCombinator(selector, options, root) {
+    selector = consumeWhitespace(selector);
+    if (selector.length == 0) {
+        return {
+            valid: ValidationLevel.Drop,
+            nodes: selector,
+            error: 'expecting combinator'
+        };
+    }
+    const combinatorTypes = [
+        EnumToken.ChildCombinatorTokenType,
+        EnumToken.DescendantCombinatorTokenType,
+        EnumToken.NextSiblingCombinatorTokenType,
+        EnumToken.SubsequentSiblingCombinatorTokenType,
+        EnumToken.ColumnCombinatorTokenType
+    ];
+    if (!combinatorTypes.includes(selector[0].typ)) {
+        return {
+            valid: ValidationLevel.Drop,
+            nodes: selector,
+            error: 'Expecting combinator'
+        };
+    }
+    selector = consumeWhitespace(selector.slice(1));
+    if (selector.length == 0) {
+        return {
+            valid: ValidationLevel.Drop,
+            nodes: selector,
+            error: 'Unexpected combinator'
+        };
+    }
+    if (combinatorTypes.includes(selector[0].typ)) {
+        return {
+            valid: ValidationLevel.Drop,
+            nodes: selector,
+            error: 'Unexpected combinator'
+        };
+    }
+    return {
+        valid: ValidationLevel.Valid,
+        nodes: selector,
+        error: ''
+    };
+}
+
+export { validateSelector };

package/dist/node/index.js

@@ -1,3 +1,4 @@
+import process from 'node:process';
 export { EnumToken } from '../lib/ast/types.js';
 export { minify } from '../lib/ast/minify.js';
 export { walk, walkValues } from '../lib/ast/walk.js';
@@ -7,6 +8,7 @@ export { renderToken } from '../lib/renderer/render.js';
 import { doParse } from '../lib/parser/parse.js';
 export { parseString, parseTokens } from '../lib/parser/parse.js';
 import '../lib/renderer/color/utils/constants.js';
+import '../lib/parser/utils/config.js';
 import { resolve, dirname } from '../lib/fs/resolve.js';
 import { load } from './load.js';
 

package/dist/web/index.js

@@ -7,6 +7,7 @@ export { renderToken } from '../lib/renderer/render.js';
 import { doParse } from '../lib/parser/parse.js';
 export { parseString, parseTokens } from '../lib/parser/parse.js';
 import '../lib/renderer/color/utils/constants.js';
+import '../lib/parser/utils/config.js';
 import { resolve, dirname } from '../lib/fs/resolve.js';
 import { load } from './load.js';
 

package/dist/web/load.js

@@ -18,6 +18,7 @@ async function load(url, currentFile) {
         const path = resolve(url, currentFile).absolute;
         t = new URL(path, self.origin);
     }
+    // @ts-ignore
     return fetch(t, t.origin != self.origin ? { mode: 'cors' } : {}).then(parseResponse);
 }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tbela99/css-parser",
   "description": "CSS parser for node and the browser",
-  "version": "0.5.4",
+  "version": "0.7.0",
   "exports": {
     ".": "./dist/node/index.js",
     "./umd": "./dist/index-umd-web.js",
@@ -55,12 +55,13 @@
     "@rollup/plugin-typescript": "^11.1.6",
     "@types/chai": "^4.3.12",
     "@types/mocha": "^10.0.6",
-    "@types/node": "^20.11.25",
+    "@types/node": "^20.14.11",
+    "@types/web": "^0.0.151",
     "@web/test-runner": "^0.18.1",
     "@web/test-runner-playwright": "^0.11.0",
     "c8": "^9.1.0",
     "mocha": "^10.4.0",
-    "playwright": "^1.42.1",
+    "playwright": "^1.45.2",
     "rollup": "^4.13.0",
     "rollup-plugin-dts": "^6.1.0",
     "tslib": "^2.6.2"