webcodecs-node 0.5.1 → 0.7.0

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/index.d.ts

@@ -4,7 +4,7 @@
 export { toUint8Array, copyToUint8Array, concatUint8Arrays, isReadableStream, readStreamToUint8Array, } from './buffer.js';
 export { validatePositiveInteger, validateNonNegativeInteger, validateFiniteNumber, validateRequired, validateNonEmptyString, validateConfigured, validateNotClosed, } from './validation.js';
 export { Logger, createLogger, setDebugMode, isDebugMode, type LogLevel, type LogEntry, } from './logger.js';
-export { isImageDataLike, isCanvasLike, isVideoFrameLike, isCanvasImageSource, type ImageDataLike, type CanvasLike, type VideoFrameLike, } from './type-guards.js';
+export { isImageDataLike, isCanvasLike, isVideoFrameLike, isCanvasImageSource, isSkiaCanvas, extractCanvasPixels, type ImageDataLike, type CanvasLike, type VideoFrameLike, type SkiaCanvasLike, } from './type-guards.js';
 export { parseAvcDecoderConfig, convertAvccToAnnexB, splitAnnexBNals, extractAvcParameterSetsFromAnnexB, buildAvcDecoderConfig, convertAnnexBToAvcc, type AvcConfig, } from './avc.js';
 export { parseHvccDecoderConfig, convertHvccToAnnexB, splitHevcAnnexBNals, extractHevcParameterSetsFromAnnexB, buildHvccDecoderConfig, convertAnnexBToHvcc, type HvccConfig, } from './hevc.js';
 export { parseAudioSpecificConfig, wrapAacFrameWithAdts, buildAudioSpecificConfig, stripAdtsHeader, type AacConfig, } from './aac.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,KAAK,QAAQ,EACb,KAAK,QAAQ,GACd,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,iCAAiC,EACjC,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,SAAS,GACf,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,kCAAkC,EAClC,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,UAAU,GAChB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,eAAe,EACf,KAAK,SAAS,GACf,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,4BAA4B,EAC5B,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,UAAU,EACV,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,KAAK,QAAQ,EACb,KAAK,QAAQ,GACd,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,iCAAiC,EACjC,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,SAAS,GACf,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,kCAAkC,EAClC,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,UAAU,GAChB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,eAAe,EACf,KAAK,SAAS,GACf,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,4BAA4B,EAC5B,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,UAAU,EACV,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC"}

package/dist/utils/index.js

@@ -8,7 +8,7 @@ export { validatePositiveInteger, validateNonNegativeInteger, validateFiniteNumb
 // Logger
 export { Logger, createLogger, setDebugMode, isDebugMode, } from './logger.js';
 // Type guards
-export { isImageDataLike, isCanvasLike, isVideoFrameLike, isCanvasImageSource, } from './type-guards.js';
+export { isImageDataLike, isCanvasLike, isVideoFrameLike, isCanvasImageSource, isSkiaCanvas, extractCanvasPixels, } from './type-guards.js';
 // Codec helpers
 export { parseAvcDecoderConfig, convertAvccToAnnexB, splitAnnexBNals, extractAvcParameterSetsFromAnnexB, buildAvcDecoderConfig, convertAnnexBToAvcc, } from './avc.js';
 export { parseHvccDecoderConfig, convertHvccToAnnexB, splitHevcAnnexBNals, extractHevcParameterSetsFromAnnexB, buildHvccDecoderConfig, convertAnnexBToHvcc, } from './hevc.js';

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,mBAAmB;AACnB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAErB,uBAAuB;AACvB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,SAAS;AACT,OAAO,EACL,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,WAAW,GAGZ,MAAM,aAAa,CAAC;AAErB,cAAc;AACd,OAAO,EACL,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,GAIpB,MAAM,kBAAkB,CAAC;AAE1B,gBAAgB;AAChB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,iCAAiC,EACjC,qBAAqB,EACrB,mBAAmB,GAEpB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,kCAAkC,EAClC,sBAAsB,EACtB,mBAAmB,GAEpB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,eAAe,GAEhB,MAAM,UAAU,CAAC;AAElB,sBAAsB;AACtB,OAAO,EACL,oBAAoB,GAGrB,MAAM,mBAAmB,CAAC;AAE3B,0BAA0B;AAC1B,OAAO,EACL,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,eAAe,GAIhB,MAAM,kBAAkB,CAAC;AAE1B,oBAAoB;AACpB,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,4BAA4B,EAC5B,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,kBAAkB;AAClB,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,GAEjB,MAAM,aAAa,CAAC;AAErB,2BAA2B;AAC3B,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,GAEvB,MAAM,oBAAoB,CAAC;AAE5B,4CAA4C;AAC5C,OAAO,EACL,UAAU,EACV,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,aAAa,GAGd,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,mBAAmB;AACnB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAErB,uBAAuB;AACvB,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,SAAS;AACT,OAAO,EACL,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,WAAW,GAGZ,MAAM,aAAa,CAAC;AAErB,cAAc;AACd,OAAO,EACL,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,GAKpB,MAAM,kBAAkB,CAAC;AAE1B,gBAAgB;AAChB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,iCAAiC,EACjC,qBAAqB,EACrB,mBAAmB,GAEpB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,kCAAkC,EAClC,sBAAsB,EACtB,mBAAmB,GAEpB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,eAAe,GAEhB,MAAM,UAAU,CAAC;AAElB,sBAAsB;AACtB,OAAO,EACL,oBAAoB,GAGrB,MAAM,mBAAmB,CAAC;AAE3B,0BAA0B;AAC1B,OAAO,EACL,YAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,eAAe,GAIhB,MAAM,kBAAkB,CAAC;AAE1B,oBAAoB;AACpB,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,4BAA4B,EAC5B,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,kBAAkB;AAClB,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,GAEjB,MAAM,aAAa,CAAC;AAErB,2BAA2B;AAC3B,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,GAEvB,MAAM,oBAAoB,CAAC;AAE5B,4CAA4C;AAC5C,OAAO,EACL,UAAU,EACV,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,aAAa,GAGd,MAAM,kBAAkB,CAAC"}

package/dist/utils/type-guards.d.ts

@@ -18,6 +18,21 @@ export interface CanvasLike {
     getContext: (type: string, options?: unknown) => unknown;
     _getImageData?: () => Uint8ClampedArray;
 }
+/**
+ * Interface for skia-canvas Canvas objects
+ */
+export interface SkiaCanvasLike {
+    width: number;
+    height: number;
+    gpu: boolean;
+    engine: {
+        renderer: string;
+        api?: string;
+    };
+    getContext: (type: '2d') => any;
+    toBuffer: (format: string, options?: unknown) => Promise<Buffer>;
+    toBufferSync: (format: string, options?: unknown) => Buffer;
+}
 /**
  * Interface for VideoFrame-like objects (including our polyfill)
  */
@@ -45,10 +60,15 @@ export interface VideoFrameLike {
  * Check if object is ImageData-like (has data, width, height)
  */
 export declare function isImageDataLike(obj: unknown): obj is ImageDataLike;
+/**
+ * Check if object is a skia-canvas Canvas
+ */
+export declare function isSkiaCanvas(obj: unknown): obj is SkiaCanvasLike;
 /**
  * Check if object is a canvas-like object with getContext
+ * Includes both standard canvas and skia-canvas
  */
-export declare function isCanvasLike(obj: unknown): obj is CanvasLike;
+export declare function isCanvasLike(obj: unknown): obj is CanvasLike | SkiaCanvasLike;
 /**
  * Check if object is a VideoFrame-like object
  */
@@ -57,4 +77,12 @@ export declare function isVideoFrameLike(obj: unknown): obj is VideoFrameLike;
  * Check if an object is a CanvasImageSource-like object
  */
 export declare function isCanvasImageSource(obj: unknown): boolean;
+/**
+ * Extract raw pixel data from any canvas-like object
+ * Returns RGBA Uint8Array
+ *
+ * @param canvas - Any canvas-like object (skia-canvas, polyfill, or standard)
+ * @returns Raw RGBA pixel data as Uint8Array
+ */
+export declare function extractCanvasPixels(canvas: CanvasLike | SkiaCanvasLike): Uint8Array;
 //# sourceMappingURL=type-guards.d.ts.map

package/dist/utils/type-guards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../../src/utils/type-guards.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,GAAG,UAAU,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;IACzD,aAAa,CAAC,EAAE,MAAM,iBAAiB,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7E,cAAc,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,MAAM,CAAC;IAC/C,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACvD,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,aAAa,CAQlE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,UAAU,CAQ5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,cAAc,CASpE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAQzD"}
+{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../../src/utils/type-guards.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,GAAG,UAAU,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;IACzD,aAAa,CAAC,EAAE,MAAM,iBAAiB,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IAEF,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,GAAG,CAAC;IAChC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,MAAM,CAAC;CAC7D;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7E,cAAc,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,MAAM,CAAC;IAC/C,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACvD,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,aAAa,CAQlE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,cAAc,CAYhE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,UAAU,GAAG,cAAc,CAW7E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,cAAc,CASpE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAQzD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,cAAc,GAAG,UAAU,CA0BnF"}

package/dist/utils/type-guards.js

@@ -12,16 +12,34 @@ export function isImageDataLike(obj) {
         typeof o.width === 'number' &&
         typeof o.height === 'number');
 }
+/**
+ * Check if object is a skia-canvas Canvas
+ */
+export function isSkiaCanvas(obj) {
+    if (!obj || typeof obj !== 'object')
+        return false;
+    const o = obj;
+    return (typeof o.width === 'number' &&
+        typeof o.height === 'number' &&
+        typeof o.gpu === 'boolean' &&
+        typeof o.getContext === 'function' &&
+        typeof o.toBuffer === 'function' &&
+        typeof o.toBufferSync === 'function' &&
+        typeof o.engine === 'object');
+}
 /**
  * Check if object is a canvas-like object with getContext
+ * Includes both standard canvas and skia-canvas
  */
 export function isCanvasLike(obj) {
     if (!obj || typeof obj !== 'object')
         return false;
     const o = obj;
-    return (typeof o.width === 'number' &&
+    // Standard canvas check
+    const isStandardCanvas = typeof o.width === 'number' &&
         typeof o.height === 'number' &&
-        typeof o.getContext === 'function');
+        typeof o.getContext === 'function';
+    return isStandardCanvas;
 }
 /**
  * Check if object is a VideoFrame-like object
@@ -46,4 +64,31 @@ export function isCanvasImageSource(obj) {
         (typeof o.codedWidth === 'number' && typeof o.codedHeight === 'number') ||
         isImageDataLike(obj));
 }
+/**
+ * Extract raw pixel data from any canvas-like object
+ * Returns RGBA Uint8Array
+ *
+ * @param canvas - Any canvas-like object (skia-canvas, polyfill, or standard)
+ * @returns Raw RGBA pixel data as Uint8Array
+ */
+export function extractCanvasPixels(canvas) {
+    // Try skia-canvas method first (most efficient)
+    if ('toBufferSync' in canvas && typeof canvas.toBufferSync === 'function') {
+        const buffer = canvas.toBufferSync('raw', { colorType: 'rgba' });
+        return new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+    }
+    // Try polyfill method
+    if ('_getImageData' in canvas && typeof canvas._getImageData === 'function') {
+        const data = canvas._getImageData();
+        return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+    }
+    // Standard canvas 2D context
+    const ctx = canvas.getContext('2d');
+    if (ctx && typeof ctx.getImageData === 'function') {
+        const imageData = ctx.getImageData(0, 0, canvas.width, canvas.height);
+        return new Uint8Array(imageData.data.buffer, imageData.data.byteOffset, imageData.data.byteLength);
+    }
+    // Fallback: empty buffer
+    return new Uint8Array(canvas.width * canvas.height * 4);
+}
 //# sourceMappingURL=type-guards.js.map

package/dist/utils/type-guards.js.map

@@ -1 +1 @@
-{"version":3,"file":"type-guards.js","sourceRoot":"","sources":["../../src/utils/type-guards.ts"],"names":[],"mappings":"AAAA;;GAEG;AAwCH;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,OAAO,CACL,CAAC,CAAC,CAAC,IAAI,YAAY,iBAAiB,IAAI,CAAC,CAAC,IAAI,YAAY,UAAU,CAAC;QACrE,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;QAC3B,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAC7B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,OAAO,CACL,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;QAC3B,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;QAC5B,OAAO,CAAC,CAAC,UAAU,KAAK,UAAU,CACnC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,OAAO,CACL,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ;QAChC,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ;QACjC,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;QAC5B,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,CAChC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,OAAO,CACL,CAAC,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC;QAC7D,CAAC,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,CAAC;QACvE,eAAe,CAAC,GAAG,CAAC,CACrB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"type-guards.js","sourceRoot":"","sources":["../../src/utils/type-guards.ts"],"names":[],"mappings":"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"}