@nextclaw/ui 0.3.17 → 0.5.0

package/dist/index.html

@@ -6,7 +6,7 @@
   <link rel="icon" type="image/svg+xml" href="/logo.svg" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
   <title>NextClaw - 系统配置</title>
-  <script type="module" crossorigin src="/assets/index-CPXV1dWr.js"></script>
+  <script type="module" crossorigin src="/assets/index-1h_LfFkZ.js"></script>
   <link rel="stylesheet" crossorigin href="/assets/index-Wn63frSd.css">
 </head>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/ui",
-  "version": "0.3.17",
+  "version": "0.5.0",
   "private": false,
   "type": "module",
   "license": "MIT",

package/src/components/doc-browser/DocBrowser.tsx

@@ -48,6 +48,17 @@ export function DocBrowser() {
         }
     }, [currentUrl]);
 
+    // Listen for route changes from the iframe via postMessage
+    useEffect(() => {
+        const handler = (e: MessageEvent) => {
+            if (e.data?.type === 'docs-route-change' && typeof e.data.url === 'string') {
+                navigate(e.data.url);
+            }
+        };
+        window.addEventListener('message', handler);
+        return () => window.removeEventListener('message', handler);
+    }, [navigate]);
+
     const handleUrlSubmit = useCallback((e: React.FormEvent) => {
         e.preventDefault();
         const input = urlInput.trim();
@@ -235,6 +246,7 @@ export function DocBrowser() {
             {/* Iframe Content */}
             <div className="flex-1 relative overflow-hidden">
                 <iframe
+                    key={currentUrl}
                     src={currentUrl}
                     className="absolute inset-0 w-full h-full border-0"
                     title="NextClaw Documentation"

package/src/components/doc-browser/DocBrowserContext.tsx

@@ -86,12 +86,20 @@ export function DocBrowserProvider({ children }: { children: ReactNode }) {
     }, []);
 
     const navigate = useCallback((url: string) => {
-        setState(prev => ({
-            ...prev,
-            currentUrl: url,
-            history: [...prev.history.slice(0, prev.historyIndex + 1), url],
-            historyIndex: prev.historyIndex + 1,
-        }));
+        setState(prev => {
+            // Normalize URLs for comparison (strip trailing slash, .html suffix)
+            const normalize = (u: string) => {
+                try { return new URL(u).pathname.replace(/\.html$/, '').replace(/\/$/, ''); } catch { return u; }
+            };
+            // Skip if same as current URL (prevents loop from postMessage echo)
+            if (normalize(url) === normalize(prev.currentUrl)) return prev;
+            return {
+                ...prev,
+                currentUrl: url,
+                history: [...prev.history.slice(0, prev.historyIndex + 1), url],
+                historyIndex: prev.historyIndex + 1,
+            };
+        });
     }, []);
 
     const goBack = useCallback(() => {

package/src/components/doc-browser/useDocLinkInterceptor.ts

@@ -18,6 +18,9 @@ export function useDocLinkInterceptor() {
             const href = anchor.getAttribute('href') || '';
             if (!isDocsUrl(href)) return;
 
+            // Don't intercept links explicitly marked for external opening
+            if (anchor.hasAttribute('data-doc-external')) return;
+
             // Don't intercept if modifier keys are held (user wants new tab behavior)
             if (e.ctrlKey || e.metaKey || e.shiftKey) return;
 

package/src/lib/i18n.ts

@@ -164,6 +164,7 @@ export const LABELS: Record<string, { zh: string; en: string }> = {
   // Doc Browser
   docBrowserTitle: { zh: '帮助文档', en: 'Help Docs' },
   docBrowserSearchPlaceholder: { zh: '搜索，也可以输入文档地址直接打开', en: 'Search, or enter a doc URL to open' },
+  docBrowserUrlPlaceholder: { zh: '输入文档路径，如 /guide/channels', en: 'Enter a doc path, e.g. /guide/channels' },
   docBrowserOpenExternal: { zh: '文档中心打开', en: 'Open in Docs' },
   docBrowserFloatMode: { zh: '悬浮窗口', en: 'Float Window' },
   docBrowserDockMode: { zh: '固定到侧栏', en: 'Dock to Sidebar' },