@pactor-app/ui 1.22.0 → 1.24.0

package/dist/components/index.cjs

@@ -13240,6 +13240,10 @@ function ChatPage({
   conversationTitle,
   conversationHeaderAction,
   onConversationHeaderAction,
+  conversationRailItems = [],
+  hideArtifactRailItem = false,
+  activeConversationRailKey,
+  onConversationRailChange,
   messages = [],
   sending,
   composerPlaceholder,
@@ -13280,6 +13284,51 @@ function ChatPage({
     if (!controlled) setInnerOpen(next);
     onArtifactOpenChange?.(next);
   };
+  const railControlled = activeConversationRailKey !== void 0;
+  const [activeRailInner, setActiveRailInner] = (0, import_react67.useState)(null);
+  const activeRailKey = railControlled ? activeConversationRailKey : activeRailInner;
+  const setActiveRailKey = (next) => {
+    if (!railControlled) setActiveRailInner(next);
+    onConversationRailChange?.(next);
+  };
+  const visibleRailItems = conversationRailItems.filter((item) => item.hidden !== true);
+  const activeRailItem = visibleRailItems.find(
+    (item) => item.key === activeRailKey
+  );
+  const activePanelItem = activeRailItem?.display === "panel" && activeRailItem.content !== void 0 ? activeRailItem : void 0;
+  const activePopoverItem = activeRailItem !== void 0 && activeRailItem.display !== "panel" && activeRailItem.content !== void 0 ? activeRailItem : void 0;
+  const toggleRailItem = (item) => {
+    const next = activeRailKey === item.key ? null : item.key;
+    if (next !== null && item.display === "panel") {
+      setOpen(false);
+    }
+    setActiveRailKey(next);
+  };
+  const toggleArtifact = () => {
+    if (!open && activePanelItem) {
+      setActiveRailKey(null);
+    }
+    setOpen(!open);
+  };
+  (0, import_react67.useEffect)(() => {
+    if (!activePopoverItem) return;
+    const onKeyDown = (event) => {
+      if (event.key === "Escape") setActiveRailKey(null);
+    };
+    const onPointerDown = (event) => {
+      const target = event.target;
+      if (target.closest("[data-slot=chat-page-rail-popover]") || target.closest("[data-slot=chat-page-conv-rail]")) {
+        return;
+      }
+      setActiveRailKey(null);
+    };
+    document.addEventListener("keydown", onKeyDown);
+    document.addEventListener("mousedown", onPointerDown);
+    return () => {
+      document.removeEventListener("keydown", onKeyDown);
+      document.removeEventListener("mousedown", onPointerDown);
+    };
+  });
   const { renderChildren } = (0, import_runtime26.useRenderer)();
   const renderSlot = (slot) => (0, import_react67.isValidElement)(slot) || typeof slot !== "object" || slot === null ? slot : renderChildren([slot]);
   const convCollControlled = conversationSectionCollapsed !== void 0;
@@ -13311,10 +13360,58 @@ function ChatPage({
       onClick: () => onMenuSelect?.(item.key)
     }
   ) }, item.key);
+  const convRailButton = (item, active, onClick) => {
+    const button = /* @__PURE__ */ (0, import_jsx_runtime185.jsx)(
+      Button2,
+      {
+        icon: item.icon,
+        variant: "text",
+        className: cn(active ? "bg-accent text-accent-foreground" : void 0, "px-2"),
+        onClick
+      }
+    );
+    return item.label !== void 0 ? /* @__PURE__ */ (0, import_jsx_runtime185.jsx)(Tooltip2, { content: item.label, side: "left", children: button }, item.key) : /* @__PURE__ */ (0, import_jsx_runtime185.jsx)("span", { children: button }, item.key);
+  };
+  const convRailVisible = !hideArtifactRailItem || visibleRailItems.length > 0;
+  const convRail = convRailVisible ? /* @__PURE__ */ (0, import_jsx_runtime185.jsxs)(
+    "div",
+    {
+      "data-slot": "chat-page-conv-rail",
+      className: "relative flex w-(--pactor-chat-rail-width) shrink-0 flex-col items-center gap-1 px-1 py-2",
+      children: [
+        !hideArtifactRailItem ? convRailButton(
+          {
+            key: "artifact",
+            icon: open ? "panel-right-close" : "package",
+            label: open ? "\u6536\u8D77\u4EA7\u7269\u533A" : artifactTitle
+          },
+          open,
+          toggleArtifact
+        ) : null,
+        visibleRailItems.map(
+          (item) => convRailButton(item, activeRailKey === item.key, () => toggleRailItem(item))
+        ),
+        activePopoverItem ? /* @__PURE__ */ (0, import_jsx_runtime185.jsx)(
+          "div",
+          {
+            "data-slot": "chat-page-rail-popover",
+            className: "absolute right-full top-0 z-10 mr-2 overflow-auto rounded-lg border border-border bg-popover shadow-md",
+            style: {
+              width: "var(--pactor-chat-rail-popover-width)",
+              maxWidth: "calc(100cqw - 2rem)",
+              maxHeight: "calc(100% - 1rem)"
+            },
+            children: renderSlot(activePopoverItem.content)
+          }
+        ) : null
+      ]
+    }
+  ) : null;
   const chatArea = /* @__PURE__ */ (0, import_jsx_runtime185.jsxs)("div", { "data-slot": "chat-page-conversation", className: "flex h-full min-w-0 flex-1 flex-col", children: [
     /* @__PURE__ */ (0, import_jsx_runtime185.jsxs)(
       "div",
       {
+        "data-slot": "chat-page-conversation-header",
         className: "flex shrink-0 items-center justify-between border-b border-border px-4 py-2.5",
         children: [
           /* @__PURE__ */ (0, import_jsx_runtime185.jsx)(Text, { text: conversationTitle, strong: true }),
@@ -13326,66 +13423,62 @@ function ChatPage({
               variant: "text",
               onClick: () => onConversationHeaderAction?.()
             }
-          ) }) : /* @__PURE__ */ (0, import_jsx_runtime185.jsx)(Tooltip2, { content: open ? "\u6536\u8D77\u4EA7\u7269\u533A" : artifactTitle, side: "bottom", children: /* @__PURE__ */ (0, import_jsx_runtime185.jsx)(
-            Button2,
-            {
-              icon: open ? "panel-right-close" : "panel-right-open",
-              variant: "text",
-              onClick: () => setOpen(!open)
-            }
-          ) })
+          ) }) : null
         ]
       }
     ),
-    /* @__PURE__ */ (0, import_jsx_runtime185.jsxs)(
-      "div",
-      {
-        "data-slot": "chat-page-conversation-body",
-        className: "mx-auto flex min-h-0 w-[61.8cqw] max-w-full flex-1 flex-col",
-        children: [
-          messages.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime185.jsx)(
-            Welcome,
-            {
-              title: welcome?.title,
-              description: welcome?.description,
-              prompts: welcome?.prompts,
-              style: { flex: 1 },
-              onSelect: (value) => onSend?.(value)
-            }
-          ) : /* @__PURE__ */ (0, import_jsx_runtime185.jsx)(
-            MessageList,
-            {
-              messages,
-              className: "scrollbar-subtle",
-              style: { flex: 1, minHeight: 0, padding: 16 },
-              onAction: onMessageAction,
-              onOpenArtifacts: () => setOpen(true)
-            }
-          ),
-          /* @__PURE__ */ (0, import_jsx_runtime185.jsx)(
-            Composer,
-            {
-              placeholder: composerPlaceholder,
-              loading: sending,
-              models,
-              model,
-              contexts,
-              contextItems,
-              attachments,
-              footer: composerFooter,
-              style: { padding: 16, paddingBottom: composerBottom ? 8 : 16, flexShrink: 0 },
-              onModelChange,
-              onContextItemsChange,
-              onAttachFiles,
-              onRemoveAttachment,
-              onRetryAttachment,
-              onSubmit: (text) => onSend?.(text)
-            }
-          ),
-          composerBottom ? /* @__PURE__ */ (0, import_jsx_runtime185.jsx)("div", { "data-slot": "chat-page-composer-bottom", className: "shrink-0 px-4 pb-2 text-center", children: renderSlot(composerBottom) }) : null
-        ]
-      }
-    )
+    /* @__PURE__ */ (0, import_jsx_runtime185.jsxs)("div", { className: "flex min-h-0 flex-1", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime185.jsxs)(
+        "div",
+        {
+          "data-slot": "chat-page-conversation-body",
+          className: "mx-auto flex min-h-0 w-[61.8cqw] max-w-full flex-col",
+          children: [
+            messages.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime185.jsx)(
+              Welcome,
+              {
+                title: welcome?.title,
+                description: welcome?.description,
+                prompts: welcome?.prompts,
+                style: { flex: 1 },
+                onSelect: (value) => onSend?.(value)
+              }
+            ) : /* @__PURE__ */ (0, import_jsx_runtime185.jsx)(
+              MessageList,
+              {
+                messages,
+                className: "scrollbar-subtle",
+                style: { flex: 1, minHeight: 0, padding: 16 },
+                onAction: onMessageAction,
+                onOpenArtifacts: () => setOpen(true)
+              }
+            ),
+            /* @__PURE__ */ (0, import_jsx_runtime185.jsx)(
+              Composer,
+              {
+                placeholder: composerPlaceholder,
+                loading: sending,
+                models,
+                model,
+                contexts,
+                contextItems,
+                attachments,
+                footer: composerFooter,
+                style: { padding: 16, paddingBottom: composerBottom ? 8 : 16, flexShrink: 0 },
+                onModelChange,
+                onContextItemsChange,
+                onAttachFiles,
+                onRemoveAttachment,
+                onRetryAttachment,
+                onSubmit: (text) => onSend?.(text)
+              }
+            ),
+            composerBottom ? /* @__PURE__ */ (0, import_jsx_runtime185.jsx)("div", { "data-slot": "chat-page-composer-bottom", className: "shrink-0 px-4 pb-2 text-center", children: renderSlot(composerBottom) }) : null
+          ]
+        }
+      ),
+      convRail
+    ] })
   ] });
   const activeArtifact = artifacts.find((item) => item.id === activeArtifactId) ?? (activeArtifactId === void 0 || activeArtifactId === "" ? artifacts[artifacts.length - 1] : void 0);
   const artifactPanel = /* @__PURE__ */ (0, import_jsx_runtime185.jsx)(
@@ -13517,10 +13610,17 @@ function ChatPage({
             ]
           }
         ),
-        /* @__PURE__ */ (0, import_jsx_runtime185.jsx)("div", { className: "@container h-full min-w-0 flex-1", children: open ? /* @__PURE__ */ (0, import_jsx_runtime185.jsxs)(PanelGroup, { orientation: "horizontal", style: { width: "100%", height: "100%" }, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime185.jsx)("div", { className: "@container h-full min-w-0 flex-1", children: open || activePanelItem ? /* @__PURE__ */ (0, import_jsx_runtime185.jsxs)(PanelGroup, { orientation: "horizontal", style: { width: "100%", height: "100%" }, children: [
           /* @__PURE__ */ (0, import_jsx_runtime185.jsx)(Panel, { defaultSize: "62%", children: chatArea }),
           /* @__PURE__ */ (0, import_jsx_runtime185.jsx)(ResizableHandle, { withHandle: true }),
-          /* @__PURE__ */ (0, import_jsx_runtime185.jsx)(Panel, { defaultSize: "38%", minSize: "380px", maxSize: "760px", children: artifactPanel })
+          /* @__PURE__ */ (0, import_jsx_runtime185.jsx)(Panel, { defaultSize: "38%", minSize: "380px", maxSize: "760px", children: activePanelItem ? /* @__PURE__ */ (0, import_jsx_runtime185.jsx)(
+            "div",
+            {
+              "data-slot": "chat-page-rail-panel",
+              className: "flex h-full min-w-0 flex-col border-l border-border bg-muted",
+              children: renderSlot(activePanelItem.content)
+            }
+          ) : artifactPanel })
         ] }) : chatArea })
       ]
     }
@@ -13660,10 +13760,10 @@ function EChartBase({
         dataIndex: params.dataIndex
       });
     });
-    const observer = new ResizeObserver(() => chart?.resize());
-    observer.observe(host);
+    const observer2 = new ResizeObserver(() => chart?.resize());
+    observer2.observe(host);
     return () => {
-      observer.disconnect();
+      observer2.disconnect();
       chart?.dispose();
       chartRef.current = null;
     };
@@ -14124,6 +14224,9 @@ function buildComposedOption(input, theme) {
   };
 }
 
+// src/components/chart/lib/use-chart-theme.ts
+var import_react69 = require("react");
+
 // src/components/chart/lib/color.ts
 var LPAREN = String.fromCharCode(40);
 var RPAREN = String.fromCharCode(41);
@@ -14220,6 +14323,64 @@ function getChartTheme() {
     return FALLBACK_THEME;
   }
 }
+function resetChartTheme() {
+  cached = null;
+}
+var CHART_SKIN_CHANGE_EVENT = "pactor:skin-change";
+var listeners = /* @__PURE__ */ new Set();
+var observer = null;
+var scheduled = false;
+function scheduleNotify() {
+  if (scheduled) return;
+  scheduled = true;
+  const enqueue = typeof requestAnimationFrame === "function" ? requestAnimationFrame : (cb) => setTimeout(cb, 0);
+  enqueue(() => {
+    scheduled = false;
+    resetChartTheme();
+    for (const listener of [...listeners]) {
+      listener();
+    }
+  });
+}
+function handleResourceLoad(event) {
+  const target = event.target;
+  if (target instanceof HTMLLinkElement || target instanceof HTMLStyleElement) {
+    scheduleNotify();
+  }
+}
+function subscribeChartTheme(listener) {
+  if (typeof document === "undefined" || typeof MutationObserver === "undefined") {
+    return () => {
+    };
+  }
+  listeners.add(listener);
+  if (!observer) {
+    observer = new MutationObserver(scheduleNotify);
+    observer.observe(document.documentElement, { attributes: true });
+    observer.observe(document.head, {
+      attributes: true,
+      childList: true,
+      characterData: true,
+      subtree: true
+    });
+    document.addEventListener("load", handleResourceLoad, true);
+    window.addEventListener(CHART_SKIN_CHANGE_EVENT, scheduleNotify);
+  }
+  return () => {
+    listeners.delete(listener);
+    if (listeners.size === 0 && observer) {
+      observer.disconnect();
+      observer = null;
+      document.removeEventListener("load", handleResourceLoad, true);
+      window.removeEventListener(CHART_SKIN_CHANGE_EVENT, scheduleNotify);
+    }
+  };
+}
+
+// src/components/chart/lib/use-chart-theme.ts
+function useChartTheme() {
+  return (0, import_react69.useSyncExternalStore)(subscribeChartTheme, getChartTheme, getChartTheme);
+}
 
 // src/components/chart/AreaChart/index.tsx
 var import_jsx_runtime189 = require("react/jsx-runtime");
@@ -14238,7 +14399,7 @@ function AreaChart({
 }) {
   const option = buildAreaOption(
     { data, xKey, yKeys, stacked, fillOpacity, colors, title },
-    getChartTheme()
+    useChartTheme()
   );
   return /* @__PURE__ */ (0, import_jsx_runtime189.jsx)(
     EChartBase,
@@ -14269,7 +14430,7 @@ function BarChart2({
 }) {
   const option = buildBarOption(
     { data, yKey, yKeys: xKeys, stacked, colors, title },
-    getChartTheme()
+    useChartTheme()
   );
   return /* @__PURE__ */ (0, import_jsx_runtime190.jsx)(
     EChartBase,
@@ -14301,7 +14462,7 @@ function BubbleChart({
 }) {
   const option = buildBubbleOption(
     { data, xKey, yKey, sizeKey, seriesKey, colors, title },
-    getChartTheme()
+    useChartTheme()
   );
   return /* @__PURE__ */ (0, import_jsx_runtime191.jsx)(
     EChartBase,
@@ -14332,7 +14493,7 @@ function ColumnChart({
 }) {
   const option = buildColumnOption(
     { data, xKey, yKeys, stacked, colors, title },
-    getChartTheme()
+    useChartTheme()
   );
   return /* @__PURE__ */ (0, import_jsx_runtime192.jsx)(
     EChartBase,
@@ -14362,7 +14523,7 @@ function ComposedChart({
 }) {
   const option = buildComposedOption(
     { data, xKey, series, colors, title },
-    getChartTheme()
+    useChartTheme()
   );
   return /* @__PURE__ */ (0, import_jsx_runtime193.jsx)(
     EChartBase,
@@ -14408,7 +14569,7 @@ function DonutChart({
       colors,
       title
     },
-    getChartTheme()
+    useChartTheme()
   );
   return /* @__PURE__ */ (0, import_jsx_runtime194.jsx)(
     EChartBase,
@@ -14439,7 +14600,7 @@ function FunnelChart2({
 }) {
   const option = buildFunnelOption(
     { data, nameKey, valueKey, sort, colors, title },
-    getChartTheme()
+    useChartTheme()
   );
   return /* @__PURE__ */ (0, import_jsx_runtime195.jsx)(
     EChartBase,
@@ -14470,7 +14631,7 @@ function GaugeChart2({
 }) {
   const option = buildGaugeOption(
     { value, min, max, thresholds, unit, title },
-    getChartTheme()
+    useChartTheme()
   );
   return /* @__PURE__ */ (0, import_jsx_runtime196.jsx)(
     EChartBase,
@@ -14500,7 +14661,7 @@ function Heatmap({
 }) {
   const option = buildHeatmapOption(
     { data, xKey, yKey, valueKey, title },
-    getChartTheme()
+    useChartTheme()
   );
   return /* @__PURE__ */ (0, import_jsx_runtime197.jsx)(
     EChartBase,
@@ -14533,7 +14694,7 @@ function LineChart2({
 }) {
   const option = buildLineOption(
     { data, xKey, yKeys, smooth, showArea, stacked, colors, title },
-    getChartTheme()
+    useChartTheme()
   );
   return /* @__PURE__ */ (0, import_jsx_runtime198.jsx)(
     EChartBase,
@@ -14549,7 +14710,7 @@ function LineChart2({
 }
 
 // src/components/chart/MapChart/index.tsx
-var import_react69 = require("react");
+var import_react70 = require("react");
 var import_jsx_runtime199 = require("react/jsx-runtime");
 var fetchedMaps = /* @__PURE__ */ new Set();
 function hasRegisteredMap(mapName) {
@@ -14572,7 +14733,8 @@ function MapChart2({
   className,
   style
 }) {
-  const [loadState, setLoadState] = (0, import_react69.useState)(
+  const theme = useChartTheme();
+  const [loadState, setLoadState] = (0, import_react70.useState)(
     () => geoJson || !geoJsonUrl || hasRegisteredMap(mapName) ? "idle" : "loading"
   );
   if (geoJson) {
@@ -14581,7 +14743,7 @@ function MapChart2({
     } catch {
     }
   }
-  (0, import_react69.useEffect)(() => {
+  (0, import_react70.useEffect)(() => {
     if (geoJson || !geoJsonUrl || hasRegisteredMap(mapName) || fetchedMaps.has(mapName)) {
       setLoadState("idle");
       return;
@@ -14638,7 +14800,7 @@ function MapChart2({
       }
     );
   }
-  const option = buildMapOption({ mapName, data, nameKey, valueKey, title }, getChartTheme());
+  const option = buildMapOption({ mapName, data, nameKey, valueKey, title }, theme);
   return /* @__PURE__ */ (0, import_jsx_runtime199.jsx)(
     EChartBase,
     {
@@ -14725,7 +14887,7 @@ function PieChart2({
 }) {
   const option = buildPieOption(
     { data, nameKey, valueKey, showLabel, colors, title },
-    getChartTheme()
+    useChartTheme()
   );
   return /* @__PURE__ */ (0, import_jsx_runtime201.jsx)(
     EChartBase,
@@ -14755,7 +14917,7 @@ function RadarChart2({
 }) {
   const option = buildRadarOption(
     { data, indicatorKey, yKeys, colors, title },
-    getChartTheme()
+    useChartTheme()
   );
   return /* @__PURE__ */ (0, import_jsx_runtime202.jsx)(
     EChartBase,
@@ -14781,7 +14943,7 @@ function SankeyChart2({
   className,
   style
 }) {
-  const option = buildSankeyOption({ nodes, links, title }, getChartTheme());
+  const option = buildSankeyOption({ nodes, links, title }, useChartTheme());
   return /* @__PURE__ */ (0, import_jsx_runtime203.jsx)(
     EChartBase,
     {
@@ -14811,7 +14973,7 @@ function ScatterChart2({
 }) {
   const option = buildScatterOption(
     { data, xKey, yKey, seriesKey, colors, title },
-    getChartTheme()
+    useChartTheme()
   );
   return /* @__PURE__ */ (0, import_jsx_runtime204.jsx)(
     EChartBase,
@@ -14841,7 +15003,7 @@ function TreeChart2({
 }) {
   const option = buildTreeOption(
     { data, title, orient, edgeShape, initialTreeDepth },
-    getChartTheme()
+    useChartTheme()
   );
   return /* @__PURE__ */ (0, import_jsx_runtime205.jsx)(
     EChartBase,

package/dist/components/index.d.cts

@@ -3381,6 +3381,20 @@ interface ChatPageMenuItem {
     /** 图标名（Icon 白名单） */
     icon?: string;
 }
+/** 对话图标栏项：点击 toggle 展示当前对话的附加内容（产物 / 执行步骤等） */
+interface ConversationRailItem {
+    key: string;
+    /** 提示文案（hover tooltip） */
+    label?: string;
+    /** 图标名（Icon 白名单） */
+    icon?: string;
+    /** 呈现形态：popover（图标栏旁悬浮弹框，缺省）/ panel（产物栏式右侧固定宽栏） */
+    display?: 'panel' | 'popover';
+    /** 附加内容（React 元素或 DslNode；缺省时点击仅触发状态事件，不渲染内容层） */
+    content?: DslNode | ReactNode;
+    /** 隐藏该项（如按当前会话有无对应内容动态显隐）；隐藏时激活态一并失效 */
+    hidden?: boolean;
+}
 /** 品牌区（展开菜单区标题 / 版本） */
 interface ChatPageBrand {
     title: string;
@@ -3436,9 +3450,8 @@ interface ChatPageProps {
     /** 对话区头部标题（通常为当前会话标题） */
     conversationTitle?: string;
     /**
-     * 对话区头部右侧自定义操作（图标 + 提示）；提供时替换缺省的产物区
-     * 开关钮，点击经 onConversationHeaderAction 传出（产物区开关可经
-     * 受控 artifactOpen + onArtifactOpenChange 自行接线）
+     * 对话区头部右侧自定义操作（图标 + 提示）；提供才渲染（未配置时
+     * header 不渲染任何按钮），点击经 onConversationHeaderAction 传出
      */
     conversationHeaderAction?: {
         icon?: string;
@@ -3447,6 +3460,17 @@ interface ChatPageProps {
     };
     /** 对话区头部右侧自定义操作点击事件 */
     onConversationHeaderAction?: () => void;
+    /**
+     * 对话图标栏附加项（header 下方、对话区右缘纵向排列，产物内置项
+     * 之后按序展示）；点击 toggle 展示对应附加内容
+     */
+    conversationRailItems?: ConversationRailItem[];
+    /** 隐藏图标栏内置产物入口（缺省 false：产物开关为图标栏首项） */
+    hideArtifactRailItem?: boolean;
+    /** 图标栏激活项 key（提供即受控，配合 onConversationRailChange 闭环；null 为全部收起） */
+    activeConversationRailKey?: string | null;
+    /** 图标栏激活项变化事件，传出 key 或 null */
+    onConversationRailChange?: (key: string | null) => void;
     messages?: MessageListItem[];
     /** 发送中（禁用 Composer 发送钮，由调用方完成后复位） */
     sending?: boolean;
@@ -3526,13 +3550,16 @@ interface ChatPageProps {
  * 行内提及（contexts：输入触发符在光标处弹菜单，选中替换为行内提及块，
  * 退格整体删除；受控 contextItems）、附件
  * 入口（onAttachFiles + 受控 attachments）与 composerFooter /
- * composerBottom 槽位）、最右产物区（ArtifactPanel：内建产物预览、
+ * composerBottom 槽位）、对话图标栏（header 下方、对话区右缘纵向
+ * 图标列：内置产物入口 + conversationRailItems 附加项，点击 toggle
+ * 展示附加内容——popover 悬浮弹框或 panel 右侧分栏，与产物区互斥）、
+ * 最右产物区（ArtifactPanel：内建产物预览、
  * 目录树与下载，可显隐；展示时经 Resizable 拖拽调节与对话区的宽度）。
  * 数据与行为全部经 props / events 进出，
- * 本组件不持有业务状态（产物区开关与分区折叠缺省非受控，均可经
- * 受控 prop + change 事件闭环）。
+ * 本组件不持有业务状态（产物区开关、图标栏激活项与分区折叠缺省非受控，
+ * 均可经受控 prop + change 事件闭环）。
  */
-declare function ChatPage({ brand, menuItems, activeMenuKey, railItems, railFooterItems, menuAction, onMenuSelect, onMenuAction, conversationSectionTitle, conversationSectionCollapsed, defaultConversationSectionCollapsed, onConversationSectionToggle, conversations, activeConversationId, onSelectConversation, onDeleteConversation, moreLabel, onMore, footerSectionTitle, footerItems, footerSectionCollapsed, defaultFooterSectionCollapsed, onFooterSectionToggle, conversationTitle, conversationHeaderAction, onConversationHeaderAction, messages, sending, composerPlaceholder, welcome, onSend, onMessageAction, models, model, onModelChange, contexts, contextItems, onContextItemsChange, attachments, onAttachFiles, onRemoveAttachment, onRetryAttachment, composerFooter, composerBottom, artifactTitle, artifacts, activeArtifactId, onSelectArtifact, artifactEmptyText, safeRegistry, user, artifactViewers, onDownloadArtifact, artifactOpen, defaultArtifactOpen, onArtifactOpenChange, className, style, }: ChatPageProps): React.JSX.Element;
+declare function ChatPage({ brand, menuItems, activeMenuKey, railItems, railFooterItems, menuAction, onMenuSelect, onMenuAction, conversationSectionTitle, conversationSectionCollapsed, defaultConversationSectionCollapsed, onConversationSectionToggle, conversations, activeConversationId, onSelectConversation, onDeleteConversation, moreLabel, onMore, footerSectionTitle, footerItems, footerSectionCollapsed, defaultFooterSectionCollapsed, onFooterSectionToggle, conversationTitle, conversationHeaderAction, onConversationHeaderAction, conversationRailItems, hideArtifactRailItem, activeConversationRailKey, onConversationRailChange, messages, sending, composerPlaceholder, welcome, onSend, onMessageAction, models, model, onModelChange, contexts, contextItems, onContextItemsChange, attachments, onAttachFiles, onRemoveAttachment, onRetryAttachment, composerFooter, composerBottom, artifactTitle, artifacts, activeArtifactId, onSelectArtifact, artifactEmptyText, safeRegistry, user, artifactViewers, onDownloadArtifact, artifactOpen, defaultArtifactOpen, onArtifactOpenChange, className, style, }: ChatPageProps): React.JSX.Element;
 
 /** 引用来源项 */
 interface CitationItem {
@@ -4444,4 +4471,4 @@ interface FormContextValue {
 /** 在字段组件内探测 Form 上下文；不在 Form 内时返回 null */
 declare function useFormContext(): FormContextValue | null;
 
-export { Accordion, type AccordionItemData, type AccordionProps, Affix, type AffixProps, AgentStatus, type AgentStatusProps, type AgentStatusType, Alert, AlertDialog, type AlertDialogProps, type AlertProps, type AlertVariant, Anchor, type AnchorItemData, type AnchorProps, AreaChart, type AreaChartProps, ArtifactPanel, type ArtifactPanelProps, type ArtifactTreeNode, type ArtifactViewer, type ArtifactViewers, AspectRatio, type AspectRatioProps, Attachment, type AttachmentItemData, type AttachmentProps, Audio, type AudioProps, Avatar, type AvatarProps, BackTop, type BackTopProps, Badge, type BadgeProps, type BadgeVariant, BarChart, type BarChartProps, Breadcrumb, type BreadcrumbItemData, type BreadcrumbProps, Bubble, BubbleChart, type BubbleChartProps, type BubbleProps, type BubbleVariant, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type ButtonSize, type ButtonVariant, Calendar, type CalendarProps, Card, type CardProps, Carousel, type CarouselImage, type CarouselItemData, type CarouselProps, Cascader, type CascaderOption, type CascaderProps, type ChartSelectPayload, ChatInput, type ChatInputProps, ChatMessage, type ChatMessageActionItem, type ChatMessageAgent, type ChatMessagePart, type ChatMessageProps, type ChatMessageStatus, ChatPage, type ChatPageArtifact, type ChatPageBrand, type ChatPageMenuItem, type ChatPageProps, Checkbox, type CheckboxProps, Citation, type CitationItem, type CitationProps, CodeBlock, type CodeBlockProps, Collapsible, type CollapsibleProps, ColorPicker, type ColorPickerProps, ColumnChart, type ColumnChartProps, Combobox, type ComboboxOption, type ComboboxProps, Command, type CommandGroupData, type CommandItemData, type CommandProps, ComposedChart, type ComposedChartProps, type ComposedSeriesItem, Composer, type ComposerContextItem, type ComposerContextSource, type ComposerModelOption, type ComposerProps, Container, type ContainerProps, type ContainerSize, Content, type ContentProps, ContextMenu, type ContextMenuItemData, type ContextMenuProps, type ConversationItemData, ConversationList, type ConversationListProps, DataTable, type DataTableColumn, type DataTablePagination, type DataTableProps, type DataTableSort, type DataTableSortOrder, DatePicker, type DatePickerPreset, type DatePickerPresetKey, type DatePickerProps, type DatePickerRangeProps, type DatePickerSingleProps, type DateRangeValue, Descriptions, type DescriptionsItemData, type DescriptionsProps, Dialog, type DialogProps, DiffViewer, type DiffViewerProps, type DocumentPageData, DocumentPreview, type DocumentPreviewProps, DonutChart, type DonutChartProps, Drawer, type DrawerPlacement, type DrawerProps, DropdownMenu, type DropdownMenuItemData, type DropdownMenuProps, EChartBase, type EChartBaseProps, Empty, type EmptyProps, Field, type FieldProps, type FieldRule, FilePreview, type FilePreviewKind, type FilePreviewProps, Flex, type FlexProps, Footer, type FooterProps, Form, type FormContextValue, type FormProps, FunnelChart, type FunnelChartProps, Gallery, type GalleryItemData, type GalleryProps, GaugeChart, type GaugeChartProps, Grid, type GridProps, Header, type HeaderBrandPosition, type HeaderDropdown, type HeaderDropdownItem, type HeaderLocale, type HeaderMenuItem, type HeaderProps, type HeaderTheme, type HeaderUser, type HeaderUserItem, Heatmap, type HeatmapProps, HoverCard, type HoverCardProps, ICONS, Icon, type IconProps, type IconSize, Image, ImageLightbox, type ImageLightboxProps, type ImageProps, ImageViewer, type ImageViewerProps, Input, InputGroup, type InputGroupProps, InputOTP, type InputOTPProps, type InputProps, Item, type ItemProps, JSONViewer, type JSONViewerProps, Kbd, type KbdProps, Label, type LabelProps, Layout, type LayoutProps, LineChart, type LineChartProps, Link, type LinkProps, List, type ListItemData, type ListProps, LoadingOverlay, type LoadingOverlayProps, MapChart, type MapChartProps, type MentionOption, Mentions, type MentionsProps, Menu, type MenuItem, type MenuProps, Menubar, type MenubarLeafItem, type MenubarMenuData, type MenubarProps, Message, MessageList, type MessageListItem, type MessageListProps, type MessageProps, MetricCard, type MetricCardProps, NavigationMenu, type NavigationMenuChildItem, type NavigationMenuItemData, type NavigationMenuProps, Notification, type NotificationProps, NumberInput, type NumberInputProps, Page, type PageProps, Pagination, type PaginationProps, PieChart, type PieChartProps, Popconfirm, type PopconfirmProps, Popover, type PopoverProps, Progress, type ProgressProps, Prompt, type PromptProps, QRCode, type QRCodeProps, RadarChart, type RadarChartProps, RadioGroup, type RadioGroupOption, type RadioGroupProps, RailTooltip, Rate, type RateProps, Resizable, type ResizablePanelData, type ResizableProps, Result, type ResultProps, type ResultStatus, RichText, type RichTextProps, SankeyChart, type SankeyChartProps, ScatterChart, type ScatterChartProps, ScrollArea, type ScrollAreaProps, Segmented, type SegmentedOption, type SegmentedProps, Select, type SelectOption, type SelectProps, Sender, type SenderProps, Separator, type SeparatorProps, Sheet, type SheetProps, type SheetSide, Sidebar, type SidebarBrand, type SidebarNavItem, type SidebarProps, Sider, type SiderProps, Skeleton, type SkeletonProps, type SkeletonShape, Slider, type SliderProps, Sonner, type SonnerProps, Space, type SpaceProps, Spinner, type SpinnerProps, type SpinnerSize, Statistic, type StatisticProps, Status, type StatusProps, type StatusType, type StepItemData, type StepStatus, Steps, type StepsProps, StreamingText, type StreamingTextProps, Suggestion, type SuggestionItem, type SuggestionProps, Switch, type SwitchProps, type TabItem, Table, type TableColumn, type TablePagination, type TablePaginationInfo, type TableProps, Tabs, type TabsProps, Tag, type TagColor, type TagProps, Text, type TextProps, type TextType, Textarea, type TextareaProps, Thinking, type ThinkingProps, type ThinkingStatus, TimePicker, type TimePickerProps, Timeline, type TimelineItemData, type TimelineProps, Toggle, ToggleGroup, type ToggleGroupOption, type ToggleGroupProps, type ToggleProps, ToolCall, type ToolCallProps, type ToolCallStatus, Tooltip, type TooltipProps, Tour, type TourProps, type TourStep, Transfer, type TransferOption, type TransferProps, Tree, TreeChart, type TreeChartProps, type TreeNodeData, type TreeProps, TreeSelect, type TreeSelectOption, type TreeSelectProps, Typography, type TypographyProps, type TypographyVariant, Upload, type UploadFileMeta, type UploadProps, Video, type VideoProps, Watermark, type WatermarkProps, Welcome, type WelcomePromptItem, type WelcomeProps, buildArtifactTree, builtinComponents, createComponentRegistry, diffLines, inferKind, normalizeIconName, registerBuiltinComponents, useFormContext, useSidebarDrawer };
+export { Accordion, type AccordionItemData, type AccordionProps, Affix, type AffixProps, AgentStatus, type AgentStatusProps, type AgentStatusType, Alert, AlertDialog, type AlertDialogProps, type AlertProps, type AlertVariant, Anchor, type AnchorItemData, type AnchorProps, AreaChart, type AreaChartProps, ArtifactPanel, type ArtifactPanelProps, type ArtifactTreeNode, type ArtifactViewer, type ArtifactViewers, AspectRatio, type AspectRatioProps, Attachment, type AttachmentItemData, type AttachmentProps, Audio, type AudioProps, Avatar, type AvatarProps, BackTop, type BackTopProps, Badge, type BadgeProps, type BadgeVariant, BarChart, type BarChartProps, Breadcrumb, type BreadcrumbItemData, type BreadcrumbProps, Bubble, BubbleChart, type BubbleChartProps, type BubbleProps, type BubbleVariant, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type ButtonSize, type ButtonVariant, Calendar, type CalendarProps, Card, type CardProps, Carousel, type CarouselImage, type CarouselItemData, type CarouselProps, Cascader, type CascaderOption, type CascaderProps, type ChartSelectPayload, ChatInput, type ChatInputProps, ChatMessage, type ChatMessageActionItem, type ChatMessageAgent, type ChatMessagePart, type ChatMessageProps, type ChatMessageStatus, ChatPage, type ChatPageArtifact, type ChatPageBrand, type ChatPageMenuItem, type ChatPageProps, Checkbox, type CheckboxProps, Citation, type CitationItem, type CitationProps, CodeBlock, type CodeBlockProps, Collapsible, type CollapsibleProps, ColorPicker, type ColorPickerProps, ColumnChart, type ColumnChartProps, Combobox, type ComboboxOption, type ComboboxProps, Command, type CommandGroupData, type CommandItemData, type CommandProps, ComposedChart, type ComposedChartProps, type ComposedSeriesItem, Composer, type ComposerContextItem, type ComposerContextSource, type ComposerModelOption, type ComposerProps, Container, type ContainerProps, type ContainerSize, Content, type ContentProps, ContextMenu, type ContextMenuItemData, type ContextMenuProps, type ConversationItemData, ConversationList, type ConversationListProps, type ConversationRailItem, DataTable, type DataTableColumn, type DataTablePagination, type DataTableProps, type DataTableSort, type DataTableSortOrder, DatePicker, type DatePickerPreset, type DatePickerPresetKey, type DatePickerProps, type DatePickerRangeProps, type DatePickerSingleProps, type DateRangeValue, Descriptions, type DescriptionsItemData, type DescriptionsProps, Dialog, type DialogProps, DiffViewer, type DiffViewerProps, type DocumentPageData, DocumentPreview, type DocumentPreviewProps, DonutChart, type DonutChartProps, Drawer, type DrawerPlacement, type DrawerProps, DropdownMenu, type DropdownMenuItemData, type DropdownMenuProps, EChartBase, type EChartBaseProps, Empty, type EmptyProps, Field, type FieldProps, type FieldRule, FilePreview, type FilePreviewKind, type FilePreviewProps, Flex, type FlexProps, Footer, type FooterProps, Form, type FormContextValue, type FormProps, FunnelChart, type FunnelChartProps, Gallery, type GalleryItemData, type GalleryProps, GaugeChart, type GaugeChartProps, Grid, type GridProps, Header, type HeaderBrandPosition, type HeaderDropdown, type HeaderDropdownItem, type HeaderLocale, type HeaderMenuItem, type HeaderProps, type HeaderTheme, type HeaderUser, type HeaderUserItem, Heatmap, type HeatmapProps, HoverCard, type HoverCardProps, ICONS, Icon, type IconProps, type IconSize, Image, ImageLightbox, type ImageLightboxProps, type ImageProps, ImageViewer, type ImageViewerProps, Input, InputGroup, type InputGroupProps, InputOTP, type InputOTPProps, type InputProps, Item, type ItemProps, JSONViewer, type JSONViewerProps, Kbd, type KbdProps, Label, type LabelProps, Layout, type LayoutProps, LineChart, type LineChartProps, Link, type LinkProps, List, type ListItemData, type ListProps, LoadingOverlay, type LoadingOverlayProps, MapChart, type MapChartProps, type MentionOption, Mentions, type MentionsProps, Menu, type MenuItem, type MenuProps, Menubar, type MenubarLeafItem, type MenubarMenuData, type MenubarProps, Message, MessageList, type MessageListItem, type MessageListProps, type MessageProps, MetricCard, type MetricCardProps, NavigationMenu, type NavigationMenuChildItem, type NavigationMenuItemData, type NavigationMenuProps, Notification, type NotificationProps, NumberInput, type NumberInputProps, Page, type PageProps, Pagination, type PaginationProps, PieChart, type PieChartProps, Popconfirm, type PopconfirmProps, Popover, type PopoverProps, Progress, type ProgressProps, Prompt, type PromptProps, QRCode, type QRCodeProps, RadarChart, type RadarChartProps, RadioGroup, type RadioGroupOption, type RadioGroupProps, RailTooltip, Rate, type RateProps, Resizable, type ResizablePanelData, type ResizableProps, Result, type ResultProps, type ResultStatus, RichText, type RichTextProps, SankeyChart, type SankeyChartProps, ScatterChart, type ScatterChartProps, ScrollArea, type ScrollAreaProps, Segmented, type SegmentedOption, type SegmentedProps, Select, type SelectOption, type SelectProps, Sender, type SenderProps, Separator, type SeparatorProps, Sheet, type SheetProps, type SheetSide, Sidebar, type SidebarBrand, type SidebarNavItem, type SidebarProps, Sider, type SiderProps, Skeleton, type SkeletonProps, type SkeletonShape, Slider, type SliderProps, Sonner, type SonnerProps, Space, type SpaceProps, Spinner, type SpinnerProps, type SpinnerSize, Statistic, type StatisticProps, Status, type StatusProps, type StatusType, type StepItemData, type StepStatus, Steps, type StepsProps, StreamingText, type StreamingTextProps, Suggestion, type SuggestionItem, type SuggestionProps, Switch, type SwitchProps, type TabItem, Table, type TableColumn, type TablePagination, type TablePaginationInfo, type TableProps, Tabs, type TabsProps, Tag, type TagColor, type TagProps, Text, type TextProps, type TextType, Textarea, type TextareaProps, Thinking, type ThinkingProps, type ThinkingStatus, TimePicker, type TimePickerProps, Timeline, type TimelineItemData, type TimelineProps, Toggle, ToggleGroup, type ToggleGroupOption, type ToggleGroupProps, type ToggleProps, ToolCall, type ToolCallProps, type ToolCallStatus, Tooltip, type TooltipProps, Tour, type TourProps, type TourStep, Transfer, type TransferOption, type TransferProps, Tree, TreeChart, type TreeChartProps, type TreeNodeData, type TreeProps, TreeSelect, type TreeSelectOption, type TreeSelectProps, Typography, type TypographyProps, type TypographyVariant, Upload, type UploadFileMeta, type UploadProps, Video, type VideoProps, Watermark, type WatermarkProps, Welcome, type WelcomePromptItem, type WelcomeProps, buildArtifactTree, builtinComponents, createComponentRegistry, diffLines, inferKind, normalizeIconName, registerBuiltinComponents, useFormContext, useSidebarDrawer };