@animus-ui/extract 0.1.11 → 0.1.12

package/README.md

@@ -31,6 +31,53 @@ const manifest = engine.analyze(fileEntriesJson);
 const { code, hasComponents } = JSON.parse(engine.transformFile(path));
 ```
 
+### Source corpus
+
+Every driver (the Vite plugin, the extraction session behind the Next
+plugin, the CLI, and unplugin) analyzes one source corpus, owned by
+`createSourceCorpus` in `@animus-ui/extract/pipeline` (`prepare` →
+analyze → `publish`; `published` is the parser-ready projection of the last
+successful pass — see the module's own doc comments for the contract).
+
+The Vite plugin and the extraction session are two drivers, not one driver
+holding a copy of the other: the session publishes artifacts to disk for
+cross-process readers, the Vite context answers virtual modules from memory.
+The raw file cache stays with each driver: the Vite context mutates its
+cache incrementally under its analysis lock, the session rebinds its cache
+wholesale on publish. The ingestion policy point (`createSourceIngestor`) is
+not exported from the pipeline barrel; its one production call site is
+inside the corpus, asserted by `tests/source-corpus.test.ts`.
+
+## Driver and host obligations
+
+Obligations a driver or host carries that no exported type expresses.
+
+### Hosts and sessions
+
+- `onExternalRootResolved` fires for each admitted root during collection, before that root is walked, so a watching host can open its handle with no blind gap between scan and watch. `onExternalRootsCommitted` fires once after a successful publication with the complete admitted root set; a failed pipeline never fires it, so the host rolls back whatever it opened.
+- Every host projects ownership at the same point — after ingestion and before the analysis result is enforced — so that two hosts cannot raise different diagnostics for the same external package. An original that leaves the corpus takes its projected children with it, so no owner outlives the file it described.
+- Integrations consume the published replacement epoch rather than deriving their own; pass the served system-props artifact's content as `servedDependencyWitness` so an offline change to that artifact moves the epoch and invalidates persistent-cache snapshots referencing the old one. Absence and an empty string are distinct witness values.
+
+### Ingestion
+
+- A payload that is not a corpus throws, naming the refusing reader, because an empty corpus is indistinguishable from "no files" and would publish an empty stylesheet. Callers with their own documented failure channel translate the throw into it; none may swallow it.
+- Keyframes collections are keyed by export name, and a `name.property` reference resolves against whatever local name binds that collection. The binding may arrive either through a cross-file import or through an export in the same file.
+
+### Options
+
+- The `exclude` dialect — globs versus substrings, and the structural exclusions that always apply and cannot be re-admitted — is defined in the [standalone extraction contract](https://github.com/codecaaron/animus/blob/main/docs/standalone-extraction.md#changed-plugin-behavior-release-notes-callout), which every driver shares.
+
+### Assets
+
+- Asset copies are content-addressed and never overwritten, so a revised asset leaves its previous revision in `assets/` until pruning removes it. Choose `staleAssetPruning: 'full-pipeline'` when the driver serves the directory in place (an already-loaded page still requests the old url) and `'every-cycle'` when it republishes the whole directory each cycle.
+- Asset urls are emitted relative to the session's `styles.css`, which sits beside `assets/`, so the host's own CSS pipeline applies its publicPath and output hashing to them. A specifier that cannot be substituted warns and is emitted literally, and fails the build in strict mode.
+
+### Engine
+
+- `transformSourcesJson` is the only channel for transforms that ship inside an installed package: `configJson` names each prop's transform but cannot carry its body, and the extractor's other seed is `createTransform()` calls parsed out of project files. Without it, props using a package-shipped transform emit the raw value.
+- In dev mode the manifest reports what reconciliation would have eliminated instead of eliminating it, as `report.eliminated_details` entries carrying `kind: "prospective_component"`. That turns a JSX-scanner blind spot into an authoring-time diagnostic rather than missing CSS in a production build.
+- `build:extract-v2` checks rustc against `rust-toolchain.toml` before building the shipped binary; `build:v2:debug` skips the check on purpose because it builds a developer-profile binary.
+
 ## License
 
 MIT

package/crates/extract-v2/index.d.ts

@@ -2,116 +2,46 @@
 /* eslint-disable */
 export declare class ExtractEngine {
   constructor(options?: EngineOptions | undefined | null)
-  /**
-   * Parse-once fact extraction over the file set; facts and sources are
-   * RETAINED on the handle for subsequent per-file calls. Returns the
-   * fact manifest (files + parseCount) as JSON.
-   */
   analyze(fileEntriesJson: string): string
-  /** Reset all retained build state. */
   clearCache(): void
   get parseCount(): number
-  /**
-   * Per-file transformation from retained source + facts (no-config
-   * subset: variants/compounds/states; system/custom payloads need the
-   * row-07 config inputs and FAIL LOUD). Returns {code, hasComponents}
-   * JSON. Import decisions come from surviving chain/payload metadata;
-   * consumed-import stripping and directive handling are the ported v1
-   * semantics.
-   */
   transformFile(path: string): string
 }
 
 /**
- * Chain discovery over a file set: parse once per file (parallel), walk
- * every stored AST, return owned facts. The v2 spine's first real surface;
- * consumed by the parity comparison tooling.
+ * Chain discovery over a file set: one parse per file, then one walk per
+ * stored AST.
  */
 export declare function discoverChains(fileEntriesJson: string): string
 
-/**
- * Engine options (row 07 Task 07.3 — replaces the RF-53 hardcodes).
- * All fields optional; absent = v1 defaults.
- */
 export interface EngineOptions {
-  /** Class-identity prefix (v1 default "animus"). */
   prefix?: string
-  /** Runtime import source (v1 default "@animus-ui/system"). */
   runtimeImport?: string
-  /** CSS virtual module id (v1 default "virtual:animus/styles.css"). */
   cssModuleId?: string
-  /**
-   * System-props virtual module id (v1 EmitterConfig default
-   * "virtual:animus/system-props").
-   */
   systemPropsModuleId?: string
-  /** Flat theme scales JSON (v1 analyzeProject `theme_json`). */
   themeJson?: string
-  /** Token-alias variable map JSON (v1 `variable_map_json`). */
   variableMapJson?: string
-  /** Contextual vars JSON (v1 `contextual_vars_json`). */
   contextualVarsJson?: string
-  /** Prop config map JSON (v1 `config_json`). */
   configJson?: string
-  /** Group registry JSON (v1 `group_registry_json`). */
   groupRegistryJson?: string
-  /**
-   * Transform source texts (`{ transformName: sourceText }` JSON) from the
-   * system evaluation. `config_json` names each prop's transform but cannot
-   * carry its body, and the extractor's other seed is `createTransform()`
-   * calls parsed out of project files — so without this, transforms shipped
-   * inside a package are unresolvable at build time and their props fall
-   * back to the raw value.
-   */
   transformSourcesJson?: string
-  /** Selector aliases JSON (v1 `selector_aliases_json`). */
   selectorAliasesJson?: string
-  /**
-   * Condition aliases JSON (the `conditionAliases` manifest field):
-   * `{ "_motionReduce": { "value": "@media …", "order": 500, "kind":
-   * "media" } }`. Absent = no registrations.
-   */
   conditionAliasesJson?: string
-  /** Global style blocks JSON (v1 `global_style_blocks_json`). */
   globalStyleBlocksJson?: string
-  /**
-   * Keyframes blocks JSON (v1 `keyframes_blocks_json` — feeds BOTH the
-   * global sheet and the static keyframes registry, v1 Phase 2a).
-   */
   keyframesJson?: string
-  /** Package resolution JSON (v1 `package_resolution_json`). */
   packageResolutionJson?: string
-  /** Path aliases JSON (`{aliases: [...]}` wrapper, v1 shape). */
   pathAliasesJson?: string
-  /**
-   * Forced-emission declarations (spec: static-emission-overrides) —
-   * the serialized `staticCss` plugin option.
-   */
   staticCssJson?: string
-  /**
-   * rootDir-relative directory prefixes of discovered external packages
-   * (JSON string array). Files under these dirs get the external-token
-   * candidate walk (extraction-diagnostics: cross-source correlation);
-   * absent = no candidates recorded.
-   */
   externalDirsJson?: string
-  /** v1 `dev_mode`: retain all components (skip reconciliation pruning). */
   devMode?: boolean
 }
 
-/**
- * Build/probe identity: proves the v2 binary loads and its oxc linkage
- * parses. Consumed by the dual-build verification and the parity harness
- * engine registry.
- */
+/** Probe identity: proves the binary loads and its oxc linkage parses. */
 export declare function engineVersion(): string
 
 /**
- * Full per-file fact extraction: chains + eagerly evaluated
- * stages + statics + raw usage facts + compose families — one parse per
- * file. The store (and every AST) is dropped when this call returns; the
- * invariant is that no program() read happens after
- * cross-file facts resolve.
+ * Full per-file fact extraction, one parse per file. The store and its
+ * ASTs drop on return: no `program()` read survives cross-file resolve.
  */
 export declare function extractFacts(fileEntriesJson: string): string
 
@@ -128,40 +58,29 @@ export interface NapiSystemConfig {
   selectorOrder?: string
   /**
    * Condition alias map JSON (the `conditionAliases` manifest field):
-   * alias → `{ value, order, kind }`. Absent when the system registers none.
+   * alias → `{ value, order, kind }`. Absent when none are registered.
    */
   conditionAliases?: string
   /**
-   * Transform source texts (`{ transformName: sourceText }` JSON) captured
-   * during system evaluation — the only channel by which transforms shipped
-   * inside a package reach the build-time evaluator. Absent against a system
-   * built by an older @animus-ui/system.
+   * Transform source texts (`{ transformName: sourceText }` JSON): the
+   * only channel by which transforms shipped in a package reach evaluation.
    */
   transformSources?: string
   globalStyleBlocks?: string
   keyframesBlocks?: string
   /**
-   * Canonical absolute paths of every module evaluated for the system
-   * (sorted; entry included, runtime stubs excluded). The plugins use this
-   * as the geological-reset membership set.
+   * Vocabulary witnesses as a JSON array of coded entries; hosts surface
+   * each as a diagnostic keyed by its `code`. Absent when there are none.
+   */
+  vocabularyWitnesses?: string
+  /**
+   * Canonical absolute paths of every module evaluated for the system,
+   * sorted; the entry is included, runtime stubs are not.
    */
   dependencies: Array<string>
   /**
-   * Per-module built-theme token manifests captured during evaluation
-   * (`{ modulePath: { exportName: [token paths] } }`) — the source-token
-   * witness for the cross-source correlation diagnostic. Absent when no
-   * evaluated module exports a built theme.
+   * Per-module built-theme token manifests, shaped
+   * `{ modulePath: { exportName: [token paths] } }`. Absent when none exist.
    */
   sourceThemeManifests?: string
 }
-
-/**
- * Scan one module entry for named `Keyframes` collection exports — the
- * keyframes-only carve-out for external package entries. The
- * entry evaluates through the same loader pipeline as a system module, but
- * nothing except `__brand === 'Keyframes'` exports is read from it; the
- * consumer's configured system remains the singular config authority.
- * Returns the `{ exportName: { keyName: { name, frames } } }` JSON, or None
- * when the entry exports no collections.
- */
-export declare function scanKeyframesExports(entryPath: string, rootDir: string): string | null

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_pipeline = require("./pipeline-ojNeABi0.cjs");
+const require_pipeline = require("./pipeline-x1yBZ2UP.cjs");
 exports.ANIMUS_LAYERS = require_pipeline.ANIMUS_LAYERS;
 exports.AnimusConfigError = require_pipeline.AnimusConfigError;
 exports.CORE_OPTION_KEYS = require_pipeline.CORE_OPTION_KEYS;
@@ -7,11 +7,11 @@ exports.DEFAULT_EXCLUDE = require_pipeline.DEFAULT_EXCLUDE;
 exports.DEFAULT_EXTENSIONS = require_pipeline.DEFAULT_EXTENSIONS;
 exports.DRIVER_NAMESPACES = require_pipeline.DRIVER_NAMESPACES;
 exports.ENGINE_TRANSFORM_EXTENSIONS = require_pipeline.ENGINE_TRANSFORM_EXTENSIONS;
-exports.KEYFRAMES_EXPORT_COLLISION = require_pipeline.KEYFRAMES_EXPORT_COLLISION;
-exports.KEYFRAMES_EXTERNAL_ENTRY_FAILED = require_pipeline.KEYFRAMES_EXTERNAL_ENTRY_FAILED;
 exports.REPLACEABLE_DEFAULT_EXCLUDE = require_pipeline.REPLACEABLE_DEFAULT_EXCLUDE;
 exports.RETIRED_ENGINE_MESSAGE = require_pipeline.RETIRED_ENGINE_MESSAGE;
 exports.STRUCTURAL_EXCLUDE = require_pipeline.STRUCTURAL_EXCLUDE;
+exports.VOCABULARY_COLLISION = require_pipeline.VOCABULARY_COLLISION;
+exports.VOCABULARY_LEGACY_VERB = require_pipeline.VOCABULARY_LEGACY_VERB;
 exports.adaptSvelteSource = require_pipeline.adaptSvelteSource;
 exports.applyPrefix = require_pipeline.applyPrefix;
 exports.applyUnitFallback = require_pipeline.applyUnitFallback;
@@ -27,10 +27,11 @@ exports.buildSystemPropsModule = require_pipeline.buildSystemPropsModule;
 exports.camelToKebab = require_pipeline.camelToKebab;
 exports.clearEngineCache = require_pipeline.clearEngineCache;
 exports.collectExternalPackageSources = require_pipeline.collectExternalPackageSources;
+exports.compareDiscoveryOrder = require_pipeline.compareDiscoveryOrder;
 exports.contentHash = require_pipeline.contentHash;
 exports.createExcludeMatcher = require_pipeline.createExcludeMatcher;
+exports.createSourceCorpus = require_pipeline.createSourceCorpus;
 exports.createSourceIdentity = require_pipeline.createSourceIdentity;
-exports.createSourceIngestor = require_pipeline.createSourceIngestor;
 exports.createV2EngineApi = require_pipeline.createV2EngineApi;
 exports.diffFilePlans = require_pipeline.diffFilePlans;
 exports.discoverFiles = require_pipeline.discoverFiles;
@@ -44,13 +45,15 @@ exports.formatRustTimingWaterfall = require_pipeline.formatRustTimingWaterfall;
 exports.hashReplacementPlans = require_pipeline.hashReplacementPlans;
 exports.ingestSourceEntries = require_pipeline.ingestSourceEntries;
 exports.isAdvisorySourceDiagnostic = require_pipeline.isAdvisorySourceDiagnostic;
+exports.isEngineTransformExtension = require_pipeline.isEngineTransformExtension;
 exports.isExcludedPackageRelativePath = require_pipeline.isExcludedPackageRelativePath;
 exports.isPathWithinRoot = require_pipeline.isPathWithinRoot;
 exports.isUnresolvedParentDrop = require_pipeline.isUnresolvedParentDrop;
 exports.loadSystemConfig = require_pipeline.loadSystemConfig;
-exports.mergeExternalKeyframes = require_pipeline.mergeExternalKeyframes;
+exports.parseFilesJson = require_pipeline.parseFilesJson;
 exports.postProcessCss = require_pipeline.postProcessCss;
 exports.preprocessMdx = require_pipeline.preprocessMdx;
+exports.projectExternalFileOwners = require_pipeline.projectExternalFileOwners;
 exports.readTsconfigAliasPairs = require_pipeline.readTsconfigAliasPairs;
 exports.resolveAbsolutePathSpecifier = require_pipeline.resolveAbsolutePathSpecifier;
 exports.resolveAssetFile = require_pipeline.resolveAssetFile;
@@ -62,13 +65,15 @@ exports.runStructuralSelfCheck = require_pipeline.runStructuralSelfCheck;
 exports.serializeStaticCss = require_pipeline.serializeStaticCss;
 exports.sharesVolumeRoot = require_pipeline.sharesVolumeRoot;
 exports.snapshotFilePlans = require_pipeline.snapshotFilePlans;
+exports.stableStringify = require_pipeline.stableStringify;
 exports.staleDistIncludesMessage = require_pipeline.staleDistIncludesMessage;
 exports.stripLeadingLayerDeclaration = require_pipeline.stripLeadingLayerDeclaration;
 exports.substituteAssetPlaceholders = require_pipeline.substituteAssetPlaceholders;
 exports.surfaceManifestDiagnostics = require_pipeline.surfaceManifestDiagnostics;
 exports.toWatchKeys = require_pipeline.toWatchKeys;
+exports.unreadableSourceDiagnostic = require_pipeline.unreadableSourceDiagnostic;
 exports.unresolvableIncludesMessage = require_pipeline.unresolvableIncludesMessage;
 exports.unresolvedParentName = require_pipeline.unresolvedParentName;
 exports.validateLayerOrder = require_pipeline.validateLayerOrder;
+exports.vocabularyWitnessDiagnostics = require_pipeline.vocabularyWitnessDiagnostics;
 exports.walkPackageSources = require_pipeline.walkPackageSources;
-exports.withoutInvalidOriginals = require_pipeline.withoutInvalidOriginals;

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { $ as CORE_OPTION_KEYS, A as createSourceIngestor, B as extractSystemFilePackages, C as resolveLightningTargets, D as resolveThroughPathAliases, E as resolveAssetFile, F as ENGINE_TRANSFORM_EXTENSIONS, G as staleDistIncludesMessage, H as firstOwners, I as preprocessMdx, J as createSourceIdentity, K as unresolvableIncludesMessage, L as adaptSvelteSource, M as isAdvisorySourceDiagnostic, N as withoutInvalidOriginals, O as findAssetSpecifiers, P as DEFAULT_EXTENSIONS, Q as AnimusConfigError, R as collectExternalPackageSources, S as postProcessCss, T as enforceExternalTokenContracts, U as isExcludedPackageRelativePath, V as findPackageRoot, W as resolveAbsolutePathSpecifier, X as sharesVolumeRoot, Y as isPathWithinRoot, Z as discoverFiles, _ as runProjectAnalysis, _t as stripLeadingLayerDeclaration, a as snapshotFilePlans, at as createExcludeMatcher, b as surfaceManifestDiagnostics, c as formatRustTimingWaterfall, ct as KEYFRAMES_EXTERNAL_ENTRY_FAILED, d as runStructuralSelfCheck, dt as RETIRED_ENGINE_MESSAGE, et as DEFAULT_EXCLUDE, f as loadSystemConfig, ft as assertNoRetiredEngineSelection, g as clearEngineCache, gt as assembleStylesheet, h as buildAnalysisInputs, ht as ANIMUS_LAYERS, i as hashReplacementPlans, it as assertKnownOptionKeys, j as ingestSourceEntries, k as substituteAssetPlaceholders, l as buildSystemPropsModule, lt as mergeExternalKeyframes, m as serializeStaticCss, mt as buildAnalyzeProjectArgs, n as camelToKebab, nt as REPLACEABLE_DEFAULT_EXCLUDE, o as assertNoErrorDiagnostics, ot as resolveMode, p as applyPrefix, pt as createV2EngineApi, q as walkPackageSources, r as diffFilePlans, rt as STRUCTURAL_EXCLUDE, s as readTsconfigAliasPairs, st as KEYFRAMES_EXPORT_COLLISION, t as toWatchKeys, tt as DRIVER_NAMESPACES, u as buildDynamicPropConfig, ut as contentHash, v as applyUnitFallback, vt as validateLayerOrder, w as buildPathAliasesJson, x as unresolvedParentName, y as isUnresolvedParentDrop, z as excludeCollectedPackages } from "./pipeline-lkbOoyAr.mjs";
-export { ANIMUS_LAYERS, AnimusConfigError, CORE_OPTION_KEYS, DEFAULT_EXCLUDE, DEFAULT_EXTENSIONS, DRIVER_NAMESPACES, ENGINE_TRANSFORM_EXTENSIONS, KEYFRAMES_EXPORT_COLLISION, KEYFRAMES_EXTERNAL_ENTRY_FAILED, REPLACEABLE_DEFAULT_EXCLUDE, RETIRED_ENGINE_MESSAGE, STRUCTURAL_EXCLUDE, adaptSvelteSource, applyPrefix, applyUnitFallback, assembleStylesheet, assertKnownOptionKeys, assertNoErrorDiagnostics, assertNoRetiredEngineSelection, buildAnalysisInputs, buildAnalyzeProjectArgs, buildDynamicPropConfig, buildPathAliasesJson, buildSystemPropsModule, camelToKebab, clearEngineCache, collectExternalPackageSources, contentHash, createExcludeMatcher, createSourceIdentity, createSourceIngestor, createV2EngineApi, diffFilePlans, discoverFiles, enforceExternalTokenContracts, excludeCollectedPackages, extractSystemFilePackages, findAssetSpecifiers, findPackageRoot, firstOwners, formatRustTimingWaterfall, hashReplacementPlans, ingestSourceEntries, isAdvisorySourceDiagnostic, isExcludedPackageRelativePath, isPathWithinRoot, isUnresolvedParentDrop, loadSystemConfig, mergeExternalKeyframes, postProcessCss, preprocessMdx, readTsconfigAliasPairs, resolveAbsolutePathSpecifier, resolveAssetFile, resolveLightningTargets, resolveMode, resolveThroughPathAliases, runProjectAnalysis, runStructuralSelfCheck, serializeStaticCss, sharesVolumeRoot, snapshotFilePlans, staleDistIncludesMessage, stripLeadingLayerDeclaration, substituteAssetPlaceholders, surfaceManifestDiagnostics, toWatchKeys, unresolvableIncludesMessage, unresolvedParentName, validateLayerOrder, walkPackageSources, withoutInvalidOriginals };
+import { $ as DEFAULT_EXCLUDE, A as enforceExternalTokenContracts, B as firstOwners, C as surfaceManifestDiagnostics, Ct as validateLayerOrder, D as postProcessCss, E as vocabularyWitnessDiagnostics, F as createSourceCorpus, G as walkPackageSources, H as resolveAbsolutePathSpecifier, I as collectExternalPackageSources, J as sharesVolumeRoot, K as createSourceIdentity, L as excludeCollectedPackages, M as resolveThroughPathAliases, N as findAssetSpecifiers, O as resolveLightningTargets, P as substituteAssetPlaceholders, Q as CORE_OPTION_KEYS, R as extractSystemFilePackages, S as isUnresolvedParentDrop, St as stripLeadingLayerDeclaration, T as unresolvedParentName, U as staleDistIncludesMessage, V as isExcludedPackageRelativePath, W as unresolvableIncludesMessage, X as discoverFiles, Y as compareDiscoveryOrder, Z as AnimusConfigError, _ as clearEngineCache, _t as preprocessMdx, a as assertNoErrorDiagnostics, at as resolveMode, b as VOCABULARY_COLLISION, bt as ANIMUS_LAYERS, c as buildSystemPropsModule, ct as createV2EngineApi, d as loadSystemConfig, dt as parseFilesJson, et as DRIVER_NAMESPACES, f as applyPrefix, ft as projectExternalFileOwners, g as buildAnalysisInputs, gt as isEngineTransformExtension, h as stableStringify, ht as ENGINE_TRANSFORM_EXTENSIONS, i as snapshotFilePlans, it as createExcludeMatcher, j as resolveAssetFile, k as buildPathAliasesJson, l as buildDynamicPropConfig, lt as ingestSourceEntries, m as camelToKebab, mt as DEFAULT_EXTENSIONS, n as diffFilePlans, nt as STRUCTURAL_EXCLUDE, o as readTsconfigAliasPairs, ot as RETIRED_ENGINE_MESSAGE, p as serializeStaticCss, pt as adaptSvelteSource, q as isPathWithinRoot, r as hashReplacementPlans, rt as assertKnownOptionKeys, s as formatRustTimingWaterfall, st as assertNoRetiredEngineSelection, t as toWatchKeys, tt as REPLACEABLE_DEFAULT_EXCLUDE, u as runStructuralSelfCheck, ut as isAdvisorySourceDiagnostic, v as runProjectAnalysis, vt as contentHash, w as unreadableSourceDiagnostic, x as VOCABULARY_LEGACY_VERB, xt as assembleStylesheet, y as applyUnitFallback, yt as buildAnalyzeProjectArgs, z as findPackageRoot } from "./pipeline-DeEENy5C.mjs";
+export { ANIMUS_LAYERS, AnimusConfigError, CORE_OPTION_KEYS, DEFAULT_EXCLUDE, DEFAULT_EXTENSIONS, DRIVER_NAMESPACES, ENGINE_TRANSFORM_EXTENSIONS, REPLACEABLE_DEFAULT_EXCLUDE, RETIRED_ENGINE_MESSAGE, STRUCTURAL_EXCLUDE, VOCABULARY_COLLISION, VOCABULARY_LEGACY_VERB, adaptSvelteSource, applyPrefix, applyUnitFallback, assembleStylesheet, assertKnownOptionKeys, assertNoErrorDiagnostics, assertNoRetiredEngineSelection, buildAnalysisInputs, buildAnalyzeProjectArgs, buildDynamicPropConfig, buildPathAliasesJson, buildSystemPropsModule, camelToKebab, clearEngineCache, collectExternalPackageSources, compareDiscoveryOrder, contentHash, createExcludeMatcher, createSourceCorpus, createSourceIdentity, createV2EngineApi, diffFilePlans, discoverFiles, enforceExternalTokenContracts, excludeCollectedPackages, extractSystemFilePackages, findAssetSpecifiers, findPackageRoot, firstOwners, formatRustTimingWaterfall, hashReplacementPlans, ingestSourceEntries, isAdvisorySourceDiagnostic, isEngineTransformExtension, isExcludedPackageRelativePath, isPathWithinRoot, isUnresolvedParentDrop, loadSystemConfig, parseFilesJson, postProcessCss, preprocessMdx, projectExternalFileOwners, readTsconfigAliasPairs, resolveAbsolutePathSpecifier, resolveAssetFile, resolveLightningTargets, resolveMode, resolveThroughPathAliases, runProjectAnalysis, runStructuralSelfCheck, serializeStaticCss, sharesVolumeRoot, snapshotFilePlans, stableStringify, staleDistIncludesMessage, stripLeadingLayerDeclaration, substituteAssetPlaceholders, surfaceManifestDiagnostics, toWatchKeys, unreadableSourceDiagnostic, unresolvableIncludesMessage, unresolvedParentName, validateLayerOrder, vocabularyWitnessDiagnostics, walkPackageSources };

package/dist/pipeline/analyze-project-args.d.ts

@@ -1,11 +1,3 @@
-/**
- * The positional argument tuple for the NAPI `analyzeProject` call.
- *
- * This is the single authoritative copy of the 17-slot contract consumed by
- * both extraction plugins (vite-plugin and next-plugin). The slot order is
- * mirrored by the Rust NAPI surface — changing it requires a coordinated
- * Rust-side update.
- */
 /** @internal */
 export type AnalyzeProjectArgs = [
     filesJson: string,
@@ -42,12 +34,8 @@ export interface AnalyzeProjectInputs {
     globalStyleBlocksJson: string | null;
     pathAliasesJson: string | null;
     keyframesJson: string | null;
-    /** Forced-emission declarations (spec: static-emission-overrides). */
     staticCssJson: string | null;
-    /** Condition alias map JSON (modern-css-surface inc 03), or null. */
     conditionAliasesJson: string | null;
-    /** rootDir-relative external package dirs (JSON string array) for the
-     *  external-token candidate walk, or null. */
     externalDirsJson: string | null;
     transformSourcesJson: string | null;
 }

package/dist/pipeline/analyze-project-args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyze-project-args.d.ts","sourceRoot":"","sources":["../../pipeline/analyze-project-args.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,gBAAgB;AAChB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM;IACjB,UAAU,EAAE,MAAM;IAClB,eAAe,EAAE,MAAM;IACvB,kBAAkB,EAAE,MAAM,GAAG,IAAI;IACjC,cAAc,EAAE,MAAM;IACtB,iBAAiB,EAAE,MAAM;IACzB,qBAAqB,EAAE,MAAM;IAC7B,OAAO,EAAE,OAAO;IAChB,iBAAiB,EAAE,MAAM,GAAG,IAAI;IAChC,mBAAmB,EAAE,MAAM,GAAG,IAAI;IAClC,iBAAiB,EAAE,IAAI;IACvB,qBAAqB,EAAE,MAAM,GAAG,IAAI;IACpC,eAAe,EAAE,MAAM,GAAG,IAAI;IAC9B,aAAa,EAAE,MAAM,GAAG,IAAI;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI;IAG5B,oBAAoB,EAAE,MAAM,GAAG,IAAI;IAInC,gBAAgB,EAAE,MAAM,GAAG,IAAI;IAG/B,oBAAoB,EAAE,MAAM,GAAG,IAAI;CACpC,CAAC;AAEF,gBAAgB;AAChB,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,sEAAsE;IACtE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qEAAqE;IACrE,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC;kDAC8C;IAC9C,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,gBAAgB;AAChB,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,oBAAoB,GAC3B,kBAAkB,CAqBpB"}
+{"version":3,"file":"analyze-project-args.d.ts","sourceRoot":"","sources":["../../pipeline/analyze-project-args.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM;IACjB,UAAU,EAAE,MAAM;IAClB,eAAe,EAAE,MAAM;IACvB,kBAAkB,EAAE,MAAM,GAAG,IAAI;IACjC,cAAc,EAAE,MAAM;IACtB,iBAAiB,EAAE,MAAM;IACzB,qBAAqB,EAAE,MAAM;IAC7B,OAAO,EAAE,OAAO;IAChB,iBAAiB,EAAE,MAAM,GAAG,IAAI;IAChC,mBAAmB,EAAE,MAAM,GAAG,IAAI;IAClC,iBAAiB,EAAE,IAAI;IACvB,qBAAqB,EAAE,MAAM,GAAG,IAAI;IACpC,eAAe,EAAE,MAAM,GAAG,IAAI;IAC9B,aAAa,EAAE,MAAM,GAAG,IAAI;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI;IAC5B,oBAAoB,EAAE,MAAM,GAAG,IAAI;IACnC,gBAAgB,EAAE,MAAM,GAAG,IAAI;IAC/B,oBAAoB,EAAE,MAAM,GAAG,IAAI;CACpC,CAAC;AAEF,gBAAgB;AAChB,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,gBAAgB;AAChB,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,oBAAoB,GAC3B,kBAAkB,CAqBpB"}

package/dist/pipeline/assemble-stylesheet.d.ts

@@ -1,20 +1,5 @@
-/**
- * The 7 Animus cascade layers. Always prefixed with `anm-` to avoid
- * collision with other frameworks' layer names (e.g., Tailwind's `base`).
- */
 export declare const ANIMUS_LAYERS: readonly ['anm-global', 'anm-base', 'anm-variants', 'anm-compounds', 'anm-states', 'anm-system', 'anm-custom'];
-/**
- * Validate that a consumer `layers` array contains all 7 Animus layers
- * in the correct relative order. Consumer layers may be interleaved.
- *
- * @throws Error with descriptive message on violation
- */
 export declare function validateLayerOrder(layers: string[]): void;
-/**
- * Strip a leading `@layer ...;` declaration line from CSS if present.
- * The Rust crate embeds this in prod-mode output; we strip it so the
- * shared assembler controls placement.
- */
 export declare function stripLeadingLayerDeclaration(css: string): string;
 export interface AssembleStylesheetParts {
     declaration: string;
@@ -22,32 +7,12 @@ export interface AssembleStylesheetParts {
     body: string;
 }
 export interface AssembleStylesheetOptions {
-    /**
-     * Custom layer order. Must contain all 7 Animus `anm-*` layers as a subsequence.
-     * Example: `['reset', 'anm-global', 'anm-base', ..., 'anm-custom', 'overrides']`
-     * Names are emitted as-is — this is the actual `@layer` declaration.
-     */
     layers?: string[];
-    /** Variable CSS: `:root { --color-*: ... }` + color mode selectors */
     variableCss?: string;
-    /** Global CSS: `@layer anm-global { reset + global styles }` */
     globalCss?: string;
-    /** Component CSS from the Rust crate (may contain embedded @layer declaration) */
     componentCss?: string;
-    /** When true, return structured `{ declaration, variables, body }` instead of a single string. */
     split?: boolean;
 }
-/**
- * Assemble the final stylesheet in canonical order:
- *
- * 1. `@layer` declaration (cascade ordering)
- * 2. Emitted variables (`:root`, color mode selectors)
- * 3. `@layer anm-global { ... }` (reset + global styles)
- * 4. `@layer anm-base/variants/compounds/states/system/custom { ... }` (components)
- *
- * This is the single source of truth for stylesheet assembly.
- * Both Vite and Next.js plugins must use this function.
- */
 export declare function assembleStylesheet(options: AssembleStylesheetOptions & {
     split: true;
 }): AssembleStylesheetParts;

package/dist/pipeline/assemble-stylesheet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assemble-stylesheet.d.ts","sourceRoot":"","sources":["../../pipeline/assemble-stylesheet.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,aAAa,YACxB,YAAY,EACZ,UAAU,EACV,cAAc,EACd,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,YAAY,CACJ,CAAC;AAiBX;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CA2BzD;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kGAAkG;IAClG,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GAAG;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GACnD,uBAAuB,CAAC;AAC3B,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GAAG;IAAE,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GACrD,MAAM,CAAC;AACV,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GACjC,MAAM,GAAG,uBAAuB,CAAC"}
+{"version":3,"file":"assemble-stylesheet.d.ts","sourceRoot":"","sources":["../../pipeline/assemble-stylesheet.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,YACxB,YAAY,EACZ,UAAU,EACV,cAAc,EACd,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,YAAY,CACJ,CAAC;AAUX,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CA2BzD;AAED,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GAAG;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GACnD,uBAAuB,CAAC;AAC3B,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GAAG;IAAE,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GACrD,MAAM,CAAC;AACV,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GACjC,MAAM,GAAG,uBAAuB,CAAC"}

package/dist/pipeline/asset-placeholders.d.ts

@@ -1,29 +1,4 @@
-/**
- * Host-side handling of `asset()` placeholders (global-styles-system):
- * `animus-asset:<specifier>` markers ride through the sandbox and the
- * emitter byte-exact; each HOST plugin substitutes them with its bundler's
- * resolved asset URL after extraction. This module owns the shared scanning
- * and replacement mechanics — resolution and strict gating stay at the
- * plugin call sites.
- */
-/** Mirrors the producer-side constant in `@animus-ui/system`'s `asset.ts`
- *  (extract must not take a runtime dependency on system); the pairing is
- *  pinned by a contract test in `tests/asset-placeholders.test.ts`. */
 export declare const ASSET_PLACEHOLDER_PREFIX = "animus-asset:";
-/** Unique asset specifiers referenced by placeholders, in appearance order. */
 export declare function findAssetSpecifiers(css: string): string[];
-/**
- * Replace each specifier's placeholder with its substitution. Specifiers
- * absent from the map keep their placeholder — the caller decides whether
- * that is a strict failure or a warn-and-emit-literally. A substitution may
- * itself be a bundler marker (e.g. Vite's `__VITE_ASSET__<ref>__`) that the
- * host's own asset pipeline resolves to a hashed file name later.
- *
- * Each replacement is anchored to a following delimiter (quote, `)`,
- * whitespace, or end of input) so a specifier that textually prefixes a
- * longer one can never clobber the longer placeholder; longest-first
- * ordering additionally lets the longer of two mapped specifiers claim its
- * occurrences before the shorter runs.
- */
 export declare function substituteAssetPlaceholders(css: string, urlBySpecifier: ReadonlyMap<string, string>): string;
 //# sourceMappingURL=asset-placeholders.d.ts.map

package/dist/pipeline/asset-placeholders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"asset-placeholders.d.ts","sourceRoot":"","sources":["../../pipeline/asset-placeholders.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;uEAEuE;AACvE,eAAO,MAAM,wBAAwB,kBAAkB,CAAC;AAkBxD,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBzD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1C,MAAM,CAgBR"}
+{"version":3,"file":"asset-placeholders.d.ts","sourceRoot":"","sources":["../../pipeline/asset-placeholders.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,kBAAkB,CAAC;AAWxD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAczD;AAED,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1C,MAAM,CAgBR"}

package/dist/pipeline/content-hash.d.ts

@@ -1,9 +1,2 @@
-/**
- * MD5 content hash used for file-change detection (HMR diffing) by both
- * extraction plugins, and for content-addressing copied asset bytes. The
- * algorithm/encoding is a cross-plugin contract: cache keys written by one
- * build path must compare equal in the next. Accepts a Buffer directly so
- * binary sources hash without an intermediate string copy.
- */
 export declare function contentHash(source: string | Buffer): string;
 //# sourceMappingURL=content-hash.d.ts.map

package/dist/pipeline/content-hash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content-hash.d.ts","sourceRoot":"","sources":["../../pipeline/content-hash.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAE3D"}
+{"version":3,"file":"content-hash.d.ts","sourceRoot":"","sources":["../../pipeline/content-hash.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAE3D"}