react-a11y-auto-caption 1.0.1 → 1.0.4

package/dist/next.mjs.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":[]}

package/dist/useAICaption.d.ts

@@ -0,0 +1,30 @@
+import { StaticImport } from "next/dist/shared/lib/get-img-props";
+import { ImgHTMLAttributes } from "react";
+export interface UseAICaptionOptions {
+    src?: string | StaticImport;
+    alt?: string;
+    apiEndpoint?: string;
+    fallbackAlt?: string;
+    onCaptionGenerated?: (caption: string) => void;
+    disableAI?: boolean;
+    announceLive?: boolean;
+    onCaptionError?: (error: Error) => void;
+}
+interface SmartImageContextProps {
+    apiEndpoint?: string;
+    disableAI?: boolean;
+}
+export declare const SmartImageContext: import("react").Context<SmartImageContextProps | undefined>;
+export interface SmartImageProps extends ImgHTMLAttributes<HTMLImageElement> {
+    apiEndpoint?: string;
+    fallbackAlt?: string;
+    onCaptionGenerated?: (caption: string) => void;
+    disableAI?: boolean;
+    announceLive?: boolean;
+}
+export declare const useAICaptions: ({ src, alt, apiEndpoint: propsEndpoint, fallbackAlt, onCaptionGenerated, disableAI: propsDisableAI, onCaptionError, }: UseAICaptionOptions) => {
+    generatedAlt: string;
+    isGenerating: boolean;
+    error: Error | null;
+};
+export {};

package/package.json

@@ -1,41 +1,70 @@
-{
-  "name": "react-a11y-auto-caption",
-  "version": "1.0.1",
-  "description": "Smart React component that automatically generates alt text for images using AI.",
-  "main": "./dist/index.js",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
-  "scripts": {
-    "build": "tsup && tsc --emitDeclarationOnly --declaration --declarationDir ./dist",
-    "dev": "tsup --watch"
-  },
-  "keywords": [
-    "react",
-    "accessibility",
-    "a11y",
-    "ai",
-    "image-captioning",
-    "alt-text"
-  ],
-  "author": "Gaeun Kim",
-  "license": "MIT",
-  "devDependencies": {
-    "@types/react": "^19.2.14",
-    "@types/react-dom": "^19.2.3",
-    "react": "^19.2.5",
-    "react-dom": "^19.2.5",
-    "tsup": "^8.5.1",
-    "typescript": "^6.0.2",
-    "next": "^15.0.0"
-  },
-  "peerDependencies": {
-    "react": ">=18.0.0",
-    "react-dom": ">=18.0.0",
-    "next": ">=13.0.0"
-  },
-  "peerDependenciesMeta": {
-    "next": {
-      "optional": true
-    }
-  }
-}
+{
+  "name": "react-a11y-auto-caption",
+  "version": "1.0.4",
+  "description": "Smart React component that automatically generates alt text for images using AI.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "keywords": [
+    "react",
+    "accessibility",
+    "a11y",
+    "alt-text",
+    "image-caption",
+    "caption-generator",
+    "screen-reader",
+    "nextjs"
+  ],
+  "homepage": "https://github.com/kong33/react-a11y-auto-caption#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kong33/react-a11y-auto-caption"
+  },
+  "bugs": {
+    "url": "https://github.com/kong33/react-a11y-auto-caption/issues"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./next": {
+      "import": "./dist/next.js",
+      "types": "./dist/next.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsup && tsc --emitDeclarationOnly --declaration --declarationDir ./dist",
+    "dev": "tsup --watch"
+  },
+  "author": "Gaeun Kim",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "next": "^15.0.0",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.2"
+  },
+  "peerDependencies": {
+    "next": ">=13.0.0",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.tsx

@@ -1,161 +0,0 @@
-import React, { createContext, useContext, useState, useEffect, ImgHTMLAttributes } from "react";
-
-interface SmartImageContextProps {
-  apiEndpoint?: string;
-  disableAI?: boolean;
-}
-
-export const SmartImageContext = createContext<SmartImageContextProps | undefined>(undefined);
-
-export const SmartImageProvider: React.FC<{
-  value: SmartImageContextProps;
-  children: React.ReactNode;
-}> = ({ value, children }) => {
-  return <SmartImageContext.Provider value={value}>{children}</SmartImageContext.Provider>;
-};
-
-const captionCache = new Map<string, string>();
-const pendingRequestCache = new Map<string, Promise<string>>();
-
-export interface SmartImageProps extends ImgHTMLAttributes<HTMLImageElement> {
-  apiEndpoint?: string;
-  fallbackAlt?: string;
-  onCaptionGenerated?: (caption: string) => void;
-  disableAI?: boolean;
-  announceLive?: boolean;
-}
-
-export const SmartImage = ({
-  src,
-  alt,
-  apiEndpoint: propsEndpoint,
-  fallbackAlt = "Image loading or caption unavailable",
-  onCaptionGenerated,
-  disableAI: propsDisableAI,
-  announceLive = false,
-  ...props
-}: SmartImageProps) => {
-  const context = useContext(SmartImageContext);
-
-  const apiEndpoint = propsEndpoint || context?.apiEndpoint;
-  const disableAI = propsDisableAI ?? context?.disableAI ?? false;
-
-  const [generatedAlt, setGeneratedAlt] = useState("");
-  const [isGenerating, setIsGenerating] = useState(false);
-
-  useEffect(() => {
-    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 = src as string;
-
-    if (captionCache.has(imageUrl)) {
-      console.log("[SmartImage] Cache hit: Reusing existing caption.");
-      const cachedCaption = captionCache.get(imageUrl)!;
-      setGeneratedAlt(cachedCaption);
-
-      if (onCaptionGenerated) onCaptionGenerated(cachedCaption);
-      return;
-    }
-
-    const generateCaption = async () => {
-      setIsGenerating(true);
-      try {
-        if (pendingRequestCache.has(imageUrl)) {
-          console.log("[SmartImage] Pending request detected. Waiting for the existing API call to complete.");
-          const caption = await pendingRequestCache.get(imageUrl)!;
-          setGeneratedAlt(caption);
-          if (onCaptionGenerated) onCaptionGenerated(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);
-
-        setGeneratedAlt(newCaption);
-
-        if (onCaptionGenerated) onCaptionGenerated(newCaption);
-      } catch (error) {
-        console.error("[SmartImage] Caption Error:", error);
-        pendingRequestCache.delete(imageUrl);
-        setGeneratedAlt(fallbackAlt);
-      } finally {
-        setIsGenerating(false);
-      }
-    };
-
-    generateCaption();
-  }, [src, alt, apiEndpoint, fallbackAlt, onCaptionGenerated, disableAI]);
-
-  const srOnlyStyle: React.CSSProperties = {
-    position: "absolute",
-    width: "1px",
-    height: "1px",
-    padding: 0,
-    margin: "-1px",
-    overflow: "hidden",
-    clip: "rect(0, 0, 0, 0)",
-    whiteSpace: "nowrap",
-    borderWidth: 0,
-  };
-
-  return (
-    <>
-      {announceLive && (
-        <span style={srOnlyStyle} aria-live="polite" aria-atomic="true">
-          {isGenerating
-            ? "Generating image description. Please wait..."
-            : generatedAlt
-              ? `Image description generated: ${generatedAlt}`
-              : ""}
-        </span>
-      )}
-
-      <img src={src} alt={generatedAlt} aria-busy={isGenerating} {...props} />
-    </>
-  );
-};

package/src/next-env.d.ts

@@ -1,2 +0,0 @@
-/// <reference types="next" />
-/// <reference types="next/image-types/global" />

package/src/next.tsx

@@ -1,154 +0,0 @@
-import React, { useState, useEffect, useContext } from "react";
-import Image, { ImageProps } from "next/image";
-
-import { SmartImageContext } from "./index";
-
-function isStaticImport(source: any): source is { src: string } {
-  return typeof source === "object" && source !== null && "src" in source;
-}
-
-const captionCache = new Map<string, string>();
-const pendingRequestCache = new Map<string, Promise<string>>();
-
-export interface SmartNextImageProps extends Omit<ImageProps, "alt"> {
-  alt?: string;
-  apiEndpoint?: string;
-  fallbackAlt?: string;
-  onCaptionGenerated?: (caption: string) => void;
-  disableAI?: boolean;
-  announceLive?: boolean;
-}
-
-export const SmartNextImage = ({
-  src,
-  alt,
-  apiEndpoint: propsEndpoint,
-  fallbackAlt = "Image loading or caption unavailable",
-  onCaptionGenerated,
-  disableAI: propsDisableAI,
-  announceLive = false,
-  ...props
-}: SmartNextImageProps) => {
-  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 imageUrl = isStaticImport(src) ? src.src : (src as string);
-
-  useEffect(() => {
-    if (alt) {
-      setGeneratedAlt(alt);
-      return;
-    }
-
-    if (!src) return;
-
-    if (disableAI) {
-      setGeneratedAlt("[Testing mode: AI caption generation disabled]");
-      return;
-    }
-
-    if (!apiEndpoint) {
-      console.warn(
-        "[SmartNextImage] Missing 'apiEndpoint' prop. Please provide a backend API URL via props or SmartImageProvider to enable AI caption generation.",
-      );
-      setGeneratedAlt(fallbackAlt);
-      return;
-    }
-
-    if (captionCache.has(imageUrl)) {
-      console.log("[SmartNextImage] Cache hit: Reusing existing caption.");
-      const cachedCaption = captionCache.get(imageUrl)!;
-      setGeneratedAlt(cachedCaption);
-
-      if (onCaptionGenerated) onCaptionGenerated(cachedCaption);
-      return;
-    }
-
-    const generateCaption = async () => {
-      setIsGenerating(true);
-      try {
-        if (pendingRequestCache.has(imageUrl)) {
-          console.log("[SmartNextImage] Pending request detected. Waiting for the existing API call to complete.");
-          const caption = await pendingRequestCache.get(imageUrl)!;
-          setGeneratedAlt(caption);
-          if (onCaptionGenerated) onCaptionGenerated(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);
-
-        setGeneratedAlt(newCaption);
-
-        if (onCaptionGenerated) onCaptionGenerated(newCaption);
-      } catch (error) {
-        console.error("[SmartNextImage] Caption Error:", error);
-        pendingRequestCache.delete(imageUrl);
-        setGeneratedAlt(fallbackAlt);
-      } finally {
-        setIsGenerating(false);
-      }
-    };
-
-    generateCaption();
-  }, [src, alt, apiEndpoint, fallbackAlt, onCaptionGenerated, disableAI, imageUrl]);
-
-  const srOnlyStyle: React.CSSProperties = {
-    position: "absolute",
-    width: "1px",
-    height: "1px",
-    padding: 0,
-    margin: "-1px",
-    overflow: "hidden",
-    clip: "rect(0, 0, 0, 0)",
-    whiteSpace: "nowrap",
-    borderWidth: 0,
-  };
-
-  return (
-    <>
-      {announceLive && (
-        <span style={srOnlyStyle} aria-live="polite" aria-atomic="true">
-          {isGenerating
-            ? "Generating image description. Please wait..."
-            : generatedAlt
-              ? `Image description generated: ${generatedAlt}`
-              : ""}
-        </span>
-      )}
-
-      <Image src={src} alt={generatedAlt || ""} aria-busy={isGenerating} {...props} />
-    </>
-  );
-};

package/tsconfig.json

@@ -1,19 +0,0 @@
-{
-  "compilerOptions": {
-    "rootDir": "./src",
-    "target": "es2020",
-    "lib": ["dom", "dom.iterable", "esnext"],
-    "allowJs": false,
-    "skipLibCheck": true,
-    "esModuleInterop": true,
-    "allowSyntheticDefaultImports": true,
-    "strict": true,
-    "forceConsistentCasingInFileNames": true,
-    "module": "esnext",
-    "moduleResolution": "bundler",
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "jsx": "react-jsx"
-  },
-  "include": ["src"]
-}

package/tsup.config.ts

@@ -1,11 +0,0 @@
-import { defineConfig } from "tsup";
-
-export default defineConfig({
-  entry: ["src/index.tsx", "src/next.tsx"],
-  format: ["cjs", "esm"],
-  dts: false,
-  splitting: false,
-  sourcemap: true,
-  clean: true,
-  external: ["react", "react-dom"],
-});