@forgeax/engine-assets-runtime 0.1.4 → 0.1.7

package/dist/internal.d.ts

@@ -1,3 +1,3 @@
 export { CatalogSession } from './internal/catalog-session.js';
-export { type AssetRegistryResolver, getAssetRegistryResolver, } from './internal/load-asset.js';
+export { type AssetRegistry, type AssetRegistryResolver, getAssetRegistryResolver, } from './internal/load-asset.js';
 //# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EACL,KAAK,qBAAqB,EAC1B,wBAAwB,GACzB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,wBAAwB,GACzB,MAAM,0BAA0B,CAAC"}

package/dist/loader-registry.d.ts

@@ -0,0 +1,63 @@
+import type { ArtifactDescriptor, LoadContext, Loader } from '@forgeax/engine-types';
+export interface PackArtifactInput {
+    readonly descriptor: ArtifactDescriptor;
+    readonly bytes: Uint8Array;
+}
+export interface PackLoaderInput {
+    readonly guid: string;
+    readonly kind: string;
+    readonly payload: Record<string, unknown>;
+    readonly refs: readonly string[];
+    readonly artifacts: Readonly<Record<string, PackArtifactInput>>;
+}
+export interface PackLoader {
+    readonly kind: string;
+    load(input: PackLoaderInput, ctx: LoadContext): unknown;
+}
+export type PackLoadResult = {
+    readonly ok: true;
+    readonly value: unknown;
+} | {
+    readonly ok: false;
+    readonly error: unknown;
+};
+/**
+ * Injectable `asset.kind` -> {@link Loader} table held by `AssetRegistry`.
+ *
+ * @example Wire + dispatch (host side)
+ * ```ts
+ * import { LoaderRegistry, wireDefaultLoaders } from '@forgeax/engine-assets-runtime';
+ * const loaders = new LoaderRegistry();
+ * wireDefaultLoaders(loaders);
+ * const meshLoader = loaders.get('mesh'); // Loader | undefined
+ * ```
+ */
+export declare class LoaderRegistry {
+    private readonly loaders;
+    private readonly packLoaders;
+    /**
+     * Register a loader for its `loader.kind`. Fail-fast on a malformed loader
+     * (charter P3); rejects a repeated kind so the canonical owner cannot be replaced.
+     *
+     * @param loader the `{ kind, load }` object to register.
+     * @throws TypeError when `loader.kind` is empty or `loader.load` is not a
+     *   function — a wire-time misconfiguration the host must fix.
+     */
+    register(loader: Loader<unknown>): () => void;
+    registerPackLoader(loader: PackLoader): () => void;
+    loadPack(input: PackLoaderInput, ctx: LoadContext): Promise<PackLoadResult>;
+    /**
+     * Look up the loader registered for `kind`. Returns `undefined` when no
+     * loader is wired — the `AssetRegistry` consumer maps that to a structured
+     * `AssetError(code='loader-not-registered')` with the registered kinds in
+     * `.detail` (charter P3).
+     */
+    get(kind: string): Loader<unknown> | undefined;
+    /**
+     * The kinds currently wired, in insertion order. Fed into the
+     * `loader-not-registered` error `.detail.registeredKinds` so AI users see
+     * exactly what is injectable.
+     */
+    registeredKinds(): readonly string[];
+}
+//# sourceMappingURL=loader-registry.d.ts.map

package/dist/loader-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader-registry.d.ts","sourceRoot":"","sources":["../src/loader-registry.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAErF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC;CACzD;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC9C;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,qBAAa,cAAc;IAIzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAC9D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiC;IAE7D;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,IAAI;IAoB7C,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,IAAI;IAoB5C,QAAQ,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAqBjF;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,SAAS;IAI9C;;;;OAIG;IACH,eAAe,IAAI,SAAS,MAAM,EAAE;CAGrC"}

package/dist/loaders/inline-pack.d.ts

@@ -0,0 +1,72 @@
+import type { Loader } from '@forgeax/engine-types';
+/** mesh loader — Float32Array / Uint16Array | Uint32Array normalisation -> MeshAsset.
+ *
+ * feat-20260611: skinIndex (Uint16Array) and skinWeight (Float32Array) accept
+ * both their native typed-array shape (in-memory: dawn smoke / direct
+ * `register` test) AND `number[]` (post-`JSON.stringify` shape produced by the
+ * dev-server / build-mode pack-body round-trip — `JSON.stringify(pack) -> fetch
+ * -> JSON.parse` flattens every typed array to a plain Array). Same dual
+ * contract `skeletonLoader` / `animationClipLoader` already honour (PR #350);
+ * without the array arm, every Fox.glb / Khronos skinned glTF surfaces as
+ * `asset-parse-failed` on the browser path while dawn smoke stays green.
+ */
+export declare const meshLoader: Loader;
+/** scene loader — delegates to parseScenePayload; routes structured ref error via ctx. */
+export declare const sceneLoader: Loader;
+/** material loader — passes + values + serialized parent GUID -> parentGuid. */
+export declare const materialLoader: Loader;
+/** sampler loader — preserve the serialised SamplerAsset descriptor. */
+export declare const samplerLoader: Loader;
+/** skeleton loader — inverseBindMatrices stride validation.
+ *
+ * bug-20260611: accept both `Float32Array` (in-memory: dawn smoke / direct
+ * `register` test) AND `number[]` (post-`JSON.stringify` shape: `normaliseForPack`
+ * in @forgeax/engine-import flattens every typed array to a plain Array so
+ * `JSON.stringify(pack)` survives the dev-server / build-mode round-trip --
+ * the same dual contract `meshLoader` already honours). Without the array arm
+ * the .pack.json -> fetch -> JSON.parse path lands a plain object whose
+ * `instanceof Float32Array` check fails, surfacing as `asset-parse-failed`
+ * for any glTF carrying a Skin (e.g. Khronos Fox.glb).
+ */
+export declare const skeletonLoader: Loader;
+/** skin loader — skeletonGuid + jointPaths validation. */
+export declare const skinLoader: Loader;
+/** animation-clip loader — channels / sampler validation.
+ *
+ * bug-20260611: sampler.input / sampler.output accept both `Float32Array`
+ * (in-memory) and `number[]` (post-`JSON.stringify` shape produced by
+ * `normaliseForPack`). Same dual contract as `skeletonLoader` /
+ * `meshLoader`; without it the dev `.pack.json` round-trip surfaces every
+ * skinned-with-animation glTF as `asset-parse-failed`.
+ */
+export declare const animationClipLoader: Loader;
+/** animation-graph loader — pack payload -> AnimationGraph POD.
+ *
+ * feat-20260713-animation-state-machine-plugin M4 / w30 (plan D-4 landing (3)):
+ * the inverse of `serializeAnimationGraph` (runtime). Each Clip leaf's `clip`
+ * field arrives as a `refs[]` index (small int); the loader resolves it back to
+ * the GUID string verbatim, leaving GUID -> handle re-resolution to the ECS/use
+ * time (the same "GUID at load, handle at use" contract materialLoader honours
+ * for parentGuid / values texture fields, asset-registry D-19). Blend/Add
+ * node references + `root` are intra-graph node indices, validated against the
+ * node count. A malformed payload (out-of-range refs / node index, bad node
+ * shape, non-finite weight) returns `undefined` so the load-by-guid path
+ * surfaces the existing `asset-parse-failed` error code (AC-14).
+ *
+ * OOS-7: reconstructs only an engine-authored graph's topology; no DCC-import
+ * metadata is consumed.
+ */
+export declare const animationGraphLoader: Loader;
+/** audio loader -- restore the durable descriptor; host decode stays elsewhere. */
+export declare const audioLoader: Loader;
+/** particle loader -- restore the complete cooked program without a GPU device. */
+export declare const particleEffectLoader: Loader;
+export { renderPipelineLoader, tilesetLoader } from './pack-artifact';
+/**
+ * The eight inline pack-payload loaders, in the historical `if`-chain order
+ * (the animation-graph loader, feat-20260713 M4 / w30, appends after the clip
+ * loader). `wireDefaultLoaders` (w5) registers these plus the texture / font /
+ * equirect loaders (w6) and the audio placeholder (w8).
+ */
+export declare const INLINE_PACK_LOADERS: readonly Loader[];
+//# sourceMappingURL=inline-pack.d.ts.map

package/dist/loaders/inline-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-pack.d.ts","sourceRoot":"","sources":["../../src/loaders/inline-pack.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAWV,MAAM,EAOP,MAAM,uBAAuB,CAAC;AAoB/B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,EAAE,MA8OxB,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,WAAW,EAAE,MAazB,CAAC;AAiFF,gFAAgF;AAChF,eAAO,MAAM,cAAc,EAAE,MAsI5B,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,aAAa,EAAE,MAiE3B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,EAAE,MAoB5B,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,UAAU,EAAE,MAcxB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,MA0DjC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAgDlC,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,WAAW,EAAE,MAqBzB,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,oBAAoB,EAAE,MASlC,CAAC;AAEF,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEtE;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAahD,CAAC"}

package/dist/loaders/mesh-bin.d.ts

@@ -0,0 +1,21 @@
+import { type VertexLayoutProjection } from '@forgeax/engine-geometry';
+import { type Result, type VertexAttributeMap } from '@forgeax/engine-types';
+import { MeshBinAssetError } from '../errors/asset';
+export interface UnpackedMeshBin {
+    readonly version: 4;
+    readonly projection: VertexLayoutProjection;
+    readonly vertices: Float32Array;
+    readonly attributes: VertexAttributeMap;
+    readonly indices?: Uint16Array | Uint32Array;
+    readonly submeshes: ReadonlyArray<Record<string, unknown>>;
+    readonly materialSlots: readonly {
+        readonly slotName: string;
+        readonly sourceKey?: string;
+        readonly defaultMaterialRef?: number;
+    }[];
+    readonly aabb?: Float32Array;
+    readonly morphTargets?: ReadonlyArray<Record<string, Float32Array>>;
+    readonly morphWeights?: Float32Array;
+}
+export declare function unpackMeshBinV4(bytes: Uint8Array, sourceKey: string): Result<UnpackedMeshBin, MeshBinAssetError>;
+//# sourceMappingURL=mesh-bin.d.ts.map

package/dist/loaders/mesh-bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-bin.d.ts","sourceRoot":"","sources":["../../src/loaders/mesh-bin.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,0BAA0B,CAAC;AAMlC,OAAO,EAAW,KAAK,MAAM,EAAE,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,QAAQ,CAAC,aAAa,EAAE,SAAS;QAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;KACtC,EAAE,CAAC;IACJ,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IACpE,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;CACtC;AAmDD,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,eAAe,EAAE,iBAAiB,CAAC,CA8N5C"}

package/dist/loaders/pack-artifact.d.ts

@@ -0,0 +1,20 @@
+import type { Loader } from '@forgeax/engine-types';
+export type CodecContextFailure = {
+    readonly code: 'basis-profile-unsupported';
+    readonly detail: {
+        readonly profile: string;
+    };
+} | {
+    readonly code: 'ktx2-color-space-mismatch';
+    readonly detail: {
+        readonly authoredColorSpace: 'srgb' | 'linear';
+        readonly dfdColorSpace: 'srgb' | 'linear' | 'unknown';
+    };
+};
+export declare const textureLoader: Loader;
+export declare const equirectLoader: Loader;
+export declare const fontLoader: Loader;
+export declare const renderPipelineLoader: Loader;
+export declare const tilesetLoader: Loader;
+export declare const PACK_ARTIFACT_LOADERS: readonly Loader[];
+//# sourceMappingURL=pack-artifact.d.ts.map

package/dist/loaders/pack-artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-artifact.d.ts","sourceRoot":"","sources":["../../src/loaders/pack-artifact.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAMV,MAAM,EAKP,MAAM,uBAAuB,CAAC;AA+L/B,MAAM,MAAM,mBAAmB,GAC3B;IACE,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,QAAQ,CAAC;QAC/C,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;KACvD,CAAC;CACH,CAAC;AAyXN,eAAO,MAAM,aAAa,EAAE,MAI3B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,MAI5B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,MAIxB,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,MAkBlC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,MA0B3B,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAMlD,CAAC"}

package/dist/material/dependency-graph.d.ts

@@ -0,0 +1,9 @@
+export declare class MaterialDependencyGraph {
+    #private;
+    link(materialGuid: string, dependencies: readonly string[]): void;
+    dependentsOf(dependency: string): readonly string[];
+    invalidate(dependencies: readonly string[]): readonly string[];
+    isInvalidated(materialGuid: string): boolean;
+    clear(materialGuid: string): void;
+}
+//# sourceMappingURL=dependency-graph.d.ts.map

package/dist/material/dependency-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-graph.d.ts","sourceRoot":"","sources":["../../src/material/dependency-graph.ts"],"names":[],"mappings":"AAAA,qBAAa,uBAAuB;;IAKlC,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAYjE,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE;IAInD,UAAU,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE;IAiB9D,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAI5C,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;CAGlC"}

package/dist/material/generation-cache.d.ts

@@ -0,0 +1,24 @@
+import { type MaterialErrorFor, type MaterialGenerationVector, type Result } from '@forgeax/engine-types';
+export type { MaterialGenerationVector } from '@forgeax/engine-types';
+export interface MaterialCachedArtifact {
+    readonly bytes: Uint8Array;
+}
+export type MaterialStaleGenerationError = MaterialErrorFor<'material-specialization-stale-generation'>;
+export declare class MaterialGenerationCache {
+    #private;
+    resolve<T>(materialGuid: string, specializationKey: string, load: () => Promise<T>, publicationGeneration?: number): Promise<T>;
+    linkResolved(materialGuid: string, specializationKey: string): void;
+    getResolvedKey(materialGuid: string): string | undefined;
+    storeArtifact(key: string, artifact: MaterialCachedArtifact): void;
+    getArtifact(key: string): MaterialCachedArtifact | undefined;
+    bump(dependency: string): number;
+    generationError(materialGuid: string): MaterialStaleGenerationError | undefined;
+    loadWithGeneration<T>(materialGuid: string, dependencies: readonly string[], load: (generation: MaterialGenerationVector) => Promise<{
+        readonly generation: MaterialGenerationVector;
+        readonly value: T;
+    }>): Promise<Result<T, MaterialStaleGenerationError>>;
+    private trackDependencies;
+    private removeResolved;
+    private vector;
+}
+//# sourceMappingURL=generation-cache.d.ts.map

package/dist/material/generation-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation-cache.d.ts","sourceRoot":"","sources":["../../src/material/generation-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAE7B,KAAK,MAAM,EACZ,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEtE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,MAAM,MAAM,4BAA4B,GACtC,gBAAgB,CAAC,0CAA0C,CAAC,CAAC;AAO/D,qBAAa,uBAAuB;;IAUlC,OAAO,CAAC,CAAC,EACP,YAAY,EAAE,MAAM,EACpB,iBAAiB,EAAE,MAAM,EACzB,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,qBAAqB,SAAI,GACxB,OAAO,CAAC,CAAC,CAAC;IAkBb,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI;IAInE,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIxD,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IAIlE,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS;IAI5D,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAYhC,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,4BAA4B,GAAG,SAAS;IAIzE,kBAAkB,CAAC,CAAC,EACxB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,IAAI,EAAE,CACJ,UAAU,EAAE,wBAAwB,KACjC,OAAO,CAAC;QAAE,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAC,GACjF,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,4BAA4B,CAAC,CAAC;IAsBnD,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,MAAM;CAOf"}

package/dist/material/inspection.d.ts

@@ -0,0 +1,24 @@
+import type { MaterialReady } from './loader.js';
+/**
+ * Read-only facts for one GUID after the MaterialReady gate succeeds.
+ * `status` is retained for the existing runtime API; `readiness` is the
+ * machine-readable first-level field for inspection consumers. This owner
+ * does not invent transport provenance or compare transport URLs.
+ */
+export interface MaterialRuntimeInfo {
+    readonly materialGuid: string;
+    readonly readiness: 'ready';
+    readonly publicationGeneration: number;
+    readonly specializationKey: string;
+    readonly artifactDigest: string;
+    readonly layoutIdentity: string;
+    readonly dependencies: readonly string[];
+    readonly profile: string;
+    readonly sourceClosure: readonly string[];
+    readonly parameterContract: MaterialReady['parameterContract'];
+    readonly refs: MaterialReady['record']['refs'];
+    readonly receipt: MaterialReady['record']['receipt'];
+    readonly status: 'Ready';
+}
+export declare function inspectMaterialRuntime(ready: MaterialReady): MaterialRuntimeInfo;
+//# sourceMappingURL=inspection.d.ts.map

package/dist/material/inspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspection.d.ts","sourceRoot":"","sources":["../../src/material/inspection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC/D,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,GAAG,mBAAmB,CAqBhF"}

package/dist/material/loader.d.ts

@@ -0,0 +1,59 @@
+import { type CookedMaterialRecord } from '@forgeax/engine-pack';
+export interface MaterialLoadRequest {
+    readonly guid: string;
+    readonly specializationKey: string;
+}
+export interface MaterialReady {
+    readonly status: 'Ready';
+    readonly guid: string;
+    readonly materialGuid: string;
+    readonly publicationGeneration: number;
+    readonly specializationKey: string;
+    readonly artifactDigest: string;
+    readonly sourceClosure: readonly string[];
+    readonly parameterContract: NonNullable<CookedMaterialRecord['parameterContract']>;
+    readonly record: CookedMaterialRecord;
+    readonly artifact: CookedMaterialRecord['artifact'];
+}
+export interface MaterialPublication {
+    readonly guid: string;
+    readonly record: unknown;
+    readonly artifactError?: {
+        readonly code: 'asset-artifact-missing' | 'asset-artifact-integrity-mismatch';
+        readonly expected: string;
+        readonly actual?: string;
+    };
+    readonly artifact?: {
+        readonly bytes: Uint8Array;
+        readonly digest?: string;
+    };
+}
+export type MaterialLoadErrorCode = 'material-specialization-not-cooked' | 'asset-artifact-missing' | 'asset-artifact-integrity-mismatch' | 'material-cook-record-invalid' | 'material-reference-not-ready';
+export interface MaterialLoadErrorDetail {
+    readonly guid: string;
+    readonly specializationKey: string;
+    readonly publicationGeneration?: number;
+    readonly field?: string;
+    readonly missing?: readonly string[];
+    readonly expected?: string;
+    readonly actual?: string;
+}
+export interface MaterialLoadError {
+    readonly status: 'Error';
+    readonly error: {
+        readonly code: MaterialLoadErrorCode;
+        readonly expected: string;
+        readonly hint: string;
+        readonly retryable: boolean;
+        readonly recoveryActions: readonly string[];
+        readonly detail: MaterialLoadErrorDetail;
+    };
+}
+export interface MaterialLoaderOptions {
+    readonly loadPublication: (guid: string, specializationKey: string) => Promise<MaterialPublication | undefined>;
+    readonly loadReference?: (guid: string) => Promise<boolean>;
+}
+export declare function createMaterialLoader(options: MaterialLoaderOptions): {
+    load(request: MaterialLoadRequest): Promise<MaterialReady | MaterialLoadError>;
+};
+//# sourceMappingURL=loader.d.ts.map

package/dist/material/loader.d.ts.map

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

package/dist/material/runtime-shader.d.ts

@@ -0,0 +1,14 @@
+import type { ShaderRegistry } from '@forgeax/engine-shader';
+import type { MaterialParameter, ParamSchemaEntry } from '@forgeax/engine-types';
+import type { MaterialReady } from './loader';
+/** Project authored MaterialAsset parameters into the runtime shader schema. */
+export declare function materialParametersToParamSchema(parameters: readonly MaterialParameter[], shaderId: string | undefined): readonly ParamSchemaEntry[];
+/** Project authored pass module ids onto the renderer's canonical ids. */
+export declare function runtimeMaterialShaderId(module: string | undefined, passName?: string): string | undefined;
+/**
+ * Install every authored pass module from one validated MaterialReady tuple.
+ * The publication artifact is the only runtime shader source; no host entry
+ * point is allowed to assemble or register the material separately.
+ */
+export declare function installMaterialReadyShaders(shaderRegistry: ShaderRegistry, readiness: MaterialReady): void;
+//# sourceMappingURL=runtime-shader.d.ts.map

package/dist/material/runtime-shader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-shader.d.ts","sourceRoot":"","sources":["../../src/material/runtime-shader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAY9C,gFAAgF;AAChF,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,SAAS,iBAAiB,EAAE,EACxC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,SAAS,gBAAgB,EAAE,CA0B7B;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,CAsBpB;AAuBD;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,cAAc,EAAE,cAAc,EAC9B,SAAS,EAAE,aAAa,GACvB,IAAI,CA6BN"}

package/dist/mesh-bin.d.ts

@@ -0,0 +1,3 @@
+export { MeshBinAssetError } from './errors/asset.js';
+export { type UnpackedMeshBin, unpackMeshBinV4, } from './loaders/mesh-bin.js';
+//# sourceMappingURL=mesh-bin.d.ts.map

package/dist/mesh-bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-bin.d.ts","sourceRoot":"","sources":["../src/mesh-bin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EACL,KAAK,eAAe,EACpB,eAAe,GAChB,MAAM,uBAAuB,CAAC"}

package/dist/mipmap-generator.d.ts

@@ -0,0 +1,132 @@
+import { type Result, RhiError } from '@forgeax/engine-rhi';
+/**
+ * Subset of `RhiDevice` consumed by the mipmap utility (charter F2: only
+ * the methods the algorithm actually invokes; the dawn integration tests
+ * pass a real `RhiDevice` and the unit cache tests pass a hand-rolled stub).
+ *
+ * Four entry-points (all synchronous Result):
+ *   - createSampler       (default linear / linear / linear)
+ *   - createBindGroupLayout
+ *   - createPipelineLayout
+ *   - createRenderPipeline (per-format pipeline cache miss)
+ *
+ * Shader module is NOT an entry-point here; it is supplied by an injected
+ * `MipmapShaderModuleFactory` (bug-20260518 D-1) so the utility does not
+ * reach into the rhi-webgpu shim package from the runtime layer.
+ *
+ * Plus `createCommandEncoder` + `queue.submit` are added once the upload
+ * call-site (T-M3-05) wires generateMipmaps in; the cache-only public hooks
+ * exercised by T-M3-01 do not need them, so they live behind an extended
+ * MipmapDeviceForBlit alias.
+ */
+export type MipmapDevice = {
+    createSampler(desc?: any): Result<any, any>;
+    createBindGroupLayout(desc: any): Result<any, any>;
+    createPipelineLayout(desc: any): Result<any, any>;
+    createRenderPipeline(desc: any): Result<any, any>;
+};
+/**
+ * Async shader-module factory injected through the call-chain
+ * `createRenderer.ts` -> `AssetRegistry.configureGpuDevice` ->
+ * `generateMipmaps` -> `getOrCreateMipmapPipeline` -> `ensureDeviceCache`
+ * (bug-20260518 D-1 / D-4).
+ *
+ * Signature mirrors the top-level async `createShaderModule(device, desc)`
+ * exposed by the rhi-webgpu shim (and the rhi-wgpu shim) so the
+ * call-site in createRenderer can pass `pack.createShaderModule` directly
+ * without a structural cast. The opaque module value is typed `unknown`
+ * here -- callers do not introspect it; they hand the value back to
+ * `createRenderPipeline` descriptors via the cached `MipmapPipelineCache`.
+ */
+export type MipmapShaderModuleFactory = (device: MipmapDevice, desc: {
+    code: string;
+    label?: string;
+}) => Promise<Result<unknown, RhiError>>;
+/**
+ * Compute mip-level count for a 2D texture (research F-1 SSOT formula).
+ *
+ * Spec-anchor: WebGPU §3.6 texture-creation says `mipLevelCount` defaults
+ * to 1; the runtime utility opts AI users into a full chain via
+ * `floor(log2(max(width, height))) + 1` -- the same formula greggman /
+ * toji / webgpufundamentals all converge on.
+ *
+ * @example
+ *   numMipLevels({ width: 256, height: 256 }) // 9
+ *   numMipLevels({ width: 1, height: 1 })     // 1
+ */
+export declare function numMipLevels(size: {
+    width: number;
+    height: number;
+}): number;
+/**
+ * Number of cached pipelines for the device (introspection hook used by
+ * T-M3-01 (c) cache-hit / (d) per-device-isolation tests; charter P3
+ * explicit failure: a cache size of 0 on a fresh device is a witnessed
+ * pre-condition rather than a swept-under hint).
+ */
+export declare function mipmapCacheSize(device: MipmapDevice): number;
+/**
+ * Get the existing per-format render pipeline or build a fresh one.
+ *
+ * Per-device WeakMap + per-format `Map<GPUTextureFormat, RenderPipeline>`
+ * (greggman 36-44 + 119-122). The shared sampler / shader-module /
+ * bind-group-layout are constructed lazily on the first cache miss for a
+ * given device and reused across all formats on that device.
+ */
+export declare function getOrCreateMipmapPipeline(device: MipmapDevice, format: GPUTextureFormat, asyncCreateShaderModule: MipmapShaderModuleFactory): Promise<Result<any, unknown>>;
+/**
+ * Extended device shape used by `generateMipmaps` (call-site T-M3-05).
+ * Adds command-encoder + bind-group + texture-view + queue surfaces beyond
+ * the cache-only `MipmapDevice` so the pipeline-cache unit tests still
+ * compile against the smaller surface.
+ */
+export type MipmapBlitDevice = MipmapDevice & {
+    createTexture(desc: any): Result<any, any>;
+    createBindGroup(desc: any): Result<any, any>;
+    createTextureView(texture: any, desc: any): Result<any, any>;
+    createCommandEncoder(desc?: any): Result<any, any>;
+    readonly queue: {
+        submit(buffers: ReadonlyArray<any>): Result<void, any>;
+    };
+};
+/**
+ * Per-mip render-pass blit-loop (research F-1 SSOT main template).
+ *
+ * For mip levels 1..levels-1: source view = previous mip {baseMipLevel:i-1,
+ * mipLevelCount:1}; destination view = current mip {baseMipLevel:i,
+ * mipLevelCount:1, usage: RENDER_ATTACHMENT}; oversized-triangle pipeline
+ * draws 3 vertices, fragment shader samples source via linear sampler.
+ *
+ * Spec sRGB correctness (F-3): when format is `*-srgb`, both views inherit
+ * the sRGB encoding so hardware decode -> bilinear in linear -> encode back
+ * happens automatically; no special-casing required.
+ *
+ * `levels` defaults to `numMipLevels({ width, height })`. AI users that
+ * already created the texture with explicit `mipLevelCount` should pass the
+ * same value here.
+ */
+export declare function generateMipmaps(device: MipmapBlitDevice, texture: any, descriptor: {
+    readonly format: GPUTextureFormat;
+    readonly width: number;
+    readonly height: number;
+    readonly levels?: number;
+}, asyncCreateShaderModule: MipmapShaderModuleFactory): Promise<Result<void, unknown>>;
+/**
+ * Synchronous sibling of `generateMipmaps` (feat-20260601-gpu-resource-store
+ * -extraction D-9). Identical per-mip blit loop, but reads the per-format
+ * pipeline + shared sampler / layout from the prewarmed device cache instead
+ * of building them. The pipeline MUST already be present (via a prior
+ * `getOrCreateMipmapPipeline` / `prewarmMipmapPipeline` async call) -- an
+ * un-prewarmed device or format returns a structured `RhiError` rather than
+ * awaiting a build, so the synchronous `draw(world)` frame contract is never
+ * broken. The async build itself does not affect the written bytes (same
+ * shader, same encoder sequence), so prewarm + sync blit reproduces the
+ * pre-extraction async `generateMipmaps` byte-for-byte (D-9 sub-contract 5).
+ */
+export declare function blitMipmapsSync(device: MipmapBlitDevice, texture: any, descriptor: {
+    readonly format: GPUTextureFormat;
+    readonly width: number;
+    readonly height: number;
+    readonly levels?: number;
+}): Result<void, RhiError>;
+//# sourceMappingURL=mipmap-generator.d.ts.map

package/dist/mipmap-generator.d.ts.map

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

package/dist/payload-validate.d.ts

@@ -0,0 +1,60 @@
+import type { Asset, TilesetAsset } from '@forgeax/engine-types';
+import { AssetError } from '@forgeax/engine-types';
+/**
+ * Register-stage fail-fast for `kind: 'mesh'` payloads whose vertices buffer
+ * is not the canonical 12-floats-per-vertex layout.
+ *
+ * Validation spec (plan-strategy D-3):
+ *   (a) asset.kind !== 'mesh' -> return null immediately
+ *   (b) vertices.length === 0 && indices.length === 0 -> return null (empty mesh legal)
+ *   (c) vertices.length % PROCEDURAL_FLOATS_PER_VERTEX !== 0 -> `AssetError` with
+ *       code='mesh-vertex-stride-mismatch', detail = { vertexCount: 0,
+ *       floatsPerVertex: vertices.length / PROCEDURAL_FLOATS_PER_VERTEX } (non-integer)
+ *   (d) otherwise compute vertexCount = vertices.length / PROCEDURAL_FLOATS_PER_VERTEX;
+ *       scan indices for maxIndex;
+ *       if maxIndex + 1 !== vertexCount -> same AssetError shape with
+ *       detail = { vertexCount: maxIndex + 1, floatsPerVertex: vertices.length / (maxIndex + 1) }
+ *
+ * Isomorphic with `validateMaterialPayload` — both are private module-level helpers,
+ * both return `AssetError | null`, and both are called from `register()` at entry.
+ *
+ * Anchors: charter P3 (structured failure); plan-strategy D-2 (gate at register stage);
+ *          plan-strategy D-3 (three-branch validation: empty / non-divisible-12 / maxIndex mismatch);
+ *          plan-strategy D-5 (physical location co-located with validateMaterialPayload).
+ */
+export declare function validateMeshPayload(asset: Asset): AssetError | null;
+/**
+ * Optional atlas extent for `validateTilesetPayload`. When omitted, the
+ * region-rectangle bounds-check is skipped — only the
+ * `tiles[].regionIndex` in `[0, regions.length)` invariant runs.
+ */
+export interface TilesetValidateOptions {
+    readonly atlasWidth?: number;
+    readonly atlasHeight?: number;
+}
+/**
+ * Validate a `TilesetAsset` payload at register time (M0 baseline rebuild
+ * + M1 schema extension). Returns `null` on success or an `AssetError`
+ * carrying the first-error details (charter P3 fail-fast). R-6 ordering:
+ *
+ *   1. `atlases.length >= 1` -- 'tileset-tile-entry-malformed' .field='atlases'.
+ *   2. Region rectangle escapes atlas extent (when extent is supplied) --
+ *      M0 code 'tileset-region-index-out-of-range'.
+ *   3. `regions[i].atlasIndex` in `[0, atlases.length)` -- 'tileset-tile-entry-malformed'
+ *      .field='atlasIndex'.
+ *   4. `tiles[i].regionIndex` in `[0, regions.length)` -- M0 code.
+ *   5. Per-tile-entry boundaries -- 'tileset-tile-entry-malformed'
+ *      .field=widthCells | heightCells | pivotX | pivotY | collider,
+ *      in that order, .scope='tile-entry' .tileEntryIndex=i.
+ */
+export declare function validateTilesetPayload(asset: TilesetAsset, opts?: TilesetValidateOptions): AssetError | null;
+/**
+ * Compute the implicit atlas extent of a `TilesetAsset` from its grid metadata
+ * (`columns * tileWidth` x `rows * tileHeight`). Used by the register-time
+ * region-bounds check when the caller does not supply explicit extents.
+ */
+export declare function inferAtlasExtent(asset: TilesetAsset): {
+    atlasWidth: number;
+    atlasHeight: number;
+};
+//# sourceMappingURL=payload-validate.d.ts.map

package/dist/payload-validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload-validate.d.ts","sourceRoot":"","sources":["../src/payload-validate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,KAAK,EAEL,YAAY,EAEb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAqB,UAAU,EAAoB,MAAM,uBAAuB,CAAC;AAExF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,GAAG,IAAI,CAqMnE;AAoBD;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AA6ID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,YAAY,EACnB,IAAI,GAAE,sBAA2B,GAChC,UAAU,GAAG,IAAI,CA6InB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAKjG"}

package/dist/plugin.d.ts

@@ -0,0 +1,16 @@
+import type { Plugin } from '@forgeax/engine-plugin';
+import type { Loader } from '@forgeax/engine-types';
+import type { AssetRegistry } from './asset-registry';
+import type { PackLoader } from './loader-registry';
+declare module '@forgeax/engine-plugin' {
+    interface EngineContextServices {
+        assets?: AssetRegistry;
+    }
+}
+/** Provide one renderer-owned asset registry to the current Cordis realm. */
+export declare function assetsPlugin(assets: AssetRegistry): Plugin;
+/** Reversibly register one runtime asset loader. */
+export declare function assetLoaderPlugin(loader: Loader<unknown>): Plugin;
+/** Reversibly register one pack loader. */
+export declare function packLoaderPlugin(loader: PackLoader): Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,qBAAqB;QAC7B,MAAM,CAAC,EAAE,aAAa,CAAC;KACxB;CACF;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAQ1D;AAED,oDAAoD;AACpD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAUjE;AAED,2CAA2C;AAC3C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAU3D"}

package/dist/registry/artifact-io.d.ts

@@ -0,0 +1,16 @@
+import type { ArtifactDescriptor, AssetArtifactError } from '@forgeax/engine-types';
+import { type Result } from '@forgeax/engine-types';
+export interface ArtifactReadRequest {
+    readonly packageUrl: string;
+    readonly guid: string;
+    readonly artifactKey: string;
+    readonly descriptor: ArtifactDescriptor;
+}
+export type ArtifactFetcher = (url: string) => Promise<Response>;
+export declare function readArtifact(request: ArtifactReadRequest, fetcher?: ArtifactFetcher): Promise<Result<Uint8Array, AssetArtifactError>>;
+export declare class ArtifactReadCache {
+    private readonly cache;
+    read(key: string, reader: () => Promise<Result<Uint8Array, AssetArtifactError>>): Promise<Result<Uint8Array, AssetArtifactError>>;
+    clear(key?: string): void;
+}
+//# sourceMappingURL=artifact-io.d.ts.map

package/dist/registry/artifact-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-io.d.ts","sourceRoot":"","sources":["../../src/registry/artifact-io.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;CACzC;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAgJjE,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE,eAAgD,GACxD,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC,CA4EjD;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsE;IAE5F,IAAI,CACF,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC,GAC5D,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;IAWlD,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;CAI1B"}