@frybynite/image-cloud 0.3.7 → 0.4.0

package/README.md

@@ -104,10 +104,10 @@ await cloud.init();
 For detailed configuration, see the documentation in the `docs/` folder:
 
 1. **[Loaders](docs/LOADERS.md)** — Configure image sources (static URLs, JSON endpoints, local paths, Google Drive folders)
-2. **[Layout Generators](docs/GENERATORS.md)** — Choose and customize layout algorithms (radial, grid, spiral, cluster, random)
+2. **[Layouts](docs/LAYOUTS.md)** — Choose and customize layout algorithms (radial, grid, spiral, cluster, random, wave)
 3. **[Image Sizing](docs/IMAGE_SIZING.md)** — Control base sizes, variance, and responsive/adaptive behavior
 4. **[Full Parameter Reference](docs/PARAMETERS.md)** — Complete configuration options for animation, interaction, styling, and more
-5. **[API Reference](docs/api/README.md)** — TypeScript API documentation for the ImageCloud class, types, loaders, and generators
+5. **[API Reference](docs/api/README.md)** — TypeScript API documentation for the ImageCloud class, types, loaders, and layouts
 
 ### Using the Configurator
 

package/dist/image-cloud-auto-init.js

@@ -4,16 +4,16 @@ const jt = ".fbn-ic-gallery{--fbn-ic-bg-primary: #05060F;--fbn-ic-bg-secondary:
   md: "0 4px 16px rgba(0,0,0,0.4)",
   lg: "0 8px 32px rgba(0,0,0,0.5)",
   glow: "0 0 30px rgba(255,255,255,0.6)"
-}), Mt = Object.freeze({
+}), Lt = Object.freeze({
   energetic: Object.freeze({ overshoot: 0.25, bounces: 2, decayRatio: 0.5 }),
   playful: Object.freeze({ overshoot: 0.15, bounces: 1, decayRatio: 0.5 }),
   subtle: Object.freeze({ overshoot: 0.08, bounces: 1, decayRatio: 0.5 })
-}), zt = Object.freeze({
+}), Mt = Object.freeze({
   gentle: Object.freeze({ stiffness: 150, damping: 30, mass: 1, oscillations: 2 }),
   bouncy: Object.freeze({ stiffness: 300, damping: 15, mass: 1, oscillations: 4 }),
   wobbly: Object.freeze({ stiffness: 180, damping: 12, mass: 1.5, oscillations: 5 }),
   snappy: Object.freeze({ stiffness: 400, damping: 25, mass: 0.8, oscillations: 2 })
-}), Ft = Object.freeze({
+}), zt = Object.freeze({
   gentle: Object.freeze({ amplitude: 30, frequency: 1.5, decay: !0, decayRate: 0.9, phase: 0 }),
   playful: Object.freeze({ amplitude: 50, frequency: 2.5, decay: !0, decayRate: 0.7, phase: 0 }),
   serpentine: Object.freeze({ amplitude: 60, frequency: 3, decay: !1, decayRate: 1, phase: 0 }),
@@ -49,14 +49,14 @@ const jt = ".fbn-ic-gallery{--fbn-ic-bg-primary: #05060F;--fbn-ic-bg-secondary:
   focused: Object.freeze({
     shadow: "none"
   })
-}), Gt = Object.freeze({
+}), Wt = Object.freeze({
   rows: 1,
   amplitude: 100,
   frequency: 2,
   phaseShift: 0,
   synchronization: "offset"
   // Note: Image rotation along wave is now controlled via image.rotation.mode = 'tangent'
-}), Wt = Object.freeze({
+}), Gt = Object.freeze({
   mobile: Object.freeze({ maxWidth: 767 }),
   tablet: Object.freeze({ maxWidth: 1199 })
 }), qt = Object.freeze({
@@ -105,7 +105,7 @@ const jt = ".fbn-ic-gallery{--fbn-ic-bg-primary: #05060F;--fbn-ic-bg-secondary:
     algorithm: "radial",
     scaleDecay: 0,
     // No decay by default (0-1 for radial/spiral)
-    responsive: Wt,
+    responsive: Gt,
     targetCoverage: 0.6,
     // Target 60% of container area
     densityFactor: 1,
@@ -387,13 +387,13 @@ function Kt(o = {}) {
   }, a;
 }
 function Zt(o, t) {
-  return { ...o ? Mt[o] : Mt.playful, ...t };
+  return { ...o ? Lt[o] : Lt.playful, ...t };
 }
 function Qt(o, t) {
-  return { ...o ? zt[o] : zt.gentle, ...t };
+  return { ...o ? Mt[o] : Mt.gentle, ...t };
 }
 function te(o, t) {
-  return { ...o ? Ft[o] : Ft.gentle, ...t };
+  return { ...o ? zt[o] : zt.gentle, ...t };
 }
 class ee {
   constructor(t) {
@@ -660,8 +660,8 @@ function le(o) {
     return;
   }
   const _ = performance.now(), H = -r / 2, $ = -a / 2;
-  function D(G) {
-    const M = G - _, w = Math.min(M / s, 1);
+  function D(W) {
+    const L = W - _, w = Math.min(L / s, 1);
     let T;
     switch (b) {
       case "bounce": {
@@ -694,11 +694,11 @@ function le(o) {
           y: st(e.y, i.y, w)
         };
     }
-    const z = T.x - i.x, C = T.y - i.y;
+    const M = T.x - i.x, C = T.y - i.y;
     let R;
     m ? R = re(w, c, y) : f ? R = st(h, c, w) : R = c;
-    let F;
-    A ? F = ce(w, u, S) : E ? F = st(p, u, w) : F = u, t.style.transform = `translate(${H}px, ${$}px) translate(${z}px, ${C}px) rotate(${R}deg) scale(${F})`, w < 1 ? requestAnimationFrame(D) : (t.style.transform = `translate(${H}px, ${$}px) rotate(${c}deg) scale(${u})`, l && l());
+    let z;
+    A ? z = ce(w, u, S) : E ? z = st(p, u, w) : z = u, t.style.transform = `translate(${H}px, ${$}px) translate(${M}px, ${C}px) rotate(${R}deg) scale(${z})`, w < 1 ? requestAnimationFrame(D) : (t.style.transform = `translate(${H}px, ${$}px) rotate(${c}deg) scale(${u})`, l && l());
   }
   requestAnimationFrame(D);
 }
@@ -1069,15 +1069,15 @@ class ge {
    * @returns Array of layout objects with position, rotation, scale
    */
   generate(t, e, i = {}) {
-    var S, L, _, H, $, D, G, M, w;
-    const n = [], { width: s, height: r } = e, a = this.config.spacing.padding, c = i.fixedHeight ?? 200, u = ((S = this.imageConfig.rotation) == null ? void 0 : S.mode) ?? "none", l = ((_ = (L = this.imageConfig.rotation) == null ? void 0 : L.range) == null ? void 0 : _.min) ?? -15, d = (($ = (H = this.imageConfig.rotation) == null ? void 0 : H.range) == null ? void 0 : $.max) ?? 15, h = ((G = (D = this.imageConfig.sizing) == null ? void 0 : D.variance) == null ? void 0 : G.min) ?? 1, g = ((w = (M = this.imageConfig.sizing) == null ? void 0 : M.variance) == null ? void 0 : w.max) ?? 1, p = h !== 1 || g !== 1, f = c * 1.5 / 2, m = c / 2, y = s - a - f, v = r - a - m, E = a + f, A = a + m;
+    var S, F, _, H, $, D, W, L, w;
+    const n = [], { width: s, height: r } = e, a = this.config.spacing.padding, c = i.fixedHeight ?? 200, u = ((S = this.imageConfig.rotation) == null ? void 0 : S.mode) ?? "none", l = ((_ = (F = this.imageConfig.rotation) == null ? void 0 : F.range) == null ? void 0 : _.min) ?? -15, d = (($ = (H = this.imageConfig.rotation) == null ? void 0 : H.range) == null ? void 0 : $.max) ?? 15, h = ((W = (D = this.imageConfig.sizing) == null ? void 0 : D.variance) == null ? void 0 : W.min) ?? 1, g = ((w = (L = this.imageConfig.sizing) == null ? void 0 : L.variance) == null ? void 0 : w.max) ?? 1, p = h !== 1 || g !== 1, f = c * 1.5 / 2, m = c / 2, y = s - a - f, v = r - a - m, E = a + f, A = a + m;
     for (let T = 0; T < t; T++) {
-      const z = this.random(E, y), C = this.random(A, v), R = u === "random" ? this.random(l, d) : 0, F = p ? this.random(h, g) : 1, U = c * F, Z = {
+      const M = this.random(E, y), C = this.random(A, v), R = u === "random" ? this.random(l, d) : 0, z = p ? this.random(h, g) : 1, U = c * z, Z = {
         id: T,
-        x: z,
+        x: M,
         y: C,
         rotation: R,
-        scale: F,
+        scale: z,
         baseSize: U
       };
       n.push(Z);
@@ -1106,8 +1106,8 @@ class fe {
    * @returns Array of layout objects with position, rotation, scale
    */
   generate(t, e, i = {}) {
-    var A, S, L, _, H, $, D, G, M;
-    const n = [], { width: s, height: r } = e, a = i.fixedHeight ?? 200, c = ((A = this.imageConfig.rotation) == null ? void 0 : A.mode) ?? "none", u = ((L = (S = this.imageConfig.rotation) == null ? void 0 : S.range) == null ? void 0 : L.min) ?? -15, l = ((H = (_ = this.imageConfig.rotation) == null ? void 0 : _.range) == null ? void 0 : H.max) ?? 15, d = ((D = ($ = this.imageConfig.sizing) == null ? void 0 : $.variance) == null ? void 0 : D.min) ?? 1, h = ((M = (G = this.imageConfig.sizing) == null ? void 0 : G.variance) == null ? void 0 : M.max) ?? 1, g = d !== 1 || h !== 1, p = this.config.scaleDecay ?? 0, b = i.fixedHeight ?? a, f = s / 2, m = r / 2, y = Math.ceil(Math.sqrt(t));
+    var A, S, F, _, H, $, D, W, L;
+    const n = [], { width: s, height: r } = e, a = i.fixedHeight ?? 200, c = ((A = this.imageConfig.rotation) == null ? void 0 : A.mode) ?? "none", u = ((F = (S = this.imageConfig.rotation) == null ? void 0 : S.range) == null ? void 0 : F.min) ?? -15, l = ((H = (_ = this.imageConfig.rotation) == null ? void 0 : _.range) == null ? void 0 : H.max) ?? 15, d = ((D = ($ = this.imageConfig.sizing) == null ? void 0 : $.variance) == null ? void 0 : D.min) ?? 1, h = ((L = (W = this.imageConfig.sizing) == null ? void 0 : W.variance) == null ? void 0 : L.max) ?? 1, g = d !== 1 || h !== 1, p = this.config.scaleDecay ?? 0, b = i.fixedHeight ?? a, f = s / 2, m = r / 2, y = Math.ceil(Math.sqrt(t));
     if (t > 0) {
       const w = g ? this.random(d, h) : 1, T = b * w;
       n.push({
@@ -1124,15 +1124,15 @@ class fe {
     }
     let v = 1, E = 1;
     for (; v < t; ) {
-      const w = E / y, T = p > 0 ? 1 - w * p * 0.5 : 1, z = E * (b * 0.8), C = z * 1.5, R = Math.PI * (3 * (C + z) - Math.sqrt((3 * C + z) * (C + 3 * z))), F = this.estimateWidth(b), U = Math.floor(R / (F * 0.7));
+      const w = E / y, T = p > 0 ? 1 - w * p * 0.5 : 1, M = E * (b * 0.8), C = M * 1.5, R = Math.PI * (3 * (C + M) - Math.sqrt((3 * C + M) * (C + 3 * M))), z = this.estimateWidth(b), U = Math.floor(R / (z * 0.7));
       if (U === 0) {
         E++;
         continue;
       }
       const Z = 2 * Math.PI / U, Q = E * (20 * Math.PI / 180);
-      for (let W = 0; W < U && v < t; W++) {
-        const tt = W * Z + Q, Y = g ? this.random(d, h) : 1, et = T * Y, X = b * et;
-        let N = f + Math.cos(tt) * C, B = m + Math.sin(tt) * z;
+      for (let G = 0; G < U && v < t; G++) {
+        const tt = G * Z + Q, Y = g ? this.random(d, h) : 1, et = T * Y, X = b * et;
+        let N = f + Math.cos(tt) * C, B = m + Math.sin(tt) * M;
         const k = this.config.spacing.padding ?? 50, j = X * 1.5 / 2, O = X / 2;
         N - j < k ? N = k + j : N + j > s - k && (N = s - k - j), B - O < k ? B = k + O : B + O > r - k && (B = r - k - O);
         const J = c === "random" ? this.random(u, l) : 0;
@@ -1180,7 +1180,7 @@ const me = {
   alignment: "center",
   gap: 10,
   overflowOffset: 0.25
-}, Lt = [
+}, Ft = [
   { x: 1, y: 1 },
   // bottom-right
   { x: -1, y: -1 },
@@ -1210,14 +1210,14 @@ class pe {
    * @returns Array of layout objects with position, rotation, scale
    */
   generate(t, e, i = {}) {
-    var Q, W, tt, Y, et, X, N, B, k;
-    const n = [], { width: s, height: r } = e, a = { ...me, ...this.config.grid }, c = this.config.spacing.padding, u = i.fixedHeight ?? 200, l = ((Q = this.imageConfig.rotation) == null ? void 0 : Q.mode) ?? "none", d = ((tt = (W = this.imageConfig.sizing) == null ? void 0 : W.variance) == null ? void 0 : tt.min) ?? 1, h = ((et = (Y = this.imageConfig.sizing) == null ? void 0 : Y.variance) == null ? void 0 : et.max) ?? 1, g = d !== 1 || h !== 1, p = s - 2 * c, b = r - 2 * c, { columns: f, rows: m } = this.calculateGridDimensions(
+    var Q, G, tt, Y, et, X, N, B, k;
+    const n = [], { width: s, height: r } = e, a = { ...me, ...this.config.grid }, c = this.config.spacing.padding, u = i.fixedHeight ?? 200, l = ((Q = this.imageConfig.rotation) == null ? void 0 : Q.mode) ?? "none", d = ((tt = (G = this.imageConfig.sizing) == null ? void 0 : G.variance) == null ? void 0 : tt.min) ?? 1, h = ((et = (Y = this.imageConfig.sizing) == null ? void 0 : Y.variance) == null ? void 0 : et.max) ?? 1, g = d !== 1 || h !== 1, p = s - 2 * c, b = r - 2 * c, { columns: f, rows: m } = this.calculateGridDimensions(
       t,
       p,
       b,
       u,
       a
-    ), y = a.stagger === "row", v = a.stagger === "column", E = y ? f + 0.5 : f, A = v ? m + 0.5 : m, S = (p - a.gap * (f - 1)) / E, L = (b - a.gap * (m - 1)) / A, _ = y ? S / 2 : 0, H = v ? L / 2 : 0, $ = 1 + a.overlap, D = Math.min(S, L) * $, G = i.fixedHeight ? Math.min(i.fixedHeight, D) : D, M = f * S + (f - 1) * a.gap + _, w = m * L + (m - 1) * a.gap + H, T = c + (p - M) / 2, z = c + (b - w) / 2, C = f * m, R = a.columns !== "auto" && a.rows !== "auto", F = R && t > C;
+    ), y = a.stagger === "row", v = a.stagger === "column", E = y ? f + 0.5 : f, A = v ? m + 0.5 : m, S = (p - a.gap * (f - 1)) / E, F = (b - a.gap * (m - 1)) / A, _ = y ? S / 2 : 0, H = v ? F / 2 : 0, $ = 1 + a.overlap, D = Math.min(S, F) * $, W = i.fixedHeight ? Math.min(i.fixedHeight, D) : D, L = f * S + (f - 1) * a.gap + _, w = m * F + (m - 1) * a.gap + H, T = c + (p - L) / 2, M = c + (b - w) / 2, C = f * m, R = a.columns !== "auto" && a.rows !== "auto", z = R && t > C;
     typeof window < "u" && (window.__gridOverflowDebug = {
       gridConfigColumns: a.columns,
       gridConfigRows: a.rows,
@@ -1226,35 +1226,35 @@ class pe {
       cellCount: C,
       hasFixedGrid: R,
       imageCount: t,
-      isOverflowMode: F
+      isOverflowMode: z
     });
-    const U = F ? new Array(C).fill(0) : [], Z = Math.min(S, L) * a.overflowOffset;
+    const U = z ? new Array(C).fill(0) : [], Z = Math.min(S, F) * a.overflowOffset;
     for (let P = 0; P < t; P++) {
       let j, O, J = 0;
-      if (F && P >= C) {
+      if (z && P >= C) {
         const K = P - C, q = K % C;
         J = Math.floor(K / C) + 1, U[q]++, a.fillDirection === "row" ? (j = q % f, O = Math.floor(q / f)) : (O = q % m, j = Math.floor(q / m));
       } else
         a.fillDirection === "row" ? (j = P % f, O = Math.floor(P / f)) : (O = P % m, j = Math.floor(P / m));
-      let V = T + j * (S + a.gap) + S / 2, it = z + O * (L + a.gap) + L / 2;
-      if (a.stagger === "row" && O % 2 === 1 ? V += S / 2 : a.stagger === "column" && j % 2 === 1 && (it += L / 2), J > 0) {
-        const K = (J - 1) % Lt.length, q = Lt[K];
+      let V = T + j * (S + a.gap) + S / 2, it = M + O * (F + a.gap) + F / 2;
+      if (a.stagger === "row" && O % 2 === 1 ? V += S / 2 : a.stagger === "column" && j % 2 === 1 && (it += F / 2), J > 0) {
+        const K = (J - 1) % Ft.length, q = Ft[K];
         V += q.x * Z, it += q.y * Z;
       }
       if (a.jitter > 0) {
-        const K = S / 2 * a.jitter, q = L / 2 * a.jitter;
+        const K = S / 2 * a.jitter, q = F / 2 * a.jitter;
         V += this.random(-K, K), it += this.random(-q, q);
       }
       let nt = V, ot = it;
-      if (!F && a.fillDirection === "row") {
+      if (!z && a.fillDirection === "row") {
         const K = t % f || f;
         if (O === Math.floor((t - 1) / f) && K < f) {
           const Rt = K * S + (K - 1) * a.gap;
           let Et = 0;
-          a.alignment === "center" ? Et = (M - Rt) / 2 : a.alignment === "end" && (Et = M - Rt), nt += Et;
+          a.alignment === "center" ? Et = (L - Rt) / 2 : a.alignment === "end" && (Et = L - Rt), nt += Et;
         }
       }
-      const pt = g ? this.random(d, h) : 1, at = G * pt, dt = at * 1.5 / 2, ut = at / 2, yt = c + dt, vt = s - c - dt, Nt = c + ut, kt = r - c - ut;
+      const pt = g ? this.random(d, h) : 1, at = W * pt, dt = at * 1.5 / 2, ut = at / 2, yt = c + dt, vt = s - c - dt, Nt = c + ut, kt = r - c - ut;
       nt = Math.max(yt, Math.min(nt, vt)), ot = Math.max(Nt, Math.min(ot, kt));
       let wt = 0;
       if (l === "random") {
@@ -1262,7 +1262,7 @@ class pe {
         a.jitter > 0 ? wt = this.random(K * a.jitter, q * a.jitter) : wt = this.random(K, q);
       }
       let xt;
-      F && J > 0 ? xt = 50 - J : xt = F ? 100 + P : P + 1, n.push({
+      z && J > 0 ? xt = 50 - J : xt = z ? 100 + P : P + 1, n.push({
         id: P,
         x: nt,
         y: ot,
@@ -1318,28 +1318,28 @@ class ve {
    * @returns Array of layout objects with position, rotation, scale
    */
   generate(t, e, i = {}) {
-    var A, S, L, _, H, $, D, G, M;
-    const n = [], { width: s, height: r } = e, a = { ...ye, ...this.config.spiral }, c = this.config.spacing.padding, u = i.fixedHeight ?? 200, l = ((A = this.imageConfig.rotation) == null ? void 0 : A.mode) ?? "none", d = ((L = (S = this.imageConfig.rotation) == null ? void 0 : S.range) == null ? void 0 : L.min) ?? -15, h = ((H = (_ = this.imageConfig.rotation) == null ? void 0 : _.range) == null ? void 0 : H.max) ?? 15, g = ((D = ($ = this.imageConfig.sizing) == null ? void 0 : $.variance) == null ? void 0 : D.min) ?? 1, p = ((M = (G = this.imageConfig.sizing) == null ? void 0 : G.variance) == null ? void 0 : M.max) ?? 1, b = g !== 1 || p !== 1, f = this.config.scaleDecay ?? a.scaleDecay, m = s / 2, y = r / 2, v = Math.min(
+    var A, S, F, _, H, $, D, W, L;
+    const n = [], { width: s, height: r } = e, a = { ...ye, ...this.config.spiral }, c = this.config.spacing.padding, u = i.fixedHeight ?? 200, l = ((A = this.imageConfig.rotation) == null ? void 0 : A.mode) ?? "none", d = ((F = (S = this.imageConfig.rotation) == null ? void 0 : S.range) == null ? void 0 : F.min) ?? -15, h = ((H = (_ = this.imageConfig.rotation) == null ? void 0 : _.range) == null ? void 0 : H.max) ?? 15, g = ((D = ($ = this.imageConfig.sizing) == null ? void 0 : $.variance) == null ? void 0 : D.min) ?? 1, p = ((L = (W = this.imageConfig.sizing) == null ? void 0 : W.variance) == null ? void 0 : L.max) ?? 1, b = g !== 1 || p !== 1, f = this.config.scaleDecay ?? a.scaleDecay, m = s / 2, y = r / 2, v = Math.min(
       m - c - u / 2,
       y - c - u / 2
     ), E = a.direction === "clockwise" ? -1 : 1;
     for (let w = 0; w < t; w++) {
-      let T, z;
+      let T, M;
       if (a.spiralType === "golden")
-        T = w * be * E + a.startAngle, z = this.calculateGoldenRadius(w, t, v, a.tightness);
+        T = w * be * E + a.startAngle, M = this.calculateGoldenRadius(w, t, v, a.tightness);
       else if (a.spiralType === "archimedean") {
         const V = w * 0.5 * a.tightness;
-        T = V * E + a.startAngle, z = this.calculateArchimedeanRadius(V, t, v, a.tightness);
+        T = V * E + a.startAngle, M = this.calculateArchimedeanRadius(V, t, v, a.tightness);
       } else {
         const V = w * 0.3 * a.tightness;
-        T = V * E + a.startAngle, z = this.calculateLogarithmicRadius(V, t, v, a.tightness);
+        T = V * E + a.startAngle, M = this.calculateLogarithmicRadius(V, t, v, a.tightness);
       }
-      const C = m + Math.cos(T) * z, R = y + Math.sin(T) * z, F = z / v, U = f > 0 ? 1 - F * f * 0.5 : 1, Z = b ? this.random(g, p) : 1, Q = U * Z, W = u * Q, Y = W * 1.5 / 2, et = W / 2, X = c + Y, N = s - c - Y, B = c + et, k = r - c - et, P = Math.max(X, Math.min(C, N)), j = Math.max(B, Math.min(R, k));
+      const C = m + Math.cos(T) * M, R = y + Math.sin(T) * M, z = M / v, U = f > 0 ? 1 - z * f * 0.5 : 1, Z = b ? this.random(g, p) : 1, Q = U * Z, G = u * Q, Y = G * 1.5 / 2, et = G / 2, X = c + Y, N = s - c - Y, B = c + et, k = r - c - et, P = Math.max(X, Math.min(C, N)), j = Math.max(B, Math.min(R, k));
       let O = 0;
       if (l === "random") {
         const V = T * 180 / Math.PI % 360, it = this.random(d, h);
         O = a.spiralType === "golden" ? it : V * 0.1 + it * 0.9;
-      } else l === "tangent" && (O = this.calculateSpiralTangent(T, z, a));
+      } else l === "tangent" && (O = this.calculateSpiralTangent(T, M, a));
       const J = t - w;
       n.push({
         id: w,
@@ -1347,7 +1347,7 @@ class ve {
         y: j,
         rotation: O,
         scale: Q,
-        baseSize: W,
+        baseSize: G,
         zIndex: J
       });
     }
@@ -1421,8 +1421,8 @@ class xe {
    * @returns Array of layout objects with position, rotation, scale
    */
   generate(t, e, i = {}) {
-    var E, A, S, L, _, H, $, D, G;
-    const n = [], { width: s, height: r } = e, a = { ...we, ...this.config.cluster }, c = this.config.spacing.padding, u = i.fixedHeight ?? 200, l = ((E = this.imageConfig.rotation) == null ? void 0 : E.mode) ?? "none", d = ((S = (A = this.imageConfig.rotation) == null ? void 0 : A.range) == null ? void 0 : S.min) ?? -15, h = ((_ = (L = this.imageConfig.rotation) == null ? void 0 : L.range) == null ? void 0 : _.max) ?? 15, g = (($ = (H = this.imageConfig.sizing) == null ? void 0 : H.variance) == null ? void 0 : $.min) ?? 1, p = ((G = (D = this.imageConfig.sizing) == null ? void 0 : D.variance) == null ? void 0 : G.max) ?? 1, b = g !== 1 || p !== 1, f = this.calculateClusterCount(
+    var E, A, S, F, _, H, $, D, W;
+    const n = [], { width: s, height: r } = e, a = { ...we, ...this.config.cluster }, c = this.config.spacing.padding, u = i.fixedHeight ?? 200, l = ((E = this.imageConfig.rotation) == null ? void 0 : E.mode) ?? "none", d = ((S = (A = this.imageConfig.rotation) == null ? void 0 : A.range) == null ? void 0 : S.min) ?? -15, h = ((_ = (F = this.imageConfig.rotation) == null ? void 0 : F.range) == null ? void 0 : _.max) ?? 15, g = (($ = (H = this.imageConfig.sizing) == null ? void 0 : H.variance) == null ? void 0 : $.min) ?? 1, p = ((W = (D = this.imageConfig.sizing) == null ? void 0 : D.variance) == null ? void 0 : W.max) ?? 1, b = g !== 1 || p !== 1, f = this.calculateClusterCount(
       t,
       a.clusterCount,
       s,
@@ -1435,12 +1435,12 @@ class xe {
       c,
       a
     ), y = new Array(f).fill(0);
-    for (let M = 0; M < t; M++)
-      y[M % f]++;
+    for (let L = 0; L < t; L++)
+      y[L % f]++;
     let v = 0;
-    for (let M = 0; M < f; M++) {
-      const w = m[M], T = y[M];
-      for (let z = 0; z < T; z++) {
+    for (let L = 0; L < f; L++) {
+      const w = m[L], T = y[L];
+      for (let M = 0; M < T; M++) {
         let C, R;
         if (a.distribution === "gaussian")
           C = this.gaussianRandom() * w.spread, R = this.gaussianRandom() * w.spread;
@@ -1448,11 +1448,11 @@ class xe {
           const O = this.random(0, Math.PI * 2), J = this.random(0, w.spread);
           C = Math.cos(O) * J, R = Math.sin(O) * J;
         }
-        const F = 1 + a.overlap * 0.5, U = 1 + a.overlap * 0.3;
-        C /= F, R /= F;
-        const Z = b ? this.random(g, p) : 1, Q = U * Z, W = u * Q;
+        const z = 1 + a.overlap * 0.5, U = 1 + a.overlap * 0.3;
+        C /= z, R /= z;
+        const Z = b ? this.random(g, p) : 1, Q = U * Z, G = u * Q;
         let tt = w.x + C, Y = w.y + R;
-        const X = W * 1.5 / 2, N = W / 2;
+        const X = G * 1.5 / 2, N = G / 2;
         tt = Math.max(c + X, Math.min(tt, s - c - X)), Y = Math.max(c + N, Math.min(Y, r - c - N));
         const B = l === "random" ? this.random(d, h) : 0, P = Math.sqrt(C * C + R * R) / w.spread, j = Math.round((1 - P) * 50) + 1;
         n.push({
@@ -1461,7 +1461,7 @@ class xe {
           y: Y,
           rotation: B,
           scale: Q,
-          baseSize: W,
+          baseSize: G,
           zIndex: j
         }), v++;
       }
@@ -1540,18 +1540,18 @@ class Ee {
    * @returns Array of layout objects with position, rotation, scale
    */
   generate(t, e, i = {}) {
-    var F, U, Z, Q, W, tt, Y, et, X;
-    const n = [], { width: s, height: r } = e, a = i.fixedHeight ?? 200, c = this.config.spacing.padding ?? 50, u = ((F = this.imageConfig.rotation) == null ? void 0 : F.mode) ?? "none", l = ((Z = (U = this.imageConfig.rotation) == null ? void 0 : U.range) == null ? void 0 : Z.min) ?? -15, d = ((W = (Q = this.imageConfig.rotation) == null ? void 0 : Q.range) == null ? void 0 : W.max) ?? 15, h = ((Y = (tt = this.imageConfig.sizing) == null ? void 0 : tt.variance) == null ? void 0 : Y.min) ?? 1, g = ((X = (et = this.imageConfig.sizing) == null ? void 0 : et.variance) == null ? void 0 : X.max) ?? 1, p = h !== 1 || g !== 1, b = i.fixedHeight ?? a, f = {
-      ...Gt,
+    var z, U, Z, Q, G, tt, Y, et, X;
+    const n = [], { width: s, height: r } = e, a = i.fixedHeight ?? 200, c = this.config.spacing.padding ?? 50, u = ((z = this.imageConfig.rotation) == null ? void 0 : z.mode) ?? "none", l = ((Z = (U = this.imageConfig.rotation) == null ? void 0 : U.range) == null ? void 0 : Z.min) ?? -15, d = ((G = (Q = this.imageConfig.rotation) == null ? void 0 : Q.range) == null ? void 0 : G.max) ?? 15, h = ((Y = (tt = this.imageConfig.sizing) == null ? void 0 : tt.variance) == null ? void 0 : Y.min) ?? 1, g = ((X = (et = this.imageConfig.sizing) == null ? void 0 : et.variance) == null ? void 0 : X.max) ?? 1, p = h !== 1 || g !== 1, b = i.fixedHeight ?? a, f = {
+      ...Wt,
       ...this.config.wave
-    }, { rows: m, amplitude: y, frequency: v, phaseShift: E, synchronization: A } = f, S = Math.ceil(t / m), H = b * 1.5 / 2, $ = c + H, D = s - c - H, G = D - $, M = S > 1 ? G / (S - 1) : 0, w = c + y + b / 2, T = r - c - y - b / 2, z = T - w, C = m > 1 ? z / (m - 1) : 0;
+    }, { rows: m, amplitude: y, frequency: v, phaseShift: E, synchronization: A } = f, S = Math.ceil(t / m), H = b * 1.5 / 2, $ = c + H, D = s - c - H, W = D - $, L = S > 1 ? W / (S - 1) : 0, w = c + y + b / 2, T = r - c - y - b / 2, M = T - w, C = m > 1 ? M / (m - 1) : 0;
     let R = 0;
     for (let N = 0; N < m && R < t; N++) {
       const B = m === 1 ? (w + T) / 2 : w + N * C;
       let k = 0;
       A === "offset" ? k = N * E : A === "alternating" && (k = N * Math.PI);
       for (let P = 0; P < S && R < t; P++) {
-        const j = S === 1 ? ($ + D) / 2 : $ + P * M, O = this.calculateWaveY(j, s, y, v, k), J = j, V = B + O, it = p ? this.random(h, g) : 1, nt = b * it;
+        const j = S === 1 ? ($ + D) / 2 : $ + P * L, O = this.calculateWaveY(j, s, y, v, k), J = j, V = B + O, it = p ? this.random(h, g) : 1, nt = b * it;
         let ot = 0;
         u === "tangent" ? ot = this.calculateRotation(j, s, y, v, k) : u === "random" && (ot = this.random(l, d));
         const at = nt * 1.5 / 2, bt = nt / 2, dt = c + at, ut = s - c - at, yt = c + bt, vt = r - c - bt;
@@ -1608,13 +1608,13 @@ class Ee {
 }
 class Se {
   constructor(t) {
-    this.config = t.layout, this.imageConfig = t.image, this.layouts = /* @__PURE__ */ new Map(), this.generator = this.initGenerator();
+    this.config = t.layout, this.imageConfig = t.image, this.layouts = /* @__PURE__ */ new Map(), this.placementLayout = this.initLayout();
   }
   /**
-   * 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
    */
-  initGenerator() {
+  initLayout() {
     switch (this.config.algorithm) {
       case "radial":
         return new fe(this.config, this.imageConfig);
@@ -1639,7 +1639,7 @@ class Se {
    * @returns Array of layout objects with position, rotation, scale
    */
   generateLayout(t, e, i = {}) {
-    const n = this.generator.generate(t, e, i);
+    const n = this.placementLayout.generate(t, e, i);
     return n.forEach((s) => {
       this.layouts.set(s.id, s);
     }), n;
@@ -1663,7 +1663,7 @@ class Se {
    * @param newConfig - Updated configuration
    */
   updateConfig(t) {
-    t.layout && (Object.assign(this.config, t.layout), t.layout.algorithm && t.layout.algorithm !== this.config.algorithm && (this.generator = this.initGenerator())), t.image && Object.assign(this.imageConfig, t.image);
+    t.layout && (Object.assign(this.config, t.layout), t.layout.algorithm && t.layout.algorithm !== this.config.algorithm && (this.placementLayout = this.initLayout())), t.image && Object.assign(this.imageConfig, t.image);
   }
   /**
    * Get responsive breakpoints from layout config
@@ -2270,7 +2270,7 @@ class Ce {
     ), this.state = I.IDLE, this.currentFocus = null, this.focusData = null, this.outgoing = null, this.incoming = null;
   }
 }
-const Re = 50, Me = 0.5, ze = 20, Fe = 0.3, Le = 150, Oe = 30, mt = class mt {
+const Re = 50, Le = 0.5, Me = 20, ze = 0.3, Fe = 150, Oe = 30, mt = class mt {
   constructor(t, e) {
     this.enabled = !1, this.touchState = null, this.recentTouchTimestamp = 0, this.container = t, this.callbacks = e, this.boundTouchStart = this.handleTouchStart.bind(this), this.boundTouchMove = this.handleTouchMove.bind(this), this.boundTouchEnd = this.handleTouchEnd.bind(this), this.boundTouchCancel = this.handleTouchCancel.bind(this);
   }
@@ -2322,7 +2322,7 @@ const Re = 50, Me = 0.5, ze = 20, Fe = 0.3, Le = 150, Oe = 30, mt = class mt {
     }
     if (this.touchState.isHorizontalSwipe !== !1 && this.touchState.isHorizontalSwipe === !0) {
       t.preventDefault(), this.touchState.isDragging = !0, this.touchState.currentX = e.clientX;
-      const s = i * Fe;
+      const s = i * ze;
       this.callbacks.onDragOffset(s);
     }
   }
@@ -2331,7 +2331,7 @@ const Re = 50, Me = 0.5, ze = 20, Fe = 0.3, Le = 150, Oe = 30, mt = class mt {
     this.recentTouchTimestamp = Date.now();
     const e = this.touchState.currentX - this.touchState.startX, i = performance.now() - this.touchState.startTime, n = Math.abs(e) / i, s = Math.abs(e);
     let r = !1;
-    this.touchState.isHorizontalSwipe === !0 && this.touchState.isDragging && (s >= Re || n >= Me && s >= ze) && (r = !0, e < 0 ? this.callbacks.onNext() : this.callbacks.onPrev()), this.touchState.isDragging && this.callbacks.onDragEnd(r), this.touchState = null;
+    this.touchState.isHorizontalSwipe === !0 && this.touchState.isDragging && (s >= Re || n >= Le && s >= Me) && (r = !0, e < 0 ? this.callbacks.onNext() : this.callbacks.onPrev()), this.touchState.isDragging && this.callbacks.onDragEnd(r), this.touchState = null;
   }
   handleTouchCancel(t) {
     var e;
@@ -2969,7 +2969,7 @@ class Ne {
         onPrev: () => this.navigateToPreviousImage(),
         onDragOffset: (t) => this.zoomEngine.setDragOffset(t),
         onDragEnd: (t) => {
-          t ? this.zoomEngine.clearDragOffset(!1) : this.zoomEngine.clearDragOffset(!0, Le);
+          t ? this.zoomEngine.clearDragOffset(!1) : this.zoomEngine.clearDragOffset(!0, Fe);
         }
       }), this.setupUI(), this.setupEventListeners(), this.logDebug("ImageCloud initialized"), await this.loadImages();
     } catch (t) {