@forgeax/engine-rhi-debug 0.0.0-dev.8d955ade1c79

package/dist/recorder/core.d.ts

@@ -0,0 +1,296 @@
+import type { Result, RhiDevice, RhiInstance, ShaderModule, TextureView } from '@forgeax/engine-rhi';
+import { type RhiDebugError } from '../errors';
+import type { HandleId, RhiCallEvent, RhiCapsRecorded, Tape } from '../types';
+declare const SNAPSHOT_TIMEOUT_MS = 30000;
+export declare const PER_EVENT_OVERHEAD: 192;
+declare const TEXTURE_USAGE_COPY_SRC = 1;
+declare const TEXTURE_USAGE_COPY_DST = 2;
+declare const TEXTURE_USAGE_BINDING = 4;
+/** Bound staging allocation, command submission, and map concurrency per batch. */
+export declare const SNAPSHOT_RESOURCE_BATCH_SIZE = 32;
+/**
+ * True for each depth / stencil texture format. Their content is render-pass
+ * output (shadow maps, z-buffers), never an uploaded byte payload, and
+ * queue.writeTexture rejects them (no CopyDst), so the frame-header snapshot
+ * loop skips them rather than emitting an un-seedable initialData event.
+ */
+declare function isDepthOrStencilFormat(format: GPUTextureFormat | undefined): boolean;
+/**
+ * True for a texture the frame-header snapshot can read back AND re-seed
+ * faithfully: each color format with a known texel-block footprint, at each
+ * array-layer count and each mip count. The readback + seed path
+ * (readbackTexturePixels + computeTextureLayout + replayInitialData) walks
+ * every (layer, mip) subresource with block-aware bytesPerRow, so ordinary
+ * texels and BC/ETC/ASTC compressed assets share one round-trip contract.
+ *
+ * Still skipped (no faithful path today, Fail Fast rather than corrupt seed):
+ * - depth/stencil formats: queue.writeTexture rejects them (no CopyDst seed).
+ * - multisample (sampleCount > 1): writeTexture rejects an MSAA target. MSAA
+ *   attachments are transient (resolved into a single-sample texture that IS
+ *   snapshottable), so skipping loses no seed.
+ */
+declare function isSnapshottableColorTexture(format: GPUTextureFormat | undefined, _size: number | GPUExtent3DStrict | undefined, sampleCount?: number): boolean;
+/** Add COPY_SRC to a buffer usage unless it is a mappable (MAP_READ/WRITE) buffer. */
+declare function promoteBufferUsage(usage: number): number;
+/**
+ * True for a mappable (MAP_READ / MAP_WRITE) buffer. These are staging buffers
+ * (e.g. shadow-probe-staging): promoteBufferUsage deliberately does NOT add
+ * COPY_SRC to them (MAP_READ|COPY_SRC is an invalid WebGPU usage combo), so they
+ * cannot be a copyBufferToBuffer source. The frame-header snapshot loop must skip
+ * them — driving readbackBufferBytes on one throws "usage doesn't include
+ * CopySrc". Their bytes are transient readback scratch, never seed payload, so
+ * losing them is correct (mirrors promoteBufferUsage's own exclusion).
+ */
+declare function isMappableBuffer(usage: number): boolean;
+export { TAPE_FORMAT_VERSION } from '../protocol/types';
+declare enum RecorderState {
+    Idle = "idle",
+    Armed = "armed",
+    Snapshotting = "snapshotting",
+    Recording = "recording",
+    Finalizing = "finalizing",
+    Error = "error"
+}
+declare function allocHandleId(kind: string): HandleId;
+declare function fastHash(data: ArrayBuffer): string;
+declare function storeBlob(state: RecorderInternal, data: ArrayBuffer): string;
+/**
+ * Narrow a readbackBufferBytes failure to the snapshot stage.
+ * readbackBufferBytes already tags `.detail.phase` with 'copy' | 'map'; carry
+ * it through so the re-wrapped error preserves the failure point. Falls back to
+ * 'copy' when the inner error lacks a snapshot detail.
+ */
+declare function snapshotStageOf(error: RhiDebugError): 'copy' | 'map' | 'store';
+type SnapshotProgress = {
+    readonly startedAt: number;
+    readonly stage: 'queue-drain' | 'resource-readback';
+    readonly totalResources: number;
+    readonly completedResources: number;
+    readonly skippedResources: number;
+    readonly currentHandleId: string | null;
+    readonly currentKind: 'buffer' | 'texture' | null;
+    readonly currentSizeBytes: number | null;
+};
+interface RecorderInternal {
+    state: RecorderState;
+    requestedFrames: number;
+    recordedFrames: number;
+    events: RhiCallEvent[];
+    blobPool: Map<string, ArrayBuffer>;
+    handleMap: WeakMap<object, HandleId>;
+    textureViewHandleMap: WeakMap<TextureView, HandleId>;
+    /**
+     * @internal
+     * Bootstrap create-event table. Populated by registerHandle when called
+     * with a create event payload — records every create* (buffer, texture,
+     * pipeline, bindGroup, shaderModule, …) from the moment wrap() is called,
+     * independent of the recorder state machine (Idle / Armed / Recording).
+     * Preserved across arm() cycles (SSOT for closure computation in getTape).
+     */
+    bootstrapCreates: Map<HandleId, RhiCallEvent>;
+    /** Handles whose initialData event was emitted by the current capture. */
+    snapshotSeededHandles: Set<HandleId>;
+    /** Generation token invalidating async snapshot work after timeout/error. */
+    snapshotGeneration: number;
+    /** Last observable progress of the current/most recent resource snapshot. */
+    snapshotProgress: SnapshotProgress | undefined;
+    /**
+     * @internal
+     * Descriptor registry of currently-live resources. Written by createBuffer /
+     * createTexture (after registerHandle) and cleared by destroyBuffer /
+     * destroyTexture. Distinct from handleMap (WeakMap, handle object -> handleId
+     * identity, one-way): descriptorTable carries the descriptor *content* (kind /
+     * size / format / usage) AND the resource object keyed by handleId, so
+     * snapshotResource can both determine a resource's shape and reach the object
+     * for readback at frame-header time without re-scanning the event stream or
+     * reverse-walking the WeakMap (which cannot be iterated). destroy* removes the
+     * entry so the live-resource set never grows unbounded (AC-09). One registry,
+     * one delete on destroy — shape and object share the same lifecycle (SSOT).
+     */
+    descriptorTable: Map<HandleId, {
+        kind: 'buffer' | 'texture';
+        size?: number | GPUExtent3DStrict;
+        format?: GPUTextureFormat;
+        sampleCount?: number;
+        mipLevelCount?: number;
+        usage: number;
+        resource: object;
+    }>;
+    /** @internal */
+    _skipRecord: boolean;
+    frameIdx: number;
+    bootstrap: boolean;
+    recordedCaps: RhiCapsRecorded | undefined;
+    onFrameEndUnsubscribe?: (() => void) | undefined;
+    /** true when the current recording is valid. */
+    valid: boolean;
+    /**
+     * @internal
+     * Most recent live RhiDevice produced by `requestAdapter().requestDevice()`
+     * via the recorder proxy chain. Captured so the adapter (I-2 fix) can
+     * reach the same device for replay without forcing the host to expose
+     * a separate channel.
+     */
+    capturedDevice: RhiDevice | undefined;
+}
+declare function snapshotTimeoutDetail(progress: SnapshotProgress | undefined, timeoutMs: number): import('../errors').CaptureTimeoutDetail;
+/**
+ * @internal
+ * True while the recorder is in a state that appends normal RHI events to the
+ * tape: Armed / Recording. Snapshotting is deliberately excluded: the async
+ * frame-header seed phase must not fold live viewport frames into the capture.
+ * This is the SSOT recording predicate —
+ * `pushEvent` gates on it, and the proxy fast-path (writeBuffer / writeTexture /
+ * createCommandEncoder) short-circuits when it is false so an idle recorder
+ * (FORGEAX_ENGINE_RHI_DEBUG=1 but no capture in flight) pays no per-call
+ * event-object allocation, no storeBlob hash+copy, and no proxy-encoder wrapping.
+ *
+ * Deliberately ignores `_skipRecord`: that flag suppresses recorder-internal
+ * RHI calls (such as snapshot readback staging) during either capture phase.
+ * `shouldRecord` folds it in for the normal pushEvent gate.
+ */
+declare function isRecordingActive(s: RecorderInternal): boolean;
+/**
+ * A frame-header snapshot is not a normal render-recording phase, but it can
+ * already have copied a live resource and still need that resource's create
+ * event when it appends `initialData`. Keep bootstrap ownership through that
+ * async window: per-frame feature resources may be released while readback is
+ * awaiting GPU completion.
+ */
+declare function retainsCaptureBootstrap(s: RecorderInternal): boolean;
+/**
+ * @internal
+ * The exact pushEvent gate as a predicate: record iff not suppressed AND in an
+ * active recording state. Proxy methods that do pre-pushEvent work (storeBlob,
+ * event-object construction) check this first to skip that work when it would
+ * be discarded — same-condition-as-pushEvent guarantees no behavioural drift
+ * (a call that would record still does all its work).
+ */
+declare function shouldRecord(s: RecorderInternal): boolean;
+declare function pushEvent(s: RecorderInternal, event: RhiCallEvent): void;
+/**
+ * Append a frame-header seed without reopening the normal RHI event gate.
+ * Snapshotting is not a render-recording state, but its async readback still
+ * needs to emit initialData events for the resources that seed replay.
+ */
+declare function pushSnapshotEvent(s: RecorderInternal, event: RhiCallEvent): void;
+declare function registerHandle(s: RecorderInternal, handle: object, kind: string, createEvent?: RhiCallEvent): HandleId;
+declare function ensureTextureCreateEvent(s: RecorderInternal, texture: object, textureId: HandleId, viewFormat?: GPUTextureFormat): RhiDebugError | undefined;
+declare function addSwapchainViewFormat(texture: Extract<RhiCallEvent, {
+    kind: 'createTexture';
+}>, viewFormat: GPUTextureFormat): void;
+declare function reconcileSwapchainViewFormats(s: RecorderInternal): void;
+declare function hasBootstrapDependency(s: RecorderInternal, handleId: HandleId): boolean;
+declare function getHandleId(s: RecorderInternal, handle: object, kind: string): HandleId;
+/**
+ * @internal
+ * Collect all handleIds referenced by frame events in `s.events`.
+ *
+ * Scans events for ALL fields that reference resources — mirrors
+ * the reference categories checked by findDanglingHandleId in
+ * tape-format.ts to achieve producer/consumer convergence (D-2).
+ *
+ * Includes: buffer/texture/pipeline/bindGroup/sampler/textureView/
+ * shaderModule handles (persistent), plus passHandleId and cmdHandleId
+ * from pass/encoder events (per-frame transient). Transient handles
+ * that are declared in-frame are excluded later by the inFrameHandleIds
+ * filter in getTape().
+ */
+export interface DebugRhiInstance extends RhiInstance {
+    arm(frames: number): Result<void, RhiDebugError>;
+    onFrameEnd(): void;
+    getTape(): Tape | RhiDebugError | undefined;
+    getState(): string;
+    getEvents(): readonly RhiCallEvent[];
+    getBlobPool(): ReadonlyMap<string, ArrayBuffer>;
+    /** Transition to error state (e.g. on device.lost). Tape data preserved but valid=false. */
+    transitionToError(): void;
+    /** Clear error state to idle, allowing re-arm. */
+    disposeError(): void;
+    /**
+     * Snapshot a resource's GPU bytes into the tape as an initialData event.
+     *
+     * Reads the resource descriptor from the internal registry, copies the
+     * resource's bytes via copyToBuffer/mapAsync, stores the bytes into the
+     * blobPool (djb2 hash-dedup), and pushes an RhiCallEventInitialData into
+     * the event stream. Returns Result with {handleId, dataHash} on success,
+     * or capture-snapshot-failed on a readback/storeBlob failure.
+     *
+     * Async: the GPU readback chain (copyToBuffer -> submit ->
+     * onSubmittedWorkDone -> mapAsync) is inherently asynchronous.
+     */
+    snapshotResource(handleId: HandleId): Promise<Result<{
+        handleId: HandleId;
+        dataHash: string;
+    }, RhiDebugError>>;
+    /**
+     * Frame-header snapshot loop: awaits all submitted GPU work, then snapshots
+     * every live resource in the descriptor registry (full-table dump, no
+     * trimming). Advances the recorder Armed -> Snapshotting -> Recording on
+     * success. Returns the first snapshot failure as a Result so the caller can
+     * fail fast rather than record a partial seed set.
+     */
+    snapshotAllLiveResources(timeoutMs?: number): Promise<Result<void, RhiDebugError>>;
+    /**
+     * @internal
+     * Append an event from a standalone wrapper (e.g. `wrapCreateShaderModule`)
+     * through the same `_skipRecord` + state-machine guard that the proxy
+     * methods use. This exists so external wrappers cannot bypass recursion
+     * protection (I-12, round 1 implement-review). Not part of the AI-user
+     * contract — `wrap*` helpers in this package are the only callers.
+     */
+    pushExternalEvent(event: RhiCallEvent): void;
+    /**
+     * @internal
+     * Register a shader module object in the recorder's handleMap so
+     * downstream pipeline events can look up its handleId via getHandleId.
+     */
+    registerShaderModule(handle: ShaderModule, handleId: HandleId): void;
+    /**
+     * @internal
+     * Route a create event through registerHandle (alloc id + write bootstrapCreates)
+     * and pushEvent in a single call. For standalone wrappers that cannot access
+     * the internal registerHandle/pushEvent functions directly.
+     * Returns the allocated HandleId so the caller can use it for downstream
+     * registration (e.g. shaderModule → handleMap).
+     */
+    pushExternalCreateEvent(handle: object, kind: string, event: RhiCallEvent): HandleId;
+    /**
+     * @internal
+     * Drop all device-bound recorder state after the host observes a real
+     * device loss. A tape recorded against the lost device cannot seed a fresh
+     * device, so the next capture must start from the rebuilt resource graph.
+     */
+    resetForDeviceLoss(): void;
+    /** @internal Return whether the current capture is valid. */
+    valid(): boolean;
+    /**
+     * @internal
+     * Return the number of entries in bootstrapCreates. Test-only accessor
+     * so unit tests can verify bootstrapCreates write/retain semantics
+     * without going through getTape() closure computation (M2).
+     */
+    bootstrapCreatesSize(): number;
+    /** @internal Return the create-event identities owned by the bootstrap registry. */
+    bootstrapEvents(): readonly RhiCallEvent[];
+    /**
+     * @internal
+     * Read-only view of the descriptor registry keyed by handleId. Test-only
+     * accessor so unit tests can verify create* register / destroy* remove
+     * semantics (AC-09) without reaching into the closed-over recorder state.
+     */
+    descriptorTable(): ReadonlyMap<HandleId, {
+        kind: 'buffer' | 'texture';
+        size?: number | GPUExtent3DStrict;
+        format?: GPUTextureFormat;
+        usage: number;
+        resource: object;
+    }>;
+}
+export type CreateShaderModuleFn = (device: RhiDevice, desc: {
+    code: string;
+    label?: string | undefined;
+}) => Promise<Result<ShaderModule, import('@forgeax/engine-rhi').RhiError>>;
+export type { RecorderInternal, SnapshotProgress };
+export { addSwapchainViewFormat, allocHandleId, ensureTextureCreateEvent, fastHash, getHandleId, hasBootstrapDependency, isDepthOrStencilFormat, isMappableBuffer, isRecordingActive, isSnapshottableColorTexture, promoteBufferUsage, pushEvent, pushSnapshotEvent, RecorderState, reconcileSwapchainViewFormats, registerHandle, retainsCaptureBootstrap, SNAPSHOT_TIMEOUT_MS, shouldRecord, snapshotStageOf, snapshotTimeoutDetail, storeBlob, TEXTURE_USAGE_BINDING, TEXTURE_USAGE_COPY_DST, TEXTURE_USAGE_COPY_SRC, };
+//# sourceMappingURL=core.d.ts.map

package/dist/recorder/core.d.ts.map

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

package/dist/recorder/device.d.ts

@@ -0,0 +1,4 @@
+import type { RhiDevice } from '@forgeax/engine-rhi';
+import type { RecorderInternal } from './core';
+export declare function createDeviceProxy(s: RecorderInternal, realDevice: RhiDevice): RhiDevice;
+//# sourceMappingURL=device.d.ts.map

package/dist/recorder/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../src/recorder/device.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAYV,SAAS,EAKV,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAmB/C,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,gBAAgB,EAAE,UAAU,EAAE,SAAS,GAAG,SAAS,CAyavF"}

package/dist/recorder/encoder.d.ts

@@ -0,0 +1,5 @@
+import type { RhiCommandEncoder } from '@forgeax/engine-rhi';
+import type { HandleId } from '../types';
+import type { RecorderInternal } from './core';
+export declare function createCommandEncoderProxy(s: RecorderInternal, realEnc: RhiCommandEncoder, cmdHId: HandleId): RhiCommandEncoder;
+//# sourceMappingURL=encoder.d.ts.map

package/dist/recorder/encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../src/recorder/encoder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAIV,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAI/C,wBAAgB,yBAAyB,CACvC,CAAC,EAAE,gBAAgB,EACnB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,QAAQ,GACf,iBAAiB,CAyOnB"}

package/dist/recorder/lifecycle.d.ts

@@ -0,0 +1,20 @@
+import type { Result } from '@forgeax/engine-rhi';
+import { type RhiDebugError } from '../errors';
+import type { HandleId, RhiCallEvent, Tape } from '../types';
+import { type RecorderInternal } from './core';
+export declare function createRecorderLifecycle(s: RecorderInternal): {
+    arm: (frames: number) => Result<void, RhiDebugError>;
+    onFrameEnd: () => void;
+    getTape: () => Tape | RhiDebugError | undefined;
+    getState: () => string;
+    getEvents: () => readonly RhiCallEvent[];
+    getBlobPool: () => ReadonlyMap<string, ArrayBuffer>;
+    transitionToError: () => void;
+    disposeError: () => void;
+    snapshotResource: (handleId: HandleId, snapshotGeneration?: number) => Promise<Result<{
+        handleId: HandleId;
+        dataHash: string;
+    }, RhiDebugError>>;
+    snapshotAllLiveResources: (timeoutMs?: number) => Promise<Result<void, RhiDebugError>>;
+};
+//# sourceMappingURL=lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/recorder/lifecycle.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAa,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAQpE,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAO7D,OAAO,EAKL,KAAK,gBAAgB,EAStB,MAAM,QAAQ,CAAC;AAEhB,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,gBAAgB;kBACpC,MAAM,KAAG,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC;sBAyClC,IAAI;mBAkDP,IAAI,GAAG,aAAa,GAAG,SAAS;oBAgI/B,MAAM;qBAGL,SAAS,YAAY,EAAE;uBAGrB,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC;6BAI1B,IAAI;wBAiBT,IAAI;iCAgCjB,QAAQ,uBACG,MAAM,KAC1B,OAAO,CAAC,MAAM,CAAC;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,aAAa,CAAC,CAAC;sDA4JxE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;EAoXxC"}

package/dist/recorder/pass.d.ts

@@ -0,0 +1,6 @@
+import type { RhiComputePassEncoder, RhiRenderPassEncoder } from '@forgeax/engine-rhi';
+import type { HandleId } from '../types';
+import type { RecorderInternal } from './core';
+export declare function createRenderPassProxy(s: RecorderInternal, realPass: RhiRenderPassEncoder, passHId: HandleId): RhiRenderPassEncoder;
+export declare function createComputePassProxy(s: RecorderInternal, realPass: RhiComputePassEncoder, passHId: HandleId): RhiComputePassEncoder;
+//# sourceMappingURL=pass.d.ts.map

package/dist/recorder/pass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pass.d.ts","sourceRoot":"","sources":["../../src/recorder/pass.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAG/C,wBAAgB,qBAAqB,CACnC,CAAC,EAAE,gBAAgB,EACnB,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,EAAE,QAAQ,GAChB,oBAAoB,CA6KtB;AAED,wBAAgB,sBAAsB,CACpC,CAAC,EAAE,gBAAgB,EACnB,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,EAAE,QAAQ,GAChB,qBAAqB,CA6CvB"}

package/dist/recorder/proxy.d.ts

@@ -0,0 +1,19 @@
+import type { RhiCanvasContext, RhiDevice, RhiError, RhiInstance } from '@forgeax/engine-rhi';
+import { type Result } from '@forgeax/engine-types';
+import { type RhiDebugError } from '../errors';
+import { type CreateShaderModuleFn, type DebugRhiInstance } from '../recorder';
+export interface RecordableBackend {
+    readonly rhi: RhiInstance & {
+        readonly acquireCanvasContext?: (canvas: HTMLCanvasElement | OffscreenCanvas) => Result<RhiCanvasContext, RhiError>;
+    };
+    readonly createShaderModule: CreateShaderModuleFn;
+}
+export interface RecorderBackend extends RecordableBackend {
+    readonly unwrapDeviceForSurface: (device: RhiDevice) => Result<RhiDevice, RhiDebugError>;
+}
+export interface RecorderProxy {
+    readonly backend: RecorderBackend;
+    readonly recorder: DebugRhiInstance;
+}
+export declare function createRecorderProxy(backend: RecordableBackend): RecorderProxy;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/recorder/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/recorder/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EAGtB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG;QAC1B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAC9B,MAAM,EAAE,iBAAiB,GAAG,eAAe,KACxC,MAAM,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;KACzC,CAAC;IACF,QAAQ,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;CACnD;AAED,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD,QAAQ,CAAC,sBAAsB,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;CAC1F;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;CACrC;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CA8B7E"}

package/dist/recorder/queue.d.ts

@@ -0,0 +1,4 @@
+import type { RhiQueue } from '@forgeax/engine-rhi';
+import type { RecorderInternal } from './core';
+export declare function createQueueProxy(s: RecorderInternal, realQueue: RhiQueue): RhiQueue;
+//# sourceMappingURL=queue.d.ts.map

package/dist/recorder/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/recorder/queue.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAyB,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAG/C,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,gBAAgB,EAAE,SAAS,EAAE,QAAQ,GAAG,QAAQ,CAqGnF"}

package/dist/recorder/resource-registry.d.ts

@@ -0,0 +1,15 @@
+import type { DebugRhiInstance } from '../recorder';
+import type { HandleId } from '../types';
+export interface ResourceCandidate {
+    readonly handleId: HandleId;
+    readonly kind: 'buffer' | 'texture';
+    readonly estimatedBytes: number;
+}
+export declare class ResourceRegistry {
+    private readonly recorder;
+    constructor(recorder: DebugRhiInstance);
+    candidates(): readonly ResourceCandidate[];
+    estimateSnapshotBytes(): number;
+    clearGeneration(): void;
+}
+//# sourceMappingURL=resource-registry.d.ts.map

package/dist/recorder/resource-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-registry.d.ts","sourceRoot":"","sources":["../../src/recorder/resource-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,gBAAgB;IAEvD,UAAU,IAAI,SAAS,iBAAiB,EAAE;IAQ1C,qBAAqB,IAAI,MAAM;IAI/B,eAAe,IAAI,IAAI;CAIxB"}

package/dist/recorder/session.d.ts

@@ -0,0 +1,25 @@
+import { type Result } from '@forgeax/engine-types';
+import { type RhiDebugError } from '../errors';
+import { type EncodedTape } from './assemble';
+import { type RecordableBackend, type RecorderBackend } from './proxy';
+export interface CaptureFrameOptions {
+    readonly snapshotTimeoutMs?: number;
+    readonly byteBudget?: number;
+    readonly signal?: AbortSignal;
+}
+export interface RecorderOptions {
+    readonly snapshotTimeoutMs?: number;
+    readonly byteBudget?: number;
+}
+export interface RecorderAttachment {
+    readonly backend: RecorderBackend;
+    captureFrame(options?: CaptureFrameOptions): Promise<Result<EncodedTape, RhiDebugError>>;
+    frameBoundary(): Promise<Result<void, RhiDebugError>>;
+    deviceLost(): void;
+    dispose(): Promise<Result<void, RhiDebugError>>;
+}
+export declare function attachRecorder(backend: RecordableBackend, options?: RecorderOptions): Result<RecorderAttachment, RhiDebugError>;
+export type { CreateShaderModuleFn } from '../recorder';
+export type { EncodedTape } from './assemble';
+export type { RecordableBackend, RecorderBackend } from './proxy';
+//# sourceMappingURL=session.d.ts.map

package/dist/recorder/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/recorder/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAuB,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAI5F,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,YAAY,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;IACzF,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;IACtD,UAAU,IAAI,IAAI,CAAC;IACnB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;CACjD;AAID,wBAAgB,cAAc,CAC5B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,GAAE,eAAoB,GAC5B,MAAM,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAoH3C;AAED,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}

package/dist/recorder/shader.d.ts

@@ -0,0 +1,3 @@
+import type { CreateShaderModuleFn, DebugRhiInstance } from './core';
+export declare function wrapCreateShaderModule(originalFn: CreateShaderModuleFn, debugInst: DebugRhiInstance): CreateShaderModuleFn;
+//# sourceMappingURL=shader.d.ts.map

package/dist/recorder/shader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shader.d.ts","sourceRoot":"","sources":["../../src/recorder/shader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAErE,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,oBAAoB,EAChC,SAAS,EAAE,gBAAgB,GAC1B,oBAAoB,CAqCtB"}

package/dist/recorder/snapshot.d.ts

@@ -0,0 +1,10 @@
+import { type Result } from '@forgeax/engine-types';
+import { type RhiDebugError } from '../errors';
+import type { DebugRhiInstance } from '../recorder';
+import type { ResourceRegistry } from './resource-registry';
+export interface SnapshotOptions {
+    readonly snapshotTimeoutMs: number;
+    readonly byteBudget: number;
+}
+export declare function snapshotFrame(recorder: DebugRhiInstance, registry: ResourceRegistry, options: SnapshotOptions): Promise<Result<void, RhiDebugError>>;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/recorder/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/recorder/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAuBtC"}

package/dist/recorder/wrap.d.ts

@@ -0,0 +1,4 @@
+import type { RhiInstance } from '@forgeax/engine-rhi';
+import { type DebugRhiInstance } from './core';
+export declare function wrap(instance: RhiInstance): DebugRhiInstance;
+//# sourceMappingURL=wrap.d.ts.map

package/dist/recorder/wrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap.d.ts","sourceRoot":"","sources":["../../src/recorder/wrap.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAMV,WAAW,EAEZ,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,KAAK,gBAAgB,EAKtB,MAAM,QAAQ,CAAC;AAIhB,wBAAgB,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,gBAAgB,CAmI5D"}

package/dist/recorder.d.ts

@@ -0,0 +1,7 @@
+export type { CreateShaderModuleFn, DebugRhiInstance } from './recorder/core';
+export { PER_EVENT_OVERHEAD, TAPE_FORMAT_VERSION } from './recorder/core';
+export type { CaptureFrameOptions, EncodedTape, RecordableBackend, RecorderAttachment, RecorderBackend, RecorderOptions, } from './recorder/session';
+export { attachRecorder } from './recorder/session';
+export { wrapCreateShaderModule } from './recorder/shader';
+export { wrap } from './recorder/wrap';
+//# sourceMappingURL=recorder.d.ts.map

package/dist/recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../src/recorder.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/replay/device-request.d.ts

@@ -0,0 +1,8 @@
+import type { Tape } from '../protocol/types';
+/**
+ * Build the strongest fresh WebGPU device the current adapter can provide for
+ * a recorded tape. Optional features must be enabled, not merely advertised,
+ * and replay receives concrete adapter limits instead of lower device defaults.
+ */
+export declare function replayDeviceRequest(tape: Tape, adapterFeatures: ReadonlySet<GPUFeatureName>, adapterLimits: Readonly<Record<string, number>>): GPUDeviceDescriptor;
+//# sourceMappingURL=device-request.d.ts.map

package/dist/replay/device-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-request.d.ts","sourceRoot":"","sources":["../../src/replay/device-request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAY9C;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,EACV,eAAe,EAAE,WAAW,CAAC,cAAc,CAAC,EAC5C,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC9C,mBAAmB,CAgBrB"}

package/dist/replay/execute-support.d.ts

@@ -0,0 +1,33 @@
+import type { RhiCommandEncoder, RhiComputePassEncoder, RhiRenderPassEncoder } from '@forgeax/engine-rhi';
+import { type Result } from '@forgeax/engine-types';
+import { type RhiDebugError } from '../errors';
+import type { RhiCallEvent, Tape } from '../protocol/types';
+import type { ReplayExecutionContext } from './execute';
+import type { ReplayResource } from './resources';
+type ReplayPass = RhiRenderPassEncoder & RhiComputePassEncoder;
+export declare function eventRecord(event: RhiCallEvent): Record<string, unknown>;
+export declare function eventFailure(eventIndex: number, event: RhiCallEvent, stage: 'lookup' | 'create' | 'write' | 'encode' | 'finish' | 'submit', cause: unknown): Result<never, RhiDebugError>;
+export declare function blob(tape: Tape, hash: string, event: RhiCallEvent, eventIndex: number): Result<Uint8Array, RhiDebugError>;
+export declare function clearBuffer(context: ReplayExecutionContext, event: Extract<RhiCallEvent, {
+    kind: 'clearBuffer';
+}>, eventIndex: number): Result<void, RhiDebugError>;
+export declare function commandEncoderCall(context: ReplayExecutionContext, event: Extract<RhiCallEvent, {
+    kind: 'pushDebugGroup' | 'popDebugGroup' | 'insertDebugMarker';
+}>, eventIndex: number, call: (encoder: RhiCommandEncoder) => void): Result<void, RhiDebugError>;
+export declare function finish(context: ReplayExecutionContext, event: Extract<RhiCallEvent, {
+    kind: 'finish';
+}>, eventIndex: number): Result<void, RhiDebugError>;
+export declare function endPass(context: ReplayExecutionContext, event: Extract<RhiCallEvent, {
+    kind: 'endRenderPass' | 'endComputePass';
+}>, eventIndex: number, role: 'render-pass' | 'compute-pass'): Result<void, RhiDebugError>;
+export declare function seedInitialData(context: ReplayExecutionContext, event: Extract<RhiCallEvent, {
+    kind: 'initialData';
+}>, eventIndex: number): Result<void, RhiDebugError>;
+export declare function requireResource<T>(context: ReplayExecutionContext, resourceId: string, kind: ReplayResource['kind'] | string, eventIndex: number, eventKind: RhiCallEvent['kind'], role?: string): Result<T, RhiDebugError>;
+export declare function requireReplayResource(context: ReplayExecutionContext, resourceId: string, kind: ReplayResource['kind'] | string, eventIndex: number, eventKind: RhiCallEvent['kind'], role?: string): Result<ReplayResource, RhiDebugError>;
+export declare function passCall(context: ReplayExecutionContext, event: RhiCallEvent, eventIndex: number, role: 'render-pass' | 'compute-pass' | 'pass', call: (pass: ReplayPass) => Result<void, RhiDebugError>): Result<void, RhiDebugError>;
+export declare function pipelineError<T>(result: Result<T, RhiDebugError>, event: RhiCallEvent, eventIndex: number): Result<never, RhiDebugError>;
+export declare function missingResource(eventIndex: number, event: RhiCallEvent, resourceId: string, expected: string): Result<never, RhiDebugError>;
+export declare function unsupportedEvent(eventIndex: number, event: RhiCallEvent, cause: string): Result<never, RhiDebugError>;
+export {};
+//# sourceMappingURL=execute-support.d.ts.map

package/dist/replay/execute-support.d.ts.map

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

package/dist/replay/execute.d.ts

@@ -0,0 +1,18 @@
+import type { RhiDevice, RhiError, RhiQueue } from '@forgeax/engine-rhi';
+import { type Result } from '@forgeax/engine-types';
+import type { RhiDebugError } from '../errors';
+import type { RhiCallEvent, Tape } from '../protocol/types';
+import type { ResourceTable } from './resources';
+export { eventFailure } from './execute-support';
+export interface ReplayExecutionContext {
+    readonly device: RhiDevice;
+    readonly queue: RhiQueue;
+    readonly tape: Tape;
+    readonly table: ResourceTable;
+    readonly createShaderModule: (device: RhiDevice, desc: {
+        readonly code: string;
+        readonly label?: string | undefined;
+    }) => Promise<Result<import('@forgeax/engine-rhi').ShaderModule, RhiError>>;
+}
+export declare function executeEvent(context: ReplayExecutionContext, event: RhiCallEvent, eventIndex: number): Promise<Result<void, RhiDebugError>>;
+//# sourceMappingURL=execute.d.ts.map

package/dist/replay/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/replay/execute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EASV,SAAS,EACT,QAAQ,EACR,QAAQ,EAET,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAM,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAiB5D,OAAO,KAAK,EAAkB,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,CAC3B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,KACjE,OAAO,CAAC,MAAM,CAAC,OAAO,qBAAqB,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;CAC5E;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,sBAAsB,EAC/B,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CA+RtC"}

package/dist/replay/readback.d.ts

@@ -0,0 +1,32 @@
+import type { RhiDevice } from '@forgeax/engine-rhi';
+import { type Result } from '@forgeax/engine-types';
+import { type RhiDebugError } from '../errors';
+import type { CreateShaderModuleFn } from '../recorder';
+import type { ResourceTable } from './resources';
+export interface BufferReadbackRange {
+    readonly offset: number;
+    readonly size?: number;
+}
+export interface TextureReadbackSubresource {
+    readonly mipLevel?: number;
+    readonly arrayLayer?: number;
+    readonly aspect?: 'all' | 'depth-only' | 'stencil-only';
+}
+export type ReplayReadbackRequest = BufferReadbackRange | TextureReadbackSubresource;
+export interface ReplayReadbackProvenance {
+    readonly generation: number;
+    readonly resourceId: string;
+    readonly subresource: ReplayReadbackRequest | null;
+    readonly selectedWorkIndex?: number;
+}
+export interface ReplayReadbackResult {
+    readonly resourceId: string;
+    readonly kind: 'buffer' | 'texture';
+    readonly format?: string;
+    readonly width?: number;
+    readonly height?: number;
+    readonly bytes: Uint8Array;
+    readonly provenance: ReplayReadbackProvenance;
+}
+export declare function readReplayResource(device: RhiDevice, table: ResourceTable, resourceId: string, subresource: ReplayReadbackRequest | undefined, createShaderModule: CreateShaderModuleFn): Promise<Result<ReplayReadbackResult, RhiDebugError>>;
+//# sourceMappingURL=readback.d.ts.map

package/dist/replay/readback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readback.d.ts","sourceRoot":"","sources":["../../src/replay/readback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,SAAS,EAEV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,aAAa,CAAC;AAWrE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,YAAY,GAAG,cAAc,CAAC;CACzD;AAED,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,GAAG,0BAA0B,CAAC;AAErF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAC;CAC/C;AAID,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,qBAAqB,GAAG,SAAS,EAC9C,kBAAkB,EAAE,oBAAoB,GACvC,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,aAAa,CAAC,CAAC,CAoCtD"}