@asciiz/atoolkit 0.1.0

package/dist/awgpu/target.d.ts

@@ -0,0 +1,98 @@
+import { type Device } from "./device.js";
+import { Texture } from "./memory.js";
+export interface ColorTargetDesc {
+    target: GPUTextureView | Texture | null;
+    clearColor?: GPUColor;
+    loadOp?: GPULoadOp;
+    storeOp?: GPUStoreOp;
+    resolveTarget?: GPUTextureView | Texture | null;
+}
+export interface DepthTargetDesc {
+    target: GPUTextureView | Texture;
+    depthClearValue?: number;
+    depthLoadOp?: GPULoadOp;
+    depthStoreOp?: GPUStoreOp;
+    stencilClearValue?: number;
+    stencilLoadOp?: GPULoadOp;
+    stencilStoreOp?: GPUStoreOp;
+}
+/**
+ * Coordinates render destination attachments (swapchain, offscreen MRT, depth-only).
+ * Automatically synchronizes canvas swapchain resizing and caches GPURenderPassDescriptor.
+ * Supports MSAA color resolve directly to canvas swapchain backbuffers.
+ */
+export declare class Target {
+    readonly label: string;
+    readonly isScreen: boolean;
+    readonly sampleCount: number;
+    device?: Device;
+    width: number;
+    height: number;
+    colorTargets: ColorTargetDesc[];
+    depthTarget?: DepthTargetDesc;
+    colorFormat?: GPUTextureFormat;
+    depthFormat?: GPUTextureFormat;
+    readonly colorTextures: Texture[];
+    private _cachedDescriptor?;
+    private _cachedColorAttachments;
+    private _cachedDepthStencilAttachment?;
+    private _depthTexture?;
+    private _msaaColorTexture?;
+    private _colorFormats;
+    constructor(label: string, width: number, height: number, options?: {
+        isScreen?: boolean;
+        device?: Device;
+        colorTargets?: ColorTargetDesc[];
+        depthTarget?: DepthTargetDesc;
+        colorFormat?: GPUTextureFormat;
+        depthFormat?: GPUTextureFormat;
+        sampleCount?: number;
+    });
+    /**
+     * Invalidates the cached GPURenderPassDescriptor and internal attachment caches.
+     * Call after directly mutating colorTargets or depthTarget to force descriptor rebuild.
+     */
+    invalidateCache(): void;
+    /**
+     * Updates color attachment at index and invalidates descriptor cache.
+     */
+    setColorTarget(index: number, desc: ColorTargetDesc): void;
+    /**
+     * Updates depth attachment and invalidates descriptor cache.
+     */
+    setDepthTarget(desc: DepthTargetDesc | undefined): void;
+    /**
+     * Factory: Creates render target bound to canvas presentation swapchain.
+     * Supports multisample anti-aliasing (MSAA) with automatic swapchain resolve target.
+     * Pass depthFormat: null to create pure color pass omitting depth buffers.
+     */
+    static createScreen(device: Device, options?: {
+        depthFormat?: GPUTextureFormat | null;
+        clearColor?: GPUColor;
+        sampleCount?: number;
+        label?: string;
+    }): Target;
+    /**
+     * Factory: Creates offscreen color and optional depth render target (RTT).
+     * Managed color textures are accessible via colorTextures[] for downstream binding
+     * as sampled inputs in subsequent passes.
+     */
+    static createOffscreen(device: Device | GPUDevice, desc: {
+        width: number;
+        height: number;
+        colorFormats?: GPUTextureFormat[];
+        depthFormat?: GPUTextureFormat;
+        label?: string;
+    }): Target;
+    /**
+     * Synchronizes attachments and returns cached GPURenderPassDescriptor.
+     * Mutates pre-allocated attachment objects in-place to ensure zero heap allocations in hot paths.
+     */
+    getDescriptor(): GPURenderPassDescriptor;
+    /**
+     * Resizes internal attachment textures when dimensions change.
+     * Handles both screen depth/MSAA buffers and offscreen color + depth textures.
+     */
+    resize(device: Device | GPUDevice, width: number, height: number): void;
+}
+//# sourceMappingURL=target.d.ts.map

package/dist/awgpu/target.d.ts.map

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

package/dist/awgpu/target.js

@@ -0,0 +1,357 @@
+// ================================================================
+//  Awgpu - Level 2: Render Destination Coordinator (Target)
+// ================================================================
+import { Texture, resolveTextureView } from "./memory.js";
+/**
+ * Coordinates render destination attachments (swapchain, offscreen MRT, depth-only).
+ * Automatically synchronizes canvas swapchain resizing and caches GPURenderPassDescriptor.
+ * Supports MSAA color resolve directly to canvas swapchain backbuffers.
+ */
+export class Target {
+    label;
+    isScreen;
+    sampleCount;
+    device;
+    width;
+    height;
+    // Color and depth attachment descriptors. Mutate via setColorTarget / setDepthTarget
+    // to guarantee cache invalidation; or call invalidateCache() after direct mutation.
+    colorTargets = [];
+    depthTarget;
+    colorFormat;
+    depthFormat;
+    // Managed textures created by createOffscreen. Exposed for downstream sampling.
+    colorTextures = [];
+    _cachedDescriptor;
+    _cachedColorAttachments = [];
+    _cachedDepthStencilAttachment;
+    _depthTexture;
+    _msaaColorTexture;
+    _colorFormats = [];
+    constructor(label, width, height, options = {}) {
+        this.label = label;
+        this.width = width;
+        this.height = height;
+        this.isScreen = options.isScreen ?? false;
+        this.sampleCount = options.sampleCount ?? 1;
+        this.device = options.device;
+        this.colorTargets = options.colorTargets ?? [];
+        this.depthTarget = options.depthTarget;
+        this.colorFormat = options.colorFormat;
+        this.depthFormat = options.depthFormat;
+    }
+    /**
+     * Invalidates the cached GPURenderPassDescriptor and internal attachment caches.
+     * Call after directly mutating colorTargets or depthTarget to force descriptor rebuild.
+     */
+    invalidateCache() {
+        this._cachedDescriptor = undefined;
+        this._cachedColorAttachments.length = 0;
+        this._cachedDepthStencilAttachment = undefined;
+    }
+    /**
+     * Updates color attachment at index and invalidates descriptor cache.
+     */
+    setColorTarget(index, desc) {
+        this.colorTargets[index] = desc;
+        this.invalidateCache();
+    }
+    /**
+     * Updates depth attachment and invalidates descriptor cache.
+     */
+    setDepthTarget(desc) {
+        this.depthTarget = desc;
+        this.invalidateCache();
+    }
+    /**
+     * Factory: Creates render target bound to canvas presentation swapchain.
+     * Supports multisample anti-aliasing (MSAA) with automatic swapchain resolve target.
+     * Pass depthFormat: null to create pure color pass omitting depth buffers.
+     */
+    static createScreen(device, options = {}) {
+        const canvas = device.canvas;
+        const w = Math.max(1, canvas ? canvas.width : 1);
+        const h = Math.max(1, canvas ? canvas.height : 1);
+        const hasDepth = options.depthFormat !== null;
+        const depthFormat = hasDepth ? (options.depthFormat ?? "depth24plus") : undefined;
+        const clearColor = options.clearColor ?? { r: 0.0, g: 0.0, b: 0.0, a: 1.0 };
+        const label = options.label ?? "ScreenTarget";
+        const sampleCount = options.sampleCount ?? 1;
+        let msaaColorTex;
+        let colorDesc;
+        if (sampleCount > 1) {
+            msaaColorTex = Texture.create2D(device, {
+                width: w,
+                height: h,
+                format: device.format,
+                sampleCount,
+                label: `${label}_MSAAColor`,
+            });
+            colorDesc = {
+                target: msaaColorTex,
+                resolveTarget: null,
+                clearColor,
+                loadOp: "clear",
+                storeOp: "discard",
+            };
+        }
+        else {
+            colorDesc = {
+                target: null,
+                clearColor,
+                loadOp: "clear",
+                storeOp: "store",
+            };
+        }
+        let depthTarget;
+        let depthTex;
+        if (depthFormat) {
+            depthTex = Texture.createDepth(device, {
+                width: w,
+                height: h,
+                format: depthFormat,
+                sampleCount,
+                label: `${label}_Depth`,
+            });
+            depthTarget = {
+                target: depthTex,
+                depthClearValue: 1.0,
+                depthLoadOp: "clear",
+                depthStoreOp: "store",
+            };
+        }
+        const target = new Target(label, w, h, {
+            isScreen: true,
+            device,
+            colorTargets: [colorDesc],
+            depthTarget,
+            colorFormat: device.format,
+            depthFormat,
+            sampleCount,
+        });
+        target._depthTexture = depthTex;
+        target._msaaColorTexture = msaaColorTex;
+        return target;
+    }
+    /**
+     * Factory: Creates offscreen color and optional depth render target (RTT).
+     * Managed color textures are accessible via colorTextures[] for downstream binding
+     * as sampled inputs in subsequent passes.
+     */
+    static createOffscreen(device, desc) {
+        const w = Math.max(1, desc.width);
+        const h = Math.max(1, desc.height);
+        const label = desc.label ?? "OffscreenTarget";
+        const formats = desc.colorFormats ?? ["rgba8unorm"];
+        const textures = [];
+        const colorTargets = new Array(formats.length);
+        for (let i = 0; i < formats.length; i++) {
+            const tex = Texture.create2D(device, {
+                width: w,
+                height: h,
+                format: formats[i],
+                label: `${label}_Color${i}`,
+            });
+            textures.push(tex);
+            colorTargets[i] = {
+                target: tex,
+                clearColor: { r: 0, g: 0, b: 0, a: 1 },
+                loadOp: "clear",
+                storeOp: "store",
+            };
+        }
+        let depthTarget;
+        let depthTex;
+        if (desc.depthFormat) {
+            depthTex = Texture.createDepth(device, {
+                width: w,
+                height: h,
+                format: desc.depthFormat,
+                label: `${label}_Depth`,
+            });
+            depthTarget = {
+                target: depthTex,
+                depthClearValue: 1.0,
+                depthLoadOp: "clear",
+                depthStoreOp: "store",
+            };
+        }
+        const target = new Target(label, w, h, {
+            isScreen: false,
+            colorTargets,
+            depthTarget,
+            colorFormat: formats[0],
+            depthFormat: desc.depthFormat,
+        });
+        target._depthTexture = depthTex;
+        // Populate managed texture list and format record for resize support.
+        for (const tex of textures) {
+            target.colorTextures.push(tex);
+        }
+        target._colorFormats = formats.slice();
+        return target;
+    }
+    /**
+     * Synchronizes attachments and returns cached GPURenderPassDescriptor.
+     * Mutates pre-allocated attachment objects in-place to ensure zero heap allocations in hot paths.
+     */
+    getDescriptor() {
+        if (this.isScreen && this.device && this.device.canvas) {
+            const cw = this.device.canvas.width;
+            const ch = this.device.canvas.height;
+            if (this.width !== cw || this.height !== ch) {
+                this.resize(this.device, cw, ch);
+            }
+        }
+        const colorCount = this.colorTargets.length;
+        if (!this._cachedDescriptor || this._cachedColorAttachments.length !== colorCount) {
+            this._cachedColorAttachments = new Array(colorCount);
+            for (let i = 0; i < colorCount; i++) {
+                this._cachedColorAttachments[i] = {
+                    view: null,
+                    clearValue: { r: 0, g: 0, b: 0, a: 1 },
+                    loadOp: "clear",
+                    storeOp: "store",
+                };
+            }
+            if (this.depthTarget) {
+                this._cachedDepthStencilAttachment = {
+                    view: null,
+                    depthClearValue: 1.0,
+                    depthLoadOp: "clear",
+                    depthStoreOp: "store",
+                };
+            }
+            else {
+                this._cachedDepthStencilAttachment = undefined;
+            }
+            this._cachedDescriptor = {
+                label: `${this.label}_PassDescriptor`,
+                colorAttachments: this._cachedColorAttachments,
+                depthStencilAttachment: this._cachedDepthStencilAttachment,
+            };
+        }
+        for (let i = 0; i < colorCount; i++) {
+            const cfg = this.colorTargets[i];
+            const att = this._cachedColorAttachments[i];
+            if (cfg.target === null) {
+                if (!this.device || !this.device.context) {
+                    throw new Error("Cannot render to swapchain: Device canvas context is unconfigured.");
+                }
+                att.view = this.device.context.getCurrentTexture().createView();
+            }
+            else {
+                att.view = resolveTextureView(cfg.target);
+            }
+            att.clearValue = cfg.clearColor ?? { r: 0, g: 0, b: 0, a: 1 };
+            att.loadOp = cfg.loadOp ?? "clear";
+            att.storeOp = cfg.storeOp ?? "store";
+            if (cfg.resolveTarget === null) {
+                if (!this.device || !this.device.context) {
+                    throw new Error("Cannot resolve to swapchain: Device canvas context is unconfigured.");
+                }
+                att.resolveTarget = this.device.context.getCurrentTexture().createView();
+            }
+            else if (cfg.resolveTarget !== undefined) {
+                att.resolveTarget = resolveTextureView(cfg.resolveTarget);
+            }
+            else {
+                att.resolveTarget = undefined;
+            }
+        }
+        if (this.depthTarget) {
+            if (!this._cachedDepthStencilAttachment) {
+                this._cachedDepthStencilAttachment = {
+                    view: null,
+                    depthClearValue: 1.0,
+                    depthLoadOp: "clear",
+                    depthStoreOp: "store",
+                };
+                this._cachedDescriptor.depthStencilAttachment = this._cachedDepthStencilAttachment;
+            }
+            const ds = this._cachedDepthStencilAttachment;
+            ds.view = resolveTextureView(this.depthTarget.target);
+            ds.depthClearValue = this.depthTarget.depthClearValue ?? 1.0;
+            ds.depthLoadOp = this.depthTarget.depthLoadOp ?? "clear";
+            ds.depthStoreOp = this.depthTarget.depthStoreOp ?? "store";
+            ds.stencilClearValue = this.depthTarget.stencilClearValue;
+            ds.stencilLoadOp = this.depthTarget.stencilLoadOp;
+            ds.stencilStoreOp = this.depthTarget.stencilStoreOp;
+        }
+        else if (this._cachedDescriptor.depthStencilAttachment) {
+            this._cachedDescriptor.depthStencilAttachment = undefined;
+            this._cachedDepthStencilAttachment = undefined;
+        }
+        return this._cachedDescriptor;
+    }
+    /**
+     * Resizes internal attachment textures when dimensions change.
+     * Handles both screen depth/MSAA buffers and offscreen color + depth textures.
+     */
+    resize(device, width, height) {
+        this.width = Math.max(1, width);
+        this.height = Math.max(1, height);
+        if (this.isScreen) {
+            if (this.sampleCount > 1) {
+                if (this._msaaColorTexture) {
+                    this._msaaColorTexture.destroy();
+                }
+                this._msaaColorTexture = Texture.create2D(device, {
+                    width: this.width,
+                    height: this.height,
+                    format: this.colorFormat ?? "rgba8unorm",
+                    sampleCount: this.sampleCount,
+                    label: `${this.label}_MSAAColor`,
+                });
+                this.colorTargets[0] = { ...this.colorTargets[0], target: this._msaaColorTexture };
+            }
+            if (this.depthFormat) {
+                if (this._depthTexture) {
+                    this._depthTexture.destroy();
+                }
+                this._depthTexture = Texture.createDepth(device, {
+                    width: this.width,
+                    height: this.height,
+                    format: this.depthFormat,
+                    sampleCount: this.sampleCount,
+                    label: `${this.label}_Depth`,
+                });
+                if (this.depthTarget) {
+                    this.depthTarget.target = this._depthTexture;
+                }
+            }
+        }
+        else if (!this.isScreen) {
+            // Offscreen target: reallocate all managed color textures.
+            for (let i = 0; i < this.colorTextures.length; i++) {
+                this.colorTextures[i].destroy();
+                const tex = Texture.create2D(device, {
+                    width: this.width,
+                    height: this.height,
+                    format: this._colorFormats[i] ?? "rgba8unorm",
+                    label: `${this.label}_Color${i}`,
+                });
+                this.colorTextures[i] = tex;
+                this.colorTargets[i] = { ...this.colorTargets[i], target: tex };
+            }
+            // Reallocate depth texture for offscreen targets.
+            if (this.depthFormat && this.depthTarget) {
+                if (this._depthTexture) {
+                    this._depthTexture.destroy();
+                }
+                else if (this.depthTarget.target instanceof Texture) {
+                    this.depthTarget.target.destroy();
+                }
+                this._depthTexture = Texture.createDepth(device, {
+                    width: this.width,
+                    height: this.height,
+                    format: this.depthFormat,
+                    label: `${this.label}_Depth`,
+                });
+                this.depthTarget.target = this._depthTexture;
+            }
+        }
+        this.invalidateCache();
+    }
+}
+//# sourceMappingURL=target.js.map

package/dist/awgpu/target.js.map

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

package/dist/awgpu_old/buffer.d.ts

@@ -0,0 +1,78 @@
+export type BufferData = BufferSource | ArrayBufferView | Float32Array | Uint16Array | Uint32Array | Uint8Array | Int32Array | ArrayBuffer;
+/**
+ * GPU buffer wrapper supporting uniform, storage, vertex, and index operations.
+ */
+export declare class Buffer {
+    readonly gpuBuffer: GPUBuffer;
+    readonly size: number;
+    readonly usage: GPUBufferUsageFlags;
+    readonly label: string;
+    readonly gpuOwned: boolean;
+    constructor(gpuBuffer: GPUBuffer, size: number, usage: GPUBufferUsageFlags, options?: {
+        label?: string;
+        gpuOwned?: boolean;
+    });
+    /**
+     * Uploads fresh data to GPU buffer using queue.writeBuffer.
+     */
+    write(device: GPUDevice, data: BufferData, bufferOffset?: number): void;
+    destroy(): void;
+    /**
+     * Creates raw GPU buffer with optional initial data upload.
+     */
+    static create(device: GPUDevice, options: {
+        size: number;
+        usage: GPUBufferUsageFlags;
+        data?: BufferData;
+        label?: string;
+    }): Buffer;
+    /**
+     * Creates uniform buffer with automatic 16-byte minimum alignment.
+     */
+    static createUniform(device: GPUDevice, sizeOrData: number | BufferData, label?: string): Buffer;
+    /**
+     * Creates storage buffer with read-only or read-write usage.
+     */
+    static createStorage(device: GPUDevice, sizeOrData: number | BufferData, options?: {
+        readOnly?: boolean;
+        label?: string;
+    }): Buffer;
+    /**
+     * Creates vertex buffer with uploaded vertex data.
+     */
+    static createVertex(device: GPUDevice, dataOrSize: BufferData | number, label?: string): Buffer;
+    /**
+     * Creates index buffer with uploaded index data.
+     */
+    static createIndex(device: GPUDevice, dataOrSize: BufferData | number, label?: string): Buffer;
+}
+/**
+ * Reusable GPU buffer pool for dynamic per-frame allocation without destruction thrashing.
+ */
+export declare class BufferPool {
+    private _buckets;
+    private _inUse;
+    private _availableCount;
+    readonly usage: GPUBufferUsageFlags;
+    readonly label: string;
+    constructor(usage: GPUBufferUsageFlags, label?: string);
+    /** Total number of allocated buffers currently managed by pool. */
+    get totalBuffers(): number;
+    /** Number of buffers currently acquired and active in frame. */
+    get inUseCount(): number;
+    private _addToBucket;
+    /**
+     * Resets active allocations at start of frame, returning all buffers to available pool.
+     */
+    reset(): void;
+    /**
+     * Acquires buffer with at least requested byte size using bucketed matching from available pool.
+     */
+    acquire(device: GPUDevice, requiredSize: number): Buffer;
+    /**
+     * Releases an individual buffer back to available pool ahead of frame reset.
+     */
+    release(buffer: Buffer): boolean;
+    destroy(): void;
+}
+//# sourceMappingURL=buffer.d.ts.map

package/dist/awgpu_old/buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../../awgpu_old/buffer.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAChB,YAAY,GACZ,eAAe,GACf,YAAY,GACZ,WAAW,GACX,WAAW,GACX,UAAU,GACV,UAAU,GACV,WAAW,CAAC;AAElB;;GAEG;AACH,qBAAa,MAAM;IACf,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;gBAGvB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,mBAAmB,EAC1B,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAO;IASxD;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,SAAI,GAAG,IAAI;IAclE,OAAO,IAAI,IAAI;IAMf;;OAEG;IACH,MAAM,CAAC,MAAM,CACT,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,mBAAmB,CAAC;QAC3B,IAAI,CAAC,EAAE,UAAU,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,GACF,MAAM;IAmBT;;OAEG;IACH,MAAM,CAAC,aAAa,CAChB,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,GAAG,UAAU,EAC/B,KAAK,SAAkB,GACxB,MAAM;IAaT;;OAEG;IACH,MAAM,CAAC,aAAa,CAChB,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,GAAG,UAAU,EAC/B,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GACrD,MAAM;IAaT;;OAEG;IACH,MAAM,CAAC,YAAY,CACf,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,UAAU,GAAG,MAAM,EAC/B,KAAK,SAAiB,GACvB,MAAM;IAYT;;OAEG;IACH,MAAM,CAAC,WAAW,CACd,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,UAAU,GAAG,MAAM,EAC/B,KAAK,SAAgB,GACtB,MAAM;CAWZ;AAED;;GAEG;AACH,qBAAa,UAAU;IACnB,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,eAAe,CAAK;IAC5B,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,KAAK,EAAE,mBAAmB,EAAE,KAAK,SAAe;IAK5D,mEAAmE;IACnE,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,gEAAgE;IAChE,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;IA6CxD;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAUhC,OAAO,IAAI,IAAI;CAelB"}