@frybynite/image-cloud 0.4.2 → 0.5.2

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,0BAA0B,CAAC;AAGlC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,EAAE,UAAU,IAAI,YAAY,EAAE,MAAM,cAAc,CAAC;AAG1D,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EAAE,gCAAgC;AACrD,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EAEtB,WAAW,EACX,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,4BAA4B,EAC5B,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EACjB,yBAAyB,EACzB,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,eAAe,EAEf,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,cAAc,EAEd,WAAW,EACZ,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,cAAc,EACd,4BAA4B,EAC5B,cAAc,EACd,eAAe,EACf,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAGpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,YAAY,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/layouts/ClusterPlacementLayout.d.ts

@@ -0,0 +1,40 @@
+import { PlacementLayout, ImageLayout, ContainerBounds, LayoutConfig, ImageConfig } from '../config/types';
+interface ClusterLayoutOptions extends Partial<LayoutConfig> {
+    fixedHeight?: number;
+}
+export declare class ClusterPlacementLayout implements PlacementLayout {
+    private config;
+    private imageConfig;
+    constructor(config: LayoutConfig, imageConfig?: ImageConfig);
+    /**
+     * Generate cluster layout positions for images
+     * @param imageCount - Number of images to layout
+     * @param containerBounds - Container dimensions {width, height}
+     * @param options - Optional overrides (includes fixedHeight)
+     * @returns Array of layout objects with position, rotation, scale
+     */
+    generate(imageCount: number, containerBounds: ContainerBounds, options?: ClusterLayoutOptions): ImageLayout[];
+    /**
+     * Calculate optimal number of clusters based on image count and container
+     */
+    private calculateClusterCount;
+    /**
+     * Generate cluster center positions with spacing constraints
+     */
+    private generateClusterCenters;
+    /**
+     * Calculate spread for a cluster (may vary if density='varied')
+     */
+    private calculateClusterSpread;
+    /**
+     * Generate a random number with approximately Gaussian distribution
+     * Using Box-Muller transform
+     */
+    private gaussianRandom;
+    /**
+     * Utility: Generate random number between min and max
+     */
+    private random;
+}
+export {};
+//# sourceMappingURL=ClusterPlacementLayout.d.ts.map

package/dist/layouts/ClusterPlacementLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClusterPlacementLayout.d.ts","sourceRoot":"","sources":["../../src/layouts/ClusterPlacementLayout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAA0B,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAQxI,UAAU,oBAAqB,SAAQ,OAAO,CAAC,YAAY,CAAC;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAWD,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE,YAAY,EAAE,WAAW,GAAE,WAAgB;IAK/D;;;;;;OAMG;IACH,QAAQ,CACN,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,eAAe,EAChC,OAAO,GAAE,oBAAyB,GACjC,WAAW,EAAE;IAuHhB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAwB7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAyD9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAS9B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;IACH,OAAO,CAAC,MAAM;CAGf"}

package/dist/layouts/GridPlacementLayout.d.ts

@@ -0,0 +1,27 @@
+import { PlacementLayout, ImageLayout, ContainerBounds, LayoutConfig, ImageConfig } from '../config/types';
+interface GridLayoutOptions extends Partial<LayoutConfig> {
+    fixedHeight?: number;
+}
+export declare class GridPlacementLayout implements PlacementLayout {
+    private config;
+    private imageConfig;
+    constructor(config: LayoutConfig, imageConfig?: ImageConfig);
+    /**
+     * Generate grid layout positions for images
+     * @param imageCount - Number of images to layout
+     * @param containerBounds - Container dimensions {width, height}
+     * @param options - Optional overrides (includes fixedHeight)
+     * @returns Array of layout objects with position, rotation, scale
+     */
+    generate(imageCount: number, containerBounds: ContainerBounds, options?: GridLayoutOptions): ImageLayout[];
+    /**
+     * Calculate optimal grid dimensions based on image count and container
+     */
+    private calculateGridDimensions;
+    /**
+     * Utility: Generate random number between min and max
+     */
+    private random;
+}
+export {};
+//# sourceMappingURL=GridPlacementLayout.d.ts.map

package/dist/layouts/GridPlacementLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GridPlacementLayout.d.ts","sourceRoot":"","sources":["../../src/layouts/GridPlacementLayout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAuB,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAErI,UAAU,iBAAkB,SAAQ,OAAO,CAAC,YAAY,CAAC;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA4BD,qBAAa,mBAAoB,YAAW,eAAe;IACzD,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE,YAAY,EAAE,WAAW,GAAE,WAAgB;IAK/D;;;;;;OAMG;IACH,QAAQ,CACN,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,eAAe,EAChC,OAAO,GAAE,iBAAsB,GAC9B,WAAW,EAAE;IAkOhB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAqC/B;;OAEG;IACH,OAAO,CAAC,MAAM;CAGf"}

package/dist/layouts/RadialPlacementLayout.d.ts

@@ -0,0 +1,33 @@
+import { PlacementLayout, ImageLayout, ContainerBounds, LayoutConfig, ImageConfig } from '../config/types';
+interface RadialLayoutOptions extends Partial<LayoutConfig> {
+    fixedHeight?: number;
+}
+export declare class RadialPlacementLayout implements PlacementLayout {
+    private config;
+    private imageConfig;
+    constructor(config: LayoutConfig, imageConfig?: ImageConfig);
+    /**
+     * Generate radial layout positions for images
+     * @param imageCount - Number of images to layout
+     * @param containerBounds - Container dimensions {width, height}
+     * @param options - Optional overrides
+     * @returns Array of layout objects with position, rotation, scale
+     */
+    generate(imageCount: number, containerBounds: ContainerBounds, options?: RadialLayoutOptions): ImageLayout[];
+    /**
+     * Estimate image width based on height
+     * Assumes landscape aspect ratio (approximately 1.4:1)
+     * @param height - Image height
+     * @returns Estimated width
+     */
+    private estimateWidth;
+    /**
+     * Utility: Generate random number between min and max
+     * @param min - Minimum value
+     * @param max - Maximum value
+     * @returns Random number in range
+     */
+    private random;
+}
+export {};
+//# sourceMappingURL=RadialPlacementLayout.d.ts.map

package/dist/layouts/RadialPlacementLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RadialPlacementLayout.d.ts","sourceRoot":"","sources":["../../src/layouts/RadialPlacementLayout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEhH,UAAU,mBAAoB,SAAQ,OAAO,CAAC,YAAY,CAAC;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,qBAAsB,YAAW,eAAe;IAC3D,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE,YAAY,EAAE,WAAW,GAAE,WAAgB;IAK/D;;;;;;OAMG;IACH,QAAQ,CACN,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,eAAe,EAChC,OAAO,GAAE,mBAAwB,GAChC,WAAW,EAAE;IAiIhB;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAMrB;;;;;OAKG;IACH,OAAO,CAAC,MAAM;CAGf"}

package/dist/layouts/RandomPlacementLayout.d.ts

@@ -0,0 +1,26 @@
+import { PlacementLayout, ImageLayout, ContainerBounds, LayoutConfig, ImageConfig } from '../config/types';
+interface RandomLayoutOptions extends Partial<LayoutConfig> {
+    fixedHeight?: number;
+}
+export declare class RandomPlacementLayout implements PlacementLayout {
+    private config;
+    private imageConfig;
+    constructor(config: LayoutConfig, imageConfig?: ImageConfig);
+    /**
+     * Generate random layout positions for images
+     * @param imageCount - Number of images to layout
+     * @param containerBounds - Container dimensions {width, height}
+     * @param options - Optional overrides (includes fixedHeight)
+     * @returns Array of layout objects with position, rotation, scale
+     */
+    generate(imageCount: number, containerBounds: ContainerBounds, options?: RandomLayoutOptions): ImageLayout[];
+    /**
+     * Utility: Generate random number between min and max
+     * @param min - Minimum value
+     * @param max - Maximum value
+     * @returns Random number in range
+     */
+    private random;
+}
+export {};
+//# sourceMappingURL=RandomPlacementLayout.d.ts.map

package/dist/layouts/RandomPlacementLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RandomPlacementLayout.d.ts","sourceRoot":"","sources":["../../src/layouts/RandomPlacementLayout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEhH,UAAU,mBAAoB,SAAQ,OAAO,CAAC,YAAY,CAAC;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,qBAAsB,YAAW,eAAe;IAC3D,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE,YAAY,EAAE,WAAW,GAAE,WAAgB;IAK/D;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,eAAe,EAAE,OAAO,GAAE,mBAAwB,GAAG,WAAW,EAAE;IAwDhH;;;;;OAKG;IACH,OAAO,CAAC,MAAM;CAGf"}

package/dist/layouts/SpiralPlacementLayout.d.ts

@@ -0,0 +1,43 @@
+import { PlacementLayout, ImageLayout, ContainerBounds, LayoutConfig, ImageConfig } from '../config/types';
+interface SpiralLayoutOptions extends Partial<LayoutConfig> {
+    fixedHeight?: number;
+}
+export declare class SpiralPlacementLayout implements PlacementLayout {
+    private config;
+    private imageConfig;
+    constructor(config: LayoutConfig, imageConfig?: ImageConfig);
+    /**
+     * Generate spiral layout positions for images
+     * @param imageCount - Number of images to layout
+     * @param containerBounds - Container dimensions {width, height}
+     * @param options - Optional overrides (includes fixedHeight)
+     * @returns Array of layout objects with position, rotation, scale
+     */
+    generate(imageCount: number, containerBounds: ContainerBounds, options?: SpiralLayoutOptions): ImageLayout[];
+    /**
+     * Calculate tangent angle for spiral curve at given position
+     * This aligns the image along the spiral's direction of travel
+     */
+    private calculateSpiralTangent;
+    /**
+     * Calculate radius for golden spiral (Vogel's model)
+     * Creates even distribution like sunflower seeds
+     */
+    private calculateGoldenRadius;
+    /**
+     * Calculate radius for Archimedean spiral
+     * r = a + b*θ (constant spacing between arms)
+     */
+    private calculateArchimedeanRadius;
+    /**
+     * Calculate radius for logarithmic (equiangular) spiral
+     * r = a * e^(b*θ)
+     */
+    private calculateLogarithmicRadius;
+    /**
+     * Utility: Generate random number between min and max
+     */
+    private random;
+}
+export {};
+//# sourceMappingURL=SpiralPlacementLayout.d.ts.map

package/dist/layouts/SpiralPlacementLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpiralPlacementLayout.d.ts","sourceRoot":"","sources":["../../src/layouts/SpiralPlacementLayout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAyB,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEvI,UAAU,mBAAoB,SAAQ,OAAO,CAAC,YAAY,CAAC;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAaD,qBAAa,qBAAsB,YAAW,eAAe;IAC3D,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE,YAAY,EAAE,WAAW,GAAE,WAAgB;IAK/D;;;;;;OAMG;IACH,QAAQ,CACN,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,eAAe,EAChC,OAAO,GAAE,mBAAwB,GAChC,WAAW,EAAE;IAsHhB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAoC9B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAa7B;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IAYlC;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IAmBlC;;OAEG;IACH,OAAO,CAAC,MAAM;CAGf"}

package/dist/layouts/WavePlacementLayout.d.ts

@@ -0,0 +1,48 @@
+import { PlacementLayout, ImageLayout, ContainerBounds, LayoutConfig, ImageConfig } from '../config/types';
+interface WaveLayoutOptions extends Partial<LayoutConfig> {
+    fixedHeight?: number;
+}
+export declare class WavePlacementLayout implements PlacementLayout {
+    private config;
+    private imageConfig;
+    constructor(config: LayoutConfig, imageConfig?: ImageConfig);
+    /**
+     * Generate wave layout positions for images
+     * @param imageCount - Number of images to layout
+     * @param containerBounds - Container dimensions {width, height}
+     * @param options - Optional overrides
+     * @returns Array of layout objects with position, rotation, scale
+     */
+    generate(imageCount: number, containerBounds: ContainerBounds, options?: WaveLayoutOptions): ImageLayout[];
+    /**
+     * Calculate Y position displacement on wave curve
+     * @param x - Horizontal position
+     * @param containerWidth - Container width
+     * @param amplitude - Wave amplitude
+     * @param frequency - Wave frequency
+     * @param phase - Phase offset
+     * @returns Y displacement from baseline
+     */
+    private calculateWaveY;
+    /**
+     * Calculate rotation based on wave tangent
+     * @param x - Horizontal position
+     * @param containerWidth - Container width
+     * @param amplitude - Wave amplitude
+     * @param frequency - Wave frequency
+     * @param phase - Phase offset
+     * @returns Rotation angle in degrees
+     */
+    private calculateRotation;
+    /**
+     * Estimate image width based on height
+    /**
+     * Utility: Generate random number between min and max
+     * @param min - Minimum value
+     * @param max - Maximum value
+     * @returns Random number in range
+     */
+    private random;
+}
+export {};
+//# sourceMappingURL=WavePlacementLayout.d.ts.map

package/dist/layouts/WavePlacementLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WavePlacementLayout.d.ts","sourceRoot":"","sources":["../../src/layouts/WavePlacementLayout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGhH,UAAU,iBAAkB,SAAQ,OAAO,CAAC,YAAY,CAAC;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,mBAAoB,YAAW,eAAe;IACzD,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE,YAAY,EAAE,WAAW,GAAE,WAAgB;IAK/D;;;;;;OAMG;IACH,QAAQ,CACN,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,eAAe,EAChC,OAAO,GAAE,iBAAsB,GAC9B,WAAW,EAAE;IAgIhB;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc;IActB;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM;CAGf"}

package/dist/loaders/CompositeLoader.d.ts

@@ -0,0 +1,37 @@
+import { ImageLoader, IImageFilter } from '../config/types';
+export interface CompositeLoaderConfig {
+    loaders: ImageLoader[];
+    debugLogging?: boolean;
+}
+export declare class CompositeLoader implements ImageLoader {
+    private loaders;
+    private debugLogging;
+    private _prepared;
+    private _discoveredUrls;
+    constructor(config: CompositeLoaderConfig);
+    /**
+     * Prepare all loaders in parallel and combine their results
+     * @param filter - Filter to apply to discovered images
+     */
+    prepare(filter: IImageFilter): Promise<void>;
+    /**
+     * Get the combined number of discovered images
+     * @throws Error if called before prepare()
+     */
+    imagesLength(): number;
+    /**
+     * Get the combined ordered list of image URLs
+     * @throws Error if called before prepare()
+     */
+    imageURLs(): string[];
+    /**
+     * Check if the loader has been prepared
+     */
+    isPrepared(): boolean;
+    /**
+     * Debug logging helper
+     * @param args - Arguments to log
+     */
+    private log;
+}
+//# sourceMappingURL=CompositeLoader.d.ts.map

package/dist/loaders/CompositeLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompositeLoader.d.ts","sourceRoot":"","sources":["../../src/loaders/CompositeLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEjE,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,YAAY,CAAU;IAG9B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,eAAe,CAAgB;gBAE3B,MAAM,EAAE,qBAAqB;IAYzC;;;OAGG;IACG,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BlD;;;OAGG;IACH,YAAY,IAAI,MAAM;IAOtB;;;OAGG;IACH,SAAS,IAAI,MAAM,EAAE;IAOrB;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;;OAGG;IACH,OAAO,CAAC,GAAG;CAKZ"}

package/dist/loaders/GoogleDriveLoader.d.ts

@@ -0,0 +1,90 @@
+import { ImageLoader, IImageFilter, GoogleDriveLoaderInnerConfig } from '../config/types';
+export declare class GoogleDriveLoader implements ImageLoader {
+    private apiKey;
+    private apiEndpoint;
+    private debugLogging;
+    private sources;
+    private _prepared;
+    private _discoveredUrls;
+    constructor(config: GoogleDriveLoaderInnerConfig);
+    /**
+     * Prepare the loader by discovering all images from configured sources
+     * @param filter - Filter to apply to discovered images
+     */
+    prepare(filter: IImageFilter): Promise<void>;
+    /**
+     * Get the number of discovered images
+     * @throws Error if called before prepare()
+     */
+    imagesLength(): number;
+    /**
+     * Get the ordered list of image URLs
+     * @throws Error if called before prepare()
+     */
+    imageURLs(): string[];
+    /**
+     * Check if the loader has been prepared
+     */
+    isPrepared(): boolean;
+    /**
+     * Extract folder ID from various Google Drive URL formats
+     * @param folderUrl - Google Drive folder URL
+     * @returns Folder ID or null if invalid
+     */
+    extractFolderId(folderUrl: string): string | null;
+    /**
+     * Load images from a Google Drive folder
+     * @param folderUrl - Google Drive folder URL
+     * @param filter - Filter to apply to discovered images
+     * @param recursive - Whether to include images from subfolders
+     * @returns Promise resolving to array of image URLs
+     */
+    private loadFromFolder;
+    /**
+     * Load images from a single folder (non-recursive)
+     * @param folderId - Google Drive folder ID
+     * @param filter - Filter to apply to discovered images
+     * @returns Promise resolving to array of image URLs
+     */
+    private loadImagesFromSingleFolder;
+    /**
+     * Load specific files by their URLs or IDs
+     * @param fileUrls - Array of Google Drive file URLs or IDs
+     * @param filter - Filter to apply to discovered images
+     * @returns Promise resolving to array of image URLs
+     */
+    private loadFiles;
+    /**
+     * Extract file ID from Google Drive file URL
+     * @param fileUrl - Google Drive file URL or file ID
+     * @returns File ID or null if invalid
+     */
+    private extractFileId;
+    /**
+     * Recursively load images from a folder and all its subfolders
+     * @param folderId - Google Drive folder ID
+     * @param filter - Filter to apply to discovered images
+     * @returns Promise resolving to array of image URLs
+     */
+    private loadImagesRecursively;
+    /**
+     * Direct loading method (no API key required, but less reliable)
+     * Uses embedded folder view to scrape image IDs
+     * @param folderId - Google Drive folder ID
+     * @param filter - Filter to apply (not used in fallback mode)
+     * @returns Promise resolving to array of image URLs
+     */
+    private loadImagesDirectly;
+    /**
+     * Manually add image URLs (for testing or when auto-loading fails)
+     * @param imageIds - Array of Google Drive file IDs
+     * @returns Array of direct image URLs
+     */
+    manualImageUrls(imageIds: string[]): string[];
+    /**
+     * Debug logging helper
+     * @param args - Arguments to log
+     */
+    private log;
+}
+//# sourceMappingURL=GoogleDriveLoader.d.ts.map

package/dist/loaders/GoogleDriveLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleDriveLoader.d.ts","sourceRoot":"","sources":["../../src/loaders/GoogleDriveLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAuB,4BAA4B,EAAqB,MAAM,iBAAiB,CAAC;AAEvI,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,OAAO,CAAsB;IAGrC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,eAAe,CAAgB;gBAE3B,MAAM,EAAE,4BAA4B;IAYhD;;;OAGG;IACG,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBlD;;;OAGG;IACH,YAAY,IAAI,MAAM;IAOtB;;;OAGG;IACH,SAAS,IAAI,MAAM,EAAE;IAOrB;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;;;OAIG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAoBjD;;;;;;OAMG;YACW,cAAc;IAyB5B;;;;;OAKG;YACW,0BAA0B;IAgCxC;;;;;OAKG;YACW,SAAS;IAyCvB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IA2BrB;;;;;OAKG;YACW,qBAAqB;IA0DnC;;;;;;OAMG;YACW,kBAAkB;IAwChC;;;;OAIG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAI7C;;;OAGG;IACH,OAAO,CAAC,GAAG;CAKZ"}

package/dist/loaders/ImageFilter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * ImageFilter.ts
+ * Filters images by extension, designed for future extensibility
+ * (e.g., size filters, date filters, etc.)
+ */
+export declare class ImageFilter {
+    private allowedExtensions;
+    /**
+     * Create a new ImageFilter
+     * @param extensions - Array of allowed file extensions (without dots)
+     *                     Defaults to common image formats if not provided
+     */
+    constructor(extensions?: string[]);
+    /**
+     * Check if a filename has an allowed extension
+     * @param filename - The filename to check (can include path or query string)
+     * @returns True if the file extension is allowed
+     */
+    isAllowed(filename: string): boolean;
+    /**
+     * Get the list of allowed extensions
+     * @returns Array of allowed extensions
+     */
+    getAllowedExtensions(): string[];
+}
+//# sourceMappingURL=ImageFilter.d.ts.map

package/dist/loaders/ImageFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageFilter.d.ts","sourceRoot":"","sources":["../../src/loaders/ImageFilter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qBAAa,WAAW;IACtB,OAAO,CAAC,iBAAiB,CAAW;IAEpC;;;;OAIG;gBACS,UAAU,CAAC,EAAE,MAAM,EAAE;IAMjC;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAOpC;;;OAGG;IACH,oBAAoB,IAAI,MAAM,EAAE;CAQjC"}

package/dist/loaders/StaticImageLoader.d.ts

@@ -0,0 +1,85 @@
+import { ImageLoader, IImageFilter, StaticLoaderInnerConfig } from '../config/types';
+export declare class StaticImageLoader implements ImageLoader {
+    private validateUrls;
+    private validationTimeout;
+    private validationMethod;
+    private sources;
+    private debugLogging;
+    private _prepared;
+    private _discoveredUrls;
+    constructor(config: StaticLoaderInnerConfig);
+    /**
+     * Prepare the loader by discovering all images from configured sources
+     * @param filter - Filter to apply to discovered images
+     */
+    prepare(filter: IImageFilter): Promise<void>;
+    /**
+     * Get the number of discovered images
+     * @throws Error if called before prepare()
+     */
+    imagesLength(): number;
+    /**
+     * Get the ordered list of image URLs
+     * @throws Error if called before prepare()
+     */
+    imageURLs(): string[];
+    /**
+     * Check if the loader has been prepared
+     */
+    isPrepared(): boolean;
+    /**
+     * 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
+     */
+    private processSource;
+    /**
+     * Process a list of direct URLs
+     * @param urls - Array of image URLs
+     * @param filter - Filter to apply to discovered images
+     * @returns Promise resolving to array of validated URLs
+     */
+    private processUrls;
+    /**
+     * Process a path-based source
+     * @param basePath - Base path (relative or absolute)
+     * @param files - Array of filenames
+     * @param filter - Filter to apply to discovered images
+     * @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
+     * @returns Promise resolving to true if valid and accessible
+     */
+    private validateUrl;
+    /**
+     * Construct full URL from basePath and filename
+     * @param basePath - Base path (relative or absolute)
+     * @param filename - Filename to append
+     * @returns Complete URL
+     */
+    private constructUrl;
+    /**
+     * Check if URL is absolute (contains protocol)
+     * @param url - URL to check
+     * @returns True if absolute URL
+     */
+    private isAbsoluteUrl;
+    /**
+     * Debug logging helper
+     * @param args - Arguments to log
+     */
+    private log;
+}
+//# sourceMappingURL=StaticImageLoader.d.ts.map

package/dist/loaders/StaticImageLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StaticImageLoader.d.ts","sourceRoot":"","sources":["../../src/loaders/StaticImageLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAgB,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAExG,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,YAAY,CAAU;IAG9B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,eAAe,CAAgB;gBAE3B,MAAM,EAAE,uBAAuB;IAe3C;;;OAGG;IACG,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBlD;;;OAGG;IACH,YAAY,IAAI,MAAM;IAOtB;;;OAGG;IACH,SAAS,IAAI,MAAM,EAAE;IAOrB;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;;;;OAKG;YACW,aAAa;IAkB3B;;;;;OAKG;YACW,WAAW;IAgCzB;;;;;;OAMG;YACW,WAAW;IAkCzB;;;;;;OAMG;YACW,WAAW;IAkCzB;;;;OAIG;YACW,WAAW;IAkEzB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAsBpB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IASrB;;;OAGG;IACH,OAAO,CAAC,GAAG;CAKZ"}

package/dist/react/index.d.ts

@@ -0,0 +1,16 @@
+import { CSSProperties } from 'react';
+import { ImageCloud as ImageCloudCore } from '../ImageCloud';
+import { ImageCloudOptions } from '../config/types';
+export type ImageCloudProps = Omit<ImageCloudOptions, 'container'> & {
+    className?: string;
+    style?: CSSProperties;
+};
+export interface ImageCloudRef {
+    instance: ImageCloudCore | null;
+}
+export declare const ImageCloud: import('react').ForwardRefExoticComponent<Omit<ImageCloudOptions, "container"> & {
+    className?: string;
+    style?: CSSProperties;
+} & import('react').RefAttributes<ImageCloudRef>>;
+export type { ImageCloudOptions, LayoutAlgorithm, LayoutConfig, AnimationConfig, ImageStylingConfig, } from '../config/types';
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,GAAG;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;CACjC;AAED,eAAO,MAAM,UAAU;gBART,MAAM;YACV,aAAa;iDAwCtB,CAAC;AAGF,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}

package/dist/react.d.ts

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,GAAG;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;CACjC;AAED,eAAO,MAAM,UAAU;gBART,MAAM;YACV,aAAa;iDAwCtB,CAAC;AAGF,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}