@nextclaw/ui 0.15.17 → 0.15.19

package/src/features/chat/managers/__tests__/chat-ui.manager.test.ts

@@ -88,6 +88,9 @@ describe('ChatUiManager content display', () => {
         type: 'panel_app',
         payload: {
           appId: 'reader',
+          params: {
+            file: { path: '/tmp/photo.png' },
+          },
         },
       },
       title: 'Reader',
@@ -95,6 +98,9 @@ describe('ChatUiManager content display', () => {
 
     expect(docBrowserManager.openTarget).toHaveBeenCalledWith({
       dedupeKey: 'panel-app:encoded-reader',
+      contentParams: {
+        file: { path: '/tmp/photo.png' },
+      },
       historyPolicy: 'managed',
       kind: 'panel-app',
       resourceUri: 'nextclaw://panel-app/encoded-reader',

package/src/features/chat/managers/chat-thread.manager.ts

@@ -347,6 +347,7 @@ export class ChatThreadManager {
       previewViewer: nextViewer,
       line: sourceTab.line ?? undefined,
       column: sourceTab.column ?? undefined,
+      params: sourceTab.params ?? undefined,
       rawText: sourceTab.rawText ?? undefined,
       contentUrl: sourceTab.contentUrl ?? undefined,
       mimeType: sourceTab.mimeType ?? undefined,
@@ -419,6 +420,7 @@ export class ChatThreadManager {
         previewViewer: request.target.payload.viewer,
         line: request.target.payload.line,
         column: request.target.payload.column,
+        params: request.target.payload.params,
       });
       return;
     }

package/src/features/chat/managers/chat-ui.manager.ts

@@ -96,21 +96,27 @@ export class ChatUiManager {
       });
       return;
     }
-    const { appId, path } = target.payload;
+    const { appId, params: contentParams, path } = target.payload;
     if (path) {
       this.docBrowserManager.open(createPanelAppResourceUri(appId, path), {
+        contentParams,
         title,
       });
       return;
     }
     const entry = await this.resolvePanelAppEntry(appId);
     if (entry) {
-      this.docBrowserManager.openTarget(createPanelAppRightPanelResourceTarget(entry), {
-        title,
-      });
+      this.docBrowserManager.openTarget(
+        {
+          ...createPanelAppRightPanelResourceTarget(entry),
+          contentParams,
+        },
+        { title },
+      );
       return;
     }
     this.docBrowserManager.open(createPanelAppResourceUri(appId), {
+      contentParams,
       title,
     });
   };

package/src/features/chat/stores/__tests__/chat-thread.store.test.ts

@@ -60,6 +60,7 @@ describe('chat thread workspace panel persistence', () => {
           label: 'README.md',
           viewMode: 'preview',
           previewViewer: 'rendered',
+          params: { chart: { series: [3, 5, 8] } },
           rawText: '# Hello',
           fullLines: [],
         },
@@ -98,6 +99,9 @@ describe('chat thread workspace panel persistence', () => {
     expect(persisted.state.snapshot.isSending).toBeUndefined();
     expect(persisted.state.snapshot.workspaceFileTabs[0].rawText).toBe('# Hello');
     expect(persisted.state.snapshot.workspaceFileTabs[0].previewViewer).toBe('rendered');
+    expect(persisted.state.snapshot.workspaceFileTabs[0].params).toEqual({
+      chart: { series: [3, 5, 8] },
+    });
     expect(persisted.state.snapshot.workspaceFileTabs[0].fullLines).toBeUndefined();
   });
 

package/src/features/chat/stores/chat-thread.store.ts

@@ -1,7 +1,11 @@
 import { create } from 'zustand';
 import { createJSONStorage, persist } from 'zustand/middleware';
 import type { NcpMessage } from '@nextclaw/ncp';
-import type { ChatFileOperationLineViewModel, ChatFilePreviewViewer } from '@nextclaw/agent-chat-ui';
+import type {
+  ChatContentParams,
+  ChatFileOperationLineViewModel,
+  ChatFilePreviewViewer,
+} from '@nextclaw/agent-chat-ui';
 import type {
   SessionContextWindowView,
   SessionTypeIconView
@@ -38,6 +42,7 @@ export type ChatWorkspaceFileTab = {
   previewViewer?: ChatFilePreviewViewer | null;
   line?: number | null;
   column?: number | null;
+  params?: ChatContentParams | null;
   rawText?: string | null;
   /** Attachment/binary content URL for workspace-native media preview. */
   contentUrl?: string | null;

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": "新任务",