img-upload-kit 1.1.1 → 2.0.0

package/dist/{types-CiLY0DwB.d.ts → upload-C5Trd6Dh.d.ts}

@@ -62,11 +62,18 @@ interface UploadPresetConfig {
     };
     /** Generate compact BlurHash string alongside WebP LQIP data URL */
     includeBlurHash?: boolean;
+    /** Opt-in to allow SVG uploads for this preset (sanitized before storage). Defaults to `false`. */
+    allowSvg?: boolean;
+    /** Maximum input pixel count allowed by Sharp (defaults to 50 MP = 50,000,000) */
+    limitInputPixels?: number;
+    /** Responsive variant widths in pixels (e.g. [640, 1024, 1920]); widths >= main image width are skipped */
+    variantWidths?: number[];
     /** Optional local directory to mirror uploaded files into */
     mirrorDir?: string;
     /** Optional public URL prefix when `mirrorDir` is used */
     publicUrlBase?: string;
 }
+declare const SVG_MIME_TYPE = "image/svg+xml";
 declare const DEFAULT_ALLOWED_FORMATS: string[];
 declare const RASTER_ALLOWED_FORMATS: string[];
 declare const DEFAULT_IMAGE_DIMENSIONS: ImageDimensions;
@@ -101,6 +108,23 @@ interface ImageUploadOptions<TPreset extends string = UploadPresetName> {
     metadata?: Record<string, string>;
     /** Generate compact BlurHash string alongside WebP LQIP data URL */
     includeBlurHash?: boolean;
+    /** Opt-in to allow SVG uploads (sanitized before storage). Defaults to `false`. */
+    allowSvg?: boolean;
+    /** Maximum input pixel count allowed by Sharp (defaults to 50 MP = 50,000,000) */
+    limitInputPixels?: number;
+    /** Marks `customFilename` as client-supplied (disables upsert and retries with a suffix on collision) */
+    isClientFilename?: boolean;
+    /** Target widths (px) for responsive image variants (widths >= main output width are skipped) */
+    variantWidths?: number[];
+    /** Optional AbortSignal to cancel queued or in-flight processing */
+    signal?: AbortSignal;
+}
+interface ImageVariant {
+    width: number;
+    height: number;
+    url: string;
+    size: number;
+    storagePath?: string;
 }
 interface UploadedImageData {
     url: string;
@@ -119,62 +143,12 @@ interface UploadedImageData {
     preset?: string;
     folder?: string;
     metadata?: Record<string, string>;
+    variants?: ImageVariant[];
+    srcSet?: string;
     uploadedAt: string;
 }
 interface ImageUploadRecord extends UploadedImageData {
     quality: number;
 }
 
-interface StorageUploadParams {
-    bucket: string;
-    path: string;
-    data: Buffer | Uint8Array;
-    contentType: string;
-    upsert?: boolean;
-    cacheControl?: string;
-    contentHash?: string;
-    metadata?: Record<string, string>;
-}
-interface StorageUploadResult {
-    bucket: string;
-    path: string;
-    url: string;
-}
-interface StorageFileEntry {
-    name: string;
-    id?: string;
-    createdAt?: string;
-    size?: number;
-}
-type StorageUploadOptions = StorageUploadParams;
-type StorageFileMetadata = StorageFileEntry;
-type StorageListResult = StorageFileEntry[];
-interface StorageAdapter {
-    /**
-     * Upload optimized image bytes to your storage backend and return its public URL.
-     */
-    upload(params: StorageUploadParams): Promise<StorageUploadResult>;
-    /**
-     * Delete an image from your storage backend by bucket and relative path.
-     */
-    delete(bucket: string, path: string): Promise<void>;
-    /**
-     * Optional: Resolve a public URL for a bucket and path.
-     */
-    getPublicUrl?(bucket: string, path: string): string | Promise<string>;
-    /**
-     * Optional: List files inside a bucket/folder.
-     */
-    list?(bucket: string, folder?: string): Promise<StorageFileEntry[]>;
-    /**
-     * Optional: Delete an asset directly from its public URL.
-     */
-    deleteByUrl?(url: string): Promise<boolean>;
-}
-type UploadRecordHook = (record: ImageUploadRecord) => void | Promise<void>;
-/**
- * Type-safe helper for authoring a custom StorageAdapter (S3, R2, Vercel Blob, Firebase, etc.).
- */
-declare function createStorageAdapter(adapter: StorageAdapter): StorageAdapter;
-
-export { DEFAULT_ALLOWED_FORMATS as D, type ExplicitOutputFormat as E, type ImageDimensions as I, type QualityLevel as Q, RASTER_ALLOWED_FORMATS as R, STANDARD_PRESETS as S, type UploadLocale as U, DEFAULT_IMAGE_DIMENSIONS as a, type ImageOutputFormat as b, type ImageUploadOptions as c, type ImageUploadRecord as d, QUALITY_PRESETS as e, type QualityPreset as f, type StandardPresetName as g, type StorageAdapter as h, type StorageFileEntry as i, type StorageFileMetadata as j, type StorageListResult as k, type StorageUploadOptions as l, type StorageUploadParams as m, type StorageUploadResult as n, type UploadKitRegister as o, type UploadPresetConfig as p, type UploadPresetName as q, type UploadedImageData as r, defineUploadPresets as s, type UploadRecordHook as t, createStorageAdapter as u };
+export { DEFAULT_ALLOWED_FORMATS as D, type ExplicitOutputFormat as E, type ImageUploadRecord as I, type QualityLevel as Q, RASTER_ALLOWED_FORMATS as R, STANDARD_PRESETS as S, type UploadLocale as U, DEFAULT_IMAGE_DIMENSIONS as a, type ImageDimensions as b, type ImageOutputFormat as c, type ImageUploadOptions as d, type ImageVariant as e, QUALITY_PRESETS as f, type QualityPreset as g, SVG_MIME_TYPE as h, type StandardPresetName as i, type UploadKitRegister as j, type UploadPresetConfig as k, type UploadPresetName as l, type UploadedImageData as m, defineUploadPresets as n };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "img-upload-kit",
-  "version": "1.1.1",
+  "version": "2.0.0",
   "publishConfig": {
     "access": "public"
   },
@@ -35,6 +35,7 @@
   "files": [
     "dist",
     "README.md",
+    "MIGRATION.md",
     "CHANGELOG.md",
     "LICENSE"
   ],
@@ -42,47 +43,93 @@
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
-    "img-upload-kit": "dist/cli.js",
-    "image-upload-kit": "dist/cli.js",
-    "blur-cli": "dist/cli.js"
+    "img-upload-kit": "dist/bin.js",
+    "image-upload-kit": "dist/bin.js",
+    "blur-cli": "dist/bin.js"
   },
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     },
     "./server": {
-      "types": "./dist/server.d.ts",
-      "import": "./dist/server.js",
-      "require": "./dist/server.cjs"
+      "import": {
+        "types": "./dist/server.d.ts",
+        "default": "./dist/server.js"
+      },
+      "require": {
+        "types": "./dist/server.d.cts",
+        "default": "./dist/server.cjs"
+      }
+    },
+    "./server/handler": {
+      "import": {
+        "types": "./dist/server-handler.d.ts",
+        "default": "./dist/server-handler.js"
+      },
+      "require": {
+        "types": "./dist/server-handler.d.cts",
+        "default": "./dist/server-handler.cjs"
+      }
     },
     "./storage": {
-      "types": "./dist/storage.d.ts",
-      "import": "./dist/storage.js",
-      "require": "./dist/storage.cjs"
+      "import": {
+        "types": "./dist/storage.d.ts",
+        "default": "./dist/storage.js"
+      },
+      "require": {
+        "types": "./dist/storage.d.cts",
+        "default": "./dist/storage.cjs"
+      }
     },
     "./blur": {
-      "types": "./dist/blur.d.ts",
-      "import": "./dist/blur.js",
-      "require": "./dist/blur.cjs"
+      "import": {
+        "types": "./dist/blur.d.ts",
+        "default": "./dist/blur.js"
+      },
+      "require": {
+        "types": "./dist/blur.d.cts",
+        "default": "./dist/blur.cjs"
+      }
     },
     "./react": {
-      "types": "./dist/react.d.ts",
-      "import": "./dist/react.js",
-      "require": "./dist/react.cjs"
+      "import": {
+        "types": "./dist/react.d.ts",
+        "default": "./dist/react.js"
+      },
+      "require": {
+        "types": "./dist/react.d.cts",
+        "default": "./dist/react.cjs"
+      }
     },
     "./headless": {
-      "types": "./dist/headless.d.ts",
-      "import": "./dist/headless.js",
-      "require": "./dist/headless.cjs"
+      "import": {
+        "types": "./dist/headless.d.ts",
+        "default": "./dist/headless.js"
+      },
+      "require": {
+        "types": "./dist/headless.d.cts",
+        "default": "./dist/headless.cjs"
+      }
     },
     "./cli": {
-      "types": "./dist/cli.d.ts",
-      "import": "./dist/cli.js",
-      "require": "./dist/cli.cjs"
+      "import": {
+        "types": "./dist/cli.d.ts",
+        "default": "./dist/cli.js"
+      },
+      "require": {
+        "types": "./dist/cli.d.cts",
+        "default": "./dist/cli.cjs"
+      }
     },
     "./styles.css": "./dist/styles.css",
+    "./styles/*.css": "./dist/styles/*.css",
     "./package.json": "./package.json"
   },
   "scripts": {
@@ -92,7 +139,8 @@
     "lint": "eslint .",
     "test": "vitest run",
     "test:watch": "vitest",
-    "prepublishOnly": "npm run typecheck && npm run test && npm run build"
+    "check:dist": "node scripts/check-dist.mjs",
+    "prepublishOnly": "npm run typecheck && npm run lint && npm run test && npm run build && npm run check:dist"
   },
   "pnpm": {
     "onlyBuiltDependencies": [
@@ -102,39 +150,51 @@
   },
   "dependencies": {
     "blurhash": "^2.0.5",
-    "commander": "^14.0.0",
-    "lqip-modern": "^2.2.1",
-    "lucide-react": "^0.577.0",
-    "sharp": "^0.34.5"
+    "commander": "^14.0.0"
   },
   "peerDependencies": {
+    "lqip-modern": "^2.2.1",
     "react": ">=18.0.0",
-    "react-dom": ">=18.0.0"
+    "react-dom": ">=18.0.0",
+    "sharp": "^0.34.5"
   },
   "peerDependenciesMeta": {
+    "lqip-modern": {
+      "optional": true
+    },
     "react": {
       "optional": true
     },
     "react-dom": {
       "optional": true
+    },
+    "sharp": {
+      "optional": true
     }
   },
   "devDependencies": {
     "@eslint/js": "^9.26.0",
+    "@testing-library/dom": "^10.4.2",
+    "@testing-library/jest-dom": "^7.0.1",
+    "@testing-library/react": "^16.3.3",
+    "@testing-library/user-event": "^14.6.8",
     "@types/node": "^22.15.0",
     "@types/react": "^19.1.0",
     "@types/react-dom": "^19.1.0",
     "eslint": "^9.26.0",
     "eslint-plugin-react-hooks": "^5.2.0",
+    "jsdom": "^31.0.0",
+    "lqip-modern": "^2.2.1",
     "prettier": "^3.5.3",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
+    "sharp": "^0.34.5",
     "tsup": "^8.5.0",
     "typescript": "^5.8.3",
     "typescript-eslint": "^8.32.0",
     "vitest": "^3.2.0"
   },
   "engines": {
-    "node": ">=18.17.0"
+    "node": ">=20.0.0"
   }
 }

package/dist/blurService-DqsnfPTd.d.cts

@@ -1,172 +0,0 @@
-type BlurPlaceholderType = 'default' | 'hero' | 'card' | 'thumbnail';
-type BlurSize = 'small' | 'medium';
-interface BlurDataOptions {
-    type?: BlurPlaceholderType;
-    size?: BlurSize;
-    width?: number;
-    height?: number;
-    punch?: number;
-}
-interface BlurManifestEntry {
-    hash: string;
-    variants: {
-        small: string;
-        medium?: string;
-        [key: string]: string | undefined;
-    };
-    color: string;
-    width?: number;
-    height?: number;
-    metadata?: Record<string, string>;
-}
-interface BlurManifestData {
-    version: string;
-    generatedAt: string;
-    totalImages: number;
-    processedImages?: number;
-    cachedImages?: number;
-    failedImages?: number;
-    hashes: Record<string, BlurManifestEntry>;
-}
-interface BlurCacheEntry {
-    dataUrl: string;
-    timestamp: number;
-}
-interface BlurServiceMetrics {
-    totalRequests: number;
-    cacheHits: number;
-    cacheMisses: number;
-    errors: number;
-}
-interface BlurImageSource {
-    url?: string;
-    blurDataUrl?: string | null;
-    blurColor?: string | null;
-    blurHash?: string | null;
-    altText?: string | null;
-    width?: number;
-    height?: number;
-}
-interface BlurData {
-    blurDataUrl: string;
-    blurColor: string;
-    blurHash?: string;
-    hasBlur: boolean;
-}
-interface BlurServiceConfig {
-    cacheSize?: number;
-    manifest?: BlurManifestData | Record<string, BlurManifestEntry>;
-}
-
-interface BlurPlaceholderStyle {
-    backgroundColor: string;
-    backgroundImage?: string;
-    backgroundSize?: string;
-    backgroundPosition?: string;
-    backgroundRepeat?: string;
-    filter?: string;
-    transform?: string;
-}
-declare function getBlurData(image: BlurImageSource | null | undefined): BlurData;
-declare function getImagePropsWithBlur(image: BlurImageSource | null | undefined): {
-    placeholder?: "blur" | undefined;
-    blurDataURL?: string | undefined;
-    src: string;
-    alt: string;
-    width: number;
-    height: number;
-} | null;
-declare function getBackgroundPropsWithBlur(image: BlurImageSource | null | undefined): BlurPlaceholderStyle;
-declare function getBlurPlaceholderStyle(image: BlurImageSource | null | undefined): BlurPlaceholderStyle;
-declare function hasBlurData(image: BlurImageSource | null | undefined): boolean;
-declare function getBulkBlurData(images: Array<BlurImageSource | null | undefined>): BlurData[];
-declare function createSrcSetWithBlur(image: BlurImageSource | null | undefined): string;
-declare function preloadImageWithBlur(image: BlurImageSource | null | undefined): void;
-declare function extractImageUrls(image: BlurImageSource | null | undefined): string[];
-/**
- * Browser helper: Decodes a compact BlurHash string (e.g. "LEHV6nWB2yk8pyo0adR*.7kCMdnj")
- * into a `data:image/png;base64,...` URL using an offscreen `<canvas>`.
- */
-declare function decodeBlurHashToDataURL(hash: string, width?: number, height?: number, punch?: number): string | null;
-
-declare const DEFAULT_CDN_PATTERNS: RegExp[];
-interface NormalizePathOptions {
-    cdnPatterns?: RegExp[];
-    stripPrefixes?: string[];
-}
-interface PathInfo {
-    normalizedPath: string;
-    folder?: string;
-    filename?: string;
-    extension?: string;
-    isExternal: boolean;
-    originalPath: string;
-}
-/**
- * Project-agnostic image URL / path normalizer.
- * Strips query parameters, leading `/public/`, relative `./`, and common CDN prefixes
- * so manifest keys match consistently across local and CDN environments.
- */
-declare function normalizeImagePath(imageSrc: string, options?: NormalizePathOptions): PathInfo;
-
-interface BlurServiceOptions {
-    cacheSize?: number;
-    manifest?: BlurManifestData | Record<string, BlurManifestEntry>;
-    pathOptions?: NormalizePathOptions;
-}
-declare class BlurService {
-    private blurData;
-    private readonly cache;
-    private readonly pathOptions?;
-    private metadata;
-    private metrics;
-    constructor(options?: BlurServiceOptions);
-    /**
-     * Hydrate the service with a generated `blur-hashes.json` manifest or hash map.
-     */
-    loadManifest(manifest: BlurManifestData | Record<string, BlurManifestEntry>): void;
-    /**
-     * Register or update a single image's blur data at runtime.
-     */
-    registerEntry(imagePath: string, entry: BlurManifestEntry): void;
-    getDefaultPlaceholder(type?: BlurPlaceholderType): string;
-    private findBlurDataByPath;
-    getDominantColor(imageSrc: string): string;
-    getBlurDataURL(imageSrc: string, options?: {
-        type?: BlurPlaceholderType;
-        size?: BlurSize;
-    }): string;
-    getBulkBlurData(imageSrcs: string[], options?: {
-        type?: BlurPlaceholderType;
-        size?: BlurSize;
-    }): Record<string, string>;
-    getProgressiveData(imageSrc: string, size?: BlurSize): {
-        color: string;
-        blur: string;
-        hasBlur: boolean;
-    };
-    hasBlurHash(imageSrc: string): boolean;
-    getMetadata(): {
-        cacheSize: number;
-        metrics: {
-            cacheHitRate: string;
-            totalRequests: number;
-            cacheHits: number;
-            cacheMisses: number;
-            errors: number;
-        };
-        version: string;
-        generatedAt: string;
-        totalImages: number;
-    };
-    clearCache(): void;
-    getBlurHash(imageSrc: string): string | null;
-    preloadBlurData(imageSrcs: string[], size?: BlurSize): void;
-    fetchBlurDataForImage(imageSrc: string, type?: BlurPlaceholderType): Promise<string>;
-    getAvailableKeys(): string[];
-    findMatchingKeys(searchTerm: string): string[];
-}
-declare function createBlurService(options?: BlurServiceOptions): BlurService;
-declare const blurService: BlurService;
-
-export { type BlurPlaceholderType as B, DEFAULT_CDN_PATTERNS as D, type NormalizePathOptions as N, type PathInfo as P, type BlurCacheEntry as a, type BlurData as b, type BlurDataOptions as c, type BlurImageSource as d, type BlurManifestData as e, type BlurManifestEntry as f, type BlurPlaceholderStyle as g, BlurService as h, type BlurServiceConfig as i, type BlurServiceMetrics as j, type BlurServiceOptions as k, type BlurSize as l, blurService as m, createBlurService as n, createSrcSetWithBlur as o, decodeBlurHashToDataURL as p, extractImageUrls as q, getBackgroundPropsWithBlur as r, getBlurData as s, getBlurPlaceholderStyle as t, getBulkBlurData as u, getImagePropsWithBlur as v, hasBlurData as w, normalizeImagePath as x, preloadImageWithBlur as y };

package/dist/blurService-DqsnfPTd.d.ts

@@ -1,172 +0,0 @@
-type BlurPlaceholderType = 'default' | 'hero' | 'card' | 'thumbnail';
-type BlurSize = 'small' | 'medium';
-interface BlurDataOptions {
-    type?: BlurPlaceholderType;
-    size?: BlurSize;
-    width?: number;
-    height?: number;
-    punch?: number;
-}
-interface BlurManifestEntry {
-    hash: string;
-    variants: {
-        small: string;
-        medium?: string;
-        [key: string]: string | undefined;
-    };
-    color: string;
-    width?: number;
-    height?: number;
-    metadata?: Record<string, string>;
-}
-interface BlurManifestData {
-    version: string;
-    generatedAt: string;
-    totalImages: number;
-    processedImages?: number;
-    cachedImages?: number;
-    failedImages?: number;
-    hashes: Record<string, BlurManifestEntry>;
-}
-interface BlurCacheEntry {
-    dataUrl: string;
-    timestamp: number;
-}
-interface BlurServiceMetrics {
-    totalRequests: number;
-    cacheHits: number;
-    cacheMisses: number;
-    errors: number;
-}
-interface BlurImageSource {
-    url?: string;
-    blurDataUrl?: string | null;
-    blurColor?: string | null;
-    blurHash?: string | null;
-    altText?: string | null;
-    width?: number;
-    height?: number;
-}
-interface BlurData {
-    blurDataUrl: string;
-    blurColor: string;
-    blurHash?: string;
-    hasBlur: boolean;
-}
-interface BlurServiceConfig {
-    cacheSize?: number;
-    manifest?: BlurManifestData | Record<string, BlurManifestEntry>;
-}
-
-interface BlurPlaceholderStyle {
-    backgroundColor: string;
-    backgroundImage?: string;
-    backgroundSize?: string;
-    backgroundPosition?: string;
-    backgroundRepeat?: string;
-    filter?: string;
-    transform?: string;
-}
-declare function getBlurData(image: BlurImageSource | null | undefined): BlurData;
-declare function getImagePropsWithBlur(image: BlurImageSource | null | undefined): {
-    placeholder?: "blur" | undefined;
-    blurDataURL?: string | undefined;
-    src: string;
-    alt: string;
-    width: number;
-    height: number;
-} | null;
-declare function getBackgroundPropsWithBlur(image: BlurImageSource | null | undefined): BlurPlaceholderStyle;
-declare function getBlurPlaceholderStyle(image: BlurImageSource | null | undefined): BlurPlaceholderStyle;
-declare function hasBlurData(image: BlurImageSource | null | undefined): boolean;
-declare function getBulkBlurData(images: Array<BlurImageSource | null | undefined>): BlurData[];
-declare function createSrcSetWithBlur(image: BlurImageSource | null | undefined): string;
-declare function preloadImageWithBlur(image: BlurImageSource | null | undefined): void;
-declare function extractImageUrls(image: BlurImageSource | null | undefined): string[];
-/**
- * Browser helper: Decodes a compact BlurHash string (e.g. "LEHV6nWB2yk8pyo0adR*.7kCMdnj")
- * into a `data:image/png;base64,...` URL using an offscreen `<canvas>`.
- */
-declare function decodeBlurHashToDataURL(hash: string, width?: number, height?: number, punch?: number): string | null;
-
-declare const DEFAULT_CDN_PATTERNS: RegExp[];
-interface NormalizePathOptions {
-    cdnPatterns?: RegExp[];
-    stripPrefixes?: string[];
-}
-interface PathInfo {
-    normalizedPath: string;
-    folder?: string;
-    filename?: string;
-    extension?: string;
-    isExternal: boolean;
-    originalPath: string;
-}
-/**
- * Project-agnostic image URL / path normalizer.
- * Strips query parameters, leading `/public/`, relative `./`, and common CDN prefixes
- * so manifest keys match consistently across local and CDN environments.
- */
-declare function normalizeImagePath(imageSrc: string, options?: NormalizePathOptions): PathInfo;
-
-interface BlurServiceOptions {
-    cacheSize?: number;
-    manifest?: BlurManifestData | Record<string, BlurManifestEntry>;
-    pathOptions?: NormalizePathOptions;
-}
-declare class BlurService {
-    private blurData;
-    private readonly cache;
-    private readonly pathOptions?;
-    private metadata;
-    private metrics;
-    constructor(options?: BlurServiceOptions);
-    /**
-     * Hydrate the service with a generated `blur-hashes.json` manifest or hash map.
-     */
-    loadManifest(manifest: BlurManifestData | Record<string, BlurManifestEntry>): void;
-    /**
-     * Register or update a single image's blur data at runtime.
-     */
-    registerEntry(imagePath: string, entry: BlurManifestEntry): void;
-    getDefaultPlaceholder(type?: BlurPlaceholderType): string;
-    private findBlurDataByPath;
-    getDominantColor(imageSrc: string): string;
-    getBlurDataURL(imageSrc: string, options?: {
-        type?: BlurPlaceholderType;
-        size?: BlurSize;
-    }): string;
-    getBulkBlurData(imageSrcs: string[], options?: {
-        type?: BlurPlaceholderType;
-        size?: BlurSize;
-    }): Record<string, string>;
-    getProgressiveData(imageSrc: string, size?: BlurSize): {
-        color: string;
-        blur: string;
-        hasBlur: boolean;
-    };
-    hasBlurHash(imageSrc: string): boolean;
-    getMetadata(): {
-        cacheSize: number;
-        metrics: {
-            cacheHitRate: string;
-            totalRequests: number;
-            cacheHits: number;
-            cacheMisses: number;
-            errors: number;
-        };
-        version: string;
-        generatedAt: string;
-        totalImages: number;
-    };
-    clearCache(): void;
-    getBlurHash(imageSrc: string): string | null;
-    preloadBlurData(imageSrcs: string[], size?: BlurSize): void;
-    fetchBlurDataForImage(imageSrc: string, type?: BlurPlaceholderType): Promise<string>;
-    getAvailableKeys(): string[];
-    findMatchingKeys(searchTerm: string): string[];
-}
-declare function createBlurService(options?: BlurServiceOptions): BlurService;
-declare const blurService: BlurService;
-
-export { type BlurPlaceholderType as B, DEFAULT_CDN_PATTERNS as D, type NormalizePathOptions as N, type PathInfo as P, type BlurCacheEntry as a, type BlurData as b, type BlurDataOptions as c, type BlurImageSource as d, type BlurManifestData as e, type BlurManifestEntry as f, type BlurPlaceholderStyle as g, BlurService as h, type BlurServiceConfig as i, type BlurServiceMetrics as j, type BlurServiceOptions as k, type BlurSize as l, blurService as m, createBlurService as n, createSrcSetWithBlur as o, decodeBlurHashToDataURL as p, extractImageUrls as q, getBackgroundPropsWithBlur as r, getBlurData as s, getBlurPlaceholderStyle as t, getBulkBlurData as u, getImagePropsWithBlur as v, hasBlurData as w, normalizeImagePath as x, preloadImageWithBlur as y };