@frybynite/image-cloud 0.3.6 → 0.4.0

package/dist/index.d.ts

@@ -179,7 +179,7 @@ declare interface ClusterLayoutOptions extends Partial<LayoutConfig> {
     fixedHeight?: number;
 }
 
-export declare class ClusterPlacementGenerator implements PlacementGenerator {
+export declare class ClusterPlacementLayout implements PlacementLayout {
     private config;
     private imageConfig;
     constructor(config: LayoutConfig, imageConfig?: ImageConfig);
@@ -253,6 +253,7 @@ export declare interface CompositeLoaderConfig {
 
 export declare interface ConfigSection {
     loaders?: SharedLoaderConfig;
+    debug?: DebugConfig;
 }
 
 export declare interface ContainerBounds {
@@ -260,6 +261,12 @@ export declare interface ContainerBounds {
     height: number;
 }
 
+export declare interface DebugConfig {
+    enabled?: boolean;
+    centers?: boolean;
+    loaders?: boolean;
+}
+
 export declare const DEFAULT_CONFIG: ImageCloudConfig;
 
 /**
@@ -681,7 +688,7 @@ declare interface GridLayoutOptions extends Partial<LayoutConfig> {
     fixedHeight?: number;
 }
 
-export declare class GridPlacementGenerator implements PlacementGenerator {
+export declare class GridPlacementLayout implements PlacementLayout {
     private config;
     private imageConfig;
     constructor(config: LayoutConfig, imageConfig?: ImageConfig);
@@ -821,7 +828,6 @@ export declare interface ImageCloudConfig {
     interaction: InteractionConfig;
     rendering: RenderingConfig;
     styling?: ImageStylingConfig;
-    debug: boolean;
 }
 
 export declare interface ImageCloudOptions {
@@ -835,7 +841,6 @@ export declare interface ImageCloudOptions {
     interaction?: Partial<InteractionConfig>;
     rendering?: Partial<RenderingConfig>;
     styling?: Partial<ImageStylingConfig>;
-    debug?: boolean;
 }
 
 /**
@@ -885,7 +890,6 @@ export declare interface ImageLayout {
     scale: number;
     baseSize: number;
     zIndex?: number;
-    borderColor?: string;
 }
 
 /**
@@ -1006,8 +1010,6 @@ export declare interface LayoutConfig {
     responsive?: ResponsiveBreakpoints;
     targetCoverage?: number;
     densityFactor?: number;
-    debugRadials?: boolean;
-    debugCenters?: boolean;
     grid?: GridAlgorithmConfig;
     spiral?: SpiralAlgorithmConfig;
     cluster?: ClusterAlgorithmConfig;
@@ -1018,13 +1020,13 @@ export declare class LayoutEngine {
     private config;
     private imageConfig;
     private layouts;
-    private generator;
+    private placementLayout;
     constructor(config: LayoutEngineConfig);
     /**
-     * Initialize the appropriate generator based on config type
-     * @returns Initialized placement generator
+     * Initialize the appropriate placement layout based on config type
+     * @returns Initialized placement layout
      */
-    private initGenerator;
+    private initLayout;
     /**
      * Generate layout positions for images
      * @param imageCount - Number of images to layout
@@ -1125,7 +1127,7 @@ declare interface PerformanceRenderingConfig {
     imageQuality?: 'auto' | 'high' | 'medium' | 'low';
 }
 
-export declare interface PlacementGenerator {
+export declare interface PlacementLayout {
     generate(imageCount: number, containerBounds: ContainerBounds, options?: Partial<LayoutConfig>): ImageLayout[];
 }
 
@@ -1138,7 +1140,7 @@ declare interface RadialLayoutOptions extends Partial<LayoutConfig> {
     fixedHeight?: number;
 }
 
-export declare class RadialPlacementGenerator implements PlacementGenerator {
+export declare class RadialPlacementLayout implements PlacementLayout {
     private config;
     private imageConfig;
     constructor(config: LayoutConfig, imageConfig?: ImageConfig);
@@ -1170,7 +1172,7 @@ declare interface RandomLayoutOptions extends Partial<LayoutConfig> {
     fixedHeight?: number;
 }
 
-export declare class RandomPlacementGenerator implements PlacementGenerator {
+export declare class RandomPlacementLayout implements PlacementLayout {
     private config;
     private imageConfig;
     constructor(config: LayoutConfig, imageConfig?: ImageConfig);
@@ -1237,7 +1239,6 @@ export declare interface SharedLoaderConfig {
     validationMethod?: 'head' | 'simple' | 'none';
     failOnAllMissing?: boolean;
     allowedExtensions?: string[];
-    debugLogging?: boolean;
 }
 
 /**
@@ -1260,7 +1261,7 @@ declare interface SpiralLayoutOptions extends Partial<LayoutConfig> {
     fixedHeight?: number;
 }
 
-export declare class SpiralPlacementGenerator implements PlacementGenerator {
+export declare class SpiralPlacementLayout implements PlacementLayout {
     private config;
     private imageConfig;
     constructor(config: LayoutConfig, imageConfig?: ImageConfig);
@@ -1447,6 +1448,10 @@ declare interface WaveAlgorithmConfig {
     synchronization: 'offset' | 'synchronized' | 'alternating';
 }
 
+declare interface WaveLayoutOptions extends Partial<LayoutConfig> {
+    fixedHeight?: number;
+}
+
 export declare interface WavePathConfig {
     amplitude: number;
     frequency: number;
@@ -1457,6 +1462,49 @@ export declare interface WavePathConfig {
 
 export declare type WavePathPreset = 'gentle' | 'playful' | 'serpentine' | 'flutter';
 
+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 declare class ZoomEngine {
     private config;
     private animationEngine;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frybynite/image-cloud",
-  "version": "0.3.6",
+  "version": "0.4.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",