@windrun-huaiin/third-ui 5.6.1 → 5.8.0

package/dist/toc-base-BC7kXpDU.d.mts

@@ -0,0 +1,15 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+interface LLMCopyButtonProps {
+    llmApiUrl?: string;
+    sourceKey?: string;
+}
+declare function LLMCopyButton({ llmApiUrl, sourceKey }?: LLMCopyButtonProps): react_jsx_runtime.JSX.Element;
+declare function EditOnGitHub({ url }: {
+    url: string;
+}): react_jsx_runtime.JSX.Element;
+declare function LastUpdatedDate({ date }: {
+    date: string | undefined;
+}): react_jsx_runtime.JSX.Element;
+
+export { EditOnGitHub as E, type LLMCopyButtonProps as L, LLMCopyButton as a, LastUpdatedDate as b };

package/dist/toc-base-BC7kXpDU.d.ts

@@ -0,0 +1,15 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+interface LLMCopyButtonProps {
+    llmApiUrl?: string;
+    sourceKey?: string;
+}
+declare function LLMCopyButton({ llmApiUrl, sourceKey }?: LLMCopyButtonProps): react_jsx_runtime.JSX.Element;
+declare function EditOnGitHub({ url }: {
+    url: string;
+}): react_jsx_runtime.JSX.Element;
+declare function LastUpdatedDate({ date }: {
+    date: string | undefined;
+}): react_jsx_runtime.JSX.Element;
+
+export { EditOnGitHub as E, type LLMCopyButtonProps as L, LLMCopyButton as a, LastUpdatedDate as b };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@windrun-huaiin/third-ui",
-  "version": "5.6.1",
+  "version": "5.8.0",
   "description": "Third-party integrated UI components for windrun-huaiin projects",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/src/fuma/fuma-page-genarator.tsx

@@ -1,8 +1,13 @@
 import { DocsBody, DocsDescription, DocsPage, DocsTitle } from 'fumadocs-ui/page';
-import { ReactNode } from 'react';
+import { ReactNode, ReactElement, cloneElement } from 'react';
 import { TocFooterWrapper } from '@third-ui/fuma/mdx';
+import type { LLMCopyButtonProps, LLMCopyButton } from '@third-ui/fuma/mdx';
 
-interface FumaPageParams {  
+interface FumaPageParams {
+  /* 
+   * The source key of the mdx content, used to generate the edit path
+   */
+  sourceKey: string;
   /* 
    * The source of the mdx content
    */
@@ -20,9 +25,9 @@ interface FumaPageParams {
    */
   githubBaseUrl?: string;
   /* 
-   * Whether to show the copy button, default is true
+   * The copy button component, must be LLMCopyButton
    */
-  showCopy?: boolean;
+  copyButtonComponent?: ReactElement<LLMCopyButtonProps, typeof LLMCopyButton>;
   /* 
    * The site icon component to use in NotFoundPage
    */
@@ -34,11 +39,12 @@ interface FumaPageParams {
 }
 
 export function createFumaPage({
+  sourceKey,
   mdxContentSource,
   getMDXComponents,
   mdxSourceDir,
   githubBaseUrl,
-  showCopy = true,
+  copyButtonComponent,
   siteIcon,
   FallbackPage,
 }: FumaPageParams) {
@@ -53,7 +59,11 @@ export function createFumaPage({
     const tocFooterElement = (
       <TocFooterWrapper
         lastModified={page.data.date}
-        showCopy={showCopy}
+        copyButtonComponent={
+          copyButtonComponent
+            ? cloneElement(copyButtonComponent, { sourceKey })
+            : undefined
+        }
         editPath={path}
         githubBaseUrl={githubBaseUrl}
       />

package/src/fuma/mdx/toc-base.tsx

@@ -9,7 +9,12 @@ import { Button } from '@base-ui/ui/button';
 
 const cache = new Map<string, string>();
 
-export function LLMCopyButton({ llmApiUrl }: { llmApiUrl?: string } = {}) {
+export interface LLMCopyButtonProps {
+  llmApiUrl?: string;
+  sourceKey?: string;
+}
+
+export function LLMCopyButton({ llmApiUrl, sourceKey }: LLMCopyButtonProps = {}) {
   const [isLoading, setLoading] = useState(false);
   const params = useParams();
   const locale = params.locale as string;
@@ -21,21 +26,30 @@ export function LLMCopyButton({ llmApiUrl }: { llmApiUrl?: string } = {}) {
     // Handle cases where slug might be undefined or empty
     const path = (slug && Array.isArray(slug)) ? slug.join('/') : '';
     const apiPrefix = llmApiUrl || '/api/llm-content';
-    const apiUrl = `${apiPrefix}?locale=${encodeURIComponent(locale)}&path=${encodeURIComponent(path)}`;
+    let apiUrl = `${apiPrefix}?locale=${encodeURIComponent(locale)}&path=${encodeURIComponent(path)}`;
+    if (sourceKey) {
+      apiUrl += `&sourceKey=${encodeURIComponent(sourceKey)}`;
+    }
     console.log('Fetching LLM content from:', apiUrl);
 
+    let content: string;
     try {
-      const content: string =
-        cache.get(apiUrl) ?? (await fetch(apiUrl).then((res) => {
-          if (!res.ok) {
-            throw new Error(`Failed to fetch LLM content: ${res.status} ${res.statusText}`);
-          }
-          return res.text();
-        }));
-
-      cache.set(apiUrl, content);
+      if (cache.has(apiUrl)) {
+        content = cache.get(apiUrl)!;
+      } else {
+        const res = await fetch(apiUrl);
+        if (!res.ok) {
+          content = `Error: Failed to fetch LLM content: ${res.status} ${res.statusText}`;
+        } else {
+          content = await res.text();
+          // only success then store cache
+          cache.set(apiUrl, content); 
+        }
+      }
       await navigator.clipboard.writeText(content);
     } catch (error) {
+      const errMsg = `Error: ${error instanceof Error ? error.message : String(error)}`;
+      await navigator.clipboard.writeText(errMsg);
       console.error("Error fetching or copying LLM content:", error);
     } finally {
       setLoading(false);

package/src/fuma/mdx/toc-footer-wrapper.tsx

@@ -1,19 +1,20 @@
 'use client';
-import { EditOnGitHub, LastUpdatedDate, LLMCopyButton } from '@third-ui/fuma/mdx/toc-base';
+import { EditOnGitHub, LastUpdatedDate } from '@third-ui/fuma/mdx/toc-base';
+import React from 'react';
 
 interface TocFooterProps {
   lastModified: string | undefined;
   editPath?: string;
   githubBaseUrl?: string;
-  showCopy?: boolean;
+  copyButtonComponent?: React.ReactNode;
 }
 
-export function TocFooterWrapper({ lastModified, editPath, githubBaseUrl, showCopy }: TocFooterProps) {
+export function TocFooterWrapper({ lastModified, editPath, githubBaseUrl, copyButtonComponent }: TocFooterProps) {
   const showEdit = githubBaseUrl && editPath;
   return (
     <div className="flex flex-col gap-y-2 items-start m-4">
       <LastUpdatedDate date={lastModified} />
-      {showCopy && <LLMCopyButton />}
+      {copyButtonComponent}
       {showEdit && <EditOnGitHub url={`${githubBaseUrl}${editPath}`} />}
     </div>
   );