@frybynite/image-cloud 0.9.6 → 0.10.1

package/dist/web-component.d.ts

@@ -883,6 +883,8 @@ declare class ImageCloud {
 export { ImageCloud }
 export { ImageCloud as ImageGallery }
 
+export declare function imageCloud(options: ImageCloudOptions): Promise<ImageCloud>;
+
 export declare interface ImageCloudConfig {
     loaders: LoaderEntry[];
     config: ConfigSection;

package/dist/web-component.js

@@ -3292,7 +3292,7 @@ class ei {
   createLoader() {
     const t = this.fullConfig.loaders, i = this.fullConfig.config.loaders ?? {};
     if (!t || t.length === 0)
-      throw new Error("No loaders configured. Provide `images`, `loaders`, or both.");
+      throw new Error("No loaders configured. Provide `images`, `loaders`, or both.\n  Example: imageCloud({ container: 'id', images: ['https://...'] })");
     const e = t.map((n) => this.createLoaderFromEntry(n, i));
     return e.length === 1 ? e[0] : new Ke({
       loaders: e,
@@ -3331,7 +3331,7 @@ class ei {
       if (ti(), this.containerRef)
         this.containerEl = this.containerRef;
       else if (this.containerEl = document.getElementById(this.containerId), !this.containerEl)
-        throw new Error(`Container #${this.containerId} not found`);
+        throw new Error(`Container "#${this.containerId}" not found. Ensure an element with id="${this.containerId}" exists in the DOM before calling imageCloud().`);
       this.containerEl.classList.add("fbn-ic-gallery"), this.containerEl.setAttribute("tabindex", "0"), this.fullConfig.interaction.navigation?.swipe !== !1 && (this.swipeEngine = new bt(this.containerEl, {
         onNext: () => this.navigateToNextImage(),
         onPrev: () => this.navigateToPreviousImage(),
@@ -3341,7 +3341,7 @@ class ei {
         }
       })), this.setupUI(), this.setupEventListeners(), this.logDebug("ImageCloud initialized"), await this.loadImages();
     } catch (t) {
-      console.error("Gallery initialization failed:", t), this.errorEl && t instanceof Error && this.showError("Gallery failed to initialize: " + t.message);
+      console.error(`ImageCloud initialization failed (container: "${this.containerId ?? "element"}"):`, t), this.errorEl && t instanceof Error && this.showError("Gallery failed to initialize: " + t.message);
     }
   }
   setupUI() {