@forgeax/engine-render 0.1.28 → 0.1.30

package/dist/internal.mjs

@@ -1,14 +1,14 @@
-export { PROBE_MAX_CONTRIBUTORS, admitProbeContributors, blendLightProbes, buildRectAreaWorldFrame, createExtendedLightingState, projectExtendedLightingInspection, promoteExtendedLightingCandidate, recordExtendedLightingFailure, rectAreaFacesPoint, scaledProbeWeight, setOcclusionRuntimeTestHooks } from './chunk-VSL23LZE.mjs';
+export { PROBE_MAX_CONTRIBUTORS, SSR_HISTORY_FORMAT, SsrHistoryOwner, admitProbeContributors, blendLightProbes, buildRectAreaWorldFrame, createExtendedLightingState, createSsrHistoryOwner, estimateSsrSpatialMemory, projectExtendedLightingInspection, promoteExtendedLightingCandidate, recordExtendedLightingFailure, rectAreaFacesPoint, scaledProbeWeight, setOcclusionRuntimeTestHooks } from './chunk-C3DDSXYK.mjs';
 import './chunk-ILQ5MEZF.mjs';
-export { createVisibilityBudget } from './chunk-JAASCMXA.mjs';
-import './chunk-RBDBZ5R7.mjs';
-export { TemporalFrameCoordinator } from './chunk-GE3SDD72.mjs';
-import { EXTENDED_LIGHTING_TOPOLOGY } from './chunk-IQMKJLNU.mjs';
-export { DeviceScope, EXTENDED_LIGHTING_REQUIRED_SAMPLED_TEXTURES, deriveExtendedLightingCapability, extendedLightingSampledTextureCapacityAvailable, validateGraphTargetCaptureReadback } from './chunk-IQMKJLNU.mjs';
-export { createLightResourceUnavailable } from './chunk-J6KACNOH.mjs';
+import './chunk-S5UE2T5P.mjs';
+import './chunk-PA5DRJNI.mjs';
+export { TemporalFrameCoordinator } from './chunk-MDQJPY3T.mjs';
+import { EXTENDED_LIGHTING_TOPOLOGY } from './chunk-FUUO4UND.mjs';
+export { DeviceScope, EXTENDED_LIGHTING_REQUIRED_SAMPLED_TEXTURES, deriveExtendedLightingCapability, extendedLightingSampledTextureCapacityAvailable, validateGraphTargetCaptureReadback } from './chunk-FUUO4UND.mjs';
+export { createLightResourceUnavailable, createVisibilityBudget } from './chunk-JRBDO2KB.mjs';
 export { resolveTilesetRuntime } from '@forgeax/engine-assets-runtime';
 import '@forgeax/engine-shader';
-import '@forgeax/engine-types';
+import { ok, err } from '@forgeax/engine-types';
 
 function deriveLtcResourcePlan(input) {
   const admitted = input.ltcAvailable;
@@ -20,7 +20,115 @@ function deriveLtcResourcePlan(input) {
     uploadCount: admitted && input.residentGeneration !== input.scope.generation ? 2 : 0
   };
 }
+function stageFromError(cause) {
+  if (typeof cause === "object" && cause !== null && "stage" in cause) {
+    const stage = cause.stage;
+    if (stage === "build" || stage === "encode" || stage === "finish" || stage === "submit") {
+      return stage;
+    }
+  }
+  return "submit";
+}
+function coordinatorInput(input) {
+  const consumerIds = input.consumerIds?.includes("ssr") ? input.consumerIds : [...input.consumerIds ?? [], "ssr"];
+  return { ...input, temporalDemand: true, consumerIds };
+}
+function resetCoordinator(coordinator, reason) {
+  switch (reason) {
+    case "first-enable":
+    case "disable":
+      return;
+    case "resize":
+      coordinator.reset("resize");
+      return;
+    case "camera-cut":
+      coordinator.reset("cut");
+      return;
+    case "history-version":
+      coordinator.reset("camera-switch");
+      return;
+    case "coverage-loss":
+      coordinator.reset("detach");
+      return;
+    case "reflection-generation":
+    case "device-recovery":
+      coordinator.reset("device-generation");
+      return;
+  }
+}
+var SsrTemporalConsumer = class {
+  constructor(coordinator, history) {
+    this.coordinator = coordinator;
+    this.history = history;
+  }
+  coordinator;
+  history;
+  begin(input) {
+    const history = this.history.beginFrame();
+    if (!history.ok) return history;
+    const temporal = this.coordinator.begin(coordinatorInput(input));
+    if (!temporal.ok) {
+      this.history.abortFrame(history.value, "build");
+      return temporal;
+    }
+    return ok({ temporal: temporal.value, history: history.value });
+  }
+  commit(candidate) {
+    const committed = this.coordinator.commit(candidate.temporal);
+    if (!committed.ok) {
+      this.history.abortFrame(candidate.history, "submit");
+      return committed;
+    }
+    const history = this.history.commitFrame(candidate.history);
+    if (!history.ok) return history;
+    return committed;
+  }
+  abort(candidate, stage) {
+    this.history.abortFrame(candidate.history, stage);
+    this.coordinator.abort(candidate.temporal, stage);
+  }
+  run(input, phases) {
+    const started = this.begin(input);
+    if (!started.ok) return started;
+    const candidate = started.value;
+    try {
+      const built = phases.build();
+      phases.encode(built);
+      phases.finish();
+      phases.submit();
+    } catch (cause) {
+      const stage = stageFromError(cause);
+      this.abort(candidate, stage);
+      return err({
+        code: "ssr-temporal-stage-failed",
+        expected: `SSR temporal ${stage} succeeds before commit`,
+        hint: "inspect the owned stage failure and retry without promoting the candidate",
+        detail: { stage, cause }
+      });
+    }
+    return this.commit(candidate);
+  }
+  reset(reason) {
+    this.history.reset(reason);
+    resetCoordinator(this.coordinator, reason);
+  }
+  retireAfterFence(queue, onFailure) {
+    this.history.retireAfterFence(queue, onFailure);
+  }
+  inspect() {
+    const temporal = this.coordinator.inspect();
+    return Object.freeze({
+      sharedEpoch: temporal.epoch,
+      consumerIds: temporal.consumerIds,
+      coordinatorAttempt: temporal.attempt,
+      history: this.history.inspect()
+    });
+  }
+};
+function createSsrTemporalConsumer(coordinator, history) {
+  return new SsrTemporalConsumer(coordinator, history);
+}
 
-export { deriveLtcResourcePlan };
+export { SsrTemporalConsumer, createSsrTemporalConsumer, deriveLtcResourcePlan };
 //# sourceMappingURL=internal.mjs.map
 //# sourceMappingURL=internal.mjs.map

package/dist/internal.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/prepare/extended-lighting/ltc-resources.ts"],"names":[],"mappings":";;;;;;;;;;;;AAoCO,SAAS,sBAAsB,KAAA,EAA8C;AAClF,EAAA,MAAM,WAAW,KAAA,CAAM,YAAA;AACvB,EAAA,OAAO;AAAA,IACL,QAAA,EAAU,0BAAA;AAAA,IACV,UAAA,EAAY,MAAM,KAAA,CAAM,UAAA;AAAA,IACxB,aAAA,EAAe,WAAW,UAAA,GAAa,SAAA;AAAA,IACvC,UAAA,EAAY,WAAW,CAAA,GAAI,CAAA;AAAA,IAC3B,aAAa,QAAA,IAAY,KAAA,CAAM,uBAAuB,KAAA,CAAM,KAAA,CAAM,aAAa,CAAA,GAAI;AAAA,GACrF;AACF","file":"internal.mjs","sourcesContent":["// @forgeax/engine-render - DeviceScope-owned RectArea LTC resources.\n\nimport type { Result, RhiDevice, RhiError, Texture } from '@forgeax/engine-rhi';\nimport { LTC_TABLE_HEIGHT, LTC_TABLE_WIDTH, LTC_TABLES } from '@forgeax/engine-shader';\nimport { err, ok } from '@forgeax/engine-types';\nimport { type DeviceScope, LifecycleTransaction } from '../../device/device-scope';\nimport {\n  GPU_TEXTURE_USAGE_COPY_DST,\n  GPU_TEXTURE_USAGE_TEXTURE_BINDING,\n} from '../../gpu-texture-usage';\nimport { deriveExtendedLightingCapability, EXTENDED_LIGHTING_TOPOLOGY } from './resources';\n\nexport interface LtcResourcePlanInput {\n  readonly scope: DeviceScope;\n  readonly ltcAvailable: boolean;\n  readonly residentGeneration?: number;\n}\n\nexport interface LtcResourcePlan {\n  readonly topology: typeof EXTENDED_LIGHTING_TOPOLOGY;\n  readonly generation: number;\n  readonly rectAdmission: 'admitted' | 'omitted';\n  readonly tableCount: number;\n  readonly uploadCount: number;\n}\n\nexport interface LtcResourceCandidate {\n  readonly topology: typeof EXTENDED_LIGHTING_TOPOLOGY;\n  readonly generation: number;\n  readonly scope: DeviceScope;\n  readonly lambertTexture: Texture;\n  readonly ggxTexture: Texture;\n  readonly tableCount: 2;\n  readonly uploadCount: 2;\n}\n\nexport function deriveLtcResourcePlan(input: LtcResourcePlanInput): LtcResourcePlan {\n  const admitted = input.ltcAvailable;\n  return {\n    topology: EXTENDED_LIGHTING_TOPOLOGY,\n    generation: input.scope.generation,\n    rectAdmission: admitted ? 'admitted' : 'omitted',\n    tableCount: admitted ? 2 : 0,\n    uploadCount: admitted && input.residentGeneration !== input.scope.generation ? 2 : 0,\n  };\n}\n\nfunction failure(expected: string, actual: string): Result<never, RhiError> {\n  return err({\n    code: 'webgpu-runtime-error',\n    expected,\n    hint: 'inspect device capabilities and retry the extendedLighting candidate',\n    detail: { error: { code: 'ltc-resource', message: actual } },\n  } as RhiError);\n}\n\nfunction textureBytes(table: Uint16Array): Uint8Array {\n  return new Uint8Array(table.buffer, table.byteOffset, table.byteLength);\n}\n\n/** Create both tracked tables atomically; unavailable LTC only omits Rect. */\nexport async function createLtcResourceCandidate(input: {\n  readonly device: RhiDevice | undefined;\n  readonly scope: DeviceScope;\n}): Promise<Result<LtcResourceCandidate | undefined, RhiError>> {\n  if (input.device === undefined) return ok(undefined);\n  if (!deriveExtendedLightingCapability(input.device).admitted) return ok(undefined);\n  const device = input.device;\n\n  const transaction = new LifecycleTransaction(input.scope);\n  let lambertTexture: Texture | undefined;\n  let ggxTexture: Texture | undefined;\n  const createTable = (label: string, table: Uint16Array): Texture => {\n    const texture = device.createTexture({\n      label,\n      size: { width: LTC_TABLE_WIDTH, height: LTC_TABLE_HEIGHT, depthOrArrayLayers: 1 },\n      mipLevelCount: 1,\n      sampleCount: 1,\n      dimension: '2d',\n      format: 'rgba16float',\n      usage: GPU_TEXTURE_USAGE_COPY_DST | GPU_TEXTURE_USAGE_TEXTURE_BINDING,\n      viewFormats: [],\n      textureBindingViewDimension: undefined,\n    });\n    if (texture === undefined || !texture.ok) {\n      throw texture?.error ?? new Error('LTC texture creation returned no result');\n    }\n    const write = device.queue.writeTexture(\n      { texture: texture.value, mipLevel: 0, origin: { x: 0, y: 0, z: 0 } },\n      textureBytes(table),\n      { offset: 0, bytesPerRow: LTC_TABLE_WIDTH * 8, rowsPerImage: LTC_TABLE_HEIGHT },\n      { width: LTC_TABLE_WIDTH, height: LTC_TABLE_HEIGHT, depthOrArrayLayers: 1 },\n    );\n    if (!write.ok) throw write.error;\n    return texture.value;\n  };\n\n  transaction.add({\n    kind: 'texture',\n    create: () => {\n      lambertTexture = createTable('extended-lighting-ltc-lambert', LTC_TABLES.lambert);\n      return lambertTexture;\n    },\n    cleanup: (value) => {\n      const destroyed = input.device?.destroyTexture(value);\n      if (destroyed !== undefined && !destroyed.ok) throw destroyed.error;\n    },\n  });\n  transaction.add({\n    kind: 'texture',\n    create: () => {\n      ggxTexture = createTable('extended-lighting-ltc-ggx', LTC_TABLES.ggx);\n      return ggxTexture;\n    },\n    cleanup: (value) => {\n      const destroyed = input.device?.destroyTexture(value);\n      if (destroyed !== undefined && !destroyed.ok) throw destroyed.error;\n    },\n  });\n\n  const committed = await transaction.commit();\n  if (!committed.ok)\n    return failure(committed.error.primary.expected, committed.error.primary.message);\n  if (lambertTexture === undefined || ggxTexture === undefined) {\n    return failure('two LTC textures', 'the transaction committed without both tables');\n  }\n  return ok({\n    topology: EXTENDED_LIGHTING_TOPOLOGY,\n    generation: input.scope.generation,\n    scope: input.scope,\n    lambertTexture,\n    ggxTexture,\n    tableCount: 2,\n    uploadCount: 2,\n  });\n}\n"]}
+{"version":3,"sources":["../src/prepare/extended-lighting/ltc-resources.ts","../src/ssr/temporal.ts"],"names":["ok","err"],"mappings":"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","file":"internal.mjs","sourcesContent":["// @forgeax/engine-render - DeviceScope-owned RectArea LTC resources.\n\nimport type { Result, RhiDevice, RhiError, Texture } from '@forgeax/engine-rhi';\nimport { LTC_TABLE_HEIGHT, LTC_TABLE_WIDTH, LTC_TABLES } from '@forgeax/engine-shader';\nimport { err, ok } from '@forgeax/engine-types';\nimport { type DeviceScope, LifecycleTransaction } from '../../device/device-scope';\nimport {\n  GPU_TEXTURE_USAGE_COPY_DST,\n  GPU_TEXTURE_USAGE_TEXTURE_BINDING,\n} from '../../gpu-texture-usage';\nimport { deriveExtendedLightingCapability, EXTENDED_LIGHTING_TOPOLOGY } from './resources';\n\nexport interface LtcResourcePlanInput {\n  readonly scope: DeviceScope;\n  readonly ltcAvailable: boolean;\n  readonly residentGeneration?: number;\n}\n\nexport interface LtcResourcePlan {\n  readonly topology: typeof EXTENDED_LIGHTING_TOPOLOGY;\n  readonly generation: number;\n  readonly rectAdmission: 'admitted' | 'omitted';\n  readonly tableCount: number;\n  readonly uploadCount: number;\n}\n\nexport interface LtcResourceCandidate {\n  readonly topology: typeof EXTENDED_LIGHTING_TOPOLOGY;\n  readonly generation: number;\n  readonly scope: DeviceScope;\n  readonly lambertTexture: Texture;\n  readonly ggxTexture: Texture;\n  readonly tableCount: 2;\n  readonly uploadCount: 2;\n}\n\nexport function deriveLtcResourcePlan(input: LtcResourcePlanInput): LtcResourcePlan {\n  const admitted = input.ltcAvailable;\n  return {\n    topology: EXTENDED_LIGHTING_TOPOLOGY,\n    generation: input.scope.generation,\n    rectAdmission: admitted ? 'admitted' : 'omitted',\n    tableCount: admitted ? 2 : 0,\n    uploadCount: admitted && input.residentGeneration !== input.scope.generation ? 2 : 0,\n  };\n}\n\nfunction failure(expected: string, actual: string): Result<never, RhiError> {\n  return err({\n    code: 'webgpu-runtime-error',\n    expected,\n    hint: 'inspect device capabilities and retry the extendedLighting candidate',\n    detail: { error: { code: 'ltc-resource', message: actual } },\n  } as RhiError);\n}\n\nfunction textureBytes(table: Uint16Array): Uint8Array {\n  return new Uint8Array(table.buffer, table.byteOffset, table.byteLength);\n}\n\n/** Create both tracked tables atomically; unavailable LTC only omits Rect. */\nexport async function createLtcResourceCandidate(input: {\n  readonly device: RhiDevice | undefined;\n  readonly scope: DeviceScope;\n}): Promise<Result<LtcResourceCandidate | undefined, RhiError>> {\n  if (input.device === undefined) return ok(undefined);\n  if (!deriveExtendedLightingCapability(input.device).admitted) return ok(undefined);\n  const device = input.device;\n\n  const transaction = new LifecycleTransaction(input.scope);\n  let lambertTexture: Texture | undefined;\n  let ggxTexture: Texture | undefined;\n  const createTable = (label: string, table: Uint16Array): Texture => {\n    const texture = device.createTexture({\n      label,\n      size: { width: LTC_TABLE_WIDTH, height: LTC_TABLE_HEIGHT, depthOrArrayLayers: 1 },\n      mipLevelCount: 1,\n      sampleCount: 1,\n      dimension: '2d',\n      format: 'rgba16float',\n      usage: GPU_TEXTURE_USAGE_COPY_DST | GPU_TEXTURE_USAGE_TEXTURE_BINDING,\n      viewFormats: [],\n      textureBindingViewDimension: undefined,\n    });\n    if (texture === undefined || !texture.ok) {\n      throw texture?.error ?? new Error('LTC texture creation returned no result');\n    }\n    const write = device.queue.writeTexture(\n      { texture: texture.value, mipLevel: 0, origin: { x: 0, y: 0, z: 0 } },\n      textureBytes(table),\n      { offset: 0, bytesPerRow: LTC_TABLE_WIDTH * 8, rowsPerImage: LTC_TABLE_HEIGHT },\n      { width: LTC_TABLE_WIDTH, height: LTC_TABLE_HEIGHT, depthOrArrayLayers: 1 },\n    );\n    if (!write.ok) throw write.error;\n    return texture.value;\n  };\n\n  transaction.add({\n    kind: 'texture',\n    create: () => {\n      lambertTexture = createTable('extended-lighting-ltc-lambert', LTC_TABLES.lambert);\n      return lambertTexture;\n    },\n    cleanup: (value) => {\n      const destroyed = input.device?.destroyTexture(value);\n      if (destroyed !== undefined && !destroyed.ok) throw destroyed.error;\n    },\n  });\n  transaction.add({\n    kind: 'texture',\n    create: () => {\n      ggxTexture = createTable('extended-lighting-ltc-ggx', LTC_TABLES.ggx);\n      return ggxTexture;\n    },\n    cleanup: (value) => {\n      const destroyed = input.device?.destroyTexture(value);\n      if (destroyed !== undefined && !destroyed.ok) throw destroyed.error;\n    },\n  });\n\n  const committed = await transaction.commit();\n  if (!committed.ok)\n    return failure(committed.error.primary.expected, committed.error.primary.message);\n  if (lambertTexture === undefined || ggxTexture === undefined) {\n    return failure('two LTC textures', 'the transaction committed without both tables');\n  }\n  return ok({\n    topology: EXTENDED_LIGHTING_TOPOLOGY,\n    generation: input.scope.generation,\n    scope: input.scope,\n    lambertTexture,\n    ggxTexture,\n    tableCount: 2,\n    uploadCount: 2,\n  });\n}\n","import { err, ok, type Result } from '@forgeax/engine-types';\nimport type {\n  TemporalFrameBeginInput,\n  TemporalFrameCandidate,\n  TemporalFrameConsumerId,\n  TemporalFrameCoordinator,\n  TemporalFrameError,\n  TemporalFramePhases,\n  TemporalFrameReceipt,\n  TemporalFrameStage,\n} from '../temporal/frame-coordinator';\nimport type {\n  SsrHistoryCandidate,\n  SsrHistoryError,\n  SsrHistoryFailureStage,\n  SsrHistoryInspection,\n  SsrHistoryOwner,\n  SsrHistoryResetReason,\n} from './history';\n\nexport interface SsrTemporalCandidate<T> {\n  readonly temporal: TemporalFrameCandidate<T>;\n  readonly history: SsrHistoryCandidate;\n}\nexport interface SsrTemporalExecutionError {\n  readonly code: 'ssr-temporal-stage-failed';\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: Readonly<{ readonly stage: TemporalFrameStage; readonly cause: unknown }>;\n}\nexport interface SsrTemporalInspection {\n  readonly sharedEpoch: number;\n  readonly consumerIds: readonly TemporalFrameConsumerId[];\n  readonly coordinatorAttempt: 'none' | 'active' | 'committed' | 'aborted';\n  readonly history: SsrHistoryInspection;\n}\nexport type SsrTemporalError = TemporalFrameError | SsrHistoryError | SsrTemporalExecutionError;\n\nfunction stageFromError(cause: unknown): TemporalFrameStage {\n  if (typeof cause === 'object' && cause !== null && 'stage' in cause) {\n    const stage = (cause as { readonly stage?: unknown }).stage;\n    if (stage === 'build' || stage === 'encode' || stage === 'finish' || stage === 'submit') {\n      return stage;\n    }\n  }\n  return 'submit';\n}\nfunction coordinatorInput<T>(input: TemporalFrameBeginInput<T>): TemporalFrameBeginInput<T> {\n  const consumerIds = input.consumerIds?.includes('ssr')\n    ? input.consumerIds\n    : [...(input.consumerIds ?? []), 'ssr' as const];\n  return { ...input, temporalDemand: true, consumerIds };\n}\nfunction resetCoordinator<T>(\n  coordinator: TemporalFrameCoordinator<T>,\n  reason: SsrHistoryResetReason,\n): void {\n  switch (reason) {\n    case 'first-enable':\n    case 'disable':\n      return;\n    case 'resize':\n      coordinator.reset('resize');\n      return;\n    case 'camera-cut':\n      coordinator.reset('cut');\n      return;\n    case 'history-version':\n      coordinator.reset('camera-switch');\n      return;\n    case 'coverage-loss':\n      coordinator.reset('detach');\n      return;\n    case 'reflection-generation':\n    case 'device-recovery':\n      coordinator.reset('device-generation');\n      return;\n  }\n}\n\n/** Stages SSR history beside the shared renderer transaction without owning submit or epochs. */\nexport class SsrTemporalConsumer<T = unknown> {\n  constructor(\n    private readonly coordinator: TemporalFrameCoordinator<T>,\n    readonly history: SsrHistoryOwner,\n  ) {}\n  begin(\n    input: TemporalFrameBeginInput<T>,\n  ): Result<SsrTemporalCandidate<T>, TemporalFrameError | SsrHistoryError> {\n    const history = this.history.beginFrame();\n    if (!history.ok) return history;\n    const temporal = this.coordinator.begin(coordinatorInput(input));\n    if (!temporal.ok) {\n      this.history.abortFrame(history.value, 'build');\n      return temporal;\n    }\n    return ok({ temporal: temporal.value, history: history.value });\n  }\n  commit(\n    candidate: SsrTemporalCandidate<T>,\n  ): Result<TemporalFrameReceipt<T>, TemporalFrameError | SsrHistoryError> {\n    const committed = this.coordinator.commit(candidate.temporal);\n    if (!committed.ok) {\n      this.history.abortFrame(candidate.history, 'submit');\n      return committed;\n    }\n    const history = this.history.commitFrame(candidate.history);\n    if (!history.ok) return history;\n    return committed;\n  }\n  abort(candidate: SsrTemporalCandidate<T>, stage: SsrHistoryFailureStage): void {\n    this.history.abortFrame(candidate.history, stage);\n    this.coordinator.abort(candidate.temporal, stage);\n  }\n  run(\n    input: TemporalFrameBeginInput<T>,\n    phases: TemporalFramePhases<T>,\n  ): Result<TemporalFrameReceipt<T>, SsrTemporalError> {\n    const started = this.begin(input);\n    if (!started.ok) return started;\n    const candidate = started.value;\n    try {\n      const built = phases.build();\n      phases.encode(built);\n      phases.finish();\n      phases.submit();\n    } catch (cause) {\n      const stage = stageFromError(cause);\n      this.abort(candidate, stage);\n      return err({\n        code: 'ssr-temporal-stage-failed',\n        expected: `SSR temporal ${stage} succeeds before commit`,\n        hint: 'inspect the owned stage failure and retry without promoting the candidate',\n        detail: { stage, cause },\n      });\n    }\n    return this.commit(candidate);\n  }\n  reset(reason: SsrHistoryResetReason): void {\n    this.history.reset(reason);\n    resetCoordinator(this.coordinator, reason);\n  }\n  retireAfterFence(\n    queue: Parameters<SsrHistoryOwner['retireAfterFence']>[0],\n    onFailure: Parameters<SsrHistoryOwner['retireAfterFence']>[1],\n  ): void {\n    this.history.retireAfterFence(queue, onFailure);\n  }\n  inspect(): SsrTemporalInspection {\n    const temporal = this.coordinator.inspect();\n    return Object.freeze({\n      sharedEpoch: temporal.epoch,\n      consumerIds: temporal.consumerIds,\n      coordinatorAttempt: temporal.attempt,\n      history: this.history.inspect(),\n    });\n  }\n}\nexport function createSsrTemporalConsumer<T>(\n  coordinator: TemporalFrameCoordinator<T>,\n  history: SsrHistoryOwner,\n): SsrTemporalConsumer<T> {\n  return new SsrTemporalConsumer(coordinator, history);\n}\n"]}

package/dist/lifecycle.d.ts

@@ -3,6 +3,7 @@ import type { RenderGraphError } from '@forgeax/engine-render-graph';
 import type { RhiError } from '@forgeax/engine-rhi';
 import type { SkinError } from '@forgeax/engine-skinning';
 import type { ImageError } from '@forgeax/engine-types';
+import type { GpuDrivenPreparationError } from './errors/gpu-driven';
 import type { RenderError } from './errors/render';
 import type { PostProcessError } from './post-process-errors';
 export interface RendererLostInfo {
@@ -10,7 +11,7 @@ export interface RendererLostInfo {
     readonly message: string;
 }
 export type RendererLostListener = (info: RendererLostInfo) => void;
-export type RendererError = RhiError | RenderGraphError | ImageError | RenderError | AssetRuntimeError | SkinError | PostProcessError;
+export type RendererError = RhiError | RenderGraphError | ImageError | RenderError | GpuDrivenPreparationError | AssetRuntimeError | SkinError | PostProcessError;
 export type RendererErrorListener = (error: RendererError) => void;
 export type HealthReason = 'alive' | 'device-lost' | 'internal-fault';
 export interface HealthDetailDeviceLost {

package/dist/lifecycle.d.ts.map

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

package/dist/material-row.d.ts

@@ -0,0 +1,15 @@
+import { type MaterialShaderArtifactReceipt } from '@forgeax/engine-shader';
+import { type ParamSchemaEntry } from '@forgeax/engine-types';
+import type { MaterialSnapshot } from './render-system-extract';
+/** Pack the producer receipt's numeric Standard PBR row into the GPU Scene table. */
+export declare function packStandardPbrMaterialRow(receipt: MaterialShaderArtifactReceipt, material: MaterialSnapshot): Uint8Array;
+/**
+ * Pack any producer-owned numeric/coordinate schema into the shared GPU Scene
+ * row page. Resource handles are intentionally absent: the scene-index shader
+ * reads texture/sampler bindings from the ordinary material group while this
+ * row carries only the values its generated `MaterialParameters` struct owns.
+ * `undefined` means the schema exceeds the page and must remain outside the
+ * capable lane.
+ */
+export declare function packMaterialProgramRow(schema: readonly ParamSchemaEntry[], material: MaterialSnapshot, rowStride?: number): Uint8Array | undefined;
+//# sourceMappingURL=material-row.d.ts.map

package/dist/material-row.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-row.d.ts","sourceRoot":"","sources":["../src/material-row.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,6BAA6B,EAEnC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAU,KAAK,gBAAgB,EAAuB,MAAM,uBAAuB,CAAC;AAE3F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAoHhE,qFAAqF;AACrF,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,6BAA6B,EACtC,QAAQ,EAAE,gBAAgB,GACzB,UAAU,CA4BZ;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,gBAAgB,EAAE,EACnC,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,SAAa,GACrB,UAAU,GAAG,SAAS,CAyBxB"}

package/dist/materials.d.ts

@@ -1,5 +1,20 @@
 import type { MaterialAsset, MaterialColorSpace, MaterialParameter, MaterialRenderState, MaterialValue } from '@forgeax/engine-types';
 export type MaterialTransmissionValidationReason = 'non-finite' | 'range' | 'shape' | 'blend' | 'depth-write';
+export type MaterialAuthoringValidationReason = 'non-finite' | 'range';
+/** Structured authoring failure for a built-in Standard material parameter. */
+export declare class MaterialAuthoringContractError extends Error {
+    readonly code: "material-authoring-contract-invalid";
+    readonly expected = "Standard material authoring values are finite and within their declared ranges";
+    readonly hint = "repair the named Standard material parameter alphaCutoff before publishing the material";
+    readonly detail: {
+        readonly code: 'material-authoring-contract-invalid';
+        readonly material: 'Standard';
+        readonly parameter: 'alphaCutoff';
+        readonly reason: MaterialAuthoringValidationReason;
+        readonly actual?: unknown;
+    };
+    constructor(reason: MaterialAuthoringValidationReason, actual?: unknown);
+}
 /** Structured authoring failure for the Standard transmission contract. */
 export declare class MaterialTransmissionContractError extends Error {
     readonly code: "material-transmission-contract-invalid";

package/dist/materials.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"materials.d.ts","sourceRoot":"","sources":["../src/materials.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"materials.d.ts","sourceRoot":"","sources":["../src/materials.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EAEjB,mBAAmB,EACnB,aAAa,EACd,MAAM,uBAAuB,CAAC;AAO/B,MAAM,MAAM,oCAAoC,GAC5C,YAAY,GACZ,OAAO,GACP,OAAO,GACP,OAAO,GACP,aAAa,CAAC;AAElB,MAAM,MAAM,iCAAiC,GAAG,YAAY,GAAG,OAAO,CAAC;AAEvE,+EAA+E;AAC/E,qBAAa,8BAA+B,SAAQ,KAAK;IACvD,QAAQ,CAAC,IAAI,EAAG,qCAAqC,CAAU;IAC/D,QAAQ,CAAC,QAAQ,oFACkE;IACnF,QAAQ,CAAC,IAAI,6FAC+E;IAC5F,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,IAAI,EAAE,qCAAqC,CAAC;QACrD,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;QAC9B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;QAClC,QAAQ,CAAC,MAAM,EAAE,iCAAiC,CAAC;QACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;gBAEU,MAAM,EAAE,iCAAiC,EAAE,MAAM,CAAC,EAAE,OAAO;CAWxE;AAED,2EAA2E;AAC3E,qBAAa,iCAAkC,SAAQ,KAAK;IAC1D,QAAQ,CAAC,IAAI,EAAG,wCAAwC,CAAU;IAClE,QAAQ,CAAC,QAAQ,gFAAgF;IACjG,QAAQ,CAAC,IAAI,sFACwE;IACrF,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,IAAI,EAAE,wCAAwC,CAAC;QACxD,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;QAC9B,QAAQ,CAAC,SAAS,EACd,cAAc,GACd,KAAK,GACL,WAAW,GACX,kBAAkB,GAClB,qBAAqB,CAAC;QAC1B,QAAQ,CAAC,MAAM,EAAE,oCAAoC,CAAC;QACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;gBAGA,SAAS,EAAE,CAAC,OAAO,iCAAiC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,EACnF,MAAM,EAAE,oCAAoC,EAC5C,MAAM,CAAC,EAAE,OAAO;CAYnB;AAED,eAAO,MAAM,gCAAgC,EAAE,aAG9C,CAAC;AAGF,QAAA,MAAM,aAAa,6BAA6B,CAAC;AAEjD,MAAM,MAAM,mBAAmB,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACpE,MAAM,MAAM,mBAAmB,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC5E,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,GAAG,MAAM,GAAG,MAAM,CAAC;AACxE,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,GAAG,MAAM,GAAG,MAAM,CAAC;AA0BxE,oFAAoF;AACpF,wBAAgB,IAAI,CAAC,KAAK,EAAE,mBAAmB,GAAG,mBAAmB,CAAC;AACtE,wBAAgB,IAAI,CAAC,KAAK,EAAE,mBAAmB,GAAG,mBAAmB,CAAC;AAwNtE,UAAU,SAAS;IACjB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,iBAAS,KAAK,CAAC,IAAI,EAAE,mBAAmB,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,aAAa,CAoBzE;AAED,UAAU,YAAY;IACpB,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,4EAA4E;IAC5E,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAC;IAC1C,QAAQ,CAAC,yBAAyB,CAAC,EAAE,aAAa,CAAC;IACnD,QAAQ,CAAC,sBAAsB,CAAC,EAAE,aAAa,CAAC;IAChD,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,aAAa,CAAC;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,mBAAmB,CAAC;IAC1C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,aAAa,CAAC;IAC3C,QAAQ,CAAC,qBAAqB,CAAC,EAAE,aAAa,CAAC;IAC/C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAC9C,QAAQ,CAAC,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAC9C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,aAAa,CAAC;IAC5C,QAAQ,CAAC,2BAA2B,CAAC,EAAE,aAAa,CAAC;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,mBAAmB,CAAC;IAC7C,QAAQ,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC;IACzC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,aAAa,CAAC;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC;IACzC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAC;IAC1C,QAAQ,CAAC,wBAAwB,CAAC,EAAE,aAAa,CAAC;IAClD,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IACvC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,aAAa,CAAC;IAC7C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAC;IAC1C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9D,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,gFAAgF;AAChF,MAAM,WAAW,sBAAuB,SAAQ,YAAY;IAC1D,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC;CACzB;AAED,+FAA+F;AAC/F,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC;IAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC;IACjC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,KAAK,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC;IAC3B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,KAAK,CAAC;IACpC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,KAAK,CAAC;IAClC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,KAAK,CAAC;IAC3C,QAAQ,CAAC,sBAAsB,CAAC,EAAE,KAAK,CAAC;IACxC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,KAAK,CAAC;IACtC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,KAAK,CAAC;IACpC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,KAAK,CAAC;IACpC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC;IAChC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAC;IACnC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,KAAK,CAAC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC;IAChC,QAAQ,CAAC,2BAA2B,CAAC,EAAE,KAAK,CAAC;IAC7C,QAAQ,CAAC,2BAA2B,CAAC,EAAE,KAAK,CAAC;IAC7C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,KAAK,CAAC;IACpC,QAAQ,CAAC,2BAA2B,CAAC,EAAE,KAAK,CAAC;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;IAC1B,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC;IACjC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,KAAK,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAC;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC;IACjC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,KAAK,CAAC;IAClC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,KAAK,CAAC;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,KAAK,CAAC;IAClC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC;IAC9B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,KAAK,CAAC;IACrC,QAAQ,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,KAAK,CAAC;IAClC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,KAAK,CAAC;IAClC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,KAAK,CAAC;CACtC;AAED,MAAM,MAAM,eAAe,GAAG,sBAAsB,GAAG,4BAA4B,CAAC;AA+KpF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa,CAEhE;AAED,eAAO,MAAM,SAAS;;;;CAAqC,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/pbr-pipeline.d.ts

@@ -97,7 +97,7 @@ export declare const INJECTION_KIND_LENGTHS: {
     transmission: number;
 };
 export declare function physicalTextureFields(paramSchema: readonly ParamSchemaEntry[]): readonly string[];
-export declare function appendTextureInjection(bgl: readonly GPUBindGroupLayoutEntry[], fields: readonly string[]): GPUBindGroupLayoutEntry[];
+export declare function appendTextureInjection(_bgl: readonly GPUBindGroupLayoutEntry[], fields: readonly string[]): GPUBindGroupLayoutEntry[];
 /**
  * Return the stable identity of the merged material bind-group layout.
  *
@@ -125,6 +125,8 @@ export interface PbrCaps {
     readonly probeBlend?: boolean;
     /** Whether the device can carry the optional SpotLight projector texture. */
     readonly projectorAvailable?: boolean;
+    /** Omit unused backdrop slots on minimum-limit devices; physical slots stay fixed. */
+    readonly transmissionBackdrop?: boolean;
 }
 /**
  * The view BGL entry list. binding 0 = view UBO (vertex + fragment);
@@ -139,7 +141,7 @@ export interface PbrCaps {
  *   fragment-only). feat-20260612-point-light-shadows-urp-hdrp Round-2 F-1.
  * binding 6 = point shadow params UBO (`array<vec4<f32>, 4>`, 64 B;
  *   fragment-only). One lane per shadow-casting point light slot
- *   (shadowAtlasLayer in [0, 4)) carrying `(near, far, 1/(far-near), 0)`.
+ *   (shadowAtlasLayer in [0, 4)) carrying `(near, far, depthBias, normalBias)`.
  * binding 7 = shadowCasterCascade UBO (16 B; vertex + fragment). Per-pass
  *   cascade-index uniform consumed exclusively by `shadow_caster.wgsl` to
  *   pick `view.lightViewProj_X` for the cascade currently being rasterized
@@ -197,7 +199,7 @@ export declare function buildPbrPipelineLayouts(device: PbrPipelineDevice, caps:
 export declare const SKIN_MATERIAL_SHADER_ID: "forgeax::pbr-skin";
 export declare const SHADOW_CASTER_SHADER_ID: "forgeax::default-shadow-caster";
 export declare function isStandardPbrSkinMaterialShader(shaderId: string | undefined): boolean;
-export declare function shadowCasterVariantSet(storageBuffer: boolean, skinned: boolean): string;
+export declare function shadowCasterVariantSet(storageBuffer: boolean, skinned: boolean, gpuDrivenSceneIndex?: boolean, alphaMask?: boolean, vertexColorAvailable?: boolean): string;
 export declare function isSkinnedShadowCasterVariant(materialShaderId: string | undefined, variantSet: string | undefined): boolean;
 export type PipelineGroup2Contract = 'mesh' | 'skin' | 'cluster' | 'skin-cluster';
 /** Resolve group(2) from the composed WGSL artifact used to build the PSO. */
@@ -224,6 +226,20 @@ export declare function isCanonicalStandardPbrMaterialShader(shaderId: string |
  * to fold the throw into the structured error pipe.
  */
 export declare function buildPbrSkinLayouts(device: PbrPipelineDevice, caps: PbrCaps, pbr: PbrPipelineLayoutBundle): PbrPipelineLayoutBundle;
+/**
+ * Build the dedicated slot-3 layout used by scene-index GPU-driven draws.
+ *
+ * Direct material draws deliberately keep `pbr-instances-bgl` at binding(0),
+ * and ProbeBlend deliberately owns binding(1).  The scene-index stream is
+ * therefore a separate BGL at binding(2), rather than an optional entry added
+ * to the direct layout.  This keeps every bind group complete for its shader
+ * and prevents a direct draw from having to bind a dummy visible stream.
+ */
+export declare function buildGpuDrivenPbrInstancesBindGroupLayout(device: PbrPipelineDevice, caps: PbrCaps): BindGroupLayout;
+/** Build the four-slot rigid scene-index pipeline layout. */
+export declare function buildGpuDrivenPbrPipelineLayout(device: PbrPipelineDevice, pbr: PbrPipelineLayoutBundle, gpuDrivenInstancesBgl: BindGroupLayout): PipelineLayout;
+/** Build the four-slot skinned scene-index pipeline layout. */
+export declare function buildGpuDrivenPbrSkinPipelineLayout(device: PbrPipelineDevice, pbrSkin: PbrPipelineLayoutBundle, gpuDrivenInstancesBgl: BindGroupLayout): PipelineLayout;
 /** Project the canonical group(2) resources for a PBR skin draw. */
 export declare function createPbrSkinMeshBindGroupEntries(meshBuffer: Buffer, meshSize: number, paletteBuffer: Buffer, paletteWindowBytes: number): BindGroupEntry[];
 /** Project all dynamic offsets for the canonical PBR skin group(2) shape. */
@@ -303,7 +319,9 @@ export declare const SPRITE_PASS_PER_INSTANCE_REGION_VARIANT_SET = "";
  *      (directional 3/4, point 5/6, cascade 7, spot atlas 8; the former
  *      spot lightViewProj matrices moved into the View UBO)
  *    - `'pbr-mesh-array'` — 1 entry: per-entity mesh SSBO (dynamic-offset)
- *    - `'pbr-instances'` — 1 entry: per-instance SSBO (no dynamic-offset)
+ *    - `'pbr-instances'` — 2 entries: per-instance SSBO plus the compact
+ *      visible-item index stream (the second entry is used only by the
+ *      scene-index vertex entry and shares the frame's instance bind group)
  *    - `'pbr-skin-mesh-array'` — 3 entries: meshes + current/previous palette
  * 3. Attachment-driven (fullscreen post-process):
  *    - `'fullscreen-post'` — 2 entries: input texture + sampler. The texture
@@ -318,7 +336,7 @@ export declare const SPRITE_PASS_PER_INSTANCE_REGION_VARIANT_SET = "";
  *    - `'fullscreen-post-with-scene-depth-msaa'` — the depth-read layout with
  *      `texture.multisampled=true`, selected for a 4-sample scene depth target.
  */
-export type BglKind = 'pbr-view' | 'pbr-material-merged' | 'pbr-mesh-array' | 'pbr-instances' | 'pbr-skin-mesh-array' | 'unlit-material' | 'hdrp-7-slot' | 'fullscreen-post' | 'fullscreen-post-with-params' | 'fullscreen-post-with-scene-depth' | 'fullscreen-post-with-scene-depth-msaa';
+export type BglKind = 'pbr-view' | 'pbr-material-merged' | 'pbr-mesh-array' | 'pbr-instances' | 'pbr-gpu-driven-instances' | 'pbr-skin-mesh-array' | 'unlit-material' | 'hdrp-7-slot' | 'fullscreen-post' | 'fullscreen-post-with-params' | 'fullscreen-post-with-scene-depth' | 'fullscreen-post-with-scene-depth-msaa';
 /**
  * Output shape of {@link buildBindGroupLayoutDescriptor}: matches the RHI
  * `BindGroupLayoutDescriptor` (label + entries with `ExplicitUndefined`) so

package/dist/pbr-pipeline.d.ts.map

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

package/dist/pipeline/render-extent.d.ts

@@ -0,0 +1,51 @@
+/** Immutable dimensions shared by every Standard graph consumer. */
+export interface RenderExtent {
+    readonly outputWidth: number;
+    readonly outputHeight: number;
+    readonly internalWidth: number;
+    readonly internalHeight: number;
+    readonly scale: number;
+    readonly generation: number;
+}
+export interface RenderExtentInput {
+    readonly outputWidth: number;
+    readonly outputHeight: number;
+    readonly requestedScale: number;
+    readonly generation: number;
+}
+export type RenderExtentDomain = 'internal' | 'output' | 'authoring';
+/** Project the immutable extent into a graph texture descriptor size. */
+export declare function renderExtentSize(extent: RenderExtent, domain: RenderExtentDomain): {
+    readonly width: number;
+    readonly height: number;
+};
+export type StandardLightingLane = 'direct' | 'clustered' | 'cpu-webgl2';
+export interface StandardExtentDomainPlan {
+    readonly extent: RenderExtent;
+    readonly lane: StandardLightingLane;
+    readonly topologyKey: string;
+    readonly dynamicDelta: 0 | 1;
+    readonly domains: {
+        readonly internal: {
+            readonly width: number;
+            readonly height: number;
+        };
+        readonly output: {
+            readonly width: number;
+            readonly height: number;
+        };
+        readonly authoring: {
+            readonly width: number;
+            readonly height: number;
+        };
+    };
+    readonly resources: readonly {
+        readonly name: string;
+        readonly domain: 'internal' | 'output' | 'authoring';
+    }[];
+}
+/** Derive the one immutable Standard extent before graph construction. */
+export declare function deriveRenderExtent(input: RenderExtentInput): RenderExtent;
+/** Describe Standard's shared internal/output/authoring domain assignment. */
+export declare function standardExtentDomainPlan(extent: RenderExtent, lane: StandardLightingLane): StandardExtentDomainPlan;
+//# sourceMappingURL=render-extent.d.ts.map

package/dist/pipeline/render-extent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-extent.d.ts","sourceRoot":"","sources":["../../src/pipeline/render-extent.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAC;AAErE,yEAAyE;AACzE,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,kBAAkB,GACzB;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAKrD;AAED,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,CAAC;AAEzE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,QAAQ,EAAE;YAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QACvE,QAAQ,CAAC,MAAM,EAAE;YAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QACrE,QAAQ,CAAC,SAAS,EAAE;YAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;KACzE,CAAC;IACF,QAAQ,CAAC,SAAS,EAAE,SAAS;QAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAC;KACtD,EAAE,CAAC;CACL;AAeD,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CAgBzE;AAED,8EAA8E;AAC9E,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,oBAAoB,GACzB,wBAAwB,CA0B1B"}

package/dist/pipeline/standard-build-context.d.ts

@@ -0,0 +1,7 @@
+import type { RenderPipelineBuildContext, RenderPipelineFrame } from '../render-pipeline';
+import type { TargetCoverageAttachment } from '../temporal/target-coverage-attachment';
+/** Standard-only graph input; custom pipeline consumers never see coverage. */
+export type StandardPipelineBuildContext = RenderPipelineBuildContext<RenderPipelineFrame> & {
+    readonly targetCoverage?: TargetCoverageAttachment;
+};
+//# sourceMappingURL=standard-build-context.d.ts.map

package/dist/pipeline/standard-build-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-build-context.d.ts","sourceRoot":"","sources":["../../src/pipeline/standard-build-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC1F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAEvF,+EAA+E;AAC/E,MAAM,MAAM,4BAA4B,GAAG,0BAA0B,CAAC,mBAAmB,CAAC,GAAG;IAC3F,QAAQ,CAAC,cAAc,CAAC,EAAE,wBAAwB,CAAC;CACpD,CAAC"}

package/dist/pipeline/standard-forward-lane.d.ts

@@ -1,6 +1,7 @@
-import type { RenderPipeline, RenderPipelineBuildContext, RenderPipelineFrame, RenderPipelineTopology } from '../render-pipeline';
+import type { RenderPipeline, RenderPipelineTopology } from '../render-pipeline';
+import type { StandardPipelineBuildContext } from './standard-build-context';
 import type { StandardTopologyInputValue } from './standard-lighting/topology';
-declare function buildUrp(context: RenderPipelineBuildContext<RenderPipelineFrame>, topology: RenderPipelineTopology, lighting: StandardTopologyInputValue): ReturnType<RenderPipeline['build']>;
+declare function buildUrp(context: StandardPipelineBuildContext, topology: RenderPipelineTopology, lighting: StandardTopologyInputValue): ReturnType<RenderPipeline['build']>;
 export declare const buildStandardForwardLane: typeof buildUrp;
 export {};
 //# sourceMappingURL=standard-forward-lane.d.ts.map

package/dist/pipeline/standard-forward-lane.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standard-forward-lane.d.ts","sourceRoot":"","sources":["../../src/pipeline/standard-forward-lane.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,cAAc,EACd,0BAA0B,EAC1B,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AA+B5B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAW/E,iBAAS,QAAQ,CACf,OAAO,EAAE,0BAA0B,CAAC,mBAAmB,CAAC,EACxD,QAAQ,EAAE,sBAAsB,EAChC,QAAQ,EAAE,0BAA0B,GACnC,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CA6TrC;AAED,eAAO,MAAM,wBAAwB,iBAAW,CAAC"}
+{"version":3,"file":"standard-forward-lane.d.ts","sourceRoot":"","sources":["../../src/pipeline/standard-forward-lane.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,cAAc,EAEd,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AA4B5B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAM7E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAW/E,iBAAS,QAAQ,CACf,OAAO,EAAE,4BAA4B,EACrC,QAAQ,EAAE,sBAAsB,EAChC,QAAQ,EAAE,0BAA0B,GACnC,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAuWrC;AAED,eAAO,MAAM,wBAAwB,iBAAW,CAAC"}

package/dist/pipeline/standard-output/auto-exposure/capability.d.ts

@@ -0,0 +1,12 @@
+import type { RhiCaps } from '@forgeax/engine-rhi';
+import { type Result } from '@forgeax/engine-types';
+import { AutoExposureCapabilityUnavailableError } from './inspection';
+export type AutoExposureCapabilityFacts = Pick<RhiCaps, 'compute' | 'storageBuffer' | 'float32Filterable' | 'rgba16floatRenderable'>;
+export interface AutoExposureCapability {
+    readonly available: true;
+    readonly generation: number;
+    readonly rgba16floatRenderable: boolean;
+}
+/** Resolve live device facts; no capability is inferred from a neighboring format. */
+export declare function resolveAutoExposureCapability(caps: AutoExposureCapabilityFacts, generation: number): Result<AutoExposureCapability, AutoExposureCapabilityUnavailableError>;
+//# sourceMappingURL=capability.d.ts.map

package/dist/pipeline/standard-output/auto-exposure/capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/standard-output/auto-exposure/capability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,sCAAsC,EAAE,MAAM,cAAc,CAAC;AAEtE,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAC5C,OAAO,EACP,SAAS,GAAG,eAAe,GAAG,mBAAmB,GAAG,uBAAuB,CAC5E,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;CACzC;AASD,sFAAsF;AACtF,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,2BAA2B,EACjC,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,sBAAsB,EAAE,sCAAsC,CAAC,CAWxE"}

package/dist/pipeline/standard-output/auto-exposure/gpu.d.ts

@@ -0,0 +1,70 @@
+import type { GraphBuffer, RenderGraphBuilder, RenderGraphError } from '@forgeax/engine-render-graph';
+import type { Buffer, RhiDevice } from '@forgeax/engine-rhi';
+import { type Result } from '@forgeax/engine-types';
+import type { RenderPipelineFrame, RenderPipelineTarget } from '../../../render-pipeline';
+export declare const AUTO_EXPOSURE_HISTOGRAM_BYTES = 1024;
+export declare const AUTO_EXPOSURE_STATE_BYTES = 32;
+export declare const AUTO_EXPOSURE_CANDIDATE_BYTES = 16;
+/** Camera/time inputs consumed by adapt; this is not a CPU exposure estimate. */
+export declare const AUTO_EXPOSURE_PARAMETERS_BYTES = 32;
+export interface AutoExposureGpuParameters {
+    readonly compensationEv: number;
+    readonly rangeMinEv: number;
+    readonly rangeMaxEv: number;
+    readonly upRate: number;
+    readonly downRate: number;
+    readonly deltaTime: number;
+    readonly fallback: number;
+    readonly generation: number;
+}
+export interface AutoExposureGpuResources {
+    readonly histogram: Buffer;
+    readonly state: Buffer;
+    readonly candidate: Buffer;
+    readonly parameters: Buffer;
+    readonly device: RhiDevice;
+    readonly generation: number;
+}
+export interface AutoExposureGraphResources {
+    readonly histogram: GraphBuffer;
+    readonly state: GraphBuffer;
+    readonly candidate: GraphBuffer;
+    readonly parameters: GraphBuffer;
+}
+export interface AutoExposureGraphProjection {
+    readonly source: RenderPipelineTarget;
+    readonly resources: AutoExposureGraphResources;
+    readonly width: number;
+    readonly height: number;
+}
+/** Allocate the one device-scoped auto-exposure resource set. */
+export declare function createAutoExposureGpuResources(device: RhiDevice, generation: number): Result<AutoExposureGpuResources, unknown>;
+/** Upload only authored camera/time metadata consumed by the GPU adaptation. */
+export declare function writeAutoExposureParameters(resources: AutoExposureGpuResources, parameters: AutoExposureGpuParameters): Result<void, unknown>;
+export declare function retireAutoExposureGpuResources(resources: AutoExposureGpuResources): void;
+/** Import persistent buffers into the current typed graph without exposing handles in topology. */
+export declare function importAutoExposureGraphResources(graph: RenderGraphBuilder<RenderPipelineFrame>): Result<AutoExposureGraphResources, RenderGraphError>;
+/**
+ * Add the real same-frame clear -> histogram -> adapt producer chain.
+ *
+ * The three logical stages are three ordered dispatches in one real compute
+ * pass. Clear and adapt use one workgroup each; histogram uses the fixed
+ * 32-workgroup cohort. The pass remains the timing interval, so no marker,
+ * native copy boundary, or CPU histogram transfer is introduced.
+ */
+export declare function addAutoExposureGraphPasses(context: import('../../../render-pipeline').RenderPipelineBuildContext<RenderPipelineFrame>, projection: AutoExposureGraphProjection): Result<void, RenderGraphError>;
+export interface AutoExposureWhiteBalance {
+    readonly temperature: number;
+    readonly tint: number;
+}
+/**
+ * Build the sole linear-HDR exposure/white-balance consumer.  The camera
+ * projection supplies temperature/tint as immutable shader constants for the
+ * frame topology; the candidate remains a same-frame GPU buffer when auto
+ * exposure is enabled.  Keeping this in one source prevents a renderer-side
+ * WB override from becoming a second color-stage authority.
+ */
+export declare function createAutoExposureApplyWgsl(whiteBalance?: AutoExposureWhiteBalance, hasCandidate?: boolean): string;
+/** Consume the same-frame adaptation candidate in the linear HDR domain. */
+export declare function addAutoExposureExposurePass(context: import('../../../render-pipeline').RenderPipelineBuildContext<RenderPipelineFrame>, input: RenderPipelineTarget, output: RenderPipelineTarget, resources: AutoExposureGraphResources | undefined, whiteBalance?: AutoExposureWhiteBalance): Result<void, RenderGraphError>;
+//# sourceMappingURL=gpu.d.ts.map

package/dist/pipeline/standard-output/auto-exposure/gpu.d.ts.map

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