webcodecs-node 0.7.2 → 0.8.5

package/dist/decoders/ImageDecoder.d.ts

@@ -3,8 +3,12 @@
  * https://developer.mozilla.org/en-US/docs/Web/API/ImageDecoder
  */
 import { VideoFrame } from '../core/VideoFrame.js';
+import type { VideoPixelFormat } from '../core/VideoFrame.js';
+import { ImageTrack, ImageTrackListClass, type ImageTrackList as ImageTrackListType } from './image/tracks.js';
 export type ColorSpaceConversion = 'none' | 'default';
 export type PremultiplyAlpha = 'none' | 'premultiply' | 'default';
+export { ImageTrack };
+export { ImageTrackListClass as ImageTrackList };
 export interface ImageDecoderInit {
     type: string;
     data: ArrayBuffer | ArrayBufferView | ReadableStream<ArrayBufferView>;
@@ -14,6 +18,17 @@ export interface ImageDecoderInit {
     preferAnimation?: boolean;
     premultiplyAlpha?: PremultiplyAlpha;
     transfer?: ArrayBuffer[];
+    /**
+     * Preferred output pixel format.
+     * - 'RGBA' (default): RGB with alpha channel, suitable for display
+     * - 'I420': YUV 4:2:0 planar, efficient for video processing
+     * - 'I420P10': 10-bit YUV 4:2:0, for HDR content (AVIF, etc.)
+     * - Other formats as supported by the decoder
+     *
+     * Note: WebP images always output RGBA due to node-webpmux limitations.
+     * JPEG/AVIF can output I420 directly for better performance.
+     */
+    preferredPixelFormat?: VideoPixelFormat;
 }
 export interface ImageDecodeOptions {
     frameIndex?: number;
@@ -23,44 +38,6 @@ export interface ImageDecodeResult {
     image: VideoFrame;
     complete: boolean;
 }
-/**
- * ImageTrack - Represents an individual image track
- */
-export declare class ImageTrack {
-    private _animated;
-    private _frameCount;
-    private _repetitionCount;
-    private _selected;
-    constructor(options: {
-        animated: boolean;
-        frameCount: number;
-        repetitionCount: number;
-        selected: boolean;
-    });
-    get animated(): boolean;
-    get frameCount(): number;
-    get repetitionCount(): number;
-    get selected(): boolean;
-}
-/**
- * ImageTrackList - A list of image tracks
- */
-export declare class ImageTrackList {
-    private _tracks;
-    private _selectedIndex;
-    private _ready;
-    private _resolveReady;
-    constructor();
-    get ready(): Promise<void>;
-    get length(): number;
-    get selectedIndex(): number;
-    get selectedTrack(): ImageTrack | null;
-    /** @internal */
-    _addTrack(track: ImageTrack): void;
-    /** @internal */
-    _markReady(): void;
-    [Symbol.iterator](): Iterator<ImageTrack>;
-}
 export declare class ImageDecoder {
     private _type;
     private _data;
@@ -79,12 +56,30 @@ export declare class ImageDecoder {
     private _visibleAnimated;
     private _visibleRepetitionCount;
     private _preferredColorSpace;
+    private _preferredPixelFormat;
     private _orientation;
     private _orientationEvaluated;
     private _frames;
     private _framesParsed;
     private _repetitionCount;
     constructor(init: ImageDecoderInit);
+    /**
+     * Detach ArrayBuffers after data has been copied
+     */
+    private _detachTransferBuffers;
+    /**
+     * Read data from a ReadableStream
+     *
+     * Note: Current implementation buffers the entire stream before decoding.
+     * This is a limitation of the node-av backend which requires complete data
+     * for image decoding. True progressive/streaming decode would require:
+     * 1. Format-specific header parsing to determine image dimensions
+     * 2. Progressive frame decoding as data arrives
+     * 3. Updating track.frameCount as new frames are discovered
+     *
+     * For animated GIF streaming tests (WPT), this means frames won't be
+     * available until the entire stream is received.
+     */
     private _readStream;
     private _initializeTracks;
     private _parseImage;
@@ -93,14 +88,12 @@ export declare class ImageDecoder {
     private _shouldPremultiplyAlpha;
     private _processFrameData;
     private _updateVisibleTrackInfo;
-    private _parseExifOrientation;
-    private _applyOrientation;
     private _decodeWithNodeAv;
     private _decodeWithWebP;
     private _decodeAllFramesDirect;
     get complete(): boolean;
     get completed(): Promise<void>;
-    get tracks(): ImageTrackList;
+    get tracks(): ImageTrackListType;
     get type(): string;
     static isTypeSupported(type: string): Promise<boolean>;
     decode(options?: ImageDecodeOptions): Promise<ImageDecodeResult>;

package/dist/decoders/ImageDecoder.d.ts.map

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