@cassida/compiler 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FSS contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/config.schema.json

@@ -0,0 +1,88 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "CassConfig",
+  "description": "FSS (Functional Style Sheet) configuration. Place this at the project root as cassida.config.json. Every field is optional; missing fields fall back to FSS defaults.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema URL for editor autocomplete."
+    },
+    "layer": {
+      "type": ["string", "null"],
+      "description": "@layer name for the cascade-isolation wrapper. Use null to disable the @layer wrap entirely.",
+      "default": "fss"
+    },
+    "importSource": {
+      "type": "string",
+      "description": "Module specifier the parser recognizes as the source of `fss`. Renamed imports (`{ fss as ff }`) are honored automatically.",
+      "default": "@cassida/core"
+    },
+    "hash": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Class-name hashing parameters.",
+      "properties": {
+        "prefix": {
+          "type": "string",
+          "description": "Prefix prepended to every generated class name.",
+          "default": "cas-"
+        },
+        "length": {
+          "type": "integer",
+          "description": "Hex characters of SHA-1 digest used as the hash. 8 is enough for ~tens of thousands of unique rules; bump to 10–12 for very large apps.",
+          "minimum": 4,
+          "maximum": 40,
+          "default": 8
+        }
+      }
+    },
+    "media": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Media-query handling.",
+      "properties": {
+        "sort": {
+          "type": "string",
+          "enum": ["mobile-first", "desktop-first"],
+          "description": "Cascade direction for width-based @media queries. Mobile-first sorts min-width ascending and max-width descending; desktop-first reverses both.",
+          "default": "mobile-first"
+        }
+      }
+    },
+    "css": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "CSS-emission strategy and post-processing.",
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": ["rule-per-class", "shared-by-declaration"],
+          "description": "rule-per-class: one rule per className with declarations baked in. shared-by-declaration: one rule per (property, value) with grouped selectors. Phase 4+ feature; recognized but not yet implemented.",
+          "default": "rule-per-class"
+        },
+        "lightningcss": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Optional lightningcss post-processing of the emitted CSS. Phase 5+ feature; recognized but not yet implemented.",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": false
+            },
+            "minify": {
+              "type": "boolean",
+              "default": true
+            },
+            "targets": {
+              "type": "string",
+              "description": "Browserslist string passed to lightningcss.",
+              "default": "defaults"
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/dist/canonicalizer.d.ts

@@ -0,0 +1,42 @@
+import { type Op, type Scope, type ScopeBag } from './types.js';
+import type { Registry } from './registry.js';
+import type { ShorthandPolicy } from './config.js';
+/**
+ * Walks an `Op[]` chain, LIFO-collapsing each scope's declarations and
+ * recursing into nested scoped sub-chains. The output is a deterministic
+ * `ScopeBag` tree: the root has `scope: null` and owns "base"
+ * declarations; each child carries its modifier (`:hover`, `@media (...)`,
+ * raw selector) plus its own bag and further children.
+ *
+ * Multiple scoped ops at the same scope key (e.g. two `.hover(...)`
+ * calls in the same chain) are merged: their inner ops are concatenated,
+ * then re-collapsed inside the merged scope. This matches the user's
+ * intuition that "`.hover()` adds, doesn't replace" while still
+ * applying property-level LIFO inside the merged scope.
+ */
+export declare class Canonicalizer {
+    private readonly registry;
+    private readonly policy;
+    constructor(registry: Registry, policy?: ShorthandPolicy);
+    collapse(ops: readonly Op[], scope?: Scope | null): ScopeBag;
+    /**
+     * Apply the configured shorthand-policy check. Throws when the user
+     * mixes shorthand and longhand of the same family within a single
+     * scope in a way the policy forbids. The error message names both
+     * methods and points at the three escape hatches: modifier callback,
+     * looser `policy` config, or sticking to one form.
+     */
+    private checkShorthandPolicy;
+    private policyError;
+    /**
+     * Deterministic key derived from a scope tree.
+     *
+     * For static-only chains (no modifiers, no nested scopes) the format
+     * matches Phase 1 exactly — sorted entry pairs — so existing class
+     * hashes are preserved across the Phase 2 upgrade. Trees with any
+     * nested scope use the structured form, which encodes the full
+     * sorted scope-tree shape.
+     */
+    canonicalKey(tree: ScopeBag): string;
+}
+//# sourceMappingURL=canonicalizer.d.ts.map

package/dist/canonicalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonicalizer.d.ts","sourceRoot":"","sources":["../src/canonicalizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,EAAE,EACP,KAAK,KAAK,EACV,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,QAAQ,EAAiB,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,QAAQ,EAAE,QAAQ,EAClB,MAAM,GAAE,eAA0B;IAGrD,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,GAAE,KAAK,GAAG,IAAW,GAAG,QAAQ;IA4ElE;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAkC5B,OAAO,CAAC,WAAW;IAiBnB;;;;;;;;OAQG;IACH,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM;CAOrC"}

package/dist/canonicalizer.js

@@ -0,0 +1,185 @@
+import { DYNAMIC_PLACEHOLDER, isDynamic, isMethodOp, isRawOp, isScopedOp, } from './types.js';
+/**
+ * Walks an `Op[]` chain, LIFO-collapsing each scope's declarations and
+ * recursing into nested scoped sub-chains. The output is a deterministic
+ * `ScopeBag` tree: the root has `scope: null` and owns "base"
+ * declarations; each child carries its modifier (`:hover`, `@media (...)`,
+ * raw selector) plus its own bag and further children.
+ *
+ * Multiple scoped ops at the same scope key (e.g. two `.hover(...)`
+ * calls in the same chain) are merged: their inner ops are concatenated,
+ * then re-collapsed inside the merged scope. This matches the user's
+ * intuition that "`.hover()` adds, doesn't replace" while still
+ * applying property-level LIFO inside the merged scope.
+ */
+export class Canonicalizer {
+    registry;
+    policy;
+    constructor(registry, policy = 'strict') {
+        this.registry = registry;
+        this.policy = policy;
+    }
+    collapse(ops, scope = null) {
+        const bag = {};
+        const slots = {};
+        const childOpsByKey = new Map();
+        // Per-scope tracking for shorthand ↔ longhand co-occurrence.
+        // Recursion into ScopedOps creates a fresh `collapse` invocation
+        // with its own local `seenShorthand` / `seenLonghand`, so the
+        // `media`/`hover`/`on` scope automatically reset the constraint.
+        const seenShorthand = new Map();
+        const seenLonghand = new Map();
+        for (const op of ops) {
+            if (isMethodOp(op)) {
+                const entry = this.registry[op.method];
+                if (!entry) {
+                    throw new Error(`[cassida] unknown method "${op.method}". Add it to the registry or check for typos.`);
+                }
+                this.checkShorthandPolicy(op.method, entry, seenShorthand, seenLonghand);
+                const dynamics = op.args.filter(isDynamic);
+                if (dynamics.length === 0) {
+                    bag[entry.property] = entry.format(...op.args);
+                    delete slots[entry.property];
+                    continue;
+                }
+                if (op.args.length !== 1 || dynamics.length !== 1) {
+                    throw new Error(`[cassida] mixed/multi-dynamic args are not supported in this phase; method "${op.method}"`);
+                }
+                bag[entry.property] = DYNAMIC_PLACEHOLDER;
+                slots[entry.property] = dynamics[0].id;
+                continue;
+            }
+            if (isScopedOp(op)) {
+                const key = scopeKey(op.scope);
+                const existing = childOpsByKey.get(key);
+                if (existing) {
+                    existing.ops.push(...op.ops);
+                }
+                else {
+                    childOpsByKey.set(key, { scope: op.scope, ops: [...op.ops] });
+                }
+                continue;
+            }
+            if (isRawOp(op)) {
+                // RawOps bypass the registry entirely. They sit in the bag as
+                // pre-formatted CSS declarations. Shorthand-policy and family
+                // tracking deliberately do NOT apply — the user already opted
+                // out of the safety net by routing through `cas.unsafe`.
+                bag[op.property] = op.value;
+                delete slots[op.property];
+                continue;
+            }
+        }
+        const children = [];
+        for (const { scope: childScope, ops: childOps } of childOpsByKey.values()) {
+            children.push(this.collapse(childOps, childScope));
+        }
+        return {
+            scope,
+            bag,
+            slots,
+            children,
+        };
+    }
+    /**
+     * Apply the configured shorthand-policy check. Throws when the user
+     * mixes shorthand and longhand of the same family within a single
+     * scope in a way the policy forbids. The error message names both
+     * methods and points at the three escape hatches: modifier callback,
+     * looser `policy` config, or sticking to one form.
+     */
+    checkShorthandPolicy(methodName, entry, seenShorthand, seenLonghand) {
+        if (this.policy === 'lenient') {
+            // No-op, but still record so downstream code can introspect if needed.
+            if (entry.shorthandFamily)
+                seenShorthand.set(entry.shorthandFamily, methodName);
+            if (entry.longhandFamily)
+                seenLonghand.set(entry.longhandFamily, methodName);
+            return;
+        }
+        // longhand → shorthand check (strict only — the bug-prone direction).
+        if (entry.shorthandFamily) {
+            const family = entry.shorthandFamily;
+            const conflicting = seenLonghand.get(family);
+            if (this.policy === 'strict' && conflicting !== undefined) {
+                throw new Error(this.policyError('shorthand', methodName, conflicting, family));
+            }
+            seenShorthand.set(family, methodName);
+        }
+        // shorthand → longhand check (always — both 'strict' and 'shorthand-first').
+        if (entry.longhandFamily) {
+            const family = entry.longhandFamily;
+            const conflicting = seenShorthand.get(family);
+            if (conflicting !== undefined) {
+                throw new Error(this.policyError('longhand', methodName, conflicting, family));
+            }
+            seenLonghand.set(family, methodName);
+        }
+    }
+    policyError(incomingKind, incomingMethod, earlierMethod, family) {
+        const prior = incomingKind === 'shorthand' ? 'longhand' : 'shorthand';
+        return (`[cassida] ${incomingKind} "${incomingMethod}" cannot follow ${prior} "${earlierMethod}" ` +
+            `in the same scope (family: "${family}", policy: "${this.policy}"). ` +
+            `Resolve via one of:\n` +
+            `  • Use a modifier callback (.media(...), .hover(...), .on(...)) to scope them separately.\n` +
+            `  • Set "shorthand.policy" to "shorthand-first" or "lenient" in cassida.config.json.\n` +
+            `  • Stick to a single form (only shorthand, or only longhands) in this scope.`);
+    }
+    /**
+     * Deterministic key derived from a scope tree.
+     *
+     * For static-only chains (no modifiers, no nested scopes) the format
+     * matches Phase 1 exactly — sorted entry pairs — so existing class
+     * hashes are preserved across the Phase 2 upgrade. Trees with any
+     * nested scope use the structured form, which encodes the full
+     * sorted scope-tree shape.
+     */
+    canonicalKey(tree) {
+        if (tree.scope === null && tree.children.length === 0) {
+            const keys = Object.keys(tree.bag).sort();
+            return JSON.stringify(keys.map((k) => [k, tree.bag[k]]));
+        }
+        return JSON.stringify(serialize(tree));
+    }
+}
+function serialize(node) {
+    const bag = Object.keys(node.bag)
+        .sort()
+        .map((k) => [k, node.bag[k]]);
+    const sortedChildren = [...node.children].sort((a, b) => scopeOrderKey(a.scope).localeCompare(scopeOrderKey(b.scope)));
+    return {
+        s: serializeScope(node.scope),
+        b: bag,
+        c: sortedChildren.map(serialize),
+    };
+}
+function serializeScope(scope) {
+    if (scope === null)
+        return null;
+    if (scope.kind === 'pseudo')
+        return { k: 'pseudo', v: scope.selector };
+    if (scope.kind === 'media')
+        return { k: 'media', v: scope.query };
+    return { k: 'raw', v: scope.selector };
+}
+/**
+ * Stable string used to (a) identify same-scope ops in `collapse`, and
+ * (b) sort sibling children deterministically in `canonicalKey`.
+ *
+ * Pseudo scopes sort before media scopes before raw scopes, with
+ * lexicographic order within each group. This is purely a
+ * canonicalization device — emission ordering for output CSS is
+ * decided by the emitter (which uses the same prefix to keep `:hover`
+ * rules before `@media` rules in the output).
+ */
+function scopeKey(scope) {
+    return scopeOrderKey(scope);
+}
+function scopeOrderKey(scope) {
+    if (scope.kind === 'pseudo')
+        return `0
${scope.selector}`;
+    if (scope.kind === 'media')
+        return `1
${scope.query}`;
+    return `2
${scope.selector}`;
+}
+//# sourceMappingURL=canonicalizer.js.map

package/dist/canonicalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonicalizer.js","sourceRoot":"","sources":["../src/canonicalizer.ts"],"names":[],"mappings":"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"}

package/dist/compile.d.ts

@@ -0,0 +1,46 @@
+import { type CompiledRule, type Op } from './types.js';
+import type { Registry } from './registry.js';
+import { type HashOptions } from './hasher.js';
+import { type PropertyMeta } from './property-spec.js';
+import type { ShorthandPolicy } from './config.js';
+import { type CassPlugin, type PluginContext } from './plugin.js';
+export interface CompileOptions extends HashOptions {
+    readonly registry: Registry;
+    /**
+     * Override the property → metadata table used to enrich dynamic slots
+     * with `animatable` / `syntax` / `initialValue`. Defaults to the
+     * canonical spec's own metadata; only override when extending the
+     * registry with custom properties that need their own `@property`
+     * descriptors.
+     */
+    readonly propertyMeta?: Readonly<Record<string, PropertyMeta>>;
+    /**
+     * Policy for shorthand ↔ longhand co-occurrence within a single
+     * scope. Defaults to `'strict'`. See `ShorthandPolicy` in `config.ts`.
+     */
+    readonly shorthandPolicy?: ShorthandPolicy;
+    /**
+     * Build-time plugins. Each plugin receives the post-collapse
+     * `ScopeBag` tree and returns a new tree; the className is derived
+     * from the post-plugin form. Plugins run in array order.
+     */
+    readonly plugins?: readonly CassPlugin[];
+    /**
+     * Subset of resolved config exposed to plugins through their
+     * `PluginContext`. Optional — if omitted, plugins receive a minimal
+     * default context.
+     */
+    readonly pluginContext?: PluginContext;
+}
+/**
+ * Pure: an `Op[]` chain in, a deterministic `CompiledRule` out.
+ *
+ * The canonical key is computed from the *shape* of the scope tree (not
+ * concrete dynamic values), so chains with the same set of properties
+ * and modifiers collapse to the same className regardless of the
+ * dynamic source values. Each dynamic slot ends up in `dynamics` with a
+ * fresh `--<className>-<scope-segments>-<prop>` variable name; the
+ * parser uses these to populate the element's inline style.
+ */
+export declare function compileOps(ops: readonly Op[], options: CompileOptions): CompiledRule;
+//# sourceMappingURL=compile.d.ts.map

package/dist/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../src/compile.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,EAAE,EAIR,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAQ,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAgB,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAEhF,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IAC/D;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACzC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;CACxC;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,YAAY,CA0BpF"}

package/dist/compile.js

@@ -0,0 +1,84 @@
+import { DYNAMIC_PLACEHOLDER, } from './types.js';
+import { Canonicalizer } from './canonicalizer.js';
+import { hash } from './hasher.js';
+import { defaultPropertyMeta } from './property-spec.js';
+import { applyPlugins } from './plugin.js';
+/**
+ * Pure: an `Op[]` chain in, a deterministic `CompiledRule` out.
+ *
+ * The canonical key is computed from the *shape* of the scope tree (not
+ * concrete dynamic values), so chains with the same set of properties
+ * and modifiers collapse to the same className regardless of the
+ * dynamic source values. Each dynamic slot ends up in `dynamics` with a
+ * fresh `--<className>-<scope-segments>-<prop>` variable name; the
+ * parser uses these to populate the element's inline style.
+ */
+export function compileOps(ops, options) {
+    const canon = new Canonicalizer(options.registry, options.shorthandPolicy ?? 'strict');
+    const rawTree = canon.collapse(ops);
+    // Plugin pipeline: between collapse and canonicalKey so that any
+    // tree shape change (e.g. wrapping :hover in @media (hover: hover))
+    // propagates into the className. This is the FSS bijection
+    // contract: same hash ⇔ same final-state CSS.
+    const ctx = options.pluginContext ?? {
+        config: { layer: 'fss', importSource: '@cassida/core' },
+    };
+    const transformedTree = applyPlugins(rawTree, options.plugins, ctx);
+    const canonical = canon.canonicalKey(transformedTree);
+    const className = hash(canonical, options);
+    const meta = options.propertyMeta ?? defaultPropertyMeta;
+    const dynamics = [];
+    const tree = substituteVars(transformedTree, className, meta, dynamics, []);
+    return {
+        className,
+        tree,
+        canonical,
+        dynamics: Object.freeze(dynamics),
+    };
+}
+function substituteVars(node, className, meta, dynamics, scopePath) {
+    const newBag = {};
+    for (const prop of Object.keys(node.bag).sort()) {
+        const val = node.bag[prop];
+        if (val === DYNAMIC_PLACEHOLDER) {
+            const varName = makeVarName(className, scopePath, prop);
+            newBag[prop] = `var(${varName})`;
+            const m = meta[prop];
+            dynamics.push({
+                property: prop,
+                varName,
+                sourceId: node.slots[prop],
+                animatable: m?.animatable ?? false,
+                syntax: m?.syntax,
+                initialValue: m?.initialValue,
+                scopePath: [...scopePath],
+            });
+        }
+        else {
+            newBag[prop] = val;
+        }
+    }
+    const newChildren = node.children.map((c) => substituteVars(c, className, meta, dynamics, [...scopePath, c.scope]));
+    return {
+        scope: node.scope,
+        bag: Object.freeze(newBag),
+        slots: node.slots,
+        children: Object.freeze(newChildren),
+    };
+}
+function makeVarName(className, scopePath, prop) {
+    const parts = [className];
+    for (const s of scopePath) {
+        parts.push(scopeToVarSegment(s));
+    }
+    parts.push(prop);
+    return '--' + parts.join('-');
+}
+function scopeToVarSegment(s) {
+    if (s.kind === 'pseudo')
+        return s.selector.replace(/:/g, '_');
+    if (s.kind === 'media')
+        return 'm-' + s.query.replace(/[^a-zA-Z0-9]/g, '_');
+    return 'r-' + s.selector.replace(/[^a-zA-Z0-9]/g, '_');
+}
+//# sourceMappingURL=compile.js.map

package/dist/compile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.js","sourceRoot":"","sources":["../src/compile.ts"],"names":[],"mappings":"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"}