img-upload-kit 1.1.1 → 2.0.1

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 };