@forgeax/engine-shader 0.1.2

package/dist/ShaderRegistry.d.ts

@@ -0,0 +1,208 @@
+import type { Result, RhiError, ShaderModule } from '@forgeax/engine-rhi';
+import type { ImmutableParamSchemaProjection, ManifestEntry, ParamSchemaEntry, ParamSchemaProjectionOwnerStats } from '@forgeax/engine-types';
+import { type ShaderError, type Result as ShaderResult } from './errors.js';
+import type { MaterialShaderManifestEntry } from './types.js';
+/**
+ * Device dependency-injection interface — ShaderRegistry does not directly
+ * depend on `@forgeax/engine-rhi-webgpu` (physical isolation); the caller (engine or
+ * tests) supplies a device-like object that implements
+ * `createShaderModule(desc) → Result<ShaderModule, RhiError>`.
+ *
+ * Difference from the top-level async `createShaderModule(device, desc)` in
+ * `@forgeax/engine-rhi-webgpu`:
+ * - This interface is synchronous — so `registry.get()` can return a cached
+ *   module synchronously.
+ * - The caller is responsible for wrapping the async real path into a sync one
+ *   (e.g. the engine pre-compiles and caches modules during `loadManifest`).
+ *
+ * Mock test shape: a direct sync implementation (see `createMockDevice` in
+ * src/__tests__/registry.test.ts).
+ */
+export interface ShaderRegistryDevice {
+    createShaderModule(desc: {
+        readonly code: string;
+        readonly label?: string | undefined;
+    }): Result<ShaderModule, RhiError>;
+}
+/**
+ * The `forgeax::` prefix reserves engine-shipped material shader identifiers
+ * (plan-strategy D-DefaultStandardPbr-Identifier + §8 charter F1 grep gate).
+ * AI users grep `forgeax::` to enumerate every reserved shader identifier in
+ * one shot. Custom user-side shaders pick their own identifier path
+ * (typically `<package>::<id>`) — anything that is not a `<guid>`
+ * (UUIDv5/v7) shape and not `forgeax::*`.
+ */
+export declare const FORGEAX_RESERVED_PATH_PREFIX: "forgeax::";
+/**
+ * Material shader admission input accepted by
+ * `installMaterialArtifact(identifier, entry)`. `findMaterialArtifact`
+ * returns a {@link RegisteredMaterialShaderEntry} with the immutable schema
+ * projection attached.
+ *
+ * - `source`: composed WGSL source (post-naga_oil); the final form fed to
+ *   `device.createShaderModule({ code })` at pipeline-build time.
+ * - `paramSchema`: closed list of `{name, type, default?}` triples that the
+ *   `MaterialAsset.payload.values` is validated against at register-time
+ *   (feat-20260523-shader-template-instance-split M4 3-tier validation). Per
+ *   feat-20260613-material-paramschema-driven-binding M3 / w12-w13, the
+ *   paramSchema is also the SSOT for the pipeline BGL via
+ *   `derive(paramSchema).bglEntries` — there is no longer a separate
+ *   `bindingLayout` field on this entry (D-1 / D-2).
+ *
+ * The shape is symmetric across engine-default + user-custom paths
+ * (charter P4 consistent abstraction): both go through the same
+ * `installMaterialArtifact` API regardless of whether the host wires the
+ * default-standard-pbr triple at boot or the user registers a custom
+ * shader after asset import.
+ */
+export interface MaterialShaderEntry {
+    readonly source: string;
+    readonly paramSchema: readonly ParamSchemaEntry[];
+}
+/** Registry-owned runtime shape published after immutable schema admission. */
+export interface RegisteredMaterialShaderEntry extends MaterialShaderEntry {
+    readonly paramSchemaProjection: ImmutableParamSchemaProjection;
+}
+export interface ShaderRegistryOptions {
+    readonly device: ShaderRegistryDevice;
+    /**
+     * URL the registry fetches `manifest.json` from. `undefined` puts the
+     * registry into the **zero-entry** mode: `loadManifest()` resolves
+     * `Result.ok(undefined)` without issuing a fetch and `entries()` returns
+     * an empty iterator. This is the bug-20260519 clear-pass-only path
+     * where AI users build a `Camera`-only world (no PBR / unlit pipeline
+     * is ever needed). `createRenderer.ts` Step 2 narrows on
+     * `manifestEntries.length > 0` to skip the dual `createShaderModule`
+     * compile in the same path (charter P3 + plan-strategy D-1 + D-2).
+     */
+    readonly manifestUrl: string | undefined;
+}
+/**
+ * Runtime shader registry — content-addressable manifest lookup →
+ * `device.createShaderModule`.
+ *
+ * Usage:
+ * ```
+ * const registry = new ShaderRegistry({ device, manifestUrl: '/shaders/manifest.json' });
+ * const loaded = await registry.loadManifest();
+ * if (!loaded.ok) handleError(loaded.error); // ShaderError.manifest-malformed
+ *
+ * const result = registry.get('abc12345');
+ * if (!result.ok) handleError(result.error); // RhiError | ShaderError.shader-not-found
+ * else useModule(result.value);
+ * ```
+ *
+ * `static get` / module-level singletons are **forbidden** (plan-strategy
+ * §S-10).
+ */
+export declare class ShaderRegistry {
+    #private;
+    constructor(opts: ShaderRegistryOptions);
+    /**
+     * Loads manifest.json and populates the hash → ManifestEntry index.
+     *
+     * Failure paths (charter proposition 4: explicit failure):
+     * - fetch / data: URL parse failed → `Result.err(ShaderError.manifest-malformed)`
+     * - JSON.parse failed → ditto
+     * - schema missing the `entries` field / an entries element missing
+     *   hash/wgsl/bindings → ditto
+     * - a material shader row is incomplete → ditto
+     *
+     * Validation is atomic: the registry does not publish any entry or
+     * material shader row until the complete document has been validated.
+     *
+     * Idempotent: subsequent calls reuse the first result (never re-fetch;
+     * charter proposition 6: idempotency).
+     */
+    loadManifest(): Promise<ShaderResult<void, ShaderError>>;
+    /**
+     * Iterate every `ManifestEntry` populated by the most recent successful
+     * `loadManifest()` call. Order matches the manifest JSON `entries` array
+     * (insertion order; charter P2 structured-over-prose: AI users walk this
+     * to discover engine-shipped entries by content marker without
+     * re-fetching the manifest).
+     *
+     * Returns an empty iterator when no manifest has been loaded yet
+     * (charter P3 explicit failure: the empty case is not an error — the
+     * absent SSOT is the absent contract).
+     */
+    entries(): IterableIterator<ManifestEntry>;
+    /**
+     * Looks up a hash and forwards to `device.createShaderModule` (creates lazily
+     * on first hit, then caches).
+     *
+     * Error paths:
+     * - hash miss → `Result.err(ShaderError.shader-not-found)`
+     * - device.createShaderModule failed → `Result.err(RhiError)` passes through
+     *   (it is **not** wrapped as a ShaderError).
+     *
+     * Sync shape: on cache miss, the underlying `device.createShaderModule` is
+     * called synchronously; the caller is responsible for handling the async
+     * real path at the device-wrapper layer (e.g. the engine pre-compiles
+     * during `loadManifest`).
+     */
+    get(hash: string): Result<ShaderModule, RhiError | ShaderError>;
+    /**
+     * Register a material shader entry under a stable identifier.
+     *
+     * **Throws** on:
+     *   - duplicate registration of the same identifier (programmer error per
+     *     AGENTS.md "explicit registration" + Inspector "fail-fast no overwrite"
+     *     pattern; charter P3 explicit failure on misuse).
+     *
+     * Successful path returns void — the registry mutates in-place. Use
+     * {@link findMaterialArtifact} to read back.
+     *
+     * Identifier conventions (charter F1 / plan-strategy §8 §2):
+     *   - `forgeax::<kebab-case>` — engine-shipped reserved prefix; the host
+     *     registers `forgeax::default-standard-pbr` at boot.
+     *   - `<package>::<id>` or `<guid>` — user-side custom shaders.
+     *
+     * @example
+     * ```ts
+     * const registry = new ShaderRegistry({ device, manifestUrl });
+     * registry.installMaterialArtifact('forgeax::default-standard-pbr', {
+     *   source: composedWgsl,
+     *   paramSchema: defaultStandardPbrSchema,
+     * });
+     * ```
+     */
+    installMaterialArtifact(identifier: string, entry: MaterialShaderEntry): void;
+    /**
+     * Lookup a previously-registered material shader entry by identifier.
+     *
+     * Returns `Result.ok(entry)` on hit, `Result.err(material-shader-not-found)`
+     * on miss. The `Result` shape mirrors `get(hash)` for consistent
+     * abstraction across the runtime registry surface (charter P4).
+     *
+     * @example
+     * ```ts
+     * const r = registry.findMaterialArtifact('forgeax::default-standard-pbr');
+     * if (!r.ok) return handleError(r.error);
+     * const { source, paramSchema } = r.value;
+     * ```
+     */
+    findMaterialArtifact(identifier: string): ShaderResult<RegisteredMaterialShaderEntry, ShaderError>;
+    /**
+     * Iterate every registered material shader identifier in registration
+     * order (charter F1 grep gate: `for (const id of registry.materialShaderIdentifiers())`
+     * lists every `forgeax::*` + user shader without a private-field reach-in).
+     */
+    materialShaderIdentifiers(): IterableIterator<string>;
+    /** Runtime diagnostic counters for the immutable ParamSchema owner. */
+    paramSchemaProjectionStats(): ParamSchemaProjectionOwnerStats;
+    /**
+     * Iterate every MaterialShaderManifestEntry parsed from manifest.json's
+     * `materialShaders[]` field during `loadManifest()`.
+     *
+     * feat-20260526-pbr-uniform-fallback-no-storage-buffer M3 / w12:
+     * createRenderer variant resolution consumes this list to select the
+     * correct variant (by `caps.storageBuffer`) and register the resolved
+     * WGSL via `installMaterialArtifact`.
+     *
+     * Returns an empty iterator when no manifest has been loaded yet or
+     * the manifest lacks `materialShaders` (backward-compatible).
+     */
+    materialShaderManifestEntries(): IterableIterator<MaterialShaderManifestEntry>;
+}
+//# sourceMappingURL=ShaderRegistry.d.ts.map

package/dist/ShaderRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShaderRegistry.d.ts","sourceRoot":"","sources":["../src/ShaderRegistry.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,KAAK,EACV,8BAA8B,EAC9B,aAAa,EACb,gBAAgB,EAChB,+BAA+B,EAChC,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,MAAM,IAAI,YAAY,EAE5B,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAI9D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,oBAAoB;IACnC,kBAAkB,CAAC,IAAI,EAAE;QACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACrC,GAAG,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;CACpC;AAID;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,EAAG,WAAoB,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACnD;AAED,+EAA+E;AAC/E,MAAM,WAAW,6BAA8B,SAAQ,mBAAmB;IACxE,QAAQ,CAAC,qBAAqB,EAAE,8BAA8B,CAAC;CAChE;AAID,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC;;;;;;;;;OASG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAID;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,cAAc;;gBAcb,IAAI,EAAE,qBAAqB;IAKvC;;;;;;;;;;;;;;;OAeG;IACG,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IA4G9D;;;;;;;;;;OAUG;IACH,OAAO,IAAI,gBAAgB,CAAC,aAAa,CAAC;IAI1C;;;;;;;;;;;;;OAaG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,YAAY,EAAE,QAAQ,GAAG,WAAW,CAAC;IA2C/D;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAsC7E;;;;;;;;;;;;;OAaG;IACH,oBAAoB,CAClB,UAAU,EAAE,MAAM,GACjB,YAAY,CAAC,6BAA6B,EAAE,WAAW,CAAC;IAc3D;;;;OAIG;IACH,yBAAyB,IAAI,gBAAgB,CAAC,MAAM,CAAC;IAIrD,uEAAuE;IACvE,0BAA0B,IAAI,+BAA+B;IAI7D;;;;;;;;;;;OAWG;IACH,6BAA6B,IAAI,gBAAgB,CAAC,2BAA2B,CAAC;CAG/E"}

package/dist/__tests__/atmosphere-background.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=atmosphere-background.test.d.ts.map

package/dist/__tests__/atmosphere-background.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atmosphere-background.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/atmosphere-background.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/atmosphere-cubemap-orientation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=atmosphere-cubemap-orientation.test.d.ts.map

package/dist/__tests__/atmosphere-cubemap-orientation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atmosphere-cubemap-orientation.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/atmosphere-cubemap-orientation.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/atmosphere-preetham-numeric.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=atmosphere-preetham-numeric.test.d.ts.map

package/dist/__tests__/atmosphere-preetham-numeric.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atmosphere-preetham-numeric.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/atmosphere-preetham-numeric.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/atmosphere-preetham-red.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=atmosphere-preetham-red.test.d.ts.map

package/dist/__tests__/atmosphere-preetham-red.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atmosphere-preetham-red.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/atmosphere-preetham-red.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/atmosphere-preetham.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=atmosphere-preetham.test.d.ts.map

package/dist/__tests__/atmosphere-preetham.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atmosphere-preetham.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/atmosphere-preetham.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/atmosphere-three-r184-reference.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=atmosphere-three-r184-reference.test.d.ts.map

package/dist/__tests__/atmosphere-three-r184-reference.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atmosphere-three-r184-reference.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/atmosphere-three-r184-reference.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/bloom-fxaa-tonemap.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bloom-fxaa-tonemap.unit.test.d.ts.map

package/dist/__tests__/bloom-fxaa-tonemap.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bloom-fxaa-tonemap.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/bloom-fxaa-tonemap.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/builtin-texture-sampling-contract.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=builtin-texture-sampling-contract.test.d.ts.map

package/dist/__tests__/builtin-texture-sampling-contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-texture-sampling-contract.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/builtin-texture-sampling-contract.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/default-standard-pbr-alpha.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=default-standard-pbr-alpha.unit.test.d.ts.map

package/dist/__tests__/default-standard-pbr-alpha.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-standard-pbr-alpha.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/default-standard-pbr-alpha.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/deferred-lighting-ssao.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=deferred-lighting-ssao.test.d.ts.map

package/dist/__tests__/deferred-lighting-ssao.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-lighting-ssao.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/deferred-lighting-ssao.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/fog-oracle.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fog-oracle.unit.test.d.ts.map

package/dist/__tests__/fog-oracle.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fog-oracle.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/fog-oracle.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/fog-orthographic-ray.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fog-orthographic-ray.unit.test.d.ts.map

package/dist/__tests__/fog-orthographic-ray.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fog-orthographic-ray.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/fog-orthographic-ray.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/fog-producer-matrix.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fog-producer-matrix.integration.test.d.ts.map

package/dist/__tests__/fog-producer-matrix.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fog-producer-matrix.integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/fog-producer-matrix.integration.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/hdrp-ssao-compile.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hdrp-ssao-compile.test.d.ts.map

package/dist/__tests__/hdrp-ssao-compile.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hdrp-ssao-compile.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/hdrp-ssao-compile.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/ibl-irradiance.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ibl-irradiance.unit.test.d.ts.map

package/dist/__tests__/ibl-irradiance.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ibl-irradiance.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/ibl-irradiance.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/ibl-sampling.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ibl-sampling.unit.test.d.ts.map

package/dist/__tests__/ibl-sampling.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ibl-sampling.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/ibl-sampling.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/lighting-punctual.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lighting-punctual.unit.test.d.ts.map

package/dist/__tests__/lighting-punctual.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lighting-punctual.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/lighting-punctual.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/material-artifact-dedup.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=material-artifact-dedup.unit.test.d.ts.map

package/dist/__tests__/material-artifact-dedup.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-artifact-dedup.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/material-artifact-dedup.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/material-builtins.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=material-builtins.unit.test.d.ts.map

package/dist/__tests__/material-builtins.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-builtins.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/material-builtins.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/material-contract.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=material-contract.unit.test.d.ts.map

package/dist/__tests__/material-contract.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-contract.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/material-contract.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/material-derived-builtins.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=material-derived-builtins.integration.test.d.ts.map

package/dist/__tests__/material-derived-builtins.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-derived-builtins.integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/material-derived-builtins.integration.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/public-surface.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=public-surface.unit.test.d.ts.map

package/dist/__tests__/public-surface.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-surface.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/public-surface.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/scene-temporal.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scene-temporal.unit.test.d.ts.map

package/dist/__tests__/scene-temporal.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-temporal.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/scene-temporal.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/shader-registry-transaction.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shader-registry-transaction.unit.test.d.ts.map

package/dist/__tests__/shader-registry-transaction.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shader-registry-transaction.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/shader-registry-transaction.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/shader.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shader.unit.test.d.ts.map

package/dist/__tests__/shader.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shader.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/shader.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/sprite-lit-shader.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sprite-lit-shader.test.d.ts.map

package/dist/__tests__/sprite-lit-shader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprite-lit-shader.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/sprite-lit-shader.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/sprite-variants.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sprite-variants.unit.test.d.ts.map

package/dist/__tests__/sprite-variants.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprite-variants.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/sprite-variants.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/taa-resolve.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=taa-resolve.unit.test.d.ts.map

package/dist/__tests__/taa-resolve.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taa-resolve.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/taa-resolve.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/transparent-pbr.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transparent-pbr.unit.test.d.ts.map

package/dist/__tests__/transparent-pbr.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transparent-pbr.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/transparent-pbr.unit.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/vertex-color-variant.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=vertex-color-variant.unit.test.d.ts.map

package/dist/__tests__/vertex-color-variant.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vertex-color-variant.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/vertex-color-variant.unit.test.ts"],"names":[],"mappings":""}

package/dist/errors.d.ts

@@ -0,0 +1,96 @@
+import type { ShaderErrorCode } from '@forgeax/engine-types';
+export type { ShaderErrorCode };
+/**
+ * Path-specific `detail` shape for `manifest-malformed` / `shader-not-found`.
+ * `reason` is supplemental prose (it does not replace `hint`).
+ */
+export interface ShaderErrorDetail {
+    readonly reason?: string | undefined;
+    /**
+     * Machine-consumable list of currently-registered material-shader identifiers.
+     * Populated by `materialShaderNotFound()` factory so AI users can enumerate
+     * available shaders via `err.detail.registeredShaderIds` for autocomplete /
+     * fuzzy-match recovery without parsing the human-formatted `err.expected`
+     * string (charter P3 structured failure). `err.expected` still carries the
+     * pre-formatted `"ShaderRegistry has registered identifiers: [...]"` message
+     * for human-readable log output — the two channels are complementary.
+     */
+    readonly registeredShaderIds?: readonly string[] | undefined;
+}
+interface ShaderErrorInit {
+    readonly code: ShaderErrorCode;
+    readonly expected: string;
+    readonly hint: string;
+    readonly message: string;
+    readonly lineNum?: number | undefined;
+    readonly linePos?: number | undefined;
+    readonly detail?: ShaderErrorDetail | undefined;
+}
+/**
+ * Structured shader error (runtime path, aligned with build-time
+ * `@forgeax/engine-shader-compiler.ShaderError`).
+ *
+ * **5 surface fields** (MVP-2.3 top-level projection, AI-user consumption path):
+ * - `.code` — member of the closed `ShaderErrorCode` union (4 variants)
+ * - `.message` — display text (`Error` base-class field, populated at construction)
+ * - `.hint` — actionable recovery guidance (charter proposition 3:
+ *   machine-readable hint > prose)
+ * - `.lineNum` / `.linePos` — error source location (undefined on the runtime
+ *   path; only populated by the build-time compile-failed path; the field is
+ *   retained here for shape alignment).
+ *
+ * **3 internal fields**:
+ * - `.name` = `'ShaderError'` (debug label)
+ * - `.expected` — expected-state description (symmetric with RhiError)
+ * - `.detail` — path-specific extras (`reason` prose)
+ *
+ * **Do not `new` this directly** — construct via the 2 factory helpers
+ * (`manifestMalformed` / `shaderNotFound`); the runtime path of this loop does
+ * not trigger compile-failed / init-failed (those two paths belong to the
+ * build-time `ShaderError` shape in `@forgeax/engine-shader-compiler`).
+ */
+export declare class ShaderError extends Error {
+    readonly name: 'ShaderError';
+    readonly code: ShaderErrorCode;
+    readonly expected: string;
+    readonly hint: string;
+    readonly lineNum: number | undefined;
+    readonly linePos: number | undefined;
+    readonly detail: ShaderErrorDetail | undefined;
+    constructor(init: ShaderErrorInit);
+}
+/** `manifest-malformed`: manifest.json schema validation failed (4 fields missing or JSON unparseable). */
+export declare function manifestMalformed(args: {
+    readonly message: string;
+    readonly hint: string;
+    readonly reason?: string | undefined;
+}): ShaderError;
+/** `shader-not-found`: ShaderRegistry.get(hash) hash miss. */
+export declare function shaderNotFound(args: {
+    readonly hash: string;
+    readonly hint: string;
+}): ShaderError;
+/**
+ * `material-shader-not-found`: `ShaderRegistry.findMaterialArtifact(identifier)`
+ * miss. Returned by the runtime path when a `MaterialAsset.payload.materialShader`
+ * `::`-routed identifier (or any registered identifier) has no matching entry
+ * in the registry. AI-user recovery: the `.hint` cites the
+ * `forgeax::default-standard-pbr` reservation + the
+ * `installMaterialArtifact(...)` API path so the caller can register the missing
+ * shader at engine boot (feat-20260523-shader-template-instance-split M5 / T05).
+ *
+ * feat-20260528-material-shader-registration-unification M3 / w12 +
+ * feat-20260624-sprite-lit F-P1 fix: dual-channel exposure of the registered
+ * identifier set. `.expected` carries the pre-formatted string
+ * `"ShaderRegistry has registered identifiers: [id1, id2, ...]"` for human /
+ * log output; `.detail.registeredShaderIds` carries the raw `readonly string[]`
+ * for AI users to enumerate via property access without regex-parsing the
+ * message (charter P3 structured failure).
+ */
+export declare function materialShaderNotFound(args: {
+    readonly identifier: string;
+    readonly hint: string;
+    readonly expected: string[];
+}): ShaderError;
+export { err, ok, type Result, type ResultErr, type ResultOk, } from '@forgeax/engine-rhi';
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC;;;;;;;;OAQG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CAC9D;AAED,UAAU,eAAe;IACvB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;CACjD;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAkB,IAAI,EAAE,aAAa,CAAiB;IACtD,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,CAAC;gBAEnC,IAAI,EAAE,eAAe;CASlC;AAID,2GAA2G;AAC3G,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC,GAAG,WAAW,CAQd;AAED,8DAA8D;AAC9D,wBAAgB,cAAc,CAAC,IAAI,EAAE;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GAAG,WAAW,CAOd;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;CAC7B,GAAG,WAAW,CAQd;AAYD,OAAO,EACL,GAAG,EACH,EAAE,EACF,KAAK,MAAM,EACX,KAAK,SAAS,EACd,KAAK,QAAQ,GACd,MAAM,qBAAqB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+export type { ManifestEntry, ParamSchemaEntry } from '@forgeax/engine-types';
+import type { MaterialAsset } from '@forgeax/engine-types';
+export { MATERIAL_PARAM_TYPES } from '@forgeax/engine-types';
+export { err, manifestMalformed, materialShaderNotFound, ok, type Result, type ResultErr, type ResultOk, ShaderError, type ShaderErrorCode, type ShaderErrorDetail, shaderNotFound, } from './errors.js';
+export { type MaterialArtifactConflictError, type MaterialArtifactInspection, MaterialArtifactRegistry, type MaterialRuntimeArtifact, registerMaterialArtifact, } from './material/artifact-registry.js';
+export { isMaterialShaderArtifact, type MaterialShaderArtifact, } from './material/artifact-types.js';
+export { DEFAULT_MSDF_TEXT_PARAM_SCHEMA, DEFAULT_SPRITE_PARAM_SCHEMA, DEFAULT_STANDARD_PBR_PARAM_SCHEMA, DEFAULT_UNLIT_PARAM_SCHEMA, STANDARD_PBR_ALPHA_CUTOFF_DEFAULT, } from './material-schemas.js';
+export { registerDefaultSpriteLit, type SpriteLitCaps, } from './register-default-sprite-lit.js';
+export { registerDefaultStandardPbrSkin } from './register-default-standard-pbr-skin.js';
+export { FORGEAX_RESERVED_PATH_PREFIX, type MaterialShaderEntry, type RegisteredMaterialShaderEntry, ShaderRegistry, type ShaderRegistryDevice, type ShaderRegistryOptions, } from './ShaderRegistry.js';
+export { findVariantByKey, type MaterialShaderManifestEntry, type MaterialShaderManifestVariant, } from './types.js';
+export declare const BUILTIN_MATERIAL_MODULES: {
+    readonly standard: "forgeax_material::standard";
+    readonly unlit: "forgeax_material::unlit";
+    readonly sprite: "forgeax_material::sprite";
+};
+/**
+ * Material modules whose shader source and parameter contract are owned by
+ * the Engine. They live in the runtime ShaderRegistry, so a Pack containing
+ * one of these materials carries authored values only and does not require a
+ * project material-cook artifact.
+ */
+export declare const ENGINE_MATERIAL_MODULES: readonly ["forgeax::default-standard-pbr", "forgeax::pbr-skin", "forgeax::default-standard-pbr-skin", "forgeax::default-unlit", "forgeax::default-shadow-caster", "forgeax::sprite", "forgeax::sprite-lit", "forgeax::msdf-text", "forgeax_material::standard", "forgeax_material::unlit", "forgeax_material::sprite", "forgeax_material::sprite-lit"];
+export declare function isEngineMaterialModule(module: string): boolean;
+export declare function isEngineMaterial(material: Pick<MaterialAsset, 'passes'>): boolean;
+export type BuiltinMaterialKind = keyof typeof BUILTIN_MATERIAL_MODULES;
+export declare function createBuiltinMaterialAsset(kind: BuiltinMaterialKind): MaterialAsset;
+/**
+ * Shared luminance epsilon floor for the extended Reinhard tone-map
+ * (feat-20260519-tonemap-reinhard-mvp / D-O3).
+ *
+ * Both the TS port at `packages/runtime/src/systems/tonemap.ts` and the WGSL
+ * fragment stage in `packages/shader/src/tonemap.wgsl` apply
+ * `max(Y, TONEMAP_LUMINANCE_EPSILON)` before dividing the luminance ratio.
+ * The floor keeps the divisor finite at degenerate inputs (`Y = 0` from black
+ * pixels, `Y < 0` from rare numerical artefacts). Single SSOT here so a
+ * single `import { TONEMAP_LUMINANCE_EPSILON } from '@forgeax/engine-shader'`
+ * keeps TS / WGSL byte-equivalent.
+ *
+ * Value: `1e-5` — small enough to not perturb any plausible HDR luminance.
+ */
+export declare const TONEMAP_LUMINANCE_EPSILON = 0.00001;
+export { TONEMAP_SHADER_MODE, type TonemapShaderMode } from './tonemap.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAsBA,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE7E,OAAO,KAAK,EAAE,aAAa,EAAoC,MAAM,uBAAuB,CAAC;AAG7F,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EACL,GAAG,EACH,iBAAiB,EACjB,sBAAsB,EACtB,EAAE,EACF,KAAK,MAAM,EACX,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,WAAW,EACX,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,6BAA6B,EAClC,KAAK,0BAA0B,EAC/B,wBAAwB,EACxB,KAAK,uBAAuB,EAC5B,wBAAwB,GACzB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,wBAAwB,EACxB,KAAK,sBAAsB,GAC5B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,8BAA8B,EAC9B,2BAA2B,EAC3B,iCAAiC,EACjC,0BAA0B,EAC1B,iCAAiC,GAClC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,wBAAwB,EACxB,KAAK,aAAa,GACnB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AACzF,OAAO,EACL,4BAA4B,EAC5B,KAAK,mBAAmB,EACxB,KAAK,6BAA6B,EAClC,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,KAAK,2BAA2B,EAChC,KAAK,6BAA6B,GACnC,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,wBAAwB;;;;CAI3B,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,wVAa1B,CAAC;AAEX,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,GAAG,OAAO,CAGjF;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,wBAAwB,CAAC;AA0BxE,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,mBAAmB,GAAG,aAAa,CAOnF;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,yBAAyB,UAAO,CAAC;AAE9C,OAAO,EAAE,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC"}