@zslabs/atomic-css-modules 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+All notable changes to `@zslabs/atomic-css-modules` are documented here.
+
+## 0.1.0
+
+- Initial release: Vite plugin and `processCssModules` core API
+- Shared atomic registry via CSS Modules `composes`
+- Eligibility for single local classes, simple trailing pseudos, and nested at-rules
+- Shorthand/longhand conflict handling and `/* atomic: skip */`

package/GUIDE.md

@@ -0,0 +1,32 @@
+# atomic-css-modules internals
+
+Eligibility and compose constraints. For install and options, see the [package README](./README.md).
+
+## What selectors are supported
+
+CSS Modules only allows `composes` on a **single local class**. Eligibility mirrors that:
+
+| Shape                                                         | Atomized?                                  |
+| ------------------------------------------------------------- | ------------------------------------------ |
+| `.card`                                                       | Yes                                        |
+| `.card:hover` / `.card::before` (one trailing simple pseudo)  | Yes — pseudo is hoisted onto the atom      |
+| `.a, .b` when every member is a local class (± simple pseudo) | Yes — split into per-class compose targets |
+| Combinators, compounds, elements, attributes, IDs, `:root`    | No                                         |
+| `.a, div` (mixed group)                                       | No                                         |
+| `:not()`, `:nth-child()`, chained `:hover:focus`              | No                                         |
+
+A trailing simple pseudo-class or pseudo-element (no arguments) is eligible. Functional or multiple trailing pseudos are not: they cannot map to one shared atom plus Modules `composes`.
+
+## Shorthand and longhand
+
+If a rule has a shorthand and any of its longhands (`margin` + `margin-left`), neither those properties atomize for that rule. Sibling longhands of the same shorthand (`font-family` + `font-size`) still do.
+
+## Size and compression
+
+Raw registry bytes can shrink when the same declarations repeat. Over the wire, gzip/brotli often close the gap on small stylesheets; savings show up at scale when many components share a design-token surface. See [Caveats](./README.md#caveats) in the README.
+
+## Non-goals
+
+- Cross-file cascade / specificity modeling
+- Atomizing combinators or compounds while still using Modules `composes`
+- Reimplementing CSS Modules compose resolution here

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zach Schnackel
+
+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/README.md

@@ -0,0 +1,121 @@
+# @zslabs/atomic-css-modules
+
+Extracts repeated CSS Modules declarations into shared atomic classes via `composes`.
+
+## Requirements
+
+- **Node.js** `>=20.17` or `>=22.5` (uses `path.matchesGlob`)
+- **CSS Modules** source (`.module.css`)
+- **Vite** `^8` when using the Vite plugin (`vite` is an optional peer)
+
+The core `processCssModules` API has no Vite dependency.
+
+## Install
+
+```sh
+npm install @zslabs/atomic-css-modules
+```
+
+```ts
+import { defineConfig } from 'vite'
+import { atomicCssModules } from '@zslabs/atomic-css-modules/vite'
+
+export default defineConfig({
+  plugins: [
+    atomicCssModules({
+      include: ['src/**/*.module.css'],
+    }),
+  ],
+})
+```
+
+| Option       | Default                           | Notes                                               |
+| ------------ | --------------------------------- | --------------------------------------------------- |
+| `include`    | `**/*.module.css`                 | Globs relative to the Vite root                     |
+| `exclude`    | `**/node_modules/**`              |                                                     |
+| `debugNames` | `true` in serve, `false` in build | Readable atoms (`color-red-a1b2c3`) vs short hashes |
+| `report`     | `"summary"`                       | `"verbose"` lists each skipped selector             |
+| `preprocess` | —                                 | `(code, filePath) => code` before scan/atomize      |
+
+## How it works
+
+Matching declarations share one registry class. Single local classes are eligible, including simple pseudos and nested at-rules.
+
+```css
+.card {
+  color: red;
+  &:hover {
+    color: blue;
+  }
+  @media (min-width: 600px) {
+    padding: 16px;
+  }
+}
+```
+
+becomes:
+
+```css
+/* module */
+.card {
+  composes: bn89ziv jtnf3j g1h5a7 from global;
+}
+```
+
+```css
+/* registry */
+.bn89ziv {
+  color: red;
+}
+
+.jtnf3j:hover {
+  color: #00f;
+}
+
+@media (width >= 600px) {
+  .g1h5a7 {
+    padding: 16px;
+  }
+}
+```
+
+Selector eligibility, shorthand/longhand rules, and non-goals: [GUIDE.md](./GUIDE.md).
+
+## Skipping
+
+Add `/* atomic: skip */` before a selector, or as the first comment in a rule block, to leave that rule alone. Use it when a declaration would atomize but sharing it would break cascade or you need the styles to stay on the local class.
+
+`buildStart` logs atom count, skip reasons, and source vs registry bytes.
+
+## Caveats
+
+- Only selectors that CSS Modules can `composes` are atomized (see the guide).
+- Shorthand + longhand in the same rule skip those properties for that rule.
+- Cross-file cascade and specificity are not modeled; if shared atoms would break ordering, use `/* atomic: skip */`.
+- On small sheets, gzip/brotli often erase the atomic class win (many one-declaration rules compress worse than fewer larger ones). The payoff shows up when UI grows against a shared token surface: Modules CSS scales with components, the atom set scales with the design system.
+- This is **0.x**: the supported surface below is stable within a minor when practical, but breaking changes may land before 1.0.
+
+## Public API
+
+**Supported**
+
+- `@zslabs/atomic-css-modules/vite` — `atomicCssModules`, plugin option types, registry virtual module ids
+- `@zslabs/atomic-css-modules` — `processCssModules`, `ProcessOptions` / `ProcessResult` and related result types, `SKIP_REASONS` / report helpers used with the pipeline
+
+**Internal** (exported for advanced use and tests; may change without a major bump)
+
+- `FileScanCache`, `scanFiles`, `rewriteFiles`, `buildRegistryCss`, `ensureUniqueAtomNames`, `syncScanAtomHashes`, and lower-level atom/scan types
+
+```ts
+import { processCssModules } from '@zslabs/atomic-css-modules'
+
+const result = processCssModules([{ filePath: 'button.module.css', code }], {
+  registryImportPath: './atomic-registry.css',
+  composeFrom: 'file', // Vite plugin uses 'global'
+  sourceMap: true,
+})
+```
+
+## License
+
+MIT

package/dist/atom-key.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Builds the deterministic key/hash for one atomizable declaration. Pure
+ * function of (property, value, !important, pseudo, at-rule condition) so
+ * scan and rewrite always agree on an atom's class name without needing to
+ * share any other state.
+ */
+import type { Declaration } from 'lightningcss';
+import type { AtomCondition, AtomKey, AtomPseudo } from './types.js';
+export interface BuildAtomKeyParams {
+    property: string;
+    declaration: Declaration;
+    important: boolean;
+    pseudo: AtomPseudo | null;
+    condition: AtomCondition;
+}
+export declare function buildAtomKey(params: BuildAtomKeyParams): AtomKey;
+export declare function atomKeyString(key: AtomKey): string;
+export declare function atomHashForKey(key: AtomKey): string;
+export declare function atomClassNameForKey(key: AtomKey, declaration: Declaration, debugNames?: boolean): string;

package/dist/atom-key.js

@@ -0,0 +1,72 @@
+import { transform } from 'lightningcss';
+import { atomClassName, fnv1a } from './hash.js';
+export function buildAtomKey(params) {
+    return {
+        property: params.property,
+        // Omit `loc` so identical values at different source positions dedupe.
+        valueFingerprint: JSON.stringify(params.declaration, (key, value) => (key === 'loc' ? undefined : value)),
+        important: params.important,
+        pseudo: params.pseudo,
+        condition: params.condition,
+    };
+}
+export function atomKeyString(key) {
+    return JSON.stringify(key);
+}
+export function atomHashForKey(key) {
+    return atomClassName(atomKeyString(key));
+}
+function slug(value) {
+    const slugged = value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return slugged || 'x';
+}
+function printedDeclaration(declaration, important) {
+    const result = transform({
+        filename: 'atom.css',
+        code: Buffer.from('._{}'),
+        visitor: {
+            StyleSheetExit(sheet) {
+                sheet.rules = [
+                    {
+                        type: 'style',
+                        value: {
+                            loc: { source_index: 0, line: 0, column: 1 },
+                            selectors: [[{ type: 'class', name: '_' }]],
+                            declarations: important
+                                ? { importantDeclarations: [declaration] }
+                                : { declarations: [declaration] },
+                        },
+                    },
+                ];
+                return sheet;
+            },
+        },
+    });
+    const css = Buffer.from(result.code).toString('utf8');
+    const match = /\{([^}]+)\}/.exec(css);
+    return (match?.[1] ?? '').replace(/!important/g, '').trim();
+}
+function debugAtomClassName(key, declaration) {
+    const prefixes = [];
+    for (const wrapper of key.condition) {
+        prefixes.push(wrapper.kind === 'media' ? 'md' : wrapper.kind);
+    }
+    if (key.pseudo && 'kind' in key.pseudo)
+        prefixes.push(key.pseudo.kind);
+    const body = slug(printedDeclaration(declaration, key.important));
+    if (key.important)
+        prefixes.push('i');
+    const name = [...prefixes, body].join('-');
+    const base = /^[a-z]/i.test(name) ? name : `a-${name}`;
+    // Suffix with a short key hash so different at-rule conditions never collide.
+    return `${base}-${fnv1a(atomKeyString(key)).slice(0, 6)}`;
+}
+export function atomClassNameForKey(key, declaration, debugNames = false) {
+    if (debugNames)
+        return debugAtomClassName(key, declaration);
+    return atomHashForKey(key);
+}
+//# sourceMappingURL=atom-key.js.map

package/dist/atom-key.js.map

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

package/dist/atoms.d.ts

@@ -0,0 +1,8 @@
+import type { Atom, ScanFileResult } from './types.js';
+/**
+ * Ensures every atom has a distinct class name. First-seen key keeps its
+ * name; later keys that collide are reallocated (`-2`, `-3`, …).
+ */
+export declare function ensureUniqueAtomNames(atoms: Map<string, Atom>): void;
+/** Rebuilds `atomHashes` from `atomKeys` using the (possibly remapped) atom map. */
+export declare function syncScanAtomHashes(scanFiles: readonly ScanFileResult[], atoms: Map<string, Atom>): void;

package/dist/atoms.js

@@ -0,0 +1,33 @@
+/**
+ * Atom map helpers: global class-name uniqueness and keeping scan rule
+ * hashes aligned with the map after remaps.
+ */
+import { allocateUniqueClassName } from './hash.js';
+/**
+ * Ensures every atom has a distinct class name. First-seen key keeps its
+ * name; later keys that collide are reallocated (`-2`, `-3`, …).
+ */
+export function ensureUniqueAtomNames(atoms) {
+    const taken = new Set();
+    for (const atom of atoms.values()) {
+        const unique = allocateUniqueClassName(taken, atom.className);
+        taken.add(unique);
+        atom.hash = unique;
+        atom.className = unique;
+    }
+}
+/** Rebuilds `atomHashes` from `atomKeys` using the (possibly remapped) atom map. */
+export function syncScanAtomHashes(scanFiles, atoms) {
+    for (const scanFile of scanFiles) {
+        for (const rule of scanFile.rules) {
+            rule.atomHashes = rule.atomKeys.map((keyString) => {
+                const atom = atoms.get(keyString);
+                if (!atom) {
+                    throw new Error(`Missing atom for key while syncing hashes`);
+                }
+                return atom.hash;
+            });
+        }
+    }
+}
+//# sourceMappingURL=atoms.js.map

package/dist/atoms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atoms.js","sourceRoot":"","sources":["../src/atoms.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAA;AAGnD;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAwB;IAC5D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAA;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;QAC7D,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACjB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAA;QAClB,IAAI,CAAC,SAAS,GAAG,MAAM,CAAA;IACzB,CAAC;AACH,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,kBAAkB,CAChC,SAAoC,EACpC,KAAwB;IAExB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAClC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE;gBAChD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;gBACjC,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAA;gBAC9D,CAAC;gBACD,OAAO,IAAI,CAAC,IAAI,CAAA;YAClB,CAAC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/declaration-utils.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Helpers for reading lightningcss `Declaration` / `DeclarationBlock` values.
+ */
+import type { Declaration, DeclarationBlock } from 'lightningcss';
+/** True for CSS Modules `composes`, whether lightningcss parsed it or left it unparsed. */
+export declare function isComposesDeclaration(declaration: Declaration): boolean;
+export type ComposesOrigin = {
+    kind: 'local';
+} | {
+    kind: 'global';
+} | {
+    kind: 'file';
+    path: string;
+};
+/** Where a `composes` declaration pulls class names from. */
+export declare function composesOrigin(declaration: Declaration): ComposesOrigin | null;
+/** Class names listed on a `composes` declaration. */
+export declare function composesNames(declaration: Declaration): string[];
+/** The `from` file path on a `composes` declaration, or null if it is local or global. */
+export declare function composesFrom(declaration: Declaration): string | null;
+/** The CSS property name a declaration represents, including custom properties and unparsed values. */
+export declare function declarationProperty(declaration: Declaration): string;
+export interface FlatDeclaration {
+    declaration: Declaration;
+    important: boolean;
+}
+/**
+ * lightningcss visitors surface `Option::None` as JSON `null`. Passing those
+ * objects back into `transform` fails for some types (notably `Specifier` on
+ * `var()` names, and `@import`/`@namespace` optionals). Drop nulls before we
+ * store or re-inject AST nodes.
+ */
+export declare function stripAstNulls(declaration: Declaration): Declaration;
+/** Deep-clone any LightningCSS AST value, dropping only JSON `null`s. */
+export declare function stripNullsDeep<T>(value: T): T;
+/** Flattens a rule's declaration block into a single ordered list, tagging each with its `!important` flag. */
+export declare function flattenDeclarations(block: DeclarationBlock<Declaration> | undefined): FlatDeclaration[];

package/dist/declaration-utils.js

@@ -0,0 +1,99 @@
+/** True for CSS Modules `composes`, whether lightningcss parsed it or left it unparsed. */
+export function isComposesDeclaration(declaration) {
+    if (declaration.property === 'composes')
+        return true;
+    return (declaration.property === 'unparsed' &&
+        declaration.value.propertyId.property === 'composes');
+}
+/** Where a `composes` declaration pulls class names from. */
+export function composesOrigin(declaration) {
+    if (declaration.property === 'composes') {
+        const from = declaration.value.from;
+        if (!from)
+            return { kind: 'local' };
+        if (from.type === 'global')
+            return { kind: 'global' };
+        if (from.type === 'file')
+            return { kind: 'file', path: from.value };
+        return { kind: 'local' };
+    }
+    if (!isComposesDeclaration(declaration) ||
+        declaration.property !== 'unparsed') {
+        return null;
+    }
+    let seenFrom = false;
+    for (const token of declaration.value.value) {
+        if (token.type !== 'token')
+            continue;
+        if (token.value.type === 'ident' && token.value.value === 'from') {
+            seenFrom = true;
+            continue;
+        }
+        if (!seenFrom)
+            continue;
+        if (token.value.type === 'ident' && token.value.value === 'global') {
+            return { kind: 'global' };
+        }
+        if (token.value.type === 'string')
+            return { kind: 'file', path: token.value.value };
+    }
+    return { kind: 'local' };
+}
+/** Class names listed on a `composes` declaration. */
+export function composesNames(declaration) {
+    if (declaration.property === 'composes')
+        return [...declaration.value.names];
+    if (!isComposesDeclaration(declaration) ||
+        declaration.property !== 'unparsed') {
+        return [];
+    }
+    const names = [];
+    for (const token of declaration.value.value) {
+        if (token.type !== 'token')
+            continue;
+        if (token.value.type === 'ident') {
+            if (token.value.value === 'from')
+                break;
+            names.push(token.value.value);
+        }
+    }
+    return names;
+}
+/** The `from` file path on a `composes` declaration, or null if it is local or global. */
+export function composesFrom(declaration) {
+    const origin = composesOrigin(declaration);
+    return origin?.kind === 'file' ? origin.path : null;
+}
+/** The CSS property name a declaration represents, including custom properties and unparsed values. */
+export function declarationProperty(declaration) {
+    if (declaration.property === 'custom')
+        return declaration.value.name;
+    if (declaration.property === 'unparsed')
+        return declaration.value.propertyId.property;
+    return declaration.property;
+}
+/**
+ * lightningcss visitors surface `Option::None` as JSON `null`. Passing those
+ * objects back into `transform` fails for some types (notably `Specifier` on
+ * `var()` names, and `@import`/`@namespace` optionals). Drop nulls before we
+ * store or re-inject AST nodes.
+ */
+export function stripAstNulls(declaration) {
+    return JSON.parse(JSON.stringify(declaration, (_key, value) => value === null ? undefined : value));
+}
+/** Deep-clone any LightningCSS AST value, dropping only JSON `null`s. */
+export function stripNullsDeep(value) {
+    return JSON.parse(JSON.stringify(value, (_key, nested) => nested === null ? undefined : nested));
+}
+/** Flattens a rule's declaration block into a single ordered list, tagging each with its `!important` flag. */
+export function flattenDeclarations(block) {
+    if (!block)
+        return [];
+    const flat = [];
+    for (const declaration of block.declarations ?? [])
+        flat.push({ declaration: stripAstNulls(declaration), important: false });
+    for (const declaration of block.importantDeclarations ?? [])
+        flat.push({ declaration: stripAstNulls(declaration), important: true });
+    return flat;
+}
+//# sourceMappingURL=declaration-utils.js.map

package/dist/declaration-utils.js.map

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

package/dist/file-scan-cache.d.ts

@@ -0,0 +1,21 @@
+import type { Atom, AtomizationReport, ScanFileResult, ScanResult, SourceFile } from './types.js';
+export declare class FileScanCache {
+    private readonly entries;
+    private debugNames;
+    /** Last rematerialized global atom map (class names globally unique). */
+    private mergedAtoms;
+    setDebugNames(debugNames: boolean): void;
+    /** True when the file was scanned. False when the cached scan was reused. */
+    update(file: SourceFile): boolean;
+    remove(filePath: string): void;
+    retain(filePaths: Iterable<string>): void;
+    getScan(filePath: string): ScanFileResult | undefined;
+    /** Globally unique atoms from the last {@link snapshot} call. */
+    getAtoms(): Map<string, Atom>;
+    snapshot(): {
+        files: SourceFile[];
+        scan: ScanResult;
+        registryCss: string;
+        report: AtomizationReport;
+    };
+}

package/dist/file-scan-cache.js

@@ -0,0 +1,122 @@
+/**
+ * Per-file scan cache so Vite can rebuild the registry from dirty files
+ * instead of re-parsing every CSS module on each HMR or transform.
+ */
+import { ensureUniqueAtomNames, syncScanAtomHashes } from './atoms.js';
+import { buildRegistryCss } from './registry.js';
+import { summarizeAtomization } from './report.js';
+import { scanFiles } from './scan.js';
+/** 64-bit DJB2-pair string hash so content collisions are vanishingly rare. */
+function contentHash(code) {
+    let hashA = 5381;
+    let hashB = 52711;
+    for (let i = 0; i < code.length; i++) {
+        const char = code.charCodeAt(i);
+        hashA = Math.imul(hashA, 33) ^ char;
+        hashB = Math.imul(hashB, 33) ^ char;
+    }
+    return `${(hashA >>> 0).toString(16).padStart(8, '0')}${(hashB >>> 0)
+        .toString(16)
+        .padStart(8, '0')}`;
+}
+function cloneAtom(atom) {
+    return {
+        hash: atom.hash,
+        className: atom.className,
+        key: atom.key,
+        keyString: atom.keyString,
+        declaration: atom.declaration,
+    };
+}
+export class FileScanCache {
+    entries = new Map();
+    debugNames = false;
+    /** Last rematerialized global atom map (class names globally unique). */
+    mergedAtoms = new Map();
+    setDebugNames(debugNames) {
+        if (this.debugNames === debugNames)
+            return;
+        this.debugNames = debugNames;
+        this.entries.clear();
+        this.mergedAtoms = new Map();
+    }
+    /** True when the file was scanned. False when the cached scan was reused. */
+    update(file) {
+        const hash = contentHash(file.code);
+        const existing = this.entries.get(file.filePath);
+        if (existing && existing.contentHash === hash)
+            return false;
+        const scanned = scanFiles([file], { debugNames: this.debugNames });
+        const scan = scanned.files[0];
+        if (!scan)
+            throw new Error(`scan produced no result for ${file.filePath}`);
+        this.entries.set(file.filePath, {
+            contentHash: hash,
+            code: file.code,
+            scan,
+            atoms: scanned.atoms,
+            skips: scanned.skips,
+        });
+        return true;
+    }
+    remove(filePath) {
+        this.entries.delete(filePath);
+    }
+    retain(filePaths) {
+        const keep = new Set(filePaths);
+        for (const filePath of this.entries.keys()) {
+            if (!keep.has(filePath))
+                this.entries.delete(filePath);
+        }
+    }
+    getScan(filePath) {
+        return this.entries.get(filePath)?.scan;
+    }
+    /** Globally unique atoms from the last {@link snapshot} call. */
+    getAtoms() {
+        return this.mergedAtoms;
+    }
+    snapshot() {
+        const files = [];
+        const scanFilesResult = [];
+        const atoms = new Map();
+        const skips = [];
+        for (const entry of this.entries.values()) {
+            files.push({ filePath: entry.scan.filePath, code: entry.code });
+            // Clone rules so remapped hashes do not mutate the per-file cache entry
+            // until we write them back via sync (we sync the clones used for rewrite).
+            scanFilesResult.push({
+                filePath: entry.scan.filePath,
+                rules: entry.scan.rules.map((rule) => ({
+                    ...rule,
+                    atomKeys: [...rule.atomKeys],
+                    atomHashes: [...rule.atomHashes],
+                    decisions: rule.decisions.map((decision) => ({ ...decision })),
+                })),
+            });
+            for (const [key, atom] of entry.atoms) {
+                if (!atoms.has(key))
+                    atoms.set(key, cloneAtom(atom));
+            }
+            skips.push(...entry.skips);
+        }
+        ensureUniqueAtomNames(atoms);
+        syncScanAtomHashes(scanFilesResult, atoms);
+        // Persist remapped hashes onto cached scans so getScan matches rewrite.
+        for (const [index, entry] of [...this.entries.values()].entries()) {
+            const remapped = scanFilesResult[index];
+            if (remapped)
+                entry.scan = remapped;
+        }
+        this.mergedAtoms = atoms;
+        const scan = { atoms, files: scanFilesResult, skips };
+        const registryCss = buildRegistryCss(atoms.values());
+        return {
+            files,
+            scan,
+            registryCss,
+            report: summarizeAtomization(files, scan, registryCss),
+        };
+    }
+}
+//# sourceMappingURL=file-scan-cache.js.map

package/dist/file-scan-cache.js.map

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

package/dist/hash.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Deterministic, dependency-free string hashing (FNV-1a) used to derive
+ * short, stable atomic class names from declaration fingerprints.
+ */
+export declare function fnv1a(input: string): string;
+/**
+ * FNV-1a encoded as base36, with a leading digit remapped to a letter
+ * so the name is a valid CSS class without a reserved prefix.
+ */
+export declare function atomClassName(fingerprint: string): string;
+/**
+ * Picks `desired` when free, otherwise appends `-2`, `-3`, … until unique.
+ * Used so class-name collisions never silently share a registry rule.
+ */
+export declare function allocateUniqueClassName(taken: ReadonlySet<string>, desired: string): string;