@forgeax/engine-render 0.1.2

package/dist/dynamic-texture-store.d.ts

@@ -0,0 +1,42 @@
+import type { Result, RhiError, Texture, TextureView } from '@forgeax/engine-rhi';
+import type { Handle } from '@forgeax/engine-types';
+export type CopyExternalImageSource = GPUCopyExternalImageSourceInfo['source'];
+declare const VIDEO_TEXTURE_FORMAT: "rgba8unorm-srgb";
+export interface DynamicTextureDevice {
+    createTexture(desc: {
+        readonly size: {
+            readonly width: number;
+            readonly height: number;
+            readonly depthOrArrayLayers: number;
+        };
+        readonly format: typeof VIDEO_TEXTURE_FORMAT;
+        readonly usage: number;
+        readonly label?: string;
+    }): Result<Texture, RhiError>;
+    createTextureView(texture: Texture, desc: Record<string, never>): Result<TextureView, RhiError>;
+    destroyTexture(texture: Texture): Result<void, RhiError>;
+    readonly queue: {
+        copyExternalImageToTexture(source: {
+            readonly source: CopyExternalImageSource;
+            readonly flipY?: boolean;
+        }, destination: {
+            readonly texture: Texture;
+        }, copySize: {
+            readonly width: number;
+            readonly height: number;
+            readonly depthOrArrayLayers: number;
+        }): Result<void, RhiError>;
+    };
+}
+/** Renderer-owned transient GPU texture cache for host-provided video frames. */
+export declare class DynamicTextureStore {
+    private device;
+    private readonly entries;
+    configureGpuDevice(device: DynamicTextureDevice): void;
+    uploadFrame(clip: Handle<'VideoAsset', 'shared'>, source: CopyExternalImageSource, width: number, height: number): Result<TextureView, RhiError> | undefined;
+    getView(clip: Handle<'VideoAsset', 'shared'>): TextureView | undefined;
+    destroyAll(): void;
+    private ensureEntry;
+}
+export {};
+//# sourceMappingURL=dynamic-texture-store.d.ts.map

package/dist/dynamic-texture-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-texture-store.d.ts","sourceRoot":"","sources":["../src/dynamic-texture-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGpD,MAAM,MAAM,uBAAuB,GAAG,8BAA8B,CAAC,QAAQ,CAAC,CAAC;AAG/E,QAAA,MAAM,oBAAoB,EAAG,iBAA0B,CAAC;AAExD,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,IAAI,EAAE;QAClB,QAAQ,CAAC,IAAI,EAAE;YACb,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;YACxB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;SACrC,CAAC;QACF,QAAQ,CAAC,MAAM,EAAE,OAAO,oBAAoB,CAAC;QAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC9B,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAChG,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACzD,QAAQ,CAAC,KAAK,EAAE;QACd,0BAA0B,CACxB,MAAM,EAAE;YAAE,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;YAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,EAC9E,WAAW,EAAE;YAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;SAAE,EAC1C,QAAQ,EAAE;YACR,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;YACxB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;SACrC,GACA,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;KAC3B,CAAC;CACH;AASD,iFAAiF;AACjF,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAA+C;IAC7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAE7D,kBAAkB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAKtD,WAAW,CACT,IAAI,EAAE,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,EACpC,MAAM,EAAE,uBAAuB,EAC/B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG,SAAS;IAc5C,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG,WAAW,GAAG,SAAS;IAItE,UAAU,IAAI,IAAI;IAMlB,OAAO,CAAC,WAAW;CA4BpB"}

package/dist/engine-metrics.d.ts

@@ -0,0 +1,23 @@
+import type { EngineMetrics } from '@forgeax/engine-types';
+export type { EngineMetrics };
+/**
+ * Default `EngineMetrics` implementation — a thin `Map<string, number>` with
+ * the three-method surface bolted on. The map is private; readers consume
+ * the snapshot accessor.
+ *
+ * @internal — instances are constructed by `createRenderer` and surfaced
+ * through `Renderer.metrics`; AI users do not import this class directly.
+ */
+export declare class EngineMetricsImpl implements EngineMetrics {
+    private readonly counters;
+    increment(name: string): void;
+    snapshot(): Readonly<Record<string, number>>;
+    reset(): void;
+}
+/**
+ * Fresh `EngineMetrics` factory; the only construction path used by
+ * `createRenderer`. Keeping the constructor private (via the factory) leaves
+ * room to swap the backing store without touching call sites.
+ */
+export declare function createEngineMetrics(): EngineMetrics;
+//# sourceMappingURL=engine-metrics.d.ts.map

package/dist/engine-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-metrics.d.ts","sourceRoot":"","sources":["../src/engine-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAmD3D,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B;;;;;;;GAOG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IAEtD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI7B,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAQ5C,KAAK,IAAI,IAAI;CAGd;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD"}

package/dist/environment/__tests__/failure-injection.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=failure-injection.test.d.ts.map

package/dist/environment/__tests__/failure-injection.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-injection.test.d.ts","sourceRoot":"","sources":["../../../src/environment/__tests__/failure-injection.test.ts"],"names":[],"mappings":""}

package/dist/environment/__tests__/generation-red.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=generation-red.test.d.ts.map

package/dist/environment/__tests__/generation-red.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation-red.test.d.ts","sourceRoot":"","sources":["../../../src/environment/__tests__/generation-red.test.ts"],"names":[],"mappings":""}

package/dist/environment/__tests__/generation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=generation.test.d.ts.map

package/dist/environment/__tests__/generation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation.test.d.ts","sourceRoot":"","sources":["../../../src/environment/__tests__/generation.test.ts"],"names":[],"mappings":""}

package/dist/environment/__tests__/graph-transaction.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=graph-transaction.test.d.ts.map

package/dist/environment/__tests__/graph-transaction.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-transaction.test.d.ts","sourceRoot":"","sources":["../../../src/environment/__tests__/graph-transaction.test.ts"],"names":[],"mappings":""}

package/dist/environment/__tests__/inspection-red.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inspection-red.test.d.ts.map

package/dist/environment/__tests__/inspection-red.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspection-red.test.d.ts","sourceRoot":"","sources":["../../../src/environment/__tests__/inspection-red.test.ts"],"names":[],"mappings":""}

package/dist/environment/__tests__/lifecycle-evidence.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lifecycle-evidence.test.d.ts.map

package/dist/environment/__tests__/lifecycle-evidence.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-evidence.test.d.ts","sourceRoot":"","sources":["../../../src/environment/__tests__/lifecycle-evidence.test.ts"],"names":[],"mappings":""}

package/dist/environment/__tests__/pipeline-topology.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pipeline-topology.test.d.ts.map

package/dist/environment/__tests__/pipeline-topology.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-topology.test.d.ts","sourceRoot":"","sources":["../../../src/environment/__tests__/pipeline-topology.test.ts"],"names":[],"mappings":""}

package/dist/environment/__tests__/readiness.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=readiness.test.d.ts.map

package/dist/environment/__tests__/readiness.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.test.d.ts","sourceRoot":"","sources":["../../../src/environment/__tests__/readiness.test.ts"],"names":[],"mappings":""}

package/dist/environment/__tests__/recovery.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=recovery.test.d.ts.map

package/dist/environment/__tests__/recovery.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.test.d.ts","sourceRoot":"","sources":["../../../src/environment/__tests__/recovery.test.ts"],"names":[],"mappings":""}

package/dist/environment/__tests__/resize-dispose.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=resize-dispose.test.d.ts.map

package/dist/environment/__tests__/resize-dispose.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resize-dispose.test.d.ts","sourceRoot":"","sources":["../../../src/environment/__tests__/resize-dispose.test.ts"],"names":[],"mappings":""}

package/dist/environment/__tests__/signature-red.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=signature-red.test.d.ts.map

package/dist/environment/__tests__/signature-red.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature-red.test.d.ts","sourceRoot":"","sources":["../../../src/environment/__tests__/signature-red.test.ts"],"names":[],"mappings":""}

package/dist/environment/__tests__/signature.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=signature.test.d.ts.map

package/dist/environment/__tests__/signature.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.test.d.ts","sourceRoot":"","sources":["../../../src/environment/__tests__/signature.test.ts"],"names":[],"mappings":""}

package/dist/environment/descriptors.d.ts

@@ -0,0 +1,2 @@
+export { deriveEnvironmentBundleDescriptors, type EnvironmentBundleDescriptors, type EnvironmentCubeDescriptor, type EnvironmentCubeFace, environmentBundleBytes, } from './signature.js';
+//# sourceMappingURL=descriptors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"descriptors.d.ts","sourceRoot":"","sources":["../../src/environment/descriptors.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,EAClC,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC"}

package/dist/environment/extracted-environment.d.ts

@@ -0,0 +1,53 @@
+import type { EntityHandle, World } from '@forgeax/engine-ecs';
+import { type Vec3 } from '@forgeax/engine-math';
+import type { Result } from '@forgeax/engine-types';
+import { type RenderError } from '../errors/render';
+import type { DirectionalLightSnapshot, SkyboxSnapshot, SkylightSnapshot } from '../render-system-extract';
+export interface AtmosphereSnapshot {
+    readonly entity: number;
+    readonly worldId: number;
+    readonly turbidity: number;
+    readonly rayleigh: number;
+    readonly mieCoefficient: number;
+    readonly mieDirectionalG: number;
+    readonly sunAngularRadius: number;
+    readonly sun: {
+        readonly entity: number;
+        readonly direction: Vec3;
+        readonly color: Vec3;
+        readonly illuminance: number;
+    };
+}
+export type ExtractedEnvironment = {
+    readonly kind: 'none';
+    readonly worldId: number;
+    readonly skylight?: SkylightSnapshot | undefined;
+    readonly skylightCount: number;
+    readonly skyboxCount: number;
+} | {
+    readonly kind: 'image';
+    readonly worldId: number;
+    readonly skylight?: SkylightSnapshot | undefined;
+    readonly skybox?: SkyboxSnapshot | undefined;
+    readonly sourceEntity: number;
+    readonly skylightCount: number;
+    readonly skyboxCount: number;
+} | {
+    readonly kind: 'atmosphere';
+    readonly worldId: number;
+    readonly atmosphere: AtmosphereSnapshot;
+    readonly skylightCount: number;
+    readonly skyboxCount: number;
+};
+export interface EnvironmentSelectionInput {
+    readonly resourceOwner: World;
+    readonly worldId?: number;
+    readonly skylight?: SkylightSnapshot | undefined;
+    readonly skylightCount?: number | undefined;
+    readonly skybox?: SkyboxSnapshot | undefined;
+    readonly skyboxCount?: number | undefined;
+}
+export declare function selectEnvironmentSource(input: EnvironmentSelectionInput): Result<ExtractedEnvironment, RenderError>;
+export declare function atmosphereSunSnapshot(environment: ExtractedEnvironment): DirectionalLightSnapshot | undefined;
+export type EnvironmentEntity = EntityHandle;
+//# sourceMappingURL=extracted-environment.d.ts.map

package/dist/environment/extracted-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extracted-environment.d.ts","sourceRoot":"","sources":["../../src/environment/extracted-environment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,KAAK,IAAI,EAAQ,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAIpD,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,wBAAwB,EACxB,cAAc,EACd,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE;QACZ,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;QACzB,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;QACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;KAC9B,CAAC;CACH;AAED,MAAM,MAAM,oBAAoB,GAC5B;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEN,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAkGD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,yBAAyB,GAC/B,MAAM,CAAC,oBAAoB,EAAE,WAAW,CAAC,CA0D3C;AAED,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,oBAAoB,GAChC,wBAAwB,GAAG,SAAS,CAQtC;AAED,MAAM,MAAM,iBAAiB,GAAG,YAAY,CAAC"}

package/dist/environment/generation.d.ts

@@ -0,0 +1,62 @@
+import type { EnvironmentSunConsumerSnapshot } from '../record/frame-lighting';
+import type { EnvironmentGpuBundle } from './gpu-bundle';
+import type { EnvironmentSignature } from './signature';
+export type EnvironmentGenerationStatus = 'idle' | 'building' | 'ready' | 'failed' | 'disposed';
+export interface EnvironmentGenerationInput {
+    readonly signature: EnvironmentSignature | string;
+    readonly bytes: number;
+}
+export interface EnvironmentBundleRecord {
+    readonly generation: number;
+    readonly deviceGeneration: string | number;
+    readonly signature: EnvironmentSignature | string;
+    readonly bytes: number;
+    /** Physical bundle in production; string-shaped handles remain for pure state tests. */
+    readonly handle: EnvironmentGpuBundle | string | {
+        readonly handle: string;
+    };
+    /** Immutable direct/CSM/atmosphere facts committed with this GPU bundle. */
+    readonly consumerSnapshot?: EnvironmentSunConsumerSnapshot | undefined;
+}
+export interface EnvironmentRetiredRecord {
+    readonly record: EnvironmentBundleRecord;
+    readonly queueCompletion: string | number | undefined;
+    retired: boolean;
+    destroyed: boolean;
+}
+export interface EnvironmentGenerationState {
+    deviceGeneration: string | number;
+    readonly retired: EnvironmentRetiredRecord[];
+    status: EnvironmentGenerationStatus;
+    generation: number;
+    desired: Readonly<EnvironmentGenerationInput> | undefined;
+    candidate: EnvironmentGenerationRecord | undefined;
+    active: EnvironmentBundleRecord | undefined;
+    lastKnownGood: EnvironmentBundleRecord | undefined;
+    failureStage: 'readiness' | 'build' | 'execute' | 'finish' | 'submit' | 'device-lost' | undefined;
+    /** Renderer-owned lifecycle facts used by the bounded inspection projection. */
+    bytes: number;
+    peakBytes: number;
+    rebuildCost: number;
+    publishCount: number;
+}
+export interface EnvironmentGenerationRecord extends EnvironmentBundleRecord {
+}
+export interface EnvironmentGenerationAttempt {
+    readonly generation: number;
+    readonly desired: Readonly<EnvironmentGenerationInput>;
+    complete(handle: EnvironmentGpuBundle | string | {
+        readonly handle: string;
+    }, consumerSnapshot?: EnvironmentSunConsumerSnapshot): EnvironmentGenerationRecord;
+    fail(stage: 'readiness' | 'build' | 'execute' | 'finish' | 'submit'): void;
+}
+export declare function createEnvironmentGenerationState(deviceGeneration: string | number): EnvironmentGenerationState;
+export declare function beginEnvironmentGeneration(state: EnvironmentGenerationState, input: EnvironmentGenerationInput): EnvironmentGenerationAttempt;
+/**
+ * One consumer projection for every environment user in the current frame.
+ * Candidate wins only while the candidate frame is being encoded; aborting
+ * removes it and therefore restores the active/LKG snapshot everywhere.
+ */
+export declare function environmentConsumerSnapshot(state: Pick<EnvironmentGenerationState, 'candidate' | 'active'>): EnvironmentSunConsumerSnapshot | undefined;
+export declare function publishEnvironmentGeneration(state: EnvironmentGenerationState, candidate: EnvironmentGenerationRecord, queueCompletion?: string | number): void;
+//# sourceMappingURL=generation.d.ts.map

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

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

package/dist/environment/gpu-bundle.d.ts

@@ -0,0 +1,23 @@
+import { type RhiDevice, RhiError, type Texture, type TextureView } from '@forgeax/engine-rhi';
+import { type Result } from '@forgeax/engine-types';
+import type { EnvironmentBundleDescriptors } from './signature';
+/** The renderer-owned physical result of one analytic environment generation. */
+export interface EnvironmentGpuBundle {
+    readonly kind: 'analytic-sky-bundle';
+    readonly descriptors: EnvironmentBundleDescriptors;
+    readonly sky: Texture;
+    readonly irradiance: Texture;
+    readonly prefilter: Texture;
+    readonly skyView: TextureView;
+    readonly irradianceView: TextureView;
+    readonly prefilterView: TextureView;
+    readonly destroy: (device: RhiDevice) => Result<void, RhiError>;
+}
+/**
+ * Allocate the three HDR cube resources before graph execution. The graph
+ * imports these exact handles, so a candidate cannot be published as a POD
+ * token while its device resources are missing.
+ */
+export declare function createEnvironmentGpuBundle(device: RhiDevice, descriptors: EnvironmentBundleDescriptors): Result<EnvironmentGpuBundle, RhiError>;
+export declare function isEnvironmentGpuBundle(value: unknown): value is EnvironmentGpuBundle;
+//# sourceMappingURL=gpu-bundle.d.ts.map

package/dist/environment/gpu-bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpu-bundle.d.ts","sourceRoot":"","sources":["../../src/environment/gpu-bundle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,QAAQ,EAAE,KAAK,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAM7D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAEhE,iFAAiF;AACjF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,4BAA4B,CAAC;IACnD,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;CACjE;AAUD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,4BAA4B,GACxC,MAAM,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAiGxC;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAMpF"}

package/dist/environment/graph.d.ts

@@ -0,0 +1,108 @@
+import type { GraphTexture, GraphTextureView, RenderGraphBuilder, RenderGraphError, RenderGraphFrame, Result } from '@forgeax/engine-render-graph';
+import type { Texture } from '@forgeax/engine-rhi';
+import type { RenderPipelineFrame } from '../render-pipeline';
+import type { EnvironmentBundleDescriptors, EnvironmentCubeDescriptor } from './signature';
+export declare const ATMOSPHERE_PRODUCER_PASS_COUNT = 42;
+export declare const ATMOSPHERE_PARAMS_BYTES = 64;
+export declare const ATMOSPHERE_PARAMS_SLOT_BYTES = 256;
+export declare const ATMOSPHERE_BACKGROUND_PARAMS_SLOT = 0;
+/** The Sun disc has a distinct immutable consumer slot. */
+export declare const ATMOSPHERE_SUN_DISC_PARAMS_SLOT = 43;
+/** One consumer slot per composition draw plus one immutable slot per producer face. */
+export declare const ATMOSPHERE_PARAMS_SLOT_COUNT = 44;
+export declare const ATMOSPHERE_PRODUCER_KINDS: readonly ["sky", "irradiance", "prefilter"];
+export type AtmosphereProducerKind = (typeof ATMOSPHERE_PRODUCER_KINDS)[number];
+export interface EnvironmentProducerPass {
+    readonly name: string;
+    readonly kind: AtmosphereProducerKind;
+    readonly face: 0 | 1 | 2 | 3 | 4 | 5;
+    readonly mipLevel: number;
+    readonly executeIf: (frame: {
+        readonly environmentDirty: boolean;
+    }) => boolean;
+}
+export interface EnvironmentImportedResource {
+    readonly kind: AtmosphereProducerKind;
+    readonly descriptor: EnvironmentCubeDescriptor;
+    readonly generation: number;
+}
+export interface EnvironmentProducerGraph {
+    readonly importedResources: readonly EnvironmentImportedResource[];
+    readonly passes: readonly EnvironmentProducerPass[];
+    readonly dirtyPassCount: number;
+}
+export interface EnvironmentGraphTargets {
+    readonly sky: readonly {
+        readonly view: GraphTextureView;
+    }[];
+    /** Whole-cube view consumed by the background and material IBL bindings. */
+    readonly skyCube?: GraphTextureView;
+    readonly irradiance: readonly {
+        readonly view: GraphTextureView;
+    }[];
+    readonly prefilter: readonly {
+        readonly view: GraphTextureView;
+    }[];
+}
+export declare function environmentGenerationDirty<FrameCtx extends RenderPipelineFrame>(frame: FrameCtx): boolean;
+export declare function environmentGenerationEnabled<FrameCtx extends RenderPipelineFrame>(frame: FrameCtx): boolean;
+/** Add the common 42-face producer topology to either built-in pipeline. */
+export declare function addEnvironmentProducerPasses<FrameCtx extends RenderPipelineFrame>(graph: RenderGraphBuilder<FrameCtx>, target: {
+    readonly view: GraphTextureView;
+}, prefix: 'urp' | 'hdrp', executeIf: (frame: FrameCtx) => boolean, environmentTargets?: EnvironmentGraphTargets): Result<number, RenderGraphError>;
+export declare function addEnvironmentCompositionPass(graph: RenderGraphBuilder<RenderPipelineFrame>, target: {
+    readonly view: GraphTextureView;
+}, name: 'urp.environment-background' | 'urp.sun-disc' | 'hdrp.environment-background-depth-aware' | 'hdrp.sun-disc', executeIf: (frame: RenderPipelineFrame) => boolean, options: {
+    readonly clear?: boolean | undefined;
+    readonly sampled?: GraphTextureView | undefined;
+    readonly sunDisc?: boolean | undefined;
+    /** Depth authority is attached read-only; it is not a shader resource. */
+    readonly depth: GraphTextureView;
+}): Result<void, RenderGraphError>;
+/** Stable, HDR clear used when the analytic consumer has no scene geometry. */
+export declare function environmentClearColor(frame: RenderPipelineFrame): GPUColor;
+export declare function createEnvironmentProducerGraph(input: {
+    readonly descriptors: EnvironmentBundleDescriptors;
+    readonly generation: number;
+    readonly dirty: boolean;
+}): EnvironmentProducerGraph;
+/**
+ * Import the candidate bundle on the same graph builder as scene work. The
+ * resolver is intentionally frame-scoped: a replaced generation cannot leak
+ * a handle from a previous device or frame into the graph.
+ */
+export declare function importEnvironmentResources<FrameCtx extends RenderGraphFrame>(builder: RenderGraphBuilder<FrameCtx>, input: {
+    readonly descriptors: EnvironmentBundleDescriptors;
+    readonly generation: number;
+    readonly resolve: (kind: AtmosphereProducerKind, frame: FrameCtx) => Texture;
+}): Result<Readonly<Record<AtmosphereProducerKind, GraphTexture>>, RenderGraphError>;
+/** Import every face/mip view so producer passes write physical candidates. */
+export declare function importEnvironmentGraphTargets<FrameCtx extends RenderGraphFrame>(builder: RenderGraphBuilder<FrameCtx>, input: {
+    readonly descriptors: EnvironmentBundleDescriptors;
+    readonly generation: number;
+    readonly resolve: (kind: AtmosphereProducerKind, frame: FrameCtx) => Texture;
+}): Result<EnvironmentGraphTargets, RenderGraphError>;
+export type EnvironmentTransactionStage = 'execute' | 'finish' | 'submit';
+export interface EnvironmentTransactionAttempt {
+    abort(stage: EnvironmentTransactionStage): void;
+    publish(): void;
+}
+export interface EnvironmentTransactionTrace {
+    readonly encoderCount: number;
+    readonly finishCount: number;
+    readonly submitCount: number;
+    readonly executedPassCount: number;
+    readonly abortedStage: EnvironmentTransactionStage | undefined;
+    readonly published: boolean;
+}
+/** One shared encoder/finish/submit transaction for environment and scene. */
+export declare function executeEnvironmentProducerTransaction(input: {
+    readonly graph: EnvironmentProducerGraph;
+    readonly dirty: boolean;
+    readonly environment: EnvironmentTransactionAttempt;
+    readonly temporal: EnvironmentTransactionAttempt;
+    readonly execute: () => boolean;
+    readonly finish: () => boolean;
+    readonly submit: () => boolean;
+}): EnvironmentTransactionTrace;
+//# sourceMappingURL=graph.d.ts.map

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

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

package/dist/environment/inspection.d.ts

@@ -0,0 +1,48 @@
+import type { EnvironmentGenerationState } from './generation';
+export type EnvironmentInspectionState = 'off' | 'building' | 'ready' | 'last-known-good' | 'failed';
+export interface EnvironmentInspectionTaa {
+    readonly activeSignature: string | undefined;
+    readonly publishCount: number;
+    readonly resetCount: number;
+    readonly lastResetReason?: string | undefined;
+}
+export interface EnvironmentInspectionInput {
+    readonly sourceWorldId?: number | undefined;
+    readonly sourceEntity?: number | undefined;
+    readonly taa?: EnvironmentInspectionTaa | undefined;
+    readonly rebuild?: {
+        readonly passCount: number;
+        readonly timeMs: number | undefined;
+    } | undefined;
+}
+/** Bounded renderer POD; GPU handles and mutable caches are intentionally absent. */
+export interface EnvironmentInspection {
+    readonly state: EnvironmentInspectionState;
+    readonly source: {
+        readonly worldId: number | undefined;
+        readonly entity: number | undefined;
+    };
+    readonly desiredSignature: string | undefined;
+    readonly activeSignature: string | undefined;
+    readonly deviceGeneration: string | number;
+    readonly bytes: number;
+    readonly peakBytes: number;
+    readonly rebuildCost: number;
+    readonly rebuild: {
+        readonly passCount: number;
+        readonly timeMs: number | undefined;
+    };
+    readonly failure: {
+        readonly stage: NonNullable<EnvironmentGenerationState['failureStage']>;
+    } | undefined;
+    readonly taa: EnvironmentInspectionTaa;
+}
+export declare function inspectEnvironmentGeneration(source: EnvironmentGenerationState, input?: EnvironmentInspectionInput): EnvironmentInspection;
+export interface FogEnvironmentProjectionInput {
+    readonly activeSignature: string | undefined;
+    readonly sunDirection: readonly [number, number, number];
+    readonly illuminance: number;
+}
+/** Read-only Fog consumer projection. Fog owns no ECS component, pass, or uniform. */
+export declare function projectFogEnvironment(input: FogEnvironmentProjectionInput): Readonly<FogEnvironmentProjectionInput>;
+//# sourceMappingURL=inspection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inspection.d.ts","sourceRoot":"","sources":["../../src/environment/inspection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAE/D,MAAM,MAAM,0BAA0B,GAClC,KAAK,GACL,UAAU,GACV,OAAO,GACP,iBAAiB,GACjB,QAAQ,CAAC;AAEb,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,GAAG,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,OAAO,CAAC,EACb;QACE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;KACrC,GACD,SAAS,CAAC;CACf;AAED,qFAAqF;AACrF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IAC/F,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;KACrC,CAAC;IACF,QAAQ,CAAC,OAAO,EACZ;QAAE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,0BAA0B,CAAC,cAAc,CAAC,CAAC,CAAA;KAAE,GAC3E,SAAS,CAAC;IACd,QAAQ,CAAC,GAAG,EAAE,wBAAwB,CAAC;CACxC;AAaD,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,0BAA0B,EAClC,KAAK,GAAE,0BAA+B,GACrC,qBAAqB,CAuBvB;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACzD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,sFAAsF;AACtF,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,6BAA6B,GACnC,QAAQ,CAAC,6BAA6B,CAAC,CAUzC"}

package/dist/environment/lifecycle.d.ts

@@ -0,0 +1,22 @@
+import type { RhiDevice } from '@forgeax/engine-rhi';
+import type { EnvironmentGenerationState } from './generation';
+export interface EnvironmentLifecycleEvidence {
+    readonly bytes: number;
+    readonly peakBytes: number;
+    readonly retireEvents: number;
+    readonly queueCompletions: number;
+}
+export declare function createEnvironmentLifecycleEvidence(): EnvironmentLifecycleEvidence;
+export declare function noteEnvironmentAllocation(evidence: EnvironmentLifecycleEvidence, bytes: number): EnvironmentLifecycleEvidence;
+export declare function noteEnvironmentRetire(evidence: EnvironmentLifecycleEvidence): EnvironmentLifecycleEvidence;
+export declare function noteEnvironmentQueueCompletion(evidence: EnvironmentLifecycleEvidence): EnvironmentLifecycleEvidence;
+export declare function completeEnvironmentQueue(state: EnvironmentGenerationState, queueCompletion: string | number): void;
+/** Destroy only retired physical bundles after the queue fence is complete. */
+export declare function destroyCompletedEnvironmentGenerations(state: EnvironmentGenerationState, device: RhiDevice, queueCompletion: string | number): void;
+export declare function abandonEnvironmentDevice(state: EnvironmentGenerationState, deviceGeneration: string | number): void;
+/** Re-arm the same Renderer owner against a new device without carrying refs across it. */
+export declare function recoverEnvironmentDevice(state: EnvironmentGenerationState, deviceGeneration: string | number): void;
+/** Resize is a same-device replacement boundary; no old bundle remains visible. */
+export declare function resizeEnvironmentGeneration(state: EnvironmentGenerationState, deviceGeneration?: string | number): void;
+export declare function disposeEnvironmentGeneration(state: EnvironmentGenerationState): void;
+//# sourceMappingURL=lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/environment/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAG/D,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,wBAAgB,kCAAkC,IAAI,4BAA4B,CAEjF;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,4BAA4B,EACtC,KAAK,EAAE,MAAM,GACZ,4BAA4B,CAO9B;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,4BAA4B,GACrC,4BAA4B,CAE9B;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,4BAA4B,GACrC,4BAA4B,CAE9B;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,0BAA0B,EACjC,eAAe,EAAE,MAAM,GAAG,MAAM,GAC/B,IAAI,CAIN;AAED,+EAA+E;AAC/E,wBAAgB,sCAAsC,CACpD,KAAK,EAAE,0BAA0B,EACjC,MAAM,EAAE,SAAS,EACjB,eAAe,EAAE,MAAM,GAAG,MAAM,GAC/B,IAAI,CAWN;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,0BAA0B,EACjC,gBAAgB,EAAE,MAAM,GAAG,MAAM,GAChC,IAAI,CASN;AAED,2FAA2F;AAC3F,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,0BAA0B,EACjC,gBAAgB,EAAE,MAAM,GAAG,MAAM,GAChC,IAAI,CAYN;AAED,mFAAmF;AACnF,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,0BAA0B,EACjC,gBAAgB,GAAE,MAAM,GAAG,MAA+B,GACzD,IAAI,CAYN;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,0BAA0B,GAAG,IAAI,CAOpF"}

package/dist/environment/readiness.d.ts

@@ -0,0 +1,29 @@
+import type { RhiDevice } from '@forgeax/engine-rhi';
+import { type Result } from '@forgeax/engine-types';
+import { AtmosphereCapsInsufficientError, AtmosphereProducerFailedError } from '../errors/render';
+export declare const ATMOSPHERE_CAPABILITY_OPERATIONS: readonly ["renderAttachment", "sample", "filter", "mip", "face"];
+export type AtmosphereCapabilityOperation = (typeof ATMOSPHERE_CAPABILITY_OPERATIONS)[number];
+export type AtmosphereBackendKind = RhiDevice['caps']['backendKind'];
+export type AtmosphereCapabilityStatus = 'pass' | 'partial' | 'unavailable' | 'structural-only';
+export interface AtmosphereMatrixBackend {
+    readonly status: AtmosphereCapabilityStatus;
+    readonly [operation: string]: string | AtmosphereCapabilityStatus | undefined;
+}
+export interface AtmosphereCapabilityMatrix {
+    readonly format: 'rgba16float';
+    readonly backends: Readonly<Record<string, AtmosphereMatrixBackend>>;
+}
+export interface AtmosphereReadiness {
+    readonly backendKind: AtmosphereBackendKind;
+    readonly status: 'ready';
+    readonly operations: readonly AtmosphereCapabilityOperation[];
+}
+/**
+ * Consume the immutable M0 matrix and fail closed. This function does not
+ * mirror RhiCaps and does not create any shader, pipeline, or bundle. The
+ * actual producer calls it only from its lazy readiness path.
+ */
+export declare function admitAtmosphereCapability(matrix: AtmosphereCapabilityMatrix, backendKind: AtmosphereBackendKind): Result<AtmosphereReadiness, AtmosphereCapsInsufficientError | AtmosphereProducerFailedError>;
+/** Map a live producer stage failure without treating it as a capability gap. */
+export declare function atmosphereProducerFailure(stage: 'build' | 'execute' | 'submit', reason: string, generation?: number): Result<never, AtmosphereProducerFailedError>;
+//# sourceMappingURL=readiness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.d.ts","sourceRoot":"","sources":["../../src/environment/readiness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,+BAA+B,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AAElG,eAAO,MAAM,gCAAgC,kEAMnC,CAAC;AAEX,MAAM,MAAM,6BAA6B,GAAG,CAAC,OAAO,gCAAgC,CAAC,CAAC,MAAM,CAAC,CAAC;AAC9F,MAAM,MAAM,qBAAqB,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;AACrE,MAAM,MAAM,0BAA0B,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,iBAAiB,CAAC;AAEhG,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,0BAA0B,CAAC;IAC5C,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,0BAA0B,GAAG,SAAS,CAAC;CAC/E;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC,CAAC;CACtE;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,SAAS,6BAA6B,EAAE,CAAC;CAC/D;AAKD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,0BAA0B,EAClC,WAAW,EAAE,qBAAqB,GACjC,MAAM,CAAC,mBAAmB,EAAE,+BAA+B,GAAG,6BAA6B,CAAC,CAuB9F;AAED,iFAAiF;AACjF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,QAAQ,EACrC,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAAC,KAAK,EAAE,6BAA6B,CAAC,CAE9C"}