@master/css 2.0.0-rc.69 → 2.0.0-rc.70

package/dist/core.cjs

@@ -1,674 +0,0 @@
-'use strict';
-
-var syntaxRule = require('./syntax-rule.cjs');
-var hexToRgb = require('./utils/hex-to-rgb.cjs');
-var extendConfig = require('./utils/extend-config.cjs');
-var rule = require('./rule.cjs');
-var syntaxRuleType = require('./syntax-rule-type.cjs');
-var layer = require('./layer.cjs');
-var syntaxLayer = require('./syntax-layer.cjs');
-var nonLayer = require('./non-layer.cjs');
-var registerGlobal = require('./register-global.cjs');
-var parseAt = require('./utils/parse-at.cjs');
-var parseValue = require('./utils/parse-value.cjs');
-var parseSelector = require('./utils/parse-selector.cjs');
-
-class MasterCSS {
-    customConfig;
-    baseConfig;
-    definedRules = [];
-    config;
-    layerStatementRule = new rule.Rule('layer-statement', '@layer base,theme,preset,components,general;');
-    rules = [
-        this.layerStatementRule
-    ];
-    classRules = new Map();
-    animationsNonLayer = new nonLayer(this);
-    baseLayer = new syntaxLayer('base', this);
-    themeLayer = new layer('theme', this);
-    presetLayer = new syntaxLayer('preset', this);
-    componentsLayer = new syntaxLayer('components', this);
-    generalLayer = new syntaxLayer('general', this);
-    components = new Map();
-    selectors = new Map();
-    variables = new Map();
-    modes = [];
-    atRules = new Map();
-    animations = new Map();
-    constructor(customConfig, baseConfig){
-        this.customConfig = customConfig;
-        this.baseConfig = baseConfig;
-        this.resolve(customConfig);
-    }
-    get text() {
-        return this.rules.sort((a, b)=>{
-            const order = [
-                'layer-statement',
-                'base',
-                'theme',
-                'preset',
-                'components',
-                'general'
-            ];
-            const indexA = order.indexOf(a.name) === -1 ? Infinity : order.indexOf(a.name);
-            const indexB = order.indexOf(b.name) === -1 ? Infinity : order.indexOf(b.name);
-            return indexA - indexB;
-        }).map(({ text })=>text).join('');
-    }
-    resolve(customConfig) {
-        if (customConfig) {
-            this.customConfig = customConfig;
-        } else {
-            customConfig = this.customConfig;
-        }
-        // @ts-expect-error read-only
-        this.config = this.baseConfig ? extendConfig(this.baseConfig, customConfig) : extendConfig(customConfig);
-        this.resolveVariables();
-        this.resolveAnimations();
-        this.resolveSelectors();
-        this.resolveAtRules();
-        this.resolveRules();
-        this.resolveComponents();
-    }
-    resolveAnimations() {
-        const { animations } = this.config;
-        if (animations) {
-            for(const animationName in animations){
-                const eachAnimation = {};
-                this.animations.set(animationName, eachAnimation);
-                const eachKeyframes = animations[animationName];
-                for(const eachKeyframeValue in eachKeyframes){
-                    const newValueByPropertyName = eachAnimation[eachKeyframeValue] = {};
-                    const eachKeyframeDeclarations = eachKeyframes[eachKeyframeValue];
-                    for(const propertyName in eachKeyframeDeclarations){
-                        newValueByPropertyName[propertyName] = eachKeyframeDeclarations[propertyName];
-                    }
-                }
-            }
-        }
-    }
-    resolveRules() {
-        const { rules, utilities } = this.config;
-        function escapeString(str) {
-            return str.replace(/[-/\\^$*+?.()|[\]{}]/g, '\\$&');
-        }
-        if (!rules && !utilities) return;
-        const rulesEntries = [];
-        // Collect utility rules
-        if (utilities) {
-            for(const utilityName in utilities){
-                const declarations = utilities[utilityName];
-                rulesEntries.push([
-                    utilityName,
-                    {
-                        declarations,
-                        type: syntaxRuleType.Utility
-                    }
-                ]);
-            }
-        }
-        // Collect normal rules
-        if (rules) {
-            rulesEntries.push(...Object.entries(rules));
-        }
-        const rulesEntriesLength = rulesEntries.length;
-        // Main loop
-        rulesEntries.sort((a, b)=>{
-            if (a[1].type !== b[1].type) {
-                return (b[1].type || 0) - (a[1].type || 0);
-            }
-            if (a[1].kind !== b[1].kind) {
-                if (!a[1].kind) return 1;
-                if (!b[1].kind) return -1;
-                const kindOrder = [
-                    'color',
-                    'number',
-                    'image'
-                ];
-                const aKindIndex = kindOrder.indexOf(a[1].kind);
-                const bKindIndex = kindOrder.indexOf(b[1].kind);
-                if (aKindIndex !== bKindIndex) {
-                    return aKindIndex - bKindIndex;
-                }
-            }
-            return b[0].localeCompare(a[0], undefined, {
-                numeric: true
-            });
-        }).forEach(([id, def], index)=>{
-            const order = rulesEntriesLength - 1 - index;
-            const syntax = {
-                id,
-                keys: [],
-                matchers: {},
-                order,
-                definition: def
-            };
-            def.unit ??= '';
-            def.separators ??= [
-                ','
-            ];
-            this.definedRules.push(syntax);
-            let { matcher, type, subkey, aliasGroups, values, kind, sign, key: originalKey, namespaces } = def;
-            const keys = [];
-            let key = originalKey;
-            // Helper: resolve variable groups
-            const addNamespace = (namespace)=>{
-                const dashedNamespace = namespace.replace(/\./g, '-');
-                this.variables.forEach((v)=>{
-                    if (v.namespace === namespace || v.group === namespace) {
-                        let variableKey = v.name;
-                        if (variableKey.startsWith('-' + dashedNamespace) || variableKey.startsWith(dashedNamespace)) {
-                            variableKey = variableKey.slice(dashedNamespace.length + 1);
-                        }
-                        if (syntax.variables) {
-                            syntax.variables.set(variableKey, v);
-                        } else {
-                            syntax.variables = new Map([
-                                [
-                                    variableKey,
-                                    v
-                                ]
-                            ]);
-                        }
-                    }
-                });
-            };
-            // 1. Auto variable binding
-            addNamespace(id);
-            // 2. Rule-defined variable groups
-            if (namespaces) {
-                namespaces.forEach(addNamespace);
-            }
-            if (id.endsWith('()')) {
-                if (!key) def.key = key = id;
-                const fnName = id.slice(0, -2);
-                matcher = new RegExp(`^${fnName}\\(`);
-            } else if (type === syntaxRuleType.NativeShorthand || type === syntaxRuleType.Native) {
-                if (!key) def.key = key = id;
-                keys.push(id);
-            }
-            if (sign) {
-                syntax.matchers.arbitrary = new RegExp(`^${sign}[^!*>+~:[@_]+\\|`);
-            } else if (!matcher) {
-                if (!key && !subkey) {
-                    keys.push(id);
-                } else {
-                    if (key && !keys.includes(key)) keys.push(key);
-                    if (subkey) keys.push(subkey);
-                    if (type === syntaxRuleType.Shorthand) keys.push(id);
-                }
-                // Ambiguous keys and values
-                if (aliasGroups?.length) {
-                    const keyPattern = aliasGroups.length > 1 ? `(?:${aliasGroups.join('|')})` : aliasGroups[0];
-                    const variableKeys = Array.from(syntax.variables?.keys() || []);
-                    const valuePatterns = values ? values.map((v)=>`${v}(?:\\b|_)`) : [];
-                    switch(kind){
-                        case 'color':
-                            valuePatterns.push(`(?:#|(?:color|color-contrast|color-mix|hwb|lab|lch|oklab|oklch|rgb|rgba|hsl|hsla|light-dark)\\(.*\\)|(?:currentColor|transparent)(?![a-zA-Z0-9-]))`);
-                            break;
-                        case 'number':
-                            valuePatterns.push('(?:[\\d.]|(?:max|min|calc|clamp)\\([^|]*\\))');
-                            break;
-                        case 'image':
-                            valuePatterns.push('(?:url|linear-gradient|radial-gradient|repeating-linear-gradient|repeating-radial-gradient|conic-gradient)\\(.*\\)');
-                            break;
-                    }
-                    if (valuePatterns?.length) {
-                        syntax.matchers.value = new RegExp(`^${keyPattern}:(?:${valuePatterns.join('|')})[^|]*?(?:@|$)`);
-                    }
-                    if (variableKeys.length) {
-                        syntax.matchers.variable = new RegExp(`^${keyPattern}:(?:${variableKeys.join('|')})(?![a-zA-Z0-9-])[^|]*?(?:@|$)`);
-                    }
-                }
-            } else {
-                syntax.matchers.arbitrary = new RegExp(matcher);
-            }
-            // Utility rule matcher
-            if (type === syntaxRuleType.Utility) {
-                syntax.id = '.' + id;
-                syntax.matchers.arbitrary = new RegExp('^' + escapeString(id) + '(?=!|\\*|>|\\+|~|:|\\[|@|_|\\.|$)', 'm');
-            }
-            // Key matcher
-            if (keys.length) {
-                syntax.keys = keys;
-                syntax.matchers.key = new RegExp(`^${keys.length > 1 ? `(${keys.join('|')})` : keys[0]}:.`);
-            }
-        });
-    }
-    resolveComponents() {
-        const { components = {} } = this.config;
-        const flatNames = Object.keys(components);
-        const resolve = (name, currentClasses = [])=>{
-            const compClasses = this.components.get(name);
-            if (compClasses) {
-                currentClasses.push(...compClasses);
-                return;
-            }
-            const className = components[name];
-            if (!className) return;
-            const classes = className.replace(/(?:\n\s*)+/g, ' ').trim().split(' ');
-            for (const cls of classes){
-                if (flatNames.includes(cls)) {
-                    resolve(cls, currentClasses);
-                } else {
-                    currentClasses.push(cls);
-                }
-            }
-            this.components.set(name, [
-                ...currentClasses
-            ]);
-        };
-        // First pass: expand class names recursively
-        for (const name of flatNames){
-            resolve(name);
-        }
-    }
-    resolveSelectors() {
-        const { selectors } = this.config;
-        if (selectors) {
-            for(const token in selectors){
-                const value = selectors[token];
-                const nodes = parseSelector(value, this, false);
-                this.selectors.set(token, nodes);
-            }
-        }
-    }
-    resolveAtRules() {
-        const { at, screens } = this.config;
-        if (screens) {
-            for(const key in screens){
-                const value = screens[key];
-                const node = this.parseValue(value);
-                this.atRules.set(key, {
-                    id: 'media',
-                    nodes: [
-                        node
-                    ]
-                });
-            }
-        }
-        if (at) {
-            for(const token in at){
-                const value = at[token];
-                if (typeof value === 'number') {
-                    const node = this.parseValue(value);
-                    this.atRules.set(token, {
-                        id: 'media',
-                        nodes: [
-                            node
-                        ]
-                    });
-                } else {
-                    const atRule = parseAt(value, this, false);
-                    this.atRules.set(token, atRule);
-                }
-            }
-        }
-    }
-    resolveVariables() {
-        const { variables, screens, modes } = this.config;
-        const aliasVariableModeResolvers = new Map();
-        const resolveVariable = (variable, mode)=>{
-            const addVariable = (name, newVariable, currentMode)=>{
-                if (currentMode) {
-                    const foundVariable = this.variables.get(name);
-                    const newModeVariable = {
-                        value: newVariable.value
-                    };
-                    if ('alpha' in newVariable) newModeVariable.alpha = newVariable.alpha;
-                    if ('space' in newVariable) newModeVariable.space = newVariable.space;
-                    if (foundVariable) {
-                        if (newVariable.type && newVariable.type !== foundVariable.type) {
-                            return;
-                        }
-                        if (!foundVariable.modes) foundVariable.modes = {};
-                        foundVariable.modes[currentMode] = newModeVariable;
-                    } else {
-                        const newRootVaraible = {
-                            name: newVariable.name,
-                            key: newVariable.key,
-                            type: newVariable.type,
-                            modes: {
-                                [currentMode]: newModeVariable
-                            }
-                        };
-                        if (newVariable.namespace) newRootVaraible.namespace = newVariable.namespace;
-                        if (newVariable.group) newRootVaraible.group = newVariable.group;
-                        this.variables.set(name, newRootVaraible);
-                    }
-                } else {
-                    this.variables.set(name, newVariable);
-                }
-            };
-            if (typeof variable.value === 'number') {
-                addVariable(variable.name, {
-                    ...variable,
-                    type: 'number'
-                }, mode);
-                addVariable('-' + variable.name, {
-                    ...variable,
-                    type: 'number',
-                    name: '-' + variable.name,
-                    key: '-' + variable.key,
-                    value: variable.value * -1
-                }, mode);
-            } else if (typeof variable.value === 'string') {
-                const aliasResult = /^\$\((.*?)\)(?: ?\/ ?(.+?))?$|^\$([a-zA-Z0-9-]+)(?: ?\/ ?(.+?))?$/.exec(variable.value);
-                if (aliasResult) {
-                    const alias = aliasResult[1] ?? aliasResult[3];
-                    const alpha = aliasResult[2] ?? aliasResult[4];
-                    let aliasVariableModeResolver = aliasVariableModeResolvers.get(variable.name);
-                    if (!aliasVariableModeResolver) {
-                        aliasVariableModeResolvers.set(variable.name, aliasVariableModeResolver = {});
-                    }
-                    aliasVariableModeResolver[mode] = ()=>{
-                        delete aliasVariableModeResolver[mode];
-                        if (!alias) return;
-                        const eachAliasModeVariableResolver = aliasVariableModeResolvers.get(alias);
-                        if (eachAliasModeVariableResolver) {
-                            for (const mode of Object.keys(eachAliasModeVariableResolver)){
-                                eachAliasModeVariableResolver[mode]?.();
-                            }
-                        }
-                        const aliasVariable = this.variables.get(alias);
-                        if (aliasVariable) {
-                            let resolvedAlpha;
-                            if (alpha) {
-                                const numberAlpha = Number(alpha) * (aliasVariable.alpha || 1);
-                                if (numberAlpha < 1) resolvedAlpha = numberAlpha;
-                            }
-                            const newVariable = {
-                                ...variable,
-                                type: aliasVariable.type,
-                                value: aliasVariable.value
-                            };
-                            if (aliasVariable.type === 'color') {
-                                if (resolvedAlpha !== undefined) newVariable.alpha = resolvedAlpha;
-                                if (aliasVariable.space) {
-                                    newVariable.space = aliasVariable.space;
-                                }
-                            }
-                            addVariable(newVariable.name, newVariable, mode);
-                            if (aliasVariable.modes) {
-                                for(const eachMode in aliasVariable.modes){
-                                    const aliasModeVariable = aliasVariable.modes[eachMode];
-                                    addVariable(newVariable.name, aliasModeVariable, eachMode);
-                                }
-                            }
-                        }
-                    };
-                } else {
-                    // 1. HEX
-                    const hexMatch = /^#([a-f0-9]{3,4}|[a-f0-9]{6}|[a-f0-9]{8})$/i.exec(variable.value);
-                    if (hexMatch) {
-                        const [r, g, b, a] = hexToRgb(hexMatch[1]);
-                        const newVariable = {
-                            ...variable,
-                            type: 'color',
-                            value: `${r} ${g} ${b}`,
-                            space: 'rgb'
-                        };
-                        if (a !== undefined && a < 1) {
-                            newVariable.alpha = a;
-                        }
-                        addVariable(newVariable.name, newVariable, mode);
-                        return;
-                    }
-                    // 2. COLOR FUNCTION
-                    const funcMatch = /^(color|color-contrast|color-mix|hwb|lab|lch|oklab|oklch|rgb|hsl|light-dark)\((.+)\)$/i.exec(variable.value);
-                    if (funcMatch) {
-                        let [, space, rawArgs] = funcMatch;
-                        space = space.toLowerCase();
-                        const normalizedArgs = rawArgs.replace(/\s*\/\s*/g, '/').replace(/\s*,\s*/g, ' ').replace(/\s+/g, ' ').trim();
-                        let alpha;
-                        const alphaMatch = /^(.+?)\/([^\s]+)$/.exec(normalizedArgs);
-                        const finalArgs = alphaMatch ? alphaMatch[1].trim() : normalizedArgs;
-                        alpha = alphaMatch ? Number(alphaMatch[2]) : undefined;
-                        const newVariable = {
-                            ...variable,
-                            type: 'color',
-                            value: finalArgs,
-                            space
-                        };
-                        if (alpha !== undefined) {
-                            newVariable.alpha = alpha;
-                        }
-                        addVariable(newVariable.name, newVariable, mode);
-                        return;
-                    }
-                    // 3. Fallback
-                    addVariable(variable.name, {
-                        ...variable,
-                        type: 'string'
-                    }, mode);
-                }
-            }
-        };
-        if (variables) {
-            for(const parnetKey in variables){
-                const variable = variables[parnetKey];
-                resolveVariable(variable);
-            }
-        }
-        if (modes) {
-            for(const mode in modes){
-                const modeVariables = modes[mode];
-                if (!modeVariables) continue;
-                for(const key in modeVariables){
-                    const variable = modeVariables[key];
-                    resolveVariable(variable, mode);
-                }
-            }
-        }
-        // todo: address to the target variable
-        aliasVariableModeResolvers.forEach((aliasVariableModeResolver)=>{
-            for (const mode of Object.keys(aliasVariableModeResolver)){
-                aliasVariableModeResolver[mode]?.();
-            }
-        });
-        if (screens) {
-            for(const key in screens){
-                const value = screens[key];
-                const name = 'screen-' + key;
-                this.variables.set(name, {
-                    name,
-                    key,
-                    namespace: 'screen',
-                    group: 'screen',
-                    type: 'number',
-                    value
-                });
-                this.variables.set('-' + name, {
-                    name: '-' + name,
-                    key: '-' + key,
-                    namespace: 'screen',
-                    group: 'screen',
-                    type: 'number',
-                    value: value * -1
-                });
-            }
-        }
-    }
-    parseValue(token, unit = 'rem') {
-        return parseValue(token, unit, this.config.rootSize);
-    }
-    /**
-     * Match check if Master CSS syntax
-     * @param className
-     * @returns css text
-     */ match(className) {
-        /**
-         * 1. variable
-         * @example fg:primary bg:blue
-         */ for (const eachSyntax of this.definedRules){
-            if (eachSyntax.matchers.variable?.test(className)) return eachSyntax;
-        }
-        /**
-         * 2. value (ambiguous.key * ambiguous.values)
-         * @example bg:current box-content font:12
-         */ for (const eachSyntax of this.definedRules){
-            if (eachSyntax.matchers.value?.test(className)) return eachSyntax;
-        }
-        /**
-         * 3. full key
-         * @example text-align:center color:blue-40
-         */ for (const eachSyntax of this.definedRules){
-            if (eachSyntax.matchers.key?.test(className)) return eachSyntax;
-        }
-        /**
-         * 4. arbitrary
-         * @example custom RegExp, utility
-         */ for (const eachSyntax of this.definedRules){
-            if (eachSyntax.matchers.arbitrary?.test(className)) return eachSyntax;
-        }
-    }
-    /**
-     * Generate syntax rules from class name
-     * @param className
-     * @returns SyntaxRule[]
-     */ generate(className, mode) {
-        let syntaxRules = [];
-        const compClasses = this.components.get(className);
-        if (compClasses) {
-            compClasses.forEach((cls)=>{
-                const syntaxRule = this.create(cls, className, mode);
-                if (syntaxRule && syntaxRule.valid) {
-                    syntaxRules.push(syntaxRule);
-                } else {
-                    console.error(`Invalid class "${cls}" found in ${className} component.`);
-                }
-            });
-        } else {
-            const atIndex = className.indexOf('@');
-            if (atIndex !== -1) {
-                const name = className.slice(0, atIndex);
-                const compClasses = this.components.get(name);
-                if (compClasses) {
-                    const atToken = className.slice(atIndex);
-                    compClasses.forEach((eachSyntax)=>{
-                        const syntaxRule = this.create(eachSyntax + atToken, className, mode);
-                        if (syntaxRule && syntaxRule.valid) {
-                            syntaxRules.push(syntaxRule);
-                        }
-                    });
-                }
-            }
-            const syntaxRule = this.create(className, undefined, mode);
-            if (syntaxRule && syntaxRule.valid) {
-                syntaxRules.push(syntaxRule);
-            }
-        }
-        return syntaxRules;
-    }
-    /**
-     * Create syntax rule from given class name
-     * @param className
-     * @returns SyntaxRule
-     */ create(className, fixedClass, mode) {
-        const syntaxRule$1 = this.generalLayer.rules.find(({ key })=>key === (fixedClass ? fixedClass + ' ' : '') + className);
-        if (syntaxRule$1) return syntaxRule$1;
-        const registeredRule = this.match(className);
-        if (registeredRule) return new syntaxRule.SyntaxRule(className, this, registeredRule, fixedClass, mode);
-    }
-    /**
-     * Create syntax rule from given selector text
-     * @param selectorText
-     */ createFromSelectorText(selectorText) {
-        const selectorTextSplits = selectorText.split(' ');
-        const stopChars = /[.#\[!\*>+~:,\s]/;
-        for(let i = 0; i < selectorTextSplits.length; i++){
-            const eachField = selectorTextSplits[i];
-            const modeSelector = this.getModeSelector(eachField);
-            if (i === 0 && eachField === modeSelector || (i === 0 || i === 1) && eachField === this.config.scope) continue;
-            if (eachField.startsWith('.')) {
-                const eachFieldName = eachField.slice(1);
-                let className = '';
-                let l = 0;
-                while(l < eachFieldName.length){
-                    const char = eachFieldName[l];
-                    const nextChar = eachFieldName[l + 1];
-                    if (char === '\\' && nextChar) {
-                        className += nextChar;
-                        l += 2;
-                        continue;
-                    }
-                    if (stopChars.test(char)) break;
-                    className += char;
-                    l++;
-                }
-                const syntaxRules = this.generate(className);
-                if (syntaxRules.length) return syntaxRules;
-            }
-        }
-    }
-    /**
-     * 根據蒐集到的所有 DOM class 重新 create
-     */ refresh(customConfig) {
-        this.reset();
-        this.resolve(customConfig);
-        return this;
-    }
-    reset() {
-        // @ts-ignore
-        this.animations = new Map();
-        // @ts-ignore
-        this.variables = new Map();
-        // @ts-ignore
-        this.atRules = new Map();
-        // @ts-ignore
-        this.selectors = new Map();
-        // @ts-ignore
-        this.components = new Map();
-        // @ts-ignore
-        this.classRules = new Map();
-        this.definedRules.length = 0;
-        this.baseLayer.reset();
-        this.themeLayer.reset();
-        this.presetLayer.reset();
-        this.componentsLayer.reset();
-        this.generalLayer.reset();
-        this.animationsNonLayer.reset();
-        return this;
-    }
-    destroy() {
-        this.reset();
-        return this;
-    }
-    add(...classNames) {
-        for (const className of classNames){
-            const rules = this.classRules.get(className);
-            if (rules) continue;
-            const newRules = this.generate(className);
-            if (newRules.length) {
-                newRules.forEach((eachSyntaxRule)=>eachSyntaxRule.layer.insert(eachSyntaxRule));
-                this.classRules.set(className, newRules);
-            }
-        }
-        return this;
-    }
-    remove(...classNames) {
-        /**
-         * class name 從 DOM tree 中被移除，
-         * 匹配並刪除對應的 rule
-         */ for (const className of classNames){
-            const rules = this.classRules.get(className);
-            if (rules) {
-                rules.forEach((rule)=>rule.layer.delete(rule.key));
-                this.classRules.delete(className);
-            }
-        }
-    }
-    getModeSelector(modeName) {
-        switch(this.config.modeTrigger){
-            case 'class':
-                return '.' + modeName;
-            case 'host':
-                return ':host(.' + modeName + ')';
-        }
-    }
-}
-(function(MasterCSS) {
-    registerGlobal(MasterCSS);
-})(MasterCSS);
-
-module.exports = MasterCSS;