@frybynite/image-cloud 0.5.0 → 0.5.2

package/dist/ImageCloud.d.ts

@@ -0,0 +1,99 @@
+import { ImageCloudOptions } from './config/types';
+export declare class ImageCloud {
+    private containerId;
+    private containerRef;
+    private fullConfig;
+    private imagesLoaded;
+    private imageElements;
+    private imageLayouts;
+    private currentImageHeight;
+    private currentFocusIndex;
+    private hoveredImage;
+    private resizeTimeout;
+    private displayQueue;
+    private queueInterval;
+    private loadGeneration;
+    private defaultStyles;
+    private hoverStyles;
+    private defaultClassName;
+    private hoverClassName;
+    private animationEngine;
+    private entryAnimationEngine;
+    private layoutEngine;
+    private zoomEngine;
+    private swipeEngine;
+    private imageLoader;
+    private imageFilter;
+    private containerEl;
+    private loadingEl;
+    private errorEl;
+    private loadingElAutoCreated;
+    private errorElAutoCreated;
+    private counterEl;
+    private counterElAutoCreated;
+    constructor(options?: ImageCloudOptions);
+    /**
+     * Create image filter based on shared loader config
+     */
+    private createImageFilter;
+    /**
+     * Create appropriate image loader based on config
+     * Processes loaders array, merges shared config, wraps in CompositeLoader if needed
+     */
+    private createLoader;
+    /**
+     * Create a single loader from a LoaderEntry, merging shared config
+     */
+    private createLoaderFromEntry;
+    /**
+     * Initialize the gallery
+     */
+    init(): Promise<void>;
+    private setupUI;
+    private resolveElement;
+    private createDefaultLoadingElement;
+    private createDefaultErrorElement;
+    private createDefaultCounterElement;
+    private setupEventListeners;
+    /**
+     * Navigate to the next image (Right arrow)
+     */
+    private navigateToNextImage;
+    /**
+     * Navigate to the previous image (Left arrow)
+     */
+    private navigateToPreviousImage;
+    /**
+     * Navigate to a specific image by index
+     */
+    private handleResize;
+    private getImageHeight;
+    /**
+     * Get container bounds for layout calculations
+     */
+    private getContainerBounds;
+    /**
+     * Load images using the unified loader interface
+     */
+    private loadImages;
+    /**
+     * Helper for debug logging
+     */
+    private logDebug;
+    private createImageCloud;
+    private handleImageClick;
+    /**
+     * Clear the image cloud and reset state
+     */
+    clearImageCloud(): void;
+    private showLoading;
+    private showError;
+    private hideError;
+    private updateCounter;
+    private hideCounter;
+    /**
+     * Destroy the gallery and clean up resources
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=ImageCloud.d.ts.map

package/dist/ImageCloud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageCloud.d.ts","sourceRoot":"","sources":["../src/ImageCloud.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAA6K,MAAM,gBAAgB,CAAC;AAenO,qBAAa,UAAU;IACrB,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,YAAY,CAAqB;IAGzC,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,iBAAiB,CAAgB;IACzC,OAAO,CAAC,YAAY,CAA4D;IAChF,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,cAAc,CAAS;IAG/B,OAAO,CAAC,aAAa,CAAkB;IACvC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,cAAc,CAAgC;IAGtD,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,WAAW,CAAc;IAGjC,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,oBAAoB,CAAU;IACtC,OAAO,CAAC,kBAAkB,CAAU;IACpC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,oBAAoB,CAAU;gBAE1B,OAAO,GAAE,iBAAsB;IAgE3C;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAoBpB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAyB7B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoD3B,OAAO,CAAC,OAAO;IAmCf,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,2BAA2B;IAanC,OAAO,CAAC,yBAAyB;IAOjC,OAAO,CAAC,2BAA2B;IAOnC,OAAO,CAAC,mBAAmB;IAoC3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAiB/B;;OAEG;IACH,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,cAAc;IA0BtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;YACW,UAAU;IAiDxB;;OAEG;IACH,OAAO,CAAC,QAAQ;YAMF,gBAAgB;YAuUhB,gBAAgB;IA0B9B;;OAEG;IACH,eAAe,IAAI,IAAI;IAsBvB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,WAAW;IAMnB;;OAEG;IACH,OAAO,IAAI,IAAI;CAqBhB"}

package/dist/config/adapter.d.ts

@@ -0,0 +1,50 @@
+import { ImageCloudOptions, LegacyImageGalleryOptions } from './types';
+type NewOptions = Partial<ImageCloudOptions>;
+type OldOptions = LegacyImageGalleryOptions;
+/**
+ * Legacy Options Adapter
+ * Converts old-style options to new pattern-based options
+ */
+export declare class LegacyOptionsAdapter {
+    /**
+     * Detect if options are in legacy format
+     */
+    static isLegacyFormat(options: ImageCloudOptions | OldOptions): options is OldOptions;
+    /**
+     * Convert legacy options to new pattern-based options
+     */
+    static convert(oldOptions: OldOptions): NewOptions;
+    /**
+     * Convert loader configuration to new LoaderEntry[] format
+     */
+    private static convertLoader;
+    /**
+     * Convert layout configuration to new pattern-based structure
+     * Returns both layout and image configs since legacy format combined them
+     */
+    private static convertLayout;
+    /**
+     * Convert animation configuration to new pattern-based structure
+     */
+    private static convertAnimation;
+    /**
+     * Convert zoom configuration to interaction.focus
+     * Note: Old focusScale/mobileScale multipliers don't directly translate to scalePercent.
+     * Using default scalePercent of 0.8 for compatibility.
+     */
+    private static convertZoomToInteraction;
+    /**
+     * Convert rendering configuration (breakpoints + ui)
+     */
+    private static convertRendering;
+    /**
+     * Show a deprecation warning (once per category)
+     */
+    private static warn;
+    /**
+     * Clear shown warnings (useful for testing)
+     */
+    static clearWarnings(): void;
+}
+export {};
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/config/adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,yBAAyB,EAO1B,MAAM,SAAS,CAAC;AAGjB,KAAK,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAC7C,KAAK,UAAU,GAAG,yBAAyB,CAAC;AAO5C;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,GAAG,OAAO,IAAI,UAAU;IAarF;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU;IA6ClD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAkD5B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAmD5B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAuB/B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAWvC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IA+B/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,IAAI;IAenB;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;CAG7B"}

package/dist/config/defaults.d.ts

@@ -0,0 +1,118 @@
+import { ImageCloudConfig, ImageCloudOptions, ImageStylingConfig, ShadowPreset, WaveAlgorithmConfig, BouncePathConfig, ElasticPathConfig, WavePathConfig, BouncePreset, ElasticPreset, WavePathPreset, EntryPathConfig, EntryRotationConfig, EntryScaleConfig, ImageConfig, ImageSizingConfig, ImageRotationConfig, ResponsiveBreakpoints, SharedLoaderConfig, DebugConfig } from './types';
+/**
+ * Shadow presets for image styling
+ */
+export declare const SHADOW_PRESETS: Record<ShadowPreset, string>;
+/**
+ * Bounce path presets - overshoot and settle animations
+ */
+export declare const BOUNCE_PRESETS: Record<BouncePreset, BouncePathConfig>;
+/**
+ * Elastic path presets - spring-like oscillation animations
+ */
+export declare const ELASTIC_PRESETS: Record<ElasticPreset, ElasticPathConfig>;
+/**
+ * Wave path presets - sinusoidal path animations
+ */
+export declare const WAVE_PATH_PRESETS: Record<WavePathPreset, WavePathConfig>;
+/**
+ * Default path configuration (linear - no special path effects)
+ */
+export declare const DEFAULT_PATH_CONFIG: EntryPathConfig;
+/**
+ * Default entry rotation configuration (no rotation animation)
+ */
+export declare const DEFAULT_ENTRY_ROTATION: EntryRotationConfig;
+/**
+ * Default entry scale configuration (no scale animation)
+ */
+export declare const DEFAULT_ENTRY_SCALE: EntryScaleConfig;
+/**
+ * Entry scale presets for common effects
+ */
+export declare const ENTRY_SCALE_PRESETS: Readonly<{
+    grow: Readonly<{
+        mode: "grow";
+        startScale: 0.3;
+    }>;
+    shrink: Readonly<{
+        mode: "shrink";
+        startScale: 1.5;
+    }>;
+    pop: Readonly<{
+        mode: "pop";
+        pop: Readonly<{
+            overshoot: 1.2;
+            bounces: 1;
+        }>;
+    }>;
+    randomSubtle: Readonly<{
+        mode: "random";
+        range: Readonly<{
+            min: 0.7;
+            max: 1;
+        }>;
+    }>;
+    randomWide: Readonly<{
+        mode: "random";
+        range: Readonly<{
+            min: 0.3;
+            max: 1.5;
+        }>;
+    }>;
+}>;
+/**
+ * Default image styling configuration
+ */
+export declare const DEFAULT_STYLING: ImageStylingConfig;
+/**
+ * Default wave layout configuration
+ */
+export declare const DEFAULT_WAVE_CONFIG: WaveAlgorithmConfig;
+/**
+ * Default responsive breakpoints for layout
+ */
+export declare const DEFAULT_RESPONSIVE_BREAKPOINTS: ResponsiveBreakpoints;
+/**
+ * Default image sizing configuration
+ */
+export declare const DEFAULT_IMAGE_SIZING: ImageSizingConfig;
+/**
+ * Default image rotation configuration
+ */
+export declare const DEFAULT_IMAGE_ROTATION: ImageRotationConfig;
+/**
+ * Default image configuration
+ */
+export declare const DEFAULT_IMAGE_CONFIG: ImageConfig;
+/**
+ * Default configuration object
+ * Frozen to prevent accidental modifications
+ */
+/**
+ * Default shared loader configuration
+ */
+export declare const DEFAULT_SHARED_LOADER_CONFIG: SharedLoaderConfig;
+/**
+ * Default debug configuration
+ */
+export declare const DEFAULT_DEBUG_CONFIG: DebugConfig;
+export declare const DEFAULT_CONFIG: ImageCloudConfig;
+export declare function mergeConfig(userConfig?: ImageCloudOptions): ImageCloudConfig;
+/**
+ * Resolve bounce path config from preset and overrides
+ */
+export declare function resolveBounceConfig(preset?: BouncePreset, overrides?: Partial<BouncePathConfig>): BouncePathConfig;
+/**
+ * Resolve elastic path config from preset and overrides
+ */
+export declare function resolveElasticConfig(preset?: ElasticPreset, overrides?: Partial<ElasticPathConfig>): ElasticPathConfig;
+/**
+ * Resolve wave path config from preset and overrides
+ */
+export declare function resolveWavePathConfig(preset?: WavePathPreset, overrides?: Partial<WavePathConfig>): WavePathConfig;
+/**
+ * Debug logger
+ */
+export declare function debugLog(config: ImageCloudConfig, ...args: unknown[]): void;
+//# 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;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAe,kBAAkB,EAAmB,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,WAAW,EAAE,iBAAiB,EAAE,mBAAmB,EAAuB,qBAAqB,EAAE,kBAAkB,EAA8B,WAAW,EAAE,MAAM,SAAS,CAAC;AAEhd;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAMtD,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,YAAY,EAAE,gBAAgB,CAIhE,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,aAAa,EAAE,iBAAiB,CAKnE,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,cAAc,EAAE,cAAc,CAKnE,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,eAEhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,mBAEnC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,gBAEhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,kBAyB5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,mBAOhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,qBAG3C,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,iBAQjC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,mBAMnC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAGjC,CAAC;AAEH;;;GAGG;AACH;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,kBAKzC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAIjC,CAAC;AAEH,eAAO,MAAM,cAAc,EAAE,gBA4G3B,CAAC;AA2LH,wBAAgB,WAAW,CACzB,UAAU,GAAE,iBAAsB,GACjC,gBAAgB,CA6NlB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,CAAC,EAAE,YAAY,EACrB,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACpC,gBAAgB,CAGlB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,CAAC,EAAE,aAAa,EACtB,SAAS,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACrC,iBAAiB,CAGnB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,CAAC,EAAE,cAAc,EACvB,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAClC,cAAc,CAGhB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAI3E"}