webcodecs-node 0.5.2 → 0.7.1

package/dist/polyfills/OffscreenCanvas.js

@@ -1,35 +1,235 @@
 /**
- * OffscreenCanvas polyfill for Node.js using sharp
+ * OffscreenCanvas Polyfill using skia-canvas
  *
- * This provides a minimal implementation of OffscreenCanvas and CanvasRenderingContext2D
- * sufficient for Mediabunny's video frame processing needs.
+ * Provides a Web-compatible OffscreenCanvas API for Node.js,
+ * making it easy to port browser code to Node.js.
+ *
+ * skia-canvas provides:
+ * - Metal acceleration on macOS
+ * - Vulkan acceleration on Linux/Windows
+ * - Automatic CPU fallback
+ */
+import { Canvas as SkiaCanvas } from 'skia-canvas';
+import { VideoFrame } from '../core/VideoFrame.js';
+/**
+ * ImageData polyfill compatible with skia-canvas
  */
-// Re-export all polyfill classes
-export { ImageDataPolyfill } from './ImageDataPolyfill.js';
-export { OffscreenCanvasRenderingContext2DPolyfill } from './CanvasRenderingContext2DPolyfill.js';
-export { OffscreenCanvasPolyfill } from './OffscreenCanvasPolyfill.js';
-export { VideoFramePolyfill } from './VideoFramePolyfill.js';
-// Import for global installation
-import { ImageDataPolyfill } from './ImageDataPolyfill.js';
-import { OffscreenCanvasRenderingContext2DPolyfill } from './CanvasRenderingContext2DPolyfill.js';
-import { OffscreenCanvasPolyfill } from './OffscreenCanvasPolyfill.js';
-import { VideoFramePolyfill } from './VideoFramePolyfill.js';
+export class ImageDataPolyfill {
+    data;
+    width;
+    height;
+    colorSpace = 'srgb';
+    colorType = 'rgba'; // Required by skia-canvas
+    constructor(dataOrWidth, widthOrHeight, height) {
+        if (typeof dataOrWidth === 'number') {
+            this.width = dataOrWidth;
+            this.height = widthOrHeight;
+            this.data = new Uint8ClampedArray(this.width * this.height * 4);
+        }
+        else {
+            this.data = dataOrWidth;
+            this.width = widthOrHeight;
+            this.height = height ?? dataOrWidth.length / 4 / widthOrHeight;
+        }
+    }
+}
+/**
+ * Blob polyfill for convertToBlob
+ */
+class BlobPolyfill {
+    _buffer;
+    type;
+    size;
+    constructor(buffer, type) {
+        this._buffer = buffer;
+        this.type = type;
+        this.size = buffer.length;
+    }
+    async arrayBuffer() {
+        return this._buffer.buffer.slice(this._buffer.byteOffset, this._buffer.byteOffset + this._buffer.byteLength);
+    }
+    async text() {
+        return this._buffer.toString('utf-8');
+    }
+    stream() {
+        const buffer = this._buffer;
+        return new ReadableStream({
+            start(controller) {
+                controller.enqueue(new Uint8Array(buffer));
+                controller.close();
+            },
+        });
+    }
+    slice(start, end, contentType) {
+        const sliced = this._buffer.slice(start, end);
+        return new BlobPolyfill(sliced, contentType ?? this.type);
+    }
+}
+/**
+ * OffscreenCanvas Polyfill
+ *
+ * Provides a Web-compatible OffscreenCanvas API using skia-canvas.
+ * This makes it easy to port browser canvas code to Node.js.
+ *
+ * @example
+ * ```typescript
+ * const canvas = new OffscreenCanvasPolyfill(1920, 1080);
+ * const ctx = canvas.getContext('2d');
+ * ctx.fillStyle = 'red';
+ * ctx.fillRect(0, 0, 1920, 1080);
+ *
+ * // Create VideoFrame for encoding
+ * const frame = new VideoFrame(canvas, { timestamp: 0 });
+ * ```
+ */
+export class OffscreenCanvasPolyfill {
+    _canvas;
+    _ctx = null;
+    /**
+     * Create a new OffscreenCanvas with the specified dimensions
+     */
+    constructor(width, height) {
+        this._canvas = new SkiaCanvas(width, height);
+    }
+    /**
+     * Get the width of the canvas
+     */
+    get width() {
+        return this._canvas.width;
+    }
+    /**
+     * Set the width of the canvas (creates new internal canvas)
+     */
+    set width(value) {
+        const height = this._canvas.height;
+        this._canvas = new SkiaCanvas(value, height);
+        this._ctx = null;
+    }
+    /**
+     * Get the height of the canvas
+     */
+    get height() {
+        return this._canvas.height;
+    }
+    /**
+     * Set the height of the canvas (creates new internal canvas)
+     */
+    set height(value) {
+        const width = this._canvas.width;
+        this._canvas = new SkiaCanvas(width, value);
+        this._ctx = null;
+    }
+    getContext(contextId, options) {
+        if (contextId === '2d') {
+            if (!this._ctx) {
+                this._ctx = this._canvas.getContext('2d');
+            }
+            return this._ctx;
+        }
+        // WebGL not supported
+        return null;
+    }
+    /**
+     * Convert canvas content to a Blob
+     *
+     * @param options - Optional encoding options
+     * @returns Promise resolving to a Blob containing the image data
+     */
+    async convertToBlob(options) {
+        const type = options?.type ?? 'image/png';
+        const quality = options?.quality ?? 0.92;
+        let format;
+        let mimeType;
+        if (type === 'image/jpeg' || type === 'image/jpg') {
+            format = 'jpg';
+            mimeType = 'image/jpeg';
+        }
+        else if (type === 'image/webp') {
+            format = 'webp';
+            mimeType = 'image/webp';
+        }
+        else {
+            format = 'png';
+            mimeType = 'image/png';
+        }
+        const buffer = await this._canvas.toBuffer(format, {
+            quality,
+        });
+        return new BlobPolyfill(buffer, mimeType);
+    }
+    /**
+     * Transfer canvas content to an ImageBitmap
+     *
+     * Note: This creates a copy of the pixel data, as true zero-copy
+     * transfer is not possible in Node.js the same way as in browsers.
+     *
+     * @returns ImageBitmap-like object with the canvas content
+     */
+    transferToImageBitmap() {
+        const pixels = this._getImageData();
+        return {
+            width: this._canvas.width,
+            height: this._canvas.height,
+            _data: pixels,
+            close: () => {
+                // No-op in Node.js
+            },
+        };
+    }
+    /**
+     * Get raw RGBA pixel data from canvas
+     * (Internal method for VideoFrame construction)
+     */
+    _getImageData() {
+        const buffer = this._canvas.toBufferSync('raw', {
+            colorType: 'rgba',
+        });
+        return new Uint8ClampedArray(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+    }
+    /**
+     * Get the underlying skia-canvas Canvas
+     * (Non-standard, for advanced use cases)
+     */
+    get _skiaCanvas() {
+        return this._canvas;
+    }
+    /**
+     * Enable/disable GPU acceleration
+     * (Non-standard, for performance tuning)
+     */
+    get gpu() {
+        return this._canvas.gpu;
+    }
+    set gpu(value) {
+        this._canvas.gpu = value;
+    }
+}
+// Re-export core VideoFrame as VideoFramePolyfill for compatibility
+export { VideoFrame as VideoFramePolyfill };
 /**
  * Install the OffscreenCanvas polyfill globally
+ *
+ * This makes OffscreenCanvas available as a global, matching browser behavior.
+ *
+ * @example
+ * ```typescript
+ * import { installOffscreenCanvasPolyfill } from 'webcodecs-node';
+ * installOffscreenCanvasPolyfill();
+ *
+ * // Now you can use OffscreenCanvas like in a browser
+ * const canvas = new OffscreenCanvas(1920, 1080);
+ * ```
  */
 export function installOffscreenCanvasPolyfill() {
     const g = globalThis;
     if (typeof g.OffscreenCanvas === 'undefined') {
         g.OffscreenCanvas = OffscreenCanvasPolyfill;
     }
-    if (typeof g.OffscreenCanvasRenderingContext2D === 'undefined') {
-        g.OffscreenCanvasRenderingContext2D = OffscreenCanvasRenderingContext2DPolyfill;
-    }
     if (typeof g.ImageData === 'undefined') {
         g.ImageData = ImageDataPolyfill;
     }
     if (typeof g.VideoFrame === 'undefined') {
-        g.VideoFrame = VideoFramePolyfill;
+        g.VideoFrame = VideoFrame;
     }
 }
 //# sourceMappingURL=OffscreenCanvas.js.map

package/dist/polyfills/OffscreenCanvas.js.map

@@ -1 +1 @@
-{"version":3,"file":"OffscreenCanvas.js","sourceRoot":"","sources":["../../src/polyfills/OffscreenCanvas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,iCAAiC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,yCAAyC,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,iCAAiC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,yCAAyC,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;GAEG;AACH,MAAM,UAAU,8BAA8B;IAC5C,MAAM,CAAC,GAAG,UAAqC,CAAC;IAChD,IAAI,OAAO,CAAC,CAAC,eAAe,KAAK,WAAW,EAAE,CAAC;QAC7C,CAAC,CAAC,eAAe,GAAG,uBAAuB,CAAC;IAC9C,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,iCAAiC,KAAK,WAAW,EAAE,CAAC;QAC/D,CAAC,CAAC,iCAAiC,GAAG,yCAAyC,CAAC;IAClF,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,WAAW,EAAE,CAAC;QACvC,CAAC,CAAC,SAAS,GAAG,iBAAiB,CAAC;IAClC,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,WAAW,EAAE,CAAC;QACxC,CAAC,CAAC,UAAU,GAAG,kBAAkB,CAAC;IACpC,CAAC;AACH,CAAC"}
+{"version":3,"file":"OffscreenCanvas.js","sourceRoot":"","sources":["../../src/polyfills/OffscreenCanvas.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -5,4 +5,5 @@ export { type BufferSource, DOMException, type CodecState, type HardwareAccelera
 export { type DOMRectInit, DOMRectReadOnly, type PlaneLayout, } from './geometry.js';
 export { type VideoPixelFormat, type VideoFrameBufferInit, type VideoFrameInit, type VideoFrameCopyToOptions, } from './video.js';
 export { type AudioSampleFormat, type AudioDataInit, type AudioDataCopyToOptions, } from './audio.js';
+export { type NativeFrame, type NativeVideoFrame, type NativeAudioFrame, isNativeFrame, hasUnref, hasClone, } from './native-frame.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,KAAK,YAAY,EACjB,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,KAAK,WAAW,EAChB,eAAe,EACf,KAAK,WAAW,GACjB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,uBAAuB,GAC7B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,sBAAsB,GAC5B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,KAAK,YAAY,EACjB,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,KAAK,WAAW,EAChB,eAAe,EACf,KAAK,WAAW,GACjB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,uBAAuB,GAC7B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,sBAAsB,GAC5B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,aAAa,EACb,QAAQ,EACR,QAAQ,GACT,MAAM,mBAAmB,CAAC"}

package/dist/types/index.js

@@ -5,4 +5,6 @@
 export { DOMException, } from './common.js';
 // Geometry types
 export { DOMRectReadOnly, } from './geometry.js';
+// Native frame types (for node-av integration)
+export { isNativeFrame, hasUnref, hasClone, } from './native-frame.js';
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAe;AACf,OAAO,EAEL,YAAY,GAQb,MAAM,aAAa,CAAC;AAErB,iBAAiB;AACjB,OAAO,EAEL,eAAe,GAEhB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAe;AACf,OAAO,EAEL,YAAY,GAQb,MAAM,aAAa,CAAC;AAErB,iBAAiB;AACjB,OAAO,EAEL,eAAe,GAEhB,MAAM,eAAe,CAAC;AAiBvB,+CAA+C;AAC/C,OAAO,EAIL,aAAa,EACb,QAAQ,EACR,QAAQ,GACT,MAAM,mBAAmB,CAAC"}

package/dist/types/native-frame.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Native frame interface for node-av integration
+ *
+ * Represents a native (non-JavaScript) audio or video frame from the node-av backend.
+ * These frames hold references to native memory that must be properly released.
+ */
+/**
+ * Base interface for native frames from node-av
+ */
+export interface NativeFrame {
+    /**
+     * Convert the native frame data to a JavaScript Buffer.
+     * For video frames, returns raw pixel data.
+     * For audio frames, returns raw PCM samples.
+     */
+    toBuffer(): Buffer;
+    /**
+     * Release the native resources associated with this frame.
+     * Should be called when the frame is no longer needed.
+     * Some implementations may not have this method (returns undefined).
+     */
+    unref?(): void;
+    /**
+     * Create a clone of this native frame.
+     * Returns a new frame with its own native resources.
+     * Some implementations may not support cloning.
+     */
+    clone?(): NativeFrame;
+}
+/**
+ * Native video frame with additional video-specific properties
+ */
+export interface NativeVideoFrame extends NativeFrame {
+    /** Frame width in pixels */
+    readonly width?: number;
+    /** Frame height in pixels */
+    readonly height?: number;
+    /** Pixel format (e.g., 'yuv420p', 'rgba') */
+    readonly format?: string;
+}
+/**
+ * Native audio frame with additional audio-specific properties
+ */
+export interface NativeAudioFrame extends NativeFrame {
+    /** Number of audio samples per channel */
+    readonly nbSamples?: number;
+    /** Sample rate in Hz */
+    readonly sampleRate?: number;
+    /** Number of audio channels */
+    readonly channels?: number;
+    /** Sample format (e.g., 'fltp', 's16') */
+    readonly format?: string;
+}
+/**
+ * Type guard to check if an object is a NativeFrame
+ *
+ * A NativeFrame must have both toBuffer() and unref() methods.
+ * This distinguishes it from objects like skia-canvas Canvas which
+ * have toBuffer() but are not native frames from node-av.
+ */
+export declare function isNativeFrame(obj: unknown): obj is NativeFrame;
+/**
+ * Type guard to check if a NativeFrame has unref capability
+ */
+export declare function hasUnref(frame: NativeFrame): frame is NativeFrame & {
+    unref(): void;
+};
+/**
+ * Type guard to check if a NativeFrame has clone capability
+ */
+export declare function hasClone(frame: NativeFrame): frame is NativeFrame & {
+    clone(): NativeFrame;
+};
+//# sourceMappingURL=native-frame.d.ts.map

package/dist/types/native-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-frame.d.ts","sourceRoot":"","sources":["../../src/types/native-frame.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,QAAQ,IAAI,MAAM,CAAC;IAEnB;;;;OAIG;IACH,KAAK,CAAC,IAAI,IAAI,CAAC;IAEf;;;;OAIG;IACH,KAAK,CAAC,IAAI,WAAW,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,wBAAwB;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW,CAO9D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,KAAK,IAAI,WAAW,GAAG;IAAE,KAAK,IAAI,IAAI,CAAA;CAAE,CAErF;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,KAAK,IAAI,WAAW,GAAG;IAAE,KAAK,IAAI,WAAW,CAAA;CAAE,CAE5F"}

package/dist/types/native-frame.js

@@ -0,0 +1,32 @@
+/**
+ * Native frame interface for node-av integration
+ *
+ * Represents a native (non-JavaScript) audio or video frame from the node-av backend.
+ * These frames hold references to native memory that must be properly released.
+ */
+/**
+ * Type guard to check if an object is a NativeFrame
+ *
+ * A NativeFrame must have both toBuffer() and unref() methods.
+ * This distinguishes it from objects like skia-canvas Canvas which
+ * have toBuffer() but are not native frames from node-av.
+ */
+export function isNativeFrame(obj) {
+    return Boolean(obj &&
+        typeof obj === 'object' &&
+        typeof obj.toBuffer === 'function' &&
+        typeof obj.unref === 'function');
+}
+/**
+ * Type guard to check if a NativeFrame has unref capability
+ */
+export function hasUnref(frame) {
+    return typeof frame.unref === 'function';
+}
+/**
+ * Type guard to check if a NativeFrame has clone capability
+ */
+export function hasClone(frame) {
+    return typeof frame.clone === 'function';
+}
+//# sourceMappingURL=native-frame.js.map

package/dist/types/native-frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-frame.js","sourceRoot":"","sources":["../../src/types/native-frame.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsDH;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,OAAO,OAAO,CACZ,GAAG;QACH,OAAO,GAAG,KAAK,QAAQ;QACvB,OAAQ,GAAmB,CAAC,QAAQ,KAAK,UAAU;QACnD,OAAQ,GAAmB,CAAC,KAAK,KAAK,UAAU,CACjD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAkB;IACzC,OAAO,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAkB;IACzC,OAAO,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU,CAAC;AAC3C,CAAC"}

package/dist/utils/codec-validation.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Codec string validation according to WebCodecs specification
+ *
+ * The WebCodecs spec requires strict validation of codec strings:
+ * - Case-sensitive matching
+ * - Fully qualified codec strings (no ambiguous "vp9", must be "vp09.xx.xx.xx")
+ * - Valid profile/level parameters
+ *
+ * @see https://www.w3.org/TR/webcodecs-codec-registry/
+ */
+export interface CodecValidationResult {
+    valid: boolean;
+    supported: boolean;
+    error?: string;
+}
+/**
+ * Validate a video codec string according to WebCodecs spec
+ *
+ * Returns { valid: true, supported: true } for valid, supported codecs
+ * Returns { valid: true, supported: false } for valid but unsupported codecs
+ * Returns { valid: false, supported: false } for invalid codec strings
+ */
+export declare function validateVideoCodec(codec: string): CodecValidationResult;
+/**
+ * Check if a codec config is valid (should throw TypeError if invalid)
+ * This checks for missing/empty required fields
+ */
+export declare function validateVideoDecoderConfig(config: unknown): void;
+/**
+ * Check if an encoder config is valid (should throw TypeError if invalid)
+ */
+export declare function validateVideoEncoderConfig(config: unknown): void;
+//# sourceMappingURL=codec-validation.d.ts.map

package/dist/utils/codec-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec-validation.d.ts","sourceRoot":"","sources":["../../src/utils/codec-validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,CA0DvE;AAyJD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAchE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CA+ChE"}