@nextclaw/ui 0.15.18 → 0.15.19

package/src/shared/components/doc-browser/__tests__/doc-browser-context.test.tsx

@@ -269,6 +269,9 @@ describe('DocBrowserProvider panel app resources', () => {
 
     act(() => {
       result.current.openTarget({
+        contentParams: {
+          file: { path: '/tmp/photo.png' },
+        },
         dedupeKey: 'panel-app:demo',
         dockIcon: { type: 'url', url: '/api/panel-apps/demo/assets/icon.png' },
         historyPolicy: 'managed',
@@ -281,6 +284,9 @@ describe('DocBrowserProvider panel app resources', () => {
 
     expect(result.current.currentTab).toMatchObject({
       currentUrl: '/api/panel-apps/demo/content',
+      contentParams: {
+        file: { path: '/tmp/photo.png' },
+      },
       dedupeKey: 'panel-app:demo',
       dockIcon: { type: 'url', url: '/api/panel-apps/demo/assets/icon.png' },
       kind: 'panel-app',
@@ -288,6 +294,32 @@ describe('DocBrowserProvider panel app resources', () => {
       title: 'Demo Panel App',
     });
   });
+
+  it('reloads a reused Panel App tab when its params change', () => {
+    const { result } = renderHook(() => useDocBrowser(), { wrapper });
+    const openPanelApp = (path: string) => {
+      result.current.openTarget({
+        contentParams: { file: { path } },
+        dedupeKey: 'panel-app:demo',
+        historyPolicy: 'managed',
+        kind: 'panel-app',
+        resourceUri: 'nextclaw://panel-app/demo',
+        title: 'Demo Panel App',
+        url: '/api/panel-apps/demo/content',
+      });
+    };
+
+    act(() => openPanelApp('/tmp/first.png'));
+    const firstNavVersion = result.current.currentTab?.navVersion;
+    act(() => openPanelApp('/tmp/second.png'));
+
+    expect(result.current.currentTab).toMatchObject({
+      contentParams: {
+        file: { path: '/tmp/second.png' },
+      },
+      navVersion: (firstNavVersion ?? 0) + 1,
+    });
+  });
 });
 
 describe('DocBrowserProvider managed history', () => {

package/src/shared/components/doc-browser/doc-browser-panel-parts.tsx

@@ -10,6 +10,7 @@ import {
 import { IconActionButton } from '@/shared/components/ui/actions/icon-action-button';
 import { NavigationLink } from '@/shared/components/actions/navigation-link';
 import { t } from '@/shared/lib/i18n';
+import { createUiContentParamsWindowName } from '@nextclaw/shared';
 
 type DocBrowserAddressToolbarProps = {
   isVisible: boolean;
@@ -86,6 +87,7 @@ export function DocBrowserFrameContent({
           ref={iframeRef}
           key={iframeInstanceId}
           src={currentUrl}
+          name={createUiContentParamsWindowName(currentTab?.contentParams)}
           className="absolute inset-0 w-full h-full border-0"
           title={currentTab?.title || 'NextClaw Docs'}
           sandbox={iframeSandbox}

package/src/shared/components/doc-browser/managers/doc-browser.manager.ts

@@ -8,10 +8,12 @@ import type {
   DocBrowserTab,
 } from '@/shared/components/doc-browser/types/doc-browser.types';
 import {
+  appendManualNavigation,
   createDocBrowserActiveHistoryEntry,
   createDefaultDocBrowserState,
   createDocBrowserTab,
   normalizeDocBrowserDockedWidth,
+  updateTabForOpen,
 } from '@/shared/components/doc-browser/utils/doc-browser-state.utils';
 import {
   DOC_BROWSER_HOME_TAB_KIND,
@@ -45,14 +47,6 @@ function updateActiveTab(state: DocBrowserState, updater: (tab: DocBrowserTab) =
   return updateTab(state, state.activeTabId, updater);
 }
 
-function appendManualNavigation(tab: DocBrowserTab, url: string): Pick<DocBrowserTab, 'history' | 'historyIndex'> {
-  const history = [...tab.history.slice(0, tab.historyIndex + 1), url];
-  return {
-    history,
-    historyIndex: history.length - 1,
-  };
-}
-
 function areActiveHistoryEntriesEquivalent(
   routeResolver: DocBrowserRouteResolver,
   current: DocBrowserActiveHistoryEntry,
@@ -140,34 +134,6 @@ function restoreActiveHistoryEntry(
   );
 }
 
-function updateTabForOpen(
-  routeResolver: DocBrowserRouteResolver,
-  tab: DocBrowserTab,
-  target: DocBrowserRouteTarget,
-  options?: DocBrowserOpenOptions,
-  dedupeKey?: string,
-): DocBrowserTab {
-  const baseTab = {
-    ...tab,
-    title: options?.title || target.title || tab.title,
-    kind: target.kind,
-    resourceUri: target.resourceUri ?? target.url,
-    dockIcon: options?.dockIcon ?? target.dockIcon,
-    dedupeKey,
-  };
-
-  if (routeResolver.areUrlsEquivalent(tab.currentUrl, target.url, tab.kind, target.kind)) {
-    return baseTab;
-  }
-
-  return {
-    ...baseTab,
-    currentUrl: target.url,
-    ...appendManualNavigation(tab, target.url),
-    navVersion: tab.navVersion + 1,
-  };
-}
-
 function isClosedDefaultHomeState(state: DocBrowserState, activeTab?: DocBrowserTab): boolean {
   return !state.isOpen
     && state.tabs.length === 1
@@ -213,7 +179,15 @@ function openResolvedDocBrowserState(
   }
 
   if (shouldForceNewTab || dedupeKey || !activeTab || activeTab.kind !== target.kind) {
-    const newTab = createDocBrowserTab(target.url, target.kind, title ?? target.title, dedupeKey, target.resourceUri ?? target.url, options?.dockIcon ?? target.dockIcon);
+    const newTab = createDocBrowserTab(
+      target.url,
+      target.kind,
+      title ?? target.title,
+      dedupeKey,
+      target.resourceUri ?? target.url,
+      options?.dockIcon ?? target.dockIcon,
+      target.contentParams,
+    );
     if (isClosedDefaultHomeState(prev, activeTab)) {
       const nextState = {
         ...prev,
@@ -257,7 +231,15 @@ function openDocBrowserState(
     kind: options?.kind,
     url,
   });
-  return openResolvedDocBrowserState(routeResolver, prev, target, options);
+  return openResolvedDocBrowserState(
+    routeResolver,
+    prev,
+    {
+      ...target,
+      contentParams: options?.contentParams,
+    },
+    options,
+  );
 }
 
 export class DocBrowserManager {

package/src/shared/components/doc-browser/types/doc-browser.types.ts

@@ -1,3 +1,5 @@
+import type { UiContentParams } from '@nextclaw/shared';
+
 export type DocBrowserMode = 'floating' | 'docked';
 export type DocBrowserTabKind = 'docs' | 'content' | (string & {});
 
@@ -7,6 +9,7 @@ export type DocBrowserTab = {
   title: string;
   currentUrl: string;
   resourceUri?: string;
+  contentParams?: UiContentParams;
   dockIcon?: DocBrowserDockIcon;
   dedupeKey?: string;
   history: string[];
@@ -21,6 +24,7 @@ export type DocBrowserRouteTarget = {
   historyPolicy: 'managed' | 'none';
   kind: DocBrowserTabKind;
   resourceUri?: string;
+  contentParams?: UiContentParams;
   title: string;
   url: string;
 };
@@ -71,6 +75,7 @@ export type DocBrowserOpenOptions = {
   newTab?: boolean;
   title?: string;
   kind?: DocBrowserTabKind;
+  contentParams?: UiContentParams;
 };
 
 export type DocBrowserState = {

package/src/shared/components/doc-browser/utils/doc-browser-state.utils.ts

@@ -1,6 +1,9 @@
 import type {
   DocBrowserActiveHistoryEntry,
   DocBrowserDockIcon,
+  DocBrowserOpenOptions,
+  DocBrowserRouteResolver,
+  DocBrowserRouteTarget,
   DocBrowserState,
   DocBrowserTab,
   DocBrowserTabKind,
@@ -11,6 +14,10 @@ import {
   inferTabTitle,
 } from './doc-browser-url.utils';
 import { t } from '@/shared/lib/i18n';
+import {
+  createUiContentParamsWindowName,
+  type UiContentParams,
+} from '@nextclaw/shared';
 
 export const DOC_BROWSER_DOCKED_DEFAULT_WIDTH = 420;
 export const DOC_BROWSER_DOCKED_MIN_WIDTH = 320;
@@ -36,6 +43,7 @@ export function createDocBrowserTab(
   dedupeKey?: string,
   resourceUri?: string,
   dockIcon?: DocBrowserDockIcon,
+  contentParams?: UiContentParams,
 ): DocBrowserTab {
   const tabTitle = title?.trim() || inferTabTitle(url, kind, kind === 'docs' ? t('docBrowserHelp') : 'Detail');
   const normalizedResourceUri = resourceUri?.trim();
@@ -46,6 +54,7 @@ export function createDocBrowserTab(
     title: tabTitle,
     currentUrl: url,
     resourceUri: normalizedResourceUri ? normalizedResourceUri : undefined,
+    contentParams,
     dockIcon,
     dedupeKey,
     history: [url],
@@ -54,6 +63,60 @@ export function createDocBrowserTab(
   };
 }
 
+export function appendManualNavigation(
+  tab: DocBrowserTab,
+  url: string,
+): Pick<DocBrowserTab, 'history' | 'historyIndex'> {
+  const history = [...tab.history.slice(0, tab.historyIndex + 1), url];
+  return {
+    history,
+    historyIndex: history.length - 1,
+  };
+}
+
+export function updateTabForOpen(
+  routeResolver: DocBrowserRouteResolver,
+  tab: DocBrowserTab,
+  target: DocBrowserRouteTarget,
+  options?: DocBrowserOpenOptions,
+  dedupeKey?: string,
+): DocBrowserTab {
+  const baseTab = {
+    ...tab,
+    title: options?.title || target.title || tab.title,
+    kind: target.kind,
+    resourceUri: target.resourceUri ?? target.url,
+    dockIcon: options?.dockIcon ?? target.dockIcon,
+    dedupeKey,
+    contentParams: target.contentParams,
+  };
+  const hasSameUrl = routeResolver.areUrlsEquivalent(
+    tab.currentUrl,
+    target.url,
+    tab.kind,
+    target.kind,
+  );
+  if (
+    hasSameUrl &&
+    createUiContentParamsWindowName(tab.contentParams) ===
+      createUiContentParamsWindowName(target.contentParams)
+  ) {
+    return baseTab;
+  }
+  if (hasSameUrl) {
+    return {
+      ...baseTab,
+      navVersion: tab.navVersion + 1,
+    };
+  }
+  return {
+    ...baseTab,
+    currentUrl: target.url,
+    ...appendManualNavigation(tab, target.url),
+    navVersion: tab.navVersion + 1,
+  };
+}
+
 export function createDocBrowserActiveHistoryEntry(tab: DocBrowserTab): DocBrowserActiveHistoryEntry {
   return {
     kind: tab.kind,

package/src/shared/lib/i18n/locales/en-US/chat.json

@@ -388,6 +388,7 @@
   "chatMessageCopy": "Copy",
   "chatMessageCopied": "Copied",
   "chatMermaidDiagram": "Diagram",
+  "chatMermaidExpand": "Expand diagram",
   "chatMermaidLoading": "Rendering diagram…",
   "chatMermaidRenderError": "Diagram could not be rendered; showing source instead",
   "chatSidebarNewTask": "New Task",

package/src/shared/lib/i18n/locales/zh-CN/chat.json

@@ -388,6 +388,7 @@
   "chatMessageCopy": "复制",
   "chatMessageCopied": "已复制",
   "chatMermaidDiagram": "图表",
+  "chatMermaidExpand": "放大图表",
   "chatMermaidLoading": "正在渲染图表…",
   "chatMermaidRenderError": "图表无法渲染，已显示源代码",
   "chatSidebarNewTask": "新任务",