@frybynite/image-cloud 0.2.8 → 0.3.0

package/dist/index.d.ts

@@ -251,9 +251,8 @@ export declare interface CompositeLoaderConfig {
     debugLogging?: boolean;
 }
 
-export declare interface CompositeLoaderConfigJson {
-    loaders: LoaderConfig[];
-    debugLogging?: boolean;
+export declare interface ConfigSection {
+    loaders?: SharedLoaderConfig;
 }
 
 export declare interface ContainerBounds {
@@ -261,11 +260,12 @@ export declare interface ContainerBounds {
     height: number;
 }
 
+export declare const DEFAULT_CONFIG: ImageCloudConfig;
+
 /**
- * Default configuration object
- * Frozen to prevent accidental modifications
+ * Default shared loader configuration
  */
-export declare const DEFAULT_CONFIG: ImageCloudConfig;
+export declare const DEFAULT_SHARED_LOADER_CONFIG: SharedLoaderConfig;
 
 declare interface DropShadowConfig {
     x: number;
@@ -553,13 +553,11 @@ declare interface GestureInteractionConfig {
     doubleTapToFocus?: boolean;
 }
 
-declare interface GoogleDriveFilesSource {
-    type: 'files';
+export declare interface GoogleDriveFilesSource {
     files: string[];
 }
 
-declare interface GoogleDriveFolderSource {
-    type: 'folder';
+export declare interface GoogleDriveFolderSource {
     folders: string[];
     recursive?: boolean;
 }
@@ -571,7 +569,7 @@ export declare class GoogleDriveLoader implements ImageLoader {
     private sources;
     private _prepared;
     private _discoveredUrls;
-    constructor(config?: Partial<GoogleDriveLoaderConfig>);
+    constructor(config: GoogleDriveLoaderInnerConfig);
     /**
      * Prepare the loader by discovering all images from configured sources
      * @param filter - Filter to apply to discovered images
@@ -653,7 +651,11 @@ export declare class GoogleDriveLoader implements ImageLoader {
     private log;
 }
 
-export declare interface GoogleDriveLoaderConfig {
+export declare interface GoogleDriveLoaderEntry {
+    googleDrive: GoogleDriveLoaderInnerConfig;
+}
+
+export declare interface GoogleDriveLoaderInnerConfig {
     apiKey: string;
     sources: GoogleDriveSource[];
     apiEndpoint?: string;
@@ -661,7 +663,7 @@ export declare interface GoogleDriveLoaderConfig {
     debugLogging?: boolean;
 }
 
-declare type GoogleDriveSource = GoogleDriveFolderSource | GoogleDriveFilesSource;
+export declare type GoogleDriveSource = GoogleDriveFolderSource | GoogleDriveFilesSource;
 
 export declare interface GridAlgorithmConfig {
     columns: number | 'auto';
@@ -740,17 +742,18 @@ declare class ImageCloud {
     private errorEl;
     constructor(options?: ImageCloudOptions);
     /**
-     * Create image filter based on config
+     * 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 loader from a LoaderConfig object (supports recursive composite loaders)
+     * Create a single loader from a LoaderEntry, merging shared config
      */
-    private createLoaderFromConfig;
+    private createLoaderFromEntry;
     /**
      * Initialize the gallery
      */
@@ -801,7 +804,8 @@ export { ImageCloud }
 export { ImageCloud as ImageGallery }
 
 export declare interface ImageCloudConfig {
-    loader: LoaderConfig;
+    loaders: LoaderEntry[];
+    config: ConfigSection;
     image: ImageConfig;
     layout: LayoutConfig;
     animation: AnimationConfig;
@@ -813,7 +817,9 @@ export declare interface ImageCloudConfig {
 
 export declare interface ImageCloudOptions {
     container?: string | HTMLElement;
-    loader?: Partial<LoaderConfig>;
+    images?: string[];
+    loaders?: LoaderEntry[];
+    config?: ConfigSection;
     image?: Partial<ImageConfig>;
     layout?: Partial<LayoutConfig>;
     animation?: Partial<AnimationConfig>;
@@ -1072,12 +1078,7 @@ declare interface LayoutSpacingConfig {
     minGap: number;
 }
 
-export declare interface LoaderConfig {
-    type: 'googleDrive' | 'static' | 'composite';
-    googleDrive?: GoogleDriveLoaderConfig;
-    static?: StaticLoaderConfig;
-    composite?: CompositeLoaderConfigJson;
-}
+export declare type LoaderEntry = StaticLoaderEntry | GoogleDriveLoaderEntry;
 
 declare interface NavigationInteractionConfig {
     keyboard?: boolean;
@@ -1221,6 +1222,15 @@ export declare interface ResponsiveRenderingConfig {
 
 declare type ShadowPreset = 'none' | 'sm' | 'md' | 'lg' | 'glow';
 
+export declare interface SharedLoaderConfig {
+    validateUrls?: boolean;
+    validationTimeout?: number;
+    validationMethod?: 'head' | 'simple' | 'none';
+    failOnAllMissing?: boolean;
+    allowedExtensions?: string[];
+    debugLogging?: boolean;
+}
+
 /**
  * Sizing mode:
  * - 'fixed': single explicit height for all breakpoints
@@ -1293,7 +1303,7 @@ export declare class StaticImageLoader implements ImageLoader {
     private debugLogging;
     private _prepared;
     private _discoveredUrls;
-    constructor(config?: Partial<StaticLoaderConfig>);
+    constructor(config: StaticLoaderInnerConfig);
     /**
      * Prepare the loader by discovering all images from configured sources
      * @param filter - Filter to apply to discovered images
@@ -1314,8 +1324,8 @@ export declare class StaticImageLoader implements ImageLoader {
      */
     isPrepared(): boolean;
     /**
-     * Process a single source object
-     * @param source - Source configuration with type, urls, basePath, files
+     * Process a single source object using shape-based detection
+     * @param source - Source configuration detected by key presence
      * @param filter - Filter to apply to discovered images
      * @returns Promise resolving to array of valid URLs from this source
      */
@@ -1335,6 +1345,14 @@ export declare class StaticImageLoader implements ImageLoader {
      * @returns Promise resolving to array of validated URLs
      */
     private processPath;
+    /**
+     * Process a JSON endpoint source
+     * Fetches a JSON endpoint that returns { images: string[] }
+     * @param url - JSON endpoint URL
+     * @param filter - Filter to apply to discovered images
+     * @returns Promise resolving to array of validated URLs
+     */
+    private processJson;
     /**
      * Validate a single URL using HEAD request
      * @param url - URL to validate
@@ -1361,7 +1379,15 @@ export declare class StaticImageLoader implements ImageLoader {
     private log;
 }
 
-export declare interface StaticLoaderConfig {
+export declare interface StaticJsonSource {
+    json: string;
+}
+
+export declare interface StaticLoaderEntry {
+    static: StaticLoaderInnerConfig;
+}
+
+export declare interface StaticLoaderInnerConfig {
     sources: StaticSource[];
     validateUrls?: boolean;
     validationTimeout?: number;
@@ -1371,14 +1397,16 @@ export declare interface StaticLoaderConfig {
     debugLogging?: boolean;
 }
 
-export declare interface StaticSource {
-    type: StaticSourceType;
-    urls?: string[];
-    basePath?: string;
-    files?: string[];
+export declare interface StaticPathSource {
+    path: string;
+    files: string[];
 }
 
-declare type StaticSourceType = 'urls' | 'path';
+export declare type StaticSource = StaticUrlsSource | StaticPathSource | StaticJsonSource;
+
+export declare interface StaticUrlsSource {
+    urls: string[];
+}
 
 export declare interface TransformParams {
     x?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frybynite/image-cloud",
-  "version": "0.2.8",
+  "version": "0.3.0",
   "description": "Javascript/TypeScript image cloud library with custom loaders, various layouts, full images styling, with animation and zoom effects",
   "type": "module",
   "main": "./dist/image-cloud.umd.js",