@forgeax/engine-render 0.1.32 → 0.1.33

package/dist/{chunk-S665NJNF.mjs.map → chunk-LEAXOMYJ.mjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/pipeline/standard-lighting/layout.ts","../src/pipeline/standard-profile.ts","../src/ibl/kernel-cache.ts","../src/temporal/scene-data.ts","../src/temporal/scene-data-catalog.ts"],"names":[],"mappings":"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","file":"chunk-S665NJNF.mjs","sourcesContent":["export const DEFAULT_CLUSTER_GRID = { x: 16, y: 9, z: 24 } as const;\nexport const CLUSTER_GRID_STRIDE_U32 = 2 as const;\nexport const LIGHT_INDEX_LIST_CAPACITY = 1048576 as const;\nexport const MAX_LIGHTS = 256 as const;\n\nexport interface StandardClusterLayout {\n  readonly grid: { readonly x: number; readonly y: number; readonly z: number };\n  readonly clusterCount: number;\n  readonly clusterGridStrideU32: typeof CLUSTER_GRID_STRIDE_U32;\n  readonly clusterGridU32Length: number;\n  readonly lightIndexListCapacity: typeof LIGHT_INDEX_LIST_CAPACITY;\n  readonly lightDataSlotCount: typeof MAX_LIGHTS;\n  readonly lightBoundsInt32Length: number;\n}\n\nexport function createStandardClusterLayout(\n  grid: { readonly x: number; readonly y: number; readonly z: number } = DEFAULT_CLUSTER_GRID,\n): StandardClusterLayout {\n  const clusterCount = grid.x * grid.y * grid.z;\n  return Object.freeze({\n    grid,\n    clusterCount,\n    clusterGridStrideU32: CLUSTER_GRID_STRIDE_U32,\n    clusterGridU32Length: clusterCount * CLUSTER_GRID_STRIDE_U32,\n    lightIndexListCapacity: LIGHT_INDEX_LIST_CAPACITY,\n    lightDataSlotCount: MAX_LIGHTS,\n    lightBoundsInt32Length: MAX_LIGHTS * 6,\n  });\n}\n\nexport const STANDARD_CLUSTER_LAYOUT = createStandardClusterLayout();\n","import type { SsaoParameterConfig } from '../ssao-config';\nexport const STANDARD_PIPELINE_ID = 'forgeax::standard' as const;\nexport const STANDARD_LIGHT_COUNTS = [1, 32, 256] as const;\nexport {\n  CLUSTER_GRID_STRIDE_U32,\n  DEFAULT_CLUSTER_GRID,\n  LIGHT_INDEX_LIST_CAPACITY,\n  MAX_LIGHTS,\n} from './standard-lighting/layout';\n\nexport type StandardLightCount = (typeof STANDARD_LIGHT_COUNTS)[number];\nexport type StandardShadowMode = 'off' | 'hard' | 'filtered';\nexport type StandardVolumetricFogQuality = 'low' | 'high';\n\nexport interface StandardVolumetricFogProfile {\n  readonly quality: StandardVolumetricFogQuality;\n  readonly depth: 48 | 64;\n  readonly tileSize: 4 | 16;\n}\n\nexport const STANDARD_POST_STAGE_NAMES = [\n  'transparent-blend',\n  'bloom',\n  'output-transform',\n  'fxaa',\n  'post-effect',\n  'present',\n] as const;\nexport type StandardPostStage = (typeof STANDARD_POST_STAGE_NAMES)[number];\nexport interface StandardProfile {\n  readonly pipelineId: typeof STANDARD_PIPELINE_ID;\n  readonly lightCount: StandardLightCount;\n  /** Graph topology selector; all local lights use the shared Cluster path. */\n  readonly renderPath: 'forward' | 'deferred';\n  readonly shadows: StandardShadowMode;\n  readonly pbr: boolean;\n  readonly ibl: boolean;\n  readonly ssao: boolean | SsaoParameterConfig;\n  /** Renderer-owned 1080p volume profile; tile width/height remain surface-derived. */\n  readonly volumetricFog?: StandardVolumetricFogProfile | undefined;\n  readonly postStages: typeof STANDARD_POST_STAGE_NAMES;\n}\n\nexport const DEFAULT_STANDARD_PROFILE: StandardProfile = Object.freeze({\n  pipelineId: STANDARD_PIPELINE_ID,\n  lightCount: 32,\n  renderPath: 'forward',\n  shadows: 'filtered',\n  pbr: true,\n  ibl: true,\n  ssao: false,\n  postStages: STANDARD_POST_STAGE_NAMES,\n});\n\nexport function resolveVolumetricFogProfile(\n  profile: Pick<StandardProfile, 'volumetricFog'>,\n): StandardVolumetricFogProfile {\n  return profile.volumetricFog ?? { quality: 'high', depth: 64, tileSize: 4 };\n}\n","export const REFLECTION_PROBE_IBL_STAGES = ['raw', 'filtered', 'publish'] as const;\nexport type ReflectionProbeIblStage = (typeof REFLECTION_PROBE_IBL_STAGES)[number];\n\nexport interface IblKernelCache {\n  readonly generation: number;\n  readonly pipelineIdentity: object;\n  readonly samplerIdentity: object;\n  readonly brdfLutIdentity: object;\n}\n\nconst kernelCaches = new Map<number, IblKernelCache>();\n\nexport function createIblKernelCache(generation: number): IblKernelCache {\n  const existing = kernelCaches.get(generation);\n  if (existing !== undefined) return existing;\n  const created: IblKernelCache = {\n    generation,\n    pipelineIdentity: {},\n    samplerIdentity: {},\n    brdfLutIdentity: {},\n  };\n  kernelCaches.set(generation, created);\n  return created;\n}\n\nexport interface ProbeIblOutput {\n  readonly entityKey: number;\n  readonly resolution: number;\n  readonly deviceGeneration: number;\n  readonly raw: object;\n  readonly filtered: object;\n  readonly rawGeneration: number;\n  readonly filteredGeneration: number;\n  readonly lkg: boolean;\n}\n\nexport interface ProbeIblUpdate extends ProbeIblOutput {\n  readonly stages: typeof REFLECTION_PROBE_IBL_STAGES;\n  readonly nextStage: ReflectionProbeIblStage;\n  readonly candidateGeneration: number;\n}\n\nexport function createProbeIblOutput(input: {\n  readonly entityKey: number;\n  readonly resolution: number;\n  readonly deviceGeneration: number;\n}): ProbeIblOutput {\n  return {\n    ...input,\n    raw: {},\n    filtered: {},\n    rawGeneration: 0,\n    filteredGeneration: 0,\n    lkg: true,\n  };\n}\n\nexport function beginProbeIblUpdate(output: ProbeIblOutput): ProbeIblUpdate {\n  return {\n    ...output,\n    stages: REFLECTION_PROBE_IBL_STAGES,\n    nextStage: 'raw',\n    candidateGeneration: output.filteredGeneration + 1,\n  };\n}\n\nexport function publishProbeIblOutput(\n  update: ProbeIblUpdate,\n  result: { readonly stage: ReflectionProbeIblStage; readonly ok: boolean },\n): ProbeIblOutput {\n  if (!result.ok || result.stage !== update.nextStage) return update;\n  if (result.stage === 'raw') {\n    return {\n      ...update,\n      rawGeneration: update.candidateGeneration,\n    };\n  }\n  if (result.stage === 'filtered') return update;\n  return {\n    ...update,\n    filteredGeneration: update.candidateGeneration,\n    lkg: true,\n  };\n}\n\nexport function resetIblKernelCaches(): void {\n  kernelCaches.clear();\n}\n","import { type RenderError, RenderFeaturePreparedStateMismatchError } from '../errors/render';\nimport type { RenderFeatureTargetHandle } from '../features/targets';\n\n/** The closed semantic schema namespace published by the render owner. */\nexport const SCENE_DATA_TEMPORAL_V1_SCHEMA = 'forgeax::scene-data::temporal-v1' as const;\nexport type SceneDataSchemaId = typeof SCENE_DATA_TEMPORAL_V1_SCHEMA;\n\nexport type SceneDataLane = 'direct' | 'clustered' | 'cpu-webgl2';\n\nexport interface SceneDataTemporalV1Descriptor {\n  readonly schema: typeof SCENE_DATA_TEMPORAL_V1_SCHEMA;\n  readonly format: 'rgba16float';\n  readonly sampleCount: 1;\n  readonly extent: 'render-resolution';\n  readonly clearValue: readonly [0, 0, -1, 1];\n  readonly channels: Readonly<{\n    readonly motionUv: 'rg';\n    readonly viewDepth: 'b-log2-1-plus-depth';\n    readonly reactive: 'a';\n  }>;\n}\n\nexport const SCENE_DATA_TEMPORAL_V1_DESCRIPTOR: SceneDataTemporalV1Descriptor = Object.freeze({\n  schema: SCENE_DATA_TEMPORAL_V1_SCHEMA,\n  format: 'rgba16float',\n  sampleCount: 1,\n  extent: 'render-resolution',\n  clearValue: [0, 0, -1, 1] as const,\n  channels: Object.freeze({\n    motionUv: 'rg',\n    viewDepth: 'b-log2-1-plus-depth',\n    reactive: 'a',\n  }),\n});\n\n/** Opaque, sampled-read-only semantic data token. */\nexport interface SceneDataTarget<Schema extends SceneDataSchemaId = SceneDataSchemaId> {\n  readonly kind: 'scene-data';\n  readonly schema: Schema;\n  readonly access: 'sampled-read';\n  readonly format: 'rgba16float';\n  readonly sampleCount: 1;\n  readonly extent: 'render-resolution';\n  readonly __sceneDataTarget: unique symbol;\n}\n\nexport type SceneDataTokenMismatch = RenderFeaturePreparedStateMismatchError;\n\nconst targetOwners = new WeakMap<object, SceneDataCatalogIdentity>();\n\nexport interface SceneDataCatalogIdentity {\n  readonly featureIdentity: string;\n  readonly planIdentity: string;\n  readonly generation: number;\n}\n\nexport function registerSceneDataTarget(\n  target: SceneDataTarget,\n  owner: SceneDataCatalogIdentity,\n): void {\n  targetOwners.set(target, owner);\n}\n\nexport function sceneDataTargetOwner(\n  target: SceneDataTarget,\n): SceneDataCatalogIdentity | undefined {\n  return typeof target === 'object' && target !== null ? targetOwners.get(target) : undefined;\n}\n\nexport function sceneDataTokenMismatch(\n  operation: string,\n  reason: 'foreign-feature' | 'foreign-kind' | 'generation-mismatch' | 'layout-mismatch',\n  owner: SceneDataCatalogIdentity,\n  target: Partial<SceneDataTarget> | undefined,\n): SceneDataTokenMismatch {\n  const detail =\n    reason === 'generation-mismatch'\n      ? {\n          featureIdentity: owner.featureIdentity,\n          order: -1,\n          stage: 'contribute' as const,\n          operation,\n          resourceKind: 'attachment' as const,\n          reason,\n          expectedGeneration: owner.generation,\n          actualGeneration: targetOwners.get(target as object)?.generation ?? -1,\n          recovery: 'renderer-recover' as const,\n        }\n      : reason === 'foreign-feature'\n        ? {\n            featureIdentity: owner.featureIdentity,\n            order: -1,\n            stage: 'contribute' as const,\n            operation,\n            resourceKind: 'attachment' as const,\n            reason,\n            expectedFeatureIdentity: owner.featureIdentity,\n            actualFeatureIdentity: targetOwners.get(target as object)?.featureIdentity ?? 'unknown',\n            recovery: 'next-frame' as const,\n          }\n        : reason === 'foreign-kind'\n          ? {\n              featureIdentity: owner.featureIdentity,\n              order: -1,\n              stage: 'contribute' as const,\n              operation,\n              resourceKind: 'attachment' as const,\n              reason,\n              expectedKind: 'attachment' as const,\n              actualKind: 'pipeline' as const,\n              recovery: 'next-frame' as const,\n            }\n          : {\n              featureIdentity: owner.featureIdentity,\n              order: -1,\n              stage: 'contribute' as const,\n              operation,\n              resourceKind: 'attachment' as const,\n              reason,\n              expectedLayout: 'sampled-read-temporal-v1',\n              actualLayout: target?.access ?? 'unknown',\n              recovery: 'next-frame' as const,\n            };\n  return new RenderFeaturePreparedStateMismatchError(detail);\n}\n\nexport function isSceneDataTarget(value: unknown): value is SceneDataTarget {\n  if (value === null || typeof value !== 'object') return false;\n  const candidate = value as Partial<SceneDataTarget>;\n  return (\n    candidate.kind === 'scene-data' &&\n    candidate.schema === SCENE_DATA_TEMPORAL_V1_SCHEMA &&\n    candidate.access === 'sampled-read' &&\n    candidate.format === 'rgba16float' &&\n    candidate.sampleCount === 1 &&\n    candidate.extent === 'render-resolution' &&\n    targetOwners.has(value)\n  );\n}\n\nexport function sceneDataTargetAsAttachment(_target: SceneDataTarget): never {\n  throw new TypeError('SceneDataTarget is sampled-read-only and cannot be used as an attachment');\n}\n\nexport type SceneDataTargetInput = RenderFeatureTargetHandle | SceneDataTarget;\n\nexport function sceneDataError(error: SceneDataTokenMismatch): RenderError {\n  return error;\n}\n","import { err, ok, type Result } from '@forgeax/engine-types';\nimport type { RenderError } from '../errors/render';\nimport { SceneDataUnavailableError } from '../errors/render';\nimport {\n  registerSceneDataTarget,\n  SCENE_DATA_TEMPORAL_V1_DESCRIPTOR,\n  SCENE_DATA_TEMPORAL_V1_SCHEMA,\n  type SceneDataLane,\n  type SceneDataSchemaId,\n  type SceneDataTarget,\n  sceneDataTargetOwner,\n  sceneDataTokenMismatch,\n} from './scene-data';\n\nexport type SceneDataAvailability =\n  | {\n      readonly status: 'available';\n      readonly completeness: 'exact' | 'exact-with-reactive-fallback';\n    }\n  | {\n      readonly status: 'unavailable';\n      readonly reason:\n        | 'capability-missing'\n        | 'producer-missing'\n        | 'coverage-incomplete'\n        | 'renderer-recovering';\n    };\n\nexport interface SceneDataInspection {\n  readonly schema: SceneDataSchemaId;\n  readonly status: SceneDataAvailability['status'];\n  readonly generation: number;\n  readonly planIdentity: string;\n  readonly lane: SceneDataLane;\n  readonly completeness?: 'exact' | 'exact-with-reactive-fallback';\n  readonly reason?: Exclude<SceneDataAvailability, { status: 'available' }>['reason'];\n  readonly missingContributorIds: readonly string[];\n  readonly omittedMissingContributorCount: number;\n}\n\nexport interface SceneDataCatalogOptions {\n  readonly featureIdentity: string;\n  readonly generation: number;\n  readonly planIdentity: string;\n  readonly lane?: SceneDataLane;\n  readonly rgba16floatRenderable: boolean;\n  readonly producerPresent?: boolean;\n  readonly coverageComplete?: boolean;\n  readonly recovering?: boolean;\n  readonly reactiveFallback?: boolean;\n  readonly missingContributorIds?: readonly string[];\n}\n\nexport interface SceneDataCatalog {\n  readonly schema: typeof SCENE_DATA_TEMPORAL_V1_SCHEMA;\n  readonly generation: number;\n  readonly planIdentity: string;\n  readonly availability: SceneDataAvailability;\n  require<Schema extends SceneDataSchemaId>(schema: Schema): SceneDataTarget<Schema>;\n  validate(target: SceneDataTarget, generation?: number): Result<SceneDataTarget, RenderError>;\n  inspect(): SceneDataInspection;\n}\n\nfunction availability(options: SceneDataCatalogOptions): SceneDataAvailability {\n  if (options.recovering) return { status: 'unavailable', reason: 'renderer-recovering' };\n  if (!options.rgba16floatRenderable)\n    return { status: 'unavailable', reason: 'capability-missing' };\n  if (options.producerPresent === false)\n    return { status: 'unavailable', reason: 'producer-missing' };\n  if (options.coverageComplete === false)\n    return { status: 'unavailable', reason: 'coverage-incomplete' };\n  return {\n    status: 'available',\n    completeness: options.reactiveFallback ? 'exact-with-reactive-fallback' : 'exact',\n  };\n}\n\nfunction createTarget(owner: SceneDataCatalogOptions): SceneDataTarget {\n  const target = Object.freeze({\n    kind: 'scene-data' as const,\n    schema: SCENE_DATA_TEMPORAL_V1_SCHEMA,\n    access: 'sampled-read' as const,\n    format: 'rgba16float' as const,\n    sampleCount: 1 as const,\n    extent: 'render-resolution' as const,\n  }) as SceneDataTarget;\n  registerSceneDataTarget(target, {\n    featureIdentity: owner.featureIdentity,\n    planIdentity: owner.planIdentity,\n    generation: owner.generation,\n  });\n  return target;\n}\n\nfunction tokenError(catalog: SceneDataCatalogOptions, operation: string): RenderError {\n  return sceneDataTokenMismatch(\n    operation,\n    'foreign-kind',\n    {\n      featureIdentity: catalog.featureIdentity,\n      planIdentity: catalog.planIdentity,\n      generation: catalog.generation,\n    },\n    undefined,\n  );\n}\n\nfunction unavailableError(\n  options: SceneDataCatalogOptions,\n  reason: Exclude<SceneDataAvailability, { status: 'available' }>['reason'],\n): RenderError {\n  const recovery =\n    reason === 'capability-missing'\n      ? 'enable-capability'\n      : reason === 'renderer-recovering'\n        ? 'renderer-recover'\n        : 'next-frame';\n  return new SceneDataUnavailableError({\n    featureIdentity: options.featureIdentity,\n    schema: SCENE_DATA_TEMPORAL_V1_SCHEMA,\n    lane: options.lane ?? 'direct',\n    reason,\n    missingContributorIds: options.missingContributorIds ?? [],\n    omittedMissingContributorCount: 0,\n    recovery,\n  });\n}\n\nexport function createSceneDataCatalog(options: SceneDataCatalogOptions): SceneDataCatalog {\n  const state = availability(options);\n  const owner = {\n    featureIdentity: options.featureIdentity,\n    planIdentity: options.planIdentity,\n    generation: options.generation,\n  };\n  const missing = [...(options.missingContributorIds ?? [])];\n  const inspectionBase = {\n    schema: SCENE_DATA_TEMPORAL_V1_SCHEMA,\n    generation: options.generation,\n    planIdentity: options.planIdentity,\n    lane: options.lane ?? 'direct',\n    missingContributorIds: Object.freeze(missing.slice(0, 32)),\n    omittedMissingContributorCount: Math.max(0, missing.length - 32),\n  };\n  return {\n    schema: SCENE_DATA_TEMPORAL_V1_SCHEMA,\n    generation: options.generation,\n    planIdentity: options.planIdentity,\n    availability: state,\n    require(schema) {\n      if (schema !== SCENE_DATA_TEMPORAL_V1_SCHEMA || state.status !== 'available') {\n        if (state.status === 'unavailable') throw unavailableError(options, state.reason);\n        throw tokenError(options, 'require scene-data target');\n      }\n      return createTarget(options) as SceneDataTarget<typeof schema>;\n    },\n    validate(target, generation = options.generation) {\n      const targetOwner = sceneDataTargetOwner(target);\n      if (targetOwner === undefined) {\n        return err(\n          sceneDataTokenMismatch('validate scene-data target', 'foreign-feature', owner, target),\n        );\n      }\n      if (\n        targetOwner.planIdentity !== owner.planIdentity ||\n        targetOwner.featureIdentity !== owner.featureIdentity\n      ) {\n        return err(\n          sceneDataTokenMismatch('validate scene-data target', 'foreign-feature', owner, target),\n        );\n      }\n      if (generation !== owner.generation || targetOwner.generation !== owner.generation) {\n        return err(\n          sceneDataTokenMismatch(\n            'validate scene-data target',\n            'generation-mismatch',\n            owner,\n            target,\n          ),\n        );\n      }\n      if (target.access !== 'sampled-read') {\n        return err(\n          sceneDataTokenMismatch('validate scene-data target', 'layout-mismatch', owner, target),\n        );\n      }\n      return ok(target);\n    },\n    inspect() {\n      return Object.freeze(\n        state.status === 'available'\n          ? { ...inspectionBase, status: state.status, completeness: state.completeness }\n          : { ...inspectionBase, status: state.status, reason: state.reason },\n      );\n    },\n  };\n}\n\nexport { SCENE_DATA_TEMPORAL_V1_SCHEMA } from './scene-data';\nexport { SCENE_DATA_TEMPORAL_V1_DESCRIPTOR };\n"]}
+{"version":3,"sources":["../src/pipeline/standard-lighting/layout.ts","../src/pipeline/standard-profile.ts","../src/ibl/kernel-cache.ts","../src/temporal/scene-data.ts","../src/temporal/scene-data-catalog.ts"],"names":[],"mappings":"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","file":"chunk-LEAXOMYJ.mjs","sourcesContent":["export const DEFAULT_CLUSTER_GRID = { x: 16, y: 9, z: 24 } as const;\nexport const CLUSTER_GRID_STRIDE_U32 = 2 as const;\nexport const LIGHT_INDEX_LIST_CAPACITY = 1048576 as const;\nexport const MAX_LIGHTS = 256 as const;\n\nexport interface StandardClusterLayout {\n  readonly grid: { readonly x: number; readonly y: number; readonly z: number };\n  readonly clusterCount: number;\n  readonly clusterGridStrideU32: typeof CLUSTER_GRID_STRIDE_U32;\n  readonly clusterGridU32Length: number;\n  readonly lightIndexListCapacity: typeof LIGHT_INDEX_LIST_CAPACITY;\n  readonly lightDataSlotCount: typeof MAX_LIGHTS;\n  readonly lightBoundsInt32Length: number;\n}\n\nexport function createStandardClusterLayout(\n  grid: { readonly x: number; readonly y: number; readonly z: number } = DEFAULT_CLUSTER_GRID,\n): StandardClusterLayout {\n  const clusterCount = grid.x * grid.y * grid.z;\n  return Object.freeze({\n    grid,\n    clusterCount,\n    clusterGridStrideU32: CLUSTER_GRID_STRIDE_U32,\n    clusterGridU32Length: clusterCount * CLUSTER_GRID_STRIDE_U32,\n    lightIndexListCapacity: LIGHT_INDEX_LIST_CAPACITY,\n    lightDataSlotCount: MAX_LIGHTS,\n    lightBoundsInt32Length: MAX_LIGHTS * 6,\n  });\n}\n\nexport const STANDARD_CLUSTER_LAYOUT = createStandardClusterLayout();\n","import type { SsaoParameterConfig } from '../ssao-config';\nexport const STANDARD_PIPELINE_ID = 'forgeax::standard' as const;\nexport const STANDARD_LIGHT_COUNTS = [1, 32, 256] as const;\nexport {\n  CLUSTER_GRID_STRIDE_U32,\n  DEFAULT_CLUSTER_GRID,\n  LIGHT_INDEX_LIST_CAPACITY,\n  MAX_LIGHTS,\n} from './standard-lighting/layout';\n\nexport type StandardLightCount = (typeof STANDARD_LIGHT_COUNTS)[number];\nexport type StandardShadowMode = 'off' | 'hard' | 'filtered';\nexport type StandardVolumetricFogQuality = 'low' | 'high';\n\nexport interface StandardVolumetricFogProfile {\n  readonly quality: StandardVolumetricFogQuality;\n  readonly depth: 48 | 64;\n  readonly tileSize: 4 | 16;\n}\n\nexport const STANDARD_POST_STAGE_NAMES = [\n  'transparent-blend',\n  'bloom',\n  'output-transform',\n  'fxaa',\n  'post-effect',\n  'present',\n] as const;\nexport type StandardPostStage = (typeof STANDARD_POST_STAGE_NAMES)[number];\nexport interface StandardProfile {\n  readonly pipelineId: typeof STANDARD_PIPELINE_ID;\n  readonly lightCount: StandardLightCount;\n  /** Graph topology selector; all local lights use the shared Cluster path. */\n  readonly renderPath: 'forward' | 'deferred';\n  readonly shadows: StandardShadowMode;\n  readonly pbr: boolean;\n  readonly ibl: boolean;\n  readonly ssao: boolean | SsaoParameterConfig;\n  /** Renderer-owned 1080p volume profile; tile width/height remain surface-derived. */\n  readonly volumetricFog?: StandardVolumetricFogProfile | undefined;\n  readonly postStages: typeof STANDARD_POST_STAGE_NAMES;\n}\n\nexport const DEFAULT_STANDARD_PROFILE: StandardProfile = Object.freeze({\n  pipelineId: STANDARD_PIPELINE_ID,\n  lightCount: 32,\n  renderPath: 'forward',\n  shadows: 'filtered',\n  pbr: true,\n  ibl: true,\n  ssao: false,\n  postStages: STANDARD_POST_STAGE_NAMES,\n});\n\nexport function resolveVolumetricFogProfile(\n  profile: Pick<StandardProfile, 'volumetricFog'>,\n): StandardVolumetricFogProfile {\n  return profile.volumetricFog ?? { quality: 'high', depth: 64, tileSize: 4 };\n}\n","export const REFLECTION_PROBE_IBL_STAGES = ['raw', 'filtered', 'publish'] as const;\nexport type ReflectionProbeIblStage = (typeof REFLECTION_PROBE_IBL_STAGES)[number];\n\nexport interface IblKernelCache {\n  readonly generation: number;\n  readonly pipelineIdentity: object;\n  readonly samplerIdentity: object;\n  readonly brdfLutIdentity: object;\n}\n\nconst kernelCaches = new Map<number, IblKernelCache>();\n\nexport function createIblKernelCache(generation: number): IblKernelCache {\n  const existing = kernelCaches.get(generation);\n  if (existing !== undefined) return existing;\n  const created: IblKernelCache = {\n    generation,\n    pipelineIdentity: {},\n    samplerIdentity: {},\n    brdfLutIdentity: {},\n  };\n  kernelCaches.set(generation, created);\n  return created;\n}\n\nexport interface ProbeIblOutput {\n  readonly entityKey: number;\n  readonly resolution: number;\n  readonly deviceGeneration: number;\n  readonly raw: object;\n  readonly filtered: object;\n  readonly rawGeneration: number;\n  readonly filteredGeneration: number;\n  readonly lkg: boolean;\n}\n\nexport interface ProbeIblUpdate extends ProbeIblOutput {\n  readonly stages: typeof REFLECTION_PROBE_IBL_STAGES;\n  readonly nextStage: ReflectionProbeIblStage;\n  readonly candidateGeneration: number;\n}\n\nexport function createProbeIblOutput(input: {\n  readonly entityKey: number;\n  readonly resolution: number;\n  readonly deviceGeneration: number;\n}): ProbeIblOutput {\n  return {\n    ...input,\n    raw: {},\n    filtered: {},\n    rawGeneration: 0,\n    filteredGeneration: 0,\n    lkg: true,\n  };\n}\n\nexport function beginProbeIblUpdate(output: ProbeIblOutput): ProbeIblUpdate {\n  return {\n    ...output,\n    stages: REFLECTION_PROBE_IBL_STAGES,\n    nextStage: 'raw',\n    candidateGeneration: output.filteredGeneration + 1,\n  };\n}\n\nexport function publishProbeIblOutput(\n  update: ProbeIblUpdate,\n  result: { readonly stage: ReflectionProbeIblStage; readonly ok: boolean },\n): ProbeIblOutput {\n  if (!result.ok || result.stage !== update.nextStage) return update;\n  if (result.stage === 'raw') {\n    return {\n      ...update,\n      rawGeneration: update.candidateGeneration,\n    };\n  }\n  if (result.stage === 'filtered') return update;\n  return {\n    ...update,\n    filteredGeneration: update.candidateGeneration,\n    lkg: true,\n  };\n}\n\nexport function resetIblKernelCaches(): void {\n  kernelCaches.clear();\n}\n","import { type RenderError, RenderFeaturePreparedStateMismatchError } from '../errors/render';\nimport type { RenderFeatureTargetHandle } from '../features/targets';\n\n/** The closed semantic schema namespace published by the render owner. */\nexport const SCENE_DATA_TEMPORAL_V1_SCHEMA = 'forgeax::scene-data::temporal-v1' as const;\nexport type SceneDataSchemaId = typeof SCENE_DATA_TEMPORAL_V1_SCHEMA;\n\nexport type SceneDataLane = 'direct' | 'clustered' | 'cpu-webgl2';\n\nexport interface SceneDataTemporalV1Descriptor {\n  readonly schema: typeof SCENE_DATA_TEMPORAL_V1_SCHEMA;\n  readonly format: 'rgba16float';\n  readonly sampleCount: 1;\n  readonly extent: 'render-resolution';\n  readonly clearValue: readonly [0, 0, -1, 1];\n  readonly channels: Readonly<{\n    readonly motionUv: 'rg';\n    readonly viewDepth: 'b-log2-1-plus-depth';\n    readonly reactive: 'a';\n  }>;\n}\n\nexport const SCENE_DATA_TEMPORAL_V1_DESCRIPTOR: SceneDataTemporalV1Descriptor = Object.freeze({\n  schema: SCENE_DATA_TEMPORAL_V1_SCHEMA,\n  format: 'rgba16float',\n  sampleCount: 1,\n  extent: 'render-resolution',\n  clearValue: [0, 0, -1, 1] as const,\n  channels: Object.freeze({\n    motionUv: 'rg',\n    viewDepth: 'b-log2-1-plus-depth',\n    reactive: 'a',\n  }),\n});\n\n/** Opaque, sampled-read-only semantic data token. */\nexport interface SceneDataTarget<Schema extends SceneDataSchemaId = SceneDataSchemaId> {\n  readonly kind: 'scene-data';\n  readonly schema: Schema;\n  readonly access: 'sampled-read';\n  readonly format: 'rgba16float';\n  readonly sampleCount: 1;\n  readonly extent: 'render-resolution';\n  readonly __sceneDataTarget: unique symbol;\n}\n\nexport type SceneDataTokenMismatch = RenderFeaturePreparedStateMismatchError;\n\nconst targetOwners = new WeakMap<object, SceneDataCatalogIdentity>();\n\nexport interface SceneDataCatalogIdentity {\n  readonly featureIdentity: string;\n  readonly planIdentity: string;\n  readonly generation: number;\n}\n\nexport function registerSceneDataTarget(\n  target: SceneDataTarget,\n  owner: SceneDataCatalogIdentity,\n): void {\n  targetOwners.set(target, owner);\n}\n\nexport function sceneDataTargetOwner(\n  target: SceneDataTarget,\n): SceneDataCatalogIdentity | undefined {\n  return typeof target === 'object' && target !== null ? targetOwners.get(target) : undefined;\n}\n\nexport function sceneDataTokenMismatch(\n  operation: string,\n  reason: 'foreign-feature' | 'foreign-kind' | 'generation-mismatch' | 'layout-mismatch',\n  owner: SceneDataCatalogIdentity,\n  target: Partial<SceneDataTarget> | undefined,\n): SceneDataTokenMismatch {\n  const detail =\n    reason === 'generation-mismatch'\n      ? {\n          featureIdentity: owner.featureIdentity,\n          order: -1,\n          stage: 'contribute' as const,\n          operation,\n          resourceKind: 'attachment' as const,\n          reason,\n          expectedGeneration: owner.generation,\n          actualGeneration: targetOwners.get(target as object)?.generation ?? -1,\n          recovery: 'renderer-recover' as const,\n        }\n      : reason === 'foreign-feature'\n        ? {\n            featureIdentity: owner.featureIdentity,\n            order: -1,\n            stage: 'contribute' as const,\n            operation,\n            resourceKind: 'attachment' as const,\n            reason,\n            expectedFeatureIdentity: owner.featureIdentity,\n            actualFeatureIdentity: targetOwners.get(target as object)?.featureIdentity ?? 'unknown',\n            recovery: 'next-frame' as const,\n          }\n        : reason === 'foreign-kind'\n          ? {\n              featureIdentity: owner.featureIdentity,\n              order: -1,\n              stage: 'contribute' as const,\n              operation,\n              resourceKind: 'attachment' as const,\n              reason,\n              expectedKind: 'attachment' as const,\n              actualKind: 'pipeline' as const,\n              recovery: 'next-frame' as const,\n            }\n          : {\n              featureIdentity: owner.featureIdentity,\n              order: -1,\n              stage: 'contribute' as const,\n              operation,\n              resourceKind: 'attachment' as const,\n              reason,\n              expectedLayout: 'sampled-read-temporal-v1',\n              actualLayout: target?.access ?? 'unknown',\n              recovery: 'next-frame' as const,\n            };\n  return new RenderFeaturePreparedStateMismatchError(detail);\n}\n\nexport function isSceneDataTarget(value: unknown): value is SceneDataTarget {\n  if (value === null || typeof value !== 'object') return false;\n  const candidate = value as Partial<SceneDataTarget>;\n  return (\n    candidate.kind === 'scene-data' &&\n    candidate.schema === SCENE_DATA_TEMPORAL_V1_SCHEMA &&\n    candidate.access === 'sampled-read' &&\n    candidate.format === 'rgba16float' &&\n    candidate.sampleCount === 1 &&\n    candidate.extent === 'render-resolution' &&\n    targetOwners.has(value)\n  );\n}\n\nexport function sceneDataTargetAsAttachment(_target: SceneDataTarget): never {\n  throw new TypeError('SceneDataTarget is sampled-read-only and cannot be used as an attachment');\n}\n\nexport type SceneDataTargetInput = RenderFeatureTargetHandle | SceneDataTarget;\n\nexport function sceneDataError(error: SceneDataTokenMismatch): RenderError {\n  return error;\n}\n","import { err, ok, type Result } from '@forgeax/engine-types';\nimport type { RenderError } from '../errors/render';\nimport { SceneDataUnavailableError } from '../errors/render';\nimport {\n  registerSceneDataTarget,\n  SCENE_DATA_TEMPORAL_V1_DESCRIPTOR,\n  SCENE_DATA_TEMPORAL_V1_SCHEMA,\n  type SceneDataLane,\n  type SceneDataSchemaId,\n  type SceneDataTarget,\n  sceneDataTargetOwner,\n  sceneDataTokenMismatch,\n} from './scene-data';\n\nexport type SceneDataAvailability =\n  | {\n      readonly status: 'available';\n      readonly completeness: 'exact' | 'exact-with-reactive-fallback';\n    }\n  | {\n      readonly status: 'unavailable';\n      readonly reason:\n        | 'capability-missing'\n        | 'producer-missing'\n        | 'coverage-incomplete'\n        | 'renderer-recovering';\n    };\n\nexport interface SceneDataInspection {\n  readonly schema: SceneDataSchemaId;\n  readonly status: SceneDataAvailability['status'];\n  readonly generation: number;\n  readonly planIdentity: string;\n  readonly lane: SceneDataLane;\n  readonly completeness?: 'exact' | 'exact-with-reactive-fallback';\n  readonly reason?: Exclude<SceneDataAvailability, { status: 'available' }>['reason'];\n  readonly missingContributorIds: readonly string[];\n  readonly omittedMissingContributorCount: number;\n}\n\nexport interface SceneDataCatalogOptions {\n  readonly featureIdentity: string;\n  readonly generation: number;\n  readonly planIdentity: string;\n  readonly lane?: SceneDataLane;\n  readonly rgba16floatRenderable: boolean;\n  readonly producerPresent?: boolean;\n  readonly coverageComplete?: boolean;\n  readonly recovering?: boolean;\n  readonly reactiveFallback?: boolean;\n  readonly missingContributorIds?: readonly string[];\n}\n\nexport interface SceneDataCatalog {\n  readonly schema: typeof SCENE_DATA_TEMPORAL_V1_SCHEMA;\n  readonly generation: number;\n  readonly planIdentity: string;\n  readonly availability: SceneDataAvailability;\n  require<Schema extends SceneDataSchemaId>(schema: Schema): SceneDataTarget<Schema>;\n  validate(target: SceneDataTarget, generation?: number): Result<SceneDataTarget, RenderError>;\n  inspect(): SceneDataInspection;\n}\n\nfunction availability(options: SceneDataCatalogOptions): SceneDataAvailability {\n  if (options.recovering) return { status: 'unavailable', reason: 'renderer-recovering' };\n  if (!options.rgba16floatRenderable)\n    return { status: 'unavailable', reason: 'capability-missing' };\n  if (options.producerPresent === false)\n    return { status: 'unavailable', reason: 'producer-missing' };\n  if (options.coverageComplete === false)\n    return { status: 'unavailable', reason: 'coverage-incomplete' };\n  return {\n    status: 'available',\n    completeness: options.reactiveFallback ? 'exact-with-reactive-fallback' : 'exact',\n  };\n}\n\nfunction createTarget(owner: SceneDataCatalogOptions): SceneDataTarget {\n  const target = Object.freeze({\n    kind: 'scene-data' as const,\n    schema: SCENE_DATA_TEMPORAL_V1_SCHEMA,\n    access: 'sampled-read' as const,\n    format: 'rgba16float' as const,\n    sampleCount: 1 as const,\n    extent: 'render-resolution' as const,\n  }) as SceneDataTarget;\n  registerSceneDataTarget(target, {\n    featureIdentity: owner.featureIdentity,\n    planIdentity: owner.planIdentity,\n    generation: owner.generation,\n  });\n  return target;\n}\n\nfunction tokenError(catalog: SceneDataCatalogOptions, operation: string): RenderError {\n  return sceneDataTokenMismatch(\n    operation,\n    'foreign-kind',\n    {\n      featureIdentity: catalog.featureIdentity,\n      planIdentity: catalog.planIdentity,\n      generation: catalog.generation,\n    },\n    undefined,\n  );\n}\n\nfunction unavailableError(\n  options: SceneDataCatalogOptions,\n  reason: Exclude<SceneDataAvailability, { status: 'available' }>['reason'],\n): RenderError {\n  const recovery =\n    reason === 'capability-missing'\n      ? 'enable-capability'\n      : reason === 'renderer-recovering'\n        ? 'renderer-recover'\n        : 'next-frame';\n  return new SceneDataUnavailableError({\n    featureIdentity: options.featureIdentity,\n    schema: SCENE_DATA_TEMPORAL_V1_SCHEMA,\n    lane: options.lane ?? 'direct',\n    reason,\n    missingContributorIds: options.missingContributorIds ?? [],\n    omittedMissingContributorCount: 0,\n    recovery,\n  });\n}\n\nexport function createSceneDataCatalog(options: SceneDataCatalogOptions): SceneDataCatalog {\n  const state = availability(options);\n  const owner = {\n    featureIdentity: options.featureIdentity,\n    planIdentity: options.planIdentity,\n    generation: options.generation,\n  };\n  const missing = [...(options.missingContributorIds ?? [])];\n  const inspectionBase = {\n    schema: SCENE_DATA_TEMPORAL_V1_SCHEMA,\n    generation: options.generation,\n    planIdentity: options.planIdentity,\n    lane: options.lane ?? 'direct',\n    missingContributorIds: Object.freeze(missing.slice(0, 32)),\n    omittedMissingContributorCount: Math.max(0, missing.length - 32),\n  };\n  return {\n    schema: SCENE_DATA_TEMPORAL_V1_SCHEMA,\n    generation: options.generation,\n    planIdentity: options.planIdentity,\n    availability: state,\n    require(schema) {\n      if (schema !== SCENE_DATA_TEMPORAL_V1_SCHEMA || state.status !== 'available') {\n        if (state.status === 'unavailable') throw unavailableError(options, state.reason);\n        throw tokenError(options, 'require scene-data target');\n      }\n      return createTarget(options) as SceneDataTarget<typeof schema>;\n    },\n    validate(target, generation = options.generation) {\n      const targetOwner = sceneDataTargetOwner(target);\n      if (targetOwner === undefined) {\n        return err(\n          sceneDataTokenMismatch('validate scene-data target', 'foreign-feature', owner, target),\n        );\n      }\n      if (\n        targetOwner.planIdentity !== owner.planIdentity ||\n        targetOwner.featureIdentity !== owner.featureIdentity\n      ) {\n        return err(\n          sceneDataTokenMismatch('validate scene-data target', 'foreign-feature', owner, target),\n        );\n      }\n      if (generation !== owner.generation || targetOwner.generation !== owner.generation) {\n        return err(\n          sceneDataTokenMismatch(\n            'validate scene-data target',\n            'generation-mismatch',\n            owner,\n            target,\n          ),\n        );\n      }\n      if (target.access !== 'sampled-read') {\n        return err(\n          sceneDataTokenMismatch('validate scene-data target', 'layout-mismatch', owner, target),\n        );\n      }\n      return ok(target);\n    },\n    inspect() {\n      return Object.freeze(\n        state.status === 'available'\n          ? { ...inspectionBase, status: state.status, completeness: state.completeness }\n          : { ...inspectionBase, status: state.status, reason: state.reason },\n      );\n    },\n  };\n}\n\nexport { SCENE_DATA_TEMPORAL_V1_SCHEMA } from './scene-data';\nexport { SCENE_DATA_TEMPORAL_V1_DESCRIPTOR };\n"]}

package/dist/{chunk-6TFBXLRJ.mjs → chunk-NB2S7ZRX.mjs}

@@ -1,5 +1,5 @@
-import { cubeArrayDepthDescriptor, comparisonSamplerDescriptor, cubeArrayDepthFaceView } from '@forgeax/engine-rhi';
 import { err, ok } from '@forgeax/engine-types';
+import { cubeArrayDepthDescriptor, comparisonSamplerDescriptor, cubeArrayDepthFaceView } from '@forgeax/engine-rhi';
 
 // src/pipeline/standard-output/auto-exposure/inspection.ts
 var AutoExposureInvalidParameterError = class extends Error {
@@ -421,14 +421,20 @@ var RenderFeatureStageFailedError = class extends Error {
   expected;
   hint;
   detail;
-  constructor(featureIdentity, order, stage, recovery) {
+  constructor(featureIdentity, order, stage, recovery, cause) {
     const expected = `feature '${featureIdentity}' completes its ${stage} stage without an error`;
     const hint = renderFeatureRecoveryHintByRecovery[recovery](featureIdentity, stage);
     super(`render feature '${featureIdentity}' failed during ${stage}`);
     this.name = "RenderFeatureStageFailedError";
     this.expected = expected;
     this.hint = hint;
-    this.detail = { featureIdentity, order, stage, recovery };
+    this.detail = {
+      featureIdentity,
+      order,
+      stage,
+      recovery,
+      ...cause === void 0 ? {} : { cause }
+    };
   }
 };
 var RenderFeatureCapabilityMissingError = class extends Error {
@@ -922,6 +928,89 @@ var VolumeInvalidParametersError = class extends Error {
     this.detail = { field, value };
   }
 };
+var MOTION_BLUR_PARAMS_BYTE_SIZE = 32;
+var DEFAULT_MOTION_BLUR_PARAMS = Object.freeze({
+  shutterAngle: 180,
+  maxRadiusPixels: 32,
+  sampleCount: 8,
+  targetFps: 60
+});
+var MotionBlurValidationError = class extends Error {
+  code = "motion-blur-invalid-params";
+  expected;
+  hint;
+  detail;
+  constructor(detail) {
+    const integer = detail.integer === true ? "integer " : "";
+    const expected = `${detail.field} ${integer}in [${detail.min}, ${detail.max}]`;
+    super(`motion-blur-invalid-params: ${expected}`);
+    this.name = "MotionBlurValidationError";
+    this.expected = expected;
+    this.hint = `set ${detail.field} to an ${integer}value in [${detail.min}, ${detail.max}]`;
+    this.detail = detail;
+  }
+};
+function validateField(field, value, min, max, integer = false) {
+  if (!Number.isFinite(value) || value < min || value > max || integer && !Number.isInteger(value)) {
+    return new MotionBlurValidationError({
+      field,
+      value,
+      min,
+      max,
+      ...integer ? { integer } : {}
+    });
+  }
+  return void 0;
+}
+function validateMotionBlurParams(input) {
+  const value = input ?? {};
+  const shutterAngle = value.shutterAngle ?? DEFAULT_MOTION_BLUR_PARAMS.shutterAngle;
+  const maxRadiusPixels = value.maxRadiusPixels ?? DEFAULT_MOTION_BLUR_PARAMS.maxRadiusPixels;
+  const sampleCount = value.sampleCount ?? DEFAULT_MOTION_BLUR_PARAMS.sampleCount;
+  const targetFps = value.targetFps ?? DEFAULT_MOTION_BLUR_PARAMS.targetFps;
+  const shutterError = validateField("shutterAngle", shutterAngle, 0, 360);
+  if (shutterError !== void 0) return err(shutterError);
+  const radiusError = validateField("maxRadiusPixels", maxRadiusPixels, 0, 64);
+  if (radiusError !== void 0) return err(radiusError);
+  const sampleError = validateField("sampleCount", sampleCount, 4, 16, true);
+  if (sampleError !== void 0) return err(sampleError);
+  const targetFpsError = validateField("targetFps", targetFps, 0, 240, true);
+  if (targetFpsError !== void 0) return err(targetFpsError);
+  return ok(Object.freeze({ shutterAngle, maxRadiusPixels, sampleCount, targetFps }));
+}
+function motionBlurTemporalDemand(params) {
+  return params !== void 0 && params.shutterAngle > 0 && params.maxRadiusPixels > 0;
+}
+function effectiveMotionBlurSampleCount(sampleCount) {
+  if (!Number.isFinite(sampleCount) || sampleCount < 4) return 0;
+  if (sampleCount < 8) return 4;
+  if (sampleCount < 16) return 8;
+  return 16;
+}
+function isMotionBlurIntervalValid(frameDeltaSeconds) {
+  return Number.isFinite(frameDeltaSeconds) && frameDeltaSeconds > 0 && frameDeltaSeconds <= 0.1;
+}
+function motionBlurExposureScale(frameDeltaSeconds, targetFps) {
+  if (!isMotionBlurIntervalValid(frameDeltaSeconds)) return 0;
+  if (!Number.isFinite(targetFps) || targetFps < 0 || targetFps > 240 || !Number.isInteger(targetFps)) {
+    return 0;
+  }
+  if (targetFps === 0) return 1;
+  return 1 / (targetFps * frameDeltaSeconds);
+}
+function motionBlurSampleDelta(sampleTimeSeconds, previousSampleTimeSeconds, fallbackDeltaSeconds) {
+  if (sampleTimeSeconds !== void 0 && !Number.isFinite(sampleTimeSeconds) || previousSampleTimeSeconds !== void 0 && !Number.isFinite(previousSampleTimeSeconds)) {
+    return Number.NaN;
+  }
+  if (Number.isFinite(sampleTimeSeconds) && Number.isFinite(previousSampleTimeSeconds)) {
+    return sampleTimeSeconds - previousSampleTimeSeconds;
+  }
+  return fallbackDeltaSeconds;
+}
+function resolveMotionBlurParams(input) {
+  if (input === void 0) return ok(void 0);
+  return validateMotionBlurParams(input);
+}
 
 // src/gpu-texture-usage.ts
 var GPU_TEXTURE_USAGE_COPY_SRC = 1;
@@ -1266,6 +1355,7 @@ function missing(operation, id) {
 }
 var InstanceCollectionStore = class {
   nextId = 1;
+  nextInstanceGeneration = 1;
   epochValue = 0;
   disposed = false;
   records = /* @__PURE__ */ new Map();
@@ -1287,9 +1377,11 @@ var InstanceCollectionStore = class {
     if (invalidPayload !== void 0) return err(invalidPayload);
     const id = this.nextId++;
     const count = input.transforms.length / MATRIX_STRIDE;
+    const generations = this.allocateGenerations(count);
     const record = {
       id,
       transforms: new Float32Array(input.transforms),
+      generations,
       count,
       capacity: nextCapacity(Math.max(INITIAL_CAPACITY, count)),
       revision: 1,
@@ -1301,13 +1393,17 @@ var InstanceCollectionStore = class {
     this.epochValue += 1;
     return ok(this.info(record));
   }
-  replace(id, transforms) {
+  replace(id, transforms, generations) {
     const record = this.live("replace", id);
     if (!record.ok) return record;
     const invalidPayload = validateTransforms("replace", transforms, id);
     if (invalidPayload !== void 0) return err(invalidPayload);
     const count = transforms.length / MATRIX_STRIDE;
+    const generationResult = generations === void 0 ? ok(this.allocateGenerations(count)) : this.validateReplacementGenerations(generations, count, id);
+    if (!generationResult.ok) return generationResult;
+    const replacementGenerations = generationResult.value;
     record.value.transforms = new Float32Array(transforms);
+    record.value.generations = replacementGenerations;
     record.value.count = count;
     record.value.capacity = Math.max(record.value.capacity, nextCapacity(Math.max(1, count)));
     record.value.revision += 1;
@@ -1424,7 +1520,12 @@ var InstanceCollectionStore = class {
     if (!record.ok) return record;
     const value = record.value;
     value.lastSnapshotRevision = value.revision;
-    const result = this.detachedSnapshot(value);
+    const result = {
+      ...this.info(value),
+      transforms: new Float32Array(value.transforms),
+      generations: new Uint32Array(value.generations),
+      dirtyRanges: value.dirtyRanges.map((range) => ({ ...range }))
+    };
     return ok(result);
   }
   /**
@@ -1490,6 +1591,7 @@ var InstanceCollectionStore = class {
     return {
       ...this.info(record),
       transforms: new Float32Array(record.transforms),
+      generations: new Uint32Array(record.generations),
       dirtyRanges: record.dirtyRanges.map((range) => ({ ...range }))
     };
   }
@@ -1501,6 +1603,49 @@ var InstanceCollectionStore = class {
       revision: record.revision
     });
   }
+  allocateGenerations(count) {
+    const generations = new Uint32Array(count);
+    for (let index = 0; index < count; index += 1) {
+      generations[index] = this.nextInstanceGeneration;
+      this.nextInstanceGeneration = this.nextInstanceGeneration + 1 >>> 0 || 1;
+    }
+    return generations;
+  }
+  validateReplacementGenerations(generations, count, collectionId) {
+    if (!(generations instanceof Uint32Array) || generations.length !== count) {
+      return err(
+        invalid(
+          "replace",
+          `generations is a Uint32Array with ${count} entries`,
+          generations instanceof Uint32Array ? generations.length : typeof generations,
+          collectionId,
+          { requestedBytes: generations?.byteLength ?? 0, cause: "invalid-generation-shape" }
+        )
+      );
+    }
+    const seen = /* @__PURE__ */ new Set();
+    for (const generation of generations) {
+      if (generation === 0 || seen.has(generation)) {
+        return err(
+          invalid(
+            "replace",
+            "generations contain unique non-zero identity tokens",
+            generation,
+            collectionId,
+            {
+              requestedBytes: generations.byteLength,
+              cause: "invalid-generation-identity"
+            }
+          )
+        );
+      }
+      seen.add(generation);
+      if (generation >= this.nextInstanceGeneration) {
+        this.nextInstanceGeneration = generation + 1 >>> 0 || 1;
+      }
+    }
+    return ok(new Uint32Array(generations));
+  }
   projectInspection(record) {
     const residency = this.residency.get(record.id);
     return Object.freeze({
@@ -1573,9 +1718,8 @@ var RENDER_GRAPH_EXECUTION_PHASE_CATALOG = [
   "record/graph-execute/skybox",
   "record/graph-execute/main",
   "record/graph-execute/fxaa",
-  "record/graph-execute/bloom-bright",
-  "record/graph-execute/bloom-blur-h",
-  "record/graph-execute/bloom-blur-v",
+  "record/graph-execute/bloom-downsample",
+  "record/graph-execute/bloom-upsample",
   "record/graph-execute/bloom-composite",
   "record/graph-execute/ssr-hiz",
   "record/graph-execute/ssr-trace",
@@ -1634,6 +1778,6 @@ var RENDER_PHASE_CATALOG = [
   ...RENDER_RECORD_PHASE_CATALOG
 ];
 
-export { AtmosphereInvalidParameterError, AutoExposureCapabilityUnavailableError, AutoExposureInvalidParameterError, AutoExposureStageFailedError, AutoExposureStaleGenerationError, DynamicResolutionInvalidParameterError, DynamicResolutionRequiresTaaError, DynamicResolutionTimingUnavailableError, EnvironmentGenerationFailedError, EnvironmentSourceConflictError, EquirectProjectionFailedError, FXAA_POST_PROCESS_ID, FogCardinalityError, FrameReceiptStaleError, GPU_TEXTURE_USAGE_COPY_DST, GPU_TEXTURE_USAGE_COPY_SRC, GPU_TEXTURE_USAGE_RENDER_ATTACHMENT, GPU_TEXTURE_USAGE_RENDER_ATTACHMENT_AND_TEXTURE_BINDING, GPU_TEXTURE_USAGE_STORAGE_BINDING, GPU_TEXTURE_USAGE_TEXTURE_BINDING, GpuDrivenPreparationError, InstanceCollectionError, InstanceCollectionStore, LifecycleConstructionError, MaterialSkinAttrMissingError, ObservationUnavailableError, OwnerStageFailedError, PointShadowAtlasBoundsViolationError, PointShadowAtlasUninitializedError, PointsLinesBudgetExceededError, PointsLinesInvalidStyleError, PointsLinesMaterialUnsupportedError, PointsLinesPrepareFailedError, PointsLinesStyleUnsupportedError, PointsLinesTopologyMismatchError, RENDER_PHASE_CATALOG, RenderFeatureCapabilityMissingError, RenderFeatureDrawRecordingFailedError, RenderFeaturePreparationFailedError, RenderFeaturePreparedStateMismatchError, RenderFeatureRegistrationConflictError, RenderFeatureStageFailedError, RenderIntentInvalidError, RenderTargetCapabilityMissingError, RenderTargetDescriptorInvalidError, RenderTargetOperationFailedError, RenderTargetStateInvalidError, RendererContractFailureError, RendererOperationError, SHADOW_ATLAS_DEFAULT_FACE_SIZE, SHADOW_ATLAS_DEFAULT_LAYERS, STANDARD_OUTPUT_TRANSFORM_FEATURE_ID, SceneDataUnavailableError, ShadowAtlas, ShadowInvalidConfigError, SkinMaterialMismatchError, SkinPaletteOverflowError, StandardClusterIndexOverflowError, StandardClusterTransportUnavailableError, StandardLightBudgetExceededError, StandardProfileInvalidError, TaaCapsInsufficientError, TemporalFrameSubmitError, TransmissionCapabilityMissingError, VertexColorVariantConflictError, VideoUploadUnsupportedError, VolumeDensityShapeMismatchError, VolumeInvalidBoundsError, VolumeInvalidParametersError, VolumeOwnerConflictError, createAutoExposureError, createAutoExposureInspection, createLightResourceUnavailable, createVisibilityBudget, instanceUploadRangesForResident };
-//# sourceMappingURL=chunk-6TFBXLRJ.mjs.map
-//# sourceMappingURL=chunk-6TFBXLRJ.mjs.map
+export { AtmosphereInvalidParameterError, AutoExposureCapabilityUnavailableError, AutoExposureInvalidParameterError, AutoExposureStageFailedError, AutoExposureStaleGenerationError, DEFAULT_MOTION_BLUR_PARAMS, DynamicResolutionInvalidParameterError, DynamicResolutionRequiresTaaError, DynamicResolutionTimingUnavailableError, EnvironmentGenerationFailedError, EnvironmentSourceConflictError, EquirectProjectionFailedError, FXAA_POST_PROCESS_ID, FogCardinalityError, FrameReceiptStaleError, GPU_TEXTURE_USAGE_COPY_DST, GPU_TEXTURE_USAGE_COPY_SRC, GPU_TEXTURE_USAGE_RENDER_ATTACHMENT, GPU_TEXTURE_USAGE_RENDER_ATTACHMENT_AND_TEXTURE_BINDING, GPU_TEXTURE_USAGE_STORAGE_BINDING, GPU_TEXTURE_USAGE_TEXTURE_BINDING, GpuDrivenPreparationError, InstanceCollectionError, InstanceCollectionStore, LifecycleConstructionError, MOTION_BLUR_PARAMS_BYTE_SIZE, MaterialSkinAttrMissingError, MotionBlurValidationError, ObservationUnavailableError, OwnerStageFailedError, PointShadowAtlasBoundsViolationError, PointShadowAtlasUninitializedError, PointsLinesBudgetExceededError, PointsLinesInvalidStyleError, PointsLinesMaterialUnsupportedError, PointsLinesPrepareFailedError, PointsLinesStyleUnsupportedError, PointsLinesTopologyMismatchError, RENDER_PHASE_CATALOG, RenderFeatureCapabilityMissingError, RenderFeatureDrawRecordingFailedError, RenderFeaturePreparationFailedError, RenderFeaturePreparedStateMismatchError, RenderFeatureRegistrationConflictError, RenderFeatureStageFailedError, RenderIntentInvalidError, RenderTargetCapabilityMissingError, RenderTargetDescriptorInvalidError, RenderTargetOperationFailedError, RenderTargetStateInvalidError, RendererContractFailureError, RendererOperationError, SHADOW_ATLAS_DEFAULT_FACE_SIZE, SHADOW_ATLAS_DEFAULT_LAYERS, STANDARD_OUTPUT_TRANSFORM_FEATURE_ID, SceneDataUnavailableError, ShadowAtlas, ShadowInvalidConfigError, SkinMaterialMismatchError, SkinPaletteOverflowError, StandardClusterIndexOverflowError, StandardClusterTransportUnavailableError, StandardLightBudgetExceededError, StandardProfileInvalidError, TaaCapsInsufficientError, TemporalFrameSubmitError, TransmissionCapabilityMissingError, VertexColorVariantConflictError, VideoUploadUnsupportedError, VolumeDensityShapeMismatchError, VolumeInvalidBoundsError, VolumeInvalidParametersError, VolumeOwnerConflictError, createAutoExposureError, createAutoExposureInspection, createLightResourceUnavailable, createVisibilityBudget, effectiveMotionBlurSampleCount, instanceUploadRangesForResident, isMotionBlurIntervalValid, motionBlurExposureScale, motionBlurSampleDelta, motionBlurTemporalDemand, resolveMotionBlurParams, validateMotionBlurParams };
+//# sourceMappingURL=chunk-NB2S7ZRX.mjs.map
+//# sourceMappingURL=chunk-NB2S7ZRX.mjs.map