@master/css-engine 2.0.0-rc.70

package/README.md

@@ -0,0 +1,57 @@
+# @master/css-engine
+
+The manifest-driven Master CSS engine.
+
+## Installation
+
+```bash
+npm install @master/css-engine
+```
+
+## Responsibility
+
+`@master/css-engine` executes `MasterCSSManifest` values. It owns class matching, value parsing, selector and at-rule parsing/generation, variable and animation insertion, cascade layers, rule priority sorting, hydration manifest generation, CSS text emission, and built-in key/namespace registries.
+
+This package does not discover project files, resolve CSS imports, compile CSS directives, or integrate with frameworks.
+
+## API
+
+### `MasterCSS`
+
+```ts
+import { MasterCSS } from '@master/css-engine'
+
+const css = MasterCSS.create({ manifest })
+
+css.add('text:center', 'font:semibold')
+console.log(css.text)
+```
+
+| API | Description |
+| --- | --- |
+| `MasterCSS.create({ manifest, emittedGlobals })` | Creates a `MasterCSS` instance. |
+| `css.add(...classNames)` | Adds class names and generated rules. |
+| `css.remove(...classNames)` | Removes class names and unused rules. |
+| `css.createRule(className)` | Creates one generated rule without inserting it. |
+| `css.createRules(className)` | Creates all generated rule branches without inserting them. |
+| `css.refresh(manifest?)` | Refreshes with a compiled manifest. |
+| `css.reset()` | Clears rules and state. |
+| `css.text` | Generated CSS text. |
+
+### Compiler helpers
+
+`@master/css-engine/compiler` exposes parse, generate, inspect, and built-in registry helpers used by the compiler, language tooling, docs, and tests.
+
+```ts
+import {
+    builtinKeyAliases,
+    builtinNativeValueNamespaces,
+    compareRulePriority,
+} from '@master/css-engine/compiler'
+```
+
+## Related packages
+
+- `@master/css` is the public facade over this package and the default preset.
+- `@master/css-compiler` lowers CSS directives into manifests.
+- `@master/css-runtime` runs the engine against live browser DOM roots.

package/dist/animation-rule.d.ts

@@ -0,0 +1,12 @@
+import MasterCSS from './core';
+import type { MasterCSSManifestAnimations } from '@master/css-schema/manifest';
+export default class AnimationRule {
+    readonly name: string;
+    readonly keyframes: MasterCSSManifestAnimations[string];
+    readonly css: MasterCSS;
+    native?: CSSKeyframeRule;
+    variableNames?: Set<string>;
+    constructor(name: string, keyframes: MasterCSSManifestAnimations[string], css: MasterCSS);
+    get key(): string;
+    get text(): string;
+}

package/dist/animation-rule.mjs

@@ -0,0 +1,38 @@
+import collectVariableNames from './utils/collect-variable-names.mjs';
+
+class AnimationRule {
+    name;
+    keyframes;
+    css;
+    native;
+    variableNames;
+    constructor(name, keyframes, css){
+        this.name = name;
+        this.keyframes = keyframes;
+        this.css = css;
+        for (const declarations of Object.values(keyframes)){
+            const variableNames = collectVariableNames(declarations, css.variables);
+            if (!variableNames) continue;
+            for (const variableName of variableNames){
+                if (this.variableNames) {
+                    this.variableNames.add(variableName);
+                } else {
+                    this.variableNames = new Set([
+                        variableName
+                    ]);
+                }
+            }
+        }
+    }
+    get key() {
+        return this.name;
+    }
+    get text() {
+        return `@keyframes ${this.name}{` + Object.entries(this.keyframes).reduce((acc, [key, variables])=>{
+            const variableText = Object.entries(variables).map(([name, value])=>`${name}:${value}`).join(';');
+            return acc + `${key}{${variableText}}`;
+        }, '') + '}';
+    }
+}
+
+export { AnimationRule as default };

package/dist/common.d.ts

@@ -0,0 +1,40 @@
+import type { MasterCSSManifestAtIdentifier } from '@master/css-schema/manifest';
+export declare const VALUE_DELIMITERS: {
+    '(': string;
+    '\'': string;
+    '"': string;
+    '{': string;
+};
+export declare const BASE_UNIT_REGEX: RegExp;
+export declare const SELECTOR_SIGNS: string[];
+export declare const SELECTOR_COMBINATORS: string[];
+export declare const QUERY_COMPARISON_OPERATORS: string[];
+export declare const QUERY_LOGICAL_OPERATORS: string[];
+export declare const SEPARATOR_SIGNS: string[];
+export declare const DELIMITER_SIGN = "|";
+export declare const SEPARATOR_SIGN = ",";
+export declare const AT_SIGN = "@";
+export declare const VALUE_UNITS: ("%" | "cm" | "mm" | "q" | "in" | "pt" | "pc" | "px" | "em" | "rem" | "ex" | "rex" | "cap" | "rcap" | "ch" | "rch" | "ic" | "ric" | "lh" | "rlh" | "vw" | "svw" | "lvw" | "dvw" | "vh" | "svh" | "lvh" | "dvh" | "vi" | "svi" | "lvi" | "dvi" | "vb" | "svb" | "lvb" | "dvb" | "vmin" | "svmin" | "lvmin" | "dvmin" | "vmax" | "svmax" | "lvmax" | "dvmax" | "cqw" | "cqh" | "cqi" | "cqb" | "cqmin" | "cqmax" | "deg" | "grad" | "rad" | "turn" | "s" | "ms" | "hz" | "khz" | "dpi" | "dpcm" | "dppx" | "x" | "fr" | "db" | "st")[];
+export declare const UNIT_REGEX: RegExp;
+export declare const CLASS_ATTRIBUTES: string[];
+export declare const CLASS_DECLARATIONS: never[];
+export declare const CLASS_FUNCTIONS: string[];
+export declare const MATCH_NAME_BOUNDARY: Set<string>;
+export declare const AT_COMPARISON_OPERATORS: string[];
+export declare const AT_LOGICAL_OPERATORS: {
+    '&': string;
+    '!': string;
+    not: string;
+    and: string;
+    or: string;
+    only: string;
+    ',': string;
+};
+export declare const AT_IDENTIFIERS: MasterCSSManifestAtIdentifier[];
+export declare const COMPARISION_OPERATORS: string[];
+export declare const AT_COMPARABLE_FEATURES: string[];
+export declare const AT_FEATURE_ALIASES: {
+    readonly w: "width";
+    readonly h: "height";
+};
+export declare const __UNSORTED__ = "__UNSORTED__";

package/dist/common.mjs

@@ -0,0 +1,114 @@
+import { MASTER_CSS_VALUE_UNITS, MASTER_CSS_VALUE_UNIT_PATTERN } from '@master/css-lexer';
+
+const VALUE_DELIMITERS = {
+    '(': ')',
+    '\'': '\'',
+    '"': '"',
+    '{': '}'
+};
+const BASE_UNIT_REGEX = /^([+-]?(?:\d+(?:\.?\d+)?|\.\d+))x$/m // 1x, 1.1x, -1x, -.1x
+;
+const SELECTOR_SIGNS = [
+    ':',
+    '_',
+    '>',
+    '+',
+    '~'
+];
+const SELECTOR_COMBINATORS = [
+    '_',
+    '>',
+    '+',
+    '~'
+];
+const QUERY_COMPARISON_OPERATORS = [
+    '>',
+    '<',
+    '='
+];
+const QUERY_LOGICAL_OPERATORS = [
+    '&'
+];
+const SEPARATOR_SIGNS = [
+    ',',
+    '|'
+];
+const DELIMITER_SIGN = '|';
+const SEPARATOR_SIGN = ',';
+const AT_SIGN = '@';
+const VALUE_UNITS = [
+    ...MASTER_CSS_VALUE_UNITS
+];
+const UNIT_REGEX = new RegExp(`^([+-.]?\\d+(?:\\.?\\d+)?)(${MASTER_CSS_VALUE_UNIT_PATTERN})?$`);
+const CLASS_ATTRIBUTES = [
+    'class',
+    'className'
+];
+const CLASS_DECLARATIONS = [];
+const CLASS_FUNCTIONS = [
+    'clsx',
+    'cva',
+    'ctl',
+    'cv',
+    'class',
+    'classnames',
+    'classVariant',
+    'styled(?:\\s+)?(?:\\.\\w+)?',
+    'classList(?:\\s+)?\\.(?:add|remove|toggle|replace)'
+];
+const MATCH_NAME_BOUNDARY = new Set([
+    '!',
+    '*',
+    '>',
+    '+',
+    '~',
+    ':',
+    '[',
+    '@',
+    '_',
+    '.'
+]);
+const AT_COMPARISON_OPERATORS = [
+    '>=',
+    '<=',
+    '>',
+    '<',
+    '='
+];
+const AT_LOGICAL_OPERATORS = {
+    '&': 'and',
+    '!': 'not',
+    // native
+    'not': 'not',
+    'and': 'and',
+    'or': 'or',
+    'only': 'only',
+    ',': 'or'
+};
+// the order is intentional and should not be changed
+const AT_IDENTIFIERS = [
+    'container',
+    'starting-style',
+    'supports',
+    'media',
+    'layer'
+];
+const COMPARISION_OPERATORS = [
+    '>=',
+    '<=',
+    '>',
+    '<',
+    '='
+];
+const AT_COMPARABLE_FEATURES = [
+    'width',
+    'height',
+    'resolution'
+];
+const AT_FEATURE_ALIASES = {
+    w: 'width',
+    h: 'height'
+};
+const __UNSORTED__ = '__UNSORTED__';
+
+export { AT_COMPARABLE_FEATURES, AT_COMPARISON_OPERATORS, AT_FEATURE_ALIASES, AT_IDENTIFIERS, AT_LOGICAL_OPERATORS, AT_SIGN, BASE_UNIT_REGEX, CLASS_ATTRIBUTES, CLASS_DECLARATIONS, CLASS_FUNCTIONS, COMPARISION_OPERATORS, DELIMITER_SIGN, MATCH_NAME_BOUNDARY, QUERY_COMPARISON_OPERATORS, QUERY_LOGICAL_OPERATORS, SELECTOR_COMBINATORS, SELECTOR_SIGNS, SEPARATOR_SIGN, SEPARATOR_SIGNS, UNIT_REGEX, VALUE_DELIMITERS, VALUE_UNITS, __UNSORTED__ };

package/dist/compile-manifest.d.ts

@@ -0,0 +1,54 @@
+import type { Variable } from '@master/css-schema/css-syntax';
+import type { MasterCSSManifest, MasterCSSManifestAnimations, MasterCSSManifestSettings, MasterCSSManifestUtility, MasterCSSManifestVariantBranch, MasterCSSManifestVariantToken } from '@master/css-schema/manifest';
+import type { AtRule } from './utils/parse-at';
+import type { SelectorNode } from './utils/parse-selector';
+export type CompiledUtility = Omit<MasterCSSManifestUtility, 'emit' | 'name' | 'order'> & {
+    name: string;
+    order: number;
+    emit: MasterCSSManifestUtility['emit'] | {
+        type: 'group';
+    };
+    variables?: Map<string, Variable>;
+};
+export type EngineSettings = MasterCSSManifestSettings & {
+    rootSize: number;
+    baseUnit: number;
+    defaultMode: NonNullable<MasterCSSManifestSettings['defaultMode']>;
+    modeTrigger: NonNullable<MasterCSSManifestSettings['modeTrigger']>;
+    modes: string[];
+};
+export interface CompiledManifest {
+    manifest: MasterCSSManifest;
+    settings: EngineSettings;
+    definedUtilities: CompiledUtility[];
+    variableMatcherUtilities: CompiledUtility[];
+    valueMatcherUtilities: CompiledUtility[];
+    keyMatcherUtilities: CompiledUtility[];
+    patternMatcherUtilities: CompiledUtility[];
+    arbitraryMatcherUtilities: CompiledUtility[];
+    variableMatcherIndex: Map<string, CompiledUtility[]>;
+    valueMatcherIndex: Map<string, CompiledUtility[]>;
+    keyMatcherIndex: Map<string, CompiledUtility[]>;
+    patternMatcherIndex?: Map<string, CompiledUtility[]>;
+    arbitraryStaticMatcherIndex?: Map<string, CompiledUtility[]>;
+    selectors: Map<string, SelectorNode[]>;
+    variables: Map<string, Variable>;
+    modes: string[];
+    atRules: Map<string, AtRule>;
+    variants: Map<MasterCSSManifestVariantToken, MasterCSSManifestVariantBranch[]>;
+    breakpointAtRules: Map<string, AtRule>;
+    containerAtRules: Map<string, AtRule>;
+    animations: Map<string, MasterCSSManifestAnimations[string]>;
+    nativeDeclarationFastPathBlockedProperties: Set<string>;
+    nativeValueNamespaceUtilities: Map<string, CompiledUtility>;
+    keyAliases: Map<string, string>;
+}
+export declare function isPureNativeDeclarationUtilityDefinition(utility: CompiledUtility): utility is CompiledUtility & {
+    emit: {
+        type: 'property';
+        property: string;
+    };
+};
+export declare function cloneCompiledSettings(settings: EngineSettings): EngineSettings;
+export declare function compileManifest(manifest: MasterCSSManifest): CompiledManifest;
+export declare function getCompiledManifest(manifest: MasterCSSManifest): CompiledManifest;