@forgeax/engine-render 0.1.20 → 0.1.23

package/dist/device/gpu-residency.d.ts

@@ -87,6 +87,13 @@ export interface MeshGpuHandles {
      * For single-submesh meshes this is a 1-element array (byte-identical to pre-M4).
      */
     readonly submeshes: readonly import('@forgeax/engine-types').Submesh[];
+    /** Packed root + lower-detail geometry ranges in the shared mesh buffers. */
+    readonly lodRanges?: readonly (readonly MeshGpuRange[])[];
+}
+export interface MeshGpuRange {
+    readonly first: number;
+    readonly count: number;
+    readonly baseVertex: number;
 }
 /**
  * GPU residency store. Owns the per-handle GPU caches and the upload
@@ -287,7 +294,7 @@ export declare class GpuResidencyCache {
      * (`_uploadCubemapFromEquirect`). Builtin meshes are NOT routed here either
      * (createRenderer step-3 owns them; D-1).
      */
-    ensureResident(handle: Handle<'MeshAsset', 'shared'>, pod: TypesMeshAsset, worldId?: World | number): Result<MeshGpuHandles, RhiError | AssetError | ImageError>;
+    ensureResident(handle: Handle<'MeshAsset', 'shared'>, pod: TypesMeshAsset, worldId?: World | number, lodMeshes?: readonly TypesMeshAsset[]): Result<MeshGpuHandles, RhiError | AssetError | ImageError>;
     ensureResident(handle: Handle<'TextureAsset', 'shared'>, pod: TextureAsset, worldId?: World | number): Result<TextureGpuEntry, RhiError | AssetError | ImageError>;
     /**
      * Eager public surface: upload decoded image bytes into a GPU texture and

package/dist/device/gpu-residency.d.ts.map

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

package/dist/device/lifecycle-transaction.d.ts

@@ -0,0 +1,2 @@
+export { type DeviceResourceKind, DeviceResourceRef, DeviceScope, type DeviceScopeReceipt, type DeviceScopeState, type LifecycleFailure, type LifecycleResourceSpec, type LifecycleResult, LifecycleTransaction, type ResourceRef, } from './device-scope';
+//# sourceMappingURL=lifecycle-transaction.d.ts.map

package/dist/device/lifecycle-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-transaction.d.ts","sourceRoot":"","sources":["../../src/device/lifecycle-transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,kBAAkB,EACvB,iBAAiB,EACjB,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,oBAAoB,EACpB,KAAK,WAAW,GACjB,MAAM,gBAAgB,CAAC"}

package/dist/environment/frame.d.ts.map

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

package/dist/environment/lifecycle.d.ts

@@ -24,6 +24,11 @@ export declare class EnvironmentLifecycle {
     isActive(generation: EnvironmentGeneration): boolean;
     discard(generation: EnvironmentGeneration): void;
     recordCandidateFailure(error: EnvironmentGenerationFailedError): void;
+    /** Retain a structured authoring failure while the active/LKG frame stays live. */
+    recordSelectionFailure(error: {
+        readonly code: string;
+        readonly detail: Readonly<Record<string, unknown>>;
+    }): void;
     recordStageFailure(stage: EnvironmentInspectionFailure['stage'], generation: EnvironmentGeneration): void;
     ensure(frame: EnvironmentFrame, laneOrFailure?: 'direct' | 'clustered' | EnvironmentGenerationFailure): Result<EnvironmentGeneration, EnvironmentGenerationFailedError>;
     publish(generation: EnvironmentGeneration): void;

package/dist/environment/lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/environment/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gCAAgC,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,KAAK,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAExF,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EAGlC,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,IAAI,IAAI,CAAC;CACjB;AAMD,2EAA2E;AAC3E,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,GAAG,CAAoC;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4C;IACvE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,oBAAoB,CAA2C;gBAE3D,KAAK,EAAE,WAAW;IAK9B,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAInC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO;IAIpD,OAAO,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI;IAShD,sBAAsB,CAAC,KAAK,EAAE,gCAAgC,GAAG,IAAI;IAQrE,kBAAkB,CAChB,KAAK,EAAE,4BAA4B,CAAC,OAAO,CAAC,EAC5C,UAAU,EAAE,qBAAqB,GAChC,IAAI;IAeP,MAAM,CACJ,KAAK,EAAE,gBAAgB,EACvB,aAAa,GAAE,QAAQ,GAAG,WAAW,GAAG,4BAAuC,GAC9E,MAAM,CAAC,qBAAqB,EAAE,gCAAgC,CAAC;IAgDlE,OAAO,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI;IAShD,OAAO,IAAI,gBAAgB;IAgB3B,cAAc,IAAI,IAAI;IAgBtB,OAAO,IAAI,qBAAqB,GAAG;QACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;QAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;KAC3C;IA8CK,OAAO,CACX,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,MAAM,CAAC,qBAAqB,EAAE,gCAAgC,CAAC,CAAC;IAkB3E,OAAO,CAAC,QAAQ;CAMjB"}
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/environment/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gCAAgC,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,KAAK,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAExF,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EAGlC,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,IAAI,IAAI,CAAC;CACjB;AAMD,2EAA2E;AAC3E,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,GAAG,CAAoC;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4C;IACvE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,oBAAoB,CAA2C;gBAE3D,KAAK,EAAE,WAAW;IAK9B,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAInC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO;IAQpD,OAAO,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI;IAShD,sBAAsB,CAAC,KAAK,EAAE,gCAAgC,GAAG,IAAI;IAQrE,mFAAmF;IACnF,sBAAsB,CAAC,KAAK,EAAE;QAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;KACpD,GAAG,IAAI;IAQR,kBAAkB,CAChB,KAAK,EAAE,4BAA4B,CAAC,OAAO,CAAC,EAC5C,UAAU,EAAE,qBAAqB,GAChC,IAAI;IAeP,MAAM,CACJ,KAAK,EAAE,gBAAgB,EACvB,aAAa,GAAE,QAAQ,GAAG,WAAW,GAAG,4BAAuC,GAC9E,MAAM,CAAC,qBAAqB,EAAE,gCAAgC,CAAC;IAmDlE,OAAO,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI;IAShD,OAAO,IAAI,gBAAgB;IAgB3B,cAAc,IAAI,IAAI;IAgBtB,OAAO,IAAI,qBAAqB,GAAG;QACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;QAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;KAC3C;IA8CK,OAAO,CACX,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,MAAM,CAAC,qBAAqB,EAAE,gCAAgC,CAAC,CAAC;IAkB3E,OAAO,CAAC,QAAQ;CAMjB"}

package/dist/errors/gpu-driven.d.ts

@@ -0,0 +1,26 @@
+import type { MaterialShaderArtifactReceipt } from '@forgeax/engine-shader';
+export type GpuDrivenPreparationErrorCode = 'missing-material-receipt' | 'missing-uv' | 'reflection-mismatch' | 'vertex-input-mismatch' | 'alpha-mask-mismatch' | 'resource-not-ready' | 'stale-generation' | 'skin-receipt-mismatch';
+export type GpuDrivenPreparationReason = 'material-receipt-missing' | 'uv-set-missing' | 'reflection-receipt-mismatch' | 'vertex-semantic-mismatch' | 'alpha-mask-receipt-missing' | 'material-resource-missing' | 'generation-stale' | 'skin-address-missing';
+export interface GpuDrivenPreparationErrorDetail {
+    readonly reason: GpuDrivenPreparationReason;
+    readonly owner: 'material' | 'geometry' | 'skin' | 'generation';
+    readonly expected?: string;
+    readonly actual?: string;
+    readonly expectedGeneration?: number;
+    readonly actualGeneration?: number;
+}
+export declare class GpuDrivenPreparationError extends Error {
+    readonly code: GpuDrivenPreparationErrorCode;
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: GpuDrivenPreparationErrorDetail;
+    constructor(code: GpuDrivenPreparationErrorCode, detail: GpuDrivenPreparationErrorDetail);
+}
+export interface GpuDrivenPreparedMaterial {
+    readonly receipt: MaterialShaderArtifactReceipt;
+    readonly resourceSlots: MaterialShaderArtifactReceipt['resourceSlots'];
+    readonly uvSets: MaterialShaderArtifactReceipt['uvSets'];
+    readonly vertexInputs: MaterialShaderArtifactReceipt['vertexInputs'];
+    readonly alphaMask: MaterialShaderArtifactReceipt['alphaMask'];
+}
+//# sourceMappingURL=gpu-driven.d.ts.map

package/dist/errors/gpu-driven.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpu-driven.d.ts","sourceRoot":"","sources":["../../src/errors/gpu-driven.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAE5E,MAAM,MAAM,6BAA6B,GACrC,0BAA0B,GAC1B,YAAY,GACZ,qBAAqB,GACrB,uBAAuB,GACvB,qBAAqB,GACrB,oBAAoB,GACpB,kBAAkB,GAClB,uBAAuB,CAAC;AAE5B,MAAM,MAAM,0BAA0B,GAClC,0BAA0B,GAC1B,gBAAgB,GAChB,6BAA6B,GAC7B,0BAA0B,GAC1B,4BAA4B,GAC5B,2BAA2B,GAC3B,kBAAkB,GAClB,sBAAsB,CAAC;AAE3B,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,MAAM,EAAE,0BAA0B,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,YAAY,CAAC;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAuCD,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,IAAI,EAAE,6BAA6B,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,+BAA+B,CAAC;gBAErC,IAAI,EAAE,6BAA6B,EAAE,MAAM,EAAE,+BAA+B;CASzF;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,EAAE,6BAA6B,CAAC;IAChD,QAAQ,CAAC,aAAa,EAAE,6BAA6B,CAAC,eAAe,CAAC,CAAC;IACvE,QAAQ,CAAC,MAAM,EAAE,6BAA6B,CAAC,QAAQ,CAAC,CAAC;IACzD,QAAQ,CAAC,YAAY,EAAE,6BAA6B,CAAC,cAAc,CAAC,CAAC;IACrE,QAAQ,CAAC,SAAS,EAAE,6BAA6B,CAAC,WAAW,CAAC,CAAC;CAChE"}

package/dist/errors/index.d.ts

@@ -1,4 +1,5 @@
 export * from './ecs-validation';
+export * from './gpu-driven';
 export * from './recover';
 export * from './render';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/errors/recover.d.ts

@@ -1,4 +1,13 @@
 import type { DeviceScopeReceipt } from '../device/resource-types';
+import type { ReflectionFallbackRecoveryAction } from '../inspection-types';
+import type { SsrAdmissionError, SsrOwnerRecoveryAction } from '../ssr/errors';
+export type { ReflectionFallbackRecoveryAction } from '../inspection-types';
+export declare function reflectionFallbackRecoveryAction(source: 'probe' | 'skylight' | 'neutral', hasLastKnownGood: boolean): ReflectionFallbackRecoveryAction;
+/**
+ * Maps a detached admission failure to the owning producer action. This is
+ * an instruction projection only; SSR never performs the recovery itself.
+ */
+export declare function ssrAdmissionRecoveryAction(error: SsrAdmissionError): SsrOwnerRecoveryAction;
 /**
  * Closed union of recover() error codes.
  *
@@ -101,5 +110,4 @@ export declare class IblCapabilityLossError extends Error {
     readonly detail: IblCapabilityLossDetail;
     constructor(lastKnownGood: string);
 }
-export {};
 //# sourceMappingURL=recover.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"recover.d.ts","sourceRoot":"","sources":["../../src/errors/recover.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAInE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,oBAAoB,CAAC;AAEjE,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;CA+BzB,CAAC;AAEF;;;;;;;;;GASG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,gBAAgB;CAQnC;AAED,QAAA,MAAM,4BAA4B;;;;;;;;;CASxB,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG,MAAM,OAAO,4BAA4B,CAAC;AAEhF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;gBAEjC,IAAI,EAAE,uBAAuB,EAAE,MAAM,EAAE,2BAA2B;CAS/E;AAED,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,mBAAmB,CAAC;AAEhE,MAAM,MAAM,qBAAqB,GAAG,yBAAyB,CAAC;AAE9D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,gBAAgB,EAAE,YAAY,CAAC;IACxC,QAAQ,CAAC,qBAAqB,EAAE,KAAK,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAA6B;IACjE,QAAQ,CAAC,QAAQ,oEAAoE;IACrF,QAAQ,CAAC,IAAI,6EAA6E;IAC1F,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;gBAE7B,aAAa,EAAE,MAAM;CASlC"}
+{"version":3,"file":"recover.d.ts","sourceRoot":"","sources":["../../src/errors/recover.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE/E,YAAY,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AAE5E,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,EACxC,gBAAgB,EAAE,OAAO,GACxB,gCAAgC,CAIlC;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,iBAAiB,GAAG,sBAAsB,CAa3F;AAID;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,oBAAoB,CAAC;AAEjE,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;CA+BzB,CAAC;AAEF;;;;;;;;;GASG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,gBAAgB;CAQnC;AAED,QAAA,MAAM,4BAA4B;;;;;;;;;CASxB,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG,MAAM,OAAO,4BAA4B,CAAC;AAEhF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;gBAEjC,IAAI,EAAE,uBAAuB,EAAE,MAAM,EAAE,2BAA2B;CAS/E;AAED,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,mBAAmB,CAAC;AAEhE,MAAM,MAAM,qBAAqB,GAAG,yBAAyB,CAAC;AAE9D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,gBAAgB,EAAE,YAAY,CAAC;IACxC,QAAQ,CAAC,qBAAqB,EAAE,KAAK,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAA6B;IACjE,QAAQ,CAAC,QAAQ,oEAAoE;IACrF,QAAQ,CAAC,IAAI,6EAA6E;IAC1F,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;gBAE7B,aAAa,EAAE,MAAM;CASlC"}

package/dist/errors/render.d.ts

@@ -36,6 +36,31 @@ export type RenderSurfaceExpectedError = {
 }[SurfaceFailureCode];
 /** Construct the closed surface error from its failure-stage discriminant. */
 export declare function createRenderSurfaceError(kind: SurfaceFailureKind, detail: RenderSurfaceFailureDetail): RenderSurfaceExpectedError;
+export type LightResourceFailureReason = 'asset' | 'format' | 'capability' | 'capacity';
+export interface LightResourceUnavailableDetail {
+    readonly entity: number;
+    readonly feature: 'ies' | 'cookie' | 'probe';
+    readonly generation: number;
+    readonly sourceKey: string;
+    readonly reason: LightResourceFailureReason;
+}
+export declare class LightResourceUnavailableError extends Error {
+    readonly code: "light-resource-unavailable";
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: LightResourceUnavailableDetail;
+    constructor(detail: LightResourceUnavailableDetail, expected: string, actual: string, hint: string);
+}
+export declare function createLightResourceUnavailable(input: {
+    readonly entity: number;
+    readonly feature: LightResourceUnavailableDetail['feature'];
+    readonly generation: number;
+    readonly sourceKey: string;
+    readonly reason: LightResourceFailureReason;
+    readonly expected: string;
+    readonly actual: string;
+    readonly hint: string;
+}): LightResourceUnavailableError;
 export interface TemporalFrameSubmitDetail {
     readonly reason: 'queue-submit-failed';
 }
@@ -49,55 +74,46 @@ export declare class TemporalFrameSubmitError extends Error {
 /**
  * Detail for `RuntimeErrorCode 'shadow-invalid-config'`.
  *
- * Emitted by `DirectionalLight.validate` shadow-field path when a field value violates
- * runtime constraints (e.g. mapSize < 1, cascadeCount not in {1..4}).
- * AI users access `.detail.field` / `.detail.value` / `.detail.min` /
- * `.detail.max` via property access — no string parsing.
- *
- * `max` is `undefined` for lower-bound-only validations (e.g. mapSize < 1).
- * feat-20260613-csm: max added for upper-bound cascade validations
- * (cascadeCount max=4, splitLambda max=1, cascadeBlend max=0.5).
+ * The four fields are the only recovery surface: AI users read the invalid
+ * field, actual value, structured bound, and reason without parsing prose.
  */
+export type ShadowInvalidConfigBound = {
+    readonly kind: 'range';
+    readonly min: number;
+    readonly max: number;
+} | {
+    readonly kind: 'lower-bound';
+    readonly operator: '>' | '>=';
+    readonly value: number;
+} | {
+    readonly kind: 'allowed-values';
+    readonly values: readonly number[];
+};
 export interface ShadowInvalidConfigDetail {
     readonly field: string;
-    readonly value: number;
-    readonly min: number;
-    readonly max?: number;
+    readonly actual: number;
+    readonly bound: ShadowInvalidConfigBound;
+    readonly reason: string;
 }
 /**
  * Structured error for shadow component config validation failures.
  *
- * Emitted by `DirectionalLight.validate()` shadow-field path (mapSize / cascadeCount /
- * splitLambda / cascadeBlend / shadowDistance) and `PointLightShadow.validate()`
- * (mapSize / farPlane > nearPlane / pcfKernelSize); both shadow component
- * types share this single error class so `switch (err.code)` on
- * `RuntimeErrorCode` only needs one branch (charter P4 — closed-union SSOT).
- * Four-field surface per AGENTS.md error model:
+ * Emitted by Directional, Point, and Spot shadow validation. All three
+ * component owners share this error class so `switch (err.code)` on
+ * `RuntimeErrorCode` needs one branch (charter P4 — closed-union SSOT).
+ * Four-field surface:
  *   - `.code = 'shadow-invalid-config'` (closed RuntimeErrorCode)
  *   - `.expected` — expected-state description (programmatic predicate form)
  *   - `.hint` — actionable recovery guidance (imperative; AI users paste into
- *     spawn calls). Integer-typed fields (e.g. `cascadeCount`, `pcfKernelSize`)
- *     get an "integer in [min, max]" hint; otherwise "[min, max]" range or
- *     "<comparator> min".
- *   - `.detail = { field, value, min, max? }` — structured values (charter P4)
- *
- * 4th constructor parameter is a union over the two range shapes:
- *   - `number` — `max` for a closed `[min, max]` range (CSM cascadeCount /
- *     splitLambda / cascadeBlend). hint uses "in [min, max]"; integer-typed
- *     fields get "integer in [min, max]".
- *   - `'>' | '>='` — comparator for an open lower-bound predicate. `'>'` is
- *     used when `min` carries dynamic context (e.g. `farPlane > nearPlane` —
- *     the surfaced hint reads "must be > nearPlane" so AI users setting
- *     farPlane=nearPlane don't re-fail the spawn loop with the wrong cue).
- *   - `undefined` — defaults to `'>='`. Callsites for mapSize < 1 validation
- *     stay backward-compatible (3-arg form).
+ *     spawn calls).
+ *   - `.detail = { field, actual, bound, reason }` — structured values.
  */
 export declare class ShadowInvalidConfigError extends Error {
     readonly code: "shadow-invalid-config";
     readonly expected: string;
     readonly hint: string;
     readonly detail: ShadowInvalidConfigDetail;
-    constructor(field: string, value: number, min: number, maxOrComparator?: number | '>' | '>=');
+    constructor(field: string, actual: number, minOrBound: number | ShadowInvalidConfigBound, maxOrComparator?: number | '>' | '>=', reason?: string);
 }
 /**
  * Detail for `RuntimeErrorCode 'equirect-projection-failed'`.
@@ -133,87 +149,67 @@ export declare class EquirectProjectionFailedError extends Error {
     readonly detail: EquirectProjectionFailedDetail;
     constructor(handle: number);
 }
-/**
- * Detail for `RuntimeErrorCode 'hdrp-light-budget-exceeded'`.
- *
- * Emitted per-frame (once-per-frame fire) when light count exceeds HDRP budget.
- */
-export interface HdrpLightBudgetExceededDetail {
+/** The finite local-light budget that a Standard frame agreed to admit. */
+export interface StandardLightBudgetExceededDetail {
     readonly actual: number;
     readonly budget: number;
 }
 /**
- * Structured error for HDRP light budget exceeded (AC-06/AC-07).
- *
- * Emitted per-frame in recordFrame when the total punctual light count
- * exceeds the HDRP budget (256). Fail-soft: fire once per frame, truncate to 256.
- *   - `.code = 'hdrp-light-budget-exceeded'` (closed RuntimeErrorCode)
- *   - `.expected` — 'light count <= 256'
- *   - `.hint` — 'reduce world light count or increase budget (OOS-hdrp-larger-budget)'
- *   - `.detail = { actual, budget }`
+ * Structured refusal for a Standard frame whose finite local-light set is
+ * outside the selected profile budget. The frame is rejected as a whole; the
+ * record owner must not slice the input or submit a partial membership set.
  */
-export declare class HdrpLightBudgetExceededError extends Error {
-    readonly code: "hdrp-light-budget-exceeded";
+export declare class StandardLightBudgetExceededError extends Error {
+    readonly code: "standard-light-budget-exceeded";
     readonly expected: string;
     readonly hint: string;
-    readonly detail: HdrpLightBudgetExceededDetail;
+    readonly detail: StandardLightBudgetExceededDetail;
     constructor(actual: number, budget: number);
 }
-/**
- * Detail for `RuntimeErrorCode 'hdrp-index-list-overflow'`.
- *
- * Emitted per-frame (once-per-frame fire) when the cluster binner overflows
- * the light index list capacity (65536). Upgraded from ClusterBinError.
- */
-export interface HdrpIndexListOverflowDetail {
+/** Cluster membership entries that could not fit the single shared index list. */
+export interface StandardClusterIndexOverflowDetail {
     readonly actual: number;
     readonly capacity: number;
 }
 /**
- * Structured error for HDRP cluster binner index list overflow (AC-24).
- *
- * Emitted per-frame in recordFrame when the CPU binner returns
- * `ClusterBinError('index-overflow')`. Fail-soft: fire once per frame,
- * continue rendering with what fit.
- *   - `.code = 'hdrp-index-list-overflow'` (closed RuntimeErrorCode)
- *   - `.expected` — 'light index list entries <= 65536'
- *   - `.hint` — 'reduce lights, shrink cluster grid, or increase capacity'
- *   - `.detail = { actual, capacity }`
+ * Structured refusal for a membership producer that exceeded the shared
+ * Cluster index-list capacity. No truncated list is uploaded and no graph is
+ * submitted for the rejected frame.
  */
-export declare class HdrpIndexListOverflowError extends Error {
-    readonly code: "hdrp-index-list-overflow";
+export declare class StandardClusterIndexOverflowError extends Error {
+    readonly code: "standard-cluster-index-overflow";
     readonly expected: string;
     readonly hint: string;
-    readonly detail: HdrpIndexListOverflowDetail;
+    readonly detail: StandardClusterIndexOverflowDetail;
     constructor(actual: number, capacity: number);
 }
-/**
- * Detail for `RuntimeErrorCode 'hdrp-deferred-caps-insufficient'`.
- *
- * Emitted when the Standard clustered lane has fewer than 4 color attachments,
- * meaning the deferred path cannot allocate 3 g-buffer color targets + depth.
- */
-export interface HdrpDeferredCapsInsufficientDetail {
-    readonly actual: number;
-    readonly expected: number;
+export interface StandardClusterTransportUnavailableDetail {
+    readonly requested: number;
+    readonly admitted: 0;
 }
 /**
- * Structured error for deferred-path capability gate failure.
- *
- * Emitted during Standard clustered lane validation — synchronous throw.
- *   - `.code = 'hdrp-deferred-caps-insufficient'` (closed RuntimeErrorCode)
- *   - `.expected` — 'maxColorAttachments >= 4'
- *   - `.hint` — actionable guidance to upgrade browser or select URP
- *   - `.detail = { actual, expected }`
- *
- * @see plan-strategy D-5 (capability validation, no silent fallback)
+ * Structured capability refusal. Standard never turns an unproven transport
+ * into a smaller direct-light lane; the caller receives the exact requested
+ * local-light count and an admitted count of zero.
  */
-export declare class HdrpDeferredCapsInsufficientError extends Error {
-    readonly code: "hdrp-deferred-caps-insufficient";
+export declare class StandardClusterTransportUnavailableError extends Error {
+    readonly code: "standard-cluster-transport-unavailable";
+    readonly expected = "all requested local lights have a proven Cluster transport";
+    readonly hint: string;
+    readonly detail: StandardClusterTransportUnavailableDetail;
+    constructor(requested: number, hint?: string);
+}
+export interface StandardProfileInvalidDetail {
+    readonly field: string;
+    readonly actual: unknown;
+}
+/** Structured validation failure for the single Standard profile surface. */
+export declare class StandardProfileInvalidError extends Error {
+    readonly code: "standard-profile-invalid";
     readonly expected: string;
     readonly hint: string;
-    readonly detail: HdrpDeferredCapsInsufficientDetail;
-    constructor(actual: number);
+    readonly detail: StandardProfileInvalidDetail;
+    constructor(message: string, detail?: StandardProfileInvalidDetail);
 }
 /**
  * Structured error for `ShadowAtlas.faceView` called before `ensure()`
@@ -252,7 +248,7 @@ export interface PointShadowAtlasBoundsViolationDetail {
  *   - `.code = 'point-shadow-atlas-bounds-violation'`
  *   - `.expected` — `0 <= layer < layers && 0 <= face < 6`
  *   - `.hint` — clamp `shadowAtlasLayer` or face index before calling
- *     `faceView`; the cap on layers is `PointLightShadow` cardinality (4)
+ *     `faceView`; the layer cap is the renderer-owned ShadowAtlas capacity
  *   - `.detail = { axis, value, max }` — discriminates layer vs face
  */
 export declare class PointShadowAtlasBoundsViolationError extends Error {
@@ -837,6 +833,83 @@ export declare class PointsLinesPrepareFailedError extends Error {
     readonly detail: PointsLinesPrepareFailedDetail;
     constructor(detail: PointsLinesPrepareFailedDetail);
 }
+export interface RenderTargetDescriptorInvalidDetail {
+    readonly field: string;
+    readonly value: unknown;
+    readonly expected: string;
+}
+export declare class RenderTargetDescriptorInvalidError extends Error {
+    readonly code: "render-target-descriptor-invalid";
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: RenderTargetDescriptorInvalidDetail;
+    constructor(detail: RenderTargetDescriptorInvalidDetail);
+}
+export interface RenderTargetCapabilityMissingDetail {
+    readonly operation: 'create' | 'resize' | 'source' | 'readback';
+    readonly requested: string;
+    readonly capability: string;
+    readonly actual: string;
+}
+export declare class RenderTargetCapabilityMissingError extends Error {
+    readonly code: "render-target-capability-missing";
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: RenderTargetCapabilityMissingDetail;
+    constructor(detail: RenderTargetCapabilityMissingDetail);
+}
+export type RenderTargetStateInvalidReason = 'foreign-renderer' | 'destroyed' | 'uninitialized' | 'generation-mismatch' | 'readback-without-intent';
+export interface RenderTargetStateInvalidDetail {
+    readonly operation: 'inspect' | 'resize' | 'source' | 'readback' | 'destroy';
+    readonly reason: RenderTargetStateInvalidReason;
+    readonly state: 'uninitialized' | 'candidate' | 'active' | 'rebuilding' | 'destroyed';
+    readonly generation: number;
+}
+export declare class RenderTargetStateInvalidError extends Error {
+    readonly code: "render-target-state-invalid";
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: RenderTargetStateInvalidDetail;
+    constructor(detail: RenderTargetStateInvalidDetail);
+}
+export interface RenderTargetOperationFailedDetail {
+    readonly operation: 'create' | 'resize' | 'source' | 'readback' | 'destroy' | 'recover';
+    readonly stage: 'allocation' | 'compile' | 'write' | 'submit' | 'copy' | 'retire';
+    readonly generation: number;
+    readonly cause: unknown;
+    readonly recovery: 'retry' | 'recover' | 'retain-last-known-good';
+}
+export declare class RenderTargetOperationFailedError extends Error {
+    readonly code: "render-target-operation-failed";
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: RenderTargetOperationFailedDetail;
+    constructor(detail: RenderTargetOperationFailedDetail);
+}
+export interface ReflectionProbeBudgetExceededDetail {
+    readonly actual: number;
+    readonly budget: number;
+}
+export declare class ReflectionProbeBudgetExceededError extends Error {
+    readonly code: "reflection-probe-budget-exceeded";
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: ReflectionProbeBudgetExceededDetail;
+    constructor(actual: number, budget: number);
+}
+export interface RenderIntentInvalidDetail {
+    readonly component: 'CubeCamera' | 'ReflectionProbe';
+    readonly field: 'updateIntent';
+    readonly value: number;
+    readonly allowed: readonly [0, 1, 2];
+}
+export declare class RenderIntentInvalidError extends Error {
+    readonly code: "render-intent-invalid";
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: RenderIntentInvalidDetail;
+    constructor(component: RenderIntentInvalidDetail['component'], value: number);
+}
 export interface VolumeOwnerConflictDetail {
     readonly ownerCount: number;
 }
@@ -904,5 +977,5 @@ export type RenderErrorCode = RenderError['code'];
  * Closed union of the render-cluster structured error classes, each carrying a
  * `RenderErrorCode` discriminant on `.code`.
  */
-export type RenderError = LifecycleConstructionError | RendererExpectedOperationError | FrameReceiptStaleError | RendererContractFailureError | ObservationUnavailableError | SceneDataUnavailableError | TaaUnavailableError | ShadowInvalidConfigError | EquirectProjectionFailedError | HdrpLightBudgetExceededError | HdrpIndexListOverflowError | HdrpDeferredCapsInsufficientError | PointShadowAtlasUninitializedError | PointShadowAtlasBoundsViolationError | VideoUploadUnsupportedError | VertexStorageBufferUnavailableError | VertexColorVariantConflictError | SkinPaletteOverflowError | SkinMaterialMismatchError | MaterialSkinAttrMissingError | TransmissionCapabilityMissingError | RenderFeatureRegistrationConflictError | RenderFeatureStageFailedError | RenderFeatureCapabilityMissingError | RenderFeaturePassOrderConflictError | RenderFeaturePreparationFailedError | RenderFeaturePreparedStateMismatchError | RenderFeatureDrawRecordingFailedError | EnvironmentSourceConflictError | FogCardinalityError | TaaCapsInsufficientError | EnvironmentGenerationFailedError | AtmosphereInvalidParameterError | OwnerStageFailedError | PointsLinesInvalidStyleError | PointsLinesTopologyMismatchError | PointsLinesStyleUnsupportedError | PointsLinesMaterialUnsupportedError | PointsLinesBudgetExceededError | PointsLinesPrepareFailedError | ProjectorBindingError | VolumeError;
+export type RenderError = LifecycleConstructionError | RendererExpectedOperationError | FrameReceiptStaleError | RendererContractFailureError | ObservationUnavailableError | SceneDataUnavailableError | TaaUnavailableError | ShadowInvalidConfigError | EquirectProjectionFailedError | StandardLightBudgetExceededError | StandardClusterIndexOverflowError | StandardClusterTransportUnavailableError | StandardProfileInvalidError | PointShadowAtlasUninitializedError | PointShadowAtlasBoundsViolationError | VideoUploadUnsupportedError | VertexStorageBufferUnavailableError | VertexColorVariantConflictError | SkinPaletteOverflowError | SkinMaterialMismatchError | MaterialSkinAttrMissingError | TransmissionCapabilityMissingError | RenderFeatureRegistrationConflictError | RenderFeatureStageFailedError | RenderFeatureCapabilityMissingError | RenderFeaturePassOrderConflictError | RenderFeaturePreparationFailedError | RenderFeaturePreparedStateMismatchError | RenderFeatureDrawRecordingFailedError | EnvironmentSourceConflictError | FogCardinalityError | TaaCapsInsufficientError | EnvironmentGenerationFailedError | AtmosphereInvalidParameterError | OwnerStageFailedError | PointsLinesInvalidStyleError | PointsLinesTopologyMismatchError | PointsLinesStyleUnsupportedError | PointsLinesMaterialUnsupportedError | PointsLinesBudgetExceededError | PointsLinesPrepareFailedError | LightResourceUnavailableError | RenderTargetDescriptorInvalidError | RenderTargetCapabilityMissingError | RenderTargetStateInvalidError | RenderTargetOperationFailedError | ReflectionProbeBudgetExceededError | RenderIntentInvalidError | ProjectorBindingError | VolumeError;
 //# sourceMappingURL=render.d.ts.map