@frybynite/image-cloud 0.3.7 → 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);
@@ -688,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);
@@ -1020,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
@@ -1127,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[];
 }
 
@@ -1140,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);
@@ -1172,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);
@@ -1261,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);
@@ -1448,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;
@@ -1458,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.7",
+  "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",