@frybynite/image-cloud 0.6.4 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. package/README.md +1 -28
  2. package/dist/image-cloud-auto-init.js +759 -345
  3. package/dist/image-cloud-auto-init.js.map +1 -1
  4. package/dist/image-cloud.js +1040 -1084
  5. package/dist/image-cloud.js.map +1 -1
  6. package/dist/image-cloud.umd.js +5 -5
  7. package/dist/image-cloud.umd.js.map +1 -1
  8. package/dist/index.d.ts +0 -2
  9. package/dist/react.d.ts +0 -2
  10. package/dist/react.js +848 -434
  11. package/dist/react.js.map +1 -1
  12. package/dist/vue.d.ts +0 -2
  13. package/dist/vue.js +856 -442
  14. package/dist/vue.js.map +1 -1
  15. package/dist/web-component.d.ts +0 -2
  16. package/dist/web-component.js +843 -429
  17. package/dist/web-component.js.map +1 -1
  18. package/package.json +14 -27
  19. package/dist/composite-CtUxtN2l.js +0 -96
  20. package/dist/composite-CtUxtN2l.js.map +0 -1
  21. package/dist/google-drive-CC-qFSV1.js +0 -260
  22. package/dist/google-drive-CC-qFSV1.js.map +0 -1
  23. package/dist/loaders/all.d.ts +0 -1654
  24. package/dist/loaders/all.js +0 -496
  25. package/dist/loaders/all.js.map +0 -1
  26. package/dist/loaders/composite.d.ts +0 -1654
  27. package/dist/loaders/composite.js +0 -96
  28. package/dist/loaders/composite.js.map +0 -1
  29. package/dist/loaders/google-drive.d.ts +0 -1654
  30. package/dist/loaders/google-drive.js +0 -260
  31. package/dist/loaders/google-drive.js.map +0 -1
  32. package/dist/loaders/static.d.ts +0 -1654
  33. package/dist/loaders/static.js +0 -219
  34. package/dist/loaders/static.js.map +0 -1
  35. package/dist/static-ejylHtQ4.js +0 -219
  36. package/dist/static-ejylHtQ4.js.map +0 -1
package/README.md CHANGED
@@ -35,9 +35,6 @@ No install needed — load directly from a CDN:
35
35
  https://cdn.jsdelivr.net/npm/@frybynite/image-cloud@latest/dist/image-cloud.js (Main - ESM)
36
36
  https://cdn.jsdelivr.net/npm/@frybynite/image-cloud@latest/dist/image-cloud.umd.js (Main - UMD)
37
37
  https://cdn.jsdelivr.net/npm/@frybynite/image-cloud@latest/dist/image-cloud-auto-init.js (Auto-init)
38
- https://cdn.jsdelivr.net/npm/@frybynite/image-cloud@latest/dist/loaders/static.js (Static loader)
39
- https://cdn.jsdelivr.net/npm/@frybynite/image-cloud@latest/dist/loaders/google-drive.js (Google Drive loader)
40
- https://cdn.jsdelivr.net/npm/@frybynite/image-cloud@latest/dist/loaders/all.js (All loaders)
41
38
  https://cdn.jsdelivr.net/npm/@frybynite/image-cloud@latest/dist/style.css
42
39
  ```
43
40
 
@@ -46,23 +43,17 @@ https://cdn.jsdelivr.net/npm/@frybynite/image-cloud@latest/dist/style.css
46
43
  https://unpkg.com/@frybynite/image-cloud@latest/dist/image-cloud.js (Main - ESM)
47
44
  https://unpkg.com/@frybynite/image-cloud@latest/dist/image-cloud.umd.js (Main - UMD)
48
45
  https://unpkg.com/@frybynite/image-cloud@latest/dist/image-cloud-auto-init.js (Auto-init)
49
- https://unpkg.com/@frybynite/image-cloud@latest/dist/loaders/static.js (Static loader)
50
- https://unpkg.com/@frybynite/image-cloud@latest/dist/loaders/google-drive.js (Google Drive loader)
51
- https://unpkg.com/@frybynite/image-cloud@latest/dist/loaders/all.js (All loaders)
52
46
  https://unpkg.com/@frybynite/image-cloud@latest/dist/style.css
53
47
  ```
54
48
 
55
49
  Replace `@latest` with a specific version (e.g., `@0.5.1`) to pin to that release.
56
50
 
57
- **Note:** Loaders are imported as separate bundles to reduce bundle size. Import only the loaders you need.
58
-
59
51
  ## Quick Start
60
52
 
61
53
  ### TypeScript/JavaScript (Programmatic API)
62
54
 
63
55
  ```typescript
64
56
  import { ImageCloud } from '@frybynite/image-cloud';
65
- import '@frybynite/image-cloud/loaders/static'; // Import loaders separately for optimal bundle size
66
57
  import '@frybynite/image-cloud/style.css';
67
58
 
68
59
  const cloud = new ImageCloud({
@@ -86,11 +77,6 @@ const cloud = new ImageCloud({
86
77
  await cloud.init();
87
78
  ```
88
79
 
89
- **Tip:** If you're using multiple loaders or want to include all of them, import the all-in-one bundle:
90
- ```typescript
91
- import '@frybynite/image-cloud/loaders/all'; // Includes static, google-drive, and composite loaders
92
- ```
93
-
94
80
  ### HTML (Auto-initialization)
95
81
 
96
82
  ```html
@@ -123,25 +109,12 @@ import '@frybynite/image-cloud/loaders/all'; // Includes static, google-drive,
123
109
 
124
110
  For detailed configuration, see the documentation in the `docs/` folder:
125
111
 
126
- 1. **[Loaders](docs/LOADERS.md)** — Configure image sources (static URLs, JSON endpoints, local paths, Google Drive folders). Loaders are imported as separate bundles to reduce bundle size.
112
+ 1. **[Loaders](docs/LOADERS.md)** — Configure image sources (static URLs, JSON endpoints, local paths, Google Drive folders)
127
113
  2. **[Layouts](docs/LAYOUTS.md)** — Choose and customize layout algorithms (radial, grid, spiral, cluster, random, wave)
128
114
  3. **[Image Sizing](docs/IMAGE_SIZING.md)** — Control base sizes, variance, and responsive/adaptive behavior
129
115
  4. **[Full Parameter Reference](docs/PARAMETERS.md)** — Complete configuration options for animation, interaction, styling, and more
130
116
  5. **[API Reference](docs/api/README.md)** — TypeScript API documentation for the ImageCloud class, types, loaders, and layouts
131
117
 
132
- ### Bundle Size Optimization
133
-
134
- Image Cloud uses a **loader registry pattern** to optimize bundle size:
135
- - The **main bundle** contains the core ImageCloud class (~30KB gzipped)
136
- - **Loader bundles** (static, google-drive, composite) are imported separately and auto-register when loaded
137
- - **Import only the loaders you need** to minimize bundle size
138
-
139
- Example: Using only the static loader
140
- ```typescript
141
- import { ImageCloud } from '@frybynite/image-cloud';
142
- import '@frybynite/image-cloud/loaders/static'; // ~2.3KB gzipped
143
- ```
144
-
145
118
  ### Using the Configurator
146
119
 
147
120
  The easiest way to create a custom configuration is with the interactive Configurator tool: