cross-image 0.2.2 → 0.2.4

package/esm/src/formats/ascii.js

@@ -183,4 +183,28 @@ export class ASCIIFormat {
         }
         return options;
     }
+    /**
+     * Get the list of metadata fields supported by ASCII format
+     */
+    getSupportedMetadata() {
+        return []; // ASCII art doesn't support metadata preservation
+    }
+    /**
+     * Extract metadata from ASCII art data without fully decoding
+     * @param data Raw ASCII art data
+     * @returns Extracted metadata or undefined
+     */
+    extractMetadata(data) {
+        if (!this.canDecode(data)) {
+            return Promise.resolve(undefined);
+        }
+        const metadata = {
+            format: "ascii",
+            compression: "none",
+            frameCount: 1,
+            bitDepth: 1, // ASCII is 1-bit (character or no character)
+            colorType: "grayscale",
+        };
+        return Promise.resolve(metadata);
+    }
 }

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

@@ -0,0 +1,96 @@
+import type { ImageData, ImageFormat, ImageMetadata } from "../types.js";
+/**
+ * AVIF format handler
+ * Supports AVIF images using runtime APIs (ImageDecoder/OffscreenCanvas)
+ * Note: Pure JavaScript encode/decode is not supported due to complexity
+ */
+export declare class AVIFFormat implements ImageFormat {
+    /** Format name identifier */
+    readonly name = "avif";
+    /** MIME type for AVIF images */
+    readonly mimeType = "image/avif";
+    /**
+     * Check if the given data is an AVIF image
+     * @param data Raw image data to check
+     * @returns true if data has AVIF signature
+     */
+    canDecode(data: Uint8Array): boolean;
+    /**
+     * Decode AVIF image data to RGBA
+     * Uses runtime APIs (ImageDecoder) for decoding
+     * @param data Raw AVIF image data
+     * @returns Decoded image data with RGBA pixels
+     */
+    decode(data: Uint8Array): Promise<ImageData>;
+    /**
+     * Encode RGBA image data to AVIF format
+     * Uses runtime APIs (OffscreenCanvas) for encoding
+     *
+     * Note: Metadata injection is not currently implemented. Metadata may be lost during encoding
+     * as it would require parsing and modifying the ISOBMFF container structure.
+     *
+     * @param imageData Image data to encode
+     * @returns Encoded AVIF image bytes
+     */
+    encode(imageData: ImageData): Promise<Uint8Array>;
+    /**
+     * Decode using runtime APIs
+     * @param data Raw AVIF data
+     * @returns Decoded image dimensions and pixel data
+     */
+    private decodeUsingRuntime;
+    /**
+     * Parse EXIF metadata from AVIF data
+     *
+     * Note: This is a simplified implementation that searches for EXIF headers linearly.
+     * A full implementation would require navigating the ISOBMFF box structure to find
+     * the 'meta' box and then the 'Exif' item. This simplified approach may not work
+     * in all cases but is suitable for basic metadata extraction when runtime APIs are
+     * not available or as a fallback.
+     *
+     * @param data Raw AVIF data
+     * @param metadata Metadata object to populate
+     */
+    private parseEXIF;
+    /**
+     * Parse TIFF-formatted EXIF data
+     * @param data EXIF data in TIFF format
+     * @param metadata Metadata object to populate
+     */
+    private parseTIFFExif;
+    /**
+     * Parse Exif Sub-IFD for camera settings
+     * @param data EXIF data
+     * @param exifIfdOffset Offset to Exif Sub-IFD
+     * @param littleEndian Byte order
+     * @param metadata Metadata object to populate
+     */
+    private parseExifSubIFD;
+    /**
+     * Parse GPS IFD for location data
+     * @param data EXIF data
+     * @param gpsIfdOffset Offset to GPS IFD
+     * @param littleEndian Byte order
+     * @param metadata Metadata object to populate
+     */
+    private parseGPSIFD;
+    /**
+     * Read a rational value (numerator/denominator)
+     * @param data Data buffer
+     * @param offset Offset to rational
+     * @param littleEndian Byte order
+     * @returns Decimal value
+     */
+    private readRational;
+    /**
+     * Get the list of metadata fields supported by AVIF format
+     */
+    getSupportedMetadata(): Array<keyof ImageMetadata>;
+    /**
+     * Extract metadata from AVIF data without fully decoding the pixel data
+     * @param data Raw AVIF data
+     * @returns Extracted metadata or undefined
+     */
+    extractMetadata(data: Uint8Array): Promise<ImageMetadata | undefined>;
+}
+//# sourceMappingURL=avif.d.ts.map