cross-image 0.1.2

package/esm/src/formats/gif.js

@@ -0,0 +1,385 @@
+import { GIFDecoder } from "../utils/gif_decoder.js";
+import { GIFEncoder } from "../utils/gif_encoder.js";
+/**
+ * GIF format handler
+ * Now includes pure-JS implementation with custom LZW compression/decompression
+ *
+ * Features:
+ * - LZW compression/decompression
+ * - Color quantization and palette generation for encoding
+ * - Interlacing support
+ * - Transparency support
+ * - Multi-frame animation support (decoding and encoding)
+ * - Falls back to runtime APIs when pure-JS fails
+ */
+export class GIFFormat {
+    constructor() {
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "gif"
+        });
+        Object.defineProperty(this, "mimeType", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "image/gif"
+        });
+    }
+    supportsMultipleFrames() {
+        return true;
+    }
+    canDecode(data) {
+        // GIF signature: "GIF87a" or "GIF89a"
+        return data.length >= 6 &&
+            data[0] === 0x47 && data[1] === 0x49 && data[2] === 0x46 && // "GIF"
+            data[3] === 0x38 && // "8"
+            (data[4] === 0x37 || data[4] === 0x39) && // "7" or "9"
+            data[5] === 0x61; // "a"
+    }
+    async decode(data) {
+        if (!this.canDecode(data)) {
+            throw new Error("Invalid GIF signature");
+        }
+        // Try pure-JS decoder first
+        try {
+            const decoder = new GIFDecoder(data);
+            const result = decoder.decode();
+            // Extract metadata from comment extensions
+            const metadata = this.extractMetadata(data);
+            return {
+                width: result.width,
+                height: result.height,
+                data: result.data,
+                metadata: Object.keys(metadata).length > 0 ? metadata : undefined,
+            };
+        }
+        catch (error) {
+            // Fall back to runtime decoder if pure-JS fails
+            console.warn("Pure-JS GIF decoder failed, falling back to runtime:", error);
+            let pos = 6; // Skip "GIF89a" or "GIF87a"
+            const width = this.readUint16LE(data, pos);
+            pos += 2;
+            const height = this.readUint16LE(data, pos);
+            const rgba = await this.decodeUsingRuntime(data, width, height);
+            const metadata = this.extractMetadata(data);
+            return {
+                width,
+                height,
+                data: rgba,
+                metadata: Object.keys(metadata).length > 0 ? metadata : undefined,
+            };
+        }
+    }
+    extractMetadata(data) {
+        const metadata = {};
+        let pos = 6; // Skip "GIF89a" or "GIF87a"
+        // Read logical screen descriptor
+        pos += 4; // Skip width and height
+        const packed = data[pos++];
+        const hasGlobalColorTable = (packed & 0x80) !== 0;
+        const globalColorTableSize = 2 << (packed & 0x07);
+        pos++; // background color
+        pos++; // aspect ratio
+        // Skip global color table if present
+        if (hasGlobalColorTable) {
+            pos += globalColorTableSize * 3;
+        }
+        // Parse extensions
+        while (pos < data.length) {
+            if (data[pos] === 0x21) { // Extension
+                const label = data[pos + 1];
+                pos += 2;
+                if (label === 0xfe) { // Comment Extension
+                    const comment = this.readDataSubBlocks(data, pos);
+                    if (comment.text) {
+                        this.parseComment(comment.text, metadata);
+                    }
+                    pos = comment.endPos;
+                }
+                else if (label === 0xff) { // Application Extension
+                    const appData = this.readDataSubBlocks(data, pos);
+                    if (appData.text && appData.text.startsWith("XMP DataXMP") ||
+                        appData.text.includes("<?xpacket")) {
+                        this.parseXMP(appData.text, metadata);
+                    }
+                    pos = appData.endPos;
+                }
+                else {
+                    // Skip other extensions
+                    while (pos < data.length && data[pos] !== 0) {
+                        const blockSize = data[pos++];
+                        pos += blockSize;
+                    }
+                    pos++; // Skip block terminator
+                }
+            }
+            else if (data[pos] === 0x3b) { // Trailer
+                break;
+            }
+            else {
+                pos++;
+            }
+        }
+        return metadata;
+    }
+    async encode(imageData) {
+        const { width, height, data, metadata } = imageData;
+        // Try pure-JS encoder first
+        try {
+            const encoder = new GIFEncoder(width, height, data);
+            const encoded = encoder.encode();
+            // Inject metadata if present
+            if (metadata && Object.keys(metadata).length > 0) {
+                const injected = this.injectMetadata(encoded, metadata);
+                return injected;
+            }
+            return encoded;
+        }
+        catch (error) {
+            // Fall back to runtime encoding if pure-JS fails
+            console.warn("Pure-JS GIF encoder failed, falling back to runtime:", error);
+            if (typeof OffscreenCanvas !== "undefined") {
+                try {
+                    const canvas = new OffscreenCanvas(width, height);
+                    const ctx = canvas.getContext("2d");
+                    if (!ctx)
+                        throw new Error("Could not get canvas context");
+                    const imgData = ctx.createImageData(width, height);
+                    const imgDataData = new Uint8ClampedArray(data);
+                    imgData.data.set(imgDataData);
+                    ctx.putImageData(imgData, 0, 0);
+                    const blob = await canvas.convertToBlob({
+                        type: "image/gif",
+                    });
+                    const arrayBuffer = await blob.arrayBuffer();
+                    const encoded = new Uint8Array(arrayBuffer);
+                    // Inject metadata if present
+                    if (metadata && Object.keys(metadata).length > 0) {
+                        const injected = this.injectMetadata(encoded, metadata);
+                        return injected;
+                    }
+                    return encoded;
+                }
+                catch (runtimeError) {
+                    throw new Error(`GIF encoding failed: ${runtimeError}`);
+                }
+            }
+            throw new Error("GIF encoding requires pure-JS support or OffscreenCanvas API");
+        }
+    }
+    /**
+     * Decode all frames from an animated GIF
+     */
+    decodeFrames(data) {
+        if (!this.canDecode(data)) {
+            throw new Error("Invalid GIF signature");
+        }
+        try {
+            const decoder = new GIFDecoder(data);
+            const result = decoder.decodeAllFrames();
+            // Extract metadata from comment extensions
+            const metadata = this.extractMetadata(data);
+            return Promise.resolve({
+                width: result.width,
+                height: result.height,
+                frames: result.frames.map((frame) => ({
+                    width: frame.width,
+                    height: frame.height,
+                    data: frame.data,
+                    frameMetadata: {
+                        left: frame.left,
+                        top: frame.top,
+                        // Convert GIF delay from centiseconds (1/100s) to milliseconds
+                        delay: frame.delay * 10,
+                        disposal: this.mapDisposalMethod(frame.disposal),
+                    },
+                })),
+                metadata: Object.keys(metadata).length > 0 ? metadata : undefined,
+            });
+        }
+        catch (error) {
+            throw new Error(`GIF multi-frame decoding failed: ${error}`);
+        }
+    }
+    /**
+     * Encode multi-frame image data to animated GIF
+     * Note: Currently not implemented, will encode only first frame
+     */
+    encodeFrames(imageData, _options) {
+        // For now, just encode the first frame using the existing encoder
+        // Full multi-frame encoding would require a more complex GIFEncoder
+        if (imageData.frames.length === 0) {
+            throw new Error("No frames to encode");
+        }
+        const firstFrame = imageData.frames[0];
+        const singleFrameData = {
+            width: firstFrame.width,
+            height: firstFrame.height,
+            data: firstFrame.data,
+            metadata: imageData.metadata,
+        };
+        return this.encode(singleFrameData);
+    }
+    mapDisposalMethod(disposal) {
+        switch (disposal) {
+            case 0:
+            case 1:
+                return "none";
+            case 2:
+                return "background";
+            case 3:
+                return "previous";
+            default:
+                return "none";
+        }
+    }
+    readUint16LE(data, offset) {
+        return data[offset] | (data[offset + 1] << 8);
+    }
+    async decodeUsingRuntime(data, _width, _height) {
+        // Try to use ImageDecoder API if available (Deno, modern browsers)
+        if (typeof ImageDecoder !== "undefined") {
+            try {
+                const decoder = new ImageDecoder({ data, type: "image/gif" });
+                const result = await decoder.decode();
+                const bitmap = result.image;
+                // Create a canvas to extract pixel data
+                const canvas = new OffscreenCanvas(bitmap.displayWidth, bitmap.displayHeight);
+                const ctx = canvas.getContext("2d");
+                if (!ctx)
+                    throw new Error("Could not get canvas context");
+                ctx.drawImage(bitmap, 0, 0);
+                const imageData = ctx.getImageData(0, 0, canvas.width, canvas.height);
+                bitmap.close();
+                return new Uint8Array(imageData.data.buffer);
+            }
+            catch (error) {
+                throw new Error(`GIF decoding failed: ${error}`);
+            }
+        }
+        throw new Error("GIF decoding requires ImageDecoder API or equivalent runtime support");
+    }
+    // Metadata parsing and injection methods
+    readDataSubBlocks(data, pos) {
+        const blocks = [];
+        while (pos < data.length) {
+            const blockSize = data[pos++];
+            if (blockSize === 0)
+                break;
+            for (let i = 0; i < blockSize && pos < data.length; i++) {
+                blocks.push(data[pos++]);
+            }
+        }
+        return {
+            text: new TextDecoder().decode(new Uint8Array(blocks)),
+            endPos: pos,
+        };
+    }
+    parseComment(comment, metadata) {
+        // Try to parse structured comments like "Title: xxx" or JSON
+        const lines = comment.split("\n");
+        for (const line of lines) {
+            const colonIdx = line.indexOf(":");
+            if (colonIdx > 0) {
+                const key = line.slice(0, colonIdx).trim().toLowerCase();
+                const value = line.slice(colonIdx + 1).trim();
+                switch (key) {
+                    case "title":
+                        metadata.title = value;
+                        break;
+                    case "description":
+                        metadata.description = value;
+                        break;
+                    case "author":
+                    case "artist":
+                        metadata.author = value;
+                        break;
+                    case "copyright":
+                        metadata.copyright = value;
+                        break;
+                }
+            }
+        }
+        // If no structured data, use entire comment as description
+        if (!metadata.title && !metadata.description && !metadata.author &&
+            !metadata.copyright) {
+            metadata.description = comment.trim();
+        }
+    }
+    parseXMP(xmpStr, metadata) {
+        // Simple XMP parsing for common fields
+        try {
+            const titleMatch = xmpStr.match(/<dc:title[^>]*>([^<]+)<\/dc:title>/);
+            if (titleMatch)
+                metadata.title = titleMatch[1].trim();
+            const descMatch = xmpStr.match(/<dc:description[^>]*>([^<]+)<\/dc:description>/);
+            if (descMatch)
+                metadata.description = descMatch[1].trim();
+            const creatorMatch = xmpStr.match(/<dc:creator[^>]*>([^<]+)<\/dc:creator>/);
+            if (creatorMatch)
+                metadata.author = creatorMatch[1].trim();
+            const rightsMatch = xmpStr.match(/<dc:rights[^>]*>([^<]+)<\/dc:rights>/);
+            if (rightsMatch)
+                metadata.copyright = rightsMatch[1].trim();
+        }
+        catch (_e) {
+            // Ignore XMP parsing errors
+        }
+    }
+    injectMetadata(gifData, metadata) {
+        // GIF structure: Header + Logical Screen Descriptor + [Global Color Table] + Data + Trailer
+        // We'll inject a Comment Extension after the Logical Screen Descriptor
+        const result = [];
+        // Copy header and logical screen descriptor
+        let pos = 0;
+        for (let i = 0; i < 13; i++) {
+            result.push(gifData[pos++]);
+        }
+        // Check if there's a global color table
+        const packed = gifData[10];
+        const hasGlobalColorTable = (packed & 0x80) !== 0;
+        const globalColorTableSize = 2 << (packed & 0x07);
+        // Copy global color table if present
+        if (hasGlobalColorTable) {
+            for (let i = 0; i < globalColorTableSize * 3; i++) {
+                result.push(gifData[pos++]);
+            }
+        }
+        // Inject Comment Extension with metadata
+        const commentText = this.createCommentText(metadata);
+        if (commentText) {
+            result.push(0x21); // Extension Introducer
+            result.push(0xfe); // Comment Label
+            // Write comment in sub-blocks (max 255 bytes per block)
+            const commentBytes = new TextEncoder().encode(commentText);
+            for (let i = 0; i < commentBytes.length; i += 255) {
+                const blockSize = Math.min(255, commentBytes.length - i);
+                result.push(blockSize);
+                for (let j = 0; j < blockSize; j++) {
+                    result.push(commentBytes[i + j]);
+                }
+            }
+            result.push(0); // Block Terminator
+        }
+        // Copy rest of the GIF data
+        while (pos < gifData.length) {
+            result.push(gifData[pos++]);
+        }
+        return new Uint8Array(result);
+    }
+    createCommentText(metadata) {
+        const parts = [];
+        if (metadata.title)
+            parts.push(`Title: ${metadata.title}`);
+        if (metadata.description) {
+            parts.push(`Description: ${metadata.description}`);
+        }
+        if (metadata.author)
+            parts.push(`Author: ${metadata.author}`);
+        if (metadata.copyright)
+            parts.push(`Copyright: ${metadata.copyright}`);
+        return parts.length > 0 ? parts.join("\n") : null;
+    }
+}

package/esm/src/formats/jpeg.d.ts

@@ -0,0 +1,18 @@
+import type { ImageData, ImageFormat } from "../types.js";
+/**
+ * JPEG format handler
+ * Implements a basic JPEG decoder and encoder
+ */
+export declare class JPEGFormat implements ImageFormat {
+    readonly name = "jpeg";
+    readonly mimeType = "image/jpeg";
+    canDecode(data: Uint8Array): boolean;
+    decode(data: Uint8Array): Promise<ImageData>;
+    encode(imageData: ImageData): Promise<Uint8Array>;
+    private injectMetadata;
+    private decodeUsingRuntime;
+    private parseJFIF;
+    private parseEXIF;
+    private createEXIFData;
+}
+//# sourceMappingURL=jpeg.d.ts.map

package/esm/src/formats/jpeg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jpeg.d.ts","sourceRoot":"","sources":["../../../src/src/formats/jpeg.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAiB,MAAM,aAAa,CAAC;AAKzE;;;GAGG;AACH,qBAAa,UAAW,YAAW,WAAW;IAC5C,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,QAAQ,gBAAgB;IAEjC,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;IAM9B,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IA2E5C,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAgDvD,OAAO,CAAC,cAAc;YA+CR,kBAAkB;IAgDhC,OAAO,CAAC,SAAS;IAkCjB,OAAO,CAAC,SAAS;IAyIjB,OAAO,CAAC,cAAc;CAgHvB"}