lightdrift-libraw 1.0.0-alpha.2 → 1.0.0-alpha.4

package/lib/index.d.ts

@@ -3,500 +3,645 @@
  * Provides type-safe access to LibRaw functionality for RAW image processing
  */
 
-declare module 'libraw' {
-  export interface LibRawMetadata {
-    /** Camera manufacturer */
-    make?: string;
-    /** Camera model */
-    model?: string;
-    /** Camera software/firmware */
-    software?: string;
-    /** Processed image width */
-    width: number;
-    /** Processed image height */
-    height: number;
-    /** RAW image width */
-    rawWidth: number;
-    /** RAW image height */
-    rawHeight: number;
-    /** Number of color channels */
-    colors: number;
-    /** Color filter array pattern */
-    filters: number;
-    /** ISO sensitivity */
-    iso?: number;
-    /** Shutter speed in seconds */
-    shutterSpeed?: number;
-    /** Aperture value (f-number) */
-    aperture?: number;
-    /** Focal length in mm */
-    focalLength?: number;
-    /** Timestamp of image capture */
-    timestamp?: number;
-  }
-
-  export interface LibRawAdvancedMetadata {
-    /** Normalized camera manufacturer */
-    normalizedMake?: string;
-    /** Normalized camera model */
-    normalizedModel?: string;
-    /** Number of RAW images in file */
-    rawCount: number;
-    /** DNG version number */
-    dngVersion: number;
-    /** Foveon sensor indicator */
-    is_foveon: number;
-    /** Color transformation matrix (4x3) */
-    colorMatrix: number[][];
-    /** Camera white balance multipliers */
-    camMul: number[];
-    /** Preprocessing multipliers */
-    preMul: number[];
-    /** Sensor black level */
-    blackLevel: number;
-    /** Maximum data value */
-    dataMaximum: number;
-    /** Sensor white level */
-    whiteLevel: number;
-  }
-
-  export interface LibRawImageSize {
-    /** Processed image width */
-    width: number;
-    /** Processed image height */
-    height: number;
-    /** RAW image width */
-    rawWidth: number;
-    /** RAW image height */
-    rawHeight: number;
-    /** Top margin in pixels */
-    topMargin: number;
-    /** Left margin in pixels */
-    leftMargin: number;
-    /** Internal width */
-    iWidth: number;
-    /** Internal height */
-    iHeight: number;
-  }
-
-  export interface LibRawLensInfo {
-    /** Lens name/model */
-    lensName?: string;
-    /** Lens manufacturer */
-    lensMake?: string;
-    /** Lens serial number */
-    lensSerial?: string;
-    /** Internal lens serial number */
-    internalLensSerial?: string;
-    /** Minimum focal length */
-    minFocal?: number;
-    /** Maximum focal length */
-    maxFocal?: number;
-    /** Maximum aperture at minimum focal length */
-    maxAp4MinFocal?: number;
-    /** Maximum aperture at maximum focal length */
-    maxAp4MaxFocal?: number;
-    /** EXIF maximum aperture */
-    exifMaxAp?: number;
-    /** Focal length in 35mm equivalent */
-    focalLengthIn35mmFormat?: number;
-  }
-
-  export interface LibRawColorInfo {
-    /** Number of color channels */
-    colors: number;
-    /** Color filter array pattern */
-    filters: number;
-    /** Sensor black level */
-    blackLevel: number;
-    /** Maximum data value */
-    dataMaximum: number;
-    /** Sensor white level */
-    whiteLevel: number;
-    /** Color profile length */
-    profileLength?: number;
-    /** RGB to camera space matrix (3x4) */
-    rgbCam: number[][];
-    /** Camera white balance multipliers */
-    camMul: number[];
-  }
-
-  export interface LibRawOutputParams {
-    /** Gamma correction curve [gamma, toe_slope] */
-    gamma?: [number, number];
-    /** Brightness adjustment (0.25-8.0) */
-    bright?: number;
-    /** Output color space (0=raw, 1=sRGB, 2=Adobe, 3=Wide, 4=ProPhoto, 5=XYZ, 6=ACES) */
-    output_color?: number;
-    /** Output bits per sample (8 or 16) */
-    output_bps?: number;
-    /** Manual white balance multipliers [R, G, B, G2] */
-    user_mul?: [number, number, number, number];
-    /** Disable automatic brightness adjustment */
-    no_auto_bright?: boolean;
-    /** Highlight recovery mode (0-9) */
-    highlight?: number;
-    /** Output TIFF format instead of PPM */
-    output_tiff?: boolean;
-  }
-
-  export interface LibRawImageData {
-    /** Image type (1=JPEG, 3=PPM/TIFF) */
-    type: number;
-    /** Image height in pixels */
-    height: number;
-    /** Image width in pixels */
-    width: number;
-    /** Number of color channels */
-    colors: number;
-    /** Bits per channel */
-    bits: number;
-    /** Total data size in bytes */
-    dataSize: number;
-    /** Raw image data buffer */
-    data: Buffer;
-  }
-
-  export interface LibRawJPEGOptions {
-    /** JPEG quality (1-100) */
-    quality?: number;
-    /** Target width (maintains aspect ratio if height not specified) */
-    width?: number;
-    /** Target height (maintains aspect ratio if width not specified) */
-    height?: number;
-    /** Use progressive JPEG */
-    progressive?: boolean;
-    /** Use mozjpeg encoder for better compression */
-    mozjpeg?: boolean;
-    /** Chroma subsampling ('4:4:4', '4:2:0') - Note: 4:2:2 maps to 4:4:4 */
-    chromaSubsampling?: '4:4:4' | '4:2:2' | '4:2:0';
-    /** Enable trellis quantisation */
-    trellisQuantisation?: boolean;
-    /** Optimize scan order */
-    optimizeScans?: boolean;
-    /** Overshoot deringing */
-    overshootDeringing?: boolean;
-    /** Optimize Huffman coding */
-    optimizeCoding?: boolean;
-    /** Output color space */
-    colorSpace?: 'srgb' | 'rec2020' | 'p3' | 'cmyk';
-    /** Enable fast mode for better performance */
-    fastMode?: boolean;
-    /** Encoding effort (1=fastest, 9=slowest) */
-    effort?: number;
-    /** Maximum concurrency for batch operations */
-    maxConcurrency?: number;
-  }
-
-  export interface LibRawOptimalSettings {
-    quality: number;
-    progressive: boolean;
-    mozjpeg: boolean;
-    chromaSubsampling: string;
-    effort: number;
-    reasoning: string;
-  }
-
-  export interface LibRawJPEGResult {
-    /** Conversion success status */
-    success: boolean;
-    /** Output file path */
-    outputPath: string;
-    /** Conversion metadata */
-    metadata: {
-      /** Original image dimensions */
-      originalDimensions: {
-        width: number;
-        height: number;
-      };
-      /** Output image dimensions */
-      outputDimensions: {
-        width: number;
-        height: number;
-      };
-      /** File size information */
-      fileSize: {
-        original: number;
-        compressed: number;
-        compressionRatio: string;
-      };
-      /** Processing performance */
-      processing: {
-        timeMs: string;
-        throughputMBps: string;
-      };
-      /** Applied JPEG options */
-      jpegOptions: object;
+export interface LibRawMetadata {
+  /** Camera manufacturer */
+  make?: string;
+  /** Camera model */
+  model?: string;
+  /** Camera software/firmware */
+  software?: string;
+  /** Processed image width */
+  width: number;
+  /** Processed image height */
+  height: number;
+  /** RAW image width */
+  rawWidth: number;
+  /** RAW image height */
+  rawHeight: number;
+  /** Number of color channels */
+  colors: number;
+  /** Color filter array pattern */
+  filters: number;
+  /** ISO sensitivity */
+  iso?: number;
+  /** Shutter speed in seconds */
+  shutterSpeed?: number;
+  /** Aperture value (f-number) */
+  aperture?: number;
+  /** Focal length in mm */
+  focalLength?: number;
+  /** Timestamp of image capture */
+  timestamp?: number;
+}
+
+export interface LibRawAdvancedMetadata {
+  /** Normalized camera manufacturer */
+  normalizedMake?: string;
+  /** Normalized camera model */
+  normalizedModel?: string;
+  /** Number of RAW images in file */
+  rawCount: number;
+  /** DNG version number */
+  dngVersion: number;
+  /** Foveon sensor indicator */
+  is_foveon: number;
+  /** Color transformation matrix (4x3) */
+  colorMatrix: number[][];
+  /** Camera white balance multipliers */
+  camMul: number[];
+  /** Preprocessing multipliers */
+  preMul: number[];
+  /** Sensor black level */
+  blackLevel: number;
+  /** Maximum data value */
+  dataMaximum: number;
+  /** Sensor white level */
+  whiteLevel: number;
+}
+
+export interface LibRawImageSize {
+  /** Processed image width */
+  width: number;
+  /** Processed image height */
+  height: number;
+  /** RAW image width */
+  rawWidth: number;
+  /** RAW image height */
+  rawHeight: number;
+  /** Top margin in pixels */
+  topMargin: number;
+  /** Left margin in pixels */
+  leftMargin: number;
+  /** Internal width */
+  iWidth: number;
+  /** Internal height */
+  iHeight: number;
+}
+
+export interface LibRawLensInfo {
+  /** Lens name/model */
+  lensName?: string;
+  /** Lens manufacturer */
+  lensMake?: string;
+  /** Lens serial number */
+  lensSerial?: string;
+  /** Internal lens serial number */
+  internalLensSerial?: string;
+  /** Minimum focal length */
+  minFocal?: number;
+  /** Maximum focal length */
+  maxFocal?: number;
+  /** Maximum aperture at minimum focal length */
+  maxAp4MinFocal?: number;
+  /** Maximum aperture at maximum focal length */
+  maxAp4MaxFocal?: number;
+  /** EXIF maximum aperture */
+  exifMaxAp?: number;
+  /** Focal length in 35mm equivalent */
+  focalLengthIn35mmFormat?: number;
+}
+
+export interface LibRawColorInfo {
+  /** Number of color channels */
+  colors: number;
+  /** Color filter array pattern */
+  filters: number;
+  /** Sensor black level */
+  blackLevel: number;
+  /** Maximum data value */
+  dataMaximum: number;
+  /** Sensor white level */
+  whiteLevel: number;
+  /** Color profile length */
+  profileLength?: number;
+  /** RGB to camera space matrix (3x4) */
+  rgbCam: number[][];
+  /** Camera white balance multipliers */
+  camMul: number[];
+}
+
+export interface LibRawOutputParams {
+  /** Gamma correction curve [gamma, toe_slope] */
+  gamma?: [number, number];
+  /** Brightness adjustment (0.25-8.0) */
+  bright?: number;
+  /** Output color space (0=raw, 1=sRGB, 2=Adobe, 3=Wide, 4=ProPhoto, 5=XYZ, 6=ACES) */
+  output_color?: number;
+  /** Output bits per sample (8 or 16) */
+  output_bps?: number;
+  /** Manual white balance multipliers [R, G, B, G2] */
+  user_mul?: [number, number, number, number];
+  /** Disable automatic brightness adjustment */
+  no_auto_bright?: boolean;
+  /** Highlight recovery mode (0-9) */
+  highlight?: number;
+  /** Output TIFF format instead of PPM */
+  output_tiff?: boolean;
+}
+
+export interface LibRawImageData {
+  /** Image type (1=JPEG, 3=PPM/TIFF) */
+  type: number;
+  /** Image height in pixels */
+  height: number;
+  /** Image width in pixels */
+  width: number;
+  /** Number of color channels */
+  colors: number;
+  /** Bits per channel */
+  bits: number;
+  /** Total data size in bytes */
+  dataSize: number;
+  /** Raw image data buffer */
+  data: Buffer;
+}
+
+export interface LibRawJPEGOptions {
+  /** JPEG quality (1-100) */
+  quality?: number;
+  /** Target width (maintains aspect ratio if height not specified) */
+  width?: number;
+  /** Target height (maintains aspect ratio if width not specified) */
+  height?: number;
+  /** Use progressive JPEG */
+  progressive?: boolean;
+  /** Use mozjpeg encoder for better compression */
+  mozjpeg?: boolean;
+  /** Chroma subsampling ('4:4:4', '4:2:0') - Note: 4:2:2 maps to 4:4:4 */
+  chromaSubsampling?: '4:4:4' | '4:2:2' | '4:2:0';
+  /** Enable trellis quantisation */
+  trellisQuantisation?: boolean;
+  /** Optimize scan order */
+  optimizeScans?: boolean;
+  /** Overshoot deringing */
+  overshootDeringing?: boolean;
+  /** Optimize Huffman coding */
+  optimizeCoding?: boolean;
+  /** Output color space */
+  colorSpace?: 'srgb' | 'rec2020' | 'p3' | 'cmyk';
+  /** Enable fast mode for better performance */
+  fastMode?: boolean;
+  /** Encoding effort (1=fastest, 9=slowest) */
+  effort?: number;
+  /** Maximum concurrency for batch operations */
+  maxConcurrency?: number;
+}
+
+export interface LibRawOptimalSettings {
+  quality: number;
+  progressive: boolean;
+  mozjpeg: boolean;
+  chromaSubsampling: string;
+  effort: number;
+  reasoning: string;
+}
+
+export interface LibRawBufferResult {
+  /** Buffer creation success status */
+  success: boolean;
+  /** Raw binary data buffer */
+  buffer: Buffer;
+  /** Buffer metadata */
+  metadata: {
+    /** Original image dimensions */
+    originalDimensions?: {
+      width: number;
+      height: number;
     };
-  }
-
-  export interface LibRawBatchResult {
-    /** Successfully processed files */
-    successful: Array<{
-      input: string;
-      output: string;
-      result: LibRawJPEGResult;
-    }>;
-    /** Failed files */
-    failed: Array<{
-      input: string;
-      error: string;
-    }>;
-    /** Processing summary */
-    summary: {
-      total: number;
-      processed: number;
-      errors: number;
-      totalProcessingTime: number;
-      averageCompressionRatio: string;
-      totalOriginalSize: number;
-      totalCompressedSize: number;
-      averageProcessingTimePerFile: string;
+    /** Output image dimensions */
+    outputDimensions?: {
+      width: number;
+      height: number;
     };
-  }
-
-  export interface LibRawOptimalSettings {
-    /** Recommended JPEG settings */
-    recommended: LibRawJPEGOptions & {
-      reasoning: string[];
+    /** Processed dimensions */
+    dimensions?: {
+      width: number;
+      height: number;
+    };
+    /** File size information */
+    fileSize: {
+      original?: number;
+      compressed: number;
+      compressionRatio?: string;
+    };
+    /** Processing performance */
+    processing: {
+      timeMs: string;
+      throughputMBps?: string;
+      fromCache?: boolean;
+    };
+    /** Format-specific options */
+    jpegOptions?: object;
+    pngOptions?: object;
+    tiffOptions?: object;
+    webpOptions?: object;
+    avifOptions?: object;
+    /** Format type */
+    format?: string;
+  };
+}
+
+export interface LibRawImageConversionOptions {
+  /** Target width (maintains aspect ratio if height not specified) */
+  width?: number;
+  /** Target height (maintains aspect ratio if width not specified) */
+  height?: number;
+  /** Output color space */
+  colorSpace?: 'srgb' | 'rec2020' | 'p3' | 'cmyk';
+  /** Enable fast mode for better performance */
+  fastMode?: boolean;
+}
+
+export interface LibRawPNGOptions extends LibRawImageConversionOptions {
+  /** PNG compression level (0-9) */
+  compressionLevel?: number;
+  /** Use progressive PNG */
+  progressive?: boolean;
+}
+
+export interface LibRawTIFFOptions extends LibRawImageConversionOptions {
+  /** TIFF compression type */
+  compression?: 'none' | 'lzw' | 'jpeg' | 'zip';
+  /** JPEG quality when using JPEG compression */
+  quality?: number;
+  /** Create pyramidal TIFF */
+  pyramid?: boolean;
+}
+
+export interface LibRawWebPOptions extends LibRawImageConversionOptions {
+  /** WebP quality (1-100) */
+  quality?: number;
+  /** Use lossless WebP */
+  lossless?: boolean;
+  /** Encoding effort (0-6) */
+  effort?: number;
+}
+
+export interface LibRawAVIFOptions extends LibRawImageConversionOptions {
+  /** AVIF quality (1-100) */
+  quality?: number;
+  /** Use lossless AVIF */
+  lossless?: boolean;
+  /** Encoding effort (0-9) */
+  effort?: number;
+}
+
+export interface LibRawThumbnailJPEGOptions {
+  /** JPEG quality (1-100) */
+  quality?: number;
+  /** Maximum dimension size */
+  maxSize?: number;
+}
+
+export interface LibRawJPEGResult {
+  /** Conversion success status */
+  success: boolean;
+  /** Output file path */
+  outputPath: string;
+  /** Conversion metadata */
+  metadata: {
+    /** Original image dimensions */
+    originalDimensions: {
+      width: number;
+      height: number;
     };
-    /** Image analysis results */
-    imageAnalysis: {
-      dimensions: {
-        width: number;
-        height: number;
-        area: number;
-      };
-      category: 'high-resolution' | 'medium-resolution' | 'low-resolution';
-      camera: {
-        make?: string;
-        model?: string;
-      };
+    /** Output image dimensions */
+    outputDimensions: {
+      width: number;
+      height: number;
     };
-  }
-
-  export class LibRaw {
-    constructor();
-
-    // ============== FILE OPERATIONS ==============
-    /**
-     * Load RAW image from file
-     * @param filename Path to RAW image file
-     */
-    loadFile(filename: string): Promise<boolean>;
-
-    /**
-     * Load RAW image from buffer
-     * @param buffer Binary data buffer containing RAW image
-     */
-    loadBuffer(buffer: Buffer): Promise<boolean>;
-
-    /**
-     * Close current image and free resources
-     */
-    close(): Promise<boolean>;
-
-    // ============== METADATA & INFORMATION ==============
-    /**
-     * Get basic image metadata and EXIF information
-     */
-    getMetadata(): Promise<LibRawMetadata>;
-
-    /**
-     * Get image size and margin information
-     */
-    getImageSize(): Promise<LibRawImageSize>;
-
-    /**
-     * Get advanced metadata including color matrices
-     */
-    getAdvancedMetadata(): Promise<LibRawAdvancedMetadata>;
-
-    /**
-     * Get lens information from EXIF data
-     */
-    getLensInfo(): Promise<LibRawLensInfo>;
-
-    /**
-     * Get color space and sensor information
-     */
-    getColorInfo(): Promise<LibRawColorInfo>;
-
-    // ============== IMAGE PROCESSING ==============
-    /**
-     * Unpack thumbnail from RAW file
-     */
-    unpackThumbnail(): Promise<boolean>;
-
-    /**
-     * Process RAW image with current settings
-     */
-    processImage(): Promise<boolean>;
-
-    /**
-     * Subtract black level from image data
-     */
-    subtractBlack(): Promise<boolean>;
-
-    /**
-     * Convert RAW data to RGB image
-     */
-    raw2Image(): Promise<boolean>;
-
-    /**
-     * Adjust image maximum values
-     */
-    adjustMaximum(): Promise<boolean>;
-
-    // ============== MEMORY IMAGE CREATION ==============
-    /**
-     * Create processed image in memory
-     */
-    createMemoryImage(): Promise<LibRawImageData>;
-
-    /**
-     * Create thumbnail image in memory
-     */
-    createMemoryThumbnail(): Promise<LibRawImageData>;
-
-    // ============== FILE WRITERS ==============
-    /**
-     * Write processed image as PPM file
-     * @param filename Output PPM file path
-     */
-    writePPM(filename: string): Promise<boolean>;
-
-    /**
-     * Write processed image as TIFF file
-     * @param filename Output TIFF file path
-     */
-    writeTIFF(filename: string): Promise<boolean>;
-
-    /**
-     * Write thumbnail as JPEG file
-     * @param filename Output JPEG file path
-     */
-    writeThumbnail(filename: string): Promise<boolean>;
-
-    // ============== CONFIGURATION & SETTINGS ==============
-    /**
-     * Set output processing parameters
-     * @param params Output parameters configuration
-     */
-    setOutputParams(params: LibRawOutputParams): Promise<boolean>;
-
-    /**
-     * Get current output processing parameters
-     */
-    getOutputParams(): Promise<LibRawOutputParams>;
-
-    // ============== UTILITY FUNCTIONS ==============
-    /**
-     * Check if image uses floating point values
-     */
-    isFloatingPoint(): Promise<boolean>;
-
-    /**
-     * Check if image is from Fuji camera and rotated
-     */
-    isFujiRotated(): Promise<boolean>;
-
-    /**
-     * Check if image is sRAW format
-     */
-    isSRAW(): Promise<boolean>;
-
-    /**
-     * Check if file contains JPEG thumbnail
-     */
-    isJPEGThumb(): Promise<boolean>;
-
-    /**
-     * Get current error count
-     */
-    errorCount(): Promise<number>;
-
-    // ============== JPEG CONVERSION (NEW FEATURE) ==============
-    /**
-     * Convert RAW to JPEG with advanced options
-     * @param outputPath Output JPEG file path
-     * @param options JPEG conversion options
-     */
-    convertToJPEG(outputPath: string, options?: LibRawJPEGOptions): Promise<LibRawJPEGResult>;
-
-    /**
-     * Batch convert multiple RAW files to JPEG
-     * @param inputPaths Array of input RAW file paths
-     * @param outputDir Output directory for JPEG files
-     * @param options JPEG conversion options
-     */
-    batchConvertToJPEG(inputPaths: string[], outputDir: string, options?: LibRawJPEGOptions): Promise<LibRawBatchResult>;
-
-    /**
-     * Get optimal JPEG conversion settings based on image analysis
-     * @param analysisOptions Options for image analysis
-     */
-    getOptimalJPEGSettings(analysisOptions?: { usage?: 'web' | 'print' | 'archive' }): Promise<LibRawOptimalSettings>;
-
-    /**
-     * High-performance JPEG conversion with minimal processing for speed
-     * @param outputPath Output JPEG file path
-     * @param options Speed-optimized JPEG options
-     */
-    convertToJPEGFast(outputPath: string, options?: LibRawJPEGOptions): Promise<LibRawJPEGResult>;
-
-    /**
-     * Create multiple JPEG sizes from single RAW (thumbnail, web, full)
-     * @param baseOutputPath Base output path (without extension)
-     * @param options Multi-size options
-     */
-    convertToJPEGMultiSize(baseOutputPath: string, options?: {
-      sizes?: Array<{
-        name: string;
-        width?: number;
-        height?: number;
-        quality?: number;
-        progressive?: boolean;
-        mozjpeg?: boolean;
-        chromaSubsampling?: string;
-        effort?: number;
-      }>;
-    }): Promise<{
-      success: boolean;
-      sizes: Record<string, {
-        name: string;
-        outputPath: string;
-        dimensions: { width: number; height: number };
-        fileSize: number;
-        processingTime: number;
-        config: any;
-      }>;
-      originalDimensions: { width: number; height: number };
-      totalProcessingTime: number;
-      averageTimePerSize: string;
+    /** File size information */
+    fileSize: {
+      original: number;
+      compressed: number;
+      compressionRatio: string;
+    };
+    /** Processing performance */
+    processing: {
+      timeMs: string;
+      throughputMBps: string;
+    };
+    /** Applied JPEG options */
+    jpegOptions: object;
+  };
+}
+
+export interface LibRawBatchResult {
+  /** Successfully processed files */
+  successful: Array<{
+    input: string;
+    output: string;
+    result: LibRawJPEGResult;
+  }>;
+  /** Failed files */
+  failed: Array<{
+    input: string;
+    error: string;
+  }>;
+  /** Processing summary */
+  summary: {
+    total: number;
+    processed: number;
+    errors: number;
+    totalProcessingTime: number;
+    averageCompressionRatio: string;
+    totalOriginalSize: number;
+    totalCompressedSize: number;
+    averageProcessingTimePerFile: string;
+  };
+}
+
+export interface LibRawOptimalSettings {
+  /** Recommended JPEG settings */
+  recommended: LibRawJPEGOptions & {
+    reasoning: string[];
+  };
+  /** Image analysis results */
+  imageAnalysis: {
+    dimensions: {
+      width: number;
+      height: number;
+      area: number;
+    };
+    category: 'high-resolution' | 'medium-resolution' | 'low-resolution';
+    camera: {
+      make?: string;
+      model?: string;
+    };
+  };
+}
+
+export declare class LibRaw {
+  constructor();
+
+  // ============== FILE OPERATIONS ==============
+  /**
+   * Load RAW image from file
+   * @param filename Path to RAW image file
+   */
+  loadFile(filename: string): Promise<boolean>;
+
+  /**
+   * Load RAW image from buffer
+   * @param buffer Binary data buffer containing RAW image
+   */
+  loadBuffer(buffer: Buffer): Promise<boolean>;
+
+  /**
+   * Close current image and free resources
+   */
+  close(): Promise<boolean>;
+
+  // ============== METADATA & INFORMATION ==============
+  /**
+   * Get basic image metadata and EXIF information
+   */
+  getMetadata(): Promise<LibRawMetadata>;
+
+  /**
+   * Get image size and margin information
+   */
+  getImageSize(): Promise<LibRawImageSize>;
+
+  /**
+   * Get advanced metadata including color matrices
+   */
+  getAdvancedMetadata(): Promise<LibRawAdvancedMetadata>;
+
+  /**
+   * Get lens information from EXIF data
+   */
+  getLensInfo(): Promise<LibRawLensInfo>;
+
+  /**
+   * Get color space and sensor information
+   */
+  getColorInfo(): Promise<LibRawColorInfo>;
+
+  // ============== IMAGE PROCESSING ==============
+  /**
+   * Unpack thumbnail from RAW file
+   */
+  unpackThumbnail(): Promise<boolean>;
+
+  /**
+   * Process RAW image with current settings
+   */
+  processImage(): Promise<boolean>;
+
+  /**
+   * Subtract black level from image data
+   */
+  subtractBlack(): Promise<boolean>;
+
+  /**
+   * Convert RAW data to RGB image
+   */
+  raw2Image(): Promise<boolean>;
+
+  /**
+   * Adjust image maximum values
+   */
+  adjustMaximum(): Promise<boolean>;
+
+  // ============== MEMORY IMAGE CREATION ==============
+  /**
+   * Create processed image in memory
+   */
+  createMemoryImage(): Promise<LibRawImageData>;
+
+  /**
+   * Create thumbnail image in memory
+   */
+  createMemoryThumbnail(): Promise<LibRawImageData>;
+
+  // ============== FILE WRITERS ==============
+  /**
+   * Write processed image as PPM file
+   * @param filename Output PPM file path
+   */
+  writePPM(filename: string): Promise<boolean>;
+
+  /**
+   * Write processed image as TIFF file
+   * @param filename Output TIFF file path
+   */
+  writeTIFF(filename: string): Promise<boolean>;
+
+  /**
+   * Write thumbnail as JPEG file
+   * @param filename Output JPEG file path
+   */
+  writeThumbnail(filename: string): Promise<boolean>;
+
+  // ============== CONFIGURATION & SETTINGS ==============
+  /**
+   * Set output processing parameters
+   * @param params Output parameters configuration
+   */
+  setOutputParams(params: LibRawOutputParams): Promise<boolean>;
+
+  /**
+   * Get current output processing parameters
+   */
+  getOutputParams(): Promise<LibRawOutputParams>;
+
+  // ============== UTILITY FUNCTIONS ==============
+  /**
+   * Check if image uses floating point values
+   */
+  isFloatingPoint(): Promise<boolean>;
+
+  /**
+   * Check if image is from Fuji camera and rotated
+   */
+  isFujiRotated(): Promise<boolean>;
+
+  /**
+   * Check if image is sRAW format
+   */
+  isSRAW(): Promise<boolean>;
+
+  /**
+   * Check if file contains JPEG thumbnail
+   */
+  isJPEGThumb(): Promise<boolean>;
+
+  /**
+   * Get current error count
+   */
+  errorCount(): Promise<number>;
+
+  // ============== MEMORY STREAM OPERATIONS (NEW FEATURE) ==============
+  /**
+   * Create processed image as JPEG buffer in memory
+   * @param options JPEG conversion options
+   */
+  createJPEGBuffer(options?: LibRawJPEGOptions): Promise<LibRawBufferResult>;
+
+  /**
+   * Create processed image as PNG buffer in memory
+   * @param options PNG conversion options
+   */
+  createPNGBuffer(options?: LibRawPNGOptions): Promise<LibRawBufferResult>;
+
+  /**
+   * Create processed image as TIFF buffer in memory
+   * @param options TIFF conversion options
+   */
+  createTIFFBuffer(options?: LibRawTIFFOptions): Promise<LibRawBufferResult>;
+
+  /**
+   * Create processed image as WebP buffer in memory
+   * @param options WebP conversion options
+   */
+  createWebPBuffer(options?: LibRawWebPOptions): Promise<LibRawBufferResult>;
+
+  /**
+   * Create processed image as AVIF buffer in memory
+   * @param options AVIF conversion options
+   */
+  createAVIFBuffer(options?: LibRawAVIFOptions): Promise<LibRawBufferResult>;
+
+  /**
+   * Create raw PPM buffer from processed image data
+   */
+  createPPMBuffer(): Promise<LibRawBufferResult>;
+
+  /**
+   * Create thumbnail as JPEG buffer in memory
+   * @param options JPEG options for thumbnail
+   */
+  createThumbnailJPEGBuffer(options?: LibRawThumbnailJPEGOptions): Promise<LibRawBufferResult>;
+
+  // ============== JPEG CONVERSION (NEW FEATURE) ==============
+  /**
+   * Convert RAW to JPEG with advanced options
+   * @param outputPath Output JPEG file path
+   * @param options JPEG conversion options
+   */
+  convertToJPEG(outputPath: string, options?: LibRawJPEGOptions): Promise<LibRawJPEGResult>;
+
+  /**
+   * Batch convert multiple RAW files to JPEG
+   * @param inputPaths Array of input RAW file paths
+   * @param outputDir Output directory for JPEG files
+   * @param options JPEG conversion options
+   */
+  batchConvertToJPEG(inputPaths: string[], outputDir: string, options?: LibRawJPEGOptions): Promise<LibRawBatchResult>;
+
+  /**
+   * Get optimal JPEG conversion settings based on image analysis
+   * @param analysisOptions Options for image analysis
+   */
+  getOptimalJPEGSettings(analysisOptions?: { usage?: 'web' | 'print' | 'archive' }): Promise<LibRawOptimalSettings>;
+
+  /**
+   * High-performance JPEG conversion with minimal processing for speed
+   * @param outputPath Output JPEG file path
+   * @param options Speed-optimized JPEG options
+   */
+  convertToJPEGFast(outputPath: string, options?: LibRawJPEGOptions): Promise<LibRawJPEGResult>;
+
+  /**
+   * Create multiple JPEG sizes from single RAW (thumbnail, web, full)
+   * @param baseOutputPath Base output path (without extension)
+   * @param options Multi-size options
+   */
+  convertToJPEGMultiSize(baseOutputPath: string, options?: {
+    sizes?: Array<{
+      name: string;
+      width?: number;
+      height?: number;
+      quality?: number;
+      progressive?: boolean;
+      mozjpeg?: boolean;
+      chromaSubsampling?: string;
+      effort?: number;
     }>;
-
-    // ============== STATIC METHODS ==============
-    /**
-     * Get LibRaw library version
-     */
-    static getVersion(): string;
-
-    /**
-     * Get LibRaw library capabilities bitmask
-     */
-    static getCapabilities(): number;
-
-    /**
-     * Get list of supported camera models
-     */
-    static getCameraList(): string[];
-
-    /**
-     * Get count of supported camera models
-     */
-    static getCameraCount(): number;
-  }
-
-  export = LibRaw;
-}
+  }): Promise<{
+    success: boolean;
+    sizes: Record<string, {
+      name: string;
+      outputPath: string;
+      dimensions: { width: number; height: number };
+      fileSize: number;
+      processingTime: number;
+      config: any;
+    }>;
+    originalDimensions: { width: number; height: number };
+    totalProcessingTime: number;
+    averageTimePerSize: string;
+  }>;
+
+  // ============== STATIC METHODS ==============
+  /**
+   * Get LibRaw library version
+   */
+  static getVersion(): string;
+
+  /**
+   * Get LibRaw library capabilities bitmask
+   */
+  static getCapabilities(): number;
+
+  /**
+   * Get list of supported camera models
+   */
+  static getCameraList(): string[];
+
+  /**
+   * Get count of supported camera models
+   */
+  static getCameraCount(): number;
+}
+
+declare const LibRaw: {
+  new (): LibRaw;
+  getVersion(): string;
+  getCapabilities(): number;
+  getCameraList(): string[];
+  getCameraCount(): number;
+};
+
+export = LibRaw;