@forgeax/engine-render 0.1.2

package/dist/renderer.d.ts.map

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

package/dist/scene-instances/post-spawn-resolve-joints.d.ts

@@ -0,0 +1,33 @@
+import type { EntityHandle, World } from '@forgeax/engine-ecs';
+import type { SkinAsset } from '@forgeax/engine-types';
+export interface SkinJointResolver {
+    resolveSkinAsset(skeletonHandle: number): SkinAsset | undefined;
+}
+interface JointPathUnresolvedError {
+    code: 'skin-joint-path-unresolved';
+    expected: string;
+    hint: string;
+    detail: {
+        skinEntity: number;
+        path: readonly string[];
+        failedAtIndex: number;
+    };
+}
+interface SkinAssetUnresolvedError {
+    code: 'skin-asset-unresolved';
+    expected: string;
+    hint: string;
+    detail: {
+        skinEntity: number;
+        skeletonHandle: number;
+    };
+}
+type ResolveError = JointPathUnresolvedError | SkinAssetUnresolvedError;
+export declare function postSpawnResolveJoints(world: World, resolver: SkinJointResolver, spawnRoot: EntityHandle): {
+    ok: true;
+} | {
+    ok: false;
+    error: ResolveError;
+};
+export {};
+//# sourceMappingURL=post-spawn-resolve-joints.d.ts.map

package/dist/scene-instances/post-spawn-resolve-joints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-spawn-resolve-joints.d.ts","sourceRoot":"","sources":["../../src/scene-instances/post-spawn-resolve-joints.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAG/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAQvD,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;CACjE;AAED,UAAU,wBAAwB;IAChC,IAAI,EAAE,4BAA4B,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,UAAU,wBAAwB;IAChC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,KAAK,YAAY,GAAG,wBAAwB,GAAG,wBAAwB,CAAC;AAExE,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,iBAAiB,EAC3B,SAAS,EAAE,YAAY,GACtB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CA4FnD"}

package/dist/scene-utils/collect-subtree.d.ts

@@ -0,0 +1,11 @@
+import type { EntityHandle, World } from '@forgeax/engine-ecs';
+/**
+ * Walk `Children.entities` BFS from `spawnRoot` to collect all descendant
+ * entities (incl. spawnRoot itself). When a shared `visited` Set is passed,
+ * it is reused across roots for cross-root de-duplication; when omitted a
+ * fresh Set is created (single-root / backward-compat).
+ *
+ * Entities without a `Children` component surface as leaves.
+ */
+export declare function collectSubtree(world: World, spawnRoot: EntityHandle, visited?: Set<number>): Set<number>;
+//# sourceMappingURL=collect-subtree.d.ts.map

package/dist/scene-utils/collect-subtree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-subtree.d.ts","sourceRoot":"","sources":["../../src/scene-utils/collect-subtree.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAI/D;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,YAAY,EACvB,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACpB,GAAG,CAAC,MAAM,CAAC,CAkBb"}

package/dist/shadow-atlas.d.ts

@@ -0,0 +1,117 @@
+import { type RhiDevice, type Sampler, type Texture, type TextureView } from '@forgeax/engine-rhi';
+/**
+ * Construction options for {@link ShadowAtlas}.
+ */
+export interface ShadowAtlasOptions {
+    /** Per-face square size in pixels. Default 512 (PointLightShadow.mapSize default). */
+    readonly faceSize?: number;
+    /** Number of cube layers. Default 4 (= PointLightShadow cardinality cap). */
+    readonly layers?: number;
+}
+/** Default per-face square size in pixels. Mirrors PointLightShadow.mapSize default. */
+export declare const SHADOW_ATLAS_DEFAULT_FACE_SIZE = 512;
+/** Default cube layer count. Mirrors PointLightShadow cardinality cap. */
+export declare const SHADOW_ATLAS_DEFAULT_LAYERS = 4;
+/**
+ * Cube-array depth atlas for point-light shadows.
+ *
+ * Shape: `texture_depth_cube_array` (depth32float) with `layers = 4` and per-
+ * face size `faceSize x faceSize`. The cube_array sampling view feeds
+ * `@group(0) @binding(5)` in URP shaders; the per-face 2D view feeds the
+ * shadow-caster render pass attachment for one (layer, face) at a time
+ * (WebGPU forbids cube views as render-pass attachments).
+ *
+ * Construction performs no GPU work. The first `ensure()` call allocates the
+ * texture + view + sampler. `dispose()` releases everything; later `ensure()`
+ * calls re-allocate.
+ *
+ * @example Lazy allocation in the extract / record path:
+ * ```
+ * if (lights.pointShadow.length > 0) {
+ *   atlas.ensure();
+ *   for (const ps of lights.pointShadow) {
+ *     for (let face = 0; face < 6; face++) {
+ *       const view = atlas.faceView(ps.shadowAtlasLayer, face);
+ *       // ... begin shadow caster pass with `view` as the depth attachment
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare class ShadowAtlas {
+    /** Backing cube_array depth texture. `null` until `ensure()` has run. */
+    private texture;
+    /**
+     * Whole-atlas cube_array sampling view used by URP shaders that bind the
+     * atlas at `@group(0) @binding(5)`. `null` until `ensure()` has run.
+     */
+    private cubeArrayView;
+    /** Comparison sampler for `texture_depth_cube_array`. */
+    private compareSampler;
+    /** Per-face 2D depth view cache, keyed by `layer * 6 + face`. */
+    private readonly faceViews;
+    /** Per-face label cache (debug aid). Reused on re-creation. */
+    private readonly device;
+    /** Per-face square size in pixels. */
+    readonly faceSize: number;
+    /** Cube layer count. */
+    readonly layers: number;
+    constructor(device: RhiDevice, options?: ShadowAtlasOptions);
+    /**
+     * Returns `true` once the atlas texture is allocated. Used by the extract /
+     * record path to gate "no PointLightShadow → no allocation" (AC-09) — the
+     * caller calls {@link ensure} on a frame that has at least one snapshot;
+     * before that, `isAllocated()` stays `false` and tests can assert no GPU
+     * resources were created.
+     */
+    isAllocated(): boolean;
+    /**
+     * Lazy-allocate the atlas texture + cube_array sampling view + comparison
+     * sampler. Idempotent: subsequent calls are zero-cost no-ops once the
+     * resources exist.
+     *
+     * Throws (via the RHI error registry) on allocation failure. This is the
+     * only path that touches the GPU — keeping it inside one method makes the
+     * "zero-shadow scene = zero allocation" gate easy to enforce: the renderer
+     * never calls this method on a frame with no PointLightShadow entities.
+     */
+    ensure(): void;
+    /**
+     * Whole-atlas cube_array sampling view (`texture_depth_cube_array`). Returns
+     * `null` if the atlas is not yet allocated; the caller should gate on a
+     * non-null pointShadow array before calling {@link ensure} + this getter.
+     */
+    getAtlasView(): TextureView | null;
+    /**
+     * Comparison sampler (`compare: 'less'`) for cube_array depth sampling.
+     * Returns `null` if the atlas is not yet allocated.
+     */
+    getComparisonSampler(): Sampler | null;
+    /**
+     * Backing texture handle. Returns `null` if the atlas is not yet allocated.
+     */
+    getTexture(): Texture | null;
+    /**
+     * Lazy 2D depth view selecting `(layer, face)` (the caller passes
+     * `shadowAtlasLayer` from the snapshot and a face index 0..5). Used as the
+     * depth attachment of the shadow-caster render pass for one cube face.
+     *
+     * Caches per `(layer, face)` so the per-frame shadow loop pays zero
+     * `createTextureView` cost after the first allocation. Cache is cleared on
+     * {@link dispose}.
+     *
+     * @throws PointShadowAtlasUninitializedError if the atlas is not yet
+     *   allocated (caller must call {@link ensure} first).
+     * @throws PointShadowAtlasBoundsViolationError if `layer` or `face` is out
+     *   of range.
+     * @throws RhiError if the underlying `createTextureView` fails.
+     */
+    faceView(layer: number, face: number): TextureView;
+    /**
+     * Release the GPU resources and clear the per-face view cache. Idempotent;
+     * subsequent calls are zero-cost. After dispose, `isAllocated()` returns
+     * `false` and the next `ensure()` re-allocates from scratch.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=shadow-atlas.d.ts.map

package/dist/shadow-atlas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-atlas.d.ts","sourceRoot":"","sources":["../src/shadow-atlas.ts"],"names":[],"mappings":"AAiCA,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAQ7B;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wFAAwF;AACxF,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAClD,0EAA0E;AAC1E,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,WAAW;IACtB,yEAAyE;IACzE,OAAO,CAAC,OAAO,CAAwB;IACvC;;;OAGG;IACH,OAAO,CAAC,aAAa,CAA4B;IACjD,yDAAyD;IACzD,OAAO,CAAC,cAAc,CAAwB;IAC9C,iEAAiE;IACjE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,+DAA+D;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wBAAwB;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,kBAAuB;IAM/D;;;;;;OAMG;IACH,WAAW,IAAI,OAAO;IAItB;;;;;;;;;OASG;IACH,MAAM,IAAI,IAAI;IAkCd;;;;OAIG;IACH,YAAY,IAAI,WAAW,GAAG,IAAI;IAIlC;;;OAGG;IACH,oBAAoB,IAAI,OAAO,GAAG,IAAI;IAItC;;OAEG;IACH,UAAU,IAAI,OAAO,GAAG,IAAI;IAI5B;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW;IAoBlD;;;;OAIG;IACH,OAAO,IAAI,IAAI;CAShB"}

package/dist/ssao-buffers.d.ts

@@ -0,0 +1,31 @@
+import type { Buffer, Texture } from '@forgeax/engine-rhi';
+import type { RenderSystemRuntime } from './render-system';
+export declare const SSAO_UNIFORM_INTENSITY_OFFSET = 192;
+export declare const SSAO_UNIFORM_BYTES = 256;
+/**
+ * SSAO GPU resources owned by this module (plan-strategy D-1, D-4).
+ *
+ * Fields are readonly per charter P5: one resource, one owner.
+ */
+export interface SsaoBuffers {
+    /** 64 padded vec4 uniform buffer for hemisphere samples. */
+    readonly kernelBuffer: Buffer;
+    readonly kernelBytes: number;
+    /** 4x4 rgba32float noise texture for per-pixel TBN rotation. */
+    readonly noiseTexture: Texture;
+    /** SSAO uniform UBO: view (mat4) + projection (mat4) + inverseProjection (mat4). */
+    readonly uniformBuffer: Buffer;
+    readonly uniformBytes: number;
+}
+/**
+ * Lazily allocate the 3 SSAO GPU resources for `runtime`. Returns the
+ * same `SsaoBuffers` object on subsequent calls (per-RenderSystem
+ * stable identity, WeakMap).
+ *
+ * On `device.createBuffer` / `device.createTexture` failure, fires a
+ * structured error on the runtime's error registry and returns `null`.
+ *
+ * @returns SsaoBuffers on success, null if any allocation fails.
+ */
+export declare function getOrCreateSsaoBuffers(runtime: RenderSystemRuntime): SsaoBuffers | null;
+//# sourceMappingURL=ssao-buffers.d.ts.map

package/dist/ssao-buffers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssao-buffers.d.ts","sourceRoot":"","sources":["../src/ssao-buffers.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAG3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAkB3D,eAAO,MAAM,6BAA6B,MAAiC,CAAC;AAC5E,eAAO,MAAM,kBAAkB,MAAgB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gEAAgE;IAChE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,oFAAoF;IACpF,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAID;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,WAAW,GAAG,IAAI,CAwGvF"}

package/dist/ssao-config.d.ts

@@ -0,0 +1,28 @@
+import { type Result } from '@forgeax/engine-types';
+import { PostProcessError } from './post-process-errors';
+export declare const SSAO_DEFAULT_RADIUS = 0.5;
+export declare const SSAO_DEFAULT_BIAS = 0.025;
+export declare const SSAO_DEFAULT_INTENSITY = 1;
+export interface SsaoParameterConfig {
+    readonly radius?: number | undefined;
+    readonly bias?: number | undefined;
+    readonly intensity?: number | undefined;
+}
+export interface ResolvedSsaoParameters {
+    readonly radius: number;
+    readonly bias: number;
+    readonly intensity: number;
+}
+/**
+ * Apply the public defaults without deciding whether the values are valid.
+ * The record stage uses this only after the graph build has validated the
+ * active HDRP configuration, or for the disabled/default fallback payload.
+ */
+export declare function getSsaoParameters(config: SsaoParameterConfig | undefined): ResolvedSsaoParameters;
+/**
+ * Resolve and validate the SSAO configuration used by both graph routes.
+ * Invalid values remain structured PostProcessErrors instead of becoming
+ * NaNs or silently falling back to shader literals.
+ */
+export declare function resolveSsaoParameters(config: SsaoParameterConfig | undefined): Result<ResolvedSsaoParameters, PostProcessError>;
+//# sourceMappingURL=ssao-config.d.ts.map

package/dist/ssao-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssao-config.d.ts","sourceRoot":"","sources":["../src/ssao-config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AACvC,eAAO,MAAM,sBAAsB,IAAM,CAAC;AAE1C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,mBAAmB,GAAG,SAAS,GAAG,sBAAsB,CAMjG;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,mBAAmB,GAAG,SAAS,GACtC,MAAM,CAAC,sBAAsB,EAAE,gBAAgB,CAAC,CAmBlD"}

package/dist/ssao-data.d.ts

@@ -0,0 +1,34 @@
+export declare const SSAO_KERNEL_SAMPLE_COUNT = 64;
+/**
+ * Generate 64 SSAO hemisphere sample vectors (tangent-space, z >= 0).
+ *
+ * Algorithm (LO 5.9, research F1):
+ *  1. Random direction on unit sphere with z >= 0.
+ *  2. Normalize.
+ *  3. Scale by random [0,1].
+ *  4. Scale by lerp(0.1, 1.0, (i/64)^2) for quadratic falloff.
+ *
+ * Each sample is returned as a `[x, y, z]` tuple in a `Float32Array`
+ * slice — 64 slices of 3 floats each, packed contiguously for upload.
+ *
+ * @param seed Optional PRNG seed (default 0). Same seed always produces
+ *   the same kernel.
+ * @returns Array of 64 `[x, y, z]` arrays (each Float32Array length 3).
+ */
+export declare function generateSsaoKernel(seed?: number): readonly Float32Array[];
+/**
+ * Generate 4x4 noise rotation vectors (tangent-space, z = 0).
+ *
+ * Algorithm (LO 5.9, research F2):
+ *  16 vec3 vectors with random xy directions and z = 0.
+ *  Used by shader to rotate the 64-sample kernel per-pixel via
+ *  tiled sampling (REPEAT addressing).
+ *
+ * Returns a flat Float32Array of 48 floats (16 vectors x 3
+ * components each), suitable for upload as a 4x4 rgba32float texture.
+ *
+ * @param seed Optional PRNG seed (default 0).
+ * @returns Float32Array of length 48.
+ */
+export declare function generateSsaoNoise(seed?: number): Float32Array;
+//# sourceMappingURL=ssao-data.d.ts.map

package/dist/ssao-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssao-data.d.ts","sourceRoot":"","sources":["../src/ssao-data.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAqB3C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,MAAU,GAAG,SAAS,YAAY,EAAE,CA2B5E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,MAAU,GAAG,YAAY,CAShE"}

package/dist/surface-format.d.ts

@@ -0,0 +1,10 @@
+import type { RhiDevice } from '@forgeax/engine-rhi';
+export interface SwapChainFormatPair {
+    readonly storage: GPUTextureFormat;
+    readonly view: GPUTextureFormat;
+    readonly fallbackReason?: 'preferred-canvas-format-missing';
+}
+export type SurfaceBackendKind = RhiDevice['caps']['backendKind'];
+export declare function resolveSurfaceFormatPair(backendKind: SurfaceBackendKind, storage: GPUTextureFormat, view: GPUTextureFormat): SwapChainFormatPair;
+export declare function selectSwapChainFormat(storageBufferCapable: boolean): SwapChainFormatPair;
+//# sourceMappingURL=surface-format.d.ts.map

package/dist/surface-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-format.d.ts","sourceRoot":"","sources":["../src/surface-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,iCAAiC,CAAC;CAC7D;AAED,MAAM,MAAM,kBAAkB,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;AAElE,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,kBAAkB,EAC/B,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,gBAAgB,GACrB,mBAAmB,CAErB;AAED,wBAAgB,qBAAqB,CAAC,oBAAoB,EAAE,OAAO,GAAG,mBAAmB,CAkBxF"}

package/dist/systems/active-camera.d.ts

@@ -0,0 +1,53 @@
+import type { World } from '@forgeax/engine-ecs';
+/**
+ * Active-camera pointer (plain-data POD). Lives as a world-level resource keyed
+ * by `ACTIVE_CAMERA_KEY`. `entity` is the packed entity id (engine `EntityHandle`
+ * is a branded number) of the camera the renderer should use.
+ *
+ * The engine treats `entity` as an opaque id; whether it names an editor camera
+ * or a game camera is a caller-side decision (OOS-4 — engine stays neutral).
+ */
+export interface ActiveCamera {
+    readonly entity: number;
+}
+/** World resource key for the `ActiveCamera` KV entry. */
+export declare const ACTIVE_CAMERA_KEY: "ActiveCamera";
+/**
+ * Read the world's `ActiveCamera` resource.
+ *
+ * @fallback KV missing returns `undefined` — absent ActiveCamera is a legal
+ * state (the renderer falls back to archetype first-hit). NO warn, NO throw.
+ * The `hasResource` guard precedes the read so this helper never trips
+ * `ResourceNotFoundError` from `world.getResource`.
+ *
+ * @example
+ *   const a = getActiveCamera(world);   // undefined when not set
+ *   if (a) { ... a.entity ... }
+ */
+export declare function getActiveCamera(world: World): ActiveCamera | undefined;
+/**
+ * Write the world's `ActiveCamera` resource (idempotent last-write-wins via
+ * `world.insertResource`). The renderer will use the camera whose entity id
+ * equals `entity`, or fall back to first-hit if that id is not a queried camera.
+ *
+ * @example
+ *   setActiveCamera(world, gameCameraEntity);  // render through the game camera
+ */
+export declare function setActiveCamera(world: World, entity: number): void;
+/**
+ * Pure selection: given the entity ids of every camera surfaced by the extract
+ * archetype query (in query order) and the optional active-camera entity id,
+ * return the index of the active camera in `cameraEntities`, or `-1` to signal
+ * "no selection — use first-hit fallback".
+ *
+ * `-1` is returned when `activeEntity` is `undefined` (resource absent) OR when
+ * the id is not present among `cameraEntities` (stale / non-camera entity).
+ * Both cases preserve the existing first-hit behavior (plan-strategy D-2).
+ *
+ * @example
+ *   selectActiveCameraIndex([10, 20, 30], 20) === 1   // pick the 2nd camera
+ *   selectActiveCameraIndex([10, 20, 30], undefined) === -1  // first-hit
+ *   selectActiveCameraIndex([10, 20, 30], 999) === -1        // first-hit
+ */
+export declare function selectActiveCameraIndex(cameraEntities: readonly number[], activeEntity: number | undefined): number;
+//# sourceMappingURL=active-camera.d.ts.map

package/dist/systems/active-camera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-camera.d.ts","sourceRoot":"","sources":["../../src/systems/active-camera.ts"],"names":[],"mappings":"AAwCA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAMjD;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,EAAG,cAAuB,CAAC;AAMzD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,GAAG,SAAS,CAGtE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAElE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,SAAS,MAAM,EAAE,EACjC,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,MAAM,CAGR"}

package/dist/systems/pass-selector.d.ts

@@ -0,0 +1,24 @@
+import type { MaterialPass, PassSelector } from '@forgeax/engine-types';
+/**
+ * Test whether a pass's tags match a {@link PassSelector}.
+ *
+ * Matching rule (AC-05): every key in the selector must exist in the pass's
+ * `tags` and the pass's tag value must be in the selector's value list for
+ * that key. An empty selector matches every pass.
+ *
+ * @param tags The pass-level tags (free key-value pairs)
+ * @param selector The selector to match against
+ */
+export declare function matchPass(tags: Record<string, string>, selector: PassSelector): boolean;
+/**
+ * Filter passes whose tags match the given {@link PassSelector}.
+ *
+ * An empty selector matches all passes (returns the input array reference).
+ * Otherwise each pass is checked via {@link matchPass}.
+ *
+ * @param passes The material's pass descriptors
+ * @param selector The pass selector
+ * @returns Filtered array of matching passes
+ */
+export declare function selectPasses(passes: readonly MaterialPass[], selector: PassSelector): readonly MaterialPass[];
+//# sourceMappingURL=pass-selector.d.ts.map

package/dist/systems/pass-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pass-selector.d.ts","sourceRoot":"","sources":["../../src/systems/pass-selector.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAExE;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CASvF;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,QAAQ,EAAE,YAAY,GACrB,SAAS,YAAY,EAAE,CAKzB"}

package/dist/systems/skin-palette-allocator.d.ts

@@ -0,0 +1,51 @@
+import type { Mat4 } from '@forgeax/engine-math';
+import type { RhiDevice } from '@forgeax/engine-rhi';
+import type { SkinPaletteSlice } from '../render-system-extract';
+export interface SkinPaletteAllocator {
+    /**
+     * Static BG entry size for `pbr-skin-mesh-array-bgl @binding(1/2)`. Always
+     * `MAX_JOINTS * 64 = 16320`; consumers (record stage) bind this size
+     * when building the BG. Path-independent.
+     */
+    readonly bindingWindowBytes: number;
+    /**
+     * True when this allocator is in storage-path mode (single shared
+     * buffer + dynOffset). False on the uniform fallback (per-entity
+     * buffer + dynOffset always 0). Record-stage reads this only for
+     * shape assertions in tests; production code branches via
+     * `slice.buffer` identity (shared vs per-entity), not this flag.
+     */
+    readonly useStorageBuffer: boolean;
+    /**
+     * Allocate a slice for `jointCount` joints. Returns the buffer + byte
+     * offset the record stage should bind. Storage path returns the same
+     * shared buffer for every call; uniform path mints (or pool-reuses) a
+     * per-entity buffer and returns it with `byteOffset: 0`. Both paths
+     * guarantee BG validation: storage extends the shared buffer's size,
+     * uniform sizes the per-entity buffer to exactly `bindingWindowBytes`.
+     *
+     * @throws if storage path buffer would exceed
+     *         `device.limits.maxStorageBufferBindingSize`
+     */
+    allocateSlice(jointCount: number): SkinPaletteSlice;
+    /**
+     * Write joint matrices into the slice's buffer at the slice's offset.
+     * Computes M_i = jointWorldTransforms[i] * ibm[i] per joint.
+     *
+     * `jointWorlds[i]` is taken straight from `Skin.joints[i]` entity's
+     * `Transform.world` view (a 16-float column-major Float32Array
+     * written by propagateTransforms); zero recompose, premultiplies
+     * directly against the IBM.
+     */
+    writeJointPalette(slice: SkinPaletteSlice, ibms: readonly Float32Array[], jointWorlds: readonly Mat4[]): void;
+    /** Upload the renderer projection's previous successful-submit palette. */
+    writePreviousJointPalette(slice: SkinPaletteSlice, jointMatrices: Float32Array): void;
+    /**
+     * Reset for next frame. Storage path: cursor rewinds, shared buffer
+     * stays. Uniform path: per-entity buffer cursor rewinds (pool entries
+     * stay allocated and round-robin to the next frame's first entity).
+     */
+    resetForFrame(): void;
+}
+export declare function createSkinPaletteAllocator(device: RhiDevice, maxBindingSize: number, useStorageBuffer?: boolean): SkinPaletteAllocator;
+//# sourceMappingURL=skin-palette-allocator.d.ts.map

package/dist/systems/skin-palette-allocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skin-palette-allocator.d.ts","sourceRoot":"","sources":["../../src/systems/skin-palette-allocator.ts"],"names":[],"mappings":"AA6CA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,KAAK,EAAU,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAO7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAmBjE,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC;;;;;;;;;;OAUG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACpD;;;;;;;;OAQG;IACH,iBAAiB,CACf,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,SAAS,YAAY,EAAE,EAC7B,WAAW,EAAE,SAAS,IAAI,EAAE,GAC3B,IAAI,CAAC;IACR,2EAA2E;IAC3E,yBAAyB,CAAC,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,GAAG,IAAI,CAAC;IACtF;;;;OAIG;IACH,aAAa,IAAI,IAAI,CAAC;CACvB;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,MAAM,EACtB,gBAAgB,UAAO,GACtB,oBAAoB,CAqKtB"}

package/dist/systems/transparent-sort-config.d.ts

@@ -0,0 +1,91 @@
+import type { World } from '@forgeax/engine-ecs';
+import type { Result } from '@forgeax/engine-types';
+import { ResourceInvalidValueError } from '../errors';
+/**
+ * Transparent-bucket sort configuration (plain-data POD). Lives as a
+ * world-level resource keyed by `TRANSPARENT_SORT_CONFIG_KEY`.
+ *
+ * Fields:
+ *   - `mode \u2208 {0, 1, 2, 3}` selects the sort formula
+ *     (`TRANSPARENT_SORT_MODE_LAYER_Z` / `_LAYER_Y` / `_LAYER_YZ` / `_DISTANCE`).
+ *   - `yzAlpha` (mode=2 only) blends Y-axis into Z-axis: 1.0 weights
+ *     posZ equally with `posY - pivot.y * size.y` (Don't-Starve style),
+ *     0.5 weights posZ at half (isometric). mode=0 / mode=1 ignore the
+ *     field (documented charter P3 legal-default boundary).
+ */
+export interface TransparentSortConfig {
+    readonly mode: number;
+    readonly yzAlpha: number;
+}
+/** World resource key for `TransparentSortConfig` KV entry. */
+export declare const TRANSPARENT_SORT_CONFIG_KEY: "TransparentSortConfig";
+/** horizontal / side-scroller: sortValue = posZ. */
+export declare const TRANSPARENT_SORT_MODE_LAYER_Z = 0;
+/** top-down / JRPG: sortValue = -(posY - pivot.y * size.y) (foot pivot Y-sort). */
+export declare const TRANSPARENT_SORT_MODE_LAYER_Y = 1;
+/** Don't-Starve / isometric: sortValue = (posY - pivot.y * size.y) + yzAlpha * posZ. */
+export declare const TRANSPARENT_SORT_MODE_LAYER_YZ = 2;
+/** 3D distance: sortValue = -(dist^2) to cameraPos, back-to-front (far first). */
+export declare const TRANSPARENT_SORT_MODE_DISTANCE = 3;
+/**
+ * Read the world's `TransparentSortConfig` resource.
+ *
+ * @fallback KV missing returns `{ mode: 0, yzAlpha: 1.0 }`
+ * (`TRANSPARENT_SORT_MODE_LAYER_Z`, horizontal-z safe default).
+ * NO warn, NO throw — KV missing is a legal state (not an error state),
+ * mirroring how a sprite-free scene is a legal state for the renderer
+ * even though render-system has a transparent bucket. plan-strategy D-2:
+ * `hasResource` guard precedes the read so this helper never trips
+ * `ResourceNotFoundError` from `world.getResource`.
+ *
+ * @example
+ *   const cfg = getTransparentSortConfig(world);
+ *   // cfg.mode === 0, cfg.yzAlpha === 1.0 when no resource inserted.
+ *
+ * @example
+ *   world.insertResource(TRANSPARENT_SORT_CONFIG_KEY,
+ *     { mode: TRANSPARENT_SORT_MODE_LAYER_Y, yzAlpha: 1.0 });
+ *   const cfg = getTransparentSortConfig(world);
+ *   // cfg.mode === 1, cfg.yzAlpha === 1.0 (yzAlpha ignored by mode=1).
+ */
+export declare function getTransparentSortConfig(world: World): TransparentSortConfig;
+/**
+ * Write the world's `TransparentSortConfig` resource, validating `mode`.
+ *
+ * Returns `Result<void, ResourceInvalidValueError>`:
+ *
+ *   - `ok` — mode is in `{0, 1, 2, 3}`; the resource is inserted /
+ *     overwritten via `world.insertResource`.
+ *   - `err` — mode is out of range; the resource is NOT mutated;
+ *     `err.error` is a `ResourceInvalidValueError` instance carrying:
+ *       `.code === 'resource-invalid-value'`
+ *       `.expected === 'mode \u2208 {0, 1, 2, 3}'`
+ *       `.hint === '0=layer-z, 1=layer-y, 2=layer-yz, 3=distance'`
+ *       `.detail.receivedMode === <the rejected mode>`
+ *
+ * @fallback mode out-of-range is NEVER silently coerced to mode=0 —
+ * `Result.err` is the only fail-mode (charter P3 structured failure).
+ * AI users read `.code / .expected / .hint / .detail` properties to
+ * self-repair, NOT the human-readable `.message` string.
+ *
+ * @fallback yzAlpha range is intentionally not validated; mode=0 / mode=1
+ * ignore the field, mode=2 reads it. The silent-ignore is the
+ * documented charter P3 "legal default" boundary (plan-strategy D-4 +
+ * AC-18 path (3) carve-out).
+ *
+ * @example success path:
+ *   const r = setTransparentSortConfig(world,
+ *     { mode: TRANSPARENT_SORT_MODE_LAYER_YZ, yzAlpha: 0.5 });
+ *   if (!r.ok) return r;
+ *
+ * @example failure path:
+ *   const r = setTransparentSortConfig(world, { mode: 99, yzAlpha: 1.0 });
+ *   if (!r.ok) {
+ *     // r.error.code === 'resource-invalid-value'
+ *     // r.error.expected === 'mode \u2208 {0, 1, 2, 3}'
+ *     // r.error.hint === '0=layer-z, 1=layer-y, 2=layer-yz, 3=distance'
+ *     // r.error.detail.receivedMode === 99
+ *   }
+ */
+export declare function setTransparentSortConfig(world: World, cfg: TransparentSortConfig): Result<void, ResourceInvalidValueError>;
+//# sourceMappingURL=transparent-sort-config.d.ts.map

package/dist/systems/transparent-sort-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transparent-sort-config.d.ts","sourceRoot":"","sources":["../../src/systems/transparent-sort-config.ts"],"names":[],"mappings":"AA0DA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAMtD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,+DAA+D;AAC/D,eAAO,MAAM,2BAA2B,EAAG,uBAAgC,CAAC;AAE5E,oDAAoD;AACpD,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAE/C,mFAAmF;AACnF,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAE/C,wFAAwF;AACxF,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAEhD,kFAAkF;AAClF,eAAO,MAAM,8BAA8B,IAAI,CAAC;AA8BhD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,qBAAqB,CAK5E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,qBAAqB,GACzB,MAAM,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAczC"}