react-a11y-auto-caption 1.0.1 → 1.0.4

package/dist/index.mjs

@@ -0,0 +1,185 @@
+// src/useAICaption.ts
+import { createContext, useContext, useEffect, useRef, useState } from "react";
+var SmartImageContext = createContext(void 0);
+var MAX_SIZE = 500;
+var LRUCaptionCache = class {
+  constructor() {
+    this.cache = /* @__PURE__ */ new Map();
+  }
+  get(key) {
+    return this.cache.get(key);
+  }
+  set(key, value) {
+    if (this.cache.size >= MAX_SIZE) {
+      this.cache.delete(this.cache.keys().next().value);
+    }
+    this.cache.set(key, value);
+  }
+  has(key) {
+    return this.cache.has(key);
+  }
+  clear() {
+    this.cache.clear();
+  }
+};
+var captionCache = new LRUCaptionCache();
+var pendingRequestCache = /* @__PURE__ */ new Map();
+function isStaticImageData(src) {
+  return typeof src === "object" && src !== null && "src" in src;
+}
+function resolveImageUrl(src) {
+  if (typeof src === "string") return src;
+  if (isStaticImageData(src)) return src.src;
+  return src.default.src;
+}
+var log = process.env.NODE_ENV === "development" ? console.log : () => {
+};
+var useAICaptions = ({
+  src,
+  alt,
+  apiEndpoint: propsEndpoint,
+  fallbackAlt = "Image loading or caption unavailable",
+  onCaptionGenerated,
+  disableAI: propsDisableAI,
+  onCaptionError
+}) => {
+  const context = useContext(SmartImageContext);
+  const apiEndpoint = propsEndpoint || context?.apiEndpoint;
+  const disableAI = propsDisableAI ?? context?.disableAI ?? false;
+  const [generatedAlt, setGeneratedAlt] = useState("");
+  const [isGenerating, setIsGenerating] = useState(false);
+  const [error, setError] = useState(null);
+  const onCaptionGeneratedRef = useRef(onCaptionGenerated);
+  const onCaptionErrorRef = useRef(onCaptionError);
+  useEffect(() => {
+    onCaptionGeneratedRef.current = onCaptionGenerated;
+    onCaptionErrorRef.current = onCaptionError;
+  });
+  useEffect(() => {
+    setError(null);
+    if (alt) {
+      setGeneratedAlt(alt);
+      return;
+    }
+    if (!src) return;
+    if (disableAI) {
+      setGeneratedAlt("[Testing mode: AI caption generation disabled]");
+      return;
+    }
+    if (!apiEndpoint) {
+      console.warn(
+        "[SmartImage] Missing 'apiEndpoint' prop. Please provide a backend API URL via props or SmartImageProvider to enable AI caption generation."
+      );
+      setGeneratedAlt(fallbackAlt);
+      return;
+    }
+    const imageUrl = resolveImageUrl(src);
+    if (captionCache.has(imageUrl)) {
+      log("[SmartImage] Cache hit: Reusing existing caption.");
+      const cachedCaption = captionCache.get(imageUrl);
+      setGeneratedAlt(cachedCaption);
+      if (onCaptionGeneratedRef.current) onCaptionGeneratedRef.current(cachedCaption);
+      return;
+    }
+    let cancelled = false;
+    const generateCaption = async () => {
+      setIsGenerating(true);
+      try {
+        if (pendingRequestCache.has(imageUrl)) {
+          log("[SmartImage] Pending request detected. Waiting for the existing API call to complete.");
+          const caption = await pendingRequestCache.get(imageUrl);
+          if (cancelled) return;
+          setGeneratedAlt(caption);
+          if (onCaptionGeneratedRef.current) onCaptionGeneratedRef.current(caption);
+          return;
+        }
+        const fetchPromise = (async () => {
+          const imageResponse = await fetch(imageUrl);
+          const imageBlob = await imageResponse.blob();
+          const imageFile = new File([imageBlob], "image.jpg", {
+            type: imageBlob.type || "image/jpeg"
+          });
+          const formData = new FormData();
+          formData.append("file", imageFile);
+          const response = await fetch(apiEndpoint, {
+            method: "POST",
+            body: formData
+          });
+          if (!response.ok) throw new Error("AI API request failed");
+          const data = await response.json();
+          if (data.caption) return data.caption;
+          throw new Error("No caption returned from the API.");
+        })();
+        pendingRequestCache.set(imageUrl, fetchPromise);
+        const newCaption = await fetchPromise;
+        pendingRequestCache.delete(imageUrl);
+        captionCache.set(imageUrl, newCaption);
+        if (cancelled) return;
+        setGeneratedAlt(newCaption);
+        if (onCaptionGeneratedRef.current) onCaptionGeneratedRef.current(newCaption);
+      } catch (err) {
+        const normalizedError = err instanceof Error ? err : new Error("Unknown error");
+        pendingRequestCache.delete(imageUrl);
+        if (cancelled) return;
+        setError(normalizedError);
+        setGeneratedAlt(fallbackAlt);
+        if (onCaptionErrorRef.current) onCaptionErrorRef.current(normalizedError);
+      } finally {
+        if (!cancelled) setIsGenerating(false);
+      }
+    };
+    generateCaption();
+    return () => {
+      cancelled = true;
+    };
+  }, [src, alt, apiEndpoint, fallbackAlt, disableAI]);
+  return { generatedAlt, isGenerating, error };
+};
+
+// src/index.tsx
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+var SmartImageProvider = ({ value, children }) => {
+  return /* @__PURE__ */ jsx(SmartImageContext.Provider, { value, children });
+};
+var SR_ONLY_STYLE = {
+  position: "absolute",
+  width: "1px",
+  height: "1px",
+  padding: 0,
+  margin: "-1px",
+  overflow: "hidden",
+  clip: "rect(0, 0, 0, 0)",
+  whiteSpace: "nowrap",
+  borderWidth: 0
+};
+var SmartImage = ({
+  src,
+  alt,
+  apiEndpoint: propsEndpoint,
+  fallbackAlt = "Image loading or caption unavailable",
+  onCaptionGenerated,
+  disableAI: propsDisableAI,
+  announceLive = false,
+  onCaptionError,
+  ...props
+}) => {
+  const { isGenerating, generatedAlt } = useAICaptions({
+    src,
+    alt,
+    apiEndpoint: propsEndpoint,
+    fallbackAlt,
+    onCaptionGenerated,
+    disableAI: propsDisableAI,
+    announceLive,
+    onCaptionError
+  });
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    announceLive && /* @__PURE__ */ jsx("span", { style: SR_ONLY_STYLE, "aria-live": "polite", "aria-atomic": "true", children: isGenerating ? "Generating image description. Please wait..." : generatedAlt ? `Image description generated: ${generatedAlt}` : "" }),
+    /* @__PURE__ */ jsx("img", { src, alt: generatedAlt, "aria-busy": isGenerating, ...props })
+  ] });
+};
+export {
+  SmartImage,
+  SmartImageProvider
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/useAICaption.ts","../src/index.tsx"],"sourcesContent":["import { StaticImport } from \"next/dist/shared/lib/get-img-props\";\r\nimport { StaticImageData } from \"next/image\";\r\nimport { createContext, ImgHTMLAttributes, useContext, useEffect, useRef, useState } from \"react\";\r\n\r\nexport interface UseAICaptionOptions {\r\n  src?: string | StaticImport;\r\n  alt?: string;\r\n  apiEndpoint?: string;\r\n  fallbackAlt?: string;\r\n  onCaptionGenerated?: (caption: string) => void;\r\n  disableAI?: boolean;\r\n  announceLive?: boolean;\r\n  onCaptionError?: (error: Error) => void;\r\n}\r\n\r\ninterface SmartImageContextProps {\r\n  apiEndpoint?: string;\r\n  disableAI?: boolean;\r\n}\r\n\r\nexport const SmartImageContext = createContext<SmartImageContextProps | undefined>(undefined);\r\n\r\nconst MAX_SIZE = 500;\r\n\r\nclass LRUCaptionCache {\r\n  private cache = new Map<string, string>();\r\n\r\n  get(key: string): string | undefined {\r\n    return this.cache.get(key);\r\n  }\r\n  set(key: string, value: string) {\r\n    if (this.cache.size >= MAX_SIZE) {\r\n      this.cache.delete(this.cache.keys().next().value!);\r\n    }\r\n    this.cache.set(key, value);\r\n  }\r\n  has(key: string) {\r\n    return this.cache.has(key);\r\n  }\r\n  clear() {\r\n    this.cache.clear();\r\n  }\r\n}\r\n\r\nconst captionCache = new LRUCaptionCache();\r\nconst pendingRequestCache = new Map<string, Promise<string>>();\r\n\r\nexport interface SmartImageProps extends ImgHTMLAttributes<HTMLImageElement> {\r\n  apiEndpoint?: string;\r\n  fallbackAlt?: string;\r\n  onCaptionGenerated?: (caption: string) => void;\r\n  disableAI?: boolean;\r\n  announceLive?: boolean;\r\n}\r\n\r\nfunction isStaticImageData(src: string | StaticImport): src is StaticImageData {\r\n  return typeof src === \"object\" && src !== null && \"src\" in src;\r\n}\r\n\r\nfunction resolveImageUrl(src: string | StaticImport): string {\r\n  if (typeof src === \"string\") return src;\r\n  if (isStaticImageData(src)) return src.src;\r\n  return src.default.src;\r\n}\r\n\r\nconst log = process.env.NODE_ENV === \"development\" ? console.log : () => {};\r\n\r\nexport const useAICaptions = ({\r\n  src,\r\n  alt,\r\n  apiEndpoint: propsEndpoint,\r\n  fallbackAlt = \"Image loading or caption unavailable\",\r\n  onCaptionGenerated,\r\n  disableAI: propsDisableAI,\r\n  onCaptionError,\r\n}: UseAICaptionOptions) => {\r\n  const context = useContext(SmartImageContext);\r\n\r\n  const apiEndpoint = propsEndpoint || context?.apiEndpoint;\r\n  const disableAI = propsDisableAI ?? context?.disableAI ?? false;\r\n\r\n  const [generatedAlt, setGeneratedAlt] = useState(\"\");\r\n  const [isGenerating, setIsGenerating] = useState(false);\r\n  const [error, setError] = useState<Error | null>(null);\r\n\r\n  const onCaptionGeneratedRef = useRef(onCaptionGenerated);\r\n  const onCaptionErrorRef = useRef(onCaptionError);\r\n\r\n  useEffect(() => {\r\n    onCaptionGeneratedRef.current = onCaptionGenerated;\r\n    onCaptionErrorRef.current = onCaptionError;\r\n  });\r\n\r\n  useEffect(() => {\r\n    setError(null);\r\n\r\n    if (alt) {\r\n      setGeneratedAlt(alt);\r\n      return;\r\n    }\r\n\r\n    if (!src) return;\r\n\r\n    if (disableAI) {\r\n      setGeneratedAlt(\"[Testing mode: AI caption generation disabled]\");\r\n      return;\r\n    }\r\n\r\n    if (!apiEndpoint) {\r\n      console.warn(\r\n        \"[SmartImage] Missing 'apiEndpoint' prop. Please provide a backend API URL via props or SmartImageProvider to enable AI caption generation.\",\r\n      );\r\n      setGeneratedAlt(fallbackAlt);\r\n      return;\r\n    }\r\n\r\n    const imageUrl = resolveImageUrl(src);\r\n\r\n    if (captionCache.has(imageUrl)) {\r\n      log(\"[SmartImage] Cache hit: Reusing existing caption.\");\r\n      const cachedCaption = captionCache.get(imageUrl)!;\r\n      setGeneratedAlt(cachedCaption);\r\n      if (onCaptionGeneratedRef.current) onCaptionGeneratedRef.current(cachedCaption);\r\n      return;\r\n    }\r\n\r\n    let cancelled = false;\r\n\r\n    const generateCaption = async () => {\r\n      setIsGenerating(true);\r\n      try {\r\n        if (pendingRequestCache.has(imageUrl)) {\r\n          log(\"[SmartImage] Pending request detected. Waiting for the existing API call to complete.\");\r\n          const caption = await pendingRequestCache.get(imageUrl)!;\r\n          if (cancelled) return;\r\n          setGeneratedAlt(caption);\r\n          if (onCaptionGeneratedRef.current) onCaptionGeneratedRef.current(caption);\r\n          return;\r\n        }\r\n\r\n        const fetchPromise = (async () => {\r\n          const imageResponse = await fetch(imageUrl);\r\n          const imageBlob = await imageResponse.blob();\r\n          const imageFile = new File([imageBlob], \"image.jpg\", {\r\n            type: imageBlob.type || \"image/jpeg\",\r\n          });\r\n          const formData = new FormData();\r\n          formData.append(\"file\", imageFile);\r\n\r\n          const response = await fetch(apiEndpoint, {\r\n            method: \"POST\",\r\n            body: formData,\r\n          });\r\n\r\n          if (!response.ok) throw new Error(\"AI API request failed\");\r\n          const data = await response.json();\r\n          if (data.caption) return data.caption;\r\n          throw new Error(\"No caption returned from the API.\");\r\n        })();\r\n\r\n        pendingRequestCache.set(imageUrl, fetchPromise);\r\n\r\n        const newCaption = await fetchPromise;\r\n        pendingRequestCache.delete(imageUrl);\r\n        captionCache.set(imageUrl, newCaption);\r\n\r\n        if (cancelled) return;\r\n        setGeneratedAlt(newCaption);\r\n        if (onCaptionGeneratedRef.current) onCaptionGeneratedRef.current(newCaption);\r\n      } catch (err) {\r\n        const normalizedError = err instanceof Error ? err : new Error(\"Unknown error\");\r\n        pendingRequestCache.delete(imageUrl);\r\n        if (cancelled) return;\r\n        setError(normalizedError);\r\n        setGeneratedAlt(fallbackAlt);\r\n        if (onCaptionErrorRef.current) onCaptionErrorRef.current(normalizedError);\r\n      } finally {\r\n        if (!cancelled) setIsGenerating(false);\r\n      }\r\n    };\r\n\r\n    generateCaption();\r\n\r\n    return () => {\r\n      cancelled = true;\r\n    };\r\n  }, [src, alt, apiEndpoint, fallbackAlt, disableAI]);\r\n\r\n  return { generatedAlt, isGenerating, error };\r\n};\r\n","import React, { ImgHTMLAttributes } from \"react\";\r\nimport { SmartImageContext, useAICaptions } from \"./useAICaption\";\r\n\r\nexport const SmartImageProvider: React.FC<{\r\n  value: { apiEndpoint?: string; disableAI?: boolean };\r\n  children: React.ReactNode;\r\n}> = ({ value, children }) => {\r\n  return <SmartImageContext.Provider value={value}>{children}</SmartImageContext.Provider>;\r\n};\r\n\r\nexport interface SmartImageProps extends ImgHTMLAttributes<HTMLImageElement> {\r\n  src?: string;\r\n  apiEndpoint?: string;\r\n  fallbackAlt?: string;\r\n  onCaptionGenerated?: (caption: string) => void;\r\n  disableAI?: boolean;\r\n  announceLive?: boolean;\r\n  onCaptionError?: (error: Error) => void;\r\n}\r\n\r\nconst SR_ONLY_STYLE: React.CSSProperties = {\r\n  position: \"absolute\",\r\n  width: \"1px\",\r\n  height: \"1px\",\r\n  padding: 0,\r\n  margin: \"-1px\",\r\n  overflow: \"hidden\",\r\n  clip: \"rect(0, 0, 0, 0)\",\r\n  whiteSpace: \"nowrap\",\r\n  borderWidth: 0,\r\n};\r\n\r\nexport const SmartImage = ({\r\n  src,\r\n  alt,\r\n  apiEndpoint: propsEndpoint,\r\n  fallbackAlt = \"Image loading or caption unavailable\",\r\n  onCaptionGenerated,\r\n  disableAI: propsDisableAI,\r\n  announceLive = false,\r\n  onCaptionError,\r\n  ...props\r\n}: SmartImageProps) => {\r\n  const { isGenerating, generatedAlt } = useAICaptions({\r\n    src,\r\n    alt,\r\n    apiEndpoint: propsEndpoint,\r\n    fallbackAlt,\r\n    onCaptionGenerated,\r\n    disableAI: propsDisableAI,\r\n    announceLive,\r\n    onCaptionError,\r\n  });\r\n\r\n  return (\r\n    <>\r\n      {announceLive && (\r\n        <span style={SR_ONLY_STYLE} aria-live=\"polite\" aria-atomic=\"true\">\r\n          {isGenerating\r\n            ? \"Generating image description. Please wait...\"\r\n            : generatedAlt\r\n              ? `Image description generated: ${generatedAlt}`\r\n              : \"\"}\r\n        </span>\r\n      )}\r\n      <img src={src} alt={generatedAlt} aria-busy={isGenerating} {...props} />\r\n    </>\r\n  );\r\n};\r\n"],"mappings":"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","names":[]}

package/dist/next.d.ts

@@ -0,0 +1,13 @@
+import React from "react";
+import { ImageProps } from "next/image";
+export interface SmartNextImageProps extends Omit<ImageProps, "alt"> {
+    alt?: string;
+    apiEndpoint?: string;
+    fallbackAlt?: string;
+    onCaptionGenerated?: (caption: string) => void;
+    onCaptionError?: (error: Error) => void;
+    disableAI?: boolean;
+    announceLive?: boolean;
+}
+export declare const SR_ONLY_STYLE: React.CSSProperties;
+export declare const SmartNextImage: ({ src, alt, apiEndpoint: propsEndpoint, fallbackAlt, onCaptionGenerated, onCaptionError, disableAI: propsDisableAI, announceLive, ...props }: SmartNextImageProps) => import("react/jsx-runtime").JSX.Element;

package/dist/next.js

@@ -0,0 +1,221 @@
+"use strict";
+"use client";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/next.tsx
+var next_exports = {};
+__export(next_exports, {
+  SR_ONLY_STYLE: () => SR_ONLY_STYLE,
+  SmartNextImage: () => SmartNextImage
+});
+module.exports = __toCommonJS(next_exports);
+var import_image = __toESM(require("next/image"));
+
+// src/useAICaption.ts
+var import_react = require("react");
+var SmartImageContext = (0, import_react.createContext)(void 0);
+var MAX_SIZE = 500;
+var LRUCaptionCache = class {
+  constructor() {
+    this.cache = /* @__PURE__ */ new Map();
+  }
+  get(key) {
+    return this.cache.get(key);
+  }
+  set(key, value) {
+    if (this.cache.size >= MAX_SIZE) {
+      this.cache.delete(this.cache.keys().next().value);
+    }
+    this.cache.set(key, value);
+  }
+  has(key) {
+    return this.cache.has(key);
+  }
+  clear() {
+    this.cache.clear();
+  }
+};
+var captionCache = new LRUCaptionCache();
+var pendingRequestCache = /* @__PURE__ */ new Map();
+function isStaticImageData(src) {
+  return typeof src === "object" && src !== null && "src" in src;
+}
+function resolveImageUrl(src) {
+  if (typeof src === "string") return src;
+  if (isStaticImageData(src)) return src.src;
+  return src.default.src;
+}
+var log = process.env.NODE_ENV === "development" ? console.log : () => {
+};
+var useAICaptions = ({
+  src,
+  alt,
+  apiEndpoint: propsEndpoint,
+  fallbackAlt = "Image loading or caption unavailable",
+  onCaptionGenerated,
+  disableAI: propsDisableAI,
+  onCaptionError
+}) => {
+  const context = (0, import_react.useContext)(SmartImageContext);
+  const apiEndpoint = propsEndpoint || context?.apiEndpoint;
+  const disableAI = propsDisableAI ?? context?.disableAI ?? false;
+  const [generatedAlt, setGeneratedAlt] = (0, import_react.useState)("");
+  const [isGenerating, setIsGenerating] = (0, import_react.useState)(false);
+  const [error, setError] = (0, import_react.useState)(null);
+  const onCaptionGeneratedRef = (0, import_react.useRef)(onCaptionGenerated);
+  const onCaptionErrorRef = (0, import_react.useRef)(onCaptionError);
+  (0, import_react.useEffect)(() => {
+    onCaptionGeneratedRef.current = onCaptionGenerated;
+    onCaptionErrorRef.current = onCaptionError;
+  });
+  (0, import_react.useEffect)(() => {
+    setError(null);
+    if (alt) {
+      setGeneratedAlt(alt);
+      return;
+    }
+    if (!src) return;
+    if (disableAI) {
+      setGeneratedAlt("[Testing mode: AI caption generation disabled]");
+      return;
+    }
+    if (!apiEndpoint) {
+      console.warn(
+        "[SmartImage] Missing 'apiEndpoint' prop. Please provide a backend API URL via props or SmartImageProvider to enable AI caption generation."
+      );
+      setGeneratedAlt(fallbackAlt);
+      return;
+    }
+    const imageUrl = resolveImageUrl(src);
+    if (captionCache.has(imageUrl)) {
+      log("[SmartImage] Cache hit: Reusing existing caption.");
+      const cachedCaption = captionCache.get(imageUrl);
+      setGeneratedAlt(cachedCaption);
+      if (onCaptionGeneratedRef.current) onCaptionGeneratedRef.current(cachedCaption);
+      return;
+    }
+    let cancelled = false;
+    const generateCaption = async () => {
+      setIsGenerating(true);
+      try {
+        if (pendingRequestCache.has(imageUrl)) {
+          log("[SmartImage] Pending request detected. Waiting for the existing API call to complete.");
+          const caption = await pendingRequestCache.get(imageUrl);
+          if (cancelled) return;
+          setGeneratedAlt(caption);
+          if (onCaptionGeneratedRef.current) onCaptionGeneratedRef.current(caption);
+          return;
+        }
+        const fetchPromise = (async () => {
+          const imageResponse = await fetch(imageUrl);
+          const imageBlob = await imageResponse.blob();
+          const imageFile = new File([imageBlob], "image.jpg", {
+            type: imageBlob.type || "image/jpeg"
+          });
+          const formData = new FormData();
+          formData.append("file", imageFile);
+          const response = await fetch(apiEndpoint, {
+            method: "POST",
+            body: formData
+          });
+          if (!response.ok) throw new Error("AI API request failed");
+          const data = await response.json();
+          if (data.caption) return data.caption;
+          throw new Error("No caption returned from the API.");
+        })();
+        pendingRequestCache.set(imageUrl, fetchPromise);
+        const newCaption = await fetchPromise;
+        pendingRequestCache.delete(imageUrl);
+        captionCache.set(imageUrl, newCaption);
+        if (cancelled) return;
+        setGeneratedAlt(newCaption);
+        if (onCaptionGeneratedRef.current) onCaptionGeneratedRef.current(newCaption);
+      } catch (err) {
+        const normalizedError = err instanceof Error ? err : new Error("Unknown error");
+        pendingRequestCache.delete(imageUrl);
+        if (cancelled) return;
+        setError(normalizedError);
+        setGeneratedAlt(fallbackAlt);
+        if (onCaptionErrorRef.current) onCaptionErrorRef.current(normalizedError);
+      } finally {
+        if (!cancelled) setIsGenerating(false);
+      }
+    };
+    generateCaption();
+    return () => {
+      cancelled = true;
+    };
+  }, [src, alt, apiEndpoint, fallbackAlt, disableAI]);
+  return { generatedAlt, isGenerating, error };
+};
+
+// src/next.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+var SR_ONLY_STYLE = {
+  position: "absolute",
+  width: "1px",
+  height: "1px",
+  padding: 0,
+  margin: "-1px",
+  overflow: "hidden",
+  clip: "rect(0, 0, 0, 0)",
+  whiteSpace: "nowrap",
+  borderWidth: 0
+};
+var SmartNextImage = ({
+  src,
+  alt,
+  apiEndpoint: propsEndpoint,
+  fallbackAlt = "Image loading or caption unavailable",
+  onCaptionGenerated,
+  onCaptionError,
+  disableAI: propsDisableAI,
+  announceLive = false,
+  ...props
+}) => {
+  const { isGenerating, generatedAlt } = useAICaptions({
+    src,
+    alt,
+    apiEndpoint: propsEndpoint,
+    fallbackAlt,
+    onCaptionGenerated,
+    disableAI: propsDisableAI,
+    announceLive
+  });
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_jsx_runtime.Fragment, { children: [
+    announceLive && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: SR_ONLY_STYLE, "aria-live": "polite", "aria-atomic": "true", children: isGenerating ? "Generating image description. Please wait..." : generatedAlt ? `Image description generated: ${generatedAlt}` : "" }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_image.default, { src, alt: generatedAlt || fallbackAlt, "aria-busy": isGenerating, ...props })
+  ] });
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SR_ONLY_STYLE,
+  SmartNextImage
+});
+//# sourceMappingURL=next.js.map

package/dist/next.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/next.tsx","../src/useAICaption.ts"],"sourcesContent":["\"use client\";\r\n\r\nimport React from \"react\";\r\nimport Image, { ImageProps } from \"next/image\";\r\n\r\nimport { useAICaptions } from \"./useAICaption\";\r\n\r\nexport interface SmartNextImageProps extends Omit<ImageProps, \"alt\"> {\r\n  alt?: string;\r\n  apiEndpoint?: string;\r\n  fallbackAlt?: string;\r\n  onCaptionGenerated?: (caption: string) => void;\r\n  onCaptionError?: (error: Error) => void;\r\n  disableAI?: boolean;\r\n  announceLive?: boolean;\r\n}\r\nexport const SR_ONLY_STYLE: React.CSSProperties = {\r\n  position: \"absolute\",\r\n  width: \"1px\",\r\n  height: \"1px\",\r\n  padding: 0,\r\n  margin: \"-1px\",\r\n  overflow: \"hidden\",\r\n  clip: \"rect(0, 0, 0, 0)\",\r\n  whiteSpace: \"nowrap\",\r\n  borderWidth: 0,\r\n};\r\nexport const SmartNextImage = ({\r\n  src,\r\n  alt,\r\n  apiEndpoint: propsEndpoint,\r\n  fallbackAlt = \"Image loading or caption unavailable\",\r\n  onCaptionGenerated,\r\n  onCaptionError,\r\n  disableAI: propsDisableAI,\r\n  announceLive = false,\r\n  ...props\r\n}: SmartNextImageProps) => {\r\n  const { isGenerating, generatedAlt } = useAICaptions({\r\n    src,\r\n    alt,\r\n    apiEndpoint: propsEndpoint,\r\n    fallbackAlt,\r\n    onCaptionGenerated,\r\n    disableAI: propsDisableAI,\r\n    announceLive,\r\n  });\r\n  return (\r\n    <>\r\n      {announceLive && (\r\n        <span style={SR_ONLY_STYLE} aria-live=\"polite\" aria-atomic=\"true\">\r\n          {isGenerating\r\n            ? \"Generating image description. Please wait...\"\r\n            : generatedAlt\r\n              ? `Image description generated: ${generatedAlt}`\r\n              : \"\"}\r\n        </span>\r\n      )}\r\n\r\n      <Image src={src} alt={generatedAlt || fallbackAlt} aria-busy={isGenerating} {...props} />\r\n    </>\r\n  );\r\n};\r\n","import { StaticImport } from \"next/dist/shared/lib/get-img-props\";\r\nimport { StaticImageData } from \"next/image\";\r\nimport { createContext, ImgHTMLAttributes, useContext, useEffect, useRef, useState } from \"react\";\r\n\r\nexport interface UseAICaptionOptions {\r\n  src?: string | StaticImport;\r\n  alt?: string;\r\n  apiEndpoint?: string;\r\n  fallbackAlt?: string;\r\n  onCaptionGenerated?: (caption: string) => void;\r\n  disableAI?: boolean;\r\n  announceLive?: boolean;\r\n  onCaptionError?: (error: Error) => void;\r\n}\r\n\r\ninterface SmartImageContextProps {\r\n  apiEndpoint?: string;\r\n  disableAI?: boolean;\r\n}\r\n\r\nexport const SmartImageContext = createContext<SmartImageContextProps | undefined>(undefined);\r\n\r\nconst MAX_SIZE = 500;\r\n\r\nclass LRUCaptionCache {\r\n  private cache = new Map<string, string>();\r\n\r\n  get(key: string): string | undefined {\r\n    return this.cache.get(key);\r\n  }\r\n  set(key: string, value: string) {\r\n    if (this.cache.size >= MAX_SIZE) {\r\n      this.cache.delete(this.cache.keys().next().value!);\r\n    }\r\n    this.cache.set(key, value);\r\n  }\r\n  has(key: string) {\r\n    return this.cache.has(key);\r\n  }\r\n  clear() {\r\n    this.cache.clear();\r\n  }\r\n}\r\n\r\nconst captionCache = new LRUCaptionCache();\r\nconst pendingRequestCache = new Map<string, Promise<string>>();\r\n\r\nexport interface SmartImageProps extends ImgHTMLAttributes<HTMLImageElement> {\r\n  apiEndpoint?: string;\r\n  fallbackAlt?: string;\r\n  onCaptionGenerated?: (caption: string) => void;\r\n  disableAI?: boolean;\r\n  announceLive?: boolean;\r\n}\r\n\r\nfunction isStaticImageData(src: string | StaticImport): src is StaticImageData {\r\n  return typeof src === \"object\" && src !== null && \"src\" in src;\r\n}\r\n\r\nfunction resolveImageUrl(src: string | StaticImport): string {\r\n  if (typeof src === \"string\") return src;\r\n  if (isStaticImageData(src)) return src.src;\r\n  return src.default.src;\r\n}\r\n\r\nconst log = process.env.NODE_ENV === \"development\" ? console.log : () => {};\r\n\r\nexport const useAICaptions = ({\r\n  src,\r\n  alt,\r\n  apiEndpoint: propsEndpoint,\r\n  fallbackAlt = \"Image loading or caption unavailable\",\r\n  onCaptionGenerated,\r\n  disableAI: propsDisableAI,\r\n  onCaptionError,\r\n}: UseAICaptionOptions) => {\r\n  const context = useContext(SmartImageContext);\r\n\r\n  const apiEndpoint = propsEndpoint || context?.apiEndpoint;\r\n  const disableAI = propsDisableAI ?? context?.disableAI ?? false;\r\n\r\n  const [generatedAlt, setGeneratedAlt] = useState(\"\");\r\n  const [isGenerating, setIsGenerating] = useState(false);\r\n  const [error, setError] = useState<Error | null>(null);\r\n\r\n  const onCaptionGeneratedRef = useRef(onCaptionGenerated);\r\n  const onCaptionErrorRef = useRef(onCaptionError);\r\n\r\n  useEffect(() => {\r\n    onCaptionGeneratedRef.current = onCaptionGenerated;\r\n    onCaptionErrorRef.current = onCaptionError;\r\n  });\r\n\r\n  useEffect(() => {\r\n    setError(null);\r\n\r\n    if (alt) {\r\n      setGeneratedAlt(alt);\r\n      return;\r\n    }\r\n\r\n    if (!src) return;\r\n\r\n    if (disableAI) {\r\n      setGeneratedAlt(\"[Testing mode: AI caption generation disabled]\");\r\n      return;\r\n    }\r\n\r\n    if (!apiEndpoint) {\r\n      console.warn(\r\n        \"[SmartImage] Missing 'apiEndpoint' prop. Please provide a backend API URL via props or SmartImageProvider to enable AI caption generation.\",\r\n      );\r\n      setGeneratedAlt(fallbackAlt);\r\n      return;\r\n    }\r\n\r\n    const imageUrl = resolveImageUrl(src);\r\n\r\n    if (captionCache.has(imageUrl)) {\r\n      log(\"[SmartImage] Cache hit: Reusing existing caption.\");\r\n      const cachedCaption = captionCache.get(imageUrl)!;\r\n      setGeneratedAlt(cachedCaption);\r\n      if (onCaptionGeneratedRef.current) onCaptionGeneratedRef.current(cachedCaption);\r\n      return;\r\n    }\r\n\r\n    let cancelled = false;\r\n\r\n    const generateCaption = async () => {\r\n      setIsGenerating(true);\r\n      try {\r\n        if (pendingRequestCache.has(imageUrl)) {\r\n          log(\"[SmartImage] Pending request detected. Waiting for the existing API call to complete.\");\r\n          const caption = await pendingRequestCache.get(imageUrl)!;\r\n          if (cancelled) return;\r\n          setGeneratedAlt(caption);\r\n          if (onCaptionGeneratedRef.current) onCaptionGeneratedRef.current(caption);\r\n          return;\r\n        }\r\n\r\n        const fetchPromise = (async () => {\r\n          const imageResponse = await fetch(imageUrl);\r\n          const imageBlob = await imageResponse.blob();\r\n          const imageFile = new File([imageBlob], \"image.jpg\", {\r\n            type: imageBlob.type || \"image/jpeg\",\r\n          });\r\n          const formData = new FormData();\r\n          formData.append(\"file\", imageFile);\r\n\r\n          const response = await fetch(apiEndpoint, {\r\n            method: \"POST\",\r\n            body: formData,\r\n          });\r\n\r\n          if (!response.ok) throw new Error(\"AI API request failed\");\r\n          const data = await response.json();\r\n          if (data.caption) return data.caption;\r\n          throw new Error(\"No caption returned from the API.\");\r\n        })();\r\n\r\n        pendingRequestCache.set(imageUrl, fetchPromise);\r\n\r\n        const newCaption = await fetchPromise;\r\n        pendingRequestCache.delete(imageUrl);\r\n        captionCache.set(imageUrl, newCaption);\r\n\r\n        if (cancelled) return;\r\n        setGeneratedAlt(newCaption);\r\n        if (onCaptionGeneratedRef.current) onCaptionGeneratedRef.current(newCaption);\r\n      } catch (err) {\r\n        const normalizedError = err instanceof Error ? err : new Error(\"Unknown error\");\r\n        pendingRequestCache.delete(imageUrl);\r\n        if (cancelled) return;\r\n        setError(normalizedError);\r\n        setGeneratedAlt(fallbackAlt);\r\n        if (onCaptionErrorRef.current) onCaptionErrorRef.current(normalizedError);\r\n      } finally {\r\n        if (!cancelled) setIsGenerating(false);\r\n      }\r\n    };\r\n\r\n    generateCaption();\r\n\r\n    return () => {\r\n      cancelled = true;\r\n    };\r\n  }, [src, alt, apiEndpoint, fallbackAlt, disableAI]);\r\n\r\n  return { generatedAlt, isGenerating, error };\r\n};\r\n"],"mappings":"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","names":["Image"]}

package/dist/next.mjs

@@ -0,0 +1,186 @@
+"use client";
+
+// src/next.tsx
+import Image from "next/image";
+
+// src/useAICaption.ts
+import { createContext, useContext, useEffect, useRef, useState } from "react";
+var SmartImageContext = createContext(void 0);
+var MAX_SIZE = 500;
+var LRUCaptionCache = class {
+  constructor() {
+    this.cache = /* @__PURE__ */ new Map();
+  }
+  get(key) {
+    return this.cache.get(key);
+  }
+  set(key, value) {
+    if (this.cache.size >= MAX_SIZE) {
+      this.cache.delete(this.cache.keys().next().value);
+    }
+    this.cache.set(key, value);
+  }
+  has(key) {
+    return this.cache.has(key);
+  }
+  clear() {
+    this.cache.clear();
+  }
+};
+var captionCache = new LRUCaptionCache();
+var pendingRequestCache = /* @__PURE__ */ new Map();
+function isStaticImageData(src) {
+  return typeof src === "object" && src !== null && "src" in src;
+}
+function resolveImageUrl(src) {
+  if (typeof src === "string") return src;
+  if (isStaticImageData(src)) return src.src;
+  return src.default.src;
+}
+var log = process.env.NODE_ENV === "development" ? console.log : () => {
+};
+var useAICaptions = ({
+  src,
+  alt,
+  apiEndpoint: propsEndpoint,
+  fallbackAlt = "Image loading or caption unavailable",
+  onCaptionGenerated,
+  disableAI: propsDisableAI,
+  onCaptionError
+}) => {
+  const context = useContext(SmartImageContext);
+  const apiEndpoint = propsEndpoint || context?.apiEndpoint;
+  const disableAI = propsDisableAI ?? context?.disableAI ?? false;
+  const [generatedAlt, setGeneratedAlt] = useState("");
+  const [isGenerating, setIsGenerating] = useState(false);
+  const [error, setError] = useState(null);
+  const onCaptionGeneratedRef = useRef(onCaptionGenerated);
+  const onCaptionErrorRef = useRef(onCaptionError);
+  useEffect(() => {
+    onCaptionGeneratedRef.current = onCaptionGenerated;
+    onCaptionErrorRef.current = onCaptionError;
+  });
+  useEffect(() => {
+    setError(null);
+    if (alt) {
+      setGeneratedAlt(alt);
+      return;
+    }
+    if (!src) return;
+    if (disableAI) {
+      setGeneratedAlt("[Testing mode: AI caption generation disabled]");
+      return;
+    }
+    if (!apiEndpoint) {
+      console.warn(
+        "[SmartImage] Missing 'apiEndpoint' prop. Please provide a backend API URL via props or SmartImageProvider to enable AI caption generation."
+      );
+      setGeneratedAlt(fallbackAlt);
+      return;
+    }
+    const imageUrl = resolveImageUrl(src);
+    if (captionCache.has(imageUrl)) {
+      log("[SmartImage] Cache hit: Reusing existing caption.");
+      const cachedCaption = captionCache.get(imageUrl);
+      setGeneratedAlt(cachedCaption);
+      if (onCaptionGeneratedRef.current) onCaptionGeneratedRef.current(cachedCaption);
+      return;
+    }
+    let cancelled = false;
+    const generateCaption = async () => {
+      setIsGenerating(true);
+      try {
+        if (pendingRequestCache.has(imageUrl)) {
+          log("[SmartImage] Pending request detected. Waiting for the existing API call to complete.");
+          const caption = await pendingRequestCache.get(imageUrl);
+          if (cancelled) return;
+          setGeneratedAlt(caption);
+          if (onCaptionGeneratedRef.current) onCaptionGeneratedRef.current(caption);
+          return;
+        }
+        const fetchPromise = (async () => {
+          const imageResponse = await fetch(imageUrl);
+          const imageBlob = await imageResponse.blob();
+          const imageFile = new File([imageBlob], "image.jpg", {
+            type: imageBlob.type || "image/jpeg"
+          });
+          const formData = new FormData();
+          formData.append("file", imageFile);
+          const response = await fetch(apiEndpoint, {
+            method: "POST",
+            body: formData
+          });
+          if (!response.ok) throw new Error("AI API request failed");
+          const data = await response.json();
+          if (data.caption) return data.caption;
+          throw new Error("No caption returned from the API.");
+        })();
+        pendingRequestCache.set(imageUrl, fetchPromise);
+        const newCaption = await fetchPromise;
+        pendingRequestCache.delete(imageUrl);
+        captionCache.set(imageUrl, newCaption);
+        if (cancelled) return;
+        setGeneratedAlt(newCaption);
+        if (onCaptionGeneratedRef.current) onCaptionGeneratedRef.current(newCaption);
+      } catch (err) {
+        const normalizedError = err instanceof Error ? err : new Error("Unknown error");
+        pendingRequestCache.delete(imageUrl);
+        if (cancelled) return;
+        setError(normalizedError);
+        setGeneratedAlt(fallbackAlt);
+        if (onCaptionErrorRef.current) onCaptionErrorRef.current(normalizedError);
+      } finally {
+        if (!cancelled) setIsGenerating(false);
+      }
+    };
+    generateCaption();
+    return () => {
+      cancelled = true;
+    };
+  }, [src, alt, apiEndpoint, fallbackAlt, disableAI]);
+  return { generatedAlt, isGenerating, error };
+};
+
+// src/next.tsx
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+var SR_ONLY_STYLE = {
+  position: "absolute",
+  width: "1px",
+  height: "1px",
+  padding: 0,
+  margin: "-1px",
+  overflow: "hidden",
+  clip: "rect(0, 0, 0, 0)",
+  whiteSpace: "nowrap",
+  borderWidth: 0
+};
+var SmartNextImage = ({
+  src,
+  alt,
+  apiEndpoint: propsEndpoint,
+  fallbackAlt = "Image loading or caption unavailable",
+  onCaptionGenerated,
+  onCaptionError,
+  disableAI: propsDisableAI,
+  announceLive = false,
+  ...props
+}) => {
+  const { isGenerating, generatedAlt } = useAICaptions({
+    src,
+    alt,
+    apiEndpoint: propsEndpoint,
+    fallbackAlt,
+    onCaptionGenerated,
+    disableAI: propsDisableAI,
+    announceLive
+  });
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    announceLive && /* @__PURE__ */ jsx("span", { style: SR_ONLY_STYLE, "aria-live": "polite", "aria-atomic": "true", children: isGenerating ? "Generating image description. Please wait..." : generatedAlt ? `Image description generated: ${generatedAlt}` : "" }),
+    /* @__PURE__ */ jsx(Image, { src, alt: generatedAlt || fallbackAlt, "aria-busy": isGenerating, ...props })
+  ] });
+};
+export {
+  SR_ONLY_STYLE,
+  SmartNextImage
+};
+//# sourceMappingURL=next.mjs.map