@animus-ui/extract 0.1.9 → 0.1.11

package/dist/session/session-paths.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Session-scoped artifact names, path derivations, and the analysis-status
+ * shape (openspec: next-turbopack-served-transform-coherence, design D1–D3)
+ * — shared by the session writer (extraction-session), the webpack
+ * plugin/loader, and the Turbopack loader.
+ *
+ * Deliberately free of singleton/session imports: the Turbopack loader
+ * executes in isolated worker processes and its module graph must stay
+ * worker-local (guardrail G1) — this module is pure path/shape vocabulary.
+ */
+/** Session-dir-relative name of the replacement-epoch disk witness
+ *  (openspec: next-webpack-served-transform-coherence, design D2;
+ *  session-scoped by next-turbopack-served-transform-coherence D2). */
+export declare const REPLACEMENT_EPOCH_ARTIFACT = "replacements-epoch";
+/** Virtual module id of the emitted system-props module — session
+ *  vocabulary shared by the orchestrator and the Turbopack config
+ *  assembly (hoisted here so the session home stays framework-free). */
+export declare const TURBOPACK_SYSTEM_PROPS_ID = "virtual:animus/system-props";
+/** Session-dir-relative name of the analysis-commit transaction artifact
+ *  (design D1). */
+export declare const ANALYSIS_COMMIT_ARTIFACT = "analysis-commit";
+/** Session-dir-relative name of the analysis-status artifact (design D3). */
+export declare const ANALYSIS_STATUS_ARTIFACT = "analysis-status.json";
+/** Session-dir-relative name of the manifest payload artifact. */
+export declare const MANIFEST_ARTIFACT = "manifest.json";
+/** Session-dir-relative name of the analysis-inputs payload artifact
+ *  (Turbopack loader-worker hydration corpus). */
+export declare const ANALYSIS_INPUTS_ARTIFACT = "analysis-inputs.json";
+/** Session-dir-relative name of the emitted stylesheet artifact. */
+export declare const STYLES_ARTIFACT = "styles.css";
+/** Session-dir-relative name of the emitted system-props module. */
+export declare const SYSTEM_PROPS_ARTIFACT = "system-props.js";
+/** Session-dir-relative directory holding copied asset() files. */
+export declare const SESSION_ASSETS_DIR = "assets";
+/** The standalone CLI's published-set commit record, written into the flat
+ *  `.animus/` tree (openspec: standalone-extraction-cli D3). Shared here so
+ *  the CLI writer and the session's start hygiene agree on ONE name — the
+ *  hygiene confinement gate keys on this record, and a renamed literal on
+ *  either side would silently re-arm deletion of the CLI's published output. */
+export declare const CLI_COMMIT_ARTIFACT = "commit.json";
+/** The standalone CLI's single-writer advisory lock in the flat `.animus/`
+ *  tree. A live holder means a CLI invocation owns that tree right now. */
+export declare const CLI_LOCK_ARTIFACT = "lock.json";
+/** Root of every session-scoped artifact tree for a project. */
+export declare function sessionsRootDir(rootDir: string): string;
+/** One session's artifact directory (design D2: session-scoped trees,
+ *  no global pointer). */
+export declare function sessionArtifactDir(rootDir: string, sessionId: string): string;
+/** Absolute path of a session's replacement-epoch artifact — the single
+ *  derivation shared by the session writer, the webpack plugin's
+ *  watch-ignore entry, and both loaders' file dependencies. Takes the
+ *  SESSION directory (not the project root) since the artifact was
+ *  relocated into the session tree. */
+export declare function replacementEpochPath(sessionDir: string): string;
+/** Absolute path of a session's analysis-commit artifact. */
+export declare function analysisCommitPath(sessionDir: string): string;
+/** Absolute path of a session's analysis-status artifact. */
+export declare function analysisStatusPath(sessionDir: string): string;
+/** Absolute path of a session's manifest artifact. */
+export declare function manifestPath(sessionDir: string): string;
+/** Absolute path of a session's analysis-inputs artifact. */
+export declare function analysisInputsPath(sessionDir: string): string;
+/** Absolute path of a session's stylesheet artifact. */
+export declare function stylesPath(sessionDir: string): string;
+/** Absolute path of a session's system-props module artifact. */
+export declare function systemPropsPath(sessionDir: string): string;
+/** Session-scoped analysis-status shape (design D3). Successful loader
+ *  invocations never depend on it; it exists so a loader observing a
+ *  source/commit mismatch can decide — on evidence — whether to wait.
+ *
+ *  Schema 2 (openspec: standalone-extraction-cli, watch readiness) adds the
+ *  additive `ready` field; every other field is unchanged, so schema-1
+ *  readers keep working (no reader branches on the schema value — the bump
+ *  records the shape revision for artifact archaeology). */
+export interface AnalysisStatus {
+    schema: 1 | 2;
+    sessionId: string;
+    attemptId: number;
+    state: 'starting' | 'debouncing' | 'analyzing' | 'committing' | 'idle' | 'failed';
+    /** [(rootDir-relative sourceKey, observed content hash)] of the batch. */
+    pending: Array<[string, string]>;
+    /** Epoch-ms deadline for the active attempt (debounce ceiling + 2s). */
+    deadlineAt: number;
+    diagnostic?: string;
+    /** Monotonic first-emission witness (additive, schema 2): absent or false
+     *  until the session's FIRST successful complete publication, true on
+     *  every status write after it — including 'failed' writes, which is what
+     *  makes readiness distinct from `state: 'idle'` (idle recurs per attempt;
+     *  ready never regresses within a session). */
+    ready?: boolean;
+}
+/** analysis-commit artifact shape (design D1: the transaction identity —
+ *  hashes are of the DISK payload bytes, envelope included). `inputsHash`
+ *  is present only when the hydration corpus is persisted (Turbopack
+ *  orchestration); webpack-mode commits omit it (spec:
+ *  next-turbopack-integration, "Webpack mode skips the hydration corpus"). */
+export interface AnalysisCommit {
+    schema: 1;
+    sessionId: string;
+    generation: number;
+    replacementEpoch: string;
+    manifestHash: string;
+    inputsHash?: string;
+    stylesHash: string;
+}
+/** Envelope embedded in every payload artifact (design D2: sessionId in
+ *  every artifact; payloadHash lets a same-session restart seed its write
+ *  guards without byte-reconstructing the payload). */
+export interface SessionEnvelope {
+    sessionId: string;
+    generation: number;
+    replacementEpoch: string;
+    payloadHash: string;
+}
+/** Splice the session envelope into a JSON-object payload as a leading
+ *  `__animusSession` field, byte-preserving the payload's own content
+ *  (parse/re-stringify could reformat engine-emitted JSON). */
+export declare function envelopeJsonArtifact(payload: string, envelopeJson: string): string;
+/** Trailing-comment side-band for the CSS artifact (a leading comment
+ *  would displace the @layer declaration consumers pin at offset 0). */
+export declare function envelopeCssArtifact(payload: string, envelopeJson: string): string;
+/** Matches the CSS artifact's envelope side-band. */
+export declare const ENVELOPE_CSS_COMMENT_RE: RegExp;
+/** Envelope of a JSON artifact's bytes, or undefined when the artifact
+ *  carries none. THROWS on unparseable bytes — callers decide whether a
+ *  torn artifact fails closed or degrades. */
+export declare function readJsonEnvelope(bytes: string): SessionEnvelope | undefined;
+/** Envelope of the CSS artifact's side-band comment, or undefined when the
+ *  side-band is absent. THROWS on an unparseable envelope body. */
+export declare function readCssEnvelope(bytes: string): SessionEnvelope | undefined;
+//# sourceMappingURL=session-paths.d.ts.map

package/dist/session/session-paths.d.ts.map

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

package/dist/session/singleton.d.ts

@@ -0,0 +1,124 @@
+export declare function getManifestJson(): string | null;
+export declare function setManifestJson(json: string): void;
+export declare function getAnalysisPromise(): Promise<void> | null;
+export declare function setAnalysisPromise(promise: Promise<void>): void;
+export declare function resetAnalysisPromise(): void;
+export declare function getSharedCss(): string;
+export declare function setSharedCss(css: string): void;
+export declare function getSharedSystemProps(): string;
+export declare function setSharedSystemProps(content: string): void;
+export declare function getSharedExternalDirs(): string[];
+export declare function setSharedExternalDirs(dirs: string[]): void;
+export declare function getSharedExternalEntries(): Map<string, string>;
+export declare function setSharedExternalEntries(entries: Map<string, string>): void;
+/** Structural view of the owning session a forwarded watch batch targets —
+ *  kept minimal (and defined here, not imported) so the singleton never
+ *  depends on the session module it serves. */
+export interface WatchBatchTarget {
+    ingestForwardedBatch(changes: {
+        modifiedFiles?: ReadonlySet<string>;
+        removedFiles?: ReadonlySet<string>;
+    }): Promise<void>;
+}
+/**
+ * The session that completed the full pipeline and holds system state — the
+ * only instance that can run watch analysis. Each MultiCompiler child holds
+ * its own session AND its own watcher with its own modified set; a
+ * non-owning session forwards its batch here instead of dropping it (a file
+ * only that compiler watches would otherwise never be analyzed).
+ */
+export declare function getOwningWatchSession(): WatchBatchTarget | null;
+export declare function setOwningWatchSession(session: WatchBatchTarget | null): void;
+/**
+ * Per-file analyzed content hashes of the last published analysis (relPath →
+ * contentHash of the exact bytes analyzed) — the loader's witness for the
+ * unconditional catching-up guard (openspec:
+ * next-webpack-served-transform-coherence, design D4). Includes files
+ * analyzed with ZERO animus entries: analyzed identity is membership in the
+ * analysis input set, not manifest entry count.
+ */
+export declare function getAnalyzedHashes(): ReadonlyMap<string, string> | null;
+export declare function setAnalyzedHashes(hashes: Map<string, string>): void;
+/**
+ * Session identity is per Next INVOCATION — one process, however many
+ * compiler instances it holds (openspec:
+ * next-turbopack-served-transform-coherence, design D2). The first
+ * ExtractionSession constructed in a process claims a fresh randomUUID;
+ * every later instance (client/server/RSC compilers each construct one)
+ * adopts it, so all compilers alias, watch-ignore, and publish ONE
+ * session-scoped artifact tree. Separate invocations (`next dev` +
+ * `next build` co-writing) are separate processes and therefore separate
+ * sessions by construction.
+ */
+export declare function claimProcessSessionId(): string;
+/**
+ * Exclusive-ownership claim over the process-global session state — the
+ * hard form of the invariant `claimProcessSessionId` documents softly. The
+ * shared slots above (manifest, css, artifact dir) plus the one session id
+ * mean two CONCURRENT drive loops in one process (a webpack MultiCompiler
+ * array config, parallel rollup array builds, two programmatic CLI runs)
+ * would share one session directory, overwrite each other's manifests, and
+ * delete each other's live trees on dispose. Drivers that run the loop
+ * exclusively (the unplugin host) claim for the build's lifetime and
+ * release on dispose; SEQUENTIAL claim/release cycles are legal. The Next
+ * multi-compiler adoption path stays the non-exclusive default. Throws
+ * naming both hosts and the remediation on overlap. The key lives in
+ * `SINGLETON_GLOBAL_KEYS`, so per-test global resets clear a leaked claim.
+ */
+export declare function claimExclusiveSessionOwner(label: string): () => void;
+/**
+ * Absolute session artifact directory of the OWNING session's last
+ * publication — the webpack loader's source for the session-scoped epoch
+ * dependency path (the loader shares the process with the pipeline; the
+ * Turbopack loader instead receives the directory via its options).
+ */
+export declare function getSessionArtifactDir(): string | null;
+export declare function setSessionArtifactDir(dir: string): void;
+/**
+ * Canonical replacement epoch of the last published analysis
+ * (`hashReplacementPlans(snapshotFilePlans(manifest), systemPropsContent)`
+ * — openspec: next-webpack-served-transform-coherence, design D5; the
+ * served system-props module rides as the served-dependency witness so
+ * offline system-props changes move the epoch). Published by the
+ * owning session AFTER the manifest so a reader that observes the epoch
+ * always observes at least that generation's manifest. (Session
+ * attribution lives on the DISK epoch artifact — no in-process mirror.)
+ */
+export declare function getReplacementEpoch(): string | null;
+export declare function setReplacementEpoch(epoch: string): void;
+/**
+ * The one in-flight watch-analysis transaction (design D3): the first
+ * compiler entering a watch batch runs analysis + publication; every other
+ * compiler (client/server/RSC — each holds its own session instance) joins
+ * this promise instead of proceeding against a pre-transaction generation.
+ */
+export declare function getWatchTransaction(): Promise<void> | null;
+export declare function setWatchTransaction(transaction: Promise<void> | null): void;
+export type AnimusEngine = 'v2';
+/** Engine selection travels through the singleton so non-owning compiler
+ *  instances and the webpack loader honor the same choice as the owner. */
+export declare function setSharedEngine(engine: AnimusEngine): void;
+export declare function getSharedEngine(): AnimusEngine;
+/** Single engine choke-point for every native extraction call. Return type
+ *  mirrors the untyped `require` the call sites previously used — the NAPI
+ *  module's own .d.ts is the authoritative surface. */
+export declare function requireEngine(): any;
+/**
+ * Test seam (injected-fn pattern — module mocks cannot reach a bundled
+ * dist copy of this module): inject a replacement engine API. GlobalThis-
+ * keyed so every copy of this module — source-imported, dist-imported,
+ * ESM/CJS dual-load — honors the one override. Deliberately NOT in
+ * SINGLETON_GLOBAL_KEYS: the override's lifecycle belongs to the test
+ * file, and per-test global resets must not strip it mid-suite. Pass null
+ * to restore the native-backed API.
+ */
+export declare function setEngineApiOverride(api: (() => any) | null): void;
+export declare function engineApi(): any;
+/**
+ * Every globalThis key this module owns EXCEPT the engine-api override
+ * (whose lifecycle belongs to the test file that set it — see
+ * setEngineApiOverride) — the single authority test harnesses
+ * snapshot/clear per test (never re-declare this list).
+ */
+export declare const SINGLETON_GLOBAL_KEYS: readonly ["__animus_manifest_json__", "__animus_analysis_promise__", "__animus_shared_css__", "__animus_shared_system_props__", "__animus_external_pkg_dirs__", "__animus_external_source_entries__", "__animus_analyzed_hashes__", "__animus_replacement_epoch__", "__animus_watch_transaction__", "__animus_process_session_id__", "__animus_session_artifact_dir__", "__animus_owning_watch_session__", "__animus_exclusive_session_owner__", "__animus_engine__", "__animus_v2_engine__", "__animus_v2_sent_sources__", "__animus_v2_drift_warned__"];
+//# sourceMappingURL=singleton.d.ts.map

package/dist/session/singleton.d.ts.map

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

package/dist/session/timing.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Verbose build-timing waterfall: JS phases, analysis sub-phases, and the
+ * shared Rust phase table. `ANIMUS_TIMING_JSON=1` additionally dumps a
+ * machine-readable merged record.
+ */
+export declare function logBuildTimings(bt: Record<string, number>, rustTiming: Record<string, number> | undefined, log: (msg: string) => void, verbose: boolean): void;
+//# sourceMappingURL=timing.d.ts.map

package/dist/session/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../session/timing.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC9C,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EAC1B,OAAO,EAAE,OAAO,GACf,IAAI,CAqDN"}

package/dist/session/turbopack-orchestrator.d.ts

@@ -0,0 +1,43 @@
+import { watch } from 'fs';
+import type { ExtractionSession } from './extraction-session';
+/**
+ * Out-of-band pipeline orchestration for Turbopack (spec:
+ * next-turbopack-integration). Turbopack exposes no compiler hooks, so the
+ * pipeline runs during next.config resolution and, in dev, from a
+ * filesystem watcher — the bundler only ever sees the `.animus/` disk
+ * artifacts.
+ */
+/** Run the full pipeline with the Turbopack emitter identity: the virtual
+ *  system-props id (Turbopack rejects the webpack path's absolute-path
+ *  imports). Turbopack orchestration persists the analysis-inputs
+ *  hydration corpus — its isolated loader workers replay it (spec:
+ *  next-turbopack-integration, "Manifest disk artifact"; webpack mode
+ *  skips the corpus). */
+export declare function runSessionPipeline(session: ExtractionSession): Promise<void>;
+/**
+ * Start the dev watcher: fs.watch per eligible top-level directory (plus a
+ * non-recursive watch on the root itself), debounced into
+ * existence-partitioned modified/removed sets feeding
+ * `session.handleWatchUpdate` (serialized — updates never overlap).
+ * Generated and vendored trees (`.animus`, `.next`, node_modules) are never
+ * registered with the OS — recursive registration of those trees exhausts
+ * inotify/kqueue descriptors (EMFILE/ENOSPC) on large projects.
+ * Idempotent per project root; unref'd so it never holds the process open.
+ * Asynchronous FSWatcher errors degrade to no-watch with a warning instead
+ * of crashing the dev server. Returns a close handle, or null when this
+ * root is already watched or the platform lacks recursive fs.watch (Linux
+ * before Node 20 — degrades to no-watch with a warning).
+ */
+export declare function startTurbopackWatcher(session: ExtractionSession, rootDir: string, debounceMs?: number, watchFn?: typeof watch): TurbopackWatcherHandle | null;
+/** The project-watch handle `startTurbopackWatcher` returns. `close()` is
+ *  caller-initiated teardown; `died` flips only on an ASYNC watcher error
+ *  (EMFILE/ENOSPC after registration) with `onDied` invoked once so the
+ *  process owner can surface the degradation; `settle()` resolves when the
+ *  in-flight update chain has drained. */
+export interface TurbopackWatcherHandle {
+    close(): void;
+    readonly died: boolean;
+    onDied: (() => void) | null;
+    settle(): Promise<void>;
+}
+//# sourceMappingURL=turbopack-orchestrator.d.ts.map

package/dist/session/turbopack-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turbopack-orchestrator.d.ts","sourceRoot":"","sources":["../../session/turbopack-orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,KAAK,EAAE,MAAM,IAAI,CAAC;AAK9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;;;;;GAMG;AAEH;;;;;yBAKyB;AACzB,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAIf;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,MAAM,EACf,UAAU,SAAK,EAGf,OAAO,GAAE,OAAO,KAAa,GAC5B,sBAAsB,GAAG,IAAI,CAoT/B;AAED;;;;0CAI0C;AAC1C,MAAM,WAAW,sBAAsB;IACrC,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB"}