@nextclaw/ui 0.15.18 → 0.15.20

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/hooks/use-projects.ts

@@ -5,10 +5,11 @@ import { t } from "@/shared/lib/i18n";
 
 const PROJECTS_QUERY_KEY = ["projects"] as const;
 
-export function useProjects() {
+export function useProjects(options: { enabled?: boolean } = {}) {
   return useQuery({
     queryKey: PROJECTS_QUERY_KEY,
     queryFn: fetchProjects,
+    enabled: options.enabled ?? true,
     staleTime: 30_000,
   });
 }

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

@@ -200,7 +200,7 @@
   "chatProcessSummaryCancelled": "cancelled",
   "chatRuntimeInitializing": "Chat is still initializing. You can keep typing and send once startup finishes.",
   "chatRuntimeInitializationFailed": "Chat startup failed. Please retry in a moment or inspect the service logs.",
-  "chatInputPlaceholder": "Type a message, / for commands, apps or skills, @ for files, folders or panel apps, Enter to send, Shift + Enter for newline",
+  "chatInputPlaceholder": "Type a message, / for commands, apps or skills, @ for files, folders, projects or panel apps, Enter to send, Shift + Enter for newline",
   "chatInputPlaceholderCompact": "Message NextClaw...",
   "chatInputHint": "Multi-turn context is preserved in the current session.",
   "chatSlashSection": "Slash menu",
@@ -239,15 +239,15 @@
   "chatPanelAppReferenceNoDescription": "No panel app description",
   "chatContextReferenceLoading": "Searching references...",
   "chatContextReferenceSection": "References",
-  "chatContextReferenceNoResult": "No matching files, folders, or panel apps",
-  "chatContextReferenceHint": "Type @ to reference a file, folder, or panel app",
+  "chatContextReferenceNoResult": "No matching files, folders, projects, or panel apps",
+  "chatContextReferenceHint": "Type @ to reference a file, folder, project, or panel app",
   "chatContextReferenceItemHint": "Press Enter to add this reference.",
   "chatContextReferenceFilesLabel": "Files & Folders",
   "chatContextReferenceFilesType": "Project Context",
   "chatContextReferenceFilesDescription": "Search and reference files or folders in the current project.",
   "chatContextReferenceFilesHint": "Press Enter to browse files and folders.",
   "chatContextReferenceBack": "Back to all references",
-  "chatContextReferenceBackDescription": "Return to the unified file, folder, and panel app reference menu.",
+  "chatContextReferenceBackDescription": "Return to the unified file, folder, project, and panel app reference menu.",
   "chatContextReferenceBackHint": "Press Enter to go back.",
   "chatContextReferenceParent": "Up one folder",
   "chatContextReferenceParentDescription": "Browse the parent folder without closing the reference menu.",
@@ -255,6 +255,15 @@
   "chatContextReferenceCurrentDirectory": "Reference current folder",
   "chatContextReferenceFileDescription": "Use this file as explicit context for the current message.",
   "chatContextReferenceDirectoryDescription": "Use this folder as a context scope for the current message.",
+  "chatContextReferenceProjectsLabel": "Projects",
+  "chatContextReferenceProjectsType": "Project Context",
+  "chatContextReferenceProjectsDescription": "Choose a registered project as context for the current message.",
+  "chatContextReferenceProjectsHint": "Press Enter to browse projects.",
+  "chatContextReferenceProjectType": "Project",
+  "chatContextReferenceProjectDescription": "Use this project's name, path, and directory outline as explicit context for the current message.",
+  "chatContextReferenceProjectPath": "Project path",
+  "chatContextReferenceProjectSection": "Projects",
+  "chatContextReferenceProjectsLoadFailed": "Failed to load projects",
   "chatContextReferenceProjectRoot": "Project directory",
   "chatContextReferenceWorkspaceSection": "Files & Folders",
   "chatContextReferenceSearchFailed": "File search failed",
@@ -388,6 +397,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

@@ -200,7 +200,7 @@
   "chatProcessSummaryCancelled": "已取消",
   "chatRuntimeInitializing": "聊天能力正在初始化。你可以先输入内容，完成后即可发送。",
   "chatRuntimeInitializationFailed": "聊天能力启动失败，请稍后重试或检查服务日志。",
-  "chatInputPlaceholder": "输入消息，/ 选命令、应用或技能，@ 引用文件、目录或面板应用，Enter 发送，Shift + Enter 换行",
+  "chatInputPlaceholder": "输入消息，/ 选命令、应用或技能，@ 引用文件、目录、项目或面板应用，Enter 发送，Shift + Enter 换行",
   "chatInputPlaceholderCompact": "发消息...",
   "chatInputHint": "支持多轮上下文，默认走当前会话。",
   "chatSlashSection": "斜杠菜单",
@@ -239,15 +239,15 @@
   "chatPanelAppReferenceNoDescription": "暂无面板应用描述",
   "chatContextReferenceLoading": "搜索引用中…",
   "chatContextReferenceSection": "引用",
-  "chatContextReferenceNoResult": "没有匹配的文件、目录或面板应用",
-  "chatContextReferenceHint": "输入 @ 引用文件、目录或面板应用",
+  "chatContextReferenceNoResult": "没有匹配的文件、目录、项目或面板应用",
+  "chatContextReferenceHint": "输入 @ 引用文件、目录、项目或面板应用",
   "chatContextReferenceItemHint": "回车添加这个引用。",
   "chatContextReferenceFilesLabel": "文件与文件夹",
   "chatContextReferenceFilesType": "项目上下文",
   "chatContextReferenceFilesDescription": "搜索并引用当前项目中的文件或目录。",
   "chatContextReferenceFilesHint": "回车进入文件与文件夹。",
   "chatContextReferenceBack": "返回全部引用",
-  "chatContextReferenceBackDescription": "返回文件、目录和面板应用的统一引用入口。",
+  "chatContextReferenceBackDescription": "返回文件、目录、项目和面板应用的统一引用入口。",
   "chatContextReferenceBackHint": "回车返回。",
   "chatContextReferenceParent": "返回上一级",
   "chatContextReferenceParentDescription": "在不关闭引用菜单的情况下浏览上一级文件夹。",
@@ -255,6 +255,15 @@
   "chatContextReferenceCurrentDirectory": "引用当前文件夹",
   "chatContextReferenceFileDescription": "把这个文件作为本次消息的显式上下文。",
   "chatContextReferenceDirectoryDescription": "把这个目录作为本次消息的上下文范围。",
+  "chatContextReferenceProjectsLabel": "项目",
+  "chatContextReferenceProjectsType": "项目上下文",
+  "chatContextReferenceProjectsDescription": "从已登记项目中选择一个，作为本次消息的上下文。",
+  "chatContextReferenceProjectsHint": "回车进入项目列表。",
+  "chatContextReferenceProjectType": "项目",
+  "chatContextReferenceProjectDescription": "把这个项目的名称、路径和目录概览作为本次消息的显式上下文。",
+  "chatContextReferenceProjectPath": "项目路径",
+  "chatContextReferenceProjectSection": "项目",
+  "chatContextReferenceProjectsLoadFailed": "项目加载失败",
   "chatContextReferenceProjectRoot": "项目目录",
   "chatContextReferenceWorkspaceSection": "文件与文件夹",
   "chatContextReferenceSearchFailed": "文件搜索失败",
@@ -388,6 +397,7 @@
   "chatMessageCopy": "复制",
   "chatMessageCopied": "已复制",
   "chatMermaidDiagram": "图表",
+  "chatMermaidExpand": "放大图表",
   "chatMermaidLoading": "正在渲染图表…",
   "chatMermaidRenderError": "图表无法渲染，已显示源代码",
   "chatSidebarNewTask": "新任务",