@animus-ui/vite-plugin 0.1.11 → 0.1.12

package/README.md

@@ -101,6 +101,7 @@ Router examples live in the
 - Do **not** add React resolve aliases to `vite.config.ts` — they break the extraction transform pipeline
 - After system config changes, restart the dev server (the subprocess runs at `buildStart`)
 - Run `bun run clean:light` if styles seem stale (clears `.vite` cache)
+- The virtual module ids are published contract, and Vite gives the first `resolveId`/`load` answer for an id to the whole config, so two plugin instances in one Vite config share one bridge and one stylesheet — the second instance's modules resolve to the first's. The per-instance key only separates independently built bundles that share a document.
 
 ## License
 

package/dist/build-start.d.ts

@@ -1,11 +1,7 @@
 import type { PluginContext } from './context';
 /**
- * buildStart: load the system, discover and ingest sources (local +
- * external packages), run whole-project analysis, and log the report.
- * `resolveSpecifier` is the bundler seam — Vite's `this.resolve` mapped to
- * an absolute id. `emitAsset` (build mode only) is Rollup's `this.emitFile`
- * for `asset()` placeholder substitution; absent in dev, where resolved
- * files are served via base + `/@fs/` instead.
+ * `resolveSpecifier` maps a specifier to an absolute id. `emitAsset` is
+ * present in build only, where `asset()` files become Rollup assets.
  */
 export declare function runBuildStart(ctx: PluginContext, resolveSpecifier: (specifier: string) => Promise<string | null>, emitAsset?: (fileName: string, source: Uint8Array) => string): Promise<void>;
 //# sourceMappingURL=build-start.d.ts.map

package/dist/build-start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-start.d.ts","sourceRoot":"","sources":["../src/build-start.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,aAAa,EAClB,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,EAC/D,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,MAAM,GAC3D,OAAO,CAAC,IAAI,CAAC,CA8Pf"}
+{"version":3,"file":"build-start.d.ts","sourceRoot":"","sources":["../src/build-start.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C;;;GAGG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,aAAa,EAClB,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,EAC/D,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,MAAM,GAC3D,OAAO,CAAC,IAAI,CAAC,CAkNf"}

package/dist/config.d.ts

@@ -1,9 +1,4 @@
 import type { PluginContext } from './context';
 import type { ResolvedConfig } from 'vite';
-/**
- * configResolved: capture build mode, root, and logger; resolve Lightning
- * CSS targets; harvest resolve.alias into the Rust `pathAliasesJson`
- * contract via the shared encoder.
- */
 export declare function applyResolvedConfig(ctx: PluginContext, config: ResolvedConfig): void;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAE3C;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,cAAc,GACrB,IAAI,CAiEN"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAE3C,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,cAAc,GACrB,IAAI,CAmCN"}

package/dist/constants.d.ts

@@ -1,8 +1,6 @@
 /**
- * The namespace every virtual module this plugin owns lives under. Exported so
- * the `transform` guard that keeps those modules out of source-file handling
- * matches on the same string the ids are built from — a rename of the
- * namespace cannot leave the guard behind.
+ * The namespace every virtual module here lives under; the `transform` guard
+ * matches on this same string so a rename cannot strand it.
  */
 export declare const VIRTUAL_PREFIX = "virtual:animus/";
 export declare const VIRTUAL_CSS_ID = "virtual:animus/styles.css";
@@ -12,18 +10,8 @@ export declare const RESOLVED_COMPONENTS_ID = "\0virtual:animus/components.js";
 export declare const VIRTUAL_BRIDGE_ID = "virtual:animus/hmr-bridge.js";
 export declare const RESOLVED_BRIDGE_ID = "\0virtual:animus/hmr-bridge.js";
 /**
- * Browser-addressable URL for the bridge, used as the `src` of the dev
- * `<script type="module">` (see index-html.ts). THE explanation of the `/@id/`
- * convention lives here; everything else points at it.
- *
- * Vite reserves `/@id/` for module ids that are not file paths. Its transform
- * middleware normalizes such a URL before serving it (`unwrapId`): strip the
- * prefix, then decode the `__x00__` placeholder back to a NUL byte. The
- * UNPREFIXED specifier is what travels here — `resolveVirtualId` is the hook
- * that answers it, and it answers with the `\0` form. (Vite's own `wrapId`
- * encodes an already-`\0`-prefixed id as `__x00__`; that form resolves too, but
- * it leans on the placeholder convention rather than on this plugin's own
- * `resolveId` contract.)
+ * Vite reserves `/@id/` for module ids that are not file paths and strips the
+ * prefix before `resolveId`, so the unprefixed specifier travels here.
  */
 export declare const BRIDGE_SCRIPT_SRC = "/@id/virtual:animus/hmr-bridge.js";
 export declare const VIRTUAL_SYSTEM_PROPS_ID = "virtual:animus/system-props";

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,cAAc,oBAAoB,CAAC;AAEhD,eAAO,MAAM,cAAc,8BAAgC,CAAC;AAC5D,eAAO,MAAM,eAAe,gCAAwB,CAAC;AAErD,eAAO,MAAM,qBAAqB,iCAAmC,CAAC;AACtE,eAAO,MAAM,sBAAsB,mCAA+B,CAAC;AAEnE,eAAO,MAAM,iBAAiB,iCAAmC,CAAC;AAClE,eAAO,MAAM,kBAAkB,mCAA2B,CAAC;AAE3D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB,sCAA8B,CAAC;AAE7D,eAAO,MAAM,uBAAuB,gCAAkC,CAAC;AACvE,eAAO,MAAM,wBAAwB,kCAAiC,CAAC;AAKvE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,cAAc,oBAAoB,CAAC;AAEhD,eAAO,MAAM,cAAc,8BAAgC,CAAC;AAC5D,eAAO,MAAM,eAAe,gCAAwB,CAAC;AAErD,eAAO,MAAM,qBAAqB,iCAAmC,CAAC;AACtE,eAAO,MAAM,sBAAsB,mCAA+B,CAAC;AAEnE,eAAO,MAAM,iBAAiB,iCAAmC,CAAC;AAClE,eAAO,MAAM,kBAAkB,mCAA2B,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,iBAAiB,sCAA8B,CAAC;AAE7D,eAAO,MAAM,uBAAuB,gCAAkC,CAAC;AACvE,eAAO,MAAM,wBAAwB,kCAAiC,CAAC;AAIvE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/context.d.ts

@@ -1,130 +1,72 @@
 import { HotUpdateEvents } from './hot-update-events';
 import type { LightningTargets } from './css';
 import type { AnimusExtractOptions } from './index';
-import type { ExcludeMatcher, ExternalPackageOutcome, ManifestDiagnostic, RawSourceEntry, SourceEntryOwnership, SourceIngestionDiagnostic, SourceIngestionResult, SystemConfig } from '@animus-ui/extract/pipeline';
+import type { ExcludeMatcher, ExternalPackageOutcome, ManifestDiagnostic, ManifestSheets, ProjectManifest, RawSourceEntry, SourceCorpus, SourceIngestionResult, SystemConfig } from '@animus-ui/extract/pipeline';
 import type { Logger } from 'vite';
-/**
- * Structured per-layer CSS sheets from the Rust crate (dev split delivery).
- * Mirrors the `CssSheets` struct in packages/extract/src/css_generator.rs —
- * keep these fields in sync.
- */
-export interface CssSheets {
-    declaration: string;
-    global: string;
-    base: string;
-    variants: string;
-    compounds: string;
-    states: string;
-    system: string;
-    custom: string;
-}
-/** Full raw originals for one adaptation attempt. */
-export declare function buildRawEntriesFromCache(cache: Map<string, {
-    hash: string;
-    source: string;
-}>): Array<{
-    path: string;
-    source: string;
-    hash: string;
-}>;
-/** Run `task` after every previously scheduled analysis transaction for
- *  this context. Entry points only (transform detection, hot update,
- *  geological reset); helpers they call internally must stay unlocked. */
-export declare function runExclusiveAnalysis<T>(ctx: object, task: () => Promise<T>): Promise<T>;
-/**
- * The exact source `virtual:animus/system-props` serves for the current state.
- * One definition, so the served bytes and the change decision below can never
- * be computed from different inputs.
- *
- * A real context carries the module already generated (`systemPropsModuleMemo`,
- * refreshed wherever the four inputs move), so serving it and deciding whether
- * it changed are both reads. Contexts that publish those inputs by hand — the
- * behavioral test doubles — carry no memo and generate here instead.
- */
+/** Runs `task` after every analysis transaction already scheduled for this
+ *  context. Entry points only — a nested call waits on its own chain. */
+export declare function runExclusiveAnalysis<T>(ctx: PluginContext, task: () => Promise<T>): Promise<T>;
+/** The exact source `virtual:animus/system-props` serves now — one definition,
+ *  so the served bytes and the HMR change decision cannot diverge. */
 export declare function systemPropsModuleSource(ctx: PluginContext): string;
-/**
- * Drop a deleted (or renamed-away) raw original from the dev file cache.
- * Generated MDX/Svelte children live in `analysisEntryCache` and disappear
- * atomically when the next source-ingestion result publishes. External
- * package entries are rootDir-relative too (with leading `..` segments).
- */
+/** Drop a deleted or renamed-away raw original from the dev file cache.
+ *  Generated MDX/Svelte children live only in the published corpus. */
 export declare function pruneFileCache(cache: Map<string, {
     hash: string;
     source: string;
 }>, rootDir: string, absPath: string): boolean;
-/**
- * Per-plugin-instance state and the pipeline operations over it. Hook
- * bodies live in their own modules (build-start, virtual-modules,
- * transform, hmr) and receive this context — the plugin factory in
- * index.ts only wires Vite hooks to those functions.
- *
- * A class rather than closure variables so each hook module names exactly
- * the state it touches, and the engine store (per-instance, never
- * module-level) is explicit.
- */
 export declare class PluginContext {
     readonly options: AnimusExtractOptions;
     readonly verbose: boolean;
-    /** Serialized staticCss forced-emission declarations (stable key order). */
     readonly staticCssJson: string | null;
     isProd: boolean;
-    /** Emission-mode signal (explicit `mode` option wins over the command);
-     *  feeds engine devMode and the minify default. Lifecycle stays on
-     *  `isProd`. */
+    /** Emission mode (the explicit `mode` option wins over the command); feeds
+     *  engine devMode and the minify default. Lifecycle stays on `isProd`. */
     emissionProd: boolean;
     rootDir: string;
     logger: Logger | null;
-    /** System-derived config (shared SystemConfig shape). */
     system: SystemConfig;
     lcssTargets: LightningTargets;
     pathAliasesJson: string | null;
     extensionsSet: ReadonlySet<string>;
     excludeMatcher: ExcludeMatcher;
-    storedManifest: any;
+    storedManifest: ProjectManifest | null;
     storedManifestJson: string;
     globalCss: string;
     resolvedComponentCss: string;
-    storedSheets: CssSheets | null;
+    storedSheets: ManifestSheets | null;
     layerDeclaration: string;
     transformOutputHashes: Map<string, string>;
     recordTransformOutput(relativePath: string, code: string): void;
-    /**
-     * The consumer system's OWN keyframes collections, captured at load time
-     * before any external merge touches `system.keyframesJson`. Every
-     * `applyExternalKeyframes` merge starts from this baseline, so repeated
-     * merges (a --watch rebuild's loadSystem + rediscovery, a geological
-     * reset) never compound prior external state — a removed include's
-     * keyframes disappear with it.
-     */
-    private consumerKeyframesJson;
-    /**
-     * Merge `Keyframes` collections from discovered external package entries
-     * into the system's collections (keyframes-only carve-out — the consumer
-     * system stays the singular config authority). Runs after buildStart
-     * discovery AND after every geological-reset system reload, since a reload
-     * rebuilds `this.system` from the consumer entry alone. Merges from the
-     * consumer-only baseline, never from the previously merged value.
-     */
-    applyExternalKeyframes(): void;
-    /** Discovery-time keyframes diagnostics awaiting the next analysis's
-     *  shared surfacing pass. */
-    externalKeyframesDiagnostics: ManifestDiagnostic[];
+    /** Vocabulary witnesses from the sealed system, awaiting the next analysis.
+     *  Surfacing happens only inside `runProjectAnalysis`. */
+    systemVocabularyDiagnostics: ManifestDiagnostic[];
     reverseProvenance: Record<string, string[]>;
     storedSystemPropMapJson: string;
     storedDynamicPropsJson: string;
     storedTransformsSource: string;
-    systemPropsModuleMemo: string | null;
-    fileCache: Map<string, {
+    readonly fileCache: ReadonlyMap<string, {
         hash: string;
         source: string;
     }>;
-    analysisEntryCache: Map<string, {
+    /** Mutation attempts against `fileCache`, for memos that must not key on
+     *  `size` — a delete plus an unrelated create leaves it unchanged. */
+    fileCacheGeneration: number;
+    /** The one mutator of the raw-source cache: every add, replacement and
+     *  deletion goes through here so no write escapes the counter above. */
+    mutateFileCache<T>(mutate: (cache: Map<string, {
         hash: string;
         source: string;
-    }>;
-    sourceOwnership: Record<string, SourceEntryOwnership>;
-    analysisOwnerByPath: Map<string, string>;
+    }>) => T): T;
+    /** Generated MDX/Svelte paths never enter `fileCache` — they live only in
+     *  this corpus's published projection. */
+    readonly corpus: SourceCorpus;
     rawExtensionFallbacks: Set<string>;
+    /** The one mutator of a file's fallback state — every raw-serve exit of the
+     *  transform hook reports here. Production keeps the set empty. The
+     *  barrier's one-shot withhold release must not route through here: it
+     *  retires other files' records, no claim about their current serve. */
+    recordFallbackState(relativePath: string, isFallback: boolean): void;
     readonly hotUpdateEvents: HotUpdateEvents;
     private pendingReloadTimer;
     packageMap: Record<string, string>;
@@ -136,7 +78,6 @@ export declare class PluginContext {
     externalDirOwners: Record<string, string>;
     externalFileOwners: Record<string, string>;
     externalSourceEntries: Map<string, string>;
-    externalKeyframesScanEntries: Map<string, string>;
     externalPackageOutcomes: ExternalPackageOutcome[];
     devServer: any;
     resolvedSystemPath: string | null;
@@ -145,70 +86,28 @@ export declare class PluginContext {
     private v2Engine;
     private v2SentSources;
     private v2DriftWarned;
-    /** Single engine choke-point for every native extraction call. */
+    /** Every native extraction call goes through this one accessor. */
     readonly engineApi: () => any;
     constructor(options: AnimusExtractOptions, engineApiOverride?: () => any);
     log(msg: string): void;
-    /**
-     * Standard-level information — emitted whether or not `verbose` is on.
-     * Reserved for events a developer must see without opting in, e.g. a file
-     * created after buildStart being folded into the analysis (openspec:
-     * hmr-new-file-detection, "New file detection logging").
-     */
+    /** Logs whether or not `verbose` is on — for events a developer must see
+     *  without opting in. */
     info(msg: string): void;
     warn(msg: string): void;
     logTimingWaterfall(timing: Record<string, number>): void;
-    /**
-     * Load a SystemInstance via Rust NAPI (rquickjs bundled eval) into
-     * `this.system`. On failure the previous config is kept (strict mode
-     * throws instead).
-     */
+    /** Load the system into `this.system`. On failure the previous config is
+     *  kept; strict mode throws instead. */
     loadSystem(): void;
-    /**
-     * Run project analysis via the shared `runProjectAnalysis` and update
-     * all manifest-derived state. Returns whether the analysis PUBLISHED —
-     * `false` means the previous manifest is still current, and callers that
-     * advanced the file cache for this attempt must roll that entry back or
-     * the content-hash gate will suppress the same-content retry forever
-     * (openspec: dev-transform-coherence, "Failed analyses do not suppress
-     * equal-content retries"). Strict mode still throws.
-     */
+    /** Runs project analysis and updates every manifest-derived state. Returns
+     *  false when nothing published, and the caller must roll its cache back. */
     runAnalysis(fileEntries: Array<{
         path: string;
         source: string;
         hash?: string;
     }>): boolean;
-    /**
-     * `runtimeImport` swaps ONE module specifier under every generated
-     * factory import, and the engine performs no export validation — an
-     * override that supplies only `createClassResolver` (the documented
-     * class-resolver entry contract) breaks the bundle at LOAD the moment any
-     * non-`.asClass()` terminal exists, with the error pointing at generated
-     * code. Guaranteed-broken output escalates in every mode, exactly like
-     * error diagnostics (extraction-diagnostics §Error diagnostics fail the
-     * build), naming the offending components instead of the import site.
-     */
     private assertRuntimeImportSuppliesTerminals;
-    /** The shared ingestion policy point — capability guard, facts memo, and
-     *  warn-dedupe lifecycle all live in the pipeline, not per host. */
-    private sourceIngestor;
-    /** Prepare one raw-source corpus through the shared adaptation boundary. */
-    ingestRawSources(fileEntries: readonly RawSourceEntry[]): Promise<SourceIngestionResult>;
-    /** Surface adapter diagnostics under the shared strict/warn policy. */
-    surfaceSourceDiagnostics(diagnostics: readonly SourceIngestionDiagnostic[]): Set<string>;
-    /**
-     * The one ingest → quarantine → analyze → publish transaction, shared by
-     * buildStart and every incremental path. Per-file quarantine: one invalid
-     * original warns and drops without aborting the rest of the corpus
-     * (strict mode throws from the shared policy). `runAnalysis(...) !==
-     * false` is the documented success contract (a `void` behavioral test
-     * double reads as success), and the accepted corpus publishes only on
-     * success. `beforeAnalysis` runs between quarantine and analysis for the
-     * two sites with a documented ordering constraint: buildStart's dev-cache
-     * seed must survive a strict analysis throw, and the geological reset
-     * clears the engine cache only after strict ingestion diagnostics had
-     * their chance to throw.
-     */
+    /** The one ingest → quarantine → analyze → publish transaction. The corpus
+     *  publishes only on success; `beforeAnalysis` runs after quarantine. */
     analyzeIngested(options?: {
         rawEntries?: readonly RawSourceEntry[];
         beforeAnalysis?: (accepted: SourceIngestionResult) => void;
@@ -216,107 +115,29 @@ export declare class PluginContext {
         ok: boolean;
         accepted: SourceIngestionResult;
     }>;
-    /** Publish every parser child and ownership edge atomically after analysis. */
     publishSourceIngestion(result: SourceIngestionResult): void;
-    /** Base-prefixed dev URL for an absolute file (Vite mounts /@fs under base). */
     devFsUrl(absPath: string): string;
-    /**
-     * The shared unresolvable-asset policy: fail the build under `strict`,
-     * else warn and record the identity mapping so the specifier emits
-     * literally.
-     */
     assetFallback(specifier: string, message: string, cause?: unknown): void;
-    /**
-     * The one asset-substitution pass per analysis. In dev, a specifier not
-     * already mapped by buildStart's bundler-resolved pass (a geological
-     * reset regenerates globalCss from an edited system, which may reference
-     * NEW assets) is resolved Node-side first — host aliases, then Node,
-     * then package root; bundler-only resolutions can differ, since the
-     * plugin hook context is unavailable on this path. Strict semantics
-     * match buildStart.
-     */
+    /** Resolves asset specifiers a system reload introduced. Node-side only —
+     *  the plugin hook context is unavailable here, so results can differ. */
     private applyAssetSubstitutions;
     private resetCoalescer;
-    /**
-     * Schedule a geological reset through the burst coalescer. N dependency
-     * events within the quiescence window produce one reset; events during a
-     * running reset produce exactly one follow-up.
-     */
-    requestGeologicalReset(trigger: string): void;
-    /**
-     * A failed reset must surface without killing the server: the coalescer
-     * fires from a bare timer, OUTSIDE Vite's handleHMRUpdate catch, so a
-     * strict-mode throw (asset resolution, token contracts, system load)
-     * would otherwise be an unhandled exception that exits the process.
-     * Strict-in-dev means the error overlay, matching the transform/HMR
-     * strict paths that Vite itself catches.
-     */
-    private geologicalResetFailed;
-    /**
-     * The geological reset: reload the system (refreshing the dependency
-     * set), clear the Rust per-file cache, re-analyze everything with full
-     * sources, then invalidate the static/component/system-prop virtual
-     * modules and reload the client.
-     */
-    performGeologicalReset(): Promise<void>;
-    private performGeologicalResetExclusive;
-    private invalidateGeologicalResetModules;
-    /**
-     * True when the file is a member of the system's evaluated module-file
-     * set. Tested BEFORE component-scan exclude filters: a system dependency
-     * edit invalidates the compiler registry regardless of what the user
-     * excluded from component scanning.
-     */
+    requestSystemReload(trigger: string): void;
+    performSystemReload(): Promise<void>;
+    private performSystemReloadExclusive;
+    private invalidateSystemReloadModules;
     isSystemDependency(absFile: string): boolean;
-    /**
-     * Ask the dev watcher to watch every loader-reported dependency path.
-     * Covers system modules unreachable from app imports (workspace package
-     * config files). Vite's watcher hard-ignores `node_modules`, so
-     * node_modules-installed system dependencies produce no events — a
-     * documented limitation; workspace deps resolve to real paths outside
-     * node_modules and are watchable. No-ops without a dev server.
-     */
+    /** Watch every loader-reported dependency path. Vite hard-ignores
+     *  node_modules, so dependencies installed there produce no events. */
     registerSystemWatchPaths(): void;
-    /**
-     * Invalidate the component CSS and system-props virtual modules, then
-     * reload the client. Shared by the two out-of-band re-analysis paths — a
-     * file created after buildStart (transform) and a file deleted during dev
-     * (the `hotUpdate` delete event) — which both mutate the cache, re-run
-     * analysis, and then need the client to pick up the regenerated CSS.
-     * No-ops outside dev.
-     *
-     * `devServer.moduleGraph` is Vite's back-compat mixed graph: its
-     * `getModuleById` searches the client AND ssr environment graphs and its
-     * `invalidateModule` invalidates both instances behind the returned node,
-     * which is exactly the reach this path wants. It stays the seam here.
-     *
-     * Both modules are invalidated unconditionally, and deliberately so: the
-     * appearance or disappearance of a whole component file is not the
-     * steady-state edit the change-gated path governs, and a client reload does
-     * NOT rescue a module that was never invalidated — Vite keeps serving its
-     * cached transform result across reloads (openspec: hmr-new-file-detection,
-     * "CSS invalidation after new file analysis").
-     */
+    /** Invalidate the component CSS and system-props modules, then reload. The
+     *  reload alone rescues nothing: Vite keeps serving its cached transform.
+     *  `devServer.moduleGraph` is the mixed back-compat graph on purpose — it
+     *  reaches client and ssr at once; per-environment graphs do not. */
     invalidateExtractedModules(): void;
-    /**
-     * The buildStart gate over include resolution
-     * (external-package-file-discovery: silence is never an outcome). An
-     * unresolvable `.includes()` specifier warns in non-strict mode and FAILS
-     * the build under `strict: true`, naming every offending specifier —
-     * a typo'd include must not ship a build missing its component CSS. A
-     * stale dist entry under an extended package (first-class-extension D13)
-     * rides the same seam: a merge against it would silently skew registry
-     * content the discovered sources no longer match.
-     */
+    /** An unresolvable `.includes()` specifier or a stale dist entry under an
+     *  extended package warns, and fails the build under `strict`. */
     enforceIncludeResolution(): void;
-    /**
-     * The post-analysis gate over cross-source token contracts
-     * (extraction-diagnostics): a discovered component referencing a token its
-     * OWN package defines but the consumer theme does not gets the teaching
-     * error naming the token, component, source package, and the missing
-     * `createTheme().extend(...)`. Wiring and severity routing live in the
-     * shared pipeline gate (next-plugin parity by construction).
-     */
     enforceExternalTokenContracts(): void;
     runSelfVerify(): void;
 }

package/dist/context.d.ts.map

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

package/dist/css.d.ts

@@ -1,9 +1,3 @@
-/**
- * CSS post-processing — the implementation lives in
- * `@animus-ui/extract/pipeline` (spec: css-post-processing, single
- * implementation across plugins). This module re-exports it for the
- * plugin's hook modules.
- */
 export type { LightningTargets } from '@animus-ui/extract/pipeline';
 export { postProcessCss, resolveLightningTargets, } from '@animus-ui/extract/pipeline';
 //# sourceMappingURL=css.d.ts.map

package/dist/css.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../src/css.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,YAAY,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EACL,cAAc,EACd,uBAAuB,GACxB,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../src/css.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EACL,cAAc,EACd,uBAAuB,GACxB,MAAM,6BAA6B,CAAC"}

package/dist/hmr.d.ts

@@ -1,23 +1,6 @@
 import type { PluginContext } from './context';
 import type { DevEnvironment, EnvironmentModuleNode, HotUpdateOptions } from 'vite';
-/**
- * hotUpdate: the single dev file-event hook. Handles system-dependency
- * membership (geological reset), content-hash diffing with incremental
- * re-analysis, deleted-file cache pruning, and targeted module invalidation
- * (component CSS, system props, and definition files whose replacement
- * changed).
- *
- * Vite 8 dispatches this hook once per environment for ONE file event — the
- * client environment first, then every non-client environment (see
- * `handleHMRUpdate` in vite/dist/node/chunks/node.js). The analysis half is
- * therefore claimed by exactly one dispatch (`ctx.hotUpdateEvents`), while the
- * invalidation half runs in every environment against its own module graph —
- * what the mixed-graph `handleHotUpdate` used to achieve implicitly by
- * invalidating the client and SSR instance behind one module node.
- *
- * The hook fires for every watched file whether or not it has modules in any
- * graph, so system dependencies registered through `watcher.add` outside the
- * root still reach the reset branch, with an empty `modules` list.
- */
+/** Vite dispatches this hook once per environment for one file event: the
+ *  analysis half is claimed by one dispatch, invalidation runs in each. */
 export declare function handleHotUpdate(ctx: PluginContext, environment: DevEnvironment, options: HotUpdateOptions): Promise<EnvironmentModuleNode[] | void>;
 //# sourceMappingURL=hmr.d.ts.map

package/dist/hmr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hmr.d.ts","sourceRoot":"","sources":["../src/hmr.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,MAAM,CAAC;AAEd;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,aAAa,EAClB,WAAW,EAAE,cAAc,EAC3B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,qBAAqB,EAAE,GAAG,IAAI,CAAC,CAUzC"}
+{"version":3,"file":"hmr.d.ts","sourceRoot":"","sources":["../src/hmr.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,MAAM,CAAC;AAEd;2EAC2E;AAC3E,wBAAsB,eAAe,CACnC,GAAG,EAAE,aAAa,EAClB,WAAW,EAAE,cAAc,EAC3B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,qBAAqB,EAAE,GAAG,IAAI,CAAC,CAKzC"}

package/dist/hot-update-events.d.ts

@@ -1,31 +1,11 @@
 /**
- * What the owning dispatch decided for one file event, so the remaining
- * environments act on the same decision instead of re-deriving it from state
- * the owner already mutated.
- *
- * - `ignored` — out of extraction scope (extension gate, exclude pattern,
- *   unreadable, MDX skipped): normal Vite HMR applies.
- * - `unchanged` — content hash identical: the update is suppressed everywhere.
- * - `analyzed` — re-analysis ran; every environment invalidates the affected
- *   modules in its own graph. `staleDefinitionFiles` are rootDir-relative
- *   definition files whose component replacement changed (the changed file
- *   itself is never listed). `systemPropsChanged` reports whether the served
- *   system-props module moved (see the transaction-spanning compare in
- *   hmr.ts `analyzeChangedFile`) — only the owning dispatch holds the
- *   before/after values, so it travels with the decision rather than being
- *   re-derived per environment.
- *   `presentationOnly` reports that the changed file's transform output is
- *   byte-identical before and after the edit (style values are not part of
- *   the emitted replacement — class names hash `filename::binding`): every
- *   environment then excludes the file's own modules from the update it
- *   returns, so the module never re-executes and React component identity,
- *   generated IDs, focus, and DOM-owned state survive the edit. Computed once
- *   by the owning dispatch (it needs the pre-edit source and manifest, which
- *   the owner consumed while re-analyzing) — the same travel rule as
- *   `systemPropsChanged`.
+ * What the owning dispatch decided for one file event. `evicted` is a lost
+ * decision for an in-scope file, so each environment invalidates broadly.
  */
 export type HotUpdateResult = {
     kind: 'ignored';
+} | {
+    kind: 'evicted';
 } | {
     kind: 'unchanged';
 } | {
@@ -35,35 +15,25 @@ export type HotUpdateResult = {
     presentationOnly: boolean;
 };
 /**
- * Once-per-file-event coordination across the `hotUpdate` dispatches.
- *
- * Vite 8 calls `hotUpdate` once per environment for a single file event — the
- * client environment first, then every non-client environment (see
- * `handleHMRUpdate` in vite/dist/node/chunks/node.js). Analysis work (cache
- * mutation, engine re-analysis, geological reset scheduling) must happen
- * exactly once per event; module invalidation must happen per environment
- * against that environment's own graph.
- *
- * The client dispatch always claims — it is dispatched first, so nothing can
- * have claimed the event before it, and claiming unconditionally keeps a
- * same-millisecond `(file, timestamp)` collision from ever costing a client
- * analysis. A non-client dispatch claims only when the event carries no
- * recorded claim at all, which happens when the plugin is filtered out of the
- * client environment.
- *
- * Keys are retained for a bounded number of recent events so that interleaved
- * file events (Vite does not serialize watcher handlers) still find their own
- * result.
+ * Vite dispatches `hotUpdate` once per environment, client first: analysis
+ * runs for one dispatch, invalidation for all, coordinated through these keys.
  */
 export declare class HotUpdateEvents {
     private readonly historyLimit;
     private readonly results;
+    /** Keys whose decision aged out of `results`, in eviction order. */
+    private readonly evicted;
     constructor(historyLimit?: number);
     /** True when this environment dispatch owns the event's analysis work. */
     claim(environmentName: string, file: string, timestamp: number): boolean;
     /** Publish the owning dispatch's decision to the other environments. */
     record(file: string, timestamp: number, result: HotUpdateResult): void;
-    /** The decision for this event — `ignored` when the event was evicted. */
+    /**
+     * The decision for this event — `evicted` once it aged out of the decision
+     * window, `ignored` only when no dispatch ever claimed it.
+     */
     resultOf(file: string, timestamp: number): HotUpdateResult;
+    /** Hold both windows at `historyLimit`, oldest insertion first. */
+    private retireOldest;
 }
 //# sourceMappingURL=hot-update-events.d.ts.map

package/dist/hot-update-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hot-update-events.d.ts","sourceRoot":"","sources":["../src/hot-update-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEN;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,eAAe;IAGd,OAAO,CAAC,QAAQ,CAAC,YAAY;IAFzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAE9D,YAA6B,YAAY,SAAK,EAAI;IAElD,0EAA0E;IAC1E,KAAK,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAUvE;IAED,wEAAwE;IACxE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAErE;IAED,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,CAEzD;CACF"}
+{"version":3,"file":"hot-update-events.d.ts","sourceRoot":"","sources":["../src/hot-update-events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEN;;;GAGG;AACH,qBAAa,eAAe;IAKd,OAAO,CAAC,QAAQ,CAAC,YAAY;IAJzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAC9D,oEAAoE;IACpE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAE7C,YAA6B,YAAY,SAAK,EAAI;IAElD,0EAA0E;IAC1E,KAAK,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAgBvE;IAED,wEAAwE;IACxE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAOrE;IAED;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,CAKzD;IAED,mEAAmE;IACnE,OAAO,CAAC,YAAY;CAarB"}