@ereo/plugin-images 0.1.6

package/dist/plugin.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @ereo/plugin-images - Plugin Implementation
+ *
+ * Core plugin that integrates image optimization into the EreoJS framework.
+ */
+import type { Plugin } from '@ereo/core';
+import type { ImagePluginConfig } from './components/types';
+/**
+ * Create the image optimization plugin.
+ *
+ * @param options - Plugin configuration
+ * @returns EreoJS plugin
+ *
+ * @example
+ * import images from '@ereo/plugin-images';
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     images({
+ *       formats: { webp: true, avif: true },
+ *       quality: 80,
+ *     }),
+ *   ],
+ * });
+ */
+export declare function imagesPlugin(options?: ImagePluginConfig): Plugin;
+export default imagesPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,MAAM,EAA4B,MAAM,YAAY,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAmB,MAAM,oBAAoB,CAAC;AA0B7E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAwLpE;AAeD,eAAe,YAAY,CAAC"}

package/dist/processing/blur.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @ereo/plugin-images - Blur Placeholder Generation
+ *
+ * Generate tiny blur placeholders for images (LQIP - Low Quality Image Placeholders).
+ */
+/**
+ * Options for blur placeholder generation.
+ */
+export interface BlurPlaceholderOptions {
+    /** Width of the placeholder (default: 8px) */
+    width?: number;
+    /** Quality for encoding (default: 10) */
+    quality?: number;
+    /** Blur sigma (default: 1) */
+    sigma?: number;
+}
+/**
+ * Result of blur placeholder generation.
+ */
+export interface BlurPlaceholderResult {
+    /** Base64-encoded data URL */
+    dataURL: string;
+    /** Width of the placeholder */
+    width: number;
+    /** Height of the placeholder */
+    height: number;
+}
+/**
+ * Generate a blur placeholder for an image.
+ *
+ * This creates a tiny (default 8px wide) blurred version of the image
+ * encoded as a base64 data URL. The browser can display this immediately
+ * while the full image loads, providing a smooth loading experience.
+ *
+ * @param input - Image buffer or file path
+ * @param options - Generation options
+ * @returns Base64-encoded data URL and dimensions
+ */
+export declare function generateBlurPlaceholder(input: Buffer | string, options?: BlurPlaceholderOptions): Promise<BlurPlaceholderResult>;
+/**
+ * Generate a blur placeholder optimized for CSS background.
+ *
+ * This version uses even more aggressive compression for minimal size.
+ *
+ * @param input - Image buffer or file path
+ * @returns Base64-encoded data URL
+ */
+export declare function generateCSSBlurPlaceholder(input: Buffer | string): Promise<string>;
+/**
+ * Generate a blur hash string.
+ *
+ * This is a compact representation that can be decoded client-side
+ * without needing the actual image data embedded.
+ *
+ * Note: This is a simplified implementation. For production,
+ * consider using the blurhash library for smaller strings.
+ *
+ * @param input - Image buffer or file path
+ * @returns Blur placeholder result
+ */
+export declare function generateBlurHash(input: Buffer | string): Promise<BlurPlaceholderResult>;
+/**
+ * Generate a shimmer placeholder SVG.
+ *
+ * This creates an animated gradient placeholder that shows
+ * a shimmer effect while the image loads.
+ *
+ * @param width - Width of the placeholder
+ * @param height - Height of the placeholder
+ * @param color - Base color (default: '#f3f4f6')
+ * @returns SVG string
+ */
+export declare function generateShimmerSVG(width: number, height: number, color?: string): string;
+/**
+ * Generate a shimmer placeholder as a data URL.
+ */
+export declare function generateShimmerDataURL(width: number, height: number, color?: string): string;
+//# sourceMappingURL=blur.d.ts.map

package/dist/processing/blur.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blur.d.ts","sourceRoot":"","sources":["../../src/processing/blur.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAoChC;AAED;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQxF;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAuC7F;AAiCD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAkB,GACxB,MAAM,CAiBR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAIR"}

package/dist/processing/color.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @ereo/plugin-images - Dominant Color Extraction
+ *
+ * Extract dominant colors from images using k-means clustering.
+ */
+/**
+ * RGB color representation.
+ */
+export interface RGBColor {
+    r: number;
+    g: number;
+    b: number;
+}
+/**
+ * Color extraction result.
+ */
+export interface ColorExtractionResult {
+    /** Primary dominant color */
+    dominant: string;
+    /** Palette of dominant colors */
+    palette: string[];
+    /** Primary color as RGB object */
+    dominantRGB: RGBColor;
+    /** Whether the image has significant transparency */
+    hasTransparency: boolean;
+}
+/**
+ * Options for color extraction.
+ */
+export interface ColorExtractionOptions {
+    /** Number of colors to extract (default: 5) */
+    colorCount?: number;
+    /** Sample size for analysis (default: 64) */
+    sampleSize?: number;
+    /** Minimum saturation for "colorful" detection (default: 0.1) */
+    minSaturation?: number;
+    /** Transparency threshold (default: 0.5) */
+    transparencyThreshold?: number;
+}
+/**
+ * Extract dominant colors from an image using k-means clustering.
+ *
+ * @param input - Image buffer or file path
+ * @param options - Extraction options
+ * @returns Dominant color and palette
+ */
+export declare function extractDominantColor(input: Buffer | string, options?: ColorExtractionOptions): Promise<ColorExtractionResult>;
+/**
+ * Convert RGB to hex color.
+ */
+export declare function rgbToHex(color: RGBColor): string;
+/**
+ * Convert hex to RGB color.
+ */
+export declare function hexToRgb(hex: string): RGBColor;
+/**
+ * Get a contrasting text color (black or white) for a background.
+ */
+export declare function getContrastColor(background: RGBColor): string;
+//# sourceMappingURL=color.d.ts.map

package/dist/processing/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/processing/color.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kCAAkC;IAClC,WAAW,EAAE,QAAQ,CAAC;IACtB,qDAAqD;IACrD,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAoFhC;AAqKD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAGhD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAU9C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,QAAQ,GAAG,MAAM,CAI7D"}

package/dist/processing/processor.d.ts

@@ -0,0 +1,101 @@
+/**
+ * @ereo/plugin-images - Image Processing Orchestrator
+ *
+ * Coordinates image processing operations using the Sharp processor.
+ */
+import type { ImagePluginConfig, ProcessedImage, ImageOptimizationParams, StaticImageData } from '../components/types';
+import { type ImageMetadata } from './sharp-processor';
+import { type BlurPlaceholderResult } from './blur';
+import { type ColorExtractionResult } from './color';
+/**
+ * Image processing result with metadata.
+ */
+export interface ImageProcessingResult {
+    /** Processed image data */
+    processed: ProcessedImage;
+    /** Original metadata */
+    metadata: ImageMetadata;
+    /** Blur placeholder (if generated) */
+    blur?: BlurPlaceholderResult;
+    /** Color extraction result (if generated) */
+    colors?: ColorExtractionResult;
+}
+/**
+ * Full image data including all variants.
+ */
+export interface FullImageData {
+    /** Static image data for component consumption */
+    staticData: StaticImageData;
+    /** Original file path */
+    path: string;
+    /** All generated variants */
+    variants: Array<{
+        width: number;
+        height: number;
+        format: string;
+        path: string;
+        buffer: Buffer;
+    }>;
+}
+/**
+ * Image processor orchestrator.
+ */
+export declare class ImageProcessor {
+    private readonly config;
+    private readonly sharp;
+    private readonly cache;
+    constructor(config?: ImagePluginConfig);
+    /**
+     * Process a single image with given parameters.
+     */
+    process(input: Buffer | string, params: ImageOptimizationParams): Promise<ProcessedImage>;
+    /**
+     * Process an image and generate all metadata.
+     */
+    processWithMetadata(input: Buffer | string, params: ImageOptimizationParams): Promise<ImageProcessingResult>;
+    /**
+     * Process a local image file and generate all variants.
+     */
+    processFile(filePath: string): Promise<FullImageData>;
+    /**
+     * Get image metadata without processing.
+     */
+    getMetadata(input: Buffer | string): Promise<ImageMetadata>;
+    /**
+     * Generate blur placeholder for an image.
+     */
+    generateBlur(input: Buffer | string): Promise<BlurPlaceholderResult>;
+    /**
+     * Extract dominant color from an image.
+     */
+    extractColor(input: Buffer | string): Promise<ColorExtractionResult>;
+    /**
+     * Check if a file is a supported image format.
+     */
+    isSupported(filePath: string): boolean;
+    /**
+     * Clear the processing cache.
+     */
+    clearCache(): void;
+    /**
+     * Get enabled output formats based on config and image type.
+     */
+    private getEnabledFormats;
+    /**
+     * Generate a path for a variant file.
+     */
+    private getVariantPath;
+    /**
+     * Generate a cache key for a processing operation.
+     */
+    private getCacheKey;
+    /**
+     * Simple hash for buffer content.
+     */
+    private hashBuffer;
+}
+/**
+ * Create a new image processor instance.
+ */
+export declare function createImageProcessor(config?: ImagePluginConfig): ImageProcessor;
+//# sourceMappingURL=processor.d.ts.map

package/dist/processing/processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.d.ts","sourceRoot":"","sources":["../../src/processing/processor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,eAAe,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAA6C,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClG,OAAO,EAA2B,KAAK,qBAAqB,EAAE,MAAM,QAAQ,CAAC;AAC7E,OAAO,EAAwB,KAAK,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAI3E;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,2BAA2B;IAC3B,SAAS,EAAE,cAAc,CAAC;IAC1B,wBAAwB;IACxB,QAAQ,EAAE,aAAa,CAAC;IACxB,sCAAsC;IACtC,IAAI,CAAC,EAAE,qBAAqB,CAAC;IAC7B,6CAA6C;IAC7C,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,UAAU,EAAE,eAAe,CAAC;IAC5B,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,QAAQ,EAAE,KAAK,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;gBAE/C,MAAM,GAAE,iBAAsB;IAQ1C;;OAEG;IACG,OAAO,CACX,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,cAAc,CAAC;IAmB1B;;OAEG;IACG,mBAAmB,CACvB,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,qBAAqB,CAAC;IAmCjC;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAyG3D;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAIjE;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI1E;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI1E;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKtC;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,WAAW;IASnB;;OAEG;IACH,OAAO,CAAC,UAAU;CAOnB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,cAAc,CAE/E"}

package/dist/processing/sharp-processor.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @ereo/plugin-images - Sharp-based Image Processor
+ *
+ * Core image processing using the Sharp library.
+ */
+import sharp from 'sharp';
+import type { ProcessedImage, ImageOptimizationParams } from '../components/types';
+/**
+ * Sharp processor options.
+ */
+export interface SharpProcessorOptions {
+    /** Default quality (1-100) */
+    quality?: number;
+    /** Maximum dimension */
+    maxDimension?: number;
+    /** Enable caching */
+    cache?: boolean;
+}
+/**
+ * Image metadata from Sharp.
+ */
+export interface ImageMetadata {
+    width: number;
+    height: number;
+    format: string;
+    space?: string;
+    channels?: number;
+    depth?: string;
+    density?: number;
+    hasAlpha?: boolean;
+    orientation?: number;
+}
+/**
+ * Sharp-based image processor.
+ */
+export declare class SharpProcessor {
+    private readonly quality;
+    private readonly maxDimension;
+    constructor(options?: SharpProcessorOptions);
+    /**
+     * Process an image with the given parameters.
+     */
+    process(input: Buffer | string, params: ImageOptimizationParams): Promise<ProcessedImage>;
+    /**
+     * Get image metadata without processing.
+     */
+    getMetadata(input: Buffer | string): Promise<ImageMetadata>;
+    /**
+     * Resize an image to specific dimensions.
+     */
+    resize(input: Buffer | string, width: number, height?: number, options?: Partial<sharp.ResizeOptions>): Promise<Buffer>;
+    /**
+     * Convert image to a specific format.
+     */
+    toFormat(input: Buffer | string, format: 'webp' | 'avif' | 'jpeg' | 'png', quality?: number): Promise<Buffer>;
+    /**
+     * Check if an image has transparency.
+     */
+    hasTransparency(input: Buffer | string): Promise<boolean>;
+    /**
+     * Rotate image based on EXIF orientation and optionally strip metadata.
+     */
+    normalize(input: Buffer | string): Promise<Buffer>;
+    /**
+     * Get dominant colors from an image.
+     * This is a simple implementation - color.ts has a more sophisticated version.
+     */
+    getDominantColor(input: Buffer | string): Promise<string>;
+}
+/**
+ * Create a new Sharp processor instance.
+ */
+export declare function createSharpProcessor(options?: SharpProcessorOptions): SharpProcessor;
+//# sourceMappingURL=sharp-processor.d.ts.map

package/dist/processing/sharp-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharp-processor.d.ts","sourceRoot":"","sources":["../../src/processing/sharp-processor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAGnF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,OAAO,GAAE,qBAA0B;IAU/C;;OAEG;IACG,OAAO,CACX,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,cAAc,CAAC;IAuF1B;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAoBjE;;OAEG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,GAAE,OAAO,CAAC,KAAK,CAAC,aAAa,CAAM,GACzC,OAAO,CAAC,MAAM,CAAC;IAYlB;;OAEG;IACG,QAAQ,CACZ,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,EACxC,OAAO,GAAE,MAAqB,GAC7B,OAAO,CAAC,MAAM,CAAC;IAqBlB;;OAEG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK/D;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIxD;;;OAGG;IACG,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAOhE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,cAAc,CAEpF"}

package/dist/runtime/cache.d.ts

@@ -0,0 +1,276 @@
+/**
+ * @ereo/plugin-images - Transform Cache Management
+ *
+ * LRU memory cache and disk cache for optimized images.
+ * Implements the unified CacheAdapter interface from @ereo/core.
+ */
+import type { CacheAdapter, CacheSetOptions } from '@ereo/core';
+/**
+ * LRU memory cache options.
+ */
+export interface MemoryCacheOptions {
+    /** Maximum number of items */
+    maxItems?: number;
+    /** Maximum total size in bytes */
+    maxSize?: number;
+    /** TTL in milliseconds (0 = no expiry) */
+    ttl?: number;
+}
+/**
+ * LRU memory cache for image buffers.
+ */
+export declare class MemoryCache {
+    private readonly cache;
+    private readonly maxItems;
+    private readonly maxSize;
+    private readonly ttl;
+    private currentSize;
+    constructor(options?: MemoryCacheOptions);
+    /**
+     * Get an item from cache.
+     */
+    get(key: string): Buffer | undefined;
+    /**
+     * Set an item in cache.
+     */
+    set(key: string, value: Buffer): void;
+    /**
+     * Check if key exists in cache.
+     */
+    has(key: string): boolean;
+    /**
+     * Delete an item from cache.
+     */
+    delete(key: string): boolean;
+    /**
+     * Clear the cache.
+     */
+    clear(): void;
+    /**
+     * Get cache statistics.
+     */
+    stats(): {
+        items: number;
+        size: number;
+        maxItems: number;
+        maxSize: number;
+    };
+    /**
+     * Evict the least recently used item.
+     */
+    private evictLRU;
+}
+/**
+ * Disk cache options.
+ */
+export interface DiskCacheOptions {
+    /** Cache directory */
+    dir: string;
+    /** Maximum total size in bytes */
+    maxSize?: number;
+    /** TTL in milliseconds (0 = no expiry) */
+    ttl?: number;
+}
+/**
+ * Disk cache for persisting optimized images.
+ */
+export declare class DiskCache {
+    private readonly dir;
+    private readonly maxSize;
+    private readonly ttl;
+    private initialized;
+    constructor(options: DiskCacheOptions);
+    /**
+     * Initialize the cache directory.
+     */
+    private init;
+    /**
+     * Generate a file path for a cache key.
+     */
+    private getPath;
+    /**
+     * Get an item from disk cache.
+     */
+    get(key: string): Promise<Buffer | undefined>;
+    /**
+     * Set an item in disk cache.
+     */
+    set(key: string, value: Buffer): Promise<void>;
+    /**
+     * Check if key exists in disk cache.
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Delete an item from disk cache.
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * Clean up expired entries.
+     */
+    cleanup(): Promise<{
+        deleted: number;
+        freed: number;
+    }>;
+    /**
+     * Get cache statistics.
+     */
+    stats(): Promise<{
+        files: number;
+        size: number;
+    }>;
+}
+/**
+ * Two-tier cache combining memory and disk.
+ */
+export declare class TwoTierCache {
+    private readonly memory;
+    private readonly disk;
+    constructor(options: {
+        memory?: MemoryCacheOptions;
+        disk: DiskCacheOptions;
+    });
+    /**
+     * Get an item from cache (checks memory first, then disk).
+     */
+    get(key: string): Promise<Buffer | undefined>;
+    /**
+     * Set an item in cache (writes to both memory and disk).
+     */
+    set(key: string, value: Buffer): Promise<void>;
+    /**
+     * Check if key exists in either cache.
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Delete from both caches.
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * Clear both caches.
+     */
+    clear(): Promise<void>;
+    /**
+     * Get combined statistics.
+     */
+    stats(): Promise<{
+        memory: {
+            items: number;
+            size: number;
+        };
+        disk: {
+            files: number;
+            size: number;
+        };
+    }>;
+    /**
+     * Clean up expired disk cache entries.
+     */
+    cleanup(): Promise<{
+        deleted: number;
+        freed: number;
+    }>;
+}
+/**
+ * Generate a cache key for image optimization parameters.
+ */
+export declare function generateCacheKey(params: {
+    src: string;
+    width: number;
+    height?: number;
+    quality?: number;
+    format?: string;
+}): string;
+/**
+ * Adapter to wrap MemoryCache as a CacheAdapter.
+ * Note: This adapter is specifically for Buffer values (images).
+ */
+export declare class MemoryCacheAdapter implements CacheAdapter {
+    private readonly cache;
+    constructor(options?: MemoryCacheOptions);
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T, options?: CacheSetOptions): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    has(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    /**
+     * Get cache statistics.
+     */
+    stats(): {
+        items: number;
+        size: number;
+        maxItems: number;
+        maxSize: number;
+    };
+}
+/**
+ * Adapter to wrap DiskCache as a CacheAdapter.
+ * Note: This adapter is specifically for Buffer values (images).
+ */
+export declare class DiskCacheAdapter implements CacheAdapter {
+    private readonly cache;
+    constructor(options: DiskCacheOptions);
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T, _options?: CacheSetOptions): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    has(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    /**
+     * Get cache statistics.
+     */
+    stats(): Promise<{
+        files: number;
+        size: number;
+    }>;
+    /**
+     * Clean up expired entries.
+     */
+    cleanup(): Promise<{
+        deleted: number;
+        freed: number;
+    }>;
+}
+/**
+ * Adapter to wrap TwoTierCache as a CacheAdapter.
+ * Note: This adapter is specifically for Buffer values (images).
+ */
+export declare class TwoTierCacheAdapter implements CacheAdapter {
+    private readonly cache;
+    constructor(options: {
+        memory?: MemoryCacheOptions;
+        disk: DiskCacheOptions;
+    });
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T, _options?: CacheSetOptions): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    has(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    /**
+     * Get combined statistics.
+     */
+    stats(): Promise<{
+        memory: {
+            items: number;
+            size: number;
+        };
+        disk: {
+            files: number;
+            size: number;
+        };
+    }>;
+    /**
+     * Clean up expired disk cache entries.
+     */
+    cleanup(): Promise<{
+        deleted: number;
+        freed: number;
+    }>;
+}
+/**
+ * Create a CacheAdapter-compatible image cache.
+ * Uses a two-tier (memory + disk) cache by default.
+ */
+export declare function createImageCacheAdapter(options: {
+    memory?: MemoryCacheOptions;
+    disk: DiskCacheOptions;
+}): CacheAdapter;
+//# sourceMappingURL=cache.d.ts.map

package/dist/runtime/cache.d.ts.map

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

package/dist/runtime/middleware.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @ereo/plugin-images - On-Demand Transform Middleware
+ *
+ * HTTP middleware for runtime image optimization.
+ */
+import type { AppContext, MiddlewareHandler } from '@ereo/core';
+import type { ImagePluginConfig } from '../components/types';
+/**
+ * Middleware options.
+ */
+export interface ImageMiddlewareOptions {
+    /** Project root directory */
+    root: string;
+    /** Plugin configuration */
+    config?: ImagePluginConfig;
+    /** Enable caching */
+    cache?: boolean;
+    /** Cache directory */
+    cacheDir?: string;
+}
+/**
+ * Create the image optimization middleware.
+ */
+export declare function createImageMiddleware(options: ImageMiddlewareOptions): (request: Request, context: AppContext, next: () => Promise<Response>) => Promise<Response>;
+/**
+ * Create a dev server middleware handler.
+ */
+export declare function imageMiddleware(options: ImageMiddlewareOptions): MiddlewareHandler;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/runtime/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/runtime/middleware.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAA2B,MAAM,qBAAqB,CAAC;AAatF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,qBAAqB;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA6GD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,IAsBjE,SAAS,OAAO,EAChB,SAAS,UAAU,EACnB,MAAM,MAAM,OAAO,CAAC,QAAQ,CAAC,KAC5B,OAAO,CAAC,QAAQ,CAAC,CA8ErB;AA+BD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,iBAAiB,CAUlF"}