@ereo/plugin-images 0.1.6

package/dist/components/types.d.ts

@@ -0,0 +1,380 @@
+/**
+ * @ereo/plugin-images - Component Type Definitions
+ *
+ * TypeScript interfaces for the Image and Picture components.
+ */
+import type { CSSProperties, ImgHTMLAttributes } from 'react';
+/**
+ * Static image data from importing an image file.
+ * This is the shape of the object returned when you import an image.
+ *
+ * @example
+ * import heroImg from './hero.jpg';
+ * // heroImg: StaticImageData
+ */
+export interface StaticImageData {
+    /** Source URL of the image */
+    src: string;
+    /** Original width in pixels */
+    width: number;
+    /** Original height in pixels */
+    height: number;
+    /** Base64 encoded blur placeholder (if generated) */
+    blurDataURL?: string;
+    /** Dominant color (if extracted) */
+    dominantColor?: string;
+    /** MIME type of the original image */
+    type?: string;
+}
+/**
+ * Placeholder type for image loading states.
+ */
+export type PlaceholderType = 'blur' | 'color' | 'shimmer' | 'empty';
+/**
+ * Object fit values for fill mode.
+ */
+export type ObjectFit = 'contain' | 'cover' | 'fill' | 'none' | 'scale-down';
+/**
+ * Object position values for fill mode.
+ */
+export type ObjectPosition = CSSProperties['objectPosition'];
+/**
+ * Loading attribute values.
+ */
+export type ImageLoading = 'lazy' | 'eager';
+/**
+ * Decoding attribute values.
+ */
+export type ImageDecoding = 'async' | 'sync' | 'auto';
+/**
+ * Custom loader function for generating image URLs.
+ */
+export interface ImageLoaderParams {
+    src: string;
+    width: number;
+    quality?: number;
+}
+export type ImageLoader = (params: ImageLoaderParams) => string;
+/**
+ * Props for the Image component.
+ */
+export interface ImageProps extends Omit<ImgHTMLAttributes<HTMLImageElement>, 'src' | 'srcSet' | 'width' | 'height' | 'loading' | 'placeholder'> {
+    /**
+     * Image source - can be a URL string or imported StaticImageData.
+     */
+    src: string | StaticImageData;
+    /**
+     * Alt text for the image (required for accessibility).
+     */
+    alt: string;
+    /**
+     * Width of the image in pixels.
+     * Not required if using `fill` or if src is StaticImageData.
+     */
+    width?: number;
+    /**
+     * Height of the image in pixels.
+     * Not required if using `fill` or if src is StaticImageData.
+     */
+    height?: number;
+    /**
+     * Fill the parent container.
+     * Parent must have position: relative, absolute, or fixed.
+     */
+    fill?: boolean;
+    /**
+     * Object-fit CSS property when using fill mode.
+     * @default 'cover'
+     */
+    objectFit?: ObjectFit;
+    /**
+     * Object-position CSS property when using fill mode.
+     * @default 'center'
+     */
+    objectPosition?: ObjectPosition;
+    /**
+     * Aspect ratio to maintain (e.g., '16/9', '4/3').
+     * Can be used instead of explicit width/height.
+     */
+    aspectRatio?: string;
+    /**
+     * Sizes attribute for responsive images.
+     * Describes how wide the image will be at various breakpoints.
+     *
+     * @example
+     * sizes="(max-width: 768px) 100vw, 50vw"
+     */
+    sizes?: string;
+    /**
+     * Placeholder to show while loading.
+     * - 'blur': Use blurDataURL or auto-generated blur
+     * - 'color': Use dominant color as background
+     * - 'shimmer': Animated shimmer effect
+     * - 'empty': No placeholder (default)
+     */
+    placeholder?: PlaceholderType;
+    /**
+     * Custom blur data URL (base64).
+     * Only used when placeholder='blur'.
+     */
+    blurDataURL?: string;
+    /**
+     * Quality of the optimized image (1-100).
+     * @default 80
+     */
+    quality?: number;
+    /**
+     * Mark as high priority (preload).
+     * Use for above-the-fold images.
+     */
+    priority?: boolean;
+    /**
+     * Loading strategy.
+     * @default 'lazy' unless priority is true
+     */
+    loading?: ImageLoading;
+    /**
+     * Decoding strategy.
+     * @default 'async'
+     */
+    decoding?: ImageDecoding;
+    /**
+     * Custom loader function for generating image URLs.
+     * Useful for external image services (Cloudinary, Imgix, etc.).
+     */
+    loader?: ImageLoader;
+    /**
+     * Disable automatic optimization.
+     * Use when you need the original image.
+     */
+    unoptimized?: boolean;
+    /**
+     * Callback when the image has loaded.
+     */
+    onLoad?: (event: React.SyntheticEvent<HTMLImageElement>) => void;
+    /**
+     * Callback when loading fails.
+     */
+    onError?: (event: React.SyntheticEvent<HTMLImageElement>) => void;
+}
+/**
+ * Art direction source for Picture component.
+ */
+export interface PictureSource {
+    /**
+     * Image source for this breakpoint.
+     */
+    src: string | StaticImageData;
+    /**
+     * Media query for when to use this source.
+     * @example "(max-width: 640px)"
+     */
+    media?: string;
+    /**
+     * MIME type hint for the browser.
+     */
+    type?: string;
+    /**
+     * Width of this variant.
+     */
+    width?: number;
+    /**
+     * Height of this variant.
+     */
+    height?: number;
+    /**
+     * Sizes attribute for this source.
+     */
+    sizes?: string;
+}
+/**
+ * Props for the Picture component (art direction).
+ */
+export interface PictureProps extends Omit<ImageProps, 'src' | 'width' | 'height'> {
+    /**
+     * Array of sources for different breakpoints/formats.
+     * Listed in order of preference (first match wins).
+     */
+    sources: PictureSource[];
+    /**
+     * Fallback source (used when no source matches).
+     * If not provided, the last source in the array is used.
+     */
+    fallback?: string | StaticImageData;
+    /**
+     * Fallback width.
+     */
+    width?: number;
+    /**
+     * Fallback height.
+     */
+    height?: number;
+}
+/**
+ * Plugin configuration for image optimization.
+ */
+export interface ImagePluginConfig {
+    /**
+     * Allowed remote image patterns.
+     * Images from other domains will only be optimized if they match.
+     */
+    remotePatterns?: RemotePattern[];
+    /**
+     * Output formats to generate.
+     * @default { webp: true, avif: false }
+     */
+    formats?: {
+        webp?: boolean;
+        avif?: boolean;
+        jpeg?: boolean;
+        png?: boolean;
+    };
+    /**
+     * Default quality for optimized images.
+     * @default 80
+     */
+    quality?: number;
+    /**
+     * Device sizes for responsive images.
+     */
+    sizes?: {
+        /**
+         * Device widths for srcset generation.
+         * @default [640, 750, 828, 1080, 1200, 1920, 2048, 3840]
+         */
+        deviceSizes?: number[];
+        /**
+         * Image widths for srcset generation.
+         * @default [16, 32, 48, 64, 96, 128, 256, 384]
+         */
+        imageSizes?: number[];
+    };
+    /**
+     * Minimum size difference (%) to create a new variant.
+     * @default 20
+     */
+    minimumCacheTTL?: number;
+    /**
+     * Domains allowed for remote images (legacy, use remotePatterns).
+     * @deprecated Use remotePatterns instead
+     */
+    domains?: string[];
+    /**
+     * Directory for cached/optimized images.
+     * @default '.ereo/images'
+     */
+    cacheDir?: string;
+    /**
+     * Generate blur placeholders at build time.
+     * @default true
+     */
+    generateBlurPlaceholder?: boolean;
+    /**
+     * Extract dominant colors at build time.
+     * @default true
+     */
+    extractDominantColor?: boolean;
+    /**
+     * Maximum image dimension (width or height).
+     * @default 3840
+     */
+    maxDimension?: number;
+    /**
+     * Path prefix for optimized images.
+     * @default '/_ereo/image'
+     */
+    path?: string;
+    /**
+     * Dangerously allow any remote image.
+     * @default false
+     */
+    dangerouslyAllowAllRemote?: boolean;
+}
+/**
+ * Remote image pattern for allowlisting.
+ */
+export interface RemotePattern {
+    /**
+     * Protocol (http or https).
+     */
+    protocol?: 'http' | 'https';
+    /**
+     * Hostname pattern (supports wildcards).
+     * @example 'cdn.example.com' or '*.example.com'
+     */
+    hostname: string;
+    /**
+     * Port number.
+     */
+    port?: string;
+    /**
+     * Path prefix pattern.
+     * @example '/images/*'
+     */
+    pathname?: string;
+}
+/**
+ * Image manifest entry (stored at build time).
+ */
+export interface ImageManifestEntry {
+    /** Original source path */
+    src: string;
+    /** Original width */
+    width: number;
+    /** Original height */
+    height: number;
+    /** Generated variants */
+    variants: ImageVariant[];
+    /** Blur placeholder data URL */
+    blurDataURL?: string;
+    /** Dominant color */
+    dominantColor?: string;
+    /** File hash for cache busting */
+    hash: string;
+}
+/**
+ * Generated image variant.
+ */
+export interface ImageVariant {
+    /** Output path */
+    path: string;
+    /** Width */
+    width: number;
+    /** Height */
+    height: number;
+    /** Format */
+    format: 'webp' | 'avif' | 'jpeg' | 'png';
+    /** File size in bytes */
+    size: number;
+}
+/**
+ * Image optimization parameters (for runtime).
+ */
+export interface ImageOptimizationParams {
+    /** Source image path or URL */
+    src: string;
+    /** Target width */
+    width: number;
+    /** Target height (optional, maintains aspect ratio if omitted) */
+    height?: number;
+    /** Quality (1-100) */
+    quality?: number;
+    /** Output format */
+    format?: 'auto' | 'webp' | 'avif' | 'jpeg' | 'png';
+}
+/**
+ * Image processing result.
+ */
+export interface ProcessedImage {
+    /** Processed image buffer */
+    buffer: Buffer;
+    /** MIME type */
+    contentType: string;
+    /** Width */
+    width: number;
+    /** Height */
+    height: number;
+    /** Format */
+    format: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/types.d.ts.map

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

package/dist/config/defaults.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @ereo/plugin-images - Default Configuration
+ *
+ * Default values for the image optimization plugin.
+ */
+import type { ImagePluginConfig } from '../components/types';
+/**
+ * Default device sizes for responsive srcset generation.
+ * These cover common device widths from mobile to 4K.
+ */
+export declare const DEFAULT_DEVICE_SIZES: number[];
+/**
+ * Default image sizes for smaller images (icons, avatars, etc.).
+ */
+export declare const DEFAULT_IMAGE_SIZES: number[];
+/**
+ * All available widths for srcset (device sizes + image sizes, sorted).
+ */
+export declare const ALL_SIZES: number[];
+/**
+ * Default image quality (1-100).
+ */
+export declare const DEFAULT_QUALITY = 80;
+/**
+ * Maximum allowed dimension (width or height).
+ */
+export declare const MAX_DIMENSION = 3840;
+/**
+ * Minimum cache TTL in seconds.
+ */
+export declare const MIN_CACHE_TTL = 60;
+/**
+ * Default cache TTL in seconds (1 year).
+ */
+export declare const DEFAULT_CACHE_TTL = 31536000;
+/**
+ * Blur placeholder width (for generating tiny blur images).
+ */
+export declare const BLUR_WIDTH = 8;
+/**
+ * URL path prefix for the image optimization endpoint.
+ */
+export declare const IMAGE_PATH_PREFIX = "/_ereo/image";
+/**
+ * Cache directory for optimized images.
+ */
+export declare const CACHE_DIR = ".ereo/images";
+/**
+ * Supported input formats for processing.
+ */
+export declare const SUPPORTED_INPUT_FORMATS: string[];
+/**
+ * Supported output formats.
+ */
+export declare const SUPPORTED_OUTPUT_FORMATS: readonly ["webp", "avif", "jpeg", "png"];
+/**
+ * MIME types for image formats.
+ */
+export declare const FORMAT_MIME_TYPES: Record<string, string>;
+/**
+ * File extensions for image formats.
+ */
+export declare const FORMAT_EXTENSIONS: Record<string, string>;
+/**
+ * Default plugin configuration.
+ */
+export declare const DEFAULT_CONFIG: Required<ImagePluginConfig>;
+/**
+ * Get all available sizes for srcset generation.
+ */
+export declare function getAllSizes(config: ImagePluginConfig): number[];
+/**
+ * Get sizes appropriate for a given target width.
+ * Returns only sizes up to 2x the target width.
+ */
+export declare function getSizesForWidth(targetWidth: number, config: ImagePluginConfig): number[];
+//# sourceMappingURL=defaults.d.ts.map

package/dist/config/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,oBAAoB,UAAgD,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,mBAAmB,UAAsC,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,SAAS,UAErB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC;;GAEG;AACH,eAAO,MAAM,aAAa,OAAO,CAAC;AAElC;;GAEG;AACH,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC;;GAEG;AACH,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,UAAU,IAAI,CAAC;AAE5B;;GAEG;AACH,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,uBAAuB,UAAuD,CAAC;AAE5F;;GAEG;AACH,eAAO,MAAM,wBAAwB,0CAA2C,CAAC;AAEjF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQpD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMpD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,iBAAiB,CAqBtD,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAI/D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAIzF"}

package/dist/config/schema.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @ereo/plugin-images - Configuration Validation
+ *
+ * Schema validation for plugin configuration.
+ */
+import type { ImagePluginConfig, RemotePattern } from '../components/types';
+/**
+ * Validation error with details.
+ */
+export declare class ConfigValidationError extends Error {
+    field: string;
+    value: unknown;
+    constructor(message: string, field: string, value: unknown);
+}
+/**
+ * Validate and normalize plugin configuration.
+ */
+export declare function validateConfig(config?: ImagePluginConfig): Required<ImagePluginConfig>;
+/**
+ * Check if a URL matches the allowed remote patterns.
+ */
+export declare function matchesRemotePattern(url: URL, patterns: RemotePattern[], domains?: string[]): boolean;
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAG5E;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAGrC,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,OAAO;gBAFrB,OAAO,EAAE,MAAM,EACR,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO;CAKxB;AAyJD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,GAAE,iBAAsB,GAAG,QAAQ,CAAC,iBAAiB,CAAC,CA2E1F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,aAAa,EAAE,EACzB,OAAO,GAAE,MAAM,EAAO,GACrB,OAAO,CAyCT"}

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @ereo/plugin-images
+ *
+ * Complete image optimization system for EreoJS.
+ * Provides automatic image optimization, blur placeholders,
+ * responsive srcset generation, and art direction support.
+ *
+ * @example
+ * // ereo.config.ts
+ * import images from '@ereo/plugin-images';
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     images({
+ *       formats: { webp: true, avif: true },
+ *       quality: 80,
+ *     }),
+ *   ],
+ * });
+ *
+ * @example
+ * // In your components
+ * import { Image, Picture } from '@ereo/plugin-images/components';
+ * import heroImg from './hero.jpg';
+ *
+ * function Hero() {
+ *   return (
+ *     <Image
+ *       src={heroImg}
+ *       alt="Hero image"
+ *       placeholder="blur"
+ *       priority
+ *     />
+ *   );
+ * }
+ */
+export { imagesPlugin as default, imagesPlugin } from './plugin';
+export { Image, Picture } from './components/index';
+export type { ImageProps, PictureProps, PictureSource, StaticImageData, PlaceholderType, ObjectFit, ObjectPosition, ImageLoading, ImageDecoding, ImageLoader, ImageLoaderParams, ImagePluginConfig, RemotePattern, ImageManifestEntry, ImageVariant, ImageOptimizationParams, ProcessedImage, } from './components/types';
+export { createImageProcessor, ImageProcessor } from './processing/processor';
+export { createSharpProcessor, SharpProcessor } from './processing/sharp-processor';
+export { generateBlurPlaceholder, generateShimmerSVG, generateShimmerDataURL, } from './processing/blur';
+export { extractDominantColor, rgbToHex, hexToRgb, getContrastColor, } from './processing/color';
+export { createBuildOptimizer, optimizeImages, BuildOptimizer } from './build/optimizer';
+export { createManifestManager, ImageManifestManager } from './build/manifest';
+export { createImageMiddleware, imageMiddleware } from './runtime/middleware';
+export { MemoryCache, DiskCache, TwoTierCache, generateCacheKey } from './runtime/cache';
+export { validateConfig, matchesRemotePattern, ConfigValidationError } from './config/schema';
+export { DEFAULT_DEVICE_SIZES, DEFAULT_IMAGE_SIZES, DEFAULT_QUALITY, MAX_DIMENSION, IMAGE_PATH_PREFIX, SUPPORTED_INPUT_FORMATS, SUPPORTED_OUTPUT_FORMATS, FORMAT_MIME_TYPES, getAllSizes, getSizesForWidth, } from './config/defaults';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAGH,OAAO,EAAE,YAAY,IAAI,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGjE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGpD,YAAY,EACV,UAAU,EACV,YAAY,EACZ,aAAa,EACb,eAAe,EACf,eAAe,EACf,SAAS,EACT,cAAc,EACd,YAAY,EACZ,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,uBAAuB,EACvB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,oBAAoB,EACpB,QAAQ,EACR,QAAQ,EACR,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAG/E,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGzF,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC9F,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACxB,iBAAiB,EACjB,WAAW,EACX,gBAAgB,GACjB,MAAM,mBAAmB,CAAC"}