@forgeax/engine-render 0.1.30 → 0.1.32

package/dist/{chunk-NO4WZCAH.mjs → chunk-S665NJNF.mjs}

@@ -1,4 +1,4 @@
-import { RenderFeaturePreparedStateMismatchError, SceneDataUnavailableError } from './chunk-JRBDO2KB.mjs';
+import { RenderFeaturePreparedStateMismatchError, SceneDataUnavailableError } from './chunk-6TFBXLRJ.mjs';
 import { err, ok } from '@forgeax/engine-types';
 
 // src/pipeline/standard-lighting/layout.ts
@@ -292,5 +292,5 @@ function createSceneDataCatalog(options) {
 }
 
 export { CLUSTER_GRID_STRIDE_U32, DEFAULT_CLUSTER_GRID, DEFAULT_STANDARD_PROFILE, LIGHT_INDEX_LIST_CAPACITY, MAX_LIGHTS, REFLECTION_PROBE_IBL_STAGES, SCENE_DATA_TEMPORAL_V1_DESCRIPTOR, SCENE_DATA_TEMPORAL_V1_SCHEMA, STANDARD_LIGHT_COUNTS, STANDARD_PIPELINE_ID, STANDARD_POST_STAGE_NAMES, beginProbeIblUpdate, createIblKernelCache, createProbeIblOutput, createSceneDataCatalog, createStandardClusterLayout, isSceneDataTarget, publishProbeIblOutput, registerSceneDataTarget, resetIblKernelCaches, resolveVolumetricFogProfile, sceneDataError, sceneDataTargetAsAttachment, sceneDataTargetOwner, sceneDataTokenMismatch };
-//# sourceMappingURL=chunk-NO4WZCAH.mjs.map
-//# sourceMappingURL=chunk-NO4WZCAH.mjs.map
+//# sourceMappingURL=chunk-S665NJNF.mjs.map
+//# sourceMappingURL=chunk-S665NJNF.mjs.map

package/dist/{chunk-NO4WZCAH.mjs.map → chunk-S665NJNF.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":";;;;AAAO,IAAM,uBAAuB,EAAE,CAAA,EAAG,IAAI,CAAA,EAAG,CAAA,EAAG,GAAG,EAAA;AAC/C,IAAM,uBAAA,GAA0B;AAChC,IAAM,yBAAA,GAA4B;AAClC,IAAM,UAAA,GAAa;AAYnB,SAAS,2BAAA,CACd,OAAuE,oBAAA,EAChD;AACvB,EAAA,MAAM,YAAA,GAAe,IAAA,CAAK,CAAA,GAAI,IAAA,CAAK,IAAI,IAAA,CAAK,CAAA;AAC5C,EAAA,OAAO,OAAO,MAAA,CAAO;AAAA,IACnB,IAAA;AAAA,IACA,YAAA;AAAA,IACA,oBAAA,EAAsB,uBAAA;AAAA,IACtB,sBAAsB,YAAA,GAAe,uBAAA;AAAA,IACrC,sBAAA,EAAwB,yBAAA;AAAA,IACxB,kBAAA,EAAoB,UAAA;AAAA,IACpB,wBAAwB,UAAA,GAAa;AAAA,GACtC,CAAA;AACH;AAEuC,2BAAA;;;AC7BhC,IAAM,oBAAA,GAAuB;AAC7B,IAAM,qBAAA,GAAwB,CAAC,CAAA,EAAG,EAAA,EAAI,GAAG;AAkBzC,IAAM,yBAAA,GAA4B;AAAA,EACvC,mBAAA;AAAA,EACA,OAAA;AAAA,EACA,kBAAA;AAAA,EACA,MAAA;AAAA,EACA,aAAA;AAAA,EACA;AACF;AAgBO,IAAM,wBAAA,GAA4C,OAAO,MAAA,CAAO;AAAA,EACrE,UAAA,EAAY,oBAAA;AAAA,EACZ,UAAA,EAAY,EAAA;AAAA,EACZ,UAAA,EAAY,SAAA;AAAA,EACZ,OAAA,EAAS,UAAA;AAAA,EACT,GAAA,EAAK,IAAA;AAAA,EACL,GAAA,EAAK,IAAA;AAAA,EACL,IAAA,EAAM,KAAA;AAAA,EACN,UAAA,EAAY;AACd,CAAC;AAEM,SAAS,4BACd,OAAA,EAC8B;AAC9B,EAAA,OAAO,OAAA,CAAQ,iBAAiB,EAAE,OAAA,EAAS,QAAQ,KAAA,EAAO,EAAA,EAAI,UAAU,CAAA,EAAE;AAC5E;;;AC1DO,IAAM,2BAAA,GAA8B,CAAC,KAAA,EAAO,UAAA,EAAY,SAAS;AAUxE,IAAM,YAAA,uBAAmB,GAAA,EAA4B;AAE9C,SAAS,qBAAqB,UAAA,EAAoC;AACvE,EAAA,MAAM,QAAA,GAAW,YAAA,CAAa,GAAA,CAAI,UAAU,CAAA;AAC5C,EAAA,IAAI,QAAA,KAAa,QAAW,OAAO,QAAA;AACnC,EAAA,MAAM,OAAA,GAA0B;AAAA,IAC9B,UAAA;AAAA,IACA,kBAAkB,EAAC;AAAA,IACnB,iBAAiB,EAAC;AAAA,IAClB,iBAAiB;AAAC,GACpB;AACA,EAAA,YAAA,CAAa,GAAA,CAAI,YAAY,OAAO,CAAA;AACpC,EAAA,OAAO,OAAA;AACT;AAmBO,SAAS,qBAAqB,KAAA,EAIlB;AACjB,EAAA,OAAO;AAAA,IACL,GAAG,KAAA;AAAA,IACH,KAAK,EAAC;AAAA,IACN,UAAU,EAAC;AAAA,IACX,aAAA,EAAe,CAAA;AAAA,IACf,kBAAA,EAAoB,CAAA;AAAA,IACpB,GAAA,EAAK;AAAA,GACP;AACF;AAEO,SAAS,oBAAoB,MAAA,EAAwC;AAC1E,EAAA,OAAO;AAAA,IACL,GAAG,MAAA;AAAA,IACH,MAAA,EAAQ,2BAAA;AAAA,IACR,SAAA,EAAW,KAAA;AAAA,IACX,mBAAA,EAAqB,OAAO,kBAAA,GAAqB;AAAA,GACnD;AACF;AAEO,SAAS,qBAAA,CACd,QACA,MAAA,EACgB;AAChB,EAAA,IAAI,CAAC,MAAA,CAAO,EAAA,IAAM,OAAO,KAAA,KAAU,MAAA,CAAO,WAAW,OAAO,MAAA;AAC5D,EAAA,IAAI,MAAA,CAAO,UAAU,KAAA,EAAO;AAC1B,IAAA,OAAO;AAAA,MACL,GAAG,MAAA;AAAA,MACH,eAAe,MAAA,CAAO;AAAA,KACxB;AAAA,EACF;AACA,EAAA,IAAI,MAAA,CAAO,KAAA,KAAU,UAAA,EAAY,OAAO,MAAA;AACxC,EAAA,OAAO;AAAA,IACL,GAAG,MAAA;AAAA,IACH,oBAAoB,MAAA,CAAO,mBAAA;AAAA,IAC3B,GAAA,EAAK;AAAA,GACP;AACF;AAEO,SAAS,oBAAA,GAA6B;AAC3C,EAAA,YAAA,CAAa,KAAA,EAAM;AACrB;;;ACnFO,IAAM,6BAAA,GAAgC;AAkBtC,IAAM,iCAAA,GAAmE,OAAO,MAAA,CAAO;AAAA,EAC5F,MAAA,EAAQ,6BAAA;AAAA,EACR,MAAA,EAAQ,aAAA;AAAA,EACR,WAAA,EAAa,CAAA;AAAA,EACb,MAAA,EAAQ,mBAAA;AAAA,EACR,UAAA,EAAY,CAAC,CAAA,EAAG,CAAA,EAAG,IAAI,CAAC,CAAA;AAAA,EACxB,QAAA,EAAU,OAAO,MAAA,CAAO;AAAA,IACtB,QAAA,EAAU,IAAA;AAAA,IACV,SAAA,EAAW,qBAAA;AAAA,IACX,QAAA,EAAU;AAAA,GACX;AACH,CAAC;AAeD,IAAM,YAAA,uBAAmB,OAAA,EAA0C;AAQ5D,SAAS,uBAAA,CACd,QACA,KAAA,EACM;AACN,EAAA,YAAA,CAAa,GAAA,CAAI,QAAQ,KAAK,CAAA;AAChC;AAEO,SAAS,qBACd,MAAA,EACsC;AACtC,EAAA,OAAO,OAAO,WAAW,QAAA,IAAY,MAAA,KAAW,OAAO,YAAA,CAAa,GAAA,CAAI,MAAM,CAAA,GAAI,MAAA;AACpF;AAEO,SAAS,sBAAA,CACd,SAAA,EACA,MAAA,EACA,KAAA,EACA,MAAA,EACwB;AACxB,EAAA,MAAM,MAAA,GACJ,WAAW,qBAAA,GACP;AAAA,IACE,iBAAiB,KAAA,CAAM,eAAA;AAAA,IACvB,KAAA,EAAO,EAAA;AAAA,IACP,KAAA,EAAO,YAAA;AAAA,IACP,SAAA;AAAA,IACA,YAAA,EAAc,YAAA;AAAA,IACd,MAAA;AAAA,IACA,oBAAoB,KAAA,CAAM,UAAA;AAAA,IAC1B,gBAAA,EAAkB,YAAA,CAAa,GAAA,CAAI,MAAgB,GAAG,UAAA,IAAc,EAAA;AAAA,IACpE,QAAA,EAAU;AAAA,GACZ,GACA,WAAW,iBAAA,GACT;AAAA,IACE,iBAAiB,KAAA,CAAM,eAAA;AAAA,IACvB,KAAA,EAAO,EAAA;AAAA,IACP,KAAA,EAAO,YAAA;AAAA,IACP,SAAA;AAAA,IACA,YAAA,EAAc,YAAA;AAAA,IACd,MAAA;AAAA,IACA,yBAAyB,KAAA,CAAM,eAAA;AAAA,IAC/B,qBAAA,EAAuB,YAAA,CAAa,GAAA,CAAI,MAAgB,GAAG,eAAA,IAAmB,SAAA;AAAA,IAC9E,QAAA,EAAU;AAAA,GACZ,GACA,WAAW,cAAA,GACT;AAAA,IACE,iBAAiB,KAAA,CAAM,eAAA;AAAA,IACvB,KAAA,EAAO,EAAA;AAAA,IACP,KAAA,EAAO,YAAA;AAAA,IACP,SAAA;AAAA,IACA,YAAA,EAAc,YAAA;AAAA,IACd,MAAA;AAAA,IACA,YAAA,EAAc,YAAA;AAAA,IACd,UAAA,EAAY,UAAA;AAAA,IACZ,QAAA,EAAU;AAAA,GACZ,GACA;AAAA,IACE,iBAAiB,KAAA,CAAM,eAAA;AAAA,IACvB,KAAA,EAAO,EAAA;AAAA,IACP,KAAA,EAAO,YAAA;AAAA,IACP,SAAA;AAAA,IACA,YAAA,EAAc,YAAA;AAAA,IACd,MAAA;AAAA,IACA,cAAA,EAAgB,0BAAA;AAAA,IAChB,YAAA,EAAc,QAAQ,MAAA,IAAU,SAAA;AAAA,IAChC,QAAA,EAAU;AAAA,GACZ;AACV,EAAA,OAAO,IAAI,wCAAwC,MAAM,CAAA;AAC3D;AAEO,SAAS,kBAAkB,KAAA,EAA0C;AAC1E,EAAA,IAAI,KAAA,KAAU,IAAA,IAAQ,OAAO,KAAA,KAAU,UAAU,OAAO,KAAA;AACxD,EAAA,MAAM,SAAA,GAAY,KAAA;AAClB,EAAA,OACE,SAAA,CAAU,SAAS,YAAA,IACnB,SAAA,CAAU,WAAW,6BAAA,IACrB,SAAA,CAAU,WAAW,cAAA,IACrB,SAAA,CAAU,WAAW,aAAA,IACrB,SAAA,CAAU,gBAAgB,CAAA,IAC1B,SAAA,CAAU,WAAW,mBAAA,IACrB,YAAA,CAAa,IAAI,KAAK,CAAA;AAE1B;AAEO,SAAS,4BAA4B,OAAA,EAAiC;AAC3E,EAAA,MAAM,IAAI,UAAU,0EAA0E,CAAA;AAChG;AAIO,SAAS,eAAe,KAAA,EAA4C;AACzE,EAAA,OAAO,KAAA;AACT;ACrFA,SAAS,aAAa,OAAA,EAAyD;AAC7E,EAAA,IAAI,QAAQ,UAAA,EAAY,OAAO,EAAE,MAAA,EAAQ,aAAA,EAAe,QAAQ,qBAAA,EAAsB;AACtF,EAAA,IAAI,CAAC,OAAA,CAAQ,qBAAA;AACX,IAAA,OAAO,EAAE,MAAA,EAAQ,aAAA,EAAe,MAAA,EAAQ,oBAAA,EAAqB;AAC/D,EAAA,IAAI,QAAQ,eAAA,KAAoB,KAAA;AAC9B,IAAA,OAAO,EAAE,MAAA,EAAQ,aAAA,EAAe,MAAA,EAAQ,kBAAA,EAAmB;AAC7D,EAAA,IAAI,QAAQ,gBAAA,KAAqB,KAAA;AAC/B,IAAA,OAAO,EAAE,MAAA,EAAQ,aAAA,EAAe,MAAA,EAAQ,qBAAA,EAAsB;AAChE,EAAA,OAAO;AAAA,IACL,MAAA,EAAQ,WAAA;AAAA,IACR,YAAA,EAAc,OAAA,CAAQ,gBAAA,GAAmB,8BAAA,GAAiC;AAAA,GAC5E;AACF;AAEA,SAAS,aAAa,KAAA,EAAiD;AACrE,EAAA,MAAM,MAAA,GAAS,OAAO,MAAA,CAAO;AAAA,IAC3B,IAAA,EAAM,YAAA;AAAA,IACN,MAAA,EAAQ,6BAAA;AAAA,IACR,MAAA,EAAQ,cAAA;AAAA,IACR,MAAA,EAAQ,aAAA;AAAA,IACR,WAAA,EAAa,CAAA;AAAA,IACb,MAAA,EAAQ;AAAA,GACT,CAAA;AACD,EAAA,uBAAA,CAAwB,MAAA,EAAQ;AAAA,IAC9B,iBAAiB,KAAA,CAAM,eAAA;AAAA,IACvB,cAAc,KAAA,CAAM,YAAA;AAAA,IACpB,YAAY,KAAA,CAAM;AAAA,GACnB,CAAA;AACD,EAAA,OAAO,MAAA;AACT;AAEA,SAAS,UAAA,CAAW,SAAkC,SAAA,EAAgC;AACpF,EAAA,OAAO,sBAAA;AAAA,IACL,SAAA;AAAA,IACA,cAAA;AAAA,IACA;AAAA,MACE,iBAAiB,OAAA,CAAQ,eAAA;AAAA,MACzB,cAAc,OAAA,CAAQ,YAAA;AAAA,MACtB,YAAY,OAAA,CAAQ;AAAA,KACtB;AAAA,IACA;AAAA,GACF;AACF;AAEA,SAAS,gBAAA,CACP,SACA,MAAA,EACa;AACb,EAAA,MAAM,WACJ,MAAA,KAAW,oBAAA,GACP,mBAAA,GACA,MAAA,KAAW,wBACT,kBAAA,GACA,YAAA;AACR,EAAA,OAAO,IAAI,yBAAA,CAA0B;AAAA,IACnC,iBAAiB,OAAA,CAAQ,eAAA;AAAA,IACzB,MAAA,EAAQ,6BAAA;AAAA,IACR,IAAA,EAAM,QAAQ,IAAA,IAAQ,QAAA;AAAA,IACtB,MAAA;AAAA,IACA,qBAAA,EAAuB,OAAA,CAAQ,qBAAA,IAAyB,EAAC;AAAA,IACzD,8BAAA,EAAgC,CAAA;AAAA,IAChC;AAAA,GACD,CAAA;AACH;AAEO,SAAS,uBAAuB,OAAA,EAAoD;AACzF,EAAA,MAAM,KAAA,GAAQ,aAAa,OAAO,CAAA;AAClC,EAAA,MAAM,KAAA,GAAQ;AAAA,IACZ,iBAAiB,OAAA,CAAQ,eAAA;AAAA,IACzB,cAAc,OAAA,CAAQ,YAAA;AAAA,IACtB,YAAY,OAAA,CAAQ;AAAA,GACtB;AACA,EAAA,MAAM,UAAU,CAAC,GAAI,OAAA,CAAQ,qBAAA,IAAyB,EAAG,CAAA;AACzD,EAAA,MAAM,cAAA,GAAiB;AAAA,IACrB,MAAA,EAAQ,6BAAA;AAAA,IACR,YAAY,OAAA,CAAQ,UAAA;AAAA,IACpB,cAAc,OAAA,CAAQ,YAAA;AAAA,IACtB,IAAA,EAAM,QAAQ,IAAA,IAAQ,QAAA;AAAA,IACtB,uBAAuB,MAAA,CAAO,MAAA,CAAO,QAAQ,KAAA,CAAM,CAAA,EAAG,EAAE,CAAC,CAAA;AAAA,IACzD,gCAAgC,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,OAAA,CAAQ,SAAS,EAAE;AAAA,GACjE;AACA,EAAA,OAAO;AAAA,IACL,MAAA,EAAQ,6BAAA;AAAA,IACR,YAAY,OAAA,CAAQ,UAAA;AAAA,IACpB,cAAc,OAAA,CAAQ,YAAA;AAAA,IACtB,YAAA,EAAc,KAAA;AAAA,IACd,QAAQ,MAAA,EAAQ;AACd,MAAA,IAAI,MAAA,KAAW,6BAAA,IAAiC,KAAA,CAAM,MAAA,KAAW,WAAA,EAAa;AAC5E,QAAA,IAAI,MAAM,MAAA,KAAW,aAAA,QAAqB,gBAAA,CAAiB,OAAA,EAAS,MAAM,MAAM,CAAA;AAChF,QAAA,MAAM,UAAA,CAAW,SAAS,2BAA2B,CAAA;AAAA,MACvD;AACA,MAAA,OAAO,aAAa,OAAO,CAAA;AAAA,IAC7B,CAAA;AAAA,IACA,QAAA,CAAS,MAAA,EAAQ,UAAA,GAAa,OAAA,CAAQ,UAAA,EAAY;AAChD,MAAA,MAAM,WAAA,GAAc,qBAAqB,MAAM,CAAA;AAC/C,MAAA,IAAI,gBAAgB,MAAA,EAAW;AAC7B,QAAA,OAAO,GAAA;AAAA,UACL,sBAAA,CAAuB,4BAAA,EAA8B,iBAAA,EAAmB,KAAA,EAAO,MAAM;AAAA,SACvF;AAAA,MACF;AACA,MAAA,IACE,YAAY,YAAA,KAAiB,KAAA,CAAM,gBACnC,WAAA,CAAY,eAAA,KAAoB,MAAM,eAAA,EACtC;AACA,QAAA,OAAO,GAAA;AAAA,UACL,sBAAA,CAAuB,4BAAA,EAA8B,iBAAA,EAAmB,KAAA,EAAO,MAAM;AAAA,SACvF;AAAA,MACF;AACA,MAAA,IAAI,eAAe,KAAA,CAAM,UAAA,IAAc,WAAA,CAAY,UAAA,KAAe,MAAM,UAAA,EAAY;AAClF,QAAA,OAAO,GAAA;AAAA,UACL,sBAAA;AAAA,YACE,4BAAA;AAAA,YACA,qBAAA;AAAA,YACA,KAAA;AAAA,YACA;AAAA;AACF,SACF;AAAA,MACF;AACA,MAAA,IAAI,MAAA,CAAO,WAAW,cAAA,EAAgB;AACpC,QAAA,OAAO,GAAA;AAAA,UACL,sBAAA,CAAuB,4BAAA,EAA8B,iBAAA,EAAmB,KAAA,EAAO,MAAM;AAAA,SACvF;AAAA,MACF;AACA,MAAA,OAAO,GAAG,MAAM,CAAA;AAAA,IAClB,CAAA;AAAA,IACA,OAAA,GAAU;AACR,MAAA,OAAO,MAAA,CAAO,MAAA;AAAA,QACZ,KAAA,CAAM,WAAW,WAAA,GACb,EAAE,GAAG,cAAA,EAAgB,MAAA,EAAQ,MAAM,MAAA,EAAQ,YAAA,EAAc,MAAM,YAAA,EAAa,GAC5E,EAAE,GAAG,cAAA,EAAgB,QAAQ,KAAA,CAAM,MAAA,EAAQ,MAAA,EAAQ,KAAA,CAAM,MAAA;AAAO,OACtE;AAAA,IACF;AAAA,GACF;AACF","file":"chunk-NO4WZCAH.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-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"]}

package/dist/components/depth-of-field.d.ts

@@ -0,0 +1,28 @@
+import { type SchemaOf, type ShapeOf } from '@forgeax/engine-ecs';
+/** Closed quality budget used by the built-in camera depth-of-field pass. */
+export type DepthOfFieldQuality = 'low' | 'medium' | 'high';
+export declare const DepthOfFieldQualityValue: Readonly<{
+    readonly low: 0;
+    readonly medium: 1;
+    readonly high: 2;
+}>;
+/** Selects which signed circle-of-confusion side contributes to the image. */
+export type DepthOfFieldSide = 'both' | 'near' | 'far';
+export declare const DepthOfFieldSideValue: Readonly<{
+    readonly both: 0;
+    readonly near: 1;
+    readonly far: 2;
+}>;
+/** Active-camera physical depth-of-field authoring data; presence enables it. */
+export declare const DepthOfField: import("@forgeax/engine-ecs").Component<"DepthOfField", {
+    readonly focusDistance: "f32";
+    readonly fStop: "f32";
+    readonly sensorHeight: "f32";
+    readonly maxRadiusPixels: "f32";
+    readonly quality: "f32";
+    readonly blurSide: "f32";
+}>;
+export type DepthOfFieldData = ShapeOf<SchemaOf<typeof DepthOfField>>;
+export declare function depthOfFieldQualityFromF32(value: number): DepthOfFieldQuality | undefined;
+export declare function depthOfFieldSideFromF32(value: number): DepthOfFieldSide | undefined;
+//# sourceMappingURL=depth-of-field.d.ts.map

package/dist/components/depth-of-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"depth-of-field.d.ts","sourceRoot":"","sources":["../../src/components/depth-of-field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnF,6EAA6E;AAC7E,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE5D,eAAO,MAAM,wBAAwB;;;;EAI1B,CAAC;AAEZ,8EAA8E;AAC9E,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAEvD,eAAO,MAAM,qBAAqB;;;;EAIvB,CAAC;AAEZ,iFAAiF;AACjF,eAAO,MAAM,YAAY;;;;;;;EAOvB,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC;AAEtE,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAKzF;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAKnF"}

package/dist/components/directional-light.d.ts

@@ -19,7 +19,8 @@ export { type DirectionalShadowFilterLabel, DirectionalShadowFilterValue, type D
  *   splitLambda    ∈ [0,1]      — PSSM split weight (default 0.75)
  *   cascadeBlend   ∈ [0,0.5]    — blend width between cascades (default 0.2)
  *   mapSize        >= 1         — shadow map resolution (default 2048)
- *   depthBias                    — normalized receiver depth subtraction (default 0.00001)
+ *   depthBias                    — normalized receiver depth floor (default 0.00001),
+ *                                  plus automatic texel/filter/slope coverage
  *   normalBias                   — world-space receiver normal offset (default 0.05)
  *   shadowDistance > 0           — how far shadows reach in front of the camera,
  *                                  in world units (default 200). This is the sole

package/dist/components/directional-light.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"directional-light.d.ts","sourceRoot":"","sources":["../../src/components/directional-light.ts"],"names":[],"mappings":"AAmCA,OAAO,EACL,KAAK,4BAA4B,EACjC,4BAA4B,EAC5B,KAAK,wBAAwB,EAC7B,+BAA+B,GAChC,MAAM,6BAA6B,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EA8B3B,CAAC"}
+{"version":3,"file":"directional-light.d.ts","sourceRoot":"","sources":["../../src/components/directional-light.ts"],"names":[],"mappings":"AAmCA,OAAO,EACL,KAAK,4BAA4B,EACjC,4BAA4B,EAC5B,KAAK,wBAAwB,EAC7B,+BAA+B,GAChC,MAAM,6BAA6B,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EA8B3B,CAAC"}

package/dist/components/index.d.ts

@@ -1,6 +1,7 @@
 export * from './atmosphere';
 export * from './camera';
 export * from './cube-camera';
+export * from './depth-of-field';
 export * from './directional-light';
 export * from './dynamic-resolution';
 export * from './fog';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,OAAO,CAAC;AACtB,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EACL,KAAK,UAAU,EACf,eAAe,EACf,MAAM,EACN,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,cAAc,oBAAoB,CAAC;AACnC,OAAO,EACL,aAAa,EACb,KAAK,2BAA2B,EAChC,KAAK,kBAAkB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,UAAU,EACf,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,KAAK,kBAAkB,EACvB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EACL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,KAAK,SAAS,EACd,SAAS,EACT,KAAK,aAAa,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,UAAU,EACV,KAAK,eAAe,EACpB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,OAAO,CAAC;AACtB,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EACL,KAAK,UAAU,EACf,eAAe,EACf,MAAM,EACN,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,cAAc,oBAAoB,CAAC;AACnC,OAAO,EACL,aAAa,EACb,KAAK,2BAA2B,EAChC,KAAK,kBAAkB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,UAAU,EACf,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,KAAK,kBAAkB,EACvB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EACL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,KAAK,SAAS,EACd,SAAS,EACT,KAAK,aAAa,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,UAAU,EACV,KAAK,eAAe,EACpB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,cAAc,CAAC"}