@forgeax/engine-render 0.1.33 → 0.1.35

package/dist/cloud/optics.d.ts

@@ -0,0 +1,56 @@
+import type { CloudDensityCache } from './density';
+import { type ValidatedCloudLayer } from './parameters';
+export type CloudOpticalPath = 'camera' | 'solar-column' | 'cloud-interior';
+export interface CloudRay {
+    readonly origin: readonly [number, number, number];
+    readonly direction: readonly [number, number, number];
+    readonly maxDistance: number;
+}
+export interface CloudOpticalResult {
+    readonly path: CloudOpticalPath;
+    readonly transmittance: number;
+    readonly scattering: readonly [number, number, number];
+    readonly opticalDepth: number;
+    readonly representativeDepth: number;
+    readonly steps: number;
+    readonly entered: boolean;
+    readonly exited: boolean;
+}
+export interface CloudInteriorLighting {
+    readonly sunRadiance: readonly [number, number, number];
+    readonly sunDirection: readonly [number, number, number];
+    readonly phaseG?: number;
+}
+export interface CloudOpticsInput {
+    readonly params: ValidatedCloudLayer;
+    readonly ray: CloudRay;
+    readonly path: CloudOpticalPath;
+    readonly timeSeconds?: number;
+    readonly cache?: CloudDensityCache;
+    readonly steps?: number;
+    readonly lighting?: CloudInteriorLighting;
+}
+export declare function intersectCloudLayer(ray: CloudRay, params: ValidatedCloudLayer): {
+    readonly start: number;
+    readonly end: number;
+} | undefined;
+/** Unit-sun incident light, using the same phase basis as production volumes. */
+export declare function cloudIncidentLight(solarT: number, cosTheta: number, height: number, forwardG?: number): readonly [number, number, number];
+/**
+ * Integrate one explicitly named optical path through the layer.
+ *
+ * Camera, solar-column and cloud-interior paths are intentionally separate
+ * call sites. A caller cannot accidentally use a camera interval as the
+ * light interval and apply the same cloud attenuation twice.
+ */
+export declare function integrateCloudPath(input: CloudOpticsInput): CloudOpticalResult;
+export declare function integrateCloudCameraPath(params: ValidatedCloudLayer, ray: CloudRay, options?: Omit<CloudOpticsInput, 'params' | 'ray' | 'path'>): CloudOpticalResult;
+export declare function integrateCloudSolarColumn(params: ValidatedCloudLayer, origin: readonly [number, number, number], sunDirection: readonly [number, number, number], options?: Omit<CloudOpticsInput, 'params' | 'ray' | 'path'> & {
+    readonly maxDistance?: number;
+}): CloudOpticalResult;
+export declare function integrateCloudInterior(params: ValidatedCloudLayer, ray: CloudRay, lighting: CloudInteriorLighting, options?: Omit<CloudOpticsInput, 'params' | 'ray' | 'path' | 'lighting'>): CloudOpticalResult;
+/** Standard's one selected sun term consumes this factor exactly once. */
+export declare function applyCloudSolarTransmittance(directSunRadiance: readonly [number, number, number], cloudTransmittance: number, meshVisibility?: number): readonly [number, number, number];
+/** Scene-linear HDR composition at the cloud interval/depth boundary. */
+export declare function compositeCloudRadiance(sceneLinearHdr: readonly [number, number, number, number], cloud: CloudOpticalResult, sceneDepth: number, cloudDepth?: number): readonly [number, number, number, number];
+//# sourceMappingURL=optics.d.ts.map

package/dist/cloud/optics.d.ts.map

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

package/dist/cloud/parameters.d.ts

@@ -0,0 +1,73 @@
+import { type Result } from '@forgeax/engine-types';
+import { type CloudLayerData, type CloudQuality } from '../components/cloud-layer';
+import { type CloudLayerError } from '../errors/cloud';
+export interface CloudLayerAuthoring {
+    readonly seed?: number;
+    readonly baseHeight?: number;
+    readonly thickness?: number;
+    readonly scale?: number;
+    readonly coverage?: number;
+    readonly density?: number;
+    readonly wind?: ArrayLike<number>;
+    readonly quality?: CloudQuality | number;
+    readonly shadowRange?: number;
+}
+export interface ValidatedCloudLayer {
+    readonly seed: number;
+    readonly baseHeight: number;
+    readonly thickness: number;
+    readonly scale: number;
+    readonly coverage: number;
+    readonly density: number;
+    readonly wind: readonly [number, number, number];
+    readonly quality: CloudQuality;
+    readonly shadowRange: number;
+}
+export interface CloudQualityProfile {
+    readonly cacheResolution: number;
+    readonly viewSteps: number;
+    readonly shadowSteps: number;
+    readonly historyWeight: number;
+    /** Renderer-owned sky trace domain in world units; independent of Camera.far. */
+    readonly viewDistance: number;
+}
+/**
+ * Quality values are bounded in one place. The values are deliberately
+ * renderer policy, while the component stores only the closed quality code.
+ */
+export declare const CLOUD_QUALITY_PROFILES: Readonly<Record<CloudQuality, CloudQualityProfile>>;
+/**
+ * The spatial cloud-shadow map is intentionally derived from the same quality
+ * profile everywhere: graph allocation, light-space projection and inspection
+ * must agree on one texel grid.  Keep the multiplier here rather than letting
+ * each owner invent a resolution.
+ */
+export declare function cloudShadowResolutionForQuality(qualityValue: CloudQuality): number;
+/**
+ * Cloud visibility is a sky-domain concern. It must not inherit the opaque
+ * geometry far plane or the finite receiver-shadow footprint: either value is
+ * commonly much shorter than a ground-view cloud trace and would turn the
+ * distant layer into a flat wall.
+ */
+export declare function cloudViewDistanceForQuality(qualityValue: CloudQuality): number;
+/** rgba16float is four 16-bit channels (8 bytes per texel). */
+export declare const CLOUD_SHADOW_BYTES_PER_TEXEL = 8;
+/**
+ * Authored density is a normalized formation value. Convert it to a bounded
+ * per-world-unit extinction coefficient only at integration time; otherwise a
+ * long horizon step would become opaque after its first sample and expose
+ * marching bands instead of a participating volume.
+ */
+export declare const CLOUD_EXTINCTION_COEFFICIENT = 0.03;
+export declare const DEFAULT_CLOUD_LAYER: ValidatedCloudLayer;
+/** Validate one detached CloudLayer POD before deriving cache or graph state. */
+export declare function validateCloudLayer(input: CloudLayerAuthoring | Partial<CloudLayerData> | undefined): Result<ValidatedCloudLayer, CloudLayerError>;
+/** Stable source identity used by cache, history and recovery receipts. */
+export declare function cloudLayerSourceKey(params: ValidatedCloudLayer): string;
+/**
+ * Stable identity for the reusable formation bases. Coverage, density and
+ * wind are evaluation inputs and deliberately do not rebuild the weather,
+ * body or erosion cache when they change continuously.
+ */
+export declare function cloudLayerFormationKey(params: ValidatedCloudLayer): string;
+//# sourceMappingURL=parameters.d.ts.map

package/dist/cloud/parameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameters.d.ts","sourceRoot":"","sources":["../../src/cloud/parameters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,YAAY,EAGlB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,KAAK,eAAe,EAAmC,MAAM,iBAAiB,CAAC;AAExF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,iFAAiF;IACjF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,mBAAmB,CAAC,CAyBnF,CAAC;AAEL;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAElF;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAE9E;AAED,+DAA+D;AAC/D,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,OAAO,CAAC;AAEjD,eAAO,MAAM,mBAAmB,EAAE,mBAUhC,CAAC;AAqDH,iFAAiF;AACjF,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,SAAS,GAC/D,MAAM,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAkD9C;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAevE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAS1E"}

package/dist/cloud/resources.d.ts

@@ -0,0 +1,60 @@
+import type { CloudDensityCache } from './density';
+import type { CloudShadowProjection } from './shadow';
+import type { CloudHistory } from './temporal';
+/** Evidence level for bytes owned by the prepared GPU path. */
+export type CloudGpuResourceEvidence = 'unavailable' | 'declared' | 'measured';
+/** rgba16float is four 16-bit channels (8 bytes per texel). */
+export declare const CLOUD_RGBA16FLOAT_BYTES_PER_TEXEL = 8;
+/** Two ping-pong surfaces for each of radiance/transmittance/depth. */
+export declare const CLOUD_HISTORY_SURFACE_COUNT = 6;
+export interface CloudLayerResourceFacts {
+    readonly generation: number;
+    /** CPU-side packed formation payload; this is not GPU residency. */
+    readonly cacheBytes: number;
+    /** Measured GPU bytes, or zero when no prepared-owner receipt was supplied. */
+    readonly shadowBytes: number;
+    readonly historyBytes: number;
+    readonly inFlightBytes: number;
+    readonly residentBytes: number;
+    readonly resourceCount: number;
+    /** Whether the GPU byte fields are measured, only graph-declared, or unknown. */
+    readonly gpuEvidence: CloudGpuResourceEvidence;
+    /** Descriptor-derived allocation sizes, independent from physical residency. */
+    readonly declaredShadowBytes: number;
+    readonly declaredHistoryBytes: number;
+    readonly declaredResidentBytes: number;
+    readonly declaredResourceCount: number;
+    /** Measured GPU resource count, kept separate from logical declarations. */
+    readonly measuredGpuResourceCount: number;
+    readonly cacheResolution: number;
+    readonly shadowResolution: number;
+}
+export interface CloudLayerResourceInputs {
+    readonly generation: number;
+    readonly cache?: CloudDensityCache;
+    readonly shadow?: CloudShadowProjection;
+    readonly history?: CloudHistory;
+    /** Bytes reported by the prepared GPU owner; absent means unavailable. */
+    readonly shadowBytes?: number;
+    readonly historyBytes?: number;
+    readonly inFlightBytes?: number;
+}
+/** Derive one inspection receipt from the resources owned by the current generation. */
+export declare function inspectCloudLayerResources(input: CloudLayerResourceInputs): CloudLayerResourceFacts;
+export interface CloudLayerGeneration {
+    readonly generation: number;
+    readonly sourceKey: string;
+    readonly resourceFacts: CloudLayerResourceFacts;
+    readonly status: 'candidate' | 'active' | 'lkg' | 'retiring';
+}
+/** Candidate -> active transition used by the renderer's existing graph owner. */
+export declare function acceptCloudLayerGeneration(candidate: CloudLayerGeneration, previous: CloudLayerGeneration | undefined): {
+    readonly active: CloudLayerGeneration;
+    readonly lkg: CloudLayerGeneration | undefined;
+};
+/** A failed candidate never replaces the LKG; retirement is fence-owned by Render. */
+export declare function retainCloudLayerAfterFailure(active: CloudLayerGeneration | undefined, candidate: CloudLayerGeneration): {
+    readonly active: CloudLayerGeneration | undefined;
+    readonly retiring: CloudLayerGeneration;
+};
+//# sourceMappingURL=resources.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/cloud/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,+DAA+D;AAC/D,MAAM,MAAM,wBAAwB,GAAG,aAAa,GAAG,UAAU,GAAG,UAAU,CAAC;AAE/E,+DAA+D;AAC/D,eAAO,MAAM,iCAAiC,IAAI,CAAC;AACnD,uEAAuE;AACvE,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,iFAAiF;IACjF,QAAQ,CAAC,WAAW,EAAE,wBAAwB,CAAC;IAC/C,gFAAgF;IAChF,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,4EAA4E;IAC5E,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,wFAAwF;AACxF,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,wBAAwB,GAC9B,uBAAuB,CA0CzB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,uBAAuB,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,KAAK,GAAG,UAAU,CAAC;CAC9D;AAED,kFAAkF;AAClF,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,oBAAoB,EAC/B,QAAQ,EAAE,oBAAoB,GAAG,SAAS,GACzC;IAAE,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,oBAAoB,GAAG,SAAS,CAAA;CAAE,CAM3F;AAED,sFAAsF;AACtF,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,oBAAoB,GAAG,SAAS,EACxC,SAAS,EAAE,oBAAoB,GAC9B;IAAE,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAA;CAAE,CAKhG"}

package/dist/cloud/shadow.d.ts

@@ -0,0 +1,42 @@
+import type { CloudDensityCache } from './density';
+import type { ValidatedCloudLayer } from './parameters';
+export interface CloudShadowProjection {
+    readonly revision: number;
+    readonly resolution: number;
+    readonly range: number;
+    readonly texelSize: number;
+    readonly center: readonly [number, number, number];
+    readonly origin: readonly [number, number, number];
+    readonly right: readonly [number, number, number];
+    readonly up: readonly [number, number, number];
+    readonly sunDirection: readonly [number, number, number];
+    readonly lowSun: boolean;
+}
+export interface CloudShadowSample {
+    readonly transmittance: number;
+    readonly uv: readonly [number, number] | undefined;
+    readonly valid: boolean;
+    readonly fallback: 'none' | 'low-sun' | 'outside-range' | 'empty-coverage';
+    readonly revision: number;
+}
+/**
+ * Build a camera-independent light-space projection. The center is a world
+ * anchor chosen by Render (usually the active scene bounds), and is snapped to
+ * one texel so camera motion cannot crawl the cloud shadow.
+ */
+export declare function createCloudShadowProjection(input: {
+    readonly center: readonly [number, number, number];
+    readonly sunDirection: readonly [number, number, number];
+    readonly range: number;
+    readonly resolution?: number;
+}): CloudShadowProjection;
+export declare function projectCloudShadowUv(projection: CloudShadowProjection, position: readonly [number, number, number]): {
+    readonly uv: readonly [number, number];
+    readonly inRange: boolean;
+};
+/** Evaluate the stable world-space shadow term used by surface and volume sun paths. */
+export declare function sampleCloudShadow(params: ValidatedCloudLayer, projection: CloudShadowProjection, worldPosition: readonly [number, number, number], options?: {
+    readonly cache?: CloudDensityCache;
+    readonly timeSeconds?: number;
+}): CloudShadowSample;
+//# sourceMappingURL=shadow.d.ts.map

package/dist/cloud/shadow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow.d.ts","sourceRoot":"","sources":["../../src/cloud/shadow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACzD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,eAAe,GAAG,gBAAgB,CAAC;IAC3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAqCD;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,GAAG,qBAAqB,CA+BxB;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,qBAAqB,EACjC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC1C;IAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAUvE;AAED,wFAAwF;AACxF,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,mBAAmB,EAC3B,UAAU,EAAE,qBAAqB,EACjC,aAAa,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAChD,OAAO,GAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GAClF,iBAAiB,CA0CnB"}

package/dist/cloud/temporal.d.ts

@@ -0,0 +1,74 @@
+import type { CloudQuality } from '../components/cloud-layer';
+export type CloudTemporalResetReason = 'authoring-generation' | 'camera-cut' | 'resize' | 'recovery' | 'time-discontinuity' | 'cloud-shadow-revision' | 'device-generation' | 'history-missing' | 'reprojection-outside' | 'scene-depth-disocclusion';
+export interface CloudTemporalSignature {
+    readonly sourceKey: string;
+    readonly viewId: string;
+    readonly authoringGeneration: number;
+    readonly cloudShadowRevision: number;
+    readonly cameraRevision: number;
+    readonly deviceGeneration: number;
+    readonly width: number;
+    readonly height: number;
+    readonly timeSeconds: number;
+    readonly quality: CloudQuality;
+    /** Scene-depth producer revision used to reject disoccluded history. */
+    readonly sceneDepthVersion?: number;
+}
+export interface CloudHistory {
+    readonly width: number;
+    readonly height: number;
+    readonly signature: string;
+    readonly temporal: CloudTemporalSignature;
+    readonly generation: number;
+    readonly valid: boolean;
+}
+export interface CloudTemporalDecision {
+    readonly reset: boolean;
+    readonly reasons: readonly CloudTemporalResetReason[];
+    readonly signature: string;
+    readonly history: CloudHistory | undefined;
+}
+export interface CloudTemporalFrame {
+    readonly signature: CloudTemporalSignature;
+    readonly history: CloudHistory | undefined;
+    readonly reset: boolean;
+    readonly reasons: readonly CloudTemporalResetReason[];
+}
+export interface CloudHistoryReprojectionInput {
+    readonly currentDepth: number;
+    readonly historyDepth: number;
+    readonly motion: readonly [number, number];
+    readonly currentPixel: readonly [number, number];
+    readonly historySize: readonly [number, number];
+    readonly depthTolerance?: number;
+}
+export interface CloudHistoryReprojection {
+    readonly accepted: boolean;
+    readonly historyUv: readonly [number, number];
+    readonly weight: number;
+    readonly reason: 'accepted' | 'outside' | 'depth-disocclusion';
+}
+export declare function cloudTemporalSignature(input: CloudTemporalSignature): string;
+/** Compare the facts that make a cloud history safe to reuse. */
+export declare function cloudTemporalResetReasons(previous: CloudTemporalSignature | undefined, next: CloudTemporalSignature, options?: {
+    readonly cameraCut?: boolean;
+    readonly recovery?: boolean;
+}): readonly CloudTemporalResetReason[];
+export declare function createCloudHistory(signature: CloudTemporalSignature, generation: number, valid?: boolean): CloudHistory;
+/** Per-view histories are keyed by the renderer's view identity. */
+export declare class CloudHistoryStore {
+    private readonly maxViews;
+    private readonly entries;
+    constructor(maxViews?: number);
+    begin(signature: CloudTemporalSignature, options?: {
+        readonly cameraCut?: boolean;
+        readonly recovery?: boolean;
+    }): CloudTemporalDecision;
+    commit(signature: CloudTemporalSignature, history: CloudHistory): void;
+    reset(viewId?: string): void;
+    get(viewId: string): CloudHistory | undefined;
+    dispose(): void;
+}
+/** Project one current pixel into the previous cloud history. */
+export declare function reprojectCloudHistory(input: CloudHistoryReprojectionInput, historyWeight?: number): CloudHistoryReprojection;
+//# sourceMappingURL=temporal.d.ts.map

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

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

package/dist/components/barrel-distortion.d.ts

@@ -0,0 +1,13 @@
+import { type SchemaOf, type ShapeOf } from '@forgeax/engine-ecs';
+import { type Result } from '@forgeax/engine-types';
+import { BarrelDistortionInvalidParameterError } from '../errors/render';
+/** Camera companion that applies the bounded first-order barrel model. */
+export declare const BarrelDistortion: import("@forgeax/engine-ecs").Component<"BarrelDistortion", {
+    readonly strength: "f32";
+    readonly centerX: "f32";
+    readonly centerY: "f32";
+}>;
+export type BarrelDistortionData = ShapeOf<SchemaOf<typeof BarrelDistortion>>;
+/** Validate and detach camera-owned barrel authoring data. */
+export declare function validateBarrelDistortionParameters(input: Partial<BarrelDistortionData> | undefined): Result<BarrelDistortionData, BarrelDistortionInvalidParameterError>;
+//# sourceMappingURL=barrel-distortion.d.ts.map

package/dist/components/barrel-distortion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"barrel-distortion.d.ts","sourceRoot":"","sources":["../../src/components/barrel-distortion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,qCAAqC,EAAE,MAAM,kBAAkB,CAAC;AAEzE,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB;;;;EAI3B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC;AAgB9E,8DAA8D;AAC9D,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,SAAS,GAC/C,MAAM,CAAC,oBAAoB,EAAE,qCAAqC,CAAC,CAerE"}

package/dist/components/cloud-layer.d.ts

@@ -0,0 +1,29 @@
+import { type SchemaOf, type ShapeOf } from '@forgeax/engine-ecs';
+/** Closed quality lane for the renderer-owned procedural cloud producer. */
+export type CloudQuality = 'low' | 'medium' | 'high';
+export declare const CloudQualityValue: Readonly<{
+    readonly low: 0;
+    readonly medium: 1;
+    readonly high: 2;
+}>;
+/**
+ * A single World-authored cloud layer.
+ *
+ * The component contains only source facts. Cache resolution, optical step
+ * counts, temporal history and GPU handles are derived by Render and never
+ * written back into ECS.
+ */
+export declare const CloudLayer: import("@forgeax/engine-ecs").Component<"CloudLayer", {
+    readonly seed: "u32";
+    readonly baseHeight: "f32";
+    readonly thickness: "f32";
+    readonly scale: "f32";
+    readonly coverage: "f32";
+    readonly density: "f32";
+    readonly wind: "array<f32, 3>";
+    readonly quality: "f32";
+    readonly shadowRange: "f32";
+}>;
+export type CloudLayerData = ShapeOf<SchemaOf<typeof CloudLayer>>;
+export declare function cloudQualityFromF32(value: number): CloudQuality | undefined;
+//# sourceMappingURL=cloud-layer.d.ts.map

package/dist/components/cloud-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-layer.d.ts","sourceRoot":"","sources":["../../src/components/cloud-layer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnF,4EAA4E;AAC5E,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErD,eAAO,MAAM,iBAAiB;;;;EAInB,CAAC;AAEZ;;;;;;GAMG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;EAmBrB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC;AAElE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAK3E"}

package/dist/components/index.d.ts

@@ -1,5 +1,7 @@
 export * from './atmosphere';
+export * from './barrel-distortion';
 export * from './camera';
+export * from './cloud-layer';
 export * from './cube-camera';
 export * from './depth-of-field';
 export * from './directional-light';

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,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,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"}

package/dist/components/instances.d.ts

@@ -1,9 +1,23 @@
-import type { InstanceCollectionData } from '../instances';
-/** Per-entity association with a renderer-owned instance collection. */
+/**
+ * World-owned local transforms for one explicit instanced renderable.
+ * Packed column-major mat4 values compose as entityWorld * instanceLocal.
+ * ECS owns copying, mutation and entity lifetime, including large arrays.
+ * Renderer extraction derives its own snapshot and GPU residency; neither
+ * authoring nor glTF SceneAsset lowering requires a Renderer identity.
+ *
+ * @example
+ * const transforms = new Float32Array(20_000 * 16);
+ * for (let i = 0; i < 20_000; i++) {
+ *   transforms[i * 16] = transforms[i * 16 + 5] =
+ *     transforms[i * 16 + 10] = transforms[i * 16 + 15] = 1;
+ * }
+ * const entity = world.spawn({ component: Instances, data: { transforms } }).unwrap();
+ * world.set(entity, Instances, { transforms }).unwrap();
+ */
 export declare const Instances: import("@forgeax/engine-ecs").Component<"Instances", {
-    readonly collectionId: "u32";
+    readonly transforms: "array<f32>";
 }>;
-/** Type-level hint for the `data` object at the Instances spawn site. */
-export type InstancesData = InstanceCollectionData;
-export type { InstanceCollectionId } from '../instances';
+export type InstancesData = {
+    readonly transforms: Float32Array;
+};
 //# sourceMappingURL=instances.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../src/components/instances.ts"],"names":[],"mappings":"AAuCA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE3D,wEAAwE;AACxE,eAAO,MAAM,SAAS;;EAEpB,CAAC;AAEH,yEAAyE;AACzE,MAAM,MAAM,aAAa,GAAG,sBAAsB,CAAC;AAEnD,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../src/components/instances.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,SAAS;;EAEpB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAA;CAAE,CAAC"}

package/dist/construct-renderer.d.ts

@@ -5,7 +5,7 @@ import type { RendererHostImplementation, RendererLegacyHostAdapter } from './as
 import { type RenderError } from './errors/render';
 import type { Renderer, RendererOptions, RenderResult } from './render-contract';
 export type { EngineEnvironmentErrorDetail, RhiBackendInstrumentation, RhiBackendPack, } from './assembly/backend-contract';
-export { EngineEnvironmentError } from './assembly/backend-contract';
+export { EngineEnvironmentError, loadRhiPack } from './assembly/backend-contract';
 export type { RendererLegacyHostAdapter } from './assembly/host-contract';
 export type { BundlerOptions };
 export type RendererFeatureAssemblyHost = Pick<RendererLegacyHostAdapter, 'installRenderFeature' | 'uninstallRenderFeature'>;

package/dist/construct-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"construct-renderer.d.ts","sourceRoot":"","sources":["../src/construct-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,KAAK,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EACV,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,KAAK,WAAW,EAAgC,MAAM,iBAAiB,CAAC;AACjF,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjF,YAAY,EACV,4BAA4B,EAC5B,yBAAyB,EACzB,cAAc,GACf,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,YAAY,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAC1E,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAC5C,yBAAyB,EACzB,sBAAsB,GAAG,wBAAwB,CAClD,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,0BAA0B,CAAC;IACnD,QAAQ,CAAC,WAAW,EAAE,2BAA2B,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AAoCD,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,eAAe,EACzB,OAAO,CAAC,EAAE,cAAc,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,CAAC,oBAAoB,EAAE,WAAW,GAAG,sBAAsB,CAAC,CAAC,CAgCnF"}
+{"version":3,"file":"construct-renderer.d.ts","sourceRoot":"","sources":["../src/construct-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,KAAK,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EACV,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,KAAK,WAAW,EAAgC,MAAM,iBAAiB,CAAC;AACjF,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjF,YAAY,EACV,4BAA4B,EAC5B,yBAAyB,EACzB,cAAc,GACf,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAClF,YAAY,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAC1E,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAC5C,yBAAyB,EACzB,sBAAsB,GAAG,wBAAwB,CAClD,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,0BAA0B,CAAC;IACnD,QAAQ,CAAC,WAAW,EAAE,2BAA2B,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AAoCD,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,eAAe,EACzB,OAAO,CAAC,EAAE,cAAc,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,CAAC,oBAAoB,EAAE,WAAW,GAAG,sBAAsB,CAAC,CAAC,CAgCnF"}