@frybynite/image-cloud 0.5.0 → 0.6.0

package/dist/static-ejylHtQ4.js

@@ -0,0 +1,219 @@
+const n = class a {
+  /**
+   * Register a loader implementation with the registry
+   * @param name - Loader identifier (e.g., 'static', 'google-drive', 'composite')
+   * @param Loader - Loader class constructor to register
+   */
+  static registerLoader(r, t) {
+    a.registry.set(r, t);
+  }
+  /**
+   * Get a registered loader implementation
+   * @param name - Loader identifier
+   * @returns Loader class constructor
+   * @throws Error if loader is not registered
+   */
+  static getLoader(r) {
+    const t = a.registry.get(r);
+    if (!t)
+      throw new Error(
+        `Loader "${r}" is not registered. Import "@frybynite/image-cloud/loaders/${r}" or "@frybynite/image-cloud/loaders/all".`
+      );
+    return t;
+  }
+  /**
+   * Check if a loader is registered
+   * @param name - Loader identifier
+   * @returns True if the loader is registered, false otherwise
+   */
+  static isRegistered(r) {
+    return a.registry.has(r);
+  }
+};
+n.registry = /* @__PURE__ */ new Map();
+let l = n;
+class c {
+  constructor(r) {
+    if (this._prepared = !1, this._discoveredUrls = [], this.validateUrls = r.validateUrls !== !1, this.validationTimeout = r.validationTimeout ?? 5e3, this.validationMethod = r.validationMethod ?? "head", this.debugLogging = r.debugLogging ?? !1, this.sources = r.sources ?? [], !this.sources || this.sources.length === 0)
+      throw new Error("StaticImageLoader requires at least one source to be configured");
+    this.log("StaticImageLoader initialized with config:", r);
+  }
+  /**
+   * Prepare the loader by discovering all images from configured sources
+   * @param filter - Filter to apply to discovered images
+   */
+  async prepare(r) {
+    this._discoveredUrls = [], this.log(`Processing ${this.sources.length} source(s)`);
+    for (const t of this.sources)
+      try {
+        const i = await this.processSource(t, r);
+        this._discoveredUrls.push(...i);
+      } catch (i) {
+        console.warn("Failed to process source:", t, i);
+      }
+    this._prepared = !0, this.log(`Successfully loaded ${this._discoveredUrls.length} image(s)`);
+  }
+  /**
+   * Get the number of discovered images
+   * @throws Error if called before prepare()
+   */
+  imagesLength() {
+    if (!this._prepared)
+      throw new Error("StaticImageLoader.imagesLength() called before prepare()");
+    return this._discoveredUrls.length;
+  }
+  /**
+   * Get the ordered list of image URLs
+   * @throws Error if called before prepare()
+   */
+  imageURLs() {
+    if (!this._prepared)
+      throw new Error("StaticImageLoader.imageURLs() called before prepare()");
+    return [...this._discoveredUrls];
+  }
+  /**
+   * Check if the loader has been prepared
+   */
+  isPrepared() {
+    return this._prepared;
+  }
+  /**
+   * Process a single source object using shape-based detection
+   * @param source - Source configuration detected by key presence
+   * @param filter - Filter to apply to discovered images
+   * @returns Promise resolving to array of valid URLs from this source
+   */
+  async processSource(r, t) {
+    return r ? "urls" in r ? await this.processUrls(r.urls, t) : "path" in r ? await this.processPath(r.path, r.files, t) : "json" in r ? await this.processJson(r.json, t) : (console.warn("Unknown source shape:", r), []) : (console.warn("Invalid source object:", r), []);
+  }
+  /**
+   * Process a list of direct URLs
+   * @param urls - Array of image URLs
+   * @param filter - Filter to apply to discovered images
+   * @returns Promise resolving to array of validated URLs
+   */
+  async processUrls(r, t) {
+    if (!Array.isArray(r))
+      return console.warn("URLs must be an array:", r), [];
+    const i = [];
+    for (const s of r) {
+      const e = s.split("/").pop() || s;
+      if (!t.isAllowed(e)) {
+        this.log(`Skipping filtered URL: ${s}`);
+        continue;
+      }
+      this.validateUrls ? await this.validateUrl(s) ? i.push(s) : console.warn(`Skipping invalid/missing URL: ${s}`) : i.push(s);
+    }
+    return i;
+  }
+  /**
+   * Process a path-based source
+   * @param basePath - Base path (relative or absolute)
+   * @param files - Array of filenames
+   * @param filter - Filter to apply to discovered images
+   * @returns Promise resolving to array of validated URLs
+   */
+  async processPath(r, t, i) {
+    if (!Array.isArray(t))
+      return console.warn("files must be an array:", t), [];
+    const s = [];
+    for (const e of t) {
+      if (!i.isAllowed(e)) {
+        this.log(`Skipping filtered file: ${e}`);
+        continue;
+      }
+      const o = this.constructUrl(r, e);
+      this.validateUrls ? await this.validateUrl(o) ? s.push(o) : console.warn(`Skipping invalid/missing file: ${o}`) : s.push(o);
+    }
+    return s;
+  }
+  /**
+   * Process a JSON endpoint source
+   * Fetches a JSON endpoint that returns { images: string[] }
+   * @param url - JSON endpoint URL
+   * @param filter - Filter to apply to discovered images
+   * @returns Promise resolving to array of validated URLs
+   */
+  async processJson(r, t) {
+    this.log(`Fetching JSON endpoint: ${r}`);
+    const i = new AbortController(), s = setTimeout(() => i.abort(), 1e4);
+    try {
+      const e = await fetch(r, { signal: i.signal });
+      if (clearTimeout(s), !e.ok)
+        throw new Error(`HTTP ${e.status} fetching ${r}`);
+      const o = await e.json();
+      if (!o || !Array.isArray(o.images))
+        throw new Error('JSON source must return JSON with shape { "images": ["url1", "url2", ...] }');
+      return this.log(`JSON endpoint returned ${o.images.length} image(s)`), await this.processUrls(o.images, t);
+    } catch (e) {
+      throw clearTimeout(s), e instanceof Error && e.name === "AbortError" ? new Error(`Timeout fetching JSON endpoint: ${r}`) : e;
+    }
+  }
+  /**
+   * Validate a single URL using HEAD request
+   * @param url - URL to validate
+   * @returns Promise resolving to true if valid and accessible
+   */
+  async validateUrl(r) {
+    if (this.validationMethod === "none")
+      return !0;
+    if (this.validationMethod === "simple")
+      try {
+        return typeof window < "u" ? new URL(r, window.location.origin) : new URL(r), !0;
+      } catch {
+        return !1;
+      }
+    if (typeof window > "u")
+      return !0;
+    if (!(r.startsWith(window.location.origin) || r.startsWith("/")))
+      return this.log(`Skipping validation for cross-origin URL: ${r}`), !0;
+    try {
+      const t = new AbortController(), i = setTimeout(() => t.abort(), this.validationTimeout), s = await fetch(r, {
+        method: "HEAD",
+        signal: t.signal
+      });
+      return clearTimeout(i), s.ok ? !0 : (this.log(`Validation failed for ${r}: HTTP ${s.status}`), !1);
+    } catch (t) {
+      return t instanceof Error && (t.name === "AbortError" ? this.log(`Validation timeout for ${r}`) : this.log(`Validation failed for ${r}:`, t.message)), !1;
+    }
+  }
+  /**
+   * Construct full URL from basePath and filename
+   * @param basePath - Base path (relative or absolute)
+   * @param filename - Filename to append
+   * @returns Complete URL
+   */
+  constructUrl(r, t) {
+    const i = r.replace(/\/$/, "");
+    if (this.isAbsoluteUrl(r))
+      return `${i}/${t}`;
+    if (typeof window > "u")
+      return `${i}/${t}`;
+    const s = window.location.origin, e = (r.startsWith("/") ? r : "/" + r).replace(/\/$/, "");
+    return `${s}${e}/${t}`;
+  }
+  /**
+   * Check if URL is absolute (contains protocol)
+   * @param url - URL to check
+   * @returns True if absolute URL
+   */
+  isAbsoluteUrl(r) {
+    try {
+      return new URL(r), !0;
+    } catch {
+      return !1;
+    }
+  }
+  /**
+   * Debug logging helper
+   * @param args - Arguments to log
+   */
+  log(...r) {
+    this.debugLogging && typeof console < "u" && console.log(...r);
+  }
+}
+l.registerLoader("static", c);
+export {
+  c as StaticImageLoader
+};
+//# sourceMappingURL=static-ejylHtQ4.js.map

package/dist/static-ejylHtQ4.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-ejylHtQ4.js","sources":["loaders/static.js"],"sourcesContent":["const a = class a {\n  /**\n   * Register a loader implementation with the registry\n   * @param name - Loader identifier (e.g., 'static', 'google-drive', 'composite')\n   * @param Loader - Loader class constructor to register\n   */\n  static registerLoader(e, t) {\n    a.registry.set(e, t);\n  }\n  /**\n   * Get a registered loader implementation\n   * @param name - Loader identifier\n   * @returns Loader class constructor\n   * @throws Error if loader is not registered\n   */\n  static getLoader(e) {\n    const t = a.registry.get(e);\n    if (!t)\n      throw new Error(\n        `Loader \"${e}\" is not registered. Import \"@frybynite/image-cloud/loaders/${e}\" or \"@frybynite/image-cloud/loaders/all\".`\n      );\n    return t;\n  }\n  /**\n   * Check if a loader is registered\n   * @param name - Loader identifier\n   * @returns True if the loader is registered, false otherwise\n   */\n  static isRegistered(e) {\n    return a.registry.has(e);\n  }\n};\na.registry = /* @__PURE__ */ new Map();\nlet n = a;\nclass l {\n  constructor(e) {\n    if (this._prepared = !1, this._discoveredUrls = [], this.validateUrls = e.validateUrls !== !1, this.validationTimeout = e.validationTimeout ?? 5e3, this.validationMethod = e.validationMethod ?? \"head\", this.debugLogging = e.debugLogging ?? !1, this.sources = e.sources ?? [], !this.sources || this.sources.length === 0)\n      throw new Error(\"StaticImageLoader requires at least one source to be configured\");\n    this.log(\"StaticImageLoader initialized with config:\", e);\n  }\n  /**\n   * Prepare the loader by discovering all images from configured sources\n   * @param filter - Filter to apply to discovered images\n   */\n  async prepare(e) {\n    this._discoveredUrls = [], this.log(`Processing ${this.sources.length} source(s)`);\n    for (const t of this.sources)\n      try {\n        const r = await this.processSource(t, e);\n        this._discoveredUrls.push(...r);\n      } catch (r) {\n        console.warn(\"Failed to process source:\", t, r);\n      }\n    this._prepared = !0, this.log(`Successfully loaded ${this._discoveredUrls.length} image(s)`);\n  }\n  /**\n   * Get the number of discovered images\n   * @throws Error if called before prepare()\n   */\n  imagesLength() {\n    if (!this._prepared)\n      throw new Error(\"StaticImageLoader.imagesLength() called before prepare()\");\n    return this._discoveredUrls.length;\n  }\n  /**\n   * Get the ordered list of image URLs\n   * @throws Error if called before prepare()\n   */\n  imageURLs() {\n    if (!this._prepared)\n      throw new Error(\"StaticImageLoader.imageURLs() called before prepare()\");\n    return [...this._discoveredUrls];\n  }\n  /**\n   * Check if the loader has been prepared\n   */\n  isPrepared() {\n    return this._prepared;\n  }\n  /**\n   * Process a single source object using shape-based detection\n   * @param source - Source configuration detected by key presence\n   * @param filter - Filter to apply to discovered images\n   * @returns Promise resolving to array of valid URLs from this source\n   */\n  async processSource(e, t) {\n    return e ? \"urls\" in e ? await this.processUrls(e.urls, t) : \"path\" in e ? await this.processPath(e.path, e.files, t) : \"json\" in e ? await this.processJson(e.json, t) : (console.warn(\"Unknown source shape:\", e), []) : (console.warn(\"Invalid source object:\", e), []);\n  }\n  /**\n   * Process a list of direct URLs\n   * @param urls - Array of image URLs\n   * @param filter - Filter to apply to discovered images\n   * @returns Promise resolving to array of validated URLs\n   */\n  async processUrls(e, t) {\n    if (!Array.isArray(e))\n      return console.warn(\"URLs must be an array:\", e), [];\n    const r = [];\n    for (const i of e) {\n      const s = i.split(\"/\").pop() || i;\n      if (!t.isAllowed(s)) {\n        this.log(`Skipping filtered URL: ${i}`);\n        continue;\n      }\n      this.validateUrls ? await this.validateUrl(i) ? r.push(i) : console.warn(`Skipping invalid/missing URL: ${i}`) : r.push(i);\n    }\n    return r;\n  }\n  /**\n   * Process a path-based source\n   * @param basePath - Base path (relative or absolute)\n   * @param files - Array of filenames\n   * @param filter - Filter to apply to discovered images\n   * @returns Promise resolving to array of validated URLs\n   */\n  async processPath(e, t, r) {\n    if (!Array.isArray(t))\n      return console.warn(\"files must be an array:\", t), [];\n    const i = [];\n    for (const s of t) {\n      if (!r.isAllowed(s)) {\n        this.log(`Skipping filtered file: ${s}`);\n        continue;\n      }\n      const o = this.constructUrl(e, s);\n      this.validateUrls ? await this.validateUrl(o) ? i.push(o) : console.warn(`Skipping invalid/missing file: ${o}`) : i.push(o);\n    }\n    return i;\n  }\n  /**\n   * Process a JSON endpoint source\n   * Fetches a JSON endpoint that returns { images: string[] }\n   * @param url - JSON endpoint URL\n   * @param filter - Filter to apply to discovered images\n   * @returns Promise resolving to array of validated URLs\n   */\n  async processJson(e, t) {\n    this.log(`Fetching JSON endpoint: ${e}`);\n    const r = new AbortController(), i = setTimeout(() => r.abort(), 1e4);\n    try {\n      const s = await fetch(e, { signal: r.signal });\n      if (clearTimeout(i), !s.ok)\n        throw new Error(`HTTP ${s.status} fetching ${e}`);\n      const o = await s.json();\n      if (!o || !Array.isArray(o.images))\n        throw new Error('JSON source must return JSON with shape { \"images\": [\"url1\", \"url2\", ...] }');\n      return this.log(`JSON endpoint returned ${o.images.length} image(s)`), await this.processUrls(o.images, t);\n    } catch (s) {\n      throw clearTimeout(i), s instanceof Error && s.name === \"AbortError\" ? new Error(`Timeout fetching JSON endpoint: ${e}`) : s;\n    }\n  }\n  /**\n   * Validate a single URL using HEAD request\n   * @param url - URL to validate\n   * @returns Promise resolving to true if valid and accessible\n   */\n  async validateUrl(e) {\n    if (this.validationMethod === \"none\")\n      return !0;\n    if (this.validationMethod === \"simple\")\n      try {\n        return typeof window < \"u\" ? new URL(e, window.location.origin) : new URL(e), !0;\n      } catch {\n        return !1;\n      }\n    if (typeof window > \"u\")\n      return !0;\n    if (!(e.startsWith(window.location.origin) || e.startsWith(\"/\")))\n      return this.log(`Skipping validation for cross-origin URL: ${e}`), !0;\n    try {\n      const r = new AbortController(), i = setTimeout(() => r.abort(), this.validationTimeout), s = await fetch(e, {\n        method: \"HEAD\",\n        signal: r.signal\n      });\n      return clearTimeout(i), s.ok ? !0 : (this.log(`Validation failed for ${e}: HTTP ${s.status}`), !1);\n    } catch (r) {\n      return r instanceof Error && (r.name === \"AbortError\" ? this.log(`Validation timeout for ${e}`) : this.log(`Validation failed for ${e}:`, r.message)), !1;\n    }\n  }\n  /**\n   * Construct full URL from basePath and filename\n   * @param basePath - Base path (relative or absolute)\n   * @param filename - Filename to append\n   * @returns Complete URL\n   */\n  constructUrl(e, t) {\n    const r = e.replace(/\\/$/, \"\");\n    if (this.isAbsoluteUrl(e))\n      return `${r}/${t}`;\n    if (typeof window > \"u\")\n      return `${r}/${t}`;\n    const i = window.location.origin, o = (e.startsWith(\"/\") ? e : \"/\" + e).replace(/\\/$/, \"\");\n    return `${i}${o}/${t}`;\n  }\n  /**\n   * Check if URL is absolute (contains protocol)\n   * @param url - URL to check\n   * @returns True if absolute URL\n   */\n  isAbsoluteUrl(e) {\n    try {\n      return new URL(e), !0;\n    } catch {\n      return !1;\n    }\n  }\n  /**\n   * Debug logging helper\n   * @param args - Arguments to log\n   */\n  log(...e) {\n    this.debugLogging && typeof console < \"u\" && console.log(...e);\n  }\n}\nn.registerLoader(\"static\", l);\nexport {\n  l as StaticImageLoader\n};\n//# sourceMappingURL=static.js.map\n"],"names":["a","e","n","l","r","i","s","o"],"mappings":"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"}

package/dist/vue.d.ts

@@ -757,10 +757,12 @@ declare class ImageCloud {
     /**
      * Create appropriate image loader based on config
      * Processes loaders array, merges shared config, wraps in CompositeLoader if needed
+     * Uses dynamic imports to trigger loader registration and enable tree-shaking
      */
     private createLoader;
     /**
      * Create a single loader from a LoaderEntry, merging shared config
+     * Uses dynamic imports to trigger loader registration and enable tree-shaking
      */
     private createLoaderFromEntry;
     /**
@@ -1567,6 +1569,21 @@ export declare class ZoomEngine {
      * @param fromDimensions - Optional starting dimensions (for mid-animation reversals)
      */
     private startUnfocusAnimation;
+    /**
+     * Capture the current visual state of an element mid-animation, BEFORE cancelling.
+     *
+     * The computed matrix.e/f include the -50%/-50% centering offset resolved to pixels.
+     * buildDimensionZoomTransform prepends its own translate(-50%,-50%), so passing raw
+     * matrix.e/f doubles the centering and produces the wrong starting position.
+     *
+     * This method extracts the PURE positional offset (pureX = matrix.e + 0.5*midWidth)
+     * and commits width/height/transform to inline styles before the animation is cancelled,
+     * preventing any visual snap.
+     *
+     * Must be called while the animation is still running (offsetWidth reflects animated size).
+     * Caller is responsible for calling animationEngine.cancelAllAnimations() afterwards.
+     */
+    private captureMidAnimationState;
     /**
      * Handle animation completion
      */