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

package/dist/replay/resources.d.ts

@@ -0,0 +1,57 @@
+import type { BindGroup, BindGroupLayout, Buffer, CommandBuffer, ComputePipeline, PipelineLayout, RenderPipeline, RhiCommandEncoder, RhiComputePassEncoder, RhiDevice, RhiRenderPassEncoder, Sampler, ShaderModule, Texture, TextureView } from '@forgeax/engine-rhi';
+import { type Result } from '@forgeax/engine-types';
+import { type RhiDebugError } from '../errors';
+import type { ResourceKind } from '../protocol/types';
+export type ReplayResource = {
+    readonly role?: string;
+} & ({
+    readonly kind: 'buffer';
+    readonly value: Buffer;
+} | {
+    readonly kind: 'texture';
+    readonly value: Texture;
+} | {
+    readonly kind: 'texture-view';
+    readonly value: TextureView;
+} | {
+    readonly kind: 'sampler';
+    readonly value: Sampler;
+} | {
+    readonly kind: 'shader-module';
+    readonly value: ShaderModule;
+} | {
+    readonly kind: 'pipeline';
+    readonly role: 'render' | 'compute';
+    readonly value: RenderPipeline | ComputePipeline;
+} | {
+    readonly kind: 'binding';
+    readonly role: 'bind-group' | 'bind-group-layout' | 'pipeline-layout';
+    readonly value: BindGroup | BindGroupLayout | PipelineLayout;
+} | {
+    readonly kind: 'encoder';
+    readonly role: 'command' | 'command-buffer' | 'render-pass' | 'compute-pass';
+    readonly value: RhiCommandEncoder | RhiRenderPassEncoder | RhiComputePassEncoder | CommandBuffer;
+});
+export interface ResourceTableEntry {
+    readonly resourceId: string;
+    readonly generation: number;
+    readonly resource: ReplayResource;
+    readonly descriptor: Record<string, unknown> | undefined;
+}
+export declare class ResourceTable {
+    private readonly device;
+    private readonly entries;
+    private disposed;
+    private currentGeneration;
+    constructor(device: RhiDevice, generation?: number);
+    get generation(): number;
+    get(resourceId: string): ResourceTableEntry | undefined;
+    set(resourceId: string, resource: ReplayResource, descriptor?: Record<string, unknown> | undefined): Result<void, RhiDebugError>;
+    delete(resourceId: string): void;
+    values(): IterableIterator<ResourceTableEntry>;
+    reset(): Result<void, RhiDebugError>;
+    dispose(): Result<void, RhiDebugError>;
+    private releaseAll;
+}
+export declare function isResourceKind(resource: ReplayResource, kind: ResourceKind): boolean;
+//# sourceMappingURL=resources.d.ts.map

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

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

package/dist/replay/session.d.ts

@@ -0,0 +1,49 @@
+import type { RhiDevice } from '@forgeax/engine-rhi';
+import { type Result } from '@forgeax/engine-types';
+import { type RhiDebugError } from '../errors';
+import { type WorkBinding, type WorkPipeline } from '../frame-model';
+import type { Tape } from '../protocol/types';
+import type { CreateShaderModuleFn } from '../recorder';
+import { type BufferReadbackRange, type ReplayReadbackResult } from './readback';
+export interface ReplayBackend {
+    readonly device: RhiDevice;
+    readonly createShaderModule: CreateShaderModuleFn;
+}
+export interface TextureSubresource {
+    readonly mipLevel: number;
+    readonly arrayLayer: number;
+    readonly aspect?: 'all' | 'depth-only' | 'stencil-only';
+}
+export type ReadbackSubresource = TextureSubresource | BufferReadbackRange;
+export type InspectField = 'bindings' | 'pipeline' | 'pixels';
+export interface WorkInspection {
+    readonly workIndex: number;
+    readonly eventIndex: number;
+    readonly passIndex: number;
+    readonly attachment: ReplayReadbackResult | undefined;
+    readonly pipeline?: WorkPipeline;
+    readonly bindings?: readonly WorkBinding[];
+    readonly vertexBuffers?: readonly {
+        readonly slot: number;
+        readonly bufferHandleId: string;
+        readonly offset: number;
+        readonly size: number | null;
+    }[];
+    readonly indexBuffer?: {
+        readonly bufferHandleId: string;
+        readonly format: string;
+        readonly offset: number;
+        readonly size: number | null;
+    } | null;
+    readonly shaders?: WorkPipeline['shaders'];
+    readonly resourceIds?: readonly string[];
+}
+export interface ReplaySession {
+    readonly generation: number;
+    inspectWork(workIndex: number, fields?: readonly InspectField[], signal?: AbortSignal): Promise<Result<WorkInspection, RhiDebugError>>;
+    readResource(resourceId: string, subresource?: ReadbackSubresource, signal?: AbortSignal): Promise<Result<ReplayReadbackResult, RhiDebugError>>;
+    dispose(): Promise<Result<void, RhiDebugError>>;
+}
+export declare function openReplay(tape: Tape, backend: ReplayBackend): Promise<Result<ReplaySession, RhiDebugError>>;
+export type { BufferReadbackRange, ReplayReadbackResult } from './readback';
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/replay/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,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,EAAmB,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEtF,OAAO,KAAK,EAAmC,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGxD,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAE1B,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;CACnD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,YAAY,GAAG,cAAc,CAAC;CACzD;AAED,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;AAE3E,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE9D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC3C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS;QAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,EAAE,CAAC;IACJ,QAAQ,CAAC,WAAW,CAAC,EAAE;QACrB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,GAAG,IAAI,CAAC;IACT,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,WAAW,CACT,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,EAChC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC;IAClD,YAAY,CACV,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,mBAAmB,EACjC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,aAAa,CAAC,CAAC,CAAC;IACxD,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;CACjD;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC,CA2I/C;AAoSD,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/replay/texture-format.d.ts

@@ -0,0 +1,21 @@
+export interface TextureReadbackDescriptor {
+    readonly format: string;
+    readonly dimension: string;
+    readonly aspect?: GPUTextureAspect | undefined;
+}
+export type TextureReadbackPlan = {
+    readonly supported: true;
+    readonly format: string;
+    readonly bytesPerTexel: number;
+    readonly blockWidth: 1;
+    readonly blockHeight: 1;
+} | {
+    readonly supported: false;
+    readonly format: string;
+    readonly reason: string;
+};
+export declare function isDepthTextureFormat(format: string): boolean;
+export declare function isDepthStencilTextureFormat(format: string): boolean;
+export declare function getTextureReadbackPlan(descriptor: TextureReadbackDescriptor): TextureReadbackPlan;
+export declare function textureBytesPerTexel(format: string): number | undefined;
+//# sourceMappingURL=texture-format.d.ts.map

package/dist/replay/texture-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"texture-format.d.ts","sourceRoot":"","sources":["../../src/replay/texture-format.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;CAChD;AAED,MAAM,MAAM,mBAAmB,GAC3B;IACE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;CACzB,GACD;IACE,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AA2BN,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,yBAAyB,GAAG,mBAAmB,CAuCjG;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvE"}

package/dist/texel-decode.d.ts

@@ -0,0 +1,35 @@
+/** Decode a single IEEE half-float (16-bit) bit pattern to a JS number. */
+export declare function halfToFloat(h: number): number;
+/**
+ * Decode tight raw GPU bytes of a supported color or depth/stencil plane into
+ * RGBA8 the canvas can paint via putImageData. Returns null when the format has
+ * no {@link formatInfo} entry or the requested aspect is invalid.
+ *
+ * @param bytes - Tight readback bytes (no row padding), length = w*h*bytesPerTexel.
+ * @param format - The texture's real format string.
+ * @param width - Texture width in pixels.
+ * @param height - Texture height in pixels.
+ * @param aspect - Explicit plane selected by readback for depth/stencil formats.
+ */
+export declare function decodeToRgba8(bytes: Uint8Array, format: string, width: number, height: number, aspect?: 'all' | 'depth-only' | 'stencil-only'): Uint8ClampedArray<ArrayBuffer> | null;
+/**
+ * Decode a single texel from tight raw GPU bytes into raw float RGBA values
+ * without the display clamp (D-4: raw byte bypass for HDR fidelity).
+ *
+ * Unlike `decodeToRgba8` which clamps float/ufloat to [0,1] for display, this
+ * returns the decoded per-channel values as-is: float formats keep true values
+ * (2.5 stays 2.5, negative stays negative), unorm/snorm stay in their native
+ * ranges, uint/sint stay as integers cast to number.
+ *
+ * Channels: 1ch grayscale (R=G=B, A=1), 2ch (RG, B=0, A=1), 3/4ch (RGBA or
+ * BGRA→swizzled). Returns null when the format has no {@link formatInfo} entry.
+ *
+ * @param bytes - Tight readback bytes, length = width*height*bytesPerTexel.
+ * @param format - The texture's real format string.
+ * @param width - Texture width in pixels.
+ * @param height - Texture height in pixels.
+ * @param texelX - 0-based column of the target texel.
+ * @param texelY - 0-based row of the target texel.
+ */
+export declare function decodeTexelRaw(bytes: Uint8Array, format: string, width: number, height: number, texelX: number, texelY: number): [number, number, number, number] | null;
+//# sourceMappingURL=texel-decode.d.ts.map

package/dist/texel-decode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"texel-decode.d.ts","sourceRoot":"","sources":["../src/texel-decode.ts"],"names":[],"mappings":"AAqBA,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAe7C;AA8GD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,KAAK,GAAG,YAAY,GAAG,cAAsB,GACpD,iBAAiB,CAAC,WAAW,CAAC,GAAG,IAAI,CAuCvC;AA+BD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CA4BzC"}

package/dist/texel-layout.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Bytes per texel for uncompressed color formats. Block-compressed formats use
+ * {@link textureBlockLayout} because their bytes are addressed by blocks.
+ */
+export declare function bytesPerTexel(format: GPUTextureFormat | undefined): number | undefined;
+export interface TextureBlockLayout {
+    readonly blockWidth: number;
+    readonly blockHeight: number;
+    readonly bytesPerBlock: number;
+}
+/** Return the WebGPU texel-block footprint for each supported color format. */
+export declare function textureBlockLayout(format: GPUTextureFormat | undefined): TextureBlockLayout | undefined;
+/** How a channel's bits are interpreted (drives the host-side decode-to-RGBA8). */
+export type ChannelType = 'unorm' | 'snorm' | 'uint' | 'sint' | 'float' | 'ufloat';
+/**
+ * Per-channel layout of an uncompressed color format, enough to decode its raw
+ * GPU bytes into displayable RGBA8 on the host (no GPU). Sits beside
+ * {@link bytesPerTexel} (which stays the SSOT for total texel size); the
+ * per-channel byte width is derived as `bytesPerTexel / channels` for plain
+ * formats, so no byte count is re-stored here. `packed` formats pack all
+ * channels into a single 4-byte word (channels read by bit-field, not by a
+ * uniform per-channel width).
+ */
+export interface FormatInfo {
+    readonly channels: 1 | 2 | 3 | 4;
+    readonly channelType: ChannelType;
+    /** Channels stored blue-first in memory (swizzle B<->R when decoding). */
+    readonly bgra?: boolean;
+    /** Bit-packed layout (channels share one 32-bit word) needing special unpack. */
+    readonly packed?: 'rgb10a2unorm' | 'rg11b10ufloat';
+}
+/**
+ * Per-channel layout of an uncompressed color format for host-side decode.
+ * Returns `undefined` for depth/stencil, block-compressed, or unknown formats
+ * (the viewer's preview path treats `undefined` as "not directly previewable").
+ */
+export declare function formatInfo(format: GPUTextureFormat | string | undefined): FormatInfo | undefined;
+/** One mip level of one array layer: its extent + where its tight bytes live in the blob. */
+export interface SubresourceSlice {
+    readonly layer: number;
+    readonly mip: number;
+    readonly width: number;
+    readonly height: number;
+    readonly byteOffset: number;
+    readonly byteLength: number;
+}
+/** Full subresource layout of a texture snapshot blob. */
+export interface TextureLayout {
+    readonly blockWidth: number;
+    readonly blockHeight: number;
+    readonly bytesPerBlock: number;
+    readonly layerCount: number;
+    readonly mipLevelCount: number;
+    readonly slices: readonly SubresourceSlice[];
+    /** Total tight byte length across every subresource (the blob size). */
+    readonly totalBytes: number;
+}
+export interface TextureExtent {
+    readonly width: number;
+    readonly height: number;
+    readonly layerCount: number;
+}
+/** Project a serialized GPU texture extent onto the dimensions used by snapshots. */
+export declare function projectTextureExtent(size: unknown): TextureExtent;
+/**
+ * Compute the canonical tight byte layout for a texture snapshot: every array
+ * layer, every mip level, packed in layer-major then mip-minor order with no row
+ * padding (tight bytesPerRow = blockCountX * bytesPerBlock). Mip dimensions halve
+ * per level (floor, min 1), matching the WebGPU mip size rule.
+ *
+ * Returns `undefined` when the format has no known block footprint. The
+ * recorder reads each slice into this exact offset; the replayer reads each
+ * slice back out and writeTexture's it to (layer, mip).
+ */
+export declare function computeTextureLayout(format: GPUTextureFormat | undefined, width: number, height: number, layerCount: number, mipLevelCount: number): TextureLayout | undefined;
+//# sourceMappingURL=texel-layout.d.ts.map

package/dist/texel-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"texel-layout.d.ts","sourceRoot":"","sources":["../src/texel-layout.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGtF;AA8CD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AA4DD,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,gBAAgB,GAAG,SAAS,GACnC,kBAAkB,GAAG,SAAS,CAQhC;AAMD,mFAAmF;AACnF,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEnF;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,iFAAiF;IACjF,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,eAAe,CAAC;CACpD;AA8CD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAGhG;AAED,6FAA6F;AAC7F,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,wEAAwE;IACxE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,qFAAqF;AACrF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,CAqBjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,gBAAgB,GAAG,SAAS,EACpC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,aAAa,GAAG,SAAS,CA4B3B"}