cross-image 0.2.3 → 0.2.4

package/script/src/formats/webp.js

@@ -603,5 +603,97 @@ class WebPFormat {
             "focalLength",
         ];
     }
+    /**
+     * Extract metadata from WebP data without fully decoding the pixel data
+     * This quickly parses RIFF chunks to extract EXIF and XMP metadata
+     * @param data Raw WebP data
+     * @returns Extracted metadata or undefined
+     */
+    extractMetadata(data) {
+        if (!this.canDecode(data)) {
+            return Promise.resolve(undefined);
+        }
+        const metadata = {
+            format: "webp",
+            frameCount: 1,
+            bitDepth: 8,
+        };
+        let pos = 12; // Skip "RIFF" + size + "WEBP"
+        const readUint32LE = (data, offset) => {
+            return data[offset] | (data[offset + 1] << 8) | (data[offset + 2] << 16) |
+                (data[offset + 3] << 24);
+        };
+        const readUint16LE = (data, offset) => {
+            return data[offset] | (data[offset + 1] << 8);
+        };
+        // Parse chunks for metadata
+        while (pos + 8 <= data.length) {
+            const chunkType = String.fromCharCode(data[pos], data[pos + 1], data[pos + 2], data[pos + 3]);
+            const chunkSize = readUint32LE(data, pos + 4);
+            pos += 8;
+            // Stop if we've gone past the end
+            if (pos + chunkSize > data.length)
+                break;
+            const chunkData = data.slice(pos, pos + chunkSize);
+            if (chunkType === "VP8 ") {
+                // Lossy VP8 chunk
+                metadata.compression = "vp8";
+                metadata.colorType = "rgb";
+            }
+            else if (chunkType === "VP8L") {
+                // Lossless VP8L chunk
+                metadata.compression = "vp8l";
+                metadata.colorType = "rgba";
+            }
+            else if (chunkType === "VP8X") {
+                // Extended format chunk - contains animation info
+                if (chunkData.length >= 10) {
+                    const flags = chunkData[0];
+                    const _hasAnimation = (flags & 0x02) !== 0;
+                    const hasAlpha = (flags & 0x10) !== 0;
+                    if (hasAlpha) {
+                        metadata.colorType = "rgba";
+                    }
+                    else {
+                        metadata.colorType = "rgb";
+                    }
+                    // Animation is handled in ANIM chunk
+                }
+            }
+            else if (chunkType === "ANIM") {
+                // Animation parameters chunk
+                if (chunkData.length >= 6) {
+                    // Background color at bytes 0-3
+                    // Loop count at bytes 4-5
+                    const _loopCount = readUint16LE(chunkData, 4);
+                    // Note: Frame count is not directly in ANIM chunk, need to count ANMF chunks
+                    // Reset frame count to 0 to start counting ANMF frames
+                    metadata.frameCount = 0;
+                }
+            }
+            else if (chunkType === "ANMF") {
+                // Animation frame - count frames
+                if (metadata.frameCount !== undefined) {
+                    metadata.frameCount++;
+                }
+                else {
+                    metadata.frameCount = 1;
+                }
+            }
+            else if (chunkType === "EXIF") {
+                // EXIF metadata chunk
+                this.parseEXIF(chunkData, metadata);
+            }
+            else if (chunkType === "XMP ") {
+                // XMP metadata chunk
+                this.parseXMP(chunkData, metadata);
+            }
+            pos += chunkSize;
+            // Chunks are padded to even length
+            if (chunkSize % 2 === 1)
+                pos++;
+        }
+        return Promise.resolve(Object.keys(metadata).length > 0 ? metadata : undefined);
+    }
 }
 exports.WebPFormat = WebPFormat;

package/script/src/image.d.ts

@@ -85,6 +85,15 @@ export declare class Image {
      * @returns Array of supported metadata field names, or undefined if format doesn't support metadata
      */
     static getSupportedMetadata(format: string): Array<keyof ImageMetadata> | undefined;
+    /**
+     * Extract metadata from image data without fully decoding the pixel data
+     * This is useful for quickly reading EXIF, XMP, or other metadata from images
+     * that may have unsupported features or compression methods
+     * @param data Raw image data
+     * @param format Optional format hint (e.g., "png", "jpeg", "webp")
+     * @returns Metadata extracted from the image, or undefined if extraction fails or format is unsupported
+     */
+    static extractMetadata(data: Uint8Array, format?: string): Promise<ImageMetadata | undefined>;
     /**
      * Read an image from bytes
      * @deprecated Use `decode()` instead. This method will be removed in a future version.

package/script/src/image.js

@@ -16,6 +16,8 @@ const pam_js_1 = require("./formats/pam.js");
 const pcx_js_1 = require("./formats/pcx.js");
 const ppm_js_1 = require("./formats/ppm.js");
 const ascii_js_1 = require("./formats/ascii.js");
+const heic_js_1 = require("./formats/heic.js");
+const avif_js_1 = require("./formats/avif.js");
 const security_js_1 = require("./utils/security.js");
 /**
  * Main Image class for reading, manipulating, and saving images
@@ -196,6 +198,30 @@ class Image {
         }
         return formatHandler.getSupportedMetadata?.();
     }
+    /**
+     * Extract metadata from image data without fully decoding the pixel data
+     * This is useful for quickly reading EXIF, XMP, or other metadata from images
+     * that may have unsupported features or compression methods
+     * @param data Raw image data
+     * @param format Optional format hint (e.g., "png", "jpeg", "webp")
+     * @returns Metadata extracted from the image, or undefined if extraction fails or format is unsupported
+     */
+    static async extractMetadata(data, format) {
+        // Try specified format first
+        if (format) {
+            const handler = Image.formats.find((f) => f.name === format);
+            if (handler && handler.canDecode(data) && handler.extractMetadata) {
+                return await handler.extractMetadata(data);
+            }
+        }
+        // Auto-detect format
+        for (const handler of Image.formats) {
+            if (handler.canDecode(data) && handler.extractMetadata) {
+                return await handler.extractMetadata(data);
+            }
+        }
+        return undefined;
+    }
     /**
      * Read an image from bytes
      * @deprecated Use `decode()` instead. This method will be removed in a future version.
@@ -845,5 +871,7 @@ Object.defineProperty(Image, "formats", {
         new pcx_js_1.PCXFormat(),
         new ppm_js_1.PPMFormat(),
         new ascii_js_1.ASCIIFormat(),
+        new heic_js_1.HEICFormat(),
+        new avif_js_1.AVIFFormat(),
     ]
 });

package/script/src/types.d.ts

@@ -50,6 +50,16 @@ export interface ImageMetadata {
     software?: string;
     /** User comment / notes */
     userComment?: string;
+    /** Image file format (e.g., "png", "jpeg", "gif", "webp", "tiff") */
+    format?: string;
+    /** Compression algorithm used (e.g., "deflate", "lzw", "dct", "vp8", "vp8l", "none") */
+    compression?: string;
+    /** Number of frames in multi-frame images (e.g., animated GIFs, APNGs, multi-page TIFFs) */
+    frameCount?: number;
+    /** Bit depth per channel (e.g., 8, 16) */
+    bitDepth?: number;
+    /** Color type (e.g., "grayscale", "rgb", "rgba", "indexed", "grayscale-alpha") */
+    colorType?: string;
     /** Custom metadata fields */
     custom?: Record<string, string | number | boolean>;
 }
@@ -203,5 +213,13 @@ export interface ImageFormat {
      * @returns Array of metadata field names that can be persisted
      */
     getSupportedMetadata?(): Array<keyof ImageMetadata>;
+    /**
+     * Extract metadata from image data without fully decoding the pixel data
+     * This is useful for quickly reading EXIF, XMP, or other metadata from images
+     * that may have unsupported features or compression methods
+     * @param data Raw image data
+     * @returns Metadata extracted from the image, or undefined if extraction fails
+     */
+    extractMetadata?(data: Uint8Array): Promise<ImageMetadata | undefined>;
 }
 //# sourceMappingURL=types.d.ts.map