@forgeax/engine-render 0.1.28 → 0.1.30

package/dist/ssr/admission.d.ts.map

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

package/dist/ssr/compose.d.ts

@@ -0,0 +1,13 @@
+import type { GraphBuffer, GraphTextureView, RenderGraphBuilder } from '@forgeax/engine-render-graph';
+import type { RenderPipelineFrame, RenderPipelineTarget } from '../render-pipeline';
+/** Material response is produced with the visible surface; composition never
+ * redraws that surface, so equal-depth overlaps cannot apply the delta twice. */
+export declare function addSsrCompositionPass(graph: RenderGraphBuilder<RenderPipelineFrame>, input: {
+    readonly scene: RenderPipelineTarget;
+    readonly radiance: GraphTextureView;
+    readonly fallback: GraphTextureView;
+    readonly response: GraphTextureView;
+    readonly normal: GraphTextureView;
+    readonly view: GraphBuffer;
+}): import("@forgeax/engine-types").Result<void, import("@forgeax/engine-render-graph").RenderGraphError>;
+//# sourceMappingURL=compose.d.ts.map

package/dist/ssr/compose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/ssr/compose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,8BAA8B,CAAC;AAMtC,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEpF;iFACiF;AACjF,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,EAC9C,KAAK,EAAE;IACL,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B,yGAwHF"}

package/dist/ssr/errors.d.ts

@@ -35,5 +35,40 @@ export interface SsrAdmissionError {
     readonly hint: string;
     readonly detail: SsrAdmissionErrorDetail;
 }
+/** Closed authoring fields accepted by the ScreenSpaceReflection schema. */
+export type SsrConfigField = 'maxDistance' | 'thickness' | 'maxRoughness';
+/** Dynamic finite range returned by ScreenSpaceReflection validation. */
+export interface SsrConfigRange {
+    readonly min: number;
+    readonly minInclusive: boolean;
+    readonly max: number;
+    readonly maxInclusive: boolean;
+}
+/** Structured invalid-authoring failure; callers branch on code and detail. */
+export interface SsrConfigInvalidError {
+    readonly code: 'ssr-config-invalid';
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: {
+        readonly field: SsrConfigField;
+        readonly value: number;
+        readonly range: SsrConfigRange;
+    };
+}
+/** Closed spatial admission reasons. */
+export type SsrSpatialUnavailableReason = 'lane-unsupported' | 'projection-unsupported' | 'scene-input-unavailable' | 'capability-unavailable' | 'format-unavailable' | 'temporal-unavailable' | 'reflection-fallback-unavailable' | 'recovery-unavailable';
+/** Structured spatial admission failure with bounded actual facts. */
+export interface SsrUnavailableError {
+    readonly code: 'ssr-unavailable';
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: {
+        readonly lane: string;
+        readonly reason: SsrSpatialUnavailableReason;
+        readonly required: readonly string[];
+        readonly actual: Readonly<Record<string, boolean | number | string>>;
+        readonly recovery: string;
+    };
+}
 export declare function createSsrAdmissionError(detail: SsrAdmissionErrorDetail): SsrAdmissionError;
 //# sourceMappingURL=errors.d.ts.map

package/dist/ssr/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/ssr/errors.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,MAAM,MAAM,qBAAqB,GAC7B,mBAAmB,GACnB,qCAAqC,GACrC,wBAAwB,GACxB,0BAA0B,GAC1B,+BAA+B,GAC/B,mBAAmB,CAAC;AAExB,MAAM,MAAM,sBAAsB,GAC9B,SAAS,GACT,cAAc,GACd,aAAa,GACb,WAAW,GACX,SAAS,GACT,OAAO,CAAC;AAEZ,MAAM,MAAM,uBAAuB,GAC/B;IACE,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,qCAAqC,CAAC;IACrD,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;CACvF,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;CACtC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,+BAA+B,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,aAAa,CAAC;CACpF,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEN,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;CAC1C;AAID,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,CAc1F"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/ssr/errors.ts"],"names":[],"mappings":"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"}

package/dist/ssr/graph.d.ts

@@ -0,0 +1,60 @@
+import type { GraphBuffer, GraphTextureView, RenderGraphBuilder, RenderGraphFrame } from '@forgeax/engine-render-graph';
+import { RenderGraphError } from '@forgeax/engine-render-graph';
+import { type Result } from '@forgeax/engine-types';
+import type { SsrSpatialAdmission } from './admission';
+import { type SsrSpatialResources } from './resources';
+export declare const SSR_TRACE_COARSE_STEPS: 48;
+export declare const SSR_TRACE_REFINE_STEPS: 5;
+export interface SsrTracePlan {
+    readonly resolution: 'half';
+    readonly coarseSteps: typeof SSR_TRACE_COARSE_STEPS;
+    readonly refineSteps: typeof SSR_TRACE_REFINE_STEPS;
+}
+export declare function buildSsrTracePlan(): SsrTracePlan;
+export interface SsrConfidenceFactors {
+    readonly hit: number;
+    readonly thickness: number;
+    readonly facing: number;
+    readonly edge: number;
+    readonly roughness: number;
+    readonly temporal: number;
+}
+/** Compute the bounded product used by the spatial trace result. */
+export declare function computeSsrConfidence(factors: SsrConfidenceFactors): number;
+export interface SsrSpatialGraphInputs {
+    readonly admission: SsrSpatialAdmission;
+    readonly width: number;
+    readonly height: number;
+    readonly depth?: GraphTextureView;
+    readonly normal?: GraphTextureView;
+    readonly scene?: GraphTextureView;
+    /** Standard temporal-v1 source metadata, needed by trace even without history. */
+    readonly currentTemporal?: GraphTextureView;
+    /** Lighting-owned exact material coverage in alpha; RGB stays with composition. */
+    readonly fallback?: GraphTextureView;
+    /** Shared Standard View UBO used to reconstruct world-space SSR rays. */
+    readonly view?: GraphBuffer;
+    /** Shared Standard temporal-v1 target plus the SSR-owned history write. */
+    readonly temporal?: {
+        readonly previousHistory: GraphTextureView;
+        readonly outputHistory: GraphTextureView;
+        readonly previousSurface: GraphTextureView;
+        readonly outputSurface: GraphTextureView;
+        readonly params: GraphBuffer;
+    };
+}
+export interface SsrSpatialGraphProjection {
+    readonly enabled: boolean;
+    readonly passNames: readonly string[];
+    readonly resources: SsrSpatialResources | undefined;
+    readonly trace: SsrTracePlan | undefined;
+}
+/**
+ * Project the M1 spatial chain into the caller's typed graph.
+ *
+ * A non-admitted result exits before resource creation. The graph owns all
+ * transient views and dependencies; this module never creates an encoder,
+ * queue submission, public handle, or second renderer.
+ */
+export declare function addSsrSpatialPasses<FrameCtx extends RenderGraphFrame>(graph: RenderGraphBuilder<FrameCtx>, input: SsrSpatialGraphInputs): Result<SsrSpatialGraphProjection, RenderGraphError>;
+//# sourceMappingURL=graph.d.ts.map

package/dist/ssr/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/ssr/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAGhE,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAK7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAA6B,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElF,eAAO,MAAM,sBAAsB,EAAG,EAAW,CAAC;AAClD,eAAO,MAAM,sBAAsB,EAAG,CAAU,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,OAAO,sBAAsB,CAAC;IACpD,QAAQ,CAAC,WAAW,EAAE,OAAO,sBAAsB,CAAC;CACrD;AAED,wBAAgB,iBAAiB,IAAI,YAAY,CAMhD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,oEAAoE;AACpE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAW1E;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC,kFAAkF;IAClF,QAAQ,CAAC,eAAe,CAAC,EAAE,gBAAgB,CAAC;IAC5C,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IACrC,yEAAyE;IACzE,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,QAAQ,CAAC,eAAe,EAAE,gBAAgB,CAAC;QAC3C,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAC;QACzC,QAAQ,CAAC,eAAe,EAAE,gBAAgB,CAAC;QAC3C,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAC;QACzC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;KAC9B,CAAC;CACH;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CAAC;CAC1C;AA+HD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,SAAS,gBAAgB,EACnE,KAAK,EAAE,kBAAkB,CAAC,QAAQ,CAAC,EACnC,KAAK,EAAE,qBAAqB,GAC3B,MAAM,CAAC,yBAAyB,EAAE,gBAAgB,CAAC,CA4jBrD"}

package/dist/ssr/history.d.ts

@@ -0,0 +1,97 @@
+import type { Buffer, RhiDevice, RhiError, RhiQueue, Texture, TextureDescriptor, TextureView } from '@forgeax/engine-rhi';
+import { type Result } from '@forgeax/engine-types';
+import type { DeviceScope } from '../device/device-scope';
+export declare const SSR_HISTORY_FORMAT: "rgba16float";
+export type SsrHistoryResetReason = 'first-enable' | 'resize' | 'camera-cut' | 'history-version' | 'coverage-loss' | 'reflection-generation' | 'device-recovery' | 'disable';
+export type SsrHistoryFailureStage = 'build' | 'encode' | 'finish' | 'submit';
+export type SsrHistoryState = 'first-frame' | 'stable' | 'reset' | 'aborted' | 'retiring' | 'retired' | 'disposed';
+export interface SsrHistorySlot {
+    readonly texture: Texture;
+    readonly view: TextureView;
+    readonly surfaceTexture: Texture;
+    readonly surfaceView: TextureView;
+}
+export interface SsrHistoryResources {
+    readonly width: number;
+    readonly height: number;
+    readonly halfWidth: number;
+    readonly halfHeight: number;
+    readonly bytes: number;
+    readonly descriptor: TextureDescriptor;
+    readonly slots: readonly [SsrHistorySlot, SsrHistorySlot];
+    /** One renderer-owned parameter block shared by the temporal resolve. */
+    readonly paramsBuffer: Buffer;
+    readonly childScope: DeviceScope;
+}
+export interface SsrHistoryCandidate {
+    readonly readSlot: 0 | 1 | null;
+    readonly writeSlot: 0 | 1;
+    readonly historyValid: boolean;
+}
+export interface SsrHistoryInspection {
+    readonly state: SsrHistoryState;
+    readonly width: number;
+    readonly height: number;
+    readonly halfWidth: number;
+    readonly halfHeight: number;
+    readonly format: typeof SSR_HISTORY_FORMAT;
+    readonly historyCount: 0 | 2;
+    readonly historyValid: boolean;
+    readonly readSlot: 0 | 1 | null;
+    readonly writeSlot: 0 | 1;
+    readonly activeBytes: number;
+    readonly candidateBytes: number;
+    readonly retiringBytes: number;
+    readonly resetCount: number;
+    readonly resetReason: SsrHistoryResetReason | undefined;
+    readonly lastFailure: SsrHistoryFailureStage | undefined;
+}
+export interface SsrHistoryError {
+    readonly code: 'ssr-history-unavailable' | 'ssr-history-active' | 'ssr-history-not-active' | 'ssr-history-retired';
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail?: Readonly<{
+        readonly stage?: SsrHistoryFailureStage;
+        readonly reason?: SsrHistoryResetReason;
+    }>;
+}
+/** Owns only SSR's two physical history slots; the shared coordinator owns epochs. */
+export declare class SsrHistoryOwner {
+    private readonly device;
+    private readonly scope;
+    private activeResources;
+    private readonly retiringResources;
+    private retirementFencePending;
+    private activeCandidate;
+    private readIndex;
+    private valid;
+    private state;
+    private resetReason;
+    private lastFailure;
+    private resetCount;
+    private constructor();
+    static create(input: {
+        readonly device: RhiDevice;
+        readonly scope: DeviceScope;
+        readonly width: number;
+        readonly height: number;
+    }): Result<SsrHistoryOwner, RhiError>;
+    get resources(): SsrHistoryResources;
+    beginFrame(): Result<SsrHistoryCandidate, SsrHistoryError>;
+    commitFrame(candidate: SsrHistoryCandidate): Result<void, SsrHistoryError>;
+    abortFrame(candidate: SsrHistoryCandidate, stage: SsrHistoryFailureStage): void;
+    reset(reason: SsrHistoryResetReason): void;
+    resize(width: number, height: number): Result<void, RhiError>;
+    /** Retire pending allocations after the queue's already-submitted work. */
+    retireAfterFence(queue: RhiQueue, onFailure: (cause: unknown) => void): void;
+    retire(): void;
+    dispose(): void;
+    inspect(): SsrHistoryInspection;
+}
+export declare function createSsrHistoryOwner(input: {
+    readonly device: RhiDevice;
+    readonly scope: DeviceScope;
+    readonly width: number;
+    readonly height: number;
+}): Result<SsrHistoryOwner, RhiError>;
+//# sourceMappingURL=history.d.ts.map

package/dist/ssr/history.d.ts.map

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

package/dist/ssr/hiz.d.ts

@@ -0,0 +1,37 @@
+import type { GraphExtent } from '@forgeax/engine-render-graph';
+/** The one depth format owned by the SSR spatial producer. */
+export declare const SSR_HIZ_FORMAT: "r32float";
+export interface SsrHiZExtent {
+    readonly width: number;
+    readonly height: number;
+}
+export interface SsrHiZLevelPlan extends SsrHiZExtent {
+    readonly level: number;
+}
+export interface SsrHiZPlan {
+    readonly extent: SsrHiZExtent;
+    readonly format: typeof SSR_HIZ_FORMAT;
+    readonly mipLevelCount: number;
+    readonly levels: readonly SsrHiZLevelPlan[];
+    readonly graphSize: GraphExtent;
+}
+/** Derive the physical WebGPU floor-halved mip extent, clamped to one texel. */
+export declare function nextSsrHiZMipExtent(extent: SsrHiZExtent): SsrHiZExtent;
+/** Derive the complete current-view Hi-Z descriptor without allocating a resource. */
+export declare function buildSsrHiZPlan(extent: SsrHiZExtent): SsrHiZPlan;
+/** Map an invalid or empty depth sample to the Hi-Z empty-pixel sentinel. */
+export declare function normalizeSsrHiZDepth(value: number): number;
+/**
+ * Reduce one mip level with the physical mip's complete coverage footprint.
+ *
+ * WebGPU mip dimensions are floor-halved, so a 3-wide source has a 1-wide
+ * destination. The destination cells therefore use integer normalized
+ * boundaries with a conservative ceil on the end boundary instead of
+ * assuming a fixed 2x2 footprint. Adjacent cells overlap at odd boundaries;
+ * this keeps boundary and trailing source columns/rows in the hierarchy.
+ * The empty sentinel is infinity and therefore never wins over a finite
+ * positive view-space depth. Invalid input samples are treated as empty so a
+ * malformed depth cannot introduce NaN into the hierarchy.
+ */
+export declare function reduceSsrHiZLevel(source: ArrayLike<number>, sourceExtent: SsrHiZExtent): Float32Array;
+//# sourceMappingURL=hiz.d.ts.map

package/dist/ssr/hiz.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hiz.d.ts","sourceRoot":"","sources":["../../src/ssr/hiz.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE,8DAA8D;AAC9D,eAAO,MAAM,cAAc,EAAG,UAAmB,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,cAAc,CAAC;IACvC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;CACjC;AAiBD,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAMtE;AAED,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CAkBhE;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1D;AAaD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,EACzB,YAAY,EAAE,YAAY,GACzB,YAAY,CAyBd"}

package/dist/ssr/inspection.d.ts

@@ -0,0 +1,42 @@
+import type { ScreenSpaceReflectionData } from '../components/screen-space-reflection';
+import type { ReflectionFallbackSource } from '../inspection-types';
+import type { SsrSpatialAdmission, SsrSpatialLane, SsrSpatialWork } from './admission';
+import type { SsrConfigInvalidError, SsrUnavailableError } from './errors';
+import type { SsrHistoryState } from './history';
+export type SsrSpatialInspectionFailure = SsrConfigInvalidError | SsrUnavailableError;
+export interface SsrSpatialHistoryInspection {
+    readonly state: 'not-owned' | SsrHistoryState;
+    readonly bytes: number;
+    readonly resetCount: number;
+}
+export interface SsrSpatialInspectionProjection {
+    readonly status?: SsrSpatialInspection['status'];
+    readonly coverage?: Partial<SsrSpatialInspection['coverage']>;
+    readonly history?: SsrSpatialHistoryInspection;
+    readonly passRoster?: readonly string[];
+    readonly fallbackSource?: ReflectionFallbackSource;
+    readonly failure?: SsrSpatialInspectionFailure;
+}
+/** Keep the public projection bounded even if a graph owner supplies a bad list. */
+export declare const SSR_INSPECTION_MAX_PASSES: 64;
+export interface SsrSpatialInspection {
+    readonly status: 'not-requested' | 'requested' | 'admitted' | 'fallback-only' | 'structural-only';
+    readonly lane: SsrSpatialLane;
+    readonly config: ScreenSpaceReflectionData | undefined;
+    readonly viewRange: number;
+    readonly coverage: {
+        /** Null means no GPU coverage measurement is available for this frame. */
+        readonly hitCount: number | null;
+        readonly fallbackCount: number | null;
+        readonly excludedCount: number | null;
+    };
+    readonly history: SsrSpatialHistoryInspection;
+    readonly work: SsrSpatialWork;
+    readonly passRoster: readonly string[];
+    readonly fallbackSource: ReflectionFallbackSource | undefined;
+    readonly failure: SsrSpatialInspectionFailure | undefined;
+}
+/** Project only detached, bounded facts from the spatial admission result. */
+export declare function projectSsrSpatialInspection(admission: SsrSpatialAdmission, projection?: SsrSpatialInspectionProjection): SsrSpatialInspection;
+export declare function serializeSsrSpatialInspection(inspection: SsrSpatialInspection): string;
+//# sourceMappingURL=inspection.d.ts.map

package/dist/ssr/inspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspection.d.ts","sourceRoot":"","sources":["../../src/ssr/inspection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AACvF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACvF,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,MAAM,MAAM,2BAA2B,GAAG,qBAAqB,GAAG,mBAAmB,CAAC;AAEtF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,eAAe,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,OAAO,CAAC,EAAE,2BAA2B,CAAC;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,wBAAwB,CAAC;IACnD,QAAQ,CAAC,OAAO,CAAC,EAAE,2BAA2B,CAAC;CAChD;AAED,oFAAoF;AACpF,eAAO,MAAM,yBAAyB,EAAG,EAAW,CAAC;AA4CrD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,WAAW,GAAG,UAAU,GAAG,eAAe,GAAG,iBAAiB,CAAC;IAClG,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE;QACjB,0EAA0E;QAC1E,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QACtC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;KACvC,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,2BAA2B,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAC9D,QAAQ,CAAC,OAAO,EAAE,2BAA2B,GAAG,SAAS,CAAC;CAC3D;AAED,8EAA8E;AAC9E,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,mBAAmB,EAC9B,UAAU,GAAE,8BAAmC,GAC9C,oBAAoB,CA2BtB;AAED,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,oBAAoB,GAAG,MAAM,CAEtF"}

package/dist/ssr/resources.d.ts

@@ -0,0 +1,58 @@
+import type { GraphTexture, GraphTextureView, RenderGraphBuilder, RenderGraphError, RenderGraphFrame } from '@forgeax/engine-render-graph';
+import { type Result } from '@forgeax/engine-types';
+import { type SsrHiZExtent, type SsrHiZPlan } from './hiz';
+export { SSR_HIZ_FORMAT } from './hiz';
+export declare const SSR_TRACE_FORMAT: "rgba16float";
+export declare const SSR_R32FLOAT_BYTES_PER_PIXEL: 4;
+export declare const SSR_RGBA16FLOAT_BYTES_PER_PIXEL: 8;
+export declare const SSR_TEMPORAL_PARAMS_BYTES: 32;
+export declare const SSR_SPATIAL_MEMORY_BUDGET_BYTES: 45088768;
+export interface SsrHiZResources {
+    readonly plan: SsrHiZPlan;
+    readonly texture: GraphTexture;
+    readonly levels: readonly GraphTextureView[];
+}
+export interface SsrSpatialTexture {
+    readonly texture: GraphTexture;
+    readonly view: GraphTextureView;
+    readonly width: number;
+    readonly height: number;
+    readonly format: typeof SSR_TRACE_FORMAT;
+}
+export interface SsrSpatialResources {
+    readonly hiz: SsrHiZResources;
+    readonly trace: SsrSpatialTexture;
+    /** Half-resolution reactivity of the admitted reflection source taps. */
+    readonly hitReactivity: GraphTextureView;
+    /** Half-resolution resolved radiance/confidence when temporal resolve is active. */
+    readonly resolved?: SsrSpatialTexture;
+    /** Sampled view of all resolved reflection levels; mip 0 remains sharp. */
+    readonly radiancePyramid?: GraphTextureView;
+}
+export interface SsrSpatialMemoryEstimate {
+    readonly width: number;
+    readonly height: number;
+    readonly halfWidth: number;
+    readonly halfHeight: number;
+    readonly hizBytes: number;
+    readonly traceBytes: number;
+    readonly hitReactivityBytes: number;
+    readonly resolvedBytes: number;
+    readonly historyBytes: number;
+    readonly temporalParamsBytes: number;
+    /** Full-resolution fallback output allocated only for SSR; included in the total. */
+    readonly fallbackInputBytes: number;
+    /** Total additional descriptor bytes, including the lighting-owned fallback, before aliasing. */
+    readonly ssrOwnedBytes: number;
+    readonly budgetBytes: typeof SSR_SPATIAL_MEMORY_BUDGET_BYTES;
+    readonly withinBudget: boolean;
+}
+/** Derive descriptor bytes for one admitted half-resolution SSR frame. */
+export declare function estimateSsrSpatialMemory(extent: SsrHiZExtent, options?: {
+    readonly temporal?: boolean;
+}): SsrSpatialMemoryEstimate;
+/** Create the renderer-owned Hi-Z texture and one typed view per mip. */
+export declare function createSsrHiZResources(graph: RenderGraphBuilder<RenderGraphFrame>, extent: SsrHiZExtent): Result<SsrHiZResources, RenderGraphError>;
+/** Allocate only the transient resources required by an admitted spatial path. */
+export declare function createSsrSpatialResources(graph: RenderGraphBuilder<RenderGraphFrame>, extent: SsrHiZExtent): Result<SsrSpatialResources, RenderGraphError>;
+//# sourceMappingURL=resources.d.ts.map

package/dist/ssr/resources.d.ts.map

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

package/dist/ssr/temporal.d.ts

@@ -0,0 +1,38 @@
+import { type Result } from '@forgeax/engine-types';
+import type { TemporalFrameBeginInput, TemporalFrameCandidate, TemporalFrameConsumerId, TemporalFrameCoordinator, TemporalFrameError, TemporalFramePhases, TemporalFrameReceipt, TemporalFrameStage } from '../temporal/frame-coordinator';
+import type { SsrHistoryCandidate, SsrHistoryError, SsrHistoryFailureStage, SsrHistoryInspection, SsrHistoryOwner, SsrHistoryResetReason } from './history';
+export interface SsrTemporalCandidate<T> {
+    readonly temporal: TemporalFrameCandidate<T>;
+    readonly history: SsrHistoryCandidate;
+}
+export interface SsrTemporalExecutionError {
+    readonly code: 'ssr-temporal-stage-failed';
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: Readonly<{
+        readonly stage: TemporalFrameStage;
+        readonly cause: unknown;
+    }>;
+}
+export interface SsrTemporalInspection {
+    readonly sharedEpoch: number;
+    readonly consumerIds: readonly TemporalFrameConsumerId[];
+    readonly coordinatorAttempt: 'none' | 'active' | 'committed' | 'aborted';
+    readonly history: SsrHistoryInspection;
+}
+export type SsrTemporalError = TemporalFrameError | SsrHistoryError | SsrTemporalExecutionError;
+/** Stages SSR history beside the shared renderer transaction without owning submit or epochs. */
+export declare class SsrTemporalConsumer<T = unknown> {
+    private readonly coordinator;
+    readonly history: SsrHistoryOwner;
+    constructor(coordinator: TemporalFrameCoordinator<T>, history: SsrHistoryOwner);
+    begin(input: TemporalFrameBeginInput<T>): Result<SsrTemporalCandidate<T>, TemporalFrameError | SsrHistoryError>;
+    commit(candidate: SsrTemporalCandidate<T>): Result<TemporalFrameReceipt<T>, TemporalFrameError | SsrHistoryError>;
+    abort(candidate: SsrTemporalCandidate<T>, stage: SsrHistoryFailureStage): void;
+    run(input: TemporalFrameBeginInput<T>, phases: TemporalFramePhases<T>): Result<TemporalFrameReceipt<T>, SsrTemporalError>;
+    reset(reason: SsrHistoryResetReason): void;
+    retireAfterFence(queue: Parameters<SsrHistoryOwner['retireAfterFence']>[0], onFailure: Parameters<SsrHistoryOwner['retireAfterFence']>[1]): void;
+    inspect(): SsrTemporalInspection;
+}
+export declare function createSsrTemporalConsumer<T>(coordinator: TemporalFrameCoordinator<T>, history: SsrHistoryOwner): SsrTemporalConsumer<T>;
+//# sourceMappingURL=temporal.d.ts.map

package/dist/ssr/temporal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.d.ts","sourceRoot":"","sources":["../../src/ssr/temporal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACtB,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;CACvC;AACD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC5F;AACD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACzD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;IACzE,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;CACxC;AACD,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,GAAG,eAAe,GAAG,yBAAyB,CAAC;AA4ChG,iGAAiG;AACjG,qBAAa,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAExC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,QAAQ,CAAC,OAAO,EAAE,eAAe;gBADhB,WAAW,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAChD,OAAO,EAAE,eAAe;IAEnC,KAAK,CACH,KAAK,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAChC,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,kBAAkB,GAAG,eAAe,CAAC;IAUxE,MAAM,CACJ,SAAS,EAAE,oBAAoB,CAAC,CAAC,CAAC,GACjC,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,kBAAkB,GAAG,eAAe,CAAC;IAUxE,KAAK,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,sBAAsB,GAAG,IAAI;IAI9E,GAAG,CACD,KAAK,EAAE,uBAAuB,CAAC,CAAC,CAAC,EACjC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC7B,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC;IAqBpD,KAAK,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI;IAI1C,gBAAgB,CACd,KAAK,EAAE,UAAU,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,EACzD,SAAS,EAAE,UAAU,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,GAC5D,IAAI;IAGP,OAAO,IAAI,qBAAqB;CASjC;AACD,wBAAgB,yBAAyB,CAAC,CAAC,EACzC,WAAW,EAAE,wBAAwB,CAAC,CAAC,CAAC,EACxC,OAAO,EAAE,eAAe,GACvB,mBAAmB,CAAC,CAAC,CAAC,CAExB"}

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

@@ -1,11 +1,14 @@
 import type { Mat4 } from '@forgeax/engine-math';
 import type { RhiDevice } from '@forgeax/engine-rhi';
-import type { SkinPaletteSlice } from './skin-palette-types';
+import type { SkinPaletteReceipt, SkinPaletteSlice } from './skin-palette-types';
 export interface SkinPaletteAllocator {
+    /** Monotonic successful GPU content writes, independent of allocation identity. */
+    readonly contentRevision: number;
     /**
-     * Static BG entry size for `pbr-skin-mesh-array-bgl @binding(1)`. Always
-     * `MAX_JOINTS * 64 = 16320`; consumers (record stage) bind this size
-     * when building the BG. Path-independent.
+     * Static BG entry size for the direct/residual
+     * `pbr-skin-mesh-array-bgl @binding(1)` path. Always `MAX_JOINTS * 64 =
+     * 16320`; the scene-index GPU path binds the complete storage arena
+     * instead. Path-independent for the fixed-window consumer.
      */
     readonly bindingWindowBytes: number;
     /**
@@ -16,6 +19,27 @@ export interface SkinPaletteAllocator {
      * `slice.buffer` identity (shared vs per-entity), not this flag.
      */
     readonly useStorageBuffer: boolean;
+    /** Allocate or reuse a persistent identity/generation-scoped palette range. */
+    allocatePersistentSlice(input: {
+        readonly identity: string;
+        readonly generation: number;
+        readonly jointCount: number;
+        readonly bounds?: Float32Array;
+    }): SkinPaletteReceipt;
+    /**
+     * Compare the producer's current joint matrices with the last observed
+     * pose and mark only changed joints dirty.  The allocator owns this small
+     * pose observation cache so extract does not grow a second palette registry.
+     */
+    observePersistentJoints(identity: string, ibms: readonly Float32Array[], jointWorlds: readonly Mat4[]): readonly number[];
+    /** Mark producer-owned joints dirty; adjacent joints are merged on receipt. */
+    markDirtyJoints(identity: string, joints: readonly number[]): void;
+    /** Start a frame without discarding persistent ranges or their fences. */
+    beginFrame(): void;
+    /** Reconcile persistent identities after the frame's extract pass. */
+    endFrame(): void;
+    /** Retire one producer identity after its owning scene is detached. */
+    releasePersistentSlice(identity: string): void;
     /**
      * Allocate a slice for `jointCount` joints. Returns the buffer + byte
      * offset the record stage should bind. Storage path returns the same
@@ -28,12 +52,6 @@ export interface SkinPaletteAllocator {
      *         `device.limits.maxStorageBufferBindingSize`
      */
     allocateSlice(jointCount: number): SkinPaletteSlice;
-    /** Allocate one stable slice for a retained render source. */
-    allocateSliceFor(key: string, jointCount: number): SkinPaletteSlice;
-    /** Release a stable slice when its render source leaves the scene. */
-    releaseSliceFor(key: string): void;
-    /** Reconcile stable slices after a full render-source extraction. */
-    retainSliceKeys(keys: ReadonlySet<string>): void;
     /**
      * Write joint matrices into the slice's buffer at the slice's offset.
      * Computes M_i = jointWorldTransforms[i] * ibm[i] per joint.
@@ -44,12 +62,16 @@ export interface SkinPaletteAllocator {
      * directly against the IBM.
      */
     writeJointPalette(slice: SkinPaletteSlice, ibms: readonly Float32Array[], jointWorlds: readonly Mat4[]): void;
+    /** Write only the dirty ranges carried by a persistent receipt. */
+    writePersistentJointPalette(receipt: SkinPaletteReceipt, ibms: readonly Float32Array[], jointWorlds: readonly Mat4[]): 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;
+    /** Release all allocator-owned GPU buffers during renderer teardown. */
+    dispose(): 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

@@ -1 +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,sBAAsB,CAAC;AAmB7D,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,8DAA8D;IAC9D,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACpE,sEAAsE;IACtE,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,qEAAqE;IACrE,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACjD;;;;;;;;OAQG;IACH,iBAAiB,CACf,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,SAAS,YAAY,EAAE,EAC7B,WAAW,EAAE,SAAS,IAAI,EAAE,GAC3B,IAAI,CAAC;IACR;;;;OAIG;IACH,aAAa,IAAI,IAAI,CAAC;CACvB;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,MAAM,EACtB,gBAAgB,UAAO,GACtB,oBAAoB,CAgPtB"}
+{"version":3,"file":"skin-palette-allocator.d.ts","sourceRoot":"","sources":["../../src/systems/skin-palette-allocator.ts"],"names":[],"mappings":"AA4CA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,KAAK,EAAU,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAO7D,OAAO,KAAK,EAEV,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAuB9B,MAAM,WAAW,oBAAoB;IACnC,mFAAmF;IACnF,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,+EAA+E;IAC/E,uBAAuB,CAAC,KAAK,EAAE;QAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;KAChC,GAAG,kBAAkB,CAAC;IACvB;;;;OAIG;IACH,uBAAuB,CACrB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,SAAS,YAAY,EAAE,EAC7B,WAAW,EAAE,SAAS,IAAI,EAAE,GAC3B,SAAS,MAAM,EAAE,CAAC;IACrB,+EAA+E;IAC/E,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACnE,0EAA0E;IAC1E,UAAU,IAAI,IAAI,CAAC;IACnB,sEAAsE;IACtE,QAAQ,IAAI,IAAI,CAAC;IACjB,uEAAuE;IACvE,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C;;;;;;;;;;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,mEAAmE;IACnE,2BAA2B,CACzB,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,SAAS,YAAY,EAAE,EAC7B,WAAW,EAAE,SAAS,IAAI,EAAE,GAC3B,IAAI,CAAC;IACR;;;;OAIG;IACH,aAAa,IAAI,IAAI,CAAC;IACtB,wEAAwE;IACxE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,MAAM,EACtB,gBAAgB,UAAO,GACtB,oBAAoB,CAsiBtB"}

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

@@ -11,4 +11,19 @@ export interface SkinPaletteSlice {
     /** GPU buffer containing the slice's joint matrices. */
     readonly buffer: Buffer;
 }
+export interface SkinPaletteDirtyRange {
+    readonly startJoint: number;
+    readonly jointCount: number;
+}
+export interface SkinPaletteReceipt extends SkinPaletteSlice {
+    readonly identity: string;
+    readonly generation: number;
+    readonly fence: number;
+    readonly customDataStart: number;
+    readonly storageOrUniform: 'storage' | 'uniform';
+    readonly bounds?: Float32Array;
+    readonly dirtyRanges: readonly SkinPaletteDirtyRange[];
+    readonly uploadBytes: number;
+    readonly retiredByteOffset?: number;
+}
 //# sourceMappingURL=skin-palette-types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"skin-palette-types.d.ts","sourceRoot":"","sources":["../../src/systems/skin-palette-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB"}
+{"version":3,"file":"skin-palette-types.d.ts","sourceRoot":"","sources":["../../src/systems/skin-palette-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACvD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC"}

package/dist/systems/transparent-dispatch.d.ts

@@ -0,0 +1,9 @@
+import type { World } from '@forgeax/engine-ecs';
+import type { CameraSnapshot } from '../render-contract';
+import type { DispatchEntry, RenderableSnapshot } from '../render-system-extract';
+/**
+ * Reorder only the transparent queue while preserving every opaque slot.
+ * Equal depth/layer values use material identity as a fold-friendly tie break.
+ */
+export declare function sortTransparentDispatch(dispatch: DispatchEntry[], world: World, cameras: readonly CameraSnapshot[], renderables: readonly RenderableSnapshot[]): DispatchEntry[];
+//# sourceMappingURL=transparent-dispatch.d.ts.map

package/dist/systems/transparent-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transparent-dispatch.d.ts","sourceRoot":"","sources":["../../src/systems/transparent-dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AASlF;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,aAAa,EAAE,EACzB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,WAAW,EAAE,SAAS,kBAAkB,EAAE,GACzC,aAAa,EAAE,CAoEjB"}

package/dist/targets/material-source.d.ts

@@ -27,6 +27,13 @@ export interface RenderTargetMaterialSourceExpectation {
 }
 /** Resolve a source only inside the renderer-owned material projection. */
 export declare function resolveRenderTargetMaterialSource(source: RenderTargetTextureSource): RenderTargetMaterialSourceBinding | undefined;
+/**
+ * Returns the stable renderer-local resource identity used by batch grouping.
+ * The opaque source object is intentionally not stringified: target identity,
+ * device generation, and view subresource are the producer-owned facts that
+ * determine whether two draws may share one material bind group.
+ */
+export declare function renderTargetMaterialSourceIdentity(source: RenderTargetTextureSource): string | undefined;
 export declare function createRenderTargetMaterialSource(target: RenderTarget, descriptor: RenderTargetDescriptor, options: RenderTargetTextureSourceOptions & {
     readonly generation: number;
 }): RenderResult<RenderTargetMaterialSourceBinding, RenderError>;