@animus-ui/extract 0.1.25 → 0.1.27

package/dist/pipeline/discover-packages.d.ts

@@ -1,8 +1,10 @@
 import type { EngineApi } from './engine-adapter';
+import type { ExtensionOrder, ProbedFile } from './extension-policy';
 import type { KitDescriptorRecord } from './kit-descriptor';
 import type { ManifestDiagnostic } from './manifest-diagnostics';
-import type { ExtractExportFact, ExtractImportFact } from './source-ingestion';
+import type { ExtractExportFact, ExtractFactsResult, ExtractImportFact } from './source-ingestion';
 import type { JsonValue } from './tsconfig-paths';
+import type { WorkspacePackages } from './workspace-packages';
 export declare function findPackageRoot(absEntryPath: string): string;
 export declare const PACKAGE_SRC_EXCLUDES: string[];
 export declare function isExcludedPackageRelativePath(rel: string): boolean;
@@ -11,8 +13,13 @@ export interface ExternalPackageOutcome {
     specifier: string;
     outcome: 'resolved' | 'unresolvable' | 'empty' | 'stale-dist';
     fileCount: number;
+    /** For an unresolvable specifier, why the resolver found no file. */
+    reason?: string;
 }
-export declare function resolveAbsolutePathSpecifier(absSpecifier: string, extensionsSet: ReadonlySet<string>): string | null;
+/** The file an absolute path specifier names, through the extension
+ *  policy, spelled exactly below the directory it shares with `within`
+ *  when given; a file differing only in case is a mismatch. */
+export declare function probeAbsolutePathSpecifier(absSpecifier: string, extensionsSet?: ReadonlySet<string>, within?: string, policy?: ExtensionOrder): ProbedFile;
 /** The package a bare specifier names: `@scope/name` or `name`. */
 export declare function bareSpecifierPackageName(specifier: string): string;
 /** Each `exports` subpath and its value; a bare target or condition object
@@ -29,15 +36,38 @@ export interface KitSourceCondition {
     /** Each exact entry that declares the condition: its subpath and its
      *  absolute source file. */
     entries: Array<[subpath: string, target: string]>;
-    /** Entries whose target is missing or outside the package. */
-    invalid: Array<[subpath: string, target: string]>;
+    /** Entries whose target is missing, differs from its file only in case,
+     *  or is no package target Node accepts, and which of those. */
+    invalid: Array<[subpath: string, target: string, why: string]>;
     /** The deepest directory holding every source entry: what discovery walks.
      *  Null when no entry is valid. */
     root: string | null;
 }
-/** The package's kit source condition, or null when no exact `exports`
- *  entry declares it: the package is no source kit. */
-export declare function readKitSourceCondition(pkgRoot: string): KitSourceCondition | null;
+/** A kit's source root as the system loader's table selects it (spec §2.2
+ *  A5): the rule that chose it, each exact entry's source file, and the
+ *  `animus` targets the loader does not read as source, with why. Each of
+ *  those falls back to its runtime target, except a percent-escaped one,
+ *  which fails the load. `unresolved` names why the specifier names no file
+ *  though its package was located. */
+export interface KitSourceSelection {
+    rule: 'animus' | 'source-exports' | 'src' | 'compiled';
+    root: string | null;
+    entries: Array<[subpath: string, file: string]>;
+    invalid: Array<[subpath: string, target: string, why: string]>;
+    unresolved: string | null;
+}
+/** A specifier's kit source root, given the package discovery located and
+ *  the file the host resolves; null where no host imports the specifier. */
+export type KitSourceRootResolver = (specifier: string, packageDir: string, hostEntry: string | null) => KitSourceSelection | null;
+/** Where a package is installed: the package `name` located from
+ *  `fromDir`, at its real path, or null. */
+export type PackageLocator = (name: string, fromDir: string) => string | null;
+/** The system loader's package locator under the session's declared
+ *  `workspaces`: the first `node_modules/<name>` up the tree, then the
+ *  workspace of that name. */
+export declare function nativePackageLocator(engine: Pick<EngineApi, 'locatePackage'>, workspaces: WorkspacePackages): PackageLocator;
+/** The native table's kit source roots under one resolution context. */
+export declare function nativeKitSourceRoot(engine: Pick<EngineApi, 'resolveKitSourceRoot'>, fromDir: string, conditions: readonly string[], workspaces: WorkspacePackages, policyJson: string): KitSourceRootResolver;
 /** Whether a bundler that reads the nearest `package.json`'s `sideEffects`
  *  against the file's own path keeps `absFile`; undefined without a field
  *  it reads, which keeps the bundler's side-effectful default. */
@@ -94,10 +124,22 @@ export interface CollectedExternalPackages {
     diagnostics: ManifestDiagnostic[];
     /** Each resolved package's kit descriptor, once per package root. */
     kitDescriptors: KitDescriptorRecord[];
+    /** Package name → the real root of the instance read for it (spec §2.2
+     *  A4): another instance an importer resolves is not this one. */
+    packageInstances: Record<string, string>;
 }
 export declare function collectExternalPackageSources(opts: {
     specifiers: string[];
     resolveSpecifier: (specifier: string) => string | null | Promise<string | null>;
+    /** Why `resolveSpecifier` found no file for a specifier, when it knows. */
+    unresolvedReason?: (specifier: string) => string | undefined;
+    /** Each kit's source root, as the system loader's table selects it. */
+    kitSourceRoot: KitSourceRootResolver;
+    /** Where the system loader locates each package from `rootDir`. */
+    locatePackage: PackageLocator;
+    /** The directory each specifier's package is located from: the kit's own
+     *  for a package a kit's system extends; `rootDir` otherwise. */
+    locateFrom?: (specifier: string) => string;
     rootDir: string;
     extensionsSet: ReadonlySet<string>;
     hasEntry: (relPath: string) => boolean;
@@ -106,6 +148,16 @@ export declare function collectExternalPackageSources(opts: {
     /** Called once per specifier after its package dir is derived and BEFORE
      *  its sources are walked, so a host can watch with no blind gap. */
     onPackageResolved?: (specifier: string, packageDir: string) => void;
+    /** Specifiers the host itself cannot resolve: each is admitted only where
+     *  a source entry redirects the host's import of it, since compiled output
+     *  the host never opens is nothing it bundles. */
+    requireSourceEntry?: (specifier: string) => boolean;
+    /** The host's extension order (spec §2.2 A2) for an absolute include or a
+     *  source-entry guess; the built-in policy without one. */
+    extensions?: ExtensionOrder;
+    /** The host's output directories, absolute: a package inside one is
+     *  output, never collected as source. */
+    hostOutputDirs?: readonly string[];
 }): Promise<CollectedExternalPackages>;
 export interface SourceKitDependency {
     name: string;
@@ -118,7 +170,18 @@ export interface SourceKitDependency {
  *  A bundler serves an installed one as compiled code unless told
  *  otherwise: Next keeps it external on the server unless it is in
  *  `transpilePackages`, and Vite's optimizer prebundles it. */
-export declare function sourceKitDependencies(rootDir: string): SourceKitDependency[];
+export declare function sourceKitDependencies(rootDir: string, engine: Pick<EngineApi, 'declaresKitSource' | 'locatePackage'>): SourceKitDependency[];
+/**
+ * The installed packages a system's membership reaches: each is a kit,
+ * whether or not it declares the source condition, and so is every kit its
+ * own system extends or includes. Read before any host resolves (a
+ * bundler's config), so the application's modules import as the system
+ * loader resolves them from the root, and a kit's from its own directory.
+ */
+export declare function systemKitDependencies(rootDir: string, systemPath: string, engine: Pick<EngineApi, 'systemMembership' | 'resolveSpecifier' | 'locatePackage'>): Promise<SourceKitDependency[]>;
+/** A specifier that names a package: not relative or absolute, and no URL,
+ *  scheme (`node:`, `virtual:`), subpath import or virtual id. */
+export declare function isPackageSpecifier(specifier: string): boolean;
 /**
  * An error for each kit the application's own `files` import or re-export
  * whose system the application's system does not include: a package that
@@ -132,13 +195,23 @@ export declare function sourceKitDependencies(rootDir: string): SourceKitDepende
 export declare function importedKitDiagnostics(files: ReadonlyArray<{
     path: string;
     source: string;
-}>, engine: Pick<EngineApi, 'extractFacts'>, rootDir: string, systemKits: readonly string[]): ManifestDiagnostic[];
+    hash: string;
+}>, engine: Pick<EngineApi, 'declaresKitSource' | 'locatePackage'>, rootDir: string, systemKits: readonly string[], 
+/** The engine's facts for parser-ready files: the ingestion's cached
+ *  parse, so the corpus pass that follows parses nothing again. */
+factsOf: (files: ReadonlyArray<{
+    path: string;
+    source: string;
+    hash: string;
+}>) => ExtractFactsResult): ManifestDiagnostic[];
 export interface PackageDirOwners {
     [packageDir: string]: string;
 }
 export declare function firstOwners(dirOwnerSets: Record<string, string[]>): PackageDirOwners;
 export declare function excludeCollectedPackages(collected: CollectedExternalPackages, rejectedSpecifiers: ReadonlySet<string>, rootDir: string): CollectedExternalPackages;
-export declare function unresolvableIncludesMessage(outcomes: ExternalPackageOutcome[]): string | null;
+/** Every unresolvable include, with why where the resolver said, and the
+ *  system file that includes them when the caller knows it. */
+export declare function unresolvableIncludesMessage(outcomes: ExternalPackageOutcome[], importer?: string): string | null;
 /** A stale dist silently skews merged registry content while discovery
  *  compiles the fresh sources; null when no specifier is stale. */
 export declare function staleDistIncludesMessage(outcomes: ExternalPackageOutcome[]): string | null;
@@ -158,10 +231,23 @@ export type ModuleParser = (source: string, path: string) => ModuleRecord | null
 export declare function engineModuleParser(engine: Pick<EngineApi, 'extractFacts'>): ModuleParser | undefined;
 /** A host's resolution of a bare specifier to its entry file: the one it
  *  resolves the packages a system extends with, under its own conditions. */
-export type PackageResolver = (specifier: string) => string | null | Promise<string | null>;
+/** A package specifier's file, as the module `importer` imports it. */
+export type PackageResolver = (specifier: string, importer: string) => string | null | Promise<string | null>;
 /** The warning for a `createSystem` call that the parser's scopes leave
  *  unbound: no import, declaration or parameter names it. Null when there is
  *  none, or when the parser reports no scopes. */
 export declare function unimportedCreateSystemCall(systemFilePath: string, record: ModuleRecord): ManifestDiagnostic | null;
-export declare function extractSystemFilePackages(systemFilePath: string, parseModule?: ModuleParser, report?: (diagnostic: ManifestDiagnostic) => void, resolvePackage?: PackageResolver): Promise<string[]>;
+/**
+ * The packages and local modules a system file's roots extend or include,
+ * from the engine's own read of it (spec §2.3 step 5): a bare specifier as
+ * its import spells it, a relative one resolved against the system file.
+ * The engine follows each root binding's identity through the modules this
+ * supplies on request: a relative one by the host's extension order,
+ * spelled exactly, a bare one by the host's package resolution.
+ */
+export declare function extractSystemFilePackages(systemFilePath: string, engine: Pick<EngineApi, 'systemMembership'>, report?: (diagnostic: ManifestDiagnostic) => void, resolvePackage?: PackageResolver, extensions?: ExtensionOrder, 
+/** Filled with each package member a kit's module spells, by the file it
+ *  names from that kit: the instance that kit's system extends, which can
+ *  differ from the application's own copy, or exist only under the kit. */
+kitMembers?: Map<string, string>): Promise<string[]>;
 //# sourceMappingURL=discover-packages.d.ts.map

package/dist/pipeline/discover-packages.d.ts.map

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

package/dist/pipeline/engine-adapter.d.ts

@@ -2,9 +2,14 @@
  * One engine API for both plugins. Imports neither the native binding nor any
  * plugin or bundler — every such dependency arrives injected.
  */
+import type { ProbeEvidenceGatherer } from './probe-evidence';
+import type { WorkspacePackages } from './workspace-packages';
 /** The stateful engine handle produced by `new native.ExtractEngine(...)`. */
 export interface V2ExtractEngine {
-    analyze(filesJson: string): string;
+    /** Parses the files for the next `analyze` of them, and names each base
+     *  their specifiers probe. */
+    prepare(filesJson: string): string;
+    analyze(filesJson: string, probeEvidenceJson?: string): string;
     transformFile(path: string): string;
     clearCache(): void;
 }
@@ -21,10 +26,43 @@ export interface EngineApi {
     /** Parse-only native fact extraction used to prepare adapted sources. */
     extractFacts?: (filesJson: string) => string;
     /** Each file's run-time module specifiers, for the kit publication check. */
-    moduleSpecifiers?: (filesJson: string) => string;
+    moduleSpecifiers?: (filesJson: string, pathAliasesJson?: string) => string;
+    /** Which kits a system file's roots extend or include, from the
+     *  engine's own parse; lists the modules it needs until supplied. */
+    systemMembership?: (inputsJson: string) => string;
     /** The engine's code-to-severity table, as JSON. */
     diagnosticCodes?: () => string;
-    analyzeProject: (filesJson: string, scalesJson: string, variableMapJson: string, contextualVarsJson: string | null, propConfigJson: string, groupRegistryJson: string, packageResolutionJson: string, devMode: boolean, emitterConfigJson: string | null, selectorAliasesJson: string | null, selectorOrderJson: string | null, globalStyleBlocksJson: string | null, pathAliasesJson: string | null, keyframesJson: string | null, staticCssJson: string | null, conditionAliasesJson: string | null, externalDirsJson: string | null, transformSourcesJson: string | null, transformProvenanceJson?: string | null, declarationScalesJson?: string, analysisContextJson?: string, generatedNamesJson?: string, propertyRecordsJson?: string) => string;
+    /** A specifier resolved as the system loader resolves it, a package from
+     *  `node_modules` then the declared `workspaces`, under the host's
+     *  extension order (`extensionPolicyJson`): the real path of the file it
+     *  names, or why it names none. */
+    resolveSpecifier?: (specifier: string, fromDir: string, conditions?: readonly string[], workspaces?: WorkspacePackages, extensionPolicyJson?: string) => {
+        path?: string | null;
+        unresolved?: string | null;
+    };
+    /** A fast fingerprint of the bytes at `path`, for telling whether a file
+     *  changed between watch passes; null where it cannot be read. */
+    fingerprintFile?: (path: string) => string | null;
+    /** `fingerprintFile` of bytes already read. */
+    fingerprintBytes?: (bytes: Buffer) => string;
+    /** Whether the package at `packageDir` declares the kit source condition:
+     *  an `animus` key anywhere in its `exports`, read from the manifest. */
+    declaresKitSource?: (packageDir: string) => boolean;
+    /** The package `name` as the system loader locates it from `fromDir`,
+     *  the first `node_modules/<name>` up the tree, then the declared
+     *  `workspaces`: its real path, or null where it locates none. */
+    locatePackage?: (name: string, fromDir: string, workspaces?: WorkspacePackages) => string | null;
+    /** A kit's source root as the system loader's table selects it (spec
+     *  §2.2 A5), as JSON: the rule that chose it, its entries and invalid
+     *  `animus` targets; or `{ "unresolved": why }` where no host imports the
+     *  specifier. `hostEntry` is the file the host resolves; `packageDir` the
+     *  package discovery located. */
+    resolveKitSourceRoot?: (specifier: string, fromDir: string, conditions?: readonly string[], workspaces?: WorkspacePackages, extensionPolicyJson?: string, hostEntry?: string, packageDir?: string) => string;
+    analyzeProject: (filesJson: string, scalesJson: string, variableMapJson: string, contextualVarsJson: string | null, propConfigJson: string, groupRegistryJson: string, packageResolutionJson: string, devMode: boolean, emitterConfigJson: string | null, selectorAliasesJson: string | null, selectorOrderJson: string | null, globalStyleBlocksJson: string | null, pathAliasesJson: string | null, keyframesJson: string | null, staticCssJson: string | null, conditionAliasesJson: string | null, externalDirsJson: string | null, transformSourcesJson: string | null, transformProvenanceJson?: string | null, declarationScalesJson?: string, analysisContextJson?: string, generatedNamesJson?: string, propertyRecordsJson?: string, 
+    /** Given, the session's evidence for the bases and computed loads the
+     *  engine's `prepare` names, carrying its input identity (spec §2.2
+     *  A2, A8, §6.3), as JSON. */
+    probeEvidence?: ProbeEvidenceGatherer) => string;
     transformFile: (source: string, path: string, manifest: string) => TransformFileResult;
     clearAnalysisCache: () => void;
 }

package/dist/pipeline/engine-adapter.d.ts.map

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

package/dist/pipeline/engine-retirement.d.ts

@@ -1,3 +1,9 @@
 export declare const RETIRED_ENGINE_MESSAGE: string;
-export declare function assertNoRetiredEngineSelection(engineOption: string | undefined): void;
+/**
+ * v2 is the only engine (SA2): the option and `ANIMUS_ENGINE`, a startup
+ * input a worker may pass as captured, accept `v2` or nothing. Hosts call
+ * this before the native module loads, so another selection never reaches
+ * it; either fails as a configuration error naming its source.
+ */
+export declare function assertSupportedEngine(engineOption: string | undefined, environmentSelection?: string | undefined): void;
 //# sourceMappingURL=engine-retirement.d.ts.map

package/dist/pipeline/engine-retirement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine-retirement.d.ts","sourceRoot":"","sources":["../../pipeline/engine-retirement.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,QAGQ,CAAC;AAE5C,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,IAAI,CAIN"}
+{"version":3,"file":"engine-retirement.d.ts","sourceRoot":"","sources":["../../pipeline/engine-retirement.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,sBAAsB,QAGQ,CAAC;AAE5C;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,oBAAoB,GAAE,MAAM,GAAG,SAAqC,GACnE,IAAI,CAeN"}

package/dist/pipeline/extension-policy.d.ts

@@ -0,0 +1,95 @@
+/**
+ * The one extension policy: the order in which a relative or aliased
+ * specifier's candidate files are tried. Source ingestion reads it here. The
+ * system loader and the extractor read `extension_policy.json`, which
+ * `node packages/extract/scripts/extension-policy.ts --write` generates from
+ * it, so every resolver tries the same files in the same order.
+ *
+ * The order: the base itself, the base with each appended extension, its
+ * `index` with each, then the sources an emitted NodeNext extension stands
+ * for (`./x.js` for `x.ts`), spelled exactly.
+ */
+export declare const EXTENSION_POLICY: {
+    /** Appended to the base, then to `{base}/index`. */
+    readonly appended: readonly ['.ts', '.tsx', '.js', '.jsx', '.mjs'];
+    /** An emitted extension, and the source extensions it names, in order. */
+    readonly nodeNext: readonly [readonly ['.js', readonly ['.ts', '.tsx', '.jsx']], readonly ['.jsx', readonly ['.tsx']], readonly ['.mjs', readonly ['.mts']], readonly ['.cjs', readonly ['.cts']]];
+};
+/** An extension order: what a specifier's base is tried with, in order. */
+export interface ExtensionOrder {
+    /** Appended to the base, then to `{base}/index`. */
+    readonly appended: readonly string[];
+    /** An emitted extension, and the source extensions it names, in order,
+     *  tried after the literal spelling. */
+    readonly nodeNext: ReadonlyArray<readonly [emitted: string, sources: readonly string[]]>;
+    /** A configured alias of an emitted extension: its sequence replaces the
+     *  literal try, in order. */
+    readonly alias: ReadonlyArray<readonly [emitted: string, sequence: readonly string[]]>;
+}
+/** The files `base` can name, in policy order: itself, with each appended
+ *  extension, as a directory's index with each, then the sources its
+ *  emitted NodeNext extension stands for (`x.js` names `x.ts`), spelled
+ *  exactly. Given `sources`, only extensions in it are tried, and under the
+ *  built-in order those it lacks (`.mdx`) follow its own. A configured
+ *  alias of the base's suffix replaces all of these. `index` spells a
+ *  directory's index path. */
+export declare function policyCandidates(base: string, options?: {
+    readonly sources?: ReadonlySet<string>;
+    readonly index?: (directory: string, file: string) => string;
+    /** A host's extension order (spec §2.2 A2); the built-in policy
+     *  without one. */
+    readonly policy?: ExtensionOrder;
+}): string[];
+/** What the filesystem holds at a candidate path, spelled exactly. */
+export type SeenFile = {
+    kind: 'file';
+}
+/** A file the filesystem opens under the candidate's spelling though no
+ *  directory lists that spelling: its real path, as the filesystem
+ *  reports it. */
+ | {
+    kind: 'case-only';
+    actual: string;
+} | {
+    kind: 'missing';
+};
+/** How a probe ends. A case mismatch is the first candidate a host opens
+ *  under a spelling no directory lists: a case- or normalization-insensitive
+ *  host loads it and a sensitive one does not, so it is neither found nor
+ *  absent. */
+export type ProbedFile = {
+    kind: 'found';
+    path: string;
+} | {
+    kind: 'case-mismatch';
+    candidate: string;
+    actual: string;
+} | {
+    kind: 'absent';
+};
+/** The first of `candidates` that `see` finds, in order; a candidate found
+ *  only under another case ends the probe as a mismatch. */
+export declare function probeCandidates(candidates: readonly string[], see: (candidate: string) => SeenFile): ProbedFile;
+/** What the filesystem holds at `candidate`: a file it opens under exactly
+ *  that spelling, or one it opens although a directory below the one the
+ *  candidate shares with `within` lists no entry spelled as the candidate
+ *  spells it (a case- or normalization-insensitive filesystem opening
+ *  another spelling). Nothing is folded: the filesystem decides what opens,
+ *  and its listings decide the spelling, so a file a case-sensitive
+ *  filesystem cannot open is simply missing. The shared directory is
+ *  spelled as given, as a specifier spells only the path from its
+ *  importer's directory and a manifest only the paths in its package. `..`
+ *  is taken back lexically, as Node and the bundlers resolve a specifier
+ *  before opening it. The system loader reads it alike. */
+export declare function seeOnDisk(candidate: string, within?: string): SeenFile;
+/** The first of `candidates` the filesystem holds, spelled exactly below
+ *  `within` when given. */
+export declare function probeOnDisk(candidates: readonly string[], within?: string): ProbedFile;
+/** Why `subject` names no file: the file it would load is spelled otherwise
+ *  on disk. `remedy` says what to respell. The system loader words it
+ *  alike. */
+export declare function caseMismatchReason(subject: string, mismatch: {
+    candidate: string;
+    actual: string;
+}, remedy: string): string;
+//# sourceMappingURL=extension-policy.d.ts.map

package/dist/pipeline/extension-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-policy.d.ts","sourceRoot":"","sources":["../../pipeline/extension-policy.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB;IAC3B,oDAAoD;aACpD,QAAQ,YAAG,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM;IAC/C,0EAA0E;aAC1E,QAAQ,sBACL,KAAK,YAAG,KAAK,EAAE,MAAM,EAAE,MAAM,cAC7B,MAAM,YAAG,MAAM,cACf,MAAM,YAAG,MAAM,cACf,MAAM,YAAG,MAAM;CAEV,CAAC;AAEX,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC;4CACwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAC9B,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC,CACvD,CAAC;IACF;iCAC6B;IAC7B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAC3B,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC,CACxD,CAAC;CACH;AAQD;;;;;;8BAM8B;AAC9B,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IACP,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7D;uBACmB;IACnB,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;CAC7B,GACL,MAAM,EAAE,CA2CV;AAED,sEAAsE;AACtE,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;AAClB;;kBAEkB;GAChB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAExB;;;cAGc;AACd,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEvB;4DAC4D;AAC5D,wBAAgB,eAAe,CAC7B,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,GAAG,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,QAAQ,GACnC,UAAU,CASZ;AA6BD;;;;;;;;;;2DAU2D;AAC3D,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAyBtE;AAED;2BAC2B;AAC3B,wBAAgB,WAAW,CACzB,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,MAAM,CAAC,EAAE,MAAM,GACd,UAAU,CAIZ;AAED;;aAEa;AACb,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC/C,MAAM,EAAE,MAAM,GACb,MAAM,CAOR"}

package/dist/pipeline/host-assets.d.ts

@@ -0,0 +1,32 @@
+/** Which files a host loads as opaque values (spec §2.2 A8): an asset, a
+ *  stylesheet or JSON, with no code and no effects on app objects (a CSS
+ *  module's class-name map, or JSON's values, are opaque data, never read
+ *  statically). An opaque file the host opens is Resolved(asset). Where the
+ *  host's reading is uncertain, a file is not opaque. */
+export interface HostAssetClassification {
+    /** Whether the host loads `file`, requested with `query` (`''`, or the
+     *  specifier's `?…`), as an opaque value. */
+    isAsset(file: string, query: string): boolean;
+    /** Where the classification comes from: the host's captured option, or
+     *  `built-in` with the reason (`noHost`, `hostOptionUnreadable`). */
+    readonly resolverVersion: string;
+}
+/** The built-in classification, where no host's can be read or is not
+ *  modelled (webpack's and Rspack's rules, as a conditional rule may never
+ *  apply): Vite's known asset types, `svg` included, its CSS languages
+ *  (`BUILT_IN_ASSET_SOURCE`) and JSON, read with Vite's queries. */
+export declare function builtInAssetClassification(reason: 'noHost' | 'hostOptionUnreadable', detail?: string): HostAssetClassification;
+/** Vite's own classification: `?url` and `?raw`, its known asset types and
+ *  the user's `assetsInclude`, as `ResolvedConfig.assetsInclude` answers,
+ *  its CSS languages (`isCSSRequest`), and its json plugin's JSON. */
+export declare function viteAssetClassification(assetsInclude: (file: string) => boolean, version?: string): HostAssetClassification;
+/** esbuild's classification, from its `loader` map: the loader esbuild
+ *  picks for a file is the longest extension of its name the map holds,
+ *  exact case. */
+export declare function esbuildAssetClassification(loader: Readonly<Record<string, string>> | undefined): HostAssetClassification;
+/** Turbopack's classification under Next: Next's static-image table
+ *  (`nextImageLoaderRegex`), unless `images.disableStaticImages`, and its
+ *  stylesheets (`regexLikeCss`), as the installed `next` declares them,
+ *  and JSON. Built-in where Next cannot be read. */
+export declare function nextImageAssetClassification(rootDir: string, disableStaticImages: boolean): HostAssetClassification;
+//# sourceMappingURL=host-assets.d.ts.map

package/dist/pipeline/host-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-assets.d.ts","sourceRoot":"","sources":["../../pipeline/host-assets.ts"],"names":[],"mappings":"AAQA;;;;yDAIyD;AACzD,MAAM,WAAW,uBAAuB;IACtC;iDAC6C;IAC7C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9C;yEACqE;IACrE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAqBD;;;oEAGoE;AACpE,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,QAAQ,GAAG,sBAAsB,EACzC,MAAM,CAAC,EAAE,MAAM,GACd,uBAAuB,CASzB;AAED;;sEAEsE;AACtE,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,EACxC,OAAO,CAAC,EAAE,MAAM,GACf,uBAAuB,CASzB;AAiCD;;kBAEkB;AAClB,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,GACnD,uBAAuB,CAmBzB;AAED;;;oDAGoD;AACpD,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,mBAAmB,EAAE,OAAO,GAC3B,uBAAuB,CA2BzB"}

package/dist/pipeline/host-expansions.d.ts

@@ -0,0 +1,92 @@
+/** A regular expression literal as written. */
+export interface RegexLiteral {
+    source: string;
+    flags: string;
+}
+/** A value written statically in an options object, as JSON. */
+export type StaticValue = string | number | boolean | null | StaticValue[] | {
+    [key: string]: StaticValue;
+};
+/** A computed load's arguments as written, as the engine's `prepare` lists
+ *  them: by `kind`, a specifier's static text, a context, or a glob. */
+export type ListedArgs = {
+    /** The specifier's static text between its substitutions: one more
+     *  than the substitutions. */
+    quasis: string[];
+    /** Whether the specifier is a template literal; otherwise a string
+     *  concatenation. */
+    template: boolean;
+    /** `import()`'s options object as written (its attributes). */
+    options: {
+        [key: string]: StaticValue;
+    } | null;
+    /** The comments inside the call, delimiters included. */
+    comments: string[];
+} | {
+    dir: string;
+    recursive: boolean | null;
+    regExp: RegexLiteral | null;
+    include: RegexLiteral | null;
+    exclude: RegexLiteral | null;
+    mode: string | null;
+} | {
+    patterns: string[];
+    options: {
+        [key: string]: StaticValue;
+    } | null;
+};
+/** A computed load the engine's `prepare` lists (spec §6.3): a load call or
+ *  `import()` that names no single specifier. */
+export interface ListedLoad {
+    /** The importing module, rootDir-relative, as the analysis keys it. */
+    importer: string;
+    /** The call's byte offset in the importer. */
+    start: number;
+    kind: 'import' | 'require' | 'context' | 'webpackContext' | 'glob' | 'globEager';
+    /** Null where an argument is not written statically. */
+    args: ListedArgs | null;
+}
+/** A file a computed load expands to, rootDir-relative, with the query the
+ *  host loads it with (`''`, or `?…`). */
+export interface ExpandedPath {
+    path: string;
+    query: string;
+}
+/**
+ * How a host's bundler expands computed loads (spec §6.3).
+ *
+ * A load is named by its importer, rootDir-relative exactly as the
+ * analysis keys it, and `start`, the UTF-8 byte offset of the call in the
+ * source `prepare` read. A host that locates loads with a JavaScript
+ * parser's ranges, which count UTF-16 code units, converts them first (a
+ * BOM and `// π 😀` put a call at byte 36, UTF-16 index 31).
+ */
+export interface HostLoadExpander {
+    /** Every file the bundler expands `load` to, exactly as it would, each
+     *  rootDir-relative exactly as the analysis keys it, with the query the
+     *  host loads it with. Undefined where the host's semantics are not
+     *  reproduced exactly, so the load keeps its widest reading: when in
+     *  doubt, no expansion. */
+    expand(load: ListedLoad, rootDir: string): readonly ExpandedPath[] | undefined;
+}
+/** One load's expansion, as the engine's `HostExpansion` reads it. */
+export interface HostExpansion {
+    importer: string;
+    start: number;
+    closed: boolean;
+    files: Array<{
+        path: string;
+        status: 'analysed' | 'opaque' | 'unanalysed';
+    }>;
+}
+/**
+ * The host's expansion of each listed load the expander reproduces, with
+ * each file read as the analysis and the host read it: a module the
+ * analysis holds, loaded as code without a query; a file the host loads as
+ * an opaque value (spec §2.2 A8); otherwise a file the analysis does not
+ * read. A query can select other code than the module (a plugin's
+ * transform), so a queried file that is not opaque is never the analysed
+ * module, and it keeps its query.
+ */
+export declare function hostExpansions(loads: readonly ListedLoad[], rootDir: string, analysed: ReadonlySet<string>, expander: HostLoadExpander, isAsset: ((file: string, query: string) => boolean) | undefined): HostExpansion[];
+//# sourceMappingURL=host-expansions.d.ts.map

package/dist/pipeline/host-expansions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-expansions.d.ts","sourceRoot":"","sources":["../../pipeline/host-expansions.ts"],"names":[],"mappings":"AAEA,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,gEAAgE;AAChE,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,WAAW,EAAE,GACb;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAA;CAAE,CAAC;AAEnC;wEACwE;AACxE,MAAM,MAAM,UAAU,GAClB;IACE;kCAC8B;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;yBACqB;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,OAAO,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAA;KAAE,GAAG,IAAI,CAAC;IAC/C,yDAAyD;IACzD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,GACD;IACE,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,GACD;IACE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAA;KAAE,GAAG,IAAI,CAAC;CAChD,CAAC;AAEN;iDACiD;AACjD,MAAM,WAAW,UAAU;IACzB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EACA,QAAQ,GACR,SAAS,GACT,SAAS,GACT,gBAAgB,GAChB,MAAM,GACN,WAAW,CAAC;IAChB,wDAAwD;IACxD,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;CACzB;AAED;0CAC0C;AAC1C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;+BAI2B;IAC3B,MAAM,CACJ,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM,GACd,SAAS,YAAY,EAAE,GAAG,SAAS,CAAC;CACxC;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,YAAY,CAAC;KAC9C,CAAC,CAAC;CACJ;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAC7B,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,SAAS,GAC9D,aAAa,EAAE,CAyBjB"}

package/dist/pipeline/host-extensions.d.ts

@@ -0,0 +1,64 @@
+import type { ExtensionOrder } from './extension-policy';
+/**
+ * The extension order a host resolver uses (spec §2.2 A2): the extensions it
+ * appends to a specifier, in its order, and the source substitutions it
+ * applies to an emitted extension (`./x.js` for `x.ts`). Each adapter
+ * captures it from the host's resolved configuration, so extraction can open
+ * the file the bundler loads.
+ */
+export interface HostExtensionPolicy extends ExtensionOrder {
+    /** Where the order came from: `<host>[@version] captured` when read from
+     *  the host's resolved configuration, `<host>[@version] default` when the
+     *  host sets none and runs its documented default, or `built-in` where no
+     *  host resolves (the CLI, direct engine calls) or, with the reason
+     *  `hostOptionUnreadable` (spec §2.2 A2), where the host has an order the
+     *  adapter cannot read (`built-in (hostOptionUnreadable:
+     *  rollup-node-resolve)`). */
+    readonly resolverVersion: string;
+}
+/** Animus's own order, where no host resolver configuration exists. */
+export declare const BUILT_IN_EXTENSION_POLICY: HostExtensionPolicy;
+/** Documented defaults, for a host whose resolved order is not readable. */
+export declare const HOST_DEFAULT_EXTENSIONS: {
+    readonly vite: readonly ['.mjs', '.js', '.mts', '.ts', '.jsx', '.tsx', '.json'];
+    readonly webpack: readonly ['.js', '.json', '.wasm'];
+    /** Rspack 1's documented default; later versions document another. */
+    readonly rspack1: readonly ['.js', '.json', '.wasm'];
+    readonly turbopack: readonly ['.tsx', '.ts', '.jsx', '.js', '.mjs', '.json'];
+    readonly esbuild: readonly ['.tsx', '.ts', '.jsx', '.js', '.css', '.json'];
+};
+/** Vite's `resolve.extensions`, which `configResolved` holds with its
+ *  defaults applied. A TypeScript importer's `./x.js` names `x.ts` too.
+ *  Only the default order is captured, as a real build resolves it. A
+ *  configured list does not describe Vite's effective resolution: Vite 8's
+ *  resolver falls back past it (`['.js']` still loads `./only` as
+ *  `only.tsx`), so it is unreadable. */
+export declare function viteExtensionPolicy(extensions: readonly string[], version?: string): HostExtensionPolicy;
+/** One `resolve` block of webpack's or Rspack's configuration. */
+interface WebpackResolveBlock {
+    readonly extensions?: readonly string[];
+    readonly extensionAlias?: Readonly<Record<string, string | string[]>>;
+}
+/** webpack's or Rspack's resolved order for an ESM import: the root
+ *  `resolve` with `byDependency.esm` merged over it as the bundler merges
+ *  it, a `...` standing for what it extends. `extensionAlias` is kept whole
+ *  and in order. Where neither sets extensions, the bundler's documented
+ *  default stands in; for Rspack only version 1's is known. */
+export declare function webpackExtensionPolicy(host: string, resolve: WebpackResolveBlock & {
+    readonly byDependency?: Readonly<Record<string, WebpackResolveBlock | undefined>>;
+}, version?: string): HostExtensionPolicy;
+/** Turbopack's `turbopack.resolveExtensions`, or its documented default
+ *  when the Next config sets none. It substitutes no source: under Next
+ *  16.3, `./x.js` beside only `x.ts` names no module. */
+export declare function turbopackExtensionPolicy(resolveExtensions: readonly string[] | undefined, nextVersion?: string): HostExtensionPolicy;
+/** esbuild's `resolveExtensions`, or its default when the build sets none. */
+export declare function esbuildExtensionPolicy(resolveExtensions: readonly string[] | undefined, version?: string): HostExtensionPolicy;
+/** Rollup leaves the extension order to its resolver plugins, which keep
+ *  their options private: a TypeScript build sets `@rollup/plugin-node-resolve`'s
+ *  `extensions`, which no documented default matches. The built-in policy
+ *  answers, with the reason. */
+export declare function rollupExtensionPolicy(usesNodeResolve: boolean): HostExtensionPolicy;
+/** The policy as the system loader reads it (`ExtensionPolicy`). */
+export declare function extensionPolicyJson(policy: HostExtensionPolicy): string;
+export {};
+//# sourceMappingURL=host-extensions.d.ts.map

package/dist/pipeline/host-extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-extensions.d.ts","sourceRoot":"","sources":["../../pipeline/host-extensions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IACzD;;;;;;kCAM8B;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,uEAAuE;AACvE,eAAO,MAAM,yBAAyB,EAAE,mBAKvC,CAAC;AAqBF,4EAA4E;AAC5E,eAAO,MAAM,uBAAuB;aAClC,IAAI,YAAG,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO;aAC5D,OAAO,YAAG,KAAK,EAAE,OAAO,EAAE,OAAO;IACjC,sEAAsE;aACtE,OAAO,YAAG,KAAK,EAAE,OAAO,EAAE,OAAO;aACjC,SAAS,YAAG,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO;aACzD,OAAO,YAAG,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO;CAC/C,CAAC;AAUX;;;;;wCAKwC;AACxC,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,OAAO,CAAC,EAAE,MAAM,GACf,mBAAmB,CAiBrB;AAED,kEAAkE;AAClE,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;CACvE;AAED;;;;+DAI+D;AAC/D,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,mBAAmB,GAAG;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAC9B,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,SAAS,CAAC,CAChD,CAAC;CACH,EACD,OAAO,CAAC,EAAE,MAAM,GACf,mBAAmB,CAyErB;AAED;;yDAEyD;AACzD,wBAAgB,wBAAwB,CACtC,iBAAiB,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAChD,WAAW,CAAC,EAAE,MAAM,GACnB,mBAAmB,CAWrB;AAED,8EAA8E;AAC9E,wBAAgB,sBAAsB,CACpC,iBAAiB,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAChD,OAAO,CAAC,EAAE,MAAM,GACf,mBAAmB,CAWrB;AAED;;;gCAGgC;AAChC,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,OAAO,GACvB,mBAAmB,CAOrB;AAED,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAMvE"}