@frybynite/image-cloud 0.5.0 → 0.6.0

package/dist/loaders/static.js

@@ -0,0 +1,219 @@
+const a = 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(e, t) {
+    a.registry.set(e, t);
+  }
+  /**
+   * Get a registered loader implementation
+   * @param name - Loader identifier
+   * @returns Loader class constructor
+   * @throws Error if loader is not registered
+   */
+  static getLoader(e) {
+    const t = a.registry.get(e);
+    if (!t)
+      throw new Error(
+        `Loader "${e}" is not registered. Import "@frybynite/image-cloud/loaders/${e}" 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(e) {
+    return a.registry.has(e);
+  }
+};
+a.registry = /* @__PURE__ */ new Map();
+let n = a;
+class l {
+  constructor(e) {
+    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)
+      throw new Error("StaticImageLoader requires at least one source to be configured");
+    this.log("StaticImageLoader initialized with config:", e);
+  }
+  /**
+   * Prepare the loader by discovering all images from configured sources
+   * @param filter - Filter to apply to discovered images
+   */
+  async prepare(e) {
+    this._discoveredUrls = [], this.log(`Processing ${this.sources.length} source(s)`);
+    for (const t of this.sources)
+      try {
+        const r = await this.processSource(t, e);
+        this._discoveredUrls.push(...r);
+      } catch (r) {
+        console.warn("Failed to process source:", t, r);
+      }
+    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(e, t) {
+    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), []);
+  }
+  /**
+   * 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(e, t) {
+    if (!Array.isArray(e))
+      return console.warn("URLs must be an array:", e), [];
+    const r = [];
+    for (const i of e) {
+      const s = i.split("/").pop() || i;
+      if (!t.isAllowed(s)) {
+        this.log(`Skipping filtered URL: ${i}`);
+        continue;
+      }
+      this.validateUrls ? await this.validateUrl(i) ? r.push(i) : console.warn(`Skipping invalid/missing URL: ${i}`) : r.push(i);
+    }
+    return r;
+  }
+  /**
+   * 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(e, t, r) {
+    if (!Array.isArray(t))
+      return console.warn("files must be an array:", t), [];
+    const i = [];
+    for (const s of t) {
+      if (!r.isAllowed(s)) {
+        this.log(`Skipping filtered file: ${s}`);
+        continue;
+      }
+      const o = this.constructUrl(e, s);
+      this.validateUrls ? await this.validateUrl(o) ? i.push(o) : console.warn(`Skipping invalid/missing file: ${o}`) : i.push(o);
+    }
+    return i;
+  }
+  /**
+   * 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(e, t) {
+    this.log(`Fetching JSON endpoint: ${e}`);
+    const r = new AbortController(), i = setTimeout(() => r.abort(), 1e4);
+    try {
+      const s = await fetch(e, { signal: r.signal });
+      if (clearTimeout(i), !s.ok)
+        throw new Error(`HTTP ${s.status} fetching ${e}`);
+      const o = await s.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 (s) {
+      throw clearTimeout(i), s instanceof Error && s.name === "AbortError" ? new Error(`Timeout fetching JSON endpoint: ${e}`) : s;
+    }
+  }
+  /**
+   * Validate a single URL using HEAD request
+   * @param url - URL to validate
+   * @returns Promise resolving to true if valid and accessible
+   */
+  async validateUrl(e) {
+    if (this.validationMethod === "none")
+      return !0;
+    if (this.validationMethod === "simple")
+      try {
+        return typeof window < "u" ? new URL(e, window.location.origin) : new URL(e), !0;
+      } catch {
+        return !1;
+      }
+    if (typeof window > "u")
+      return !0;
+    if (!(e.startsWith(window.location.origin) || e.startsWith("/")))
+      return this.log(`Skipping validation for cross-origin URL: ${e}`), !0;
+    try {
+      const r = new AbortController(), i = setTimeout(() => r.abort(), this.validationTimeout), s = await fetch(e, {
+        method: "HEAD",
+        signal: r.signal
+      });
+      return clearTimeout(i), s.ok ? !0 : (this.log(`Validation failed for ${e}: HTTP ${s.status}`), !1);
+    } catch (r) {
+      return r instanceof Error && (r.name === "AbortError" ? this.log(`Validation timeout for ${e}`) : this.log(`Validation failed for ${e}:`, r.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(e, t) {
+    const r = e.replace(/\/$/, "");
+    if (this.isAbsoluteUrl(e))
+      return `${r}/${t}`;
+    if (typeof window > "u")
+      return `${r}/${t}`;
+    const i = window.location.origin, o = (e.startsWith("/") ? e : "/" + e).replace(/\/$/, "");
+    return `${i}${o}/${t}`;
+  }
+  /**
+   * Check if URL is absolute (contains protocol)
+   * @param url - URL to check
+   * @returns True if absolute URL
+   */
+  isAbsoluteUrl(e) {
+    try {
+      return new URL(e), !0;
+    } catch {
+      return !1;
+    }
+  }
+  /**
+   * Debug logging helper
+   * @param args - Arguments to log
+   */
+  log(...e) {
+    this.debugLogging && typeof console < "u" && console.log(...e);
+  }
+}
+n.registerLoader("static", l);
+export {
+  l as StaticImageLoader
+};
+//# sourceMappingURL=static.js.map

package/dist/loaders/static.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.js","sources":["../../src/engines/LoaderRegistry.ts","../../src/loaders/StaticImageLoader.ts","../../src/loaders/index-static.ts"],"sourcesContent":["/**\n * Loader Registry - Manages registration and lookup of image loader implementations\n *\n * This registry enables dynamic loading of loaders through separate bundles\n * while maintaining a central registry of available loaders. It mirrors the\n * LayoutEngine registry pattern for consistency.\n *\n * Public API:\n * - registerLoader(name, LoaderClass)\n * - getLoader(name)\n * - isRegistered(name)\n */\n\nimport type { ImageLoader, StaticLoaderInnerConfig, GoogleDriveLoaderInnerConfig } from '../config/types';\n\n/**\n * Constructor signature for loader classes\n * Supports both simple loaders and composite loaders with their respective config types\n */\nexport type LoaderConstructor =\n  | (new (config: StaticLoaderInnerConfig) => ImageLoader)\n  | (new (config: GoogleDriveLoaderInnerConfig) => ImageLoader)\n  | (new (config: any) => ImageLoader);\n\nexport class LoaderRegistry {\n  private static readonly registry = new Map<string, LoaderConstructor>();\n\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(name: string, Loader: LoaderConstructor): void {\n    LoaderRegistry.registry.set(name, Loader);\n  }\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(name: string): LoaderConstructor {\n    const Loader = LoaderRegistry.registry.get(name);\n\n    if (!Loader) {\n      throw new Error(\n        `Loader \"${name}\" is not registered. ` +\n        `Import \"@frybynite/image-cloud/loaders/${name}\" or \"@frybynite/image-cloud/loaders/all\".`\n      );\n    }\n\n    return Loader;\n  }\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(name: string): boolean {\n    return LoaderRegistry.registry.has(name);\n  }\n}\n","/**\n * StaticImageLoader.ts\n * Loads images from predefined URL sources and local paths\n * Compatible with ImageCloud's loader interface\n *\n * Public API:\n * - prepare(filter) - Async discovery of images\n * - imagesLength() - Get count of discovered images\n * - imageURLs() - Get ordered list of image URLs\n * - isPrepared() - Check if loader has been prepared\n */\n\nimport type { ImageLoader, IImageFilter, StaticSource, StaticLoaderInnerConfig } from '../config/types';\n\nexport class StaticImageLoader implements ImageLoader {\n  private validateUrls: boolean;\n  private validationTimeout: number;\n  private validationMethod: 'head' | 'simple' | 'none';\n  private sources: StaticSource[];\n  private debugLogging: boolean;\n\n  // State for new interface\n  private _prepared: boolean = false;\n  private _discoveredUrls: string[] = [];\n\n  constructor(config: StaticLoaderInnerConfig) {\n    this.validateUrls = config.validateUrls !== false;\n    this.validationTimeout = config.validationTimeout ?? 5000;\n    this.validationMethod = config.validationMethod ?? 'head';\n    this.debugLogging = config.debugLogging ?? false;\n    this.sources = config.sources ?? [];\n\n    // Validate that we have sources configured\n    if (!this.sources || this.sources.length === 0) {\n      throw new Error('StaticImageLoader requires at least one source to be configured');\n    }\n\n    this.log('StaticImageLoader initialized with config:', config);\n  }\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(filter: IImageFilter): Promise<void> {\n    this._discoveredUrls = [];\n\n    this.log(`Processing ${this.sources.length} source(s)`);\n\n    // Process sources sequentially to preserve order\n    for (const source of this.sources) {\n      try {\n        const urls = await this.processSource(source, filter);\n        this._discoveredUrls.push(...urls);\n      } catch (error) {\n        console.warn('Failed to process source:', source, error);\n        // Continue processing other sources\n      }\n    }\n\n    this._prepared = true;\n    this.log(`Successfully loaded ${this._discoveredUrls.length} image(s)`);\n  }\n\n  /**\n   * Get the number of discovered images\n   * @throws Error if called before prepare()\n   */\n  imagesLength(): number {\n    if (!this._prepared) {\n      throw new Error('StaticImageLoader.imagesLength() called before prepare()');\n    }\n    return this._discoveredUrls.length;\n  }\n\n  /**\n   * Get the ordered list of image URLs\n   * @throws Error if called before prepare()\n   */\n  imageURLs(): string[] {\n    if (!this._prepared) {\n      throw new Error('StaticImageLoader.imageURLs() called before prepare()');\n    }\n    return [...this._discoveredUrls];\n  }\n\n  /**\n   * Check if the loader has been prepared\n   */\n  isPrepared(): boolean {\n    return this._prepared;\n  }\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  private async processSource(source: StaticSource, filter: IImageFilter): Promise<string[]> {\n    if (!source) {\n      console.warn('Invalid source object:', source);\n      return [];\n    }\n\n    if ('urls' in source) {\n      return await this.processUrls(source.urls, filter);\n    } else if ('path' in source) {\n      return await this.processPath(source.path, source.files, filter);\n    } else if ('json' in source) {\n      return await this.processJson(source.json, filter);\n    } else {\n      console.warn('Unknown source shape:', source);\n      return [];\n    }\n  }\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  private async processUrls(urls: string[], filter: IImageFilter): Promise<string[]> {\n    if (!Array.isArray(urls)) {\n      console.warn('URLs must be an array:', urls);\n      return [];\n    }\n\n    const validUrls: string[] = [];\n\n    for (const url of urls) {\n      // Apply filter based on URL filename\n      const filename = url.split('/').pop() || url;\n      if (!filter.isAllowed(filename)) {\n        this.log(`Skipping filtered URL: ${url}`);\n        continue;\n      }\n\n      if (this.validateUrls) {\n        const isValid = await this.validateUrl(url);\n        if (isValid) {\n          validUrls.push(url);\n        } else {\n          console.warn(`Skipping invalid/missing URL: ${url}`);\n        }\n      } else {\n        // No validation - add all URLs\n        validUrls.push(url);\n      }\n    }\n\n    return validUrls;\n  }\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  private async processPath(basePath: string, files: string[], filter: IImageFilter): Promise<string[]> {\n\n    if (!Array.isArray(files)) {\n      console.warn('files must be an array:', files);\n      return [];\n    }\n\n    const validUrls: string[] = [];\n\n    for (const file of files) {\n      // Apply filter based on filename\n      if (!filter.isAllowed(file)) {\n        this.log(`Skipping filtered file: ${file}`);\n        continue;\n      }\n\n      const url = this.constructUrl(basePath, file);\n\n      if (this.validateUrls) {\n        const isValid = await this.validateUrl(url);\n        if (isValid) {\n          validUrls.push(url);\n        } else {\n          console.warn(`Skipping invalid/missing file: ${url}`);\n        }\n      } else {\n        // No validation - add all URLs\n        validUrls.push(url);\n      }\n    }\n\n    return validUrls;\n  }\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  private async processJson(url: string, filter: IImageFilter): Promise<string[]> {\n\n    this.log(`Fetching JSON endpoint: ${url}`);\n\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), 10000);\n\n    try {\n      const response = await fetch(url, { signal: controller.signal });\n      clearTimeout(timeoutId);\n\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status} fetching ${url}`);\n      }\n\n      const data = await response.json();\n\n      if (!data || !Array.isArray(data.images)) {\n        throw new Error(`JSON source must return JSON with shape { \"images\": [\"url1\", \"url2\", ...] }`);\n      }\n\n      this.log(`JSON endpoint returned ${data.images.length} image(s)`);\n\n      // Process the URLs through the standard URL processing pipeline\n      return await this.processUrls(data.images, filter);\n    } catch (error) {\n      clearTimeout(timeoutId);\n      if (error instanceof Error && error.name === 'AbortError') {\n        throw new Error(`Timeout fetching JSON endpoint: ${url}`);\n      }\n      throw error;\n    }\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  private async validateUrl(url: string): Promise<boolean> {\n    if (this.validationMethod === 'none') {\n      return true;\n    }\n\n    if (this.validationMethod === 'simple') {\n      // Basic URL format check\n      try {\n        if (typeof window !== 'undefined') {\n          new URL(url, window.location.origin);\n        } else {\n          new URL(url);\n        }\n        return true;\n      } catch {\n        return false;\n      }\n    }\n\n    // validationMethod === 'head' (default)\n    // For cross-origin URLs, we can't validate due to CORS\n    // So we only validate same-origin URLs\n    if (typeof window === 'undefined') {\n      return true; // In non-browser environment, assume valid\n    }\n\n    const isSameOrigin = url.startsWith(window.location.origin) ||\n                         url.startsWith('/');\n\n    if (!isSameOrigin) {\n      // Cross-origin URL - assume valid, can't validate due to CORS\n      this.log(`Skipping validation for cross-origin URL: ${url}`);\n      return true;\n    }\n\n    // Same-origin URL - validate with HEAD request\n    try {\n      const controller = new AbortController();\n      const timeoutId = setTimeout(() => controller.abort(), this.validationTimeout);\n\n      const response = await fetch(url, {\n        method: 'HEAD',\n        signal: controller.signal\n      });\n\n      clearTimeout(timeoutId);\n\n      if (response.ok) {\n        return true;\n      } else {\n        this.log(`Validation failed for ${url}: HTTP ${response.status}`);\n        return false;\n      }\n\n    } catch (error) {\n      if (error instanceof Error) {\n        if (error.name === 'AbortError') {\n          this.log(`Validation timeout for ${url}`);\n        } else {\n          this.log(`Validation failed for ${url}:`, error.message);\n        }\n      }\n      return false;\n    }\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  private constructUrl(basePath: string, filename: string): string {\n    // Remove trailing slash from basePath\n    const cleanBase = basePath.replace(/\\/$/, '');\n\n    // Check if basePath is absolute URL\n    if (this.isAbsoluteUrl(basePath)) {\n      return `${cleanBase}/${filename}`;\n    }\n\n    // Relative path - prepend current origin\n    if (typeof window === 'undefined') {\n      return `${cleanBase}/${filename}`; // In non-browser environment, return as-is\n    }\n\n    const origin = window.location.origin;\n    // Ensure basePath starts with /\n    const normalizedPath = basePath.startsWith('/') ? basePath : '/' + basePath;\n    const cleanPath = normalizedPath.replace(/\\/$/, '');\n\n    return `${origin}${cleanPath}/${filename}`;\n  }\n\n  /**\n   * Check if URL is absolute (contains protocol)\n   * @param url - URL to check\n   * @returns True if absolute URL\n   */\n  private isAbsoluteUrl(url: string): boolean {\n    try {\n      new URL(url);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Debug logging helper\n   * @param args - Arguments to log\n   */\n  private log(...args: unknown[]): void {\n    if (this.debugLogging && typeof console !== 'undefined') {\n      console.log(...args);\n    }\n  }\n}\n","import { LoaderRegistry } from '../engines/LoaderRegistry';\nimport { StaticImageLoader } from './StaticImageLoader';\n\nLoaderRegistry.registerLoader('static', StaticImageLoader);\n\nexport { StaticImageLoader };\n"],"names":["_LoaderRegistry","name","Loader","LoaderRegistry","StaticImageLoader","config","filter","source","urls","error","validUrls","url","filename","basePath","files","file","controller","timeoutId","response","data","cleanBase","origin","cleanPath","args"],"mappings":"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"}

package/dist/react.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
      */