@forgeax/engine-render 0.1.7 → 0.1.19

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

@@ -14,6 +14,18 @@ export interface RhiBackendPack {
         code: string;
         label?: string | undefined;
     }) => Promise<Result<ShaderModule, RhiError>>;
+    /**
+     * Internal render-path fast path. WebGPU creates a shader module
+     * synchronously and reports WGSL diagnostics through the async
+     * `createShaderModule` entry; waiting for `getCompilationInfo()` here would
+     * serialize every first-use material behind a slow software adapter. The
+     * render assembly still validates the module when it builds the pipeline,
+     * while public callers retain the diagnostic-rich async entry above.
+     */
+    readonly createShaderModuleImmediate?: (device: RhiDevice, desc: {
+        code: string;
+        label?: string | undefined;
+    }) => Result<ShaderModule, RhiError>;
     readonly translateErrorEventToRhiError?: (event: unknown) => {
         readonly ok: false;
         readonly error: RhiError;

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

@@ -1 +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"}
+{"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;;;;;;;OAOG;IACH,QAAQ,CAAC,2BAA2B,CAAC,EAAE,CACrC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,KAC/C,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IACpC,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;AAiCD,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;CAWtE"}

package/dist/assembly/factory.d.ts

@@ -2,6 +2,8 @@ import { MeshSsboCapacityExceededError, MeshSsboCeilingReachedError } from '@for
 import type { Buffer, PipelineLayout, RhiDevice } from '@forgeax/engine-rhi';
 import { type MaterialShaderManifestEntry } from '@forgeax/engine-shader';
 import type { ImportTransport } from '@forgeax/engine-types';
+export type { MaterialShaderManifestEntry } from '@forgeax/engine-shader';
+import type { RenderFeatureMaterialShaderBindingContract } from '../features/plan';
 import type { Renderer, RendererOptions } from '../render-contract';
 import { type RhiBackendPack } from './backend-contract';
 import type { RendererAssemblyImplementation, RendererHostImplementation } from './host-contract';
@@ -85,15 +87,23 @@ export type LayoutKind = 'pbr' | 'pbr-skin' | 'hdrp-pbr' | 'sprite-urp' | 'unlit
  * 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.
+ * Transmission is filtered by the same sampled-texture capability gate as
+ * Standard transmission because HDRP shares the material texture ABI.
  */
-export declare function selectHdrpPbrPrewarmVariants(manifestEntry: MaterialShaderManifestEntry | undefined, storageBufferCapable: boolean): readonly MaterialShaderManifestEntry['variants'][number][];
+export declare function selectHdrpPbrPrewarmVariants(manifestEntry: MaterialShaderManifestEntry | undefined, storageBufferCapable: boolean, transmissionCapable: boolean): readonly MaterialShaderManifestEntry['variants'][number][];
+/**
+ * Select both Standard transmission states from the manifest for exact-label
+ * prewarming. The requested keys come from declared variants; no key is
+ * synthesized and no source fallback is permitted.
+ */
+export declare function selectStandardPbrTransmissionPrewarmVariants(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 MaterialShaderBindingContract = RenderFeatureMaterialShaderBindingContract;
 export type MaterialShaderVertexInputContract = 'none' | 'render-material';
 export declare function resolveMaterialShaderBindingContract(source: string): MaterialShaderBindingContract;
 export declare function resolveMaterialShaderVertexInputContract(source: string): MaterialShaderVertexInputContract;

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

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

@@ -6,6 +6,7 @@ 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 { CurrentGraphTarget, GraphTargetCaptureRequest } from '../record/frame-snapshot';
 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: {
@@ -56,6 +57,9 @@ export interface RendererLegacyHostAdapter {
     detachScene(world: World): void;
     draw(worldsOrRequest: readonly World[] | RenderFrameInput, options?: DrawOwnerOptions): RenderResult<void | FrameReceipt, RhiError | RenderError>;
     observeCurrentFrame(options: FrameObservationOptions): Promise<RenderResult<FrameObservation, ObservationUnavailableError>>;
+    /** @internal Test-only current compiled graph target diagnostic. */
+    getCurrentGraphTarget(name: string): CurrentGraphTarget | undefined;
+    requestGraphTargetCapture(request: GraphTargetCaptureRequest): void;
     onLost(listener: RendererLostListener): () => void;
     onError(listener: RendererErrorListener): () => void;
     health(): HealthSnapshot;

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

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

package/dist/assembly/renderer-frame-transaction.d.ts

@@ -0,0 +1,39 @@
+/** Staged frame state committed only after the renderer submit barrier. */
+export interface RendererFrameTransaction<T> {
+    readonly candidate: T;
+    readonly commit: () => T;
+    readonly abort: () => void;
+}
+export declare function stageRendererFrame<T>(candidate: T, onAbort?: () => void): RendererFrameTransaction<T>;
+export type RendererFrameStage = 'build' | 'execute' | 'finish' | 'submit';
+export interface RendererFrameStageFailure {
+    readonly stage: RendererFrameStage;
+}
+export type RendererFrameStageResult<T> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly stage: RendererFrameStage;
+};
+export interface RendererFrameTransactionSteps<T> {
+    readonly build: () => RendererFrameStageResult<T>;
+    readonly execute: (candidate: T) => RendererFrameStageResult<void>;
+    readonly finish: (candidate: T) => RendererFrameStageResult<void>;
+    readonly submit: (candidate: T) => RendererFrameStageResult<void>;
+    readonly commit: (candidate: T) => void;
+    readonly abort?: (failure: RendererFrameStageFailure) => void;
+}
+/**
+ * Run the four renderer stages behind one commit barrier. A stage can expose
+ * only a structured failure; the candidate is never published until submit
+ * has returned success, so a failed frame cannot advance last-known-good state.
+ */
+export declare function executeRendererFrameTransaction<T>(steps: RendererFrameTransactionSteps<T>): {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly error: RendererFrameStageFailure;
+};
+//# sourceMappingURL=renderer-frame-transaction.d.ts.map

package/dist/assembly/renderer-frame-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-frame-transaction.d.ts","sourceRoot":"","sources":["../../src/assembly/renderer-frame-transaction.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,SAAS,EAAE,CAAC,EACZ,OAAO,GAAE,MAAM,IAAsB,GACpC,wBAAwB,CAAC,CAAC,CAAC,CAe7B;AAED,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3E,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;CACpC;AAED,MAAM,MAAM,wBAAwB,CAAC,CAAC,IAClC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACxC;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAE/D,MAAM,WAAW,6BAA6B,CAAC,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,wBAAwB,CAAC,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,wBAAwB,CAAC,IAAI,CAAC,CAAC;IACnE,QAAQ,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,wBAAwB,CAAC,IAAI,CAAC,CAAC;IAClE,QAAQ,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,wBAAwB,CAAC,IAAI,CAAC,CAAC;IAClE,QAAQ,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,yBAAyB,KAAK,IAAI,CAAC;CAC/D;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,CAAC,EAC/C,KAAK,EAAE,6BAA6B,CAAC,CAAC,CAAC,GAErC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACxC;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,yBAAyB,CAAA;CAAE,CAmBpE"}

package/dist/assembly/renderer-inspection.d.ts

@@ -0,0 +1,22 @@
+import type { CompiledRenderGraphInfo } from '@forgeax/engine-render-graph';
+import type { RhiCanvasSurfacePresentationProof, TextureFormat } from '@forgeax/engine-rhi';
+import { type RenderOutputInspection } from '../render-contract';
+/** Inputs owned by the renderer assembly for one detached output projection. */
+export interface RendererOutputInspectionInput {
+    readonly graph: CompiledRenderGraphInfo | undefined;
+    readonly surfaceAvailable: boolean;
+    readonly surfaceStorage: TextureFormat;
+    readonly surfaceDisplay: TextureFormat;
+    readonly surfaceProfile?: 'dual-view' | 'raw-only';
+    readonly rgba16floatRenderable: boolean;
+    readonly presentationProof?: RhiCanvasSurfacePresentationProof | undefined;
+}
+/**
+ * Project output facts from the committed graph and physical surface only.
+ * Profile fields are deliberately not consulted: a transform pass, a real
+ * intermediate target, and the final endpoint/domain are graph facts.
+ */
+export declare function projectRendererOutputInspection(input: RendererOutputInspectionInput): RenderOutputInspection;
+/** Detached inspection projection helper; live renderer objects never cross this boundary. */
+export declare function detachRendererInspection<T extends object>(inspection: T): Readonly<T>;
+//# sourceMappingURL=renderer-inspection.d.ts.map

package/dist/assembly/renderer-inspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-inspection.d.ts","sourceRoot":"","sources":["../../src/assembly/renderer-inspection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,EAAE,iCAAiC,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC5F,OAAO,EACL,KAAK,sBAAsB,EAG5B,MAAM,oBAAoB,CAAC;AAE5B,gFAAgF;AAChF,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,KAAK,EAAE,uBAAuB,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC;IACvC,QAAQ,CAAC,cAAc,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;IACnD,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iCAAiC,GAAG,SAAS,CAAC;CAC5E;AAcD;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,6BAA6B,GACnC,sBAAsB,CAoExB;AAED,8FAA8F;AAC9F,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,MAAM,EAAE,UAAU,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAErF"}

package/dist/assembly/renderer-lifecycle.d.ts

@@ -0,0 +1,4 @@
+import type { RendererState } from '../render-contract';
+/** Lifecycle states that may accept a new frame operation. */
+export declare function isRendererStateOperational(state: RendererState): boolean;
+//# sourceMappingURL=renderer-lifecycle.d.ts.map

package/dist/assembly/renderer-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-lifecycle.d.ts","sourceRoot":"","sources":["../../src/assembly/renderer-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,8DAA8D;AAC9D,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAExE"}

package/dist/authoring.mjs

@@ -1,5 +1,7 @@
-export { GlyphText, SpritePlayback, TransparentSort, setActiveCamera, spritePlaybackModeFromU32 } from './chunk-HCOGPHKS.mjs';
-export { SPRITE_PREMULTIPLIED_ALPHA_BLEND, SpriteAnimation, SpriteInstances, SpriteRegionOverride, TileLayer, Tilemap, TilemapSort } from './chunk-CQXZC5XI.mjs';
+export { GlyphText, SpritePlayback, setActiveCamera, spritePlaybackModeFromU32 } from './chunk-FJ6P52EE.mjs';
+export { SpriteAnimation, SpriteInstances, SpriteRegionOverride, TileLayer, Tilemap, TilemapSort } from './chunk-JDWARUOI.mjs';
+export { TransparentSort } from './chunk-RXZ3RGOU.mjs';
+export { SPRITE_PREMULTIPLIED_ALPHA_BLEND } from './chunk-VFPLTKCU.mjs';
 import { ok } from '@forgeax/engine-types';
 
 function createFullscreenRenderFeature(options) {

package/dist/authoring.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/features/fullscreen.ts"],"names":[],"mappings":";;;;AAwBO,SAAS,8BACd,OAAA,EAC0B;AAC1B,EAAA,MAAM,YAAA,GAAe,cAAc,OAAA,CAAQ,QAAA,CAAS,QAAQ,eAAA,EAAiB,GAAG,CAAA,CAAE,WAAA,EAAa,CAAA,CAAA;AAC/F,EAAA,OAAO,OAAO,MAAA,CAAO;AAAA,IACnB,UAAU,OAAA,CAAQ,QAAA;AAAA,IAClB,OAAA,EAAS,CAAC,QAAA,KAA0C,EAAA,CAAG,MAAS,CAAA;AAAA,IAChE,IAAA,EAAM,CAAC,KAAA,EAAkB,QAAA,KACvB,EAAA,CAAG;AAAA,MACD,SAAA,EAAW;AAAA,QACT;AAAA,UACE,IAAA,EAAM,oBAAA;AAAA,UACN,IAAA,EAAM,YAAA;AAAA,UACN,QAAQ,OAAA,CAAQ,MAAA;AAAA,UAChB,GAAI,QAAQ,KAAA,KAAU,MAAA,GAAY,EAAC,GAAI,EAAE,KAAA,EAAO,OAAA,CAAQ,KAAA,EAAM;AAAA,UAC9D,GAAI,QAAQ,MAAA,KAAW,MAAA,GAAY,EAAC,GAAI,EAAE,MAAA,EAAQ,OAAA,CAAQ,MAAA;AAAO;AACnE,OACF;AAAA,MACA,QAAQ;AAAC,KACkB;AAAA,GAChC,CAAA;AACH","file":"authoring.mjs","sourcesContent":["import { ok } from '@forgeax/engine-types';\nimport type {\n  RenderFeatureFullscreenRead,\n  RenderFeaturePlan,\n  RenderFeaturePlanContext,\n} from './plan';\nimport type { RenderFeature, RenderFeatureExtractContext } from './types';\n\n/** Host-owned fullscreen effect declaration carried by one RenderFeature. */\nexport interface FullscreenRenderFeatureOptions {\n  readonly identity: string;\n  readonly source: string;\n  readonly reads?: readonly RenderFeatureFullscreenRead[];\n  readonly params?: {\n    readonly byteSize: number;\n    readonly defaultValue: Uint8Array;\n  };\n}\n\n/**\n * Describe a fullscreen effect for the single feature host.\n * The producer returns this closed feature; GPU registration and lifetime stay\n * with the renderer host.\n */\nexport function createFullscreenRenderFeature(\n  options: FullscreenRenderFeatureOptions,\n): RenderFeature<undefined> {\n  const resourceName = `fullscreen.${options.identity.replace(/[^a-z0-9.-]/gi, '-').toLowerCase()}`;\n  return Object.freeze({\n    identity: options.identity,\n    extract: (_context: RenderFeatureExtractContext) => ok(undefined),\n    plan: (_data: undefined, _context: RenderFeaturePlanContext) =>\n      ok({\n        resources: [\n          {\n            kind: 'fullscreen-program',\n            name: resourceName,\n            source: options.source,\n            ...(options.reads === undefined ? {} : { reads: options.reads }),\n            ...(options.params === undefined ? {} : { params: options.params }),\n          },\n        ],\n        passes: [],\n      } satisfies RenderFeaturePlan),\n  });\n}\n"]}
+{"version":3,"sources":["../src/features/fullscreen.ts"],"names":[],"mappings":";;;;;;AAwBO,SAAS,8BACd,OAAA,EAC0B;AAC1B,EAAA,MAAM,YAAA,GAAe,cAAc,OAAA,CAAQ,QAAA,CAAS,QAAQ,eAAA,EAAiB,GAAG,CAAA,CAAE,WAAA,EAAa,CAAA,CAAA;AAC/F,EAAA,OAAO,OAAO,MAAA,CAAO;AAAA,IACnB,UAAU,OAAA,CAAQ,QAAA;AAAA,IAClB,OAAA,EAAS,CAAC,QAAA,KAA0C,EAAA,CAAG,MAAS,CAAA;AAAA,IAChE,IAAA,EAAM,CAAC,KAAA,EAAkB,QAAA,KACvB,EAAA,CAAG;AAAA,MACD,SAAA,EAAW;AAAA,QACT;AAAA,UACE,IAAA,EAAM,oBAAA;AAAA,UACN,IAAA,EAAM,YAAA;AAAA,UACN,QAAQ,OAAA,CAAQ,MAAA;AAAA,UAChB,GAAI,QAAQ,KAAA,KAAU,MAAA,GAAY,EAAC,GAAI,EAAE,KAAA,EAAO,OAAA,CAAQ,KAAA,EAAM;AAAA,UAC9D,GAAI,QAAQ,MAAA,KAAW,MAAA,GAAY,EAAC,GAAI,EAAE,MAAA,EAAQ,OAAA,CAAQ,MAAA;AAAO;AACnE,OACF;AAAA,MACA,QAAQ;AAAC,KACkB;AAAA,GAChC,CAAA;AACH","file":"authoring.mjs","sourcesContent":["import { ok } from '@forgeax/engine-types';\nimport type {\n  RenderFeatureFullscreenRead,\n  RenderFeaturePlan,\n  RenderFeaturePlanContext,\n} from './plan';\nimport type { RenderFeature, RenderFeatureExtractContext } from './types';\n\n/** Host-owned fullscreen effect declaration carried by one RenderFeature. */\nexport interface FullscreenRenderFeatureOptions {\n  readonly identity: string;\n  readonly source: string;\n  readonly reads?: readonly RenderFeatureFullscreenRead[];\n  readonly params?: {\n    readonly byteSize: number;\n    readonly defaultValue: Uint8Array;\n  };\n}\n\n/**\n * Describe a fullscreen effect for the single feature host.\n * The producer returns this closed feature; GPU registration and lifetime stay\n * with the renderer host.\n */\nexport function createFullscreenRenderFeature(\n  options: FullscreenRenderFeatureOptions,\n): RenderFeature<undefined> {\n  const resourceName = `fullscreen.${options.identity.replace(/[^a-z0-9.-]/gi, '-').toLowerCase()}`;\n  return Object.freeze({\n    identity: options.identity,\n    extract: (_context: RenderFeatureExtractContext) => ok(undefined),\n    plan: (_data: undefined, _context: RenderFeaturePlanContext) =>\n      ok({\n        resources: [\n          {\n            kind: 'fullscreen-program',\n            name: resourceName,\n            source: options.source,\n            ...(options.reads === undefined ? {} : { reads: options.reads }),\n            ...(options.params === undefined ? {} : { params: options.params }),\n          },\n        ],\n        passes: [],\n      } satisfies RenderFeaturePlan),\n  });\n}\n"]}

package/dist/chunk-FJ6P52EE.mjs

@@ -0,0 +1,46 @@
+import { defineComponent } from '@forgeax/engine-ecs';
+
+// src/components/glyph-text.ts
+var GlyphText = defineComponent("GlyphText", {
+  // The layout/render owner re-resolves the font asset on the target world;
+  // authoring text and style remain portable simulation state.
+  fontHandle: {
+    type: "shared<FontAsset>",
+    default: 0,
+    simulationTransient: true
+  },
+  text: { type: "string", default: "" },
+  fontSize: { type: "f32", default: 16 },
+  // color carries an explicit layer-2 default [1,1,1,1] (opaque white); the
+  // array layer-3 fallback is all-zero, so the default MUST be explicit (D-5).
+  color: { type: "array<f32, 4>", default: new Float32Array([1, 1, 1, 1]) }
+});
+
+// src/components/sprite-playback-mode.ts
+var SPRITE_PLAYBACK_MODE_LOOP = 0;
+var SPRITE_PLAYBACK_MODE_CLAMP = 1;
+var SpritePlayback = Object.freeze({
+  loop: SPRITE_PLAYBACK_MODE_LOOP,
+  clamp: SPRITE_PLAYBACK_MODE_CLAMP
+});
+function spritePlaybackModeFromU32(value) {
+  return value === SPRITE_PLAYBACK_MODE_CLAMP ? "clamp" : "loop";
+}
+
+// src/systems/active-camera.ts
+var ACTIVE_CAMERA_KEY = "ActiveCamera";
+function getActiveCamera(world) {
+  if (!world.hasResource(ACTIVE_CAMERA_KEY)) return void 0;
+  return world.getResource(ACTIVE_CAMERA_KEY);
+}
+function setActiveCamera(world, entity) {
+  world.insertResource(ACTIVE_CAMERA_KEY, { entity });
+}
+function selectActiveCameraIndex(cameraEntities, activeEntity) {
+  if (activeEntity === void 0) return -1;
+  return cameraEntities.indexOf(activeEntity);
+}
+
+export { GlyphText, SpritePlayback, getActiveCamera, selectActiveCameraIndex, setActiveCamera, spritePlaybackModeFromU32 };
+//# sourceMappingURL=chunk-FJ6P52EE.mjs.map
+//# sourceMappingURL=chunk-FJ6P52EE.mjs.map

package/dist/chunk-FJ6P52EE.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/glyph-text.ts","../src/components/sprite-playback-mode.ts","../src/systems/active-camera.ts"],"names":[],"mappings":";;;AAkDO,IAAM,SAAA,GAAY,gBAAgB,WAAA,EAAa;AAAA;AAAA;AAAA,EAGpD,UAAA,EAAY;AAAA,IACV,IAAA,EAAM,mBAAA;AAAA,IACN,OAAA,EAAS,CAAA;AAAA,IACT,mBAAA,EAAqB;AAAA,GACvB;AAAA,EACA,IAAA,EAAM,EAAE,IAAA,EAAM,QAAA,EAAU,SAAS,EAAA,EAAG;AAAA,EACpC,QAAA,EAAU,EAAE,IAAA,EAAM,KAAA,EAAO,SAAS,EAAA,EAAG;AAAA;AAAA;AAAA,EAGrC,KAAA,EAAO,EAAE,IAAA,EAAM,eAAA,EAAiB,OAAA,EAAS,IAAI,YAAA,CAAa,CAAC,CAAA,EAAG,CAAA,EAAG,CAAA,EAAG,CAAC,CAAC,CAAA;AACxE,CAAC;;;ACXM,IAAM,yBAAA,GAA4B,CAAA;AAGlC,IAAM,0BAAA,GAA6B,CAAA;AAGnC,IAAM,cAAA,GAAiB,OAAO,MAAA,CAAO;AAAA,EAC1C,IAAA,EAAM,yBAAA;AAAA,EACN,KAAA,EAAO;AACT,CAAU;AAeH,SAAS,0BAA0B,KAAA,EAAmC;AAC3E,EAAA,OAAO,KAAA,KAAU,6BAA6B,OAAA,GAAU,MAAA;AAC1D;;;ACnBO,IAAM,iBAAA,GAAoB,cAAA;AAkB1B,SAAS,gBAAgB,KAAA,EAAwC;AACtE,EAAA,IAAI,CAAC,KAAA,CAAM,WAAA,CAAY,iBAAiB,GAAG,OAAO,MAAA;AAClD,EAAA,OAAO,KAAA,CAAM,YAA0B,iBAAiB,CAAA;AAC1D;AAUO,SAAS,eAAA,CAAgB,OAAc,MAAA,EAAsB;AAClE,EAAA,KAAA,CAAM,cAAA,CAA6B,iBAAA,EAAmB,EAAE,MAAA,EAAQ,CAAA;AAClE;AAiBO,SAAS,uBAAA,CACd,gBACA,YAAA,EACQ;AACR,EAAA,IAAI,YAAA,KAAiB,QAAW,OAAO,EAAA;AACvC,EAAA,OAAO,cAAA,CAAe,QAAQ,YAAY,CAAA;AAC5C","file":"chunk-FJ6P52EE.mjs","sourcesContent":["// @forgeax/engine-runtime - GlyphText component (feat-20260531-world-space-msdf-text-rendering M4 / w14).\n//\n// `GlyphText` is the authoring source component for world-space MSDF text\n// (requirements AC-06 / §domain model). It carries ONLY authoring data; the\n// glyph quad baking + MeshFilter / MeshRenderer attachment is the job of the\n// `glyphTextLayoutSystem` (plan-strategy D-2: GlyphText is pure authoring\n// data, baking is a system responsibility). There is NO `TextLayoutAsset`\n// intermediate (OOS-5) -- layout output lives directly in a baked MeshAsset.\n//\n// Naming: single-semantic component drops the `Component` suffix\n// (AGENTS.md §Component naming rule #1 -- Transform / Camera / GlyphText).\n//\n// Schema vocab:\n//   - `fontHandle: 'shared<FontAsset>'` -> `Handle<'FontAsset', 'shared'>`\n//     (u32-stored; AssetRegistry owns the FontAsset lifecycle). AI users\n//     obtain the handle via `assets.loadByGuid<FontAsset>(guid)`.\n//   - `text: 'string'` -> native JS string (UniqueRefStore-backed, same\n//     dispatch as `Name.value`).\n//   - `fontSize: 'f32'` -> layout scale applied to the FontAsset metrics.\n//   - `color: 'array<f32, 4>'` -> linear-space rgba tint (feat-20260709 M3:\n//     collapsed from four `colorR/G/B/A` scalar columns into one inline\n//     stride-4 SoA column, mirroring the DirectionalLight direction/color\n//     idiom). Explicit layer-2 default [1,1,1,1] (opaque white).\n//\n// charter mapping: P1 (single import surface from `@forgeax/engine-render`,\n// co-located with `glyphTextLayoutSystem` that consumes it) + P3\n// (machine-readable schema literal) + P5 (consistent abstraction: same\n// `'shared<T>'` idiom as MeshFilter.assetHandle / MeshRenderer.materials).\n\nimport { defineComponent } from '@forgeax/engine-ecs';\n\n/**\n * Glyph text authoring component (world-space MSDF text).\n *\n * Spawn an entity with a `GlyphText` and the `glyphTextLayoutSystem`\n * (auto-wired by `createRenderer` / `createApp`) lays out the glyph quads,\n * bakes a `MeshAsset`, and attaches `MeshFilter` + `MeshRenderer` on the\n * next frame (Commands-deferred). Mutating `text` / `fontSize` / `color`\n * re-bakes the mesh in place (plan-strategy D-1 updateMesh; registry size\n * unchanged, AC-08).\n *\n * @example Spawn a world-space label:\n *   import { GlyphText } from '@forgeax/engine-render/authoring';\n *   const font = (await assets.loadByGuid(fontGuid)).unwrap();\n *   world.spawn({\n *     component: GlyphText,\n *     data: { fontHandle: font, text: 'Hello', fontSize: 32,\n *             color: [1, 1, 1, 1] },\n *   });\n */\nexport const GlyphText = defineComponent('GlyphText', {\n  // The layout/render owner re-resolves the font asset on the target world;\n  // authoring text and style remain portable simulation state.\n  fontHandle: {\n    type: 'shared<FontAsset>',\n    default: 0 as never,\n    simulationTransient: true,\n  },\n  text: { type: 'string', default: '' },\n  fontSize: { type: 'f32', default: 16 },\n  // color carries an explicit layer-2 default [1,1,1,1] (opaque white); the\n  // array layer-3 fallback is all-zero, so the default MUST be explicit (D-5).\n  color: { type: 'array<f32, 4>', default: new Float32Array([1, 1, 1, 1]) },\n});\n","// @forgeax/engine-runtime - SpritePlaybackMode (u32 column encoding + mapper).\n//\n// SSOT for the SpriteAnimation.playbackMode ECS column (M2 T-12) and the\n// runtime tick-system branch selector (M4 T-23). The shape mirrors the M1\n// `Tonemap` block in `./camera.ts:72-90` (TONEMAP_NONE = 0 /\n// TONEMAP_REINHARD_EXTENDED = 1 + `type Tonemap = 'none' |\n// 'reinhard-extended'` + `tonemapFromF32`) for charter P4 consistent\n// abstraction — AI users keep one mental model across all u32-encoded\n// closed-union schema columns.\n//\n// Why `'u32'` + constant + mapper instead of a string-literal column?\n// ECS schema whitelist `SchemaFieldType` (packages/ecs/src/component.ts\n// section schema-field-type) does not accept string-literal unions\n// (research F-2 + F-5). Storing a u32 + translating to a closed\n// `'loop' | 'clamp'` literal union at the tick-system seam preserves\n// AI-user-facing narrowing (`switch (mode) { case 'loop': ... }`)\n// without forcing the ECS column to learn a new field-type vocabulary.\n//\n// Naming convention (plan-strategy section 8.command naming):\n//   SPRITE_PLAYBACK_MODE_LOOP / SPRITE_PLAYBACK_MODE_CLAMP mirror M1\n//   TONEMAP_* / TRANSPARENT_SORT_MODE_*. `spritePlaybackModeFromU32`\n//   mirrors `tonemapFromF32` / `cameraProjectionFromF32`. AI users\n//   discover the trio via single-import barrel re-export from\n//   `@forgeax/engine-runtime` (wired in by M2 T-13).\n//\n// Anchors: plan-strategy section 2 D-5 + section 3.1 PR block SPM +\n//          section 4 risk R-SCHEMA-1 reaction; research F-2 + F-5;\n//          requirements section AC-02 + section 2.3 playbackMode row;\n//          plan-tasks.json T-07 acceptanceCheck (rg\n//          \"SPRITE_PLAYBACK_MODE_LOOP|SPRITE_PLAYBACK_MODE_CLAMP|\n//          spritePlaybackModeFromU32\" >= 3 hits in this file).\n\n/**\n * Playback mode discriminator literal union (requirements section AC-02 +\n * section 2.3). Two members for the MVP:\n *\n *   `'loop'`  — `currentFrame = (currentFrame + 1) % frameCount`; the\n *               sprite-animation-tick system wraps the index when\n *               `accumDt >= frameDuration` (default for hello-sprite-\n *               atlas demo \"100 sprites synchronised walk cycle\").\n *   `'clamp'` — `currentFrame = min(currentFrame + 1, frameCount - 1)`;\n *               holds the last frame for death / terminator-animation\n *               style sequences (requirements section 2.5 q8 lock).\n *\n * Future modes (`'pingpong'`, reverse playback, arbitrary frame index\n * jumps) are deferred per requirements OOS-03. The closed union shape\n * leaves room for additive growth without breaking the u32 enum encoding\n * (plan-strategy section 2 D-5).\n */\nexport type SpritePlaybackMode = 'loop' | 'clamp';\n\n/** Numeric encoding of the loop playback mode (schema value for `playbackMode`). */\nexport const SPRITE_PLAYBACK_MODE_LOOP = 0 as const;\n\n/** Numeric encoding of the clamp playback mode (schema value for `playbackMode`). */\nexport const SPRITE_PLAYBACK_MODE_CLAMP = 1 as const;\n\n/** Grouped authoring values; the numeric ECS encoding stays owner-local. */\nexport const SpritePlayback = Object.freeze({\n  loop: SPRITE_PLAYBACK_MODE_LOOP,\n  clamp: SPRITE_PLAYBACK_MODE_CLAMP,\n} as const);\n\n/**\n * Map a `SpriteAnimation.playbackMode` numeric column value to the closed\n * `SpritePlaybackMode` string-literal union. The defensive fallback mirrors\n * `cameraProjectionFromF32` / `tonemapFromF32` precedent — a value other\n * than `SPRITE_PLAYBACK_MODE_CLAMP` (1) maps to `'loop'`, so stale or\n * uninitialised entities surface a predictable playback shape through the\n * tick-system query (rather than throwing or returning `undefined`).\n * Validation of `playbackMode` happens at schema-write time, not here.\n *\n * The tick-system in M4 T-23 (`spriteAnimationTickSystem`) consumes the\n * return value via `switch (mode) { case 'loop': ...; case 'clamp': ... }`\n * to pick the per-branch frame-advance arithmetic.\n */\nexport function spritePlaybackModeFromU32(value: number): SpritePlaybackMode {\n  return value === SPRITE_PLAYBACK_MODE_CLAMP ? 'clamp' : 'loop';\n}\n","// @forgeax/engine-runtime - ActiveCamera KV resource + selection helper.\n//\n// feat-20260630-viewport-2x2-run-x-display-redesign M2 w12 / plan-strategy D-2.\n//\n// PROBLEM (research Finding 4): the render extract stage selects the camera by\n// archetype-query FIRST-HIT (`cameras[0]`) and fires `render-system-multi-camera`\n// when more than one [Camera, Transform, Entity] entity exists. A single engine\n// world that carries BOTH an editor orbit camera AND a game camera therefore\n// cannot pick which one renders. This module adds the minimum neutral mechanism:\n// an `ActiveCamera { entity }` resource naming the entity to render through.\n//\n// ENGINE-NEUTRAL (requirements OOS-4 / AC-16): the engine knows only entity IDs.\n// It does NOT know which entity is \"editor\" or \"game\" -- the caller (editor side)\n// decides what `ActiveCamera.entity` points at. No editor concept enters this\n// file or the engine layer.\n//\n// BACKWARD COMPATIBLE (plan-strategy D-2): when the resource is ABSENT, or the\n// named entity is not among the queried cameras, selection falls back to the\n// existing first-hit behavior unchanged. Single-camera scenes are unaffected.\n//\n// Surface:\n//   - interface  ActiveCamera { entity: number }\n//   - constant   ACTIVE_CAMERA_KEY = 'ActiveCamera'\n//   - helper     getActiveCamera(world): ActiveCamera | undefined\n//   - helper     setActiveCamera(world, entity): void\n//   - pure       selectActiveCameraIndex(cameraEntities, activeEntity): number\n//\n// @new-surface KV resource: ECS has no defineResource factory; the TS POD\n//   interface + string KV key form is the minimum-new-surface route, mirroring\n//   TransparentSortConfig. The world resource store\n//   (insertResource / getResource / hasResource) is reused unchanged.\n// @derives world.hasResource / world.insertResource / world.getResource KV API.\n// @fallback getActiveCamera KV missing returns undefined; no warn; no throw\n//   (absent ActiveCamera is a legal state -> first-hit fallback in extract).\n//\n// charter mapping: F1 (single-import barrel + single entity pointer, smallest\n// concept face vs a multi-field priority/enabled scheme) + P4 (consistent\n// abstraction -- same world.{has,get,insert}Resource KV API as every other\n// engine resource consumer).\n\nimport type { World } from '@forgeax/engine-ecs';\n\n// ────────────────────────────────────────────────────────────────────────────\n// POD interface + KV key\n// ────────────────────────────────────────────────────────────────────────────\n\n/**\n * Active-camera pointer (plain-data POD). Lives as a world-level resource keyed\n * by `ACTIVE_CAMERA_KEY`. `entity` is the packed entity id (engine `EntityHandle`\n * is a branded number) of the camera the renderer should use.\n *\n * The engine treats `entity` as an opaque id; whether it names an editor camera\n * or a game camera is a caller-side decision (OOS-4 — engine stays neutral).\n */\nexport interface ActiveCamera {\n  readonly entity: number;\n}\n\n/** World resource key for the `ActiveCamera` KV entry. */\nexport const ACTIVE_CAMERA_KEY = 'ActiveCamera' as const;\n\n// ────────────────────────────────────────────────────────────────────────────\n// Helpers\n// ────────────────────────────────────────────────────────────────────────────\n\n/**\n * Read the world's `ActiveCamera` resource.\n *\n * @fallback KV missing returns `undefined` — absent ActiveCamera is a legal\n * state (the renderer falls back to archetype first-hit). NO warn, NO throw.\n * The `hasResource` guard precedes the read so this helper never trips\n * `ResourceNotFoundError` from `world.getResource`.\n *\n * @example\n *   const a = getActiveCamera(world);   // undefined when not set\n *   if (a) { ... a.entity ... }\n */\nexport function getActiveCamera(world: World): ActiveCamera | undefined {\n  if (!world.hasResource(ACTIVE_CAMERA_KEY)) return undefined;\n  return world.getResource<ActiveCamera>(ACTIVE_CAMERA_KEY);\n}\n\n/**\n * Write the world's `ActiveCamera` resource (idempotent last-write-wins via\n * `world.insertResource`). The renderer will use the camera whose entity id\n * equals `entity`, or fall back to first-hit if that id is not a queried camera.\n *\n * @example\n *   setActiveCamera(world, gameCameraEntity);  // render through the game camera\n */\nexport function setActiveCamera(world: World, entity: number): void {\n  world.insertResource<ActiveCamera>(ACTIVE_CAMERA_KEY, { entity });\n}\n\n/**\n * Pure selection: given the entity ids of every camera surfaced by the extract\n * archetype query (in query order) and the optional active-camera entity id,\n * return the index of the active camera in `cameraEntities`, or `-1` to signal\n * \"no selection — use first-hit fallback\".\n *\n * `-1` is returned when `activeEntity` is `undefined` (resource absent) OR when\n * the id is not present among `cameraEntities` (stale / non-camera entity).\n * Both cases preserve the existing first-hit behavior (plan-strategy D-2).\n *\n * @example\n *   selectActiveCameraIndex([10, 20, 30], 20) === 1   // pick the 2nd camera\n *   selectActiveCameraIndex([10, 20, 30], undefined) === -1  // first-hit\n *   selectActiveCameraIndex([10, 20, 30], 999) === -1        // first-hit\n */\nexport function selectActiveCameraIndex(\n  cameraEntities: readonly number[],\n  activeEntity: number | undefined,\n): number {\n  if (activeEntity === undefined) return -1;\n  return cameraEntities.indexOf(activeEntity);\n}\n"]}

package/dist/chunk-IPXCABEP.mjs

@@ -0,0 +1,73 @@
+import { vec3 } from '@forgeax/engine-math';
+
+// src/record/frame-snapshot.ts
+function worldEntityKey(worldId, entityKey) {
+  return worldId * 4294967296 + entityKey;
+}
+var ZERO_CAMERA_CLEAR_FALLBACK = [0, 0, 0, 1];
+var textureIdentities = /* @__PURE__ */ new WeakMap();
+var nextTextureIdentity = 1;
+function getTextureIdentity(texture) {
+  const object = texture;
+  const existing = textureIdentities.get(object);
+  if (existing !== void 0) return existing;
+  const identity = nextTextureIdentity++;
+  textureIdentities.set(object, identity);
+  return identity;
+}
+function validateGraphTargetCaptureReadback(input) {
+  const { bytes, expectedByteLength, sentinel } = input;
+  if (bytes.byteLength !== expectedByteLength)
+    return { ok: false, code: "capture-readback-length" };
+  if (sentinel?.every((value, index) => bytes[index] === value)) {
+    return { ok: false, code: "capture-readback-untouched-sentinel" };
+  }
+  if (bytes.every((value) => value === 0)) return { ok: false, code: "capture-readback-empty" };
+  for (let index = 0; index + 1 < bytes.length; index += 2) {
+    const exponent = (bytes[index + 1] ?? 0) >>> 2 & 31;
+    if (exponent === 31) return { ok: false, code: "capture-readback-non-finite" };
+  }
+  return { ok: true };
+}
+function makeZeroCameraFallbackSnapshot() {
+  const identityWorld = new Float32Array(16);
+  identityWorld[0] = 1;
+  identityWorld[5] = 1;
+  identityWorld[10] = 1;
+  identityWorld[15] = 1;
+  return {
+    position: vec3.create(0, 0, 0),
+    world: identityWorld,
+    fov: Math.PI / 4,
+    aspect: 1,
+    near: 0.1,
+    far: 100,
+    // feat-20260613 M6 / w20: synthetic camera defaults to perspective so
+    // the CSM extract path stays consistent with the previously-implicit
+    // perspective shape (unchanged behavior; explicit field).
+    projection: "perspective",
+    orthoLeft: -1,
+    orthoRight: 1,
+    orthoBottom: -1,
+    orthoTop: 1,
+    tonemap: "none",
+    exposure: 1,
+    whitePoint: 4,
+    antialias: "none",
+    bloom: "off",
+    bloomThreshold: 1,
+    bloomIntensity: 1,
+    bloomBlurRadius: 4,
+    clearColor: ZERO_CAMERA_CLEAR_FALLBACK
+  };
+}
+function clampPcfKernelSize(value) {
+  if (value === void 0) return 3;
+  if (value <= 1) return 1;
+  if (value <= 3) return 3;
+  return 5;
+}
+
+export { clampPcfKernelSize, getTextureIdentity, makeZeroCameraFallbackSnapshot, validateGraphTargetCaptureReadback, worldEntityKey };
+//# sourceMappingURL=chunk-IPXCABEP.mjs.map
+//# sourceMappingURL=chunk-IPXCABEP.mjs.map

package/dist/chunk-IPXCABEP.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/record/frame-snapshot.ts"],"names":[],"mappings":"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","file":"chunk-IPXCABEP.mjs","sourcesContent":["// @forgeax/engine-runtime - RenderSystem record stage: frame-snapshot.\n// Extracted from render-system-record.ts (feat-20260704 M3/w17, pure move).\n\nimport type { World } from '@forgeax/engine-ecs';\nimport { vec3 } from '@forgeax/engine-math';\nimport type { ResolvedColorTargetDescriptor } from '@forgeax/engine-render-graph';\nimport type { Texture } from '@forgeax/engine-rhi';\nimport type { ClusterBinScratch } from '../cluster-binner';\nimport type { EnvironmentGeneration } from '../environment/generation';\nimport type { EnvironmentLifecycle } from '../environment/lifecycle';\nimport type { GpuBuffer } from '../gpu-resource';\nimport type { TemporalGpuState } from '../temporal/gpu';\nimport type { TemporalView } from '../temporal/view';\n\nexport type TemporalCommitOutcome =\n  | { readonly kind: 'none' }\n  | { readonly kind: 'off'; readonly view: TemporalView }\n  | { readonly kind: 'taa'; readonly view: TemporalView };\n\n/**\n * feat-20260708-composited-multi-world-rendering M1 / D-1 / D-9:\n * worldId-entityKey composite key helper. Formula: `worldId * 2^32 + entityKey`.\n *\n * worldId is the index into `worlds[]` (the `draw` call argument). entityKey\n * is the packed Entity u32 (encodeEntity(indexSlot, generation)) surfaced\n * through `RenderableSnapshot.entityKey`.\n *\n * Key properties:\n *   - worldId=0 identity: `worldEntityKey(0, k) === k` — single-world path\n *     cache behavior is bit-for-bit unchanged (AC-03 regression guarantee).\n *   - JS safe integer: worldId < 2^21 keeps the composite key below\n *     Number.MAX_SAFE_INTEGER (2^53).\n *   - SSOT: all cache-key compositing consumers import this single helper;\n *     no inline `worldId * 2^32 + k` duplication (D-9).\n *\n * @internal — exported for unit test + glyph/tilemap/record consumers;\n * not part of the public @forgeax/engine-runtime API surface.\n */\nexport function worldEntityKey(worldId: number, entityKey: number): number {\n  return worldId * 4294967296 + entityKey; // 2^32 = 4294967296\n}\n\n/**\n * Cross-frame cache entry for a material bind group whose source material and\n * all resolved GPU resources are stable. The material snapshot identity is\n * the extract-layer invalidation token; the builder only stores entries after\n * all explicit resource handles resolved to resident GPU objects.\n */\nexport interface MaterialBgAssemblyCacheEntry {\n  readonly material: MaterialSnapshot;\n  /** Invalidates when a texture/sampler residency identity changes. */\n  readonly materialResourceEpoch: number;\n  readonly materialBgl: BindGroupLayout;\n  /** Buffer identity changes when the shared material capacity grows. */\n  readonly materialBuffer: Buffer;\n  readonly skylightResources: SkylightBindGroupResources;\n  readonly bindGroup: BindGroup;\n}\n\nimport type { CompiledRenderGraph } from '@forgeax/engine-render-graph';\nimport type { BindGroup, BindGroupLayout, Buffer, TextureView } from '@forgeax/engine-rhi';\nimport type { MaterialRenderState, RenderPipelineAsset } from '@forgeax/engine-types';\nimport type { MeshGpuHandles } from '../device/gpu-residency';\nimport type { SkylightBindGroupResources } from '../ibl/skylight-bind-group';\nimport type { InstanceBufferCacheEntry } from '../instance-buffer-cache';\nimport type { CameraSnapshot } from '../render-contract';\nimport type { RenderPipeline as RenderPipelineDef, RenderPipelineFrame } from '../render-pipeline';\nimport type {\n  DispatchEntry,\n  MaterialSnapshot,\n  PointShadowSnapshot,\n  RenderableSnapshot,\n  SpotLightSnapshot,\n} from '../render-system-extract';\nimport type { ShadowAtlas } from '../shadow-atlas';\n\n/**\n * feat-20260608-create-app-param-surface-trim / M1 / D-8 (q8 user lock):\n * fallback clear color when the world carries no Camera entity. Opaque\n * black `[0, 0, 0, 1]`, replacing the historical\n * `[0.06, 0.06, 0.08, 1.0]` dark-slate sentinel. Single SSOT consumed by\n * the synthetic CameraSnapshot built when `cameras.length === 0`\n * (Case B in `recordFrame`) and read directly by tests\n * (`zero-camera-clear-fallback.test.ts`). AC-05.\n */\nexport const ZERO_CAMERA_CLEAR_FALLBACK: readonly [number, number, number, number] = [0, 0, 0, 1];\n\nexport interface FrameObservationSource {\n  readonly texture: Texture;\n  readonly descriptor: ResolvedColorTargetDescriptor;\n  readonly frameId: number;\n  readonly pipelineId: 'forgeax::standard';\n  readonly backendId: string;\n}\n\n/** Internal test/diagnostic view of one compiled graph color target. */\nexport interface CurrentGraphTarget {\n  readonly name: string;\n  readonly texture: Texture;\n  /** Stable opaque identity for this RHI handle during the renderer lifetime. */\n  readonly textureIdentity: number;\n  readonly descriptor: ResolvedColorTargetDescriptor;\n  readonly frameId: number;\n  /** Monotonic identity of the compiled graph that owns this texture. */\n  readonly graphGeneration: number;\n}\n\nconst textureIdentities = new WeakMap<object, number>();\nlet nextTextureIdentity = 1;\n\n/**\n * Project an opaque RHI texture handle to a stable diagnostic identity.\n * RHI handles intentionally expose no serializable fields; object identity is\n * the only valid comparison boundary for a copy-time capture.\n */\nexport function getTextureIdentity(texture: Texture): number {\n  const object = texture as object;\n  const existing = textureIdentities.get(object);\n  if (existing !== undefined) return existing;\n  const identity = nextTextureIdentity++;\n  textureIdentities.set(object, identity);\n  return identity;\n}\n\nexport type GraphTargetCaptureReadbackValidation =\n  | { readonly ok: true }\n  | {\n      readonly ok: false;\n      readonly code:\n        | 'capture-readback-length'\n        | 'capture-readback-untouched-sentinel'\n        | 'capture-readback-empty'\n        | 'capture-readback-non-finite';\n    };\n\n/** Validate a mapped rgba16float capture before a consumer decodes its values. */\nexport function validateGraphTargetCaptureReadback(input: {\n  readonly bytes: Uint8Array;\n  readonly expectedByteLength: number;\n  readonly sentinel?: Uint8Array;\n}): GraphTargetCaptureReadbackValidation {\n  const { bytes, expectedByteLength, sentinel } = input;\n  if (bytes.byteLength !== expectedByteLength)\n    return { ok: false, code: 'capture-readback-length' };\n  if (sentinel?.every((value, index) => bytes[index] === value)) {\n    return { ok: false, code: 'capture-readback-untouched-sentinel' };\n  }\n  if (bytes.every((value) => value === 0)) return { ok: false, code: 'capture-readback-empty' };\n  for (let index = 0; index + 1 < bytes.length; index += 2) {\n    const exponent = ((bytes[index + 1] ?? 0) >>> 2) & 0x1f;\n    if (exponent === 0x1f) return { ok: false, code: 'capture-readback-non-finite' };\n  }\n  return { ok: true };\n}\n\n/** Internal readback request consumed by the record encoder in the same submit. */\nexport interface GraphTargetCaptureRequest {\n  readonly name: string;\n  readonly buffer: Buffer;\n  readonly bytesPerRow: number;\n  readonly width: number;\n  readonly height: number;\n  /** Descriptor contract checked against the resolved target at copy time. */\n  readonly expected: {\n    readonly format: ResolvedColorTargetDescriptor['format'];\n    readonly width: number;\n    readonly height: number;\n    readonly usage: number;\n    /** Optional caller binding; when present it is checked at copy time. */\n    readonly identity?: {\n      readonly graphGeneration: number;\n      readonly frameId: number;\n      readonly textureIdentity: number;\n    };\n  };\n}\n\n/**\n * Build a synthetic CameraSnapshot the record stage uses when the world\n * carries no Camera entity. Identity-shaped projection / view inputs\n * keep the existing matrix math numerically stable; clear-color quartet\n * sourced from `ZERO_CAMERA_CLEAR_FALLBACK` so the swap-chain still\n * paints `[0, 0, 0, 1]` (AI-user friendly observable signal that the\n * `'render-system-no-camera'` diagnostic fired without leaving stale\n * pixels on screen).\n */\nexport function makeZeroCameraFallbackSnapshot(): CameraSnapshot {\n  // Identity world mat4 so `mat4.invert(world)` yields identity view.\n  const identityWorld = new Float32Array(16);\n  identityWorld[0] = 1;\n  identityWorld[5] = 1;\n  identityWorld[10] = 1;\n  identityWorld[15] = 1;\n  return {\n    position: vec3.create(0, 0, 0),\n    world: identityWorld,\n    fov: Math.PI / 4,\n    aspect: 1,\n    near: 0.1,\n    far: 100,\n    // feat-20260613 M6 / w20: synthetic camera defaults to perspective so\n    // the CSM extract path stays consistent with the previously-implicit\n    // perspective shape (unchanged behavior; explicit field).\n    projection: 'perspective',\n    orthoLeft: -1,\n    orthoRight: 1,\n    orthoBottom: -1,\n    orthoTop: 1,\n    tonemap: 'none',\n    exposure: 1.0,\n    whitePoint: 4.0,\n    antialias: 'none',\n    bloom: 'off',\n    bloomThreshold: 1.0,\n    bloomIntensity: 1.0,\n    bloomBlurRadius: 4.0,\n    clearColor: ZERO_CAMERA_CLEAR_FALLBACK,\n  };\n}\n\n// feat-20260621-merge-directionallightshadow-into-directionallight M3 / m3-t2\n// (D-7): host-clamp the merged DirectionalLight's pcfKernelSize to the nearest\n// valid odd kernel in {1,3,5} before it reaches the View UBO float [128].\n// lighting-directional.wgsl runs a constant-trip-count loop to MAX_PCF_HALF=2\n// (merged 5.3-production-shadow-demos AC-14 variant-free pattern) and clips each\n// iteration to half = (pcfKernelSize-1)/2, so the supported kernel set is\n// {1,3,5} (cap 5). undefined (no shadow fields) defaults to 3.\nexport function clampPcfKernelSize(value: number | undefined): number {\n  if (value === undefined) return 3;\n  if (value <= 1) return 1;\n  if (value <= 3) return 3;\n  return 5;\n}\n\n/**\n * Per-RenderSystem mutable frame state.\n *\n * Owned by the `createRenderSystem` closure; advanced once per\n * `recordFrame` invocation. The `instanceBuffers` map holds the per-entity\n * GPU storage buffers for Instances-bearing entities (cache key = the\n * packed Entity u32 surfaced via `InstancesSnapshot.cacheKey`); entries\n * are recreated when the `archVersion` bumps or `byteLength` changes.\n *\n * feat-20260518-pbr-direct-lighting-mvp M3 / w14 (AC-17 a): the\n * `warnedZeroLightStandard` flag latches the first-frame warning that\n * fires when the world contains a StandardMaterial entity but zero\n * DirectionalLight entries — once latched the next 100 frames suppress\n * the warning so the AI user is not flooded with repeated noise (charter\n * P3 silent failure -> explicit warning at most once per RenderSystem\n * lifetime).\n */\nexport interface RenderFrameState {\n  frameNumber: number;\n  /** Monotonic compiled-graph identity used by diagnostic readbacks. */\n  graphGeneration: number;\n  /** Number of successfully submitted TAA frames; failed attempts do not advance it. */\n  successfulTemporalFrameIndex?: number;\n  /** Optional graph resource lookup used by low-level record helpers and tests. */\n  perFrameGraph?: {\n    readonly getColorTargetDescriptor: (key: string) => ResolvedColorTargetDescriptor | undefined;\n    readonly getColorTargetView: (key: string) => TextureView | undefined;\n    readonly getColorTargetTexture: (key: string) => Texture | undefined;\n    readonly graphGeneration: number;\n  } | null;\n  graphTargetCapture?: GraphTargetCaptureRequest | undefined;\n  /** Last successfully rendered static directional shadow atlas token. */\n  directionalShadowCache: DirectionalShadowCache | null;\n  /** Last successfully submitted camera post-process mode. */\n  lastSuccessfulBloom: 'off' | 'on';\n  /** Bloom record receipts staged by this frame; cleared on abort. */\n  bloomFrameReceipts?: BloomFrameReceipts | undefined;\n  /** Set by a directional shadow pass when this frame refreshed the atlas. */\n  directionalShadowCacheRecorded: boolean;\n  /** The sole compiled owner for compute, copy, feature, and raster work. */\n  compiledFrameGraph: CompiledRenderGraph<RenderPipelineFrame> | null;\n  compiledFrameGraphTopologyKey: string | null;\n  readonly retiredCompiledFrameGraphs: Set<CompiledRenderGraph<RenderPipelineFrame>>;\n  /** Physical outputs projected by typed graph passes for downstream observers. */\n  currentFrameObservationSource: FrameObservationSource | undefined;\n  /** Camera antialias mode for the last successfully submitted graph. */\n  lastSuccessfulCameraAntialias: CameraSnapshot['antialias'] | undefined;\n  /** Staged TAA GPU state is promoted only after queue.submit succeeds. */\n  temporalGpuState: TemporalGpuState | undefined;\n  /** Last successful TAA GPU state; candidate replacement stays staged until submit. */\n  activeTemporalGpuState: TemporalGpuState | undefined;\n  /** Submitted temporal generations retained until their queue fence resolves. */\n  readonly retiringTemporalGpuStates: Set<TemporalGpuState>;\n  /** Last successful projection; candidate frames never overwrite it. */\n  lastSuccessfulTemporalView: TemporalView | undefined;\n  pendingTemporalCommit: TemporalCommitOutcome;\n  /** Staged environment generation is promoted only after queue.submit succeeds. */\n  environmentGeneration: EnvironmentGeneration | undefined;\n  readonly environmentLifecycle: EnvironmentLifecycle | undefined;\n  currentDirectionalShadowView: TextureView | null;\n  currentSpotShadowView: TextureView | null;\n  readonly instanceBuffers: Map<number, InstanceBufferCacheEntry>;\n  /** Per-entity vertex buffers for the Standard CPU morph lane. */\n  readonly morphBuffers?: Map<number, MorphBufferCacheEntry>;\n  readonly hdrpClusterBinScratch: ClusterBinScratch;\n  /** Reusable HDRP cluster output buffers; sized once and grown only if the grid/cap changes. */\n  hdrpClusterGridScratch: Uint32Array | null;\n  hdrpLightIndexListScratch: Uint32Array | null;\n  /** Compute bind group for the optional WebGPU HDRP membership producer. */\n  hdrpClusterMembershipBindGroup: BindGroup | null;\n  transientInstanceBuffers: InstanceBufferCacheEntry[];\n  warnedZeroLightStandard: boolean;\n  /**\n   * feax-20260608-multi-light-warn-once M3: once-warn latch for multi-light\n   * overrun per bucket (directional N>1 / point N>4 / spot N>4). Fires at\n   * most once per RenderSystem lifetime per bucket so AI users see a single\n   * actionable console.warn without per-frame flooding (charter P3 explicit\n   * failure: warn-once preserves signal/noise floor).\n   */\n  warnedMultiLightDirectional: boolean;\n  warnedMultiLightPoint: boolean;\n  warnedMultiLightSpot: boolean;\n  /**\n   * feat-20260630-equirect-kind-internalized-ibl-declarative-skyligh M3 / w19:\n   * once-warn latches for >1 Skylight / >1 SkyboxBackground entity. Fire at most\n   * once per RenderSystem lifetime so the multi-entity warn (which names the\n   * winning entity handle, F-8) does not flood the console every frame.\n   */\n  warnedMultiSkylight: boolean;\n  warnedMultiSkybox: boolean;\n  /** feat-20260531-skybox-env-background M3 / w20: once-warn when camera\n   * tonemap is 'none' but a SkyboxBackground entity exists. Skybox needs\n   * the HDR render target allocated by the tonemap path; without it the\n   * skybox pass is skipped (plan-strategy D-2 NOTE). */\n  warnedSkyboxTonemapNone: boolean;\n  /**\n   * Per-handle warn-once anchor for the missing baseColor-texture fallback,\n   * shared by every textured material path (sprite / sprite-lit / standard-pbr\n   * / pbr-skin / unlit — feat-20260520-2d-sprite-layer-mvp M-3 / w25 seeded it\n   * for sprites; feat-future-pbr-missing-texture-fallback-explicit generalised\n   * it to PBR/skin so GLB textures that fail to reach the GPU no longer render\n   * silently flat). A `Set<number>` keyed by the raw Handle<TextureAsset> id -\n   * the writer fires `console.warn` exactly once per missing texture handle per\n   * RenderSystem lifetime so AI users see a single actionable message without\n   * per-frame log flooding. The set lives across frames so the second frame on\n   * the same missing handle stays silent (charter P3 explicit failure:\n   * warn-once preserves signal / noise floor while structured RhiError below\n   * stays per-frame fire).\n   *\n   * Note on the WeakSet/Set choice: plan-strategy mentions WeakSet but\n   * Handle values are numeric brand u32s (not object references), so\n   * WeakSet<object> is not applicable; Set<number> gives identical\n   * warn-once-per-handle semantics at zero additional cost (charter F1\n   * minimal surface; the per-RenderSystem lifetime cap is the upper\n   * bound).\n   */\n  readonly warnedMissingBaseColorTextureHandles: Set<number>;\n  /**\n   * feat-20260527-sprite-nineslice M2 / w11 + M4 / w16 (AC-16): once-per-\n   * renderable guard for the `nineslice.scale-too-small` metric increment.\n   * Keyed by `renderableIndex` so the second frame on the same mis-scaled\n   * entity does NOT keep bumping the counter — AI users see one counter\n   * tick per offending entity per RenderSystem lifetime, matching the\n   * single-event semantics of the structured fail-fast (charter P3:\n   * machine-readable signal, not a per-frame inflation). M4 retired the\n   * placeholder console.warn; the increment lands on the per-Renderer\n   * EngineMetrics through `runtime.metrics.increment(...)`.\n   */\n  readonly warnedNineSliceScaleEntities: Set<number>;\n  /**\n   * feat-20260630-equirect-kind-internalized-ibl-declarative-skyligh M3 / w18:\n   * per-handle fire-once anchor for the lazy equirect-to-cubemap projection\n   * failure. A `Set<number>` keyed by the raw Handle<EquirectAsset> id - the\n   * record arm fires the structured `EquirectProjectionFailedError` exactly\n   * once per failed source per RenderSystem lifetime (the store records\n   * `status:'failed'` permanently and never retries, R-2 / AC-09; without this\n   * latch the record arm would re-fire the error every frame). The set lives\n   * across frames so the second frame on the same failed handle stays silent\n   * (charter P3: warn-once preserves signal / noise floor).\n   */\n  readonly firedEquirectProjectionFailedHandles: Set<number>;\n  /**\n   * feat-20260622-handle-to-id-allocator-elimination M1 / w3: per-frame\n   * bind group caches converted to nested WeakMap chain roots (D-3).\n   * Each root is a WeakMap<object, WeakMap<...>> walked by\n   * getOrCreateFromChain; the chain depth varies by variant\n   * (view-main = 7, mesh = 1, hdrp-unified = 5, skin = 2).\n   * Roots are stable between device recoveries and replaced when the renderer\n   * swaps to a fresh device. Chain keys are always inner buffer handles, never\n   * wrappers (D-3).\n   */\n  viewBindGroupCache: WeakMap<object, unknown>;\n  meshBindGroupCache: WeakMap<object, unknown>;\n  /**\n   * feat-20260622-handle-to-id-allocator-elimination M1 / w2: per-entity\n   * bind group caches scoped by entityKey (packed u32 as number).\n   * Outer Map<number, WeakMap<handle, ...>> lets GC collect entries for\n   * destroyed entities whose handles are unreachable; per-entity material\n   * and instances share the same two-level shape (D-1). The inner WeakMap\n   * value is opaque (`unknown`) because `getOrCreateFromChain` walks a\n   * variable-depth chain — intermediate handles map to nested WeakMaps and\n   * only the final handle maps to the variant->BindGroup leaf Map. Direct\n   * readers (HDRP shadow-instances read end) assert the leaf shape locally.\n   */\n  /**\n   * feat-20260708-composited-multi-world-rendering M1 / D-1a #2: outer Map\n   * keyed by `worldEntityKey(worldId, entityKey)`. Inner WeakMap unchanged.\n   */\n  readonly materialBgPerEntity: Map<number, WeakMap<object, unknown>>;\n  /**\n   * feat-20260708-composited-multi-world-rendering M1 / D-1a #3: outer Map\n   * keyed by `worldEntityKey(worldId, entityKey)`. Inner WeakMap unchanged.\n   */\n  readonly instancesBgPerEntity: Map<number, WeakMap<object, unknown>>;\n  /** Identity-keyed instances BGs shared across entities using the same buffer. */\n  readonly instancesBgShared: WeakMap<object, unknown>;\n  /**\n   * feat-20260622-handle-to-id-allocator-elimination M1 / w2: cross-entity\n   * shared material bind group cache (OQ-1 option A). Outer key is the\n   * material shaderId string; inner chain is a WeakMap keyed by the same\n   * handle objects used in per-entity chains. Reuses the generic\n   * `getOrCreatePerEntity` helper with outerKey string|number (D-1).\n   */\n  readonly materialBgShared: Map<string, WeakMap<object, unknown>>;\n  /** Cross-frame fast path for fully-resident, immutable material snapshots. */\n  readonly materialBgAssemblyCache: Map<string, MaterialBgAssemblyCacheEntry>;\n  /**\n   * feat-20260622-handle-to-id-allocator-elimination M1 / w2: singleton\n   * material bind group cache (D-6). Single flat Map<variant, BindGroup>\n   * for the one true singleton in production: shadow-material-singleton.\n   * shadow-instances-singleton is a test fixture fiction (research F3);\n   * no second singleton field is needed.\n   */\n  readonly singletonMaterialCache: Map<string, BindGroup>;\n  /**\n   * Post-process bind group cache: nested WeakMap chain root shared by the\n   * built-in bloom (bright / blur-H / blur-V / composite), FXAA, and HDRP SSAO\n   * (calc / blur) fullscreen passes. Each of these passes samples graph-owned\n   * transient render targets (hdrColor / ldrColor / bloom* / ssaoRaw /\n   * gbuf0 / hdrDepth); on canvas resize the graph retires the old physical\n   * textures and allocates new ones, so the bind group must be rebuilt to\n   * reference the new TextureView identity. Keying the cache on the physical\n   * TextureView (or `::tex` texture handle for passes that recreate their bound\n   * view every frame) makes invalidation automatic: a resized target yields a\n   * new key object -> WeakMap miss -> factory rebuild, and dead views are GC'd\n   * (same identity-invalidation mechanism as view/mesh caches, D-3). Replaces\n   * the pre-fix `pp.*BindGroup === null` single-slot caches that never\n   * invalidated on resize and submitted destroyed textures.\n   */\n  postProcessBgCache: WeakMap<object, unknown>;\n  /**\n   * Raw handle of the currently installed RenderPipelineAsset (0 = builtin).\n   * Installation brands the next candidate topology; the prior compiled graph\n   * remains last-known-good until the candidate compiles successfully.\n   */\n  installedPipelineHandle: number;\n  /**\n   * Active topology declaration resolved from the pipeline registry.\n   */\n  activePipeline: RenderPipelineDef;\n  /**\n   * Install-time config projected into `RenderPipelineTopology.config`.\n   */\n  installedPipelineConfig: RenderPipelineAsset['config'];\n  /**\n   * Whether the configured standard graph resolved to the clustered lane.\n   * Capability gating keeps URP forward bindings on WebGL2 fallback even\n   * when a clustered profile was requested.\n   */\n  isHdrpActive: boolean;\n  /**\n   * feat-20260608-cluster-lighting M5 / w20 + M6 / w23 + M5 / w22:\n   * once-per-frame fire dedup set for HDRP per-frame fail-soft errors\n   * (`hdrp-light-budget-exceeded`, `hdrp-index-list-overflow`). Cleared\n   * at the end of each frame so the next frame re-fires if the condition\n   * persists. Set<string> keyed by RuntimeErrorCode literal.\n   */\n  hdrpOncePerFrameFired: Set<string>;\n  /**\n   * feat-20260612-point-light-shadows-urp-hdrp M3 / T-M3-2 (plan-strategy §D-1).\n   * Lazily-allocated cube_array shadow atlas owned by the RenderSystem\n   * lifetime. `null` until the first frame whose `lights.pointShadow` is\n   * non-empty (zero-shadow scenes never allocate; AC-09). The atlas is\n   * disposed by the renderer dispose path; subsequent frames with a non-empty\n   * snapshot list re-allocate.\n   */\n  pointShadowAtlas: ShadowAtlas | null;\n  /**\n   * feat-20260612-point-light-shadows-urp-hdrp M3 / T-M3-2 (plan-strategy §D-3):\n   * per-frame projection of `lights.pointShadow` from the extract stage. The\n   * typed point-shadow pass reads this list to drive the 6 x N face iteration.\n   * Empty array means the topology declares no point-shadow passes.\n   */\n  pointShadowSnapshots: readonly PointShadowSnapshot[];\n  /**\n   * feat-20260622-chunk-gpu-instancing-sprite-tilemap M1 / w4 (D-1):\n   * last fold-pass output, computed at `recordFrame` entry from the\n   * transparent-sort-ordered dispatch + mode-gate (D-5: only mode 0\n   * folds; other modes yield singleton buckets). Currently an\n   * observational compute — the drawIndexed swap (1 instanced draw per\n   * fold bucket) is the follow-on integration that wires each bucket\n   * into the sprite-pass / geometry-pass dispatch loops. The bucket\n   * count is the source of truth for `render.instancing.foldedDraws`\n   * metric (M3 / w13) — every fold-eligible bucket (bucketSize >= 1\n   * under mode 0 AND not bypassed) contributes one increment.\n   */\n  lastFoldBucketCount: number;\n  /**\n   * feat-20260625-spot-light-shadow-mapping M2 / w9 (D-2): per-frame projection\n   * of `lights.spot` from the extract stage. The typed spot-shadow graph\n   * pass reads this list to render each\n   * castShadow spot's perspective depth into its `spotShadowDepth` atlas tile\n   * (viewport keyed on `shadowAtlasTile`). `recordFrame` writes it before\n   * graph execution. Spots with `shadowAtlasTile < 0` (castShadow:false,\n   * degenerate direction, or clipped beyond cap 4) are skipped — zero\n   * shadow-casting spots means zero spot shadow passes (AC-03).\n   */\n  spotShadowSnapshots: readonly SpotLightSnapshot[];\n}\n\nexport interface MorphBufferCacheEntry {\n  readonly buffer: GpuBuffer;\n  readonly byteLength: number;\n}\n\n/**\n * feat-20260518-pbr-direct-lighting-mvp M5 / w22.11 (D-2 + D-10 + AC-06):\n * mutable per-frame dispatch counter object owned by `createRenderSystem`\n * and bumped here at the actual `pass.setPipeline(...)` call site (the\n * only point with both `mat.materialShaderId` and `mesh.layoutProjection` in scope).\n * Unlit / custom shader pipeline dispatch tracked here.\n */\nexport interface DispatchCounts {\n  unlit: number;\n  /** feat-20260523 M4-T07: 'standard' counter removed; schema-driven\n   *  materials are tracked via materialShaderId in the pipeline cache. */\n}\n\n/**\n * feat-20260531-per-frame-bind-group-cache M1 / w4: per-frame\n * createBindGroup counter. Closure-mutable object aligned with\n * DispatchCounts precedent. Reset in draw(world) entry, bumped on\n * cache-miss createBindGroup calls (M2-M4).\n */\nexport interface BindGroupCounts {\n  createBindGroup: number;\n  /**\n   * Debug-only: records the variant of every cache-miss BindGroup created via\n   * `getOrCreateFromChain` for unit-test observability. Production paths do\n   * not read this array.\n   */\n  keys: string[];\n}\n\n/**\n * Successful Bloom record operations staged for the current frame. These\n * counters are promoted only after the shared renderer queue submission.\n */\nexport interface BloomFrameReceipts {\n  readonly uploadCount: number;\n  readonly bindGroupCount: number;\n  readonly encodeCount: number;\n}\n\n/**\n * A renderable resolved against the AssetRegistry for the current frame:\n * its source snapshot, the GPU mesh handles, the row index used to correlate\n * transparent-sort output back to this entry, and an optional per-material\n * renderState override (bug-20260527-renderstate-pipeline-dispatch-gap D-4).\n * Module-scoped so RenderPipelineContext can type `validated` / `validatedOrdered`\n * without a dynamic type escape (was a recordFrame-local interface before F-4).\n */\nexport interface ValidatedRenderable {\n  readonly source: RenderableSnapshot;\n  /** World that owns the renderable's asset handles and material snapshots. */\n  readonly world?: World;\n  readonly mesh: MeshGpuHandles;\n  readonly renderableIndex: number;\n  readonly renderState: MaterialRenderState | undefined;\n  /**\n   * Canonical authored material-variant request folded from the selected\n   * pass's `defines` map. Capability axes are merged at the renderer seam;\n   * this field carries only the pass-owned selection into record.\n   */\n  readonly variantSet?: string | undefined;\n  /**\n   * w10: per-pass stencil reference value folded from\n   * {@link DispatchEntry.stencilReference} (draw-call dynamic state). The draw\n   * loop calls `pass.setStencilReference(stencilReference ?? 0)` before each\n   * draw; `undefined` falls back to the WebGPU default 0 (semantic no-op).\n   */\n  readonly stencilReference: number | undefined;\n}\n\n/**\n * Cross-frame validity token for the directional shadow atlas.\n *\n * The atlas is a render target, not authored state. Keeping its validity\n * token beside the other RenderFrameState caches lets recordFrame skip a\n * static caster submission without teaching the public render-pipeline\n * contract about caching. Every source that can change caster depth is part\n * of the token: world mutation, asset catalogue, graph/target identity, CSM\n * matrices, and the GPU mesh-residency epoch.\n *\n * @internal\n */\nexport interface DirectionalShadowCache {\n  readonly worlds: readonly World[];\n  readonly worldStateTokens: readonly DirectionalShadowWorldState[];\n  readonly assetCatalogEpoch: number;\n  readonly pipelineHandle: number;\n  readonly graphTopologyKey: string | null;\n  readonly shadowMapSize: number;\n  readonly cascadeCount: number;\n  readonly lightViewProj: readonly Float32Array[];\n  readonly meshResidencyEpoch: number;\n}\n\n/**\n * ECS state that can change the contents of a directional shadow map.\n *\n * The ECS-owned RenderReadLease is the only render-facing mutation boundary.\n * Its cursor is intentionally conservative: any published World change\n * invalidates the cached atlas, while render never reaches through World for\n * component-clock storage.\n */\nexport interface DirectionalShadowWorldState {\n  readonly worldIdentity: string;\n  readonly changeCursor: number;\n}\n"]}

package/dist/chunk-JDWARUOI.mjs

@@ -0,0 +1,44 @@
+import { defineComponent } from '@forgeax/engine-ecs';
+
+// src/components/sprite-animation.ts
+var SpriteAnimation = defineComponent("SpriteAnimation", {
+  frameCount: { type: "u32" },
+  frameDuration: { type: "f32" },
+  currentFrame: { type: "u32", transient: true },
+  accumDt: { type: "f32", transient: true },
+  regions: { type: "array<f32>" },
+  playbackMode: { type: "u32" }
+});
+var SpriteInstances = defineComponent("SpriteInstances", {
+  transforms: { type: "array<f32>" },
+  regions: { type: "array<f32>" }
+});
+var SpriteRegionOverride = defineComponent("SpriteRegionOverride", {
+  region: { type: "array<f32, 4>" }
+});
+var TilemapSort = Object.freeze({
+  layer: 0,
+  perCell: 1
+});
+function decodeSortScope(raw) {
+  return raw === 1 ? "per-cell" : "layer";
+}
+var TileLayer = defineComponent("TileLayer", {
+  tiles: { type: "array<u32>" },
+  layerOrder: { type: "i32", default: 0 },
+  dirty: { type: "u8", default: 0 },
+  sortScope: { type: "u8", default: 0 }
+});
+var Tilemap = defineComponent("Tilemap", {
+  cols: { type: "u32", default: 0 },
+  rows: { type: "u32", default: 0 },
+  // tileSize carries an explicit layer-2 default [1,1] (unit cell); the array
+  // layer-3 fallback is all-zero, so the default MUST be explicit (D-5).
+  tileSize: { type: "array<f32, 2>", default: new Float32Array([1, 1]) },
+  chunkSize: { type: "u32", default: 16 },
+  tileset: { type: "string" }
+});
+
+export { SpriteAnimation, SpriteInstances, SpriteRegionOverride, TileLayer, Tilemap, TilemapSort, decodeSortScope };
+//# sourceMappingURL=chunk-JDWARUOI.mjs.map
+//# sourceMappingURL=chunk-JDWARUOI.mjs.map