@forgeax/engine-assets-runtime 0.1.3 → 0.1.6

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"}

package/dist/registry/asset-evidence.d.ts

@@ -0,0 +1,13 @@
+import { type AssetEvidence, type AssetEvidenceError, type AssetEvidenceInputs, type Result } from '@forgeax/engine-types';
+/** Host-injected runtime bridge; the adapter never imports CLI, Vite, or Node policy. */
+export interface RuntimeEvidenceSource {
+    readonly evidence: (guid: string) => Promise<AssetEvidenceInputs | Result<AssetEvidenceInputs, AssetEvidenceError>>;
+}
+/** Runtime SDK view over the shared AssetEvidence projector. */
+export interface RuntimeAssetEvidenceAdapter {
+    readonly inspect: (guid: string) => Promise<Result<AssetEvidence, AssetEvidenceError>>;
+    readonly verifyByGuid: (guid: string) => Promise<Result<AssetEvidence, AssetEvidenceError>>;
+}
+/** Create an adapter; omitted source intentionally returns capability-missing errors. */
+export declare function createRuntimeAssetEvidenceAdapter(source?: RuntimeEvidenceSource): RuntimeAssetEvidenceAdapter;
+//# sourceMappingURL=asset-evidence.d.ts.map

package/dist/registry/asset-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-evidence.d.ts","sourceRoot":"","sources":["../../src/registry/asset-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAGxB,KAAK,MAAM,EACZ,MAAM,uBAAuB,CAAC;AAE/B,yFAAyF;AACzF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,CACjB,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,mBAAmB,GAAG,MAAM,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,CAAC,CAAC;CACrF;AAED,gEAAgE;AAChE,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC,CAAC;IACvF,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC,CAAC;CAC7F;AAuBD,yFAAyF;AACzF,wBAAgB,iCAAiC,CAC/C,MAAM,CAAC,EAAE,qBAAqB,GAC7B,2BAA2B,CAI7B"}

package/dist/registry/catalog-state.d.ts

@@ -0,0 +1,47 @@
+import { type Result } from '@forgeax/engine-rhi';
+import type { AssetError, CatalogDelta, CatalogDiagnostic, CatalogEntry } from '@forgeax/engine-types';
+import type { CatalogSource } from '../catalog-source';
+export interface CatalogReplicaSnapshot {
+    readonly version: number;
+    readonly entries: readonly CatalogEntry[];
+    readonly stale: boolean;
+    readonly diagnostics: readonly CatalogDiagnostic[];
+}
+type SnapshotResult = Result<CatalogReplicaSnapshot, AssetError>;
+type CatalogDeltaListener = (delta: CatalogDelta) => void;
+/**
+ * One authoritative catalog read model owned by AssetRegistry.
+ *
+ * The source subscription is installed before the first enumeration. Deltas
+ * observed during that baseline read are buffered and folded afterwards, so
+ * an early publication cannot disappear between the two operations.
+ */
+export declare class CatalogReplica {
+    private readonly source;
+    private readonly listeners;
+    private readonly entries;
+    private pendingBeforeBaseline;
+    private pendingDuringReconcile;
+    private unsubscribe;
+    private startPromise;
+    private baselineReady;
+    private version;
+    private stale;
+    private diagnostics;
+    private currentSnapshot;
+    private readonly expectedScope;
+    constructor(source: CatalogSource);
+    subscribe(listener: CatalogDeltaListener): () => void;
+    snapshot(): CatalogReplicaSnapshot;
+    dispose(): void;
+    start(): Promise<SnapshotResult>;
+    reconcile(): Promise<SnapshotResult>;
+    private loadBaseline;
+    private receive;
+    private fold;
+    private safeDelta;
+    private publish;
+    private makeSnapshot;
+}
+export {};
+//# sourceMappingURL=catalog-state.d.ts.map

package/dist/registry/catalog-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-state.d.ts","sourceRoot":"","sources":["../../src/registry/catalog-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,YAAY,EAIb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACpD;AAED,KAAK,cAAc,GAAG,MAAM,CAAC,sBAAsB,EAAE,UAAU,CAAC,CAAC;AACjE,KAAK,oBAAoB,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;AAmM1D;;;;;;GAMG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAC7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,qBAAqB,CAAsB;IACnD,OAAO,CAAC,sBAAsB,CAA6B;IAC3D,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,YAAY,CAAsC;IAC1D,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkE;gBAEpF,MAAM,EAAE,aAAa;IAWjC,SAAS,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAKrD,QAAQ,IAAI,sBAAsB;IAIlC,OAAO,IAAI,IAAI;IAST,KAAK,IAAI,OAAO,CAAC,cAAc,CAAC;IAahC,SAAS,IAAI,OAAO,CAAC,cAAc,CAAC;YAQ5B,YAAY;IAuB1B,OAAO,CAAC,OAAO;IAef,OAAO,CAAC,IAAI;IAiCZ,OAAO,CAAC,SAAS;IA4BjB,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,YAAY;CAYrB"}

package/dist/registry/catalog.d.ts

@@ -0,0 +1,48 @@
+import { type Result } from '@forgeax/engine-rhi';
+import { type Asset, type AssetEnvelope, AssetError, type AssetPublicationEnvelope, type AssetRelation, type CatalogDiagnostic, type CatalogLifecycle, type CatalogProjection, type CatalogSubject, type CookExecution, type ProviderProvenance, type ResourceRevision, type RuntimeAssetBinding, type SourceOverrideDescriptor, type SourceOverrideMap } from '@forgeax/engine-types';
+import type { AssetRegistry } from '../asset-registry';
+/** Runtime catalog row parsed from the shared pack-index POD shape. */
+export interface CatalogRecord {
+    readonly packageUrl: string;
+    readonly kind: string;
+    readonly authoring?: import('@forgeax/engine-types').AssetAuthoringCapability;
+    readonly name?: string;
+    readonly refs?: readonly string[];
+    readonly sourcePath?: string;
+    readonly cookReceiptUrl?: string;
+    readonly packageId?: string;
+    readonly provenance?: ProviderProvenance;
+    readonly revision?: ResourceRevision;
+    readonly sourceKey?: string;
+    readonly sourceIndex?: number;
+    readonly sourceOverrides?: SourceOverrideMap;
+    readonly sourceOverrideDescriptors?: readonly SourceOverrideDescriptor[];
+    readonly relations?: readonly AssetRelation[];
+    readonly diagnostics?: readonly CatalogDiagnostic[];
+    /** Producer-owned projection axes; never infer these from locators. */
+    readonly subject?: CatalogSubject;
+    readonly execution?: CookExecution;
+    readonly lifecycle?: CatalogLifecycle;
+    readonly projection?: CatalogProjection;
+    /** Complete producer publication tuple used by Scene publication fences. */
+    readonly publication?: AssetPublicationEnvelope;
+}
+/** Build the canonical row for an inline asset without inventing producer facts. */
+export declare function createInlineCatalogRecord(envelope: AssetEnvelope<Asset>, name: string): CatalogRecord;
+type CatalogFetch = (input: string, init?: {
+    readonly cache?: 'no-store';
+}) => PromiseLike<{
+    readonly ok: boolean;
+    json(): Promise<unknown>;
+}>;
+/** Resolve a catalog entry URL against the configured pack-index URL. */
+export declare function resolveCatalogAssetUrl(registry: AssetRegistry, packageUrl: string): string;
+/** Parse the shared pack-index/catalog wire shape without loading payloads. */
+export declare function parseCatalog(raw: unknown, resolveUrl?: (packageUrl: string) => string, expectedRevision?: ResourceRevision, expectedScope?: Pick<RuntimeAssetBinding, 'scopeId' | 'generation'>): Result<Map<string, CatalogRecord>, AssetError>;
+/** Fetch and parse a catalog using the shared JSON/error boundary. */
+export declare function fetchCatalog(url: string, fetch: CatalogFetch, resolveUrl?: (packageUrl: string) => string, expectedRevision?: ResourceRevision, expectedScope?: Pick<RuntimeAssetBinding, 'scopeId' | 'generation'>, requestInit?: {
+    readonly cache?: 'no-store';
+}): Promise<Result<Map<string, CatalogRecord>, AssetError>>;
+export declare function fetchPackIndex(registry: AssetRegistry): Promise<Result<Map<string, CatalogRecord>, AssetError>>;
+export {};
+//# sourceMappingURL=catalog.d.ts.map

package/dist/registry/catalog.d.ts.map

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