@elastic/distillate 0.0.0 → 0.1.0

package/dist/cjs/var_invariant.js

@@ -0,0 +1,115 @@
+"use strict";
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertVarRefsHaveDeclarations = exports.findVarRefViolations = exports.collectReferencedCustomProperties = exports.collectDeclaredCustomProperties = void 0;
+const css_scan_1 = require("./css_scan");
+const DECLARATION_RE = /(--[A-Za-z_][\w-]*)\s*:/g;
+const REFERENCE_RE = /var\(\s*(--[A-Za-z_][\w-]*)/g;
+const scan = (css) => {
+    const masked = [];
+    const blockAt = [];
+    for (const span of (0, css_scan_1.scanCss)(css)) {
+        const blank = (0, css_scan_1.isOpaque)(span);
+        for (let offset = 0; offset < span.text.length; offset += 1) {
+            masked.push(blank ? ' ' : (span.text[offset] ?? ''));
+            blockAt.push(span.block);
+        }
+    }
+    return { masked: masked.join(''), blockAt };
+};
+/**
+ * A custom property is declared where a declaration can start: inside a
+ * declarations block, as the first thing after `{` or `;`. A selector carrying
+ * a BEM-style modifier and a pseudo-class (`.button--active:hover`) matches the
+ * same characters and declares nothing.
+ */
+const isDeclarationStart = ({ masked, blockAt }, index) => {
+    if (blockAt[index] !== 'declarations') {
+        return false;
+    }
+    for (let cursor = index - 1; cursor >= 0; cursor -= 1) {
+        const char = masked[cursor];
+        if (char === undefined || !/\s/.test(char)) {
+            return char === '{' || char === ';';
+        }
+    }
+    return false;
+};
+/**
+ * `var` has to open a function token rather than end a longer identifier:
+ * `--expr:myvar(--x)` names some other function.
+ */
+const isFunctionTokenStart = (masked, index) => {
+    const before = masked[index - 1];
+    return before === undefined || !/[\w\\-]/.test(before);
+};
+/** Collects every custom property declared in a declaration position in `css`. */
+const collectDeclaredCustomProperties = (css) => {
+    const scanned = scan(css);
+    const declared = new Set();
+    for (const match of scanned.masked.matchAll(DECLARATION_RE)) {
+        const name = match[1];
+        if (name && isDeclarationStart(scanned, match.index ?? 0)) {
+            declared.add(name);
+        }
+    }
+    return declared;
+};
+exports.collectDeclaredCustomProperties = collectDeclaredCustomProperties;
+/** Collects all custom property names referenced inside `var(...)` calls in `css`. */
+const collectReferencedCustomProperties = (css) => {
+    const { masked } = scan(css);
+    const names = [];
+    for (const match of masked.matchAll(REFERENCE_RE)) {
+        const name = match[1];
+        if (name && isFunctionTokenStart(masked, match.index ?? 0)) {
+            names.push(name);
+        }
+    }
+    return names;
+};
+exports.collectReferencedCustomProperties = collectReferencedCustomProperties;
+/**
+ * Returns all `var(...)` references whose custom property is never declared in `css`.
+ *
+ * @param css Full CSS text to scan.
+ */
+const findVarRefViolations = (css) => {
+    const { masked } = scan(css);
+    const declared = (0, exports.collectDeclaredCustomProperties)(css);
+    const violations = [];
+    for (const match of masked.matchAll(REFERENCE_RE)) {
+        const ref = match[1];
+        const index = match.index ?? 0;
+        if (!ref || declared.has(ref) || !isFunctionTokenStart(masked, index)) {
+            continue;
+        }
+        violations.push({
+            reference: ref,
+            context: css.slice(Math.max(0, index - 40), index + ref.length + 8),
+        });
+    }
+    return violations;
+};
+exports.findVarRefViolations = findVarRefViolations;
+/**
+ * Throws if any `var(...)` in `css` has no matching custom-property declaration.
+ *
+ * @param css Full CSS text to scan.
+ * @throws If any reference has no declaration in the same text.
+ */
+const assertVarRefsHaveDeclarations = (css) => {
+    const violations = (0, exports.findVarRefViolations)(css);
+    if (violations.length === 0) {
+        return;
+    }
+    const lines = violations.map(({ reference, context }) => `- ${reference} referenced near "${context.replace(/\s+/g, ' ')}"`);
+    throw new Error(`${violations.length} var(...) reference(s) without a matching declaration:\n${lines.join('\n')}`);
+};
+exports.assertVarRefsHaveDeclarations = assertVarRefsHaveDeclarations;
+//# sourceMappingURL=var_invariant.js.map

package/dist/cjs/var_invariant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"var_invariant.js","sourceRoot":"","sources":["../../src/var_invariant.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport { type CssBlockKind, isOpaque, scanCss } from './css_scan';\n\nconst DECLARATION_RE = /(--[A-Za-z_][\\w-]*)\\s*:/g;\nconst REFERENCE_RE = /var\\(\\s*(--[A-Za-z_][\\w-]*)/g;\n\n/** A `var(...)` whose custom property is never declared in the same CSS text. */\nexport interface VarInvariantViolation {\n  /** The undeclared custom property name (e.g. `--aui-color-bg`). */\n  readonly reference: string;\n  /** Surrounding CSS text for error reporting. */\n  readonly context: string;\n}\n\ninterface ScannedCss {\n  /**\n   * `css` with comments, strings, `url(...)` tokens, and escapes blanked to\n   * spaces, positions preserved. A `var(` inside a string is text, a `;`\n   * inside an escape is part of a value, and neither should match here.\n   */\n  readonly masked: string;\n  /** The enclosing block kind at each character offset. */\n  readonly blockAt: readonly CssBlockKind[];\n}\n\nconst scan = (css: string): ScannedCss => {\n  const masked: string[] = [];\n  const blockAt: CssBlockKind[] = [];\n  for (const span of scanCss(css)) {\n    const blank = isOpaque(span);\n    for (let offset = 0; offset < span.text.length; offset += 1) {\n      masked.push(blank ? ' ' : (span.text[offset] ?? ''));\n      blockAt.push(span.block);\n    }\n  }\n  return { masked: masked.join(''), blockAt };\n};\n\n/**\n * A custom property is declared where a declaration can start: inside a\n * declarations block, as the first thing after `{` or `;`. A selector carrying\n * a BEM-style modifier and a pseudo-class (`.button--active:hover`) matches the\n * same characters and declares nothing.\n */\nconst isDeclarationStart = (\n  { masked, blockAt }: ScannedCss,\n  index: number\n): boolean => {\n  if (blockAt[index] !== 'declarations') {\n    return false;\n  }\n  for (let cursor = index - 1; cursor >= 0; cursor -= 1) {\n    const char = masked[cursor];\n    if (char === undefined || !/\\s/.test(char)) {\n      return char === '{' || char === ';';\n    }\n  }\n  return false;\n};\n\n/**\n * `var` has to open a function token rather than end a longer identifier:\n * `--expr:myvar(--x)` names some other function.\n */\nconst isFunctionTokenStart = (masked: string, index: number): boolean => {\n  const before = masked[index - 1];\n  return before === undefined || !/[\\w\\\\-]/.test(before);\n};\n\n/** Collects every custom property declared in a declaration position in `css`. */\nexport const collectDeclaredCustomProperties = (css: string): Set<string> => {\n  const scanned = scan(css);\n  const declared = new Set<string>();\n  for (const match of scanned.masked.matchAll(DECLARATION_RE)) {\n    const name = match[1];\n    if (name && isDeclarationStart(scanned, match.index ?? 0)) {\n      declared.add(name);\n    }\n  }\n  return declared;\n};\n\n/** Collects all custom property names referenced inside `var(...)` calls in `css`. */\nexport const collectReferencedCustomProperties = (\n  css: string\n): readonly string[] => {\n  const { masked } = scan(css);\n  const names: string[] = [];\n  for (const match of masked.matchAll(REFERENCE_RE)) {\n    const name = match[1];\n    if (name && isFunctionTokenStart(masked, match.index ?? 0)) {\n      names.push(name);\n    }\n  }\n  return names;\n};\n\n/**\n * Returns all `var(...)` references whose custom property is never declared in `css`.\n *\n * @param css Full CSS text to scan.\n */\nexport const findVarRefViolations = (\n  css: string\n): readonly VarInvariantViolation[] => {\n  const { masked } = scan(css);\n  const declared = collectDeclaredCustomProperties(css);\n  const violations: VarInvariantViolation[] = [];\n  for (const match of masked.matchAll(REFERENCE_RE)) {\n    const ref = match[1];\n    const index = match.index ?? 0;\n    if (!ref || declared.has(ref) || !isFunctionTokenStart(masked, index)) {\n      continue;\n    }\n    violations.push({\n      reference: ref,\n      context: css.slice(Math.max(0, index - 40), index + ref.length + 8),\n    });\n  }\n  return violations;\n};\n\n/**\n * Throws if any `var(...)` in `css` has no matching custom-property declaration.\n *\n * @param css Full CSS text to scan.\n * @throws If any reference has no declaration in the same text.\n */\nexport const assertVarRefsHaveDeclarations = (css: string): void => {\n  const violations = findVarRefViolations(css);\n  if (violations.length === 0) {\n    return;\n  }\n  const lines = violations.map(\n    ({ reference, context }) =>\n      `- ${reference} referenced near \"${context.replace(/\\s+/g, ' ')}\"`\n  );\n  throw new Error(\n    `${violations.length} var(...) reference(s) without a matching declaration:\\n${lines.join('\\n')}`\n  );\n};\n"]}

package/dist/collector.d.ts

@@ -0,0 +1,84 @@
+import { type StyleNameMode, type StyleNameResolver, type StyleTarget } from './names.js';
+import type { ContextualVarPath, StyleEntry, StyleHandle, StyleRegistry, StylesModule } from './styles/index.js';
+/** Target, naming mode, registry, and prefix for one {@link StylesCollector}. */
+export interface StylesCollectorOptions {
+    /** Target context (e.g. `artifact` or `stylesheet`). */
+    target: StyleTarget;
+    /** Desired name mode (`compact` or `readable`). */
+    names: StyleNameMode;
+    /** Registry modules were authored against; used for auto-collection and compact-name snapshots. */
+    registry: StyleRegistry;
+    /** Brand prefix forwarded to the name resolver. */
+    prefix: string;
+    /** When `true`, emit no-op-handle warnings through `warn`. Inherited from `createDistillery({ dev })`. */
+    dev?: boolean;
+    /** Warning sink for no-op handles. Used only when `dev` is `true`. Defaults to `console.warn`. */
+    warn?: (message: string) => void;
+}
+/** Reachable entries for one render or one stylesheet. */
+export declare class StylesCollector {
+    /** The target collection mode. */
+    readonly target: StyleTarget;
+    /** The naming mode (compact vs readable). */
+    readonly names: StyleNameMode;
+    /** Associated registry. */
+    readonly registry: StyleRegistry;
+    /** Emitted class name prefix. */
+    readonly prefix: string;
+    private readonly dev;
+    private readonly warn;
+    private readonly entries;
+    private readonly handles;
+    private readonly themeDeps;
+    private readonly varDeps;
+    constructor({ target, names, registry, prefix, dev, warn, }: StylesCollectorOptions);
+    /**
+     * Collects a module's non-variant entries, or one explicit entry.
+     *
+     * Variant entries stay off this path; collect them via `useHandles`.
+     *
+     * @param value Module (all non-variant entries), a single entry, or an array of entries.
+     */
+    use(value: StylesModule | StyleEntry | readonly StyleEntry[]): void;
+    /**
+     * Collects every entry on `module`, including variants. Used by the stylesheet target.
+     *
+     * @param module Module whose entries should all be collected.
+     */
+    useAllEntries(module: StylesModule): void;
+    /**
+     * Collects handles and auto-includes rules whose selector deps are all present.
+     *
+     * Media blocks include only inner rules whose deps are met.
+     *
+     * @param handles Handles resolved during this render pass (e.g. from `resolveClassName`).
+     * @returns Handles that were retained. Empty untargeted handles are omitted in compact mode.
+     */
+    useHandles(handles: readonly StyleHandle[]): readonly StyleHandle[];
+    /** Collects `auto` rules on `module` whose every selector dependency is already collected. */
+    useRulesWhenDepsMet(module: StylesModule): void;
+    private tryActivateDependent;
+    private allDepsMet;
+    /** Marks a theme token path as reachable so it appears in the emitted theme block, even if no collected declaration reads it. */
+    useThemeVar(path: string): void;
+    /** Creates a {@link StyleNameResolver} scoped to this collector's current dep set. */
+    createResolver(): StyleNameResolver;
+    /** Collected style entries sorted for emission (base rules before all `@media`/`@container` blocks). */
+    get collectedEntries(): readonly StyleEntry[];
+    /** Theme token paths that survive reachability; emitted in the theme scope block. */
+    get collectedThemeDeps(): ReadonlySet<string>;
+    /** Contextual var paths that survive reachability; used by the runtime for compact-name substitution. */
+    get collectedVarDeps(): ReadonlySet<ContextualVarPath>;
+    /**
+     * Returns the variable keys within `groupPath` that are reachable from `handle` or from any collected rule targeting it.
+     *
+     * @param handle Handle whose declaration refs and dependent rules are consulted.
+     * @param groupPath Group prefix path (e.g. `vars/chip/look`).
+     */
+    reachableDefaults(handle: StyleHandle, groupPath: `vars/${string}`): ReadonlySet<string>;
+    private finalizeDeps;
+    private retainHandle;
+    private addEntry;
+    private addDeclarationDeps;
+}
+//# sourceMappingURL=collector.d.ts.map

package/dist/collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../src/collector.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EACjB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EACV,iBAAiB,EAIjB,UAAU,EACV,WAAW,EAEX,aAAa,EAEb,YAAY,EACb,MAAM,UAAU,CAAC;AA0DlB,iFAAiF;AACjF,MAAM,WAAW,sBAAsB;IACrC,wDAAwD;IACxD,MAAM,EAAE,WAAW,CAAC;IACpB,mDAAmD;IACnD,KAAK,EAAE,aAAa,CAAC;IACrB,mGAAmG;IACnG,QAAQ,EAAE,aAAa,CAAC;IACxB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,0GAA0G;IAC1G,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,kGAAkG;IAClG,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,0DAA0D;AAC1D,qBAAa,eAAe;IAC1B,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,2BAA2B;IAC3B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAU;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;gBAE5C,EACV,MAAM,EACN,KAAK,EACL,QAAQ,EACR,MAAM,EACN,GAAW,EACX,IAAyC,GAC1C,EAAE,sBAAsB;IASzB;;;;;;OAMG;IACH,GAAG,CAAC,KAAK,EAAE,YAAY,GAAG,UAAU,GAAG,SAAS,UAAU,EAAE,GAAG,IAAI;IA0CnE;;;;OAIG;IACH,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAiBzC;;;;;;;OAOG;IACH,UAAU,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,SAAS,WAAW,EAAE;IA0BnE,8FAA8F;IAC9F,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAc/C,OAAO,CAAC,oBAAoB;IAgC5B,OAAO,CAAC,UAAU;IASlB,iIAAiI;IACjI,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI/B,sFAAsF;IACtF,cAAc,IAAI,iBAAiB;IAiBnC,wGAAwG;IACxG,IAAI,gBAAgB,IAAI,SAAS,UAAU,EAAE,CAE5C;IAED,qFAAqF;IACrF,IAAI,kBAAkB,IAAI,WAAW,CAAC,MAAM,CAAC,CAE5C;IAED,yGAAyG;IACzG,IAAI,gBAAgB,IAAI,WAAW,CAAC,iBAAiB,CAAC,CAErD;IAOD;;;;;OAKG;IACH,iBAAiB,CACf,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,QAAQ,MAAM,EAAE,GAC1B,WAAW,CAAC,MAAM,CAAC;IAoCtB,OAAO,CAAC,YAAY;IAwCpB,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,QAAQ;IAmBhB,OAAO,CAAC,kBAAkB;CAI3B"}

package/dist/collector.js

@@ -0,0 +1,416 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import { isLocalVarOverrideMarker } from './local_vars.js';
+import { createStyleNameResolver, } from './names.js';
+import { isEmptyDeclarations } from './styles/declarations.js';
+const warnedHandles = new WeakSet();
+const dependentEntriesCache = new WeakMap();
+const dependentEntries = (module, handleKey) => {
+    let cached = dependentEntriesCache.get(module);
+    if (!cached) {
+        cached = new Map();
+        for (const entry of module.entries) {
+            if (entry.kind === 'rule') {
+                if (!entry.auto) {
+                    continue;
+                }
+                for (const dep of entry.dependsOn) {
+                    appendDependent(cached, dep, entry);
+                }
+                continue;
+            }
+            if (entry.kind === 'media') {
+                const deps = new Set();
+                for (const nested of entry.rules) {
+                    if (!nested.auto) {
+                        continue;
+                    }
+                    nested.dependsOn.forEach((key) => deps.add(key));
+                }
+                for (const dep of deps) {
+                    appendDependent(cached, dep, entry);
+                }
+            }
+        }
+        dependentEntriesCache.set(module, cached);
+    }
+    return cached.get(handleKey) ?? [];
+};
+const appendDependent = (cache, key, entry) => {
+    const list = cache.get(key);
+    if (list) {
+        list.push(entry);
+        return;
+    }
+    cache.set(key, [entry]);
+};
+/** Reachable entries for one render or one stylesheet. */
+export class StylesCollector {
+    /** The target collection mode. */
+    target;
+    /** The naming mode (compact vs readable). */
+    names;
+    /** Associated registry. */
+    registry;
+    /** Emitted class name prefix. */
+    prefix;
+    dev;
+    warn;
+    entries = new Map();
+    handles = new Map();
+    themeDeps = new Set();
+    varDeps = new Set();
+    constructor({ target, names, registry, prefix, dev = false, warn = (message) => console.warn(message), }) {
+        this.target = target;
+        this.names = names;
+        this.registry = registry;
+        this.prefix = prefix;
+        this.dev = dev;
+        this.warn = warn;
+    }
+    /**
+     * Collects a module's non-variant entries, or one explicit entry.
+     *
+     * Variant entries stay off this path; collect them via `useHandles`.
+     *
+     * @param value Module (all non-variant entries), a single entry, or an array of entries.
+     */
+    use(value) {
+        if (isReadonlyArray(value)) {
+            value.forEach((entry) => this.use(entry));
+            return;
+        }
+        if (isStylesModule(value)) {
+            // Aggregate deps from non-variant entries only. The module-level
+            // `themeDeps`/`varDeps` snapshot would also include variant entries'
+            // deps, which would push their var paths into the resolver's compact
+            // registry and steal short names from actually-rendered handles.
+            for (const entry of value.entries) {
+                if (entry.variant) {
+                    continue;
+                }
+                if (entry.kind === 'handle' && !this.retainHandle(entry)) {
+                    continue;
+                }
+                this.entries.set(entryKey(entry), entry);
+                if (entry.kind === 'handle' || entry.kind === 'rule') {
+                    this.addDeclarationDeps(entry.declarations);
+                }
+                else {
+                    for (const inner of entry.rules) {
+                        this.addDeclarationDeps(inner.declarations);
+                    }
+                }
+            }
+            for (const handle of value.handleList) {
+                if (handle.variant) {
+                    continue;
+                }
+                if (!this.retainHandle(handle)) {
+                    continue;
+                }
+                this.handles.set(handle.key, handle);
+            }
+            return;
+        }
+        this.addEntry(value);
+    }
+    /**
+     * Collects every entry on `module`, including variants. Used by the stylesheet target.
+     *
+     * @param module Module whose entries should all be collected.
+     */
+    useAllEntries(module) {
+        for (const entry of module.entries) {
+            if (entry.kind === 'handle' && !this.retainHandle(entry)) {
+                continue;
+            }
+            this.entries.set(entryKey(entry), entry);
+        }
+        for (const handle of module.handleList) {
+            if (!this.retainHandle(handle)) {
+                continue;
+            }
+            this.handles.set(handle.key, handle);
+        }
+        module.themeDeps.forEach((path) => this.themeDeps.add(path));
+        module.varDeps.forEach((path) => this.varDeps.add(path));
+    }
+    /**
+     * Collects handles and auto-includes rules whose selector deps are all present.
+     *
+     * Media blocks include only inner rules whose deps are met.
+     *
+     * @param handles Handles resolved during this render pass (e.g. from `resolveClassName`).
+     * @returns Handles that were retained. Empty untargeted handles are omitted in compact mode.
+     */
+    useHandles(handles) {
+        const retained = [];
+        for (const handle of handles) {
+            if (!this.retainHandle(handle)) {
+                continue;
+            }
+            retained.push(handle);
+            if (this.handles.has(handle.key)) {
+                continue;
+            }
+            this.entries.set(entryKey(handle), handle);
+            this.handles.set(handle.key, handle);
+            this.addDeclarationDeps(handle.declarations);
+        }
+        for (const handle of retained) {
+            const module = this.registry.module(handle.moduleName);
+            if (!module) {
+                continue;
+            }
+            for (const dependent of dependentEntries(module, handle.key)) {
+                this.tryActivateDependent(dependent);
+            }
+        }
+        return retained;
+    }
+    /** Collects `auto` rules on `module` whose every selector dependency is already collected. */
+    useRulesWhenDepsMet(module) {
+        for (const entry of module.entries) {
+            if (entry.kind !== 'rule') {
+                continue;
+            }
+            if (this.entries.has(entryKey(entry))) {
+                continue;
+            }
+            if (this.allDepsMet(entry.dependsOn)) {
+                this.addEntry(entry);
+            }
+        }
+    }
+    tryActivateDependent(entry) {
+        if (entry.kind === 'rule') {
+            if (!entry.auto) {
+                return;
+            }
+            if (this.entries.has(entryKey(entry))) {
+                return;
+            }
+            if (!this.allDepsMet(entry.dependsOn)) {
+                return;
+            }
+            this.addEntry(entry);
+            return;
+        }
+        if (entry.kind === 'media') {
+            const liveRules = entry.rules.filter((rule) => rule.auto && this.allDepsMet(rule.dependsOn));
+            if (liveRules.length === 0) {
+                return;
+            }
+            const filtered = liveRules.length === entry.rules.length
+                ? entry
+                : { ...entry, rules: liveRules };
+            this.entries.set(entryKey(filtered), filtered);
+            for (const rule of liveRules) {
+                this.addDeclarationDeps(rule.declarations);
+            }
+        }
+    }
+    allDepsMet(dependsOn) {
+        for (const dep of dependsOn) {
+            if (!this.handles.has(dep)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /** Marks a theme token path as reachable so it appears in the emitted theme block, even if no collected declaration reads it. */
+    useThemeVar(path) {
+        this.themeDeps.add(path);
+    }
+    /** Creates a {@link StyleNameResolver} scoped to this collector's current dep set. */
+    createResolver() {
+        const finalized = this.finalizeDeps();
+        const snapshot = this.registry.freeze({
+            classKeys: this.names === 'compact'
+                ? [...this.handles.keys()]
+                : this.registry.classKeys,
+            cssVarKeys: cssVarKeysFrom(finalized),
+        });
+        return createStyleNameResolver({
+            names: this.names,
+            prefix: this.prefix,
+            classKeys: snapshot.classKeys,
+            cssVarKeys: snapshot.cssVarKeys,
+        });
+    }
+    /** Collected style entries sorted for emission (base rules before all `@media`/`@container` blocks). */
+    get collectedEntries() {
+        return [...this.entries.values()].sort(compareEntriesForEmission);
+    }
+    /** Theme token paths that survive reachability; emitted in the theme scope block. */
+    get collectedThemeDeps() {
+        return this.finalizeDeps().theme;
+    }
+    /** Contextual var paths that survive reachability; used by the runtime for compact-name substitution. */
+    get collectedVarDeps() {
+        return this.finalizeDeps().vars;
+    }
+    // Reachability-aware default-emission set used by the runtime. For a
+    // given handle and `${group}` site, returns the keys whose declarations
+    // should ship: union of group-keys appearing in `handle.declarations.deps.refs`
+    // and in `deps.refs` of every collected rule/media-inner-rule whose
+    // selector targets `handle`.
+    /**
+     * Returns the variable keys within `groupPath` that are reachable from `handle` or from any collected rule targeting it.
+     *
+     * @param handle Handle whose declaration refs and dependent rules are consulted.
+     * @param groupPath Group prefix path (e.g. `vars/chip/look`).
+     */
+    reachableDefaults(handle, groupPath) {
+        const groupPrefix = `${groupPath}/`;
+        const reachable = new Set();
+        const harvest = (refs) => {
+            for (const path of refs) {
+                if (path.startsWith(groupPrefix)) {
+                    reachable.add(path.slice(groupPrefix.length));
+                }
+            }
+        };
+        harvest(handle.declarations.deps.refs);
+        for (const entry of this.entries.values()) {
+            if (entry.kind === 'rule') {
+                if (entry.dependsOn.has(handle.key)) {
+                    harvest(entry.declarations.deps.refs);
+                }
+                continue;
+            }
+            if (entry.kind === 'media') {
+                for (const innerRule of entry.rules) {
+                    if (innerRule.dependsOn.has(handle.key)) {
+                        harvest(innerRule.declarations.deps.refs);
+                    }
+                }
+            }
+        }
+        return reachable;
+    }
+    // Computes the final theme/var dep sets, folding in default-marker
+    // contributions only for keys that survive reachability. Called once per
+    // `createResolver()` and per `collectedThemeDeps`/`collectedVarDeps`
+    // access; collection mutations between calls re-derive the result.
+    finalizeDeps() {
+        const theme = new Set(this.themeDeps);
+        const vars = new Set(this.varDeps);
+        for (const handle of this.handles.values()) {
+            for (const group of handle.declarations.deps.defaults) {
+                const reachable = this.reachableDefaults(handle, group.groupPath);
+                for (const item of group.keys) {
+                    if (!reachable.has(item.key)) {
+                        continue;
+                    }
+                    vars.add(item.path);
+                    item.valueDeps.theme.forEach((path) => theme.add(path));
+                    item.valueDeps.vars.forEach((path) => vars.add(path));
+                }
+            }
+        }
+        // Default markers inside rule / media-inner-rule declarations don't have
+        // a host handle to anchor reachability against. The runtime emits every
+        // listed key when rendering such a declaration, so we mirror that here
+        // and include all of them in the registry.
+        for (const entry of this.entries.values()) {
+            if (entry.kind === 'rule') {
+                includeAllDefaults(entry.declarations.deps.defaults, theme, vars);
+                continue;
+            }
+            if (entry.kind === 'media') {
+                for (const inner of entry.rules) {
+                    includeAllDefaults(inner.declarations.deps.defaults, theme, vars);
+                }
+            }
+        }
+        return { theme, vars };
+    }
+    retainHandle(handle) {
+        if (!isEmptyDeclarations(handle.declarations)) {
+            return true;
+        }
+        if (this.registry.targetsHandle(handle.key)) {
+            return true;
+        }
+        if (this.dev && !warnedHandles.has(handle)) {
+            warnedHandles.add(handle);
+            this.warn(`Style module "${handle.moduleName}" handle "${handle.localName}" has no declarations and no rule targets it; delete the empty template.`);
+        }
+        return this.names !== 'compact';
+    }
+    addEntry(entry) {
+        if (entry.kind === 'handle' && !this.retainHandle(entry)) {
+            return;
+        }
+        this.entries.set(entryKey(entry), entry);
+        if (entry.kind === 'handle') {
+            this.handles.set(entry.key, entry);
+            this.addDeclarationDeps(entry.declarations);
+            return;
+        }
+        if (entry.kind === 'rule') {
+            this.addDeclarationDeps(entry.declarations);
+            return;
+        }
+        for (const rule of entry.rules) {
+            this.addDeclarationDeps(rule.declarations);
+        }
+    }
+    addDeclarationDeps(declarations) {
+        declarations.deps.theme.forEach((path) => this.themeDeps.add(path));
+        declarations.deps.vars.forEach((path) => this.varDeps.add(path));
+    }
+}
+const includeAllDefaults = (defaults, theme, vars) => {
+    for (const group of defaults) {
+        for (const item of group.keys) {
+            vars.add(item.path);
+            item.valueDeps.theme.forEach((path) => theme.add(path));
+            item.valueDeps.vars.forEach((path) => vars.add(path));
+        }
+    }
+};
+const cssVarKeysFrom = (finalized) => {
+    const keys = new Set();
+    finalized.theme.forEach((path) => keys.add(path));
+    finalized.vars.forEach((path) => keys.add(path));
+    return [...keys].sort();
+};
+const entryKey = (entry) => {
+    if (entry.kind === 'media') {
+        return `media/${entry.key}`;
+    }
+    return entry.key;
+};
+const mediaSortRank = (entry) => entry.kind === 'media' ? 1 : 0;
+const localVarOverrideRank = (entry) => {
+    if (entry.kind === 'media') {
+        return 0;
+    }
+    return entry.declarations.css.some(isLocalVarOverrideMarker) ? 1 : 0;
+};
+// Base entries before every `@media`/`@container` block (no specificity). See finding `media-block-ordering`.
+// `${group.set()}` after `${group}` defaults so a stacked override class wins. See finding `local-var-override-ordering`.
+const compareEntriesForEmission = (a, b) => {
+    const rankDelta = mediaSortRank(a) - mediaSortRank(b);
+    if (rankDelta !== 0) {
+        return rankDelta;
+    }
+    const varDelta = localVarOverrideRank(a) - localVarOverrideRank(b);
+    if (varDelta !== 0) {
+        return varDelta;
+    }
+    if (a.moduleName !== b.moduleName) {
+        return a.moduleName.localeCompare(b.moduleName);
+    }
+    return a.key.localeCompare(b.key);
+};
+const isReadonlyArray = (value) => Array.isArray(value);
+const isStylesModule = (value) => 'handles' in value && 'handleList' in value;
+//# sourceMappingURL=collector.js.map