@craft-ts/style 0.7.0-beta.15

package/src/plugin/emit.js

@@ -0,0 +1,134 @@
+import { propertyRule } from "../lib/css-vars.js";
+import { prop } from "../lib/props/generated.js";
+import { clipOverflow, containerType, noClipping, scrollPort, } from "../lib/obligations.js";
+/** The layer order is fixed here so that no import order can change it. */
+export const LAYERS = [
+    'reset',
+    'tokens',
+    'components',
+    'variants',
+    'overrides',
+];
+/**
+ * Properties the vocabulary owns.
+ *
+ * The generated table, plus the ones only an obligation can write. `overflow`
+ * is in the second set and not the first on purpose: it is reachable through
+ * `provides(scrollPort.block)` and through nothing else.
+ */
+export const knownProperties = () => {
+    const known = new Set(Object.values(prop));
+    const specs = [
+        ...Object.values(scrollPort),
+        ...Object.values(noClipping),
+        ...Object.values(containerType),
+        ...Object.values(clipOverflow).map((entry) => entry.spec),
+    ];
+    for (const spec of specs) {
+        for (const declaration of spec.effect)
+            known.add(declaration.property);
+    }
+    return known;
+};
+export class UnknownCssError extends Error {
+    property;
+    source;
+    constructor(property, source) {
+        super(`craft-style: '${property}' is not a property of the vocabulary (emitted from ${source}). Nothing in the generated table produces it, so it reached the emitter through an escape hatch. Add it to the table or route it through an obligation.`);
+        this.property = property;
+        this.source = source;
+    }
+}
+/**
+ * The last net under the escape hatches.
+ *
+ * A keyword or property that slipped past the types would otherwise become CSS
+ * the browser silently drops — the exact failure the package exists to prevent,
+ * arriving at the last possible moment.
+ */
+export function validateAtoms(atoms, source = 'the style registry') {
+    const known = knownProperties();
+    for (const atom of atoms) {
+        // A custom property is declared by `cssVars`, which already registered its
+        // `@property` block; the table has nothing to say about it.
+        if (atom.property.startsWith('--'))
+            continue;
+        if (!known.has(atom.property)) {
+            throw new UnknownCssError(atom.property, source);
+        }
+    }
+}
+const escapeClass = (className) => `.${className.replace(/([^a-zA-Z0-9_-])/g, '\\$1')}`;
+/** An at-rule condition nests around the rule; a selector fragment joins it. */
+const isAtRule = (point) => point.open.startsWith('@');
+function ruleText(atom) {
+    const selector = atom.conditions
+        .filter((point) => !isAtRule(point))
+        .reduce((current, point) => point.open.replace('&', current), escapeClass(atom.className));
+    const body = `${selector}{${atom.property}:${atom.value}}`;
+    return atom.conditions
+        .filter(isAtRule)
+        .reduceRight((inner, point) => `${point.open}{${inner}}`, body);
+}
+const byName = (left, right) => left.className.localeCompare(right.className);
+/**
+ * The stylesheet.
+ *
+ * Unconditional atoms land in `components`, conditional ones in `variants`, so
+ * a variant always wins over the base without anyone counting selector
+ * specificity. Ordering is by class name rather than by registration order:
+ * the output must not depend on which module the bundler happened to load
+ * first, or two identical builds would produce two different files.
+ */
+export function renderCss(atoms, vars) {
+    const base = atoms
+        .filter((atom) => atom.conditions.length === 0)
+        .sort(byName);
+    const variants = atoms
+        .filter((atom) => atom.conditions.length > 0)
+        .sort(byName);
+    const properties = [...vars]
+        .sort((left, right) => left.name.localeCompare(right.name))
+        .map(propertyRule);
+    const sections = [
+        `@layer ${LAYERS.join(', ')};`,
+        properties.length ? `@layer tokens{${properties.join('')}}` : '',
+        base.length ? `@layer components{${base.map(ruleText).join('')}}` : '',
+        variants.length
+            ? `@layer variants{${variants.map(ruleText).join('')}}`
+            : '',
+    ];
+    return sections.filter(Boolean).join('\n') + '\n';
+}
+/**
+ * What the dependency graph consumes.
+ *
+ * Emitted by the plugin rather than re-derived by an AST pass: there is one
+ * graph and two producers, and a second, approximate evaluation of the DSL
+ * would disagree with this one sooner or later.
+ */
+export function styleDump(classes, atoms, vars) {
+    return {
+        classes: [...classes]
+            .sort((left, right) => left.key.localeCompare(right.key))
+            .map((registered) => ({
+            key: registered.key,
+            className: registered.className,
+            axes: registered.axes,
+            atoms: registered.rules.map((rule) => rule.className),
+            unproven: registered.unproven,
+            requires: registered.requires,
+            provides: registered.provides,
+            violates: registered.violates,
+        })),
+        atoms: [...atoms].sort(byName).map((atom) => ({
+            className: atom.className,
+            property: atom.property,
+            value: atom.value,
+            conditions: atom.conditions.map((point) => `${point.axis}:${point.point}`),
+            unproven: atom.unproven,
+        })),
+        vars: [...vars].sort((left, right) => left.name.localeCompare(right.name)),
+    };
+}
+//# sourceMappingURL=emit.js.map

package/src/plugin/emit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.js","sourceRoot":"","sources":["../../../../../libs/style/src/plugin/emit.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Turning the registry into CSS.\n *\n * This module is pure: registry in, stylesheet out. It never touches the\n * filesystem and never asks the typechecker anything — the types verify, the\n * values emit. Everything that reads files lives in `vite.ts`.\n *\n * Deduplication happened upstream, when the atoms were registered: two\n * components writing `padding: 1rem` under the same condition already share one\n * atom. What is left here is ordering, wrapping, and the last safety net —\n * validating that every property about to be written is one the vocabulary\n * actually owns.\n */\nimport type { AnyAxisPoint } from '../lib/axes/index.ts';\nimport type { AtomicRule, RegisteredClass } from '../lib/styles.ts';\nimport type { CssVarDeclaration } from '../lib/css-vars.ts';\nimport { propertyRule } from '../lib/css-vars.ts';\nimport { prop } from '../lib/props/generated.ts';\nimport {\n  clipOverflow,\n  containerType,\n  noClipping,\n  scrollPort,\n} from '../lib/obligations.ts';\n\n/** The layer order is fixed here so that no import order can change it. */\nexport const LAYERS = [\n  'reset',\n  'tokens',\n  'components',\n  'variants',\n  'overrides',\n] as const;\n\n/**\n * Properties the vocabulary owns.\n *\n * The generated table, plus the ones only an obligation can write. `overflow`\n * is in the second set and not the first on purpose: it is reachable through\n * `provides(scrollPort.block)` and through nothing else.\n */\nexport const knownProperties = (): ReadonlySet<string> => {\n  const known = new Set<string>(Object.values(prop));\n  const specs = [\n    ...Object.values(scrollPort),\n    ...Object.values(noClipping),\n    ...Object.values(containerType),\n    ...Object.values(clipOverflow).map((entry) => entry.spec),\n  ];\n  for (const spec of specs) {\n    for (const declaration of spec.effect) known.add(declaration.property);\n  }\n  return known;\n};\n\nexport class UnknownCssError extends Error {\n  readonly property: string;\n  readonly source: string;\n\n  constructor(property: string, source: string) {\n    super(\n      `craft-style: '${property}' is not a property of the vocabulary (emitted from ${source}). Nothing in the generated table produces it, so it reached the emitter through an escape hatch. Add it to the table or route it through an obligation.`,\n    );\n    this.property = property;\n    this.source = source;\n  }\n}\n\n/**\n * The last net under the escape hatches.\n *\n * A keyword or property that slipped past the types would otherwise become CSS\n * the browser silently drops — the exact failure the package exists to prevent,\n * arriving at the last possible moment.\n */\nexport function validateAtoms(\n  atoms: readonly AtomicRule[],\n  source = 'the style registry',\n): void {\n  const known = knownProperties();\n  for (const atom of atoms) {\n    // A custom property is declared by `cssVars`, which already registered its\n    // `@property` block; the table has nothing to say about it.\n    if (atom.property.startsWith('--')) continue;\n    if (!known.has(atom.property)) {\n      throw new UnknownCssError(atom.property, source);\n    }\n  }\n}\n\nconst escapeClass = (className: string): string =>\n  `.${className.replace(/([^a-zA-Z0-9_-])/g, '\\\\$1')}`;\n\n/** An at-rule condition nests around the rule; a selector fragment joins it. */\nconst isAtRule = (point: AnyAxisPoint): boolean => point.open.startsWith('@');\n\nfunction ruleText(atom: AtomicRule): string {\n  const selector = atom.conditions\n    .filter((point) => !isAtRule(point))\n    .reduce(\n      (current, point) => point.open.replace('&', current),\n      escapeClass(atom.className),\n    );\n  const body = `${selector}{${atom.property}:${atom.value}}`;\n  return atom.conditions\n    .filter(isAtRule)\n    .reduceRight((inner, point) => `${point.open}{${inner}}`, body);\n}\n\nconst byName = (left: AtomicRule, right: AtomicRule): number =>\n  left.className.localeCompare(right.className);\n\n/**\n * The stylesheet.\n *\n * Unconditional atoms land in `components`, conditional ones in `variants`, so\n * a variant always wins over the base without anyone counting selector\n * specificity. Ordering is by class name rather than by registration order:\n * the output must not depend on which module the bundler happened to load\n * first, or two identical builds would produce two different files.\n */\nexport function renderCss(\n  atoms: readonly AtomicRule[],\n  vars: readonly CssVarDeclaration[],\n): string {\n  const base = atoms\n    .filter((atom) => atom.conditions.length === 0)\n    .sort(byName);\n  const variants = atoms\n    .filter((atom) => atom.conditions.length > 0)\n    .sort(byName);\n  const properties = [...vars]\n    .sort((left, right) => left.name.localeCompare(right.name))\n    .map(propertyRule);\n\n  const sections = [\n    `@layer ${LAYERS.join(', ')};`,\n    properties.length ? `@layer tokens{${properties.join('')}}` : '',\n    base.length ? `@layer components{${base.map(ruleText).join('')}}` : '',\n    variants.length\n      ? `@layer variants{${variants.map(ruleText).join('')}}`\n      : '',\n  ];\n\n  return sections.filter(Boolean).join('\\n') + '\\n';\n}\n\nexport interface StyleDump {\n  readonly classes: readonly {\n    readonly key: string;\n    readonly className: string;\n    readonly axes: Readonly<Record<string, readonly string[]>>;\n    readonly atoms: readonly string[];\n    readonly unproven: readonly string[];\n    readonly requires: readonly string[];\n    readonly provides: readonly string[];\n    readonly violates: readonly string[];\n  }[];\n  readonly atoms: readonly {\n    readonly className: string;\n    readonly property: string;\n    readonly value: string;\n    readonly conditions: readonly string[];\n    readonly unproven: string;\n  }[];\n  readonly vars: readonly CssVarDeclaration[];\n}\n\n/**\n * What the dependency graph consumes.\n *\n * Emitted by the plugin rather than re-derived by an AST pass: there is one\n * graph and two producers, and a second, approximate evaluation of the DSL\n * would disagree with this one sooner or later.\n */\nexport function styleDump(\n  classes: readonly RegisteredClass[],\n  atoms: readonly AtomicRule[],\n  vars: readonly CssVarDeclaration[],\n): StyleDump {\n  return {\n    classes: [...classes]\n      .sort((left, right) => left.key.localeCompare(right.key))\n      .map((registered) => ({\n        key: registered.key,\n        className: registered.className,\n        axes: registered.axes,\n        atoms: registered.rules.map((rule) => rule.className),\n        unproven: registered.unproven,\n        requires: registered.requires,\n        provides: registered.provides,\n        violates: registered.violates,\n      })),\n    atoms: [...atoms].sort(byName).map((atom) => ({\n      className: atom.className,\n      property: atom.property,\n      value: atom.value,\n      conditions: atom.conditions.map(\n        (point) => `${point.axis}:${point.point}`,\n      ),\n      unproven: atom.unproven,\n    })),\n    vars: [...vars].sort((left, right) => left.name.localeCompare(right.name)),\n  };\n}\n"]}

package/src/plugin/vite.d.ts

@@ -0,0 +1,66 @@
+import type { AtomicRule, RegisteredClass } from '../lib/styles.ts';
+import type { CssVarDeclaration } from '../lib/css-vars.ts';
+import { type StyleDump } from './emit.ts';
+/**
+ * Re-exported so a consumer can build the graph dump without running a build —
+ * a test that already imported the sheets has the registry in hand.
+ */
+export { renderCss, styleDump, validateAtoms, type StyleDump } from './emit.ts';
+export declare const VIRTUAL_CSS_ID = "virtual:craft-style.css";
+export interface CraftStyleOptions {
+    /** File suffix that marks a style module. */
+    readonly suffix?: string;
+    /** Directory names never walked into. */
+    readonly ignore?: readonly string[];
+    /** Where to write the graph dump. Skipped when absent. */
+    readonly dumpPath?: string;
+    /** Module aliases for the Node evaluation, e.g. a workspace source path. */
+    readonly alias?: Readonly<Record<string, string>>;
+}
+interface Registry {
+    readonly classes: readonly RegisteredClass[];
+    readonly atoms: readonly AtomicRule[];
+    readonly vars: readonly CssVarDeclaration[];
+}
+/** Sorted, so that two runs on the same tree evaluate in the same order. */
+export declare function findStyleModules(root: string, suffix?: string, ignore?: readonly string[]): Promise<readonly string[]>;
+/** Bundles the given style modules and reads the registry they filled. */
+export declare function evaluateStyleModules(files: readonly string[], alias?: Readonly<Record<string, string>>): Promise<Registry>;
+export interface EmitResult {
+    readonly css: string;
+    readonly dump: StyleDump;
+}
+export declare function emitStyles(files: readonly string[], alias?: Readonly<Record<string, string>>): Promise<EmitResult>;
+/**
+ * Minimal shape of the Vite plugin object, declared here rather than imported.
+ *
+ * `vite` is a peer, not a dependency: a consumer building with something else
+ * can still call `emitStyles` without pulling Vite's types in.
+ */
+export interface CraftStylePlugin {
+    readonly name: string;
+    readonly enforce?: 'pre' | 'post';
+    configResolved?(config: {
+        readonly root: string;
+    }): void;
+    resolveId?(id: string): string | undefined;
+    load?(id: string): Promise<string | undefined>;
+    handleHotUpdate?(context: {
+        readonly file: string;
+        readonly server: {
+            readonly ws: {
+                send(message: {
+                    readonly type: 'full-reload';
+                    readonly path: '*';
+                }): void | Promise<void>;
+            };
+        };
+    }): void;
+}
+/**
+ * `import 'virtual:craft-style.css'` once, at the app entry, and the whole
+ * stylesheet arrives — built, not computed. No class is ever assembled at
+ * runtime, so what the browser gets is what the emitter proved.
+ */
+export declare function craftStyle(options?: CraftStyleOptions): CraftStylePlugin;
+//# sourceMappingURL=vite.d.ts.map

package/src/plugin/vite.d.ts.map

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

package/src/plugin/vite.js

@@ -0,0 +1,150 @@
+/**
+ * The Vite plugin: evaluate the style modules in Node, emit static CSS.
+ *
+ * The generation never goes through the typechecker API. The plugin imports the
+ * modules and reads the values they registered — which is why a `*.style.ts` is
+ * only allowed to import vocabulary (the `style-file-boundary` ESLint rule),
+ * and why importing one in Node is safe: there is no application code in it to
+ * run.
+ *
+ * Every style module is bundled into **one** synthetic entry before being
+ * imported. Importing them one by one would give each its own copy of the
+ * registry, and deduplication across files — the whole point of atomic
+ * emission — would quietly stop working.
+ *
+ * The bundler is Vite's own `build()` in SSR mode rather than esbuild called
+ * directly: Vite 8 no longer ships esbuild, and a plugin that reaches for a
+ * bundler its host does not have is a plugin that breaks on the next upgrade.
+ */
+import { mkdtemp, readdir, rm, writeFile } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { renderCss, styleDump, validateAtoms } from "./emit.js";
+/**
+ * Re-exported so a consumer can build the graph dump without running a build —
+ * a test that already imported the sheets has the registry in hand.
+ */
+export { renderCss, styleDump, validateAtoms } from "./emit.js";
+export const VIRTUAL_CSS_ID = 'virtual:craft-style.css';
+const RESOLVED_CSS_ID = '\0' + VIRTUAL_CSS_ID;
+const DEFAULT_IGNORED = ['node_modules', 'dist', '.git', '.nx', 'tmp'];
+/** Sorted, so that two runs on the same tree evaluate in the same order. */
+export async function findStyleModules(root, suffix = '.style.ts', ignore = DEFAULT_IGNORED) {
+    const found = [];
+    const walk = async (directory) => {
+        const entries = await readdir(directory, { withFileTypes: true });
+        for (const entry of entries) {
+            const path = join(directory, entry.name);
+            if (entry.isDirectory()) {
+                if (!ignore.includes(entry.name) && !entry.name.startsWith('.')) {
+                    await walk(path);
+                }
+            }
+            else if (entry.name.endsWith(suffix)) {
+                found.push(path);
+            }
+        }
+    };
+    await walk(root);
+    return found.sort();
+}
+/** Bundles the given style modules and reads the registry they filled. */
+export async function evaluateStyleModules(files, alias = {}) {
+    const { build } = await import('vite');
+    const directory = await mkdtemp(join(tmpdir(), 'craft-style-'));
+    try {
+        const entry = join(directory, 'entry.mjs');
+        // Each module is imported as a **namespace** and re-exported, not imported
+        // for its side effects. `@craft-ts/style` is marked `sideEffects: false`,
+        // so a bare side-effect import lets the bundler drop the very calls the
+        // registry is built from — silently, and only for some of them.
+        const sorted = [...files].sort();
+        const imports = sorted
+            .map((file, index) => `import * as module${index} from ${JSON.stringify(pathToFileURL(file).href)};`)
+            .join('\n');
+        const held = sorted.map((_, index) => `module${index}`).join(', ');
+        await writeFile(entry, `${imports}\nexport const evaluated = [${held}];\nexport { registeredAtoms, registeredClasses, registeredVars } from '@craft-ts/style';\n`);
+        await build({
+            configFile: false,
+            logLevel: 'silent',
+            resolve: { alias: { ...alias } },
+            // Nothing may stay external: an externalised `@craft-ts/style` would be
+            // resolved again at import time and hand back a second, empty registry.
+            ssr: { noExternal: true },
+            build: {
+                ssr: entry,
+                outDir: directory,
+                emptyOutDir: false,
+                minify: false,
+                write: true,
+                rollupOptions: {
+                    output: { format: 'cjs', entryFileNames: 'bundle.cjs' },
+                },
+            },
+        });
+        // Loaded through `require` rather than `import()`: a test runner sitting on
+        // top of this module intercepts dynamic imports and resolves them against
+        // its own module graph, where a file in a temp directory does not exist.
+        // `require` goes to the filesystem, in the runner and in a real build alike.
+        const module = createRequire(import.meta.url)(join(directory, 'bundle.cjs'));
+        return {
+            classes: module.registeredClasses(),
+            atoms: module.registeredAtoms(),
+            vars: module.registeredVars(),
+        };
+    }
+    finally {
+        await rm(directory, { recursive: true, force: true });
+    }
+}
+export async function emitStyles(files, alias) {
+    const registry = await evaluateStyleModules(files, alias);
+    validateAtoms(registry.atoms, files.join(', '));
+    return {
+        css: renderCss(registry.atoms, registry.vars),
+        dump: styleDump(registry.classes, registry.atoms, registry.vars),
+    };
+}
+/**
+ * `import 'virtual:craft-style.css'` once, at the app entry, and the whole
+ * stylesheet arrives — built, not computed. No class is ever assembled at
+ * runtime, so what the browser gets is what the emitter proved.
+ */
+export function craftStyle(options = {}) {
+    let root = process.cwd();
+    let cached;
+    return {
+        name: 'craft-style',
+        enforce: 'pre',
+        configResolved(config) {
+            root = config.root;
+        },
+        resolveId(id) {
+            return id === VIRTUAL_CSS_ID ? RESOLVED_CSS_ID : undefined;
+        },
+        async load(id) {
+            if (id !== RESOLVED_CSS_ID)
+                return undefined;
+            const files = await findStyleModules(root, options.suffix, options.ignore);
+            cached ??= await emitStyles(files, options.alias);
+            if (options.dumpPath) {
+                await writeFile(options.dumpPath, JSON.stringify(cached.dump, null, 2) + '\n');
+            }
+            return cached.css;
+        },
+        handleHotUpdate(context) {
+            // A style module changed: the whole sheet is re-derived rather than
+            // patched. Atomic output is small and the emission is one bundle away —
+            // an incremental path here would be a second source of truth. The
+            // stylesheet is a virtual module imported once by the app entry, so
+            // invalidating the cache alone would leave the browser on old CSS.
+            if (context.file.endsWith(options.suffix ?? '.style.ts')) {
+                cached = undefined;
+                context.server.ws.send({ type: 'full-reload', path: '*' });
+            }
+        },
+    };
+}
+//# sourceMappingURL=vite.js.map

package/src/plugin/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.js","sourceRoot":"","sources":["../../../../../libs/style/src/plugin/vite.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The Vite plugin: evaluate the style modules in Node, emit static CSS.\n *\n * The generation never goes through the typechecker API. The plugin imports the\n * modules and reads the values they registered — which is why a `*.style.ts` is\n * only allowed to import vocabulary (the `style-file-boundary` ESLint rule),\n * and why importing one in Node is safe: there is no application code in it to\n * run.\n *\n * Every style module is bundled into **one** synthetic entry before being\n * imported. Importing them one by one would give each its own copy of the\n * registry, and deduplication across files — the whole point of atomic\n * emission — would quietly stop working.\n *\n * The bundler is Vite's own `build()` in SSR mode rather than esbuild called\n * directly: Vite 8 no longer ships esbuild, and a plugin that reaches for a\n * bundler its host does not have is a plugin that breaks on the next upgrade.\n */\nimport { mkdtemp, readdir, rm, writeFile } from 'node:fs/promises';\nimport { createRequire } from 'node:module';\nimport { tmpdir } from 'node:os';\nimport { join } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport type { AtomicRule, RegisteredClass } from '../lib/styles.ts';\nimport type { CssVarDeclaration } from '../lib/css-vars.ts';\nimport { renderCss, styleDump, validateAtoms, type StyleDump } from './emit.ts';\n\n/**\n * Re-exported so a consumer can build the graph dump without running a build —\n * a test that already imported the sheets has the registry in hand.\n */\nexport { renderCss, styleDump, validateAtoms, type StyleDump } from './emit.ts';\n\nexport const VIRTUAL_CSS_ID = 'virtual:craft-style.css';\nconst RESOLVED_CSS_ID = '\\0' + VIRTUAL_CSS_ID;\n\nconst DEFAULT_IGNORED = ['node_modules', 'dist', '.git', '.nx', 'tmp'];\n\nexport interface CraftStyleOptions {\n  /** File suffix that marks a style module. */\n  readonly suffix?: string;\n  /** Directory names never walked into. */\n  readonly ignore?: readonly string[];\n  /** Where to write the graph dump. Skipped when absent. */\n  readonly dumpPath?: string;\n  /** Module aliases for the Node evaluation, e.g. a workspace source path. */\n  readonly alias?: Readonly<Record<string, string>>;\n}\n\ninterface Registry {\n  readonly classes: readonly RegisteredClass[];\n  readonly atoms: readonly AtomicRule[];\n  readonly vars: readonly CssVarDeclaration[];\n}\n\n/** Sorted, so that two runs on the same tree evaluate in the same order. */\nexport async function findStyleModules(\n  root: string,\n  suffix = '.style.ts',\n  ignore: readonly string[] = DEFAULT_IGNORED,\n): Promise<readonly string[]> {\n  const found: string[] = [];\n  const walk = async (directory: string): Promise<void> => {\n    const entries = await readdir(directory, { withFileTypes: true });\n    for (const entry of entries) {\n      const path = join(directory, entry.name);\n      if (entry.isDirectory()) {\n        if (!ignore.includes(entry.name) && !entry.name.startsWith('.')) {\n          await walk(path);\n        }\n      } else if (entry.name.endsWith(suffix)) {\n        found.push(path);\n      }\n    }\n  };\n  await walk(root);\n  return found.sort();\n}\n\n/** Bundles the given style modules and reads the registry they filled. */\nexport async function evaluateStyleModules(\n  files: readonly string[],\n  alias: Readonly<Record<string, string>> = {},\n): Promise<Registry> {\n  const { build } = await import('vite');\n  const directory = await mkdtemp(join(tmpdir(), 'craft-style-'));\n  try {\n    const entry = join(directory, 'entry.mjs');\n    // Each module is imported as a **namespace** and re-exported, not imported\n    // for its side effects. `@craft-ts/style` is marked `sideEffects: false`,\n    // so a bare side-effect import lets the bundler drop the very calls the\n    // registry is built from — silently, and only for some of them.\n    const sorted = [...files].sort();\n    const imports = sorted\n      .map(\n        (file, index) =>\n          `import * as module${index} from ${JSON.stringify(pathToFileURL(file).href)};`,\n      )\n      .join('\\n');\n    const held = sorted.map((_, index) => `module${index}`).join(', ');\n    await writeFile(\n      entry,\n      `${imports}\\nexport const evaluated = [${held}];\\nexport { registeredAtoms, registeredClasses, registeredVars } from '@craft-ts/style';\\n`,\n    );\n\n    await build({\n      configFile: false,\n      logLevel: 'silent',\n      resolve: { alias: { ...alias } },\n      // Nothing may stay external: an externalised `@craft-ts/style` would be\n      // resolved again at import time and hand back a second, empty registry.\n      ssr: { noExternal: true },\n      build: {\n        ssr: entry,\n        outDir: directory,\n        emptyOutDir: false,\n        minify: false,\n        write: true,\n        rollupOptions: {\n          output: { format: 'cjs', entryFileNames: 'bundle.cjs' },\n        },\n      },\n    });\n\n    // Loaded through `require` rather than `import()`: a test runner sitting on\n    // top of this module intercepts dynamic imports and resolves them against\n    // its own module graph, where a file in a temp directory does not exist.\n    // `require` goes to the filesystem, in the runner and in a real build alike.\n    const module = createRequire(import.meta.url)(\n      join(directory, 'bundle.cjs'),\n    ) as {\n      registeredClasses(): readonly RegisteredClass[];\n      registeredAtoms(): readonly AtomicRule[];\n      registeredVars(): readonly CssVarDeclaration[];\n    };\n    return {\n      classes: module.registeredClasses(),\n      atoms: module.registeredAtoms(),\n      vars: module.registeredVars(),\n    };\n  } finally {\n    await rm(directory, { recursive: true, force: true });\n  }\n}\n\nexport interface EmitResult {\n  readonly css: string;\n  readonly dump: StyleDump;\n}\n\nexport async function emitStyles(\n  files: readonly string[],\n  alias?: Readonly<Record<string, string>>,\n): Promise<EmitResult> {\n  const registry = await evaluateStyleModules(files, alias);\n  validateAtoms(registry.atoms, files.join(', '));\n  return {\n    css: renderCss(registry.atoms, registry.vars),\n    dump: styleDump(registry.classes, registry.atoms, registry.vars),\n  };\n}\n\n/**\n * Minimal shape of the Vite plugin object, declared here rather than imported.\n *\n * `vite` is a peer, not a dependency: a consumer building with something else\n * can still call `emitStyles` without pulling Vite's types in.\n */\nexport interface CraftStylePlugin {\n  readonly name: string;\n  readonly enforce?: 'pre' | 'post';\n  configResolved?(config: { readonly root: string }): void;\n  resolveId?(id: string): string | undefined;\n  load?(id: string): Promise<string | undefined>;\n  handleHotUpdate?(context: {\n    readonly file: string;\n    readonly server: {\n      readonly ws: {\n        send(message: {\n          readonly type: 'full-reload';\n          readonly path: '*';\n        }): void | Promise<void>;\n      };\n    };\n  }): void;\n}\n\n/**\n * `import 'virtual:craft-style.css'` once, at the app entry, and the whole\n * stylesheet arrives — built, not computed. No class is ever assembled at\n * runtime, so what the browser gets is what the emitter proved.\n */\nexport function craftStyle(options: CraftStyleOptions = {}): CraftStylePlugin {\n  let root = process.cwd();\n  let cached: EmitResult | undefined;\n\n  return {\n    name: 'craft-style',\n    enforce: 'pre',\n    configResolved(config) {\n      root = config.root;\n    },\n    resolveId(id) {\n      return id === VIRTUAL_CSS_ID ? RESOLVED_CSS_ID : undefined;\n    },\n    async load(id) {\n      if (id !== RESOLVED_CSS_ID) return undefined;\n      const files = await findStyleModules(\n        root,\n        options.suffix,\n        options.ignore,\n      );\n      cached ??= await emitStyles(files, options.alias);\n      if (options.dumpPath) {\n        await writeFile(\n          options.dumpPath,\n          JSON.stringify(cached.dump, null, 2) + '\\n',\n        );\n      }\n      return cached.css;\n    },\n    handleHotUpdate(context) {\n      // A style module changed: the whole sheet is re-derived rather than\n      // patched. Atomic output is small and the emission is one bundle away —\n      // an incremental path here would be a second source of truth. The\n      // stylesheet is a virtual module imported once by the app entry, so\n      // invalidating the cache alone would leave the browser on old CSS.\n      if (context.file.endsWith(options.suffix ?? '.style.ts')) {\n        cached = undefined;\n        context.server.ws.send({ type: 'full-reload', path: '*' });\n      }\n    },\n  };\n}\n"]}