@forgeax/engine-render 0.1.4 → 0.1.7

package/dist/__tests__/device-scope-lifecycle.unit.test.d.ts

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

package/dist/__tests__/device-scope-lifecycle.unit.test.d.ts.map

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

package/dist/__tests__/device-scope-stale-matrix.unit.test.d.ts

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

package/dist/__tests__/device-scope-stale-matrix.unit.test.d.ts.map

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

package/dist/__tests__/fullscreen-feature-plan.unit.test.d.ts

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

package/dist/__tests__/fullscreen-feature-plan.unit.test.d.ts.map

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

package/dist/__tests__/gpu-driven-indirect-raster-evidence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gpu-driven-indirect-raster-evidence.d.ts","sourceRoot":"","sources":["../../src/__tests__/gpu-driven-indirect-raster-evidence.ts"],"names":[],"mappings":"AA6FA,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,wBAAsB,kCAAkC,IAAI,OAAO,CAAC,+BAA+B,CAAC,CAwPnG"}
+{"version":3,"file":"gpu-driven-indirect-raster-evidence.d.ts","sourceRoot":"","sources":["../../src/__tests__/gpu-driven-indirect-raster-evidence.ts"],"names":[],"mappings":"AAoFA,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,wBAAsB,kCAAkC,IAAI,OAAO,CAAC,+BAA+B,CAAC,CAoQnG"}

package/dist/__tests__/gpu-driven-view-gpu-evidence.d.ts

@@ -8,5 +8,11 @@ export interface GpuDrivenViewGpuEvidence {
     readonly overflow: number;
     readonly persistentTranslationX: number;
 }
+export interface GpuDrivenViewLifecycleEvidence {
+    readonly frames: number;
+    readonly bufferRebuilds: number;
+    readonly candidateCapacity: number;
+}
+export declare function runGpuDrivenViewLifecycleEvidence(): Promise<GpuDrivenViewLifecycleEvidence>;
 export declare function runGpuDrivenViewGpuEvidence(): Promise<GpuDrivenViewGpuEvidence>;
 //# sourceMappingURL=gpu-driven-view-gpu-evidence.d.ts.map

package/dist/__tests__/gpu-driven-view-gpu-evidence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gpu-driven-view-gpu-evidence.d.ts","sourceRoot":"","sources":["../../src/__tests__/gpu-driven-view-gpu-evidence.ts"],"names":[],"mappings":"AAiDA,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;CACzC;AAED,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAmIrF"}
+{"version":3,"file":"gpu-driven-view-gpu-evidence.d.ts","sourceRoot":"","sources":["../../src/__tests__/gpu-driven-view-gpu-evidence.ts"],"names":[],"mappings":"AA8CA,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;CACzC;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,wBAAsB,iCAAiC,IAAI,OAAO,CAAC,8BAA8B,CAAC,CA0EjG;AAED,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAmIrF"}

package/dist/{gpu-driven/view-reference.d.ts → __tests__/gpu-driven-view-reference.d.ts}

@@ -1,5 +1,5 @@
-import type { RenderSceneProjectionSlot } from '../render-scene-projection';
-import type { SubmissionPlan } from './batch-topology';
+import type { SubmissionPlan } from '../gpu-driven/batch-topology';
+import type { RenderSceneSlot } from '../scene/render-scene';
 export declare const INDEXED_INDIRECT_STRIDE = 20;
 export interface GpuDrivenViewReferenceResult {
     readonly visibleInstanceIndices: Uint32Array;
@@ -11,5 +11,5 @@ export interface GpuDrivenViewReferenceResult {
     readonly overflowedBatches: readonly number[];
 }
 /** CPU oracle for the storage-buffer compute protocol and WebGL2 fallback semantics. */
-export declare function classifyGpuDrivenView(plan: SubmissionPlan, slots: readonly RenderSceneProjectionSlot[], planes: Float32Array, capacityByBatch?: ReadonlyMap<number, number>): GpuDrivenViewReferenceResult;
-//# sourceMappingURL=view-reference.d.ts.map
+export declare function classifyGpuDrivenView(plan: SubmissionPlan, slots: readonly RenderSceneSlot[], planes: Float32Array, capacityByBatch?: ReadonlyMap<number, number>): GpuDrivenViewReferenceResult;
+//# sourceMappingURL=gpu-driven-view-reference.d.ts.map

package/dist/__tests__/gpu-driven-view-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpu-driven-view-reference.d.ts","sourceRoot":"","sources":["../../src/__tests__/gpu-driven-view-reference.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,sBAAsB,EAAE,WAAW,CAAC;IAC7C,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C;AAED,wFAAwF;AACxF,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,SAAS,eAAe,EAAE,EACjC,MAAM,EAAE,YAAY,EACpB,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5C,4BAA4B,CAuF9B"}

package/dist/__tests__/gpu-scene-render-graph-gpu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gpu-scene-render-graph-gpu.d.ts","sourceRoot":"","sources":["../../src/__tests__/gpu-scene-render-graph-gpu.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,uBAAuB,EAAsB,MAAM,8BAA8B,CAAC;AAuGhG,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAwMvE"}
+{"version":3,"file":"gpu-scene-render-graph-gpu.d.ts","sourceRoot":"","sources":["../../src/__tests__/gpu-scene-render-graph-gpu.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,uBAAuB,EAAsB,MAAM,8BAA8B,CAAC;AAuGhG,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAuMvE"}

package/dist/__tests__/ibl/face-uniforms.unit.test.d.ts

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

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

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

package/dist/__tests__/morph-feature-plan.unit.test.d.ts

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

package/dist/__tests__/morph-feature-plan.unit.test.d.ts.map

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

package/dist/__tests__/render-feature-plan.test-d.d.ts

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

package/dist/__tests__/render-feature-plan.test-d.d.ts.map

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

package/dist/__tests__/render-feature-plan.unit.test.d.ts

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

package/dist/__tests__/render-feature-plan.unit.test.d.ts.map

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

package/dist/__tests__/ssao-config.unit.test.d.ts

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

package/dist/__tests__/ssao-config.unit.test.d.ts.map

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

package/dist/__tests__/standard-clustered-pipeline.unit.test.d.ts

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

package/dist/__tests__/standard-clustered-pipeline.unit.test.d.ts.map

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

package/dist/__tests__/standard-descriptors.test-d.d.ts

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

package/dist/__tests__/standard-descriptors.test-d.d.ts.map

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

package/dist/__tests__/standard-pipeline.dawn.test.d.ts

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

package/dist/__tests__/standard-pipeline.dawn.test.d.ts.map

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

package/dist/__tests__/standard-pipeline.integration.test.d.ts

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

package/dist/__tests__/standard-pipeline.integration.test.d.ts.map

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

package/dist/__tests__/standard-profile-oracle.unit.test.d.ts

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

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

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

package/dist/__tests__/visibility-resource-short-circuit.unit.test.d.ts

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

package/dist/__tests__/visibility-resource-short-circuit.unit.test.d.ts.map

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

package/dist/{renderer/backend-selection.d.ts → assembly/backend-contract.d.ts}

@@ -1,10 +1,11 @@
 import type { Result, RhiCanvasContext, RhiDevice, RhiError, RhiInstance, ShaderModule } from '@forgeax/engine-rhi';
-import type { RendererOptions } from '../renderer';
+/** Optional host hooks for recorder and device-lifecycle capabilities. */
 export interface RhiBackendInstrumentation {
     readonly resolveSurfaceDevice?: (device: RhiDevice) => Result<RhiDevice, RhiError>;
     readonly onFrameBoundary?: () => void;
     readonly onDeviceLost?: () => void;
 }
+/** Runtime-owned backend services injected into the render assembly. */
 export interface RhiBackendPack {
     readonly rhi: RhiInstance & {
         readonly acquireCanvasContext: (canvas: HTMLCanvasElement | OffscreenCanvas) => Result<RhiCanvasContext, RhiError>;
@@ -19,8 +20,18 @@ export interface RhiBackendPack {
     };
     /** @internal */
     readonly _internal_getRawDevice?: (device: RhiDevice) => unknown | undefined;
+    /** Optional lifecycle hooks owned by the host capability being injected. */
     readonly instrumentation?: RhiBackendInstrumentation;
 }
-export declare function loadRhiPack(mod: Record<string, unknown>): RhiBackendPack;
-export declare function loadBackendPack(options: RendererOptions | undefined): Promise<Result<RhiBackendPack, RhiError>>;
-//# sourceMappingURL=backend-selection.d.ts.map
+export interface EngineEnvironmentErrorDetail {
+    readonly webgpuError?: RhiError | Error | undefined;
+    readonly wgpuError?: RhiError | Error | undefined;
+}
+export declare class EngineEnvironmentError extends Error {
+    readonly reason: string;
+    readonly webgpuError?: RhiError | Error | undefined;
+    readonly wgpuError?: RhiError | Error | undefined;
+    readonly detail: EngineEnvironmentErrorDetail;
+    constructor(reason: string, detail?: EngineEnvironmentErrorDetail);
+}
+//# sourceMappingURL=backend-contract.d.ts.map

package/dist/assembly/backend-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-contract.d.ts","sourceRoot":"","sources":["../../src/assembly/backend-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,gBAAgB,EAChB,SAAS,EACT,QAAQ,EACR,WAAW,EACX,YAAY,EACb,MAAM,qBAAqB,CAAC;AAE7B,0EAA0E;AAC1E,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACnF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CACpC;AAED,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG;QAC1B,QAAQ,CAAC,oBAAoB,EAAE,CAC7B,MAAM,EAAE,iBAAiB,GAAG,eAAe,KACxC,MAAM,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;KACzC,CAAC;IACF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAC5B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,KAC/C,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC7C,QAAQ,CAAC,6BAA6B,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK;QAC3D,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;QACnB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;KAC1B,CAAC;IACF,gBAAgB;IAChB,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO,GAAG,SAAS,CAAC;IAC7E,4EAA4E;IAC5E,QAAQ,CAAC,eAAe,CAAC,EAAE,yBAAyB,CAAC;CACtD;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;CACnD;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;gBAElC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,4BAAiC;CAQtE"}

package/dist/assembly/factory.d.ts

@@ -0,0 +1,214 @@
+import { MeshSsboCapacityExceededError, MeshSsboCeilingReachedError } from '@forgeax/engine-assets-runtime';
+import type { Buffer, PipelineLayout, RhiDevice } from '@forgeax/engine-rhi';
+import { type MaterialShaderManifestEntry } from '@forgeax/engine-shader';
+import type { ImportTransport } from '@forgeax/engine-types';
+import type { Renderer, RendererOptions } from '../render-contract';
+import { type RhiBackendPack } from './backend-contract';
+import type { RendererAssemblyImplementation, RendererHostImplementation } from './host-contract';
+export { assembleMaterialProjection } from './material/assembly';
+export { projectMaterialPipeline, routeMaterialPipeline, updateMaterialRuntimeValues, } from './material/pipeline-projection';
+/**
+ * Bundler-layer injection accepted by `createRenderer` (and proxied by
+ * `createApp`) as the optional third argument.
+ *
+ * feat-20260608-create-app-param-surface-trim / M2 / D-3: aggregates the two
+ * host-injected build-tool channels:
+ *
+ *   - shaderManifestUrl: the URL the host's vite-plugin-shader emit step
+ *     wrote `manifest.json` to. When this field is omitted (or `bundler`
+ *     itself is omitted), createRenderer falls back to
+ *     '/shaders/manifest.json' (D-2 q5-A) so the LO 1.1 zero-config takeoff
+ *     path keeps working without explicit injection. Tests can inject via a
+ *     `data:application/json,...` URL to bypass fetch.
+ *
+ *   - importTransport: dev-only ImportTransport forwarded verbatim to the
+ *     AssetRegistry third ctor slot so DDC-miss assets can lazy-import.
+ *     Absent => shipped form (a DDC miss fails fast with `asset-not-imported`).
+ *
+ * The interface is duplicated structurally in `@forgeax/engine-app`
+ * (BundlerOptions exported from packages/app); demos consume through the app
+ * package, the engine accepts via this local minimal shape so packages/runtime
+ * does NOT depend on packages/app (charter P4 + reverse-coupling deny-list).
+ * TypeScript structural typing makes the two interchangeable at every call
+ * site (M3 forgeaxBundlerAdapter() returns the same shape).
+ */
+export interface BundlerOptions {
+    readonly importTransport?: ImportTransport | undefined;
+    readonly shaderManifestUrl?: string | undefined;
+}
+/** Build a Renderer from the backend pack supplied by the Runtime host. */
+/**
+ * Per-variant PipelineLayout selector (M4.5 / D-10 option A).
+ *
+ * The HDRP variant (`CLUSTER_FORWARD_AVAILABLE=true` or canonical `''`
+ * all-true when the shader declares the cluster axis) needs the 7-slot
+ * group(2) BGL chain (`hdrpPbrPipelineLayout`); URP variants
+ * (`CLUSTER_FORWARD_AVAILABLE=false` / undefined / no axis) keep the
+ * 1-slot mesh-array BGL chain (`pbrPipelineLayout`).
+ *
+ * Returns `null` only when the URP fallback layout itself is null
+ * (Camera-only / empty-manifest path). When the HDRP layout is null but
+ * URP exists, the HDRP variant gracefully falls back to URP — the WGSL
+ * resolved upstream by `findVariantByKey` is the URP variant in that
+ * case (manifest entry with all-true definesKey === '' was registered
+ * with isHdrpActive=false at boot when storage-buffer caps are absent).
+ *
+ * Pure function — exported for unit-test access (M4.5 / w35).
+ */
+/**
+ * Closed enum of pipeline-layout kinds the selector can dispatch to.
+ *
+ * `pbr` — standard PBR (1-entry mesh-array BGL).
+ * `pbr-skin` — bug-20260611-skin-pipeline-layout: 2-entry mesh-array BGL
+ *   (binding 0 meshes + binding 1 palette) for the `forgeax::pbr-skin`
+ *   material shader.
+ * `hdrp-pbr` — feat-20260609 HDRP cluster-forward variant (7-slot group(2)
+ *   BGL substituted at slot 2).
+ * `sprite-urp` — bug-20260708 M2 (c): sprite / sprite-lit shaders reuse
+ *   the URP 1-slot mesh-array BGL (they don't declare
+ *   CLUSTER_FORWARD_AVAILABLE) but their canonical all-true variant key
+ *   `''` (`SPRITE_PASS_PER_INSTANCE_REGION_VARIANT_SET`) MUST NOT trigger
+ *   the `variantSet===''` → HDRP branch of the selector. Callers
+ *   (`buildPipelineContext`) resolve `sprite-urp` from the sprite
+ *   `materialShaderId` and pass it through; the selector short-circuits
+ *   to `pbrPipelineLayout` before the HDRP check.
+ *
+ * AC-09 grep gate: the selector body (`selectPipelineLayoutForVariant`)
+ * **MUST NOT** contain literal `'forgeax::pbr-skin'` (or another
+ * shader-id literal). The caller resolves `LayoutKind` upstream and passes
+ * the structured value through (charter P4 consistent abstraction). New
+ * material-shader layouts add a `LayoutKind` member + a PipelineState slot
+ * + a switch arm here in one cut (charter P3 extensibility).
+ */
+export type LayoutKind = 'pbr' | 'pbr-skin' | 'hdrp-pbr' | 'sprite-urp' | 'unlit-urp';
+/**
+ * Return every device-capability HDRP PBR variant that needs a lazy module
+ * label seeded during renderer boot. Color availability is intentionally not
+ * filtered: colored and no-color meshes use distinct composed WGSL modules.
+ */
+export declare function selectHdrpPbrPrewarmVariants(manifestEntry: MaterialShaderManifestEntry | undefined, storageBufferCapable: boolean): readonly MaterialShaderManifestEntry['variants'][number][];
+/**
+ * Select the PBR variant that matches a fallback mesh with no COLOR_0 input.
+ * Unknown/custom material IDs may still use the legacy PBR fallback, so that
+ * path must obey the same geometry-owned vertex-color axis as registered PBR.
+ */
+export declare function selectNoColorPbrVariant(manifestEntry: MaterialShaderManifestEntry | undefined, storageBufferCapable: boolean, variantSet: string | undefined): MaterialShaderManifestEntry['variants'][number] | undefined;
+export type MaterialShaderBindingContract = 'group-0' | 'group-0-resource' | 'view-only' | 'view-and-scene-depth' | 'render-material';
+export type MaterialShaderVertexInputContract = 'none' | 'render-material';
+export declare function resolveMaterialShaderBindingContract(source: string): MaterialShaderBindingContract;
+export declare function resolveMaterialShaderVertexInputContract(source: string): MaterialShaderVertexInputContract;
+export declare function allowsUnlitPreparedFallback(depthFormatOverride: GPUTextureFormat | null | undefined, vertexLayout: string | undefined, materialShaderId?: string): boolean;
+/**
+ * Prepared VFX draws own their vertex inputs and bind groups. A missing
+ * authored material shader is therefore retryable, but it is never safe to
+ * substitute the built-in PBR module: PBR declares mesh/instance groups that
+ * the VFX draw does not bind. Returning true keeps the feature on its
+ * structured next-frame recovery path instead of creating an invalid PSO.
+ */
+export declare function shouldDeferMissingPreparedMaterialShader(vertexLayout: string | undefined): boolean;
+export declare function selectPipelineLayoutForVariant(state: {
+    readonly pbrPipelineLayout: PipelineLayout | null;
+    readonly hdrpPbrPipelineLayout: PipelineLayout | null;
+    readonly pbrSkinPipelineLayout: PipelineLayout | null;
+} | null, variantSet: string | undefined, layoutKind?: LayoutKind): PipelineLayout | null;
+/**
+ * Resolve a requested material variant against the actual backend capabilities.
+ * Record callers use the native-capability request; the backend-owned axes
+ * must be rewritten before the request reaches shader lookup and PSO layout
+ * selection.
+ */
+export declare function resolveMaterialShaderVariantSet(requestedVariantSet: string | undefined, variants: ReadonlyArray<{
+    readonly defines: Readonly<Record<string, boolean>>;
+}>, backendKind: RhiDevice['caps']['backendKind'], storageBuffer: boolean): string | undefined;
+/**
+ * Keep a single-source material on its canonical module identity. A manifest
+ * entry with no variants cannot consume a synthesized capability or geometry
+ * axis, so carrying one into the pipeline cache only creates an uncached lazy
+ * compile beside the prewarmed source module.
+ */
+export declare function normalizeMaterialShaderVariantSet(requestedVariantSet: string | undefined, manifestEntry: MaterialShaderManifestEntry | undefined): string | undefined;
+export declare function createRenderer(canvas: unknown, options?: RendererOptions, bundler?: BundlerOptions, backend?: RhiBackendPack): Promise<RendererAssemblyImplementation>;
+/** Narrow the concrete host to the lease/receipt-only public contract. */
+export declare function exposeRenderer(renderer: RendererHostImplementation): Renderer;
+/**
+ * Derive a usable storage-buffer ceiling from device limits.
+ *
+ * Mirrors the `SKIN_PALETTE_MAX_BINDING_BYTES` 0/undefined floor pattern
+ * (createRenderer.ts:4070-4073): when `maxStorageBufferBindingSize` is 0 or
+ * undefined (WebKit `downlevel_webgl2_defaults`), climb the fallback chain —
+ * `maxBufferSize` → `maxUniformBufferBindingSize` → WebGPU spec floor
+ * 134217728 (128 MiB).
+ *
+ * Pure helper — no device dependency, directly testable in node.
+ */
+export declare function deriveStorageBufferCeiling(limits: Readonly<{
+    maxStorageBufferBindingSize?: number;
+    maxBufferSize?: number;
+    maxUniformBufferBindingSize?: number;
+}>): number;
+/**
+ * Mesh + material buffer wrapper carrying the inner `Buffer` handle plus
+ * the byte-size at the time of allocation. The wrapper-object identity is
+ * stable across grow events — only `.buffer` and `.sizeInBytes` are mutated
+ * in place — so `PipelineState.meshStorageBuffer` / `materialUniformBuffer`
+ * fields capture the wrapper once and survive grow events without a re-bind
+ * cycle through the public Renderer surface (research §F8 R1).
+ */
+export interface MeshSsboBufferWrapper {
+    buffer: Buffer | null;
+    sizeInBytes: number;
+}
+/** Closure-local grow state surfaced for spy assertions in unit tests. */
+export interface MeshSsboState {
+    slotCount: number;
+    mesh: MeshSsboBufferWrapper;
+    material: MeshSsboBufferWrapper;
+}
+/** `growMeshSsbo` return shape (D-5: Result-like, never throws). */
+export type MeshSsboGrowResult = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly code: 'mesh-ssbo-ceiling-reached' | 'mesh-ssbo-capacity-exceeded';
+    /** Pre-grow slotCount — the caller can render up to this many slots (degraded subset). */
+    readonly degradedToSlotCount: number;
+};
+/** Minimal device surface the grow controller needs (mocked in unit tests). */
+export interface MeshSsboGrowDevice {
+    readonly limits: {
+        readonly maxStorageBufferBindingSize: number;
+    };
+    readonly createBuffer: (descriptor: {
+        readonly label?: string;
+        readonly size: number;
+        readonly usage: number;
+        readonly mappedAtCreation?: boolean;
+    }) => Buffer;
+}
+/** Minimal error-registry surface (just `fire` — `RhiErrorListenerRegistry` matches). */
+export interface MeshSsboGrowErrorRegistry {
+    fire: (e: MeshSsboCeilingReachedError | MeshSsboCapacityExceededError) => void;
+}
+export interface MeshSsboGrowControllerInit {
+    readonly device: MeshSsboGrowDevice;
+    readonly errorRegistry: MeshSsboGrowErrorRegistry;
+    readonly initialSlotCount: number;
+    readonly perEntityStride: number;
+    readonly meshUsage: number;
+    readonly materialUsage: number;
+}
+export interface MeshSsboGrowController {
+    readonly state: MeshSsboState;
+    /** Allocate the initial mesh + material buffer pair at `initialSlotCount`. */
+    readonly initialBuild: () => void;
+    /** Grow to satisfy `neededSlots`; idempotent + ceiling-aware. */
+    readonly growMeshSsbo: (neededSlots: number) => MeshSsboGrowResult;
+}
+/**
+ * Build a closure-scoped mesh-SSBO grow controller. Module-scope so unit
+ * tests (`__tests__/mesh-ssbo-grow.test.ts`) can construct it with a fake
+ * device + spy errorRegistry without spinning up the full WebGPU renderer
+ * (charter F2 minimal surface — the controller is the testable seam).
+ */
+export declare function createMeshSsboGrowController(init: MeshSsboGrowControllerInit): MeshSsboGrowController;
+//# sourceMappingURL=factory.d.ts.map

package/dist/assembly/factory.d.ts.map

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

package/dist/assembly/host-contract.d.ts

@@ -0,0 +1,84 @@
+import type { AssetRegistry } from '@forgeax/engine-assets-runtime';
+import type { World } from '@forgeax/engine-ecs';
+import type { Result, RhiDevice, RhiError, ShaderModule } from '@forgeax/engine-rhi';
+import type { RecoverFailure } from '../errors/recover';
+import type { ObservationUnavailableError, RenderError } from '../errors/render';
+import type { RenderFeature, RenderFeatureDiagnostics } from '../features/types';
+import type { MeshMaterialBindingObservation } from '../mesh-material-bindings';
+import type { FrameObservation, FrameObservationOptions } from '../record/frame';
+import type { DrawOwnerOptions, FrameObservationRequest, FrameReceipt, FrameReceiptObservation, HealthSnapshot, RenderDebugOverlay, RendererError, RendererErrorListener, RendererLostListener, RenderFrameInput, RenderInspection, RenderProfile, RenderResult, RenderWorldLease } from '../render-contract';
+import type { RenderSceneInspection } from '../render-system';
+type RenderShaderModuleFactory = (device: RhiDevice, desc: {
+    readonly label?: string | undefined;
+    readonly code: string;
+}) => Promise<Result<ShaderModule, RhiError>>;
+/** Package-local source projected to the sole public Renderer.subscribe channel. */
+export type RendererHostEvent = {
+    readonly kind: 'error';
+    readonly error: RendererError;
+} | {
+    readonly kind: 'health';
+    readonly health: HealthSnapshot;
+};
+export type RendererHostEventListener = (event: RendererHostEvent) => void;
+/**
+ * Narrow assembly contract consumed by exposeRenderer and constructRendererHost.
+ * Legacy diagnostics remain on RendererLegacyHostAdapter and cannot leak into
+ * the public Renderer type.
+ */
+export interface RendererHostImplementation {
+    attach(world: World): RenderResult<RenderWorldLease, RenderError>;
+    setProfile(profile: RenderProfile): RenderResult<void, RenderError>;
+    inspect(): RenderInspection;
+    drawFrame(request: RenderFrameInput): RenderResult<FrameReceipt, RhiError | RenderError>;
+    observe(receipt: FrameReceipt, request: FrameObservationRequest): Promise<RenderResult<FrameReceiptObservation, RenderError>>;
+    releaseSurface(): RenderResult<void, RhiError>;
+    restoreSurface(): RenderResult<void, RhiError>;
+    recover(): Promise<Result<void, RecoverFailure>>;
+    dispose(): RenderResult<void, RenderError>;
+    /** @internal Single event source used to construct public Renderer.subscribe. */
+    subscribeHostEvents(listener: RendererHostEventListener): () => void;
+    readonly device: RhiDevice;
+    /** @internal */
+    readonly _internal_createShaderModule: RenderShaderModuleFactory;
+    /** @internal */
+    readonly _internal_setRenderOverlay: (overlay: RenderDebugOverlay | undefined) => void;
+    readonly assetRegistry: AssetRegistry;
+    readonly initialization: Promise<RenderResult<void, RhiError>>;
+}
+/**
+ * @internal
+ * Temporary package-local compatibility surface for unmigrated render tests
+ * and producers. It is intentionally absent from RendererHostImplementation.
+ */
+export interface RendererLegacyHostAdapter {
+    attachScene(world: World): RenderResult<void, RhiError>;
+    detachScene(world: World): void;
+    draw(worldsOrRequest: readonly World[] | RenderFrameInput, options?: DrawOwnerOptions): RenderResult<void | FrameReceipt, RhiError | RenderError>;
+    observeCurrentFrame(options: FrameObservationOptions): Promise<RenderResult<FrameObservation, ObservationUnavailableError>>;
+    onLost(listener: RendererLostListener): () => void;
+    onError(listener: RendererErrorListener): () => void;
+    health(): HealthSnapshot;
+    readonly frustumStats: {
+        readonly culled: number;
+        readonly total: number;
+    };
+    readonly visibilityStats: {
+        readonly explicitlyHidden: number;
+    };
+    readonly renderScene: RenderSceneInspection;
+    readonly meshMaterialBindings: readonly MeshMaterialBindingObservation[];
+    readonly perFramePassNames: readonly string[];
+    renderFeatureDiagnostics(): readonly RenderFeatureDiagnostics[];
+    installRenderFeature(feature: RenderFeature<unknown>): Promise<RenderResult<void, RenderError>>;
+    uninstallRenderFeature(feature: RenderFeature<unknown>): Promise<RenderResult<void, RenderError>>;
+    readonly bindGroupCounts: {
+        readonly createBindGroup: number;
+        readonly keys: readonly string[];
+    };
+}
+/** @internal Concrete factory object before it is narrowed by exposeRenderer. */
+export interface RendererAssemblyImplementation extends RendererHostImplementation, RendererLegacyHostAdapter {
+}
+export {};
+//# sourceMappingURL=host-contract.d.ts.map

package/dist/assembly/host-contract.d.ts.map

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

package/dist/{renderer → assembly}/material/assembly.d.ts

@@ -13,7 +13,6 @@ export interface MaterialRenderProjection {
     readonly materialGuid: string;
     readonly specializationKey: string;
     readonly artifactHash: string;
-    readonly layoutIdentity: string;
     readonly passes: readonly MaterialRenderPassProjection[];
     readonly runtimeValues: Readonly<Record<string, MaterialValue | null>>;
     readonly staticSelection: readonly string[];

package/dist/{renderer → assembly}/material/assembly.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assembly.d.ts","sourceRoot":"","sources":["../../../src/renderer/material/assembly.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,4BAA4B,EAAE,CAAC;IACzD,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC,CAAC,CAAC;IACvE,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAkBD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,oBAAoB,GAAG,wBAAwB,CAajG"}
+{"version":3,"file":"assembly.d.ts","sourceRoot":"","sources":["../../../src/assembly/material/assembly.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,4BAA4B,EAAE,CAAC;IACzD,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC,CAAC,CAAC;IACvE,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAkBD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,oBAAoB,GAAG,wBAAwB,CASjG"}

package/dist/assembly/material/pipeline-projection.d.ts

@@ -0,0 +1,30 @@
+import type { MaterialRuntimeArtifact } from '@forgeax/engine-shader';
+import type { MaterialValue } from '@forgeax/engine-types';
+import type { MaterialRenderProjection } from './assembly.js';
+export interface MaterialPipelineProjection {
+    readonly specializationKey: string;
+    readonly artifactHash: string;
+    readonly passes: MaterialRenderProjection['passes'];
+}
+export interface MaterialPipelineReady extends MaterialPipelineProjection {
+    readonly kind: 'ready';
+    readonly artifact: MaterialRuntimeArtifact;
+}
+export interface MaterialPipelineMiss {
+    readonly kind: 'error';
+    readonly error: {
+        readonly code: 'material-specialization-not-cooked';
+        readonly expected: string;
+        readonly hint: string;
+        readonly detail: {
+            readonly specializationKey: string;
+        };
+    };
+}
+export declare function projectMaterialPipeline(projection: MaterialRenderProjection): MaterialPipelineProjection;
+export declare function updateMaterialRuntimeValues(projection: MaterialRenderProjection, values: Readonly<Record<string, MaterialValue | null>>): MaterialRenderProjection;
+export declare function routeMaterialPipeline(args: {
+    readonly projection: MaterialRenderProjection;
+    readonly lookupArtifact: (key: string) => MaterialRuntimeArtifact | undefined;
+}): MaterialPipelineReady | MaterialPipelineMiss;
+//# sourceMappingURL=pipeline-projection.d.ts.map

package/dist/assembly/material/pipeline-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-projection.d.ts","sourceRoot":"","sources":["../../../src/assembly/material/pipeline-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAE9D,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC,QAAQ,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,qBAAsB,SAAQ,0BAA0B;IACvE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;CAC5C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,IAAI,EAAE,oCAAoC,CAAC;QACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,EAAE;YAAE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;SAAE,CAAC;KACzD,CAAC;CACH;AAED,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,wBAAwB,GACnC,0BAA0B,CAM5B;AAED,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,wBAAwB,EACpC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC,CAAC,GACrD,wBAAwB,CAK1B;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAC;IAC9C,QAAQ,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,uBAAuB,GAAG,SAAS,CAAC;CAC/E,GAAG,qBAAqB,GAAG,oBAAoB,CAc/C"}

package/dist/authoring.d.ts

@@ -1,12 +1,12 @@
-export * from './components/glyph-text';
-export * from './components/sprite-animation';
-export * from './components/sprite-instances';
-export * from './components/sprite-playback-mode';
-export * from './components/sprite-region-override';
-export * from './components/tile-layer';
-export * from './components/tilemap';
-export { glyphTextLayoutSystem, resetGlyphBakeCache } from './glyph-text-layout-system';
-export { Materials, materialTextureValue, SPRITE_PREMULTIPLIED_ALPHA_BLEND, } from './materials';
-export { getTransparentSortConfig, setTransparentSortConfig, TRANSPARENT_SORT_MODE_DISTANCE, TRANSPARENT_SORT_MODE_LAYER_Y, TRANSPARENT_SORT_MODE_LAYER_YZ, TRANSPARENT_SORT_MODE_LAYER_Z, type TransparentSortConfig, } from './systems/transparent-sort-config';
-export { tilemapChunkExtractSystem } from './tilemap-chunk-extract-system';
+export { GlyphText } from './components/glyph-text';
+export { SpriteAnimation } from './components/sprite-animation';
+export { SpriteInstances, type SpriteInstancesData } from './components/sprite-instances';
+export { SpritePlayback, spritePlaybackModeFromU32 } from './components/sprite-playback-mode';
+export { SpriteRegionOverride } from './components/sprite-region-override';
+export { TileLayer, TilemapSort } from './components/tile-layer';
+export { Tilemap } from './components/tilemap';
+export { createFullscreenRenderFeature, type FullscreenRenderFeatureOptions, } from './features/fullscreen';
+export { SPRITE_PREMULTIPLIED_ALPHA_BLEND } from './materials';
+export { setActiveCamera } from './systems/active-camera';
+export { TransparentSort } from './systems/transparent-sort-config';
 //# sourceMappingURL=authoring.d.ts.map

package/dist/authoring.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authoring.d.ts","sourceRoot":"","sources":["../src/authoring.ts"],"names":[],"mappings":"AACA,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACxF,OAAO,EACL,SAAS,EACT,oBAAoB,EACpB,gCAAgC,GACjC,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,8BAA8B,EAC9B,6BAA6B,EAC7B,8BAA8B,EAC9B,6BAA6B,EAC7B,KAAK,qBAAqB,GAC3B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"authoring.d.ts","sourceRoot":"","sources":["../src/authoring.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9F,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EACL,6BAA6B,EAC7B,KAAK,8BAA8B,GACpC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gCAAgC,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC"}