@pactor-app/chat 1.0.0 → 1.2.0

package/dist/index.d.cts

@@ -655,6 +655,11 @@ declare function useChatAutoScroll({ messageCount, lastContentLength, isStreamin
  * 数据以接口注入：greeting / subtitle / suggestions 均为受控 props；
  * 点击建议经 `onSuggestionClick` 回调交还调用方（ChatView 接入时
  * 复用 Composer 的同一条发送路径）。
+ *
+ * chrome DSL 渲染层（spec: chat-chrome-dsl）：元素层在页面运行时内
+ * 优先经 ChromeSlot 以宿主组件（Typography / Text / Button）DSL 组合
+ * 渲染，建议点击经 chat.sendSuggestion 内建动作接回同一发送路径；
+ * 无 renderer 环境或类型缺失时回退下方手写实现（EmptyStateFallback）。
  */
 type ChatSuggestion = string | {
     label: string;
@@ -738,6 +743,10 @@ interface ChatWorkspaceServices {
     /** Composer 工具栏左 / 右槽（ReactNode 闭包槽，纯 React 与 DSL 场景均可用） */
     toolbarStart?: ReactNode;
     toolbarEnd?: ReactNode;
+    /** Composer footer 槽（spec: chat-composer-slots；ReactNode 闭包槽） */
+    composerFooter?: ReactNode;
+    /** Composer 下方自定义内容槽（ReactNode 闭包槽；渲染在 Composer 之外正下方，未提供不渲染） */
+    composerBottom?: ReactNode;
     /** 工作区头部右侧扩展区（提供 title 或 headerExtra 时渲染头部） */
     headerExtra?: ReactNode;
 }
@@ -764,8 +773,20 @@ interface ChatWorkspaceProps {
      * 包裹工作区（侧栏 + 移动端抽屉）。仅页面运行时上下文内有效。
      */
     sidebar?: DslNode;
+    /** Composer 工具栏左端 DslNode 槽（与服务注入的 toolbarStart 先后渲染，服务槽在先） */
+    toolbarStart?: DslNode;
     /** Composer 工具栏右端 DslNode 槽（与服务注入的 toolbarEnd 先后渲染） */
     toolbarEnd?: DslNode;
+    /** Composer footer DslNode 槽（spec: chat-composer-slots；与服务注入的 composerFooter 先后渲染，服务槽在先） */
+    composerFooter?: DslNode;
+    /** Composer 下方自定义内容 DslNode 槽（与服务注入的 composerBottom 先后渲染，服务槽在先；未提供不渲染） */
+    composerBottom?: DslNode;
+    /**
+     * 隐藏 Composer 工具栏行（缺省 false）：true 时工具栏行整体不渲染，
+     * toolbarStart / toolbarEnd 槽一并抑制（composerFooter 槽不受影响），
+     * Enter 发送保留
+     */
+    hideToolbar?: boolean;
     /**
      * 产出物面板受控 props（spec: chat-artifact-panel，决策 D2）：
      * 任一提供即全受控；都未提供时由内部 / 注入的 ArtifactStore 驱动
@@ -874,7 +895,7 @@ interface ChatProps {
     conversationId?: string;
     /** 注入 dsl part 作用域 params */
     params?: Record<string, unknown>;
-    /** 传 false 关闭 header；缺省渲染（header 槽整体替换 > title + headerExtra 内建 header） */
+    /** 传 false 关闭 header；缺省按内容自动渲染（header 槽整体替换 > title + headerExtra / headerActions / header 位模型 chip 内建 header，均无内容时 header 节点不渲染） */
     showHeader?: boolean;
     /** 左侧菜单数据；提供时以 AppShell 承载内建侧栏 */
     menu?: ChatMenuItem[];
@@ -882,6 +903,27 @@ interface ChatProps {
     activeMenuKey?: string;
     /** 侧栏槽：提供时替代内建菜单侧栏 */
     sidebar?: DslNode | ReactNode;
+    /**
+     * Composer 槽（spec: chat-composer-slots / Composer 槽配置）：
+     * toolbarStart 工具栏左端 / toolbarEnd 工具栏右端（发送钮之前）/
+     * composerFooter footer 区域（工具栏下方、带分隔线）；
+     * 与服务注入的同名槽并存时服务槽在先
+     */
+    toolbarStart?: DslNode | ReactNode;
+    toolbarEnd?: DslNode | ReactNode;
+    composerFooter?: DslNode | ReactNode;
+    /**
+     * Composer 下方自定义内容槽（DslNode | ReactNode）：
+     * 渲染在 Composer 之外正下方（页面底部留白区内），
+     * 与服务注入的同名槽并存时服务槽在先；未提供不渲染
+     */
+    composerBottom?: DslNode | ReactNode;
+    /**
+     * 隐藏 Composer 工具栏行（缺省 false；DSL 可序列化标量）：
+     * true 时工具栏行整体不渲染，toolbarStart / toolbarEnd 槽一并抑制
+     * （composerFooter 槽不受影响），Enter 发送保留
+     */
+    hideToolbar?: boolean;
     /** 内建 header 标题右侧槽 */
     headerExtra?: DslNode | ReactNode;
     /** header 槽：整体替换内建 header */
@@ -941,12 +983,16 @@ interface ChatProps {
     /** 菜单项点击回调（disabled 项不触发） */
     onMenuSelect?: (key: string, item: ChatMenuItem) => void;
 }
-/** 菜单图标名 → lucide 子集（白名单式，未知名渲染占位圆点，不抛错） */
-declare const MENU_ICONS: Record<string, ComponentType<{
-    size?: number;
-    strokeWidth?: number;
-}>>;
-/** 内建侧栏：menu 数据驱动的菜单（分组标题 + 图标 + badge + disabled）；ChatShell 同款复用 */
+/**
+ * 菜单图标名（spec: chat-icon-convergence）：契约取值（plus / chat /
+ * history / settings / star / search / user / folder）直接作为 ui Icon
+ * 白名单名渲染，未知名由 ui Icon 渲染占位图标，不抛错。
+ * 白名单曾映射 lucide 子集（MENU_ICONS），收敛后删除。
+ */
+/** 内建侧栏：menu 数据驱动的菜单（分组标题 + 图标 + badge + disabled）；ChatShell 同款复用。
+ * chrome DSL 渲染层（spec: chat-on-ui-components）：DSL 环境优先经宿主
+ * Menu 组件组合渲染（chat.menuSelect 接回同一传播与 drawer close），
+ * 无 renderer / 类型缺失时回退下方手写菜单 */
 declare function ChatSidebarMenu({ menu, activeMenuKey, onMenuSelect, }: {
     menu: ChatMenuItem[];
     activeMenuKey?: string;
@@ -960,7 +1006,7 @@ declare function ChatSidebarMenu({ menu, activeMenuKey, onMenuSelect, }: {
  * 「未配置聊天服务」提示并 console.warn，不抛错。组合逻辑与
  * createChatWorkspace 共用内部 ChatComposition（决策 D5）。
  */
-declare function Chat({ title, greeting, subtitle, suggestions, conversationId, params, showHeader, menu, activeMenuKey, sidebar, headerExtra, header, headerActions, editableTitle, onExport, onThemeChange, onClear, onTitleChange, models, model, onModelChange, modelPlacement, contexts, onContextsChange, messageActions, onMessageAction, artifact, panelOpen, onPanelClose, inspector, onArtifact, onOpenArtifact, className, onSend, onMenuSelect, }: ChatProps): ReactNode;
+declare function Chat({ title, greeting, subtitle, suggestions, conversationId, params, showHeader, menu, activeMenuKey, sidebar, toolbarStart, toolbarEnd, composerFooter, composerBottom, hideToolbar, headerExtra, header, headerActions, editableTitle, onExport, onThemeChange, onClear, onTitleChange, models, model, onModelChange, modelPlacement, contexts, onContextsChange, messageActions, onMessageAction, artifact, panelOpen, onPanelClose, inspector, onArtifact, onOpenArtifact, className, onSend, onMenuSelect, }: ChatProps): ReactNode;
 /** Chat 的 DSL 组件类型名 */
 declare const CHAT_COMPONENT_TYPE = "Chat";
 /**
@@ -970,6 +1016,20 @@ declare const CHAT_COMPONENT_TYPE = "Chat";
  * 一并注册，同样不覆盖已有同名类型。
  */
 declare function registerChatComponent(registry: Registry<unknown>): void;
+/**
+ * 便捷工厂：创建含全部内置组件 + Chat / ChatShell 的组件注册表，
+ * 直接作为 createPactorApplication 的 componentRegistry 选项：
+ *
+ * ```ts
+ * import { createChatComponentRegistry } from '@pactor-app/chat';
+ *
+ * createPactorApplication({
+ *   appId: 'my-chat',
+ *   componentRegistry: createChatComponentRegistry,
+ * });
+ * ```
+ */
+declare function createChatComponentRegistry(): Registry<unknown>;
 
 /**
  * ChatShell（spec: chat-dsl-component / ChatShell 外壳组件，设计决策 D6）：
@@ -1036,6 +1096,16 @@ interface ArtifactPanelProps {
 }
 declare function ArtifactPanel({ artifact, inspector, onClose, safeRegistry, user, className, }: ArtifactPanelProps): ReactNode;
 
+/**
+ * 侧栏抽屉 context（spec: chat-app-shell）：侧栏内容（如导航项）在导航后
+ * 调用 `close()` 关闭移动端抽屉；不在 AppShell 内时返回 null，
+ * 调用方以可选链安全调用（`drawer?.close()`），不抛错。
+ * `collapsed` 为桌面折叠（icon rail）状态（决策 D3）：侧栏内容可据此
+ * 降级为纯图标展示（如菜单项以 title 兜底可访问名）。
+ *
+ * 实现为 ui Sidebar 的 context 转发（chat-on-ui-sidebar）：AppShell
+ * 内部渲染 ui Sidebar，hook 签名与语义保持不变，调用方零改动。
+ */
 declare function useSidebarDrawer(): {
     close: () => void;
     collapsed: boolean;
@@ -1068,12 +1138,14 @@ interface AppShellProps {
 /**
  * AppShell（spec: chat-app-shell）：聊天工作区应用外壳 = 侧栏插槽 + 主区。
  *
- * 桌面（≥768px）：侧栏与主区在 flex 行内同级排列；
- * 移动端（<768px）：侧栏退出文档流变为左侧覆盖抽屉（遮罩 + 顶栏菜单按钮）。
- * 布局切换全部在 styles.css 媒体查询（`.pactor-chat-shell*`）中表达，
- * JS 只拥有抽屉开合状态 `drawerOpen`。
+ * 实现为 ui Sidebar 的薄封装（spec: chat-on-ui-sidebar）：桌面（≥768px）
+ * 侧栏与主区 flex 同行；移动端（<768px）侧栏变为覆盖抽屉（遮罩 +
+ * 顶栏菜单按钮）；折叠 / 抽屉 / inert 等交互全部由 ui Sidebar 承担，
+ * chat 侧只挂 `pactor-chat-shell` 类做 `--sidebar*` → `--pactor-chat-*`
+ * 令牌映射（皮肤唯一入口仍为 --pactor-chat-*，见 styles.css）与
+ * 高度语义（h-full 填满父容器，嵌入契约）。
  */
-declare function AppShell({ sidebar, brand, locationKey, sidebarFooter, collapsible, children, className }: AppShellProps): react.JSX.Element;
+declare function AppShell({ sidebar, brand, locationKey, sidebarFooter, collapsible, children, className, }: AppShellProps): react.JSX.Element;
 
 /**
  * 上下文数据源解析与候选列表（spec: chat-context-sources，设计决策 D1/D5）：
@@ -1105,6 +1177,10 @@ type CallChatService = (name: string, params?: Record<string, unknown>) => Promi
  *   模型 chip（AnchoredPopover 列表，toolbarEnd 之前）；contexts 配置
  *   且未注入调用方回调时启用内建 @ 提及 / + 菜单弹层，选中项追加为
  *   输入区上方的上下文 chips（受控：contextChips + onContextChipsChange）
+ * - chrome DSL 渲染层（spec: chat-composer-on-chatinput）：呈现层在
+ *   DSL 环境经宿主 ChatInput 组合渲染（非受控 + chat.composerSubmit
+ *   桥接 + 冒泡同步 / 附件承接），无 renderer 或类型缺失时回退手写
+ *   呈现（ComposerFallback），两条路径交互语义一致
  */
 interface ComposerProps {
     /** 发送回调；输入框在回调后清空 */
@@ -1126,6 +1202,15 @@ interface ComposerProps {
     /** 工具栏左 / 右渲染槽 */
     toolbarStart?: ReactNode;
     toolbarEnd?: ReactNode;
+    /** footer 槽（spec: chat-composer-slots / Composer footer 槽）：渲染在工具栏下方、以分隔线相隔；未提供不渲染 */
+    composerFooter?: ReactNode;
+    /**
+     * 隐藏工具栏行（缺省 false）：true 时工具栏行整体不渲染——
+     * 内建 + 钮 / 附件钮 / 模型 chip / 发送钮与 toolbarStart / toolbarEnd
+     * 槽一并抑制（footer 槽不受影响）；Enter 发送保留，DSL 路径由
+     * ChatInput 工具栏行零渲染承担
+     */
+    hideToolbar?: boolean;
     /** 词边界 `@` 输入触发：query 为 `@` 后文本，anchorRect 为弹层锚点 */
     onMentionTrigger?: (query: string, anchorRect: DOMRect) => void;
     /** "+" 按钮触发弹层入口 */
@@ -1152,7 +1237,7 @@ interface ComposerProps {
     /** service 引用解析出口（ChatServices.callService 透传） */
     callService?: CallChatService;
 }
-declare function Composer({ onSend, streaming, onStop, placeholder, disabled, attachments, onAttachmentsChange, onAttachFiles, onAttachmentClick, toolbarStart, toolbarEnd, onMentionTrigger, onPlusMenu, models, model, onModelChange, contextSources, contextChips, onContextChipsChange, callService, }: ComposerProps): react.JSX.Element;
+declare function Composer({ onSend, streaming, onStop, placeholder, disabled, attachments, onAttachmentsChange, onAttachFiles, onAttachmentClick, toolbarStart, toolbarEnd, onMentionTrigger, onPlusMenu, models, model, onModelChange, contextSources, contextChips, onContextChipsChange, callService, composerFooter, hideToolbar, }: ComposerProps): react.JSX.Element;
 
 /**
  * ChatView（设计决策 D6）：消息列表（useSyncExternalStore 订阅
@@ -1171,7 +1256,7 @@ declare function Composer({ onSend, streaming, onStop, placeholder, disabled, at
  * Composer 扩展 props（attachments / onAttachFiles / toolbar 槽 /
  * 提及与 "+" 触发等，见 ComposerProps）原样透传给内建 Composer。
  */
-interface ChatViewProps extends Pick<ComposerProps, 'attachments' | 'onAttachmentsChange' | 'onAttachFiles' | 'onAttachmentClick' | 'toolbarStart' | 'toolbarEnd' | 'onMentionTrigger' | 'onPlusMenu'> {
+interface ChatViewProps extends Pick<ComposerProps, 'attachments' | 'onAttachmentsChange' | 'onAttachFiles' | 'onAttachmentClick' | 'toolbarStart' | 'toolbarEnd' | 'composerFooter' | 'hideToolbar' | 'onMentionTrigger' | 'onPlusMenu'> {
     store: ConversationStore;
     /** 注入后发送即驱动 turn；缺省时仅触发 onSend */
     transport?: ChatTransport;
@@ -1233,9 +1318,15 @@ interface ChatViewProps extends Pick<ComposerProps, 'attachments' | 'onAttachmen
     messageActions?: Array<BuiltinMessageAction | ChatMessageAction>;
     /** 全部消息动作（含内建）点击的并行通知（event 语义，不影响内建默认行为） */
     onMessageAction?: (actionId: string, message: ChatMessage) => void;
+    /**
+     * Composer 下方自定义内容槽（未提供不渲染）：渲染在 Composer 之外、
+     * 页面底部留白区内（空态 / 钉底两态一致），典型用途为免责声明、
+     * 备案信息等弱提示行
+     */
+    composerBottom?: ReactNode;
     className?: string;
 }
-declare function ChatView({ store, transport, onSend, safeRegistry, capabilities, permission, confirm, conversationId, user, params, greeting, subtitle, suggestions, className, onArtifact, onOpenArtifact, attachments, onAttachmentsChange, onAttachFiles, onAttachmentClick, toolbarStart, toolbarEnd, onMentionTrigger, onPlusMenu, models, model, onModelChange, modelPlacement, contexts, onContextsChange, callService, messageActions, onMessageAction, }: ChatViewProps): react.JSX.Element;
+declare function ChatView({ store, transport, onSend, safeRegistry, capabilities, permission, confirm, conversationId, user, params, greeting, subtitle, suggestions, className, onArtifact, onOpenArtifact, attachments, onAttachmentsChange, onAttachFiles, onAttachmentClick, toolbarStart, toolbarEnd, composerFooter, hideToolbar, onMentionTrigger, onPlusMenu, models, model, onModelChange, modelPlacement, contexts, onContextsChange, callService, messageActions, onMessageAction, composerBottom, }: ChatViewProps): react.JSX.Element;
 
 /**
  * ActivityTrace（spec: chat-activity-trace，设计决策 D1/D4）：
@@ -1333,10 +1424,6 @@ interface MessageActionsProps {
     /** 全部动作（含内建）点击的并行通知 */
     onMessageAction?: (actionId: string, message: ChatMessage) => void;
 }
-/** 动作图标名 → lucide 子集（白名单式，同菜单 MENU_ICONS 口径；未知名渲染占位图标，不抛错） */
-declare const MESSAGE_ACTION_ICONS: Record<string, ComponentType<{
-    size?: number;
-}>>;
 /** 收集消息的可复制文本（text / markdown part 按序拼接） */
 declare function collectMessageText(message: ChatMessage): string;
 declare function MessageActions({ message, actions, showRegenerate, onRegenerate, onEdit, onRetry, forceVisible, callService, onMessageAction, }: MessageActionsProps): react.JSX.Element | null;
@@ -1388,8 +1475,9 @@ declare function ChatLayout({ title, children }: ChatLayoutProps): react.JSX.Ele
 declare const CHAT_LAYOUT_TYPE = "chat";
 /**
  * 结构化 LayoutRegistry（兼容 @pactor-app/ui layout 层的 LayoutRegistry =
- * Registry<LayoutComponent>）：以结构化类型声明，避免对
- * @pactor-app/ui 产生运行时依赖。
+ * Registry<LayoutComponent>）：结构化类型声明，调用方传入 ui layout 层
+ * 的注册表即天然兼容（历史为零依赖约定而设；chat-icon-convergence 起
+ * chat 正式依赖 @pactor-app/ui，本结构化声明保留以收窄本文件的 API 面）。
  */
 interface ChatLayoutRegistry {
     has(name: string): boolean;
@@ -1398,4 +1486,4 @@ interface ChatLayoutRegistry {
 /** 注册 chat 布局（已注册时不覆盖，与 createLayoutRegistry 约定一致） */
 declare function registerChatLayout(layoutRegistry: ChatLayoutRegistry): void;
 
-export { ActivityTrace, type ActivityTraceProps, AppShell, type AppShellProps, ArtifactPanel, type ArtifactPanelProps, type ArtifactPatch, ArtifactStore, type BuiltinMessageAction, CHAT_COMPONENT_TYPE, CHAT_DENIED_TYPE, CHAT_LAYOUT_TYPE, CHAT_SHELL_COMPONENT_TYPE, type CapabilityActionDeps, type CapabilityHandler, Chat, type ChatArtifact, type ChatAttachment, type ChatCapabilityRegistry, type ChatConfirm, type ChatConfirmRequest, type ChatContextItem, type ChatContextSource, ChatDenied, type ChatEvent, type ChatHeaderAction, type ChatInput, ChatLayout, type ChatLayoutProps, type ChatLayoutRegistry, type ChatMenuItem, type ChatMessage, type ChatMessageAction, type ChatModelOption, type ChatPart, type ChatPermissionChecker, type ChatProps, type ChatRole, type ChatRuntime, type ChatScope, type ChatServices, ChatServicesProvider, ChatShell, type ChatShellProps, ChatSidebarMenu, type ChatSuggestion, type ChatTransport, type ChatTurnResult, ChatView, type ChatViewProps, type ChatWorkspaceProps, type ChatWorkspaceServices, Composer, type ComposerProps, ConversationStore, type CreateChatRuntimeOptions, DEFAULT_CHAT_GREETING, EmptyState, type EmptyStateProps, MENU_ICONS, MESSAGE_ACTION_ICONS, type ManualChatDriver, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, type MessagePatch, type MessageStatus, type PartPatch, type PartRef, PartRenderer, type PartRendererProps, type PartStatus, type RunChatTurnOptions, type StreamingMode, type ToolCallStatus, type ToolTraceEntry, type UseChatAutoScrollOptions, type UseChatAutoScrollResult, type UseSmoothStreamTextOptions, applyChatEvent, buildChatScope, collectMessageText, createChatId, createChatRuntime, createChatWorkspace, createManualDriver, createSafeRegistry, detectStreamingMode, guardChatDsl, pairToolTraces, registerCapabilityAction, registerChatComponent, registerChatLayout, registerChatShellComponent, runChatTurn, runRegenerateTurn, useChatAutoScroll, useChatServices, useSidebarDrawer, useSmoothStreamText };
+export { ActivityTrace, type ActivityTraceProps, AppShell, type AppShellProps, ArtifactPanel, type ArtifactPanelProps, type ArtifactPatch, ArtifactStore, type BuiltinMessageAction, CHAT_COMPONENT_TYPE, CHAT_DENIED_TYPE, CHAT_LAYOUT_TYPE, CHAT_SHELL_COMPONENT_TYPE, type CapabilityActionDeps, type CapabilityHandler, Chat, type ChatArtifact, type ChatAttachment, type ChatCapabilityRegistry, type ChatConfirm, type ChatConfirmRequest, type ChatContextItem, type ChatContextSource, ChatDenied, type ChatEvent, type ChatHeaderAction, type ChatInput, ChatLayout, type ChatLayoutProps, type ChatLayoutRegistry, type ChatMenuItem, type ChatMessage, type ChatMessageAction, type ChatModelOption, type ChatPart, type ChatPermissionChecker, type ChatProps, type ChatRole, type ChatRuntime, type ChatScope, type ChatServices, ChatServicesProvider, ChatShell, type ChatShellProps, ChatSidebarMenu, type ChatSuggestion, type ChatTransport, type ChatTurnResult, ChatView, type ChatViewProps, type ChatWorkspaceProps, type ChatWorkspaceServices, Composer, type ComposerProps, ConversationStore, type CreateChatRuntimeOptions, DEFAULT_CHAT_GREETING, EmptyState, type EmptyStateProps, type ManualChatDriver, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, type MessagePatch, type MessageStatus, type PartPatch, type PartRef, PartRenderer, type PartRendererProps, type PartStatus, type RunChatTurnOptions, type StreamingMode, type ToolCallStatus, type ToolTraceEntry, type UseChatAutoScrollOptions, type UseChatAutoScrollResult, type UseSmoothStreamTextOptions, applyChatEvent, buildChatScope, collectMessageText, createChatComponentRegistry, createChatId, createChatRuntime, createChatWorkspace, createManualDriver, createSafeRegistry, detectStreamingMode, guardChatDsl, pairToolTraces, registerCapabilityAction, registerChatComponent, registerChatLayout, registerChatShellComponent, runChatTurn, runRegenerateTurn, useChatAutoScroll, useChatServices, useSidebarDrawer, useSmoothStreamText };

package/dist/index.d.ts

@@ -655,6 +655,11 @@ declare function useChatAutoScroll({ messageCount, lastContentLength, isStreamin
  * 数据以接口注入：greeting / subtitle / suggestions 均为受控 props；
  * 点击建议经 `onSuggestionClick` 回调交还调用方（ChatView 接入时
  * 复用 Composer 的同一条发送路径）。
+ *
+ * chrome DSL 渲染层（spec: chat-chrome-dsl）：元素层在页面运行时内
+ * 优先经 ChromeSlot 以宿主组件（Typography / Text / Button）DSL 组合
+ * 渲染，建议点击经 chat.sendSuggestion 内建动作接回同一发送路径；
+ * 无 renderer 环境或类型缺失时回退下方手写实现（EmptyStateFallback）。
  */
 type ChatSuggestion = string | {
     label: string;
@@ -738,6 +743,10 @@ interface ChatWorkspaceServices {
     /** Composer 工具栏左 / 右槽（ReactNode 闭包槽，纯 React 与 DSL 场景均可用） */
     toolbarStart?: ReactNode;
     toolbarEnd?: ReactNode;
+    /** Composer footer 槽（spec: chat-composer-slots；ReactNode 闭包槽） */
+    composerFooter?: ReactNode;
+    /** Composer 下方自定义内容槽（ReactNode 闭包槽；渲染在 Composer 之外正下方，未提供不渲染） */
+    composerBottom?: ReactNode;
     /** 工作区头部右侧扩展区（提供 title 或 headerExtra 时渲染头部） */
     headerExtra?: ReactNode;
 }
@@ -764,8 +773,20 @@ interface ChatWorkspaceProps {
      * 包裹工作区（侧栏 + 移动端抽屉）。仅页面运行时上下文内有效。
      */
     sidebar?: DslNode;
+    /** Composer 工具栏左端 DslNode 槽（与服务注入的 toolbarStart 先后渲染，服务槽在先） */
+    toolbarStart?: DslNode;
     /** Composer 工具栏右端 DslNode 槽（与服务注入的 toolbarEnd 先后渲染） */
     toolbarEnd?: DslNode;
+    /** Composer footer DslNode 槽（spec: chat-composer-slots；与服务注入的 composerFooter 先后渲染，服务槽在先） */
+    composerFooter?: DslNode;
+    /** Composer 下方自定义内容 DslNode 槽（与服务注入的 composerBottom 先后渲染，服务槽在先；未提供不渲染） */
+    composerBottom?: DslNode;
+    /**
+     * 隐藏 Composer 工具栏行（缺省 false）：true 时工具栏行整体不渲染，
+     * toolbarStart / toolbarEnd 槽一并抑制（composerFooter 槽不受影响），
+     * Enter 发送保留
+     */
+    hideToolbar?: boolean;
     /**
      * 产出物面板受控 props（spec: chat-artifact-panel，决策 D2）：
      * 任一提供即全受控；都未提供时由内部 / 注入的 ArtifactStore 驱动
@@ -874,7 +895,7 @@ interface ChatProps {
     conversationId?: string;
     /** 注入 dsl part 作用域 params */
     params?: Record<string, unknown>;
-    /** 传 false 关闭 header；缺省渲染（header 槽整体替换 > title + headerExtra 内建 header） */
+    /** 传 false 关闭 header；缺省按内容自动渲染（header 槽整体替换 > title + headerExtra / headerActions / header 位模型 chip 内建 header，均无内容时 header 节点不渲染） */
     showHeader?: boolean;
     /** 左侧菜单数据；提供时以 AppShell 承载内建侧栏 */
     menu?: ChatMenuItem[];
@@ -882,6 +903,27 @@ interface ChatProps {
     activeMenuKey?: string;
     /** 侧栏槽：提供时替代内建菜单侧栏 */
     sidebar?: DslNode | ReactNode;
+    /**
+     * Composer 槽（spec: chat-composer-slots / Composer 槽配置）：
+     * toolbarStart 工具栏左端 / toolbarEnd 工具栏右端（发送钮之前）/
+     * composerFooter footer 区域（工具栏下方、带分隔线）；
+     * 与服务注入的同名槽并存时服务槽在先
+     */
+    toolbarStart?: DslNode | ReactNode;
+    toolbarEnd?: DslNode | ReactNode;
+    composerFooter?: DslNode | ReactNode;
+    /**
+     * Composer 下方自定义内容槽（DslNode | ReactNode）：
+     * 渲染在 Composer 之外正下方（页面底部留白区内），
+     * 与服务注入的同名槽并存时服务槽在先；未提供不渲染
+     */
+    composerBottom?: DslNode | ReactNode;
+    /**
+     * 隐藏 Composer 工具栏行（缺省 false；DSL 可序列化标量）：
+     * true 时工具栏行整体不渲染，toolbarStart / toolbarEnd 槽一并抑制
+     * （composerFooter 槽不受影响），Enter 发送保留
+     */
+    hideToolbar?: boolean;
     /** 内建 header 标题右侧槽 */
     headerExtra?: DslNode | ReactNode;
     /** header 槽：整体替换内建 header */
@@ -941,12 +983,16 @@ interface ChatProps {
     /** 菜单项点击回调（disabled 项不触发） */
     onMenuSelect?: (key: string, item: ChatMenuItem) => void;
 }
-/** 菜单图标名 → lucide 子集（白名单式，未知名渲染占位圆点，不抛错） */
-declare const MENU_ICONS: Record<string, ComponentType<{
-    size?: number;
-    strokeWidth?: number;
-}>>;
-/** 内建侧栏：menu 数据驱动的菜单（分组标题 + 图标 + badge + disabled）；ChatShell 同款复用 */
+/**
+ * 菜单图标名（spec: chat-icon-convergence）：契约取值（plus / chat /
+ * history / settings / star / search / user / folder）直接作为 ui Icon
+ * 白名单名渲染，未知名由 ui Icon 渲染占位图标，不抛错。
+ * 白名单曾映射 lucide 子集（MENU_ICONS），收敛后删除。
+ */
+/** 内建侧栏：menu 数据驱动的菜单（分组标题 + 图标 + badge + disabled）；ChatShell 同款复用。
+ * chrome DSL 渲染层（spec: chat-on-ui-components）：DSL 环境优先经宿主
+ * Menu 组件组合渲染（chat.menuSelect 接回同一传播与 drawer close），
+ * 无 renderer / 类型缺失时回退下方手写菜单 */
 declare function ChatSidebarMenu({ menu, activeMenuKey, onMenuSelect, }: {
     menu: ChatMenuItem[];
     activeMenuKey?: string;
@@ -960,7 +1006,7 @@ declare function ChatSidebarMenu({ menu, activeMenuKey, onMenuSelect, }: {
  * 「未配置聊天服务」提示并 console.warn，不抛错。组合逻辑与
  * createChatWorkspace 共用内部 ChatComposition（决策 D5）。
  */
-declare function Chat({ title, greeting, subtitle, suggestions, conversationId, params, showHeader, menu, activeMenuKey, sidebar, headerExtra, header, headerActions, editableTitle, onExport, onThemeChange, onClear, onTitleChange, models, model, onModelChange, modelPlacement, contexts, onContextsChange, messageActions, onMessageAction, artifact, panelOpen, onPanelClose, inspector, onArtifact, onOpenArtifact, className, onSend, onMenuSelect, }: ChatProps): ReactNode;
+declare function Chat({ title, greeting, subtitle, suggestions, conversationId, params, showHeader, menu, activeMenuKey, sidebar, toolbarStart, toolbarEnd, composerFooter, composerBottom, hideToolbar, headerExtra, header, headerActions, editableTitle, onExport, onThemeChange, onClear, onTitleChange, models, model, onModelChange, modelPlacement, contexts, onContextsChange, messageActions, onMessageAction, artifact, panelOpen, onPanelClose, inspector, onArtifact, onOpenArtifact, className, onSend, onMenuSelect, }: ChatProps): ReactNode;
 /** Chat 的 DSL 组件类型名 */
 declare const CHAT_COMPONENT_TYPE = "Chat";
 /**
@@ -970,6 +1016,20 @@ declare const CHAT_COMPONENT_TYPE = "Chat";
  * 一并注册，同样不覆盖已有同名类型。
  */
 declare function registerChatComponent(registry: Registry<unknown>): void;
+/**
+ * 便捷工厂：创建含全部内置组件 + Chat / ChatShell 的组件注册表，
+ * 直接作为 createPactorApplication 的 componentRegistry 选项：
+ *
+ * ```ts
+ * import { createChatComponentRegistry } from '@pactor-app/chat';
+ *
+ * createPactorApplication({
+ *   appId: 'my-chat',
+ *   componentRegistry: createChatComponentRegistry,
+ * });
+ * ```
+ */
+declare function createChatComponentRegistry(): Registry<unknown>;
 
 /**
  * ChatShell（spec: chat-dsl-component / ChatShell 外壳组件，设计决策 D6）：
@@ -1036,6 +1096,16 @@ interface ArtifactPanelProps {
 }
 declare function ArtifactPanel({ artifact, inspector, onClose, safeRegistry, user, className, }: ArtifactPanelProps): ReactNode;
 
+/**
+ * 侧栏抽屉 context（spec: chat-app-shell）：侧栏内容（如导航项）在导航后
+ * 调用 `close()` 关闭移动端抽屉；不在 AppShell 内时返回 null，
+ * 调用方以可选链安全调用（`drawer?.close()`），不抛错。
+ * `collapsed` 为桌面折叠（icon rail）状态（决策 D3）：侧栏内容可据此
+ * 降级为纯图标展示（如菜单项以 title 兜底可访问名）。
+ *
+ * 实现为 ui Sidebar 的 context 转发（chat-on-ui-sidebar）：AppShell
+ * 内部渲染 ui Sidebar，hook 签名与语义保持不变，调用方零改动。
+ */
 declare function useSidebarDrawer(): {
     close: () => void;
     collapsed: boolean;
@@ -1068,12 +1138,14 @@ interface AppShellProps {
 /**
  * AppShell（spec: chat-app-shell）：聊天工作区应用外壳 = 侧栏插槽 + 主区。
  *
- * 桌面（≥768px）：侧栏与主区在 flex 行内同级排列；
- * 移动端（<768px）：侧栏退出文档流变为左侧覆盖抽屉（遮罩 + 顶栏菜单按钮）。
- * 布局切换全部在 styles.css 媒体查询（`.pactor-chat-shell*`）中表达，
- * JS 只拥有抽屉开合状态 `drawerOpen`。
+ * 实现为 ui Sidebar 的薄封装（spec: chat-on-ui-sidebar）：桌面（≥768px）
+ * 侧栏与主区 flex 同行；移动端（<768px）侧栏变为覆盖抽屉（遮罩 +
+ * 顶栏菜单按钮）；折叠 / 抽屉 / inert 等交互全部由 ui Sidebar 承担，
+ * chat 侧只挂 `pactor-chat-shell` 类做 `--sidebar*` → `--pactor-chat-*`
+ * 令牌映射（皮肤唯一入口仍为 --pactor-chat-*，见 styles.css）与
+ * 高度语义（h-full 填满父容器，嵌入契约）。
  */
-declare function AppShell({ sidebar, brand, locationKey, sidebarFooter, collapsible, children, className }: AppShellProps): react.JSX.Element;
+declare function AppShell({ sidebar, brand, locationKey, sidebarFooter, collapsible, children, className, }: AppShellProps): react.JSX.Element;
 
 /**
  * 上下文数据源解析与候选列表（spec: chat-context-sources，设计决策 D1/D5）：
@@ -1105,6 +1177,10 @@ type CallChatService = (name: string, params?: Record<string, unknown>) => Promi
  *   模型 chip（AnchoredPopover 列表，toolbarEnd 之前）；contexts 配置
  *   且未注入调用方回调时启用内建 @ 提及 / + 菜单弹层，选中项追加为
  *   输入区上方的上下文 chips（受控：contextChips + onContextChipsChange）
+ * - chrome DSL 渲染层（spec: chat-composer-on-chatinput）：呈现层在
+ *   DSL 环境经宿主 ChatInput 组合渲染（非受控 + chat.composerSubmit
+ *   桥接 + 冒泡同步 / 附件承接），无 renderer 或类型缺失时回退手写
+ *   呈现（ComposerFallback），两条路径交互语义一致
  */
 interface ComposerProps {
     /** 发送回调；输入框在回调后清空 */
@@ -1126,6 +1202,15 @@ interface ComposerProps {
     /** 工具栏左 / 右渲染槽 */
     toolbarStart?: ReactNode;
     toolbarEnd?: ReactNode;
+    /** footer 槽（spec: chat-composer-slots / Composer footer 槽）：渲染在工具栏下方、以分隔线相隔；未提供不渲染 */
+    composerFooter?: ReactNode;
+    /**
+     * 隐藏工具栏行（缺省 false）：true 时工具栏行整体不渲染——
+     * 内建 + 钮 / 附件钮 / 模型 chip / 发送钮与 toolbarStart / toolbarEnd
+     * 槽一并抑制（footer 槽不受影响）；Enter 发送保留，DSL 路径由
+     * ChatInput 工具栏行零渲染承担
+     */
+    hideToolbar?: boolean;
     /** 词边界 `@` 输入触发：query 为 `@` 后文本，anchorRect 为弹层锚点 */
     onMentionTrigger?: (query: string, anchorRect: DOMRect) => void;
     /** "+" 按钮触发弹层入口 */
@@ -1152,7 +1237,7 @@ interface ComposerProps {
     /** service 引用解析出口（ChatServices.callService 透传） */
     callService?: CallChatService;
 }
-declare function Composer({ onSend, streaming, onStop, placeholder, disabled, attachments, onAttachmentsChange, onAttachFiles, onAttachmentClick, toolbarStart, toolbarEnd, onMentionTrigger, onPlusMenu, models, model, onModelChange, contextSources, contextChips, onContextChipsChange, callService, }: ComposerProps): react.JSX.Element;
+declare function Composer({ onSend, streaming, onStop, placeholder, disabled, attachments, onAttachmentsChange, onAttachFiles, onAttachmentClick, toolbarStart, toolbarEnd, onMentionTrigger, onPlusMenu, models, model, onModelChange, contextSources, contextChips, onContextChipsChange, callService, composerFooter, hideToolbar, }: ComposerProps): react.JSX.Element;
 
 /**
  * ChatView（设计决策 D6）：消息列表（useSyncExternalStore 订阅
@@ -1171,7 +1256,7 @@ declare function Composer({ onSend, streaming, onStop, placeholder, disabled, at
  * Composer 扩展 props（attachments / onAttachFiles / toolbar 槽 /
  * 提及与 "+" 触发等，见 ComposerProps）原样透传给内建 Composer。
  */
-interface ChatViewProps extends Pick<ComposerProps, 'attachments' | 'onAttachmentsChange' | 'onAttachFiles' | 'onAttachmentClick' | 'toolbarStart' | 'toolbarEnd' | 'onMentionTrigger' | 'onPlusMenu'> {
+interface ChatViewProps extends Pick<ComposerProps, 'attachments' | 'onAttachmentsChange' | 'onAttachFiles' | 'onAttachmentClick' | 'toolbarStart' | 'toolbarEnd' | 'composerFooter' | 'hideToolbar' | 'onMentionTrigger' | 'onPlusMenu'> {
     store: ConversationStore;
     /** 注入后发送即驱动 turn；缺省时仅触发 onSend */
     transport?: ChatTransport;
@@ -1233,9 +1318,15 @@ interface ChatViewProps extends Pick<ComposerProps, 'attachments' | 'onAttachmen
     messageActions?: Array<BuiltinMessageAction | ChatMessageAction>;
     /** 全部消息动作（含内建）点击的并行通知（event 语义，不影响内建默认行为） */
     onMessageAction?: (actionId: string, message: ChatMessage) => void;
+    /**
+     * Composer 下方自定义内容槽（未提供不渲染）：渲染在 Composer 之外、
+     * 页面底部留白区内（空态 / 钉底两态一致），典型用途为免责声明、
+     * 备案信息等弱提示行
+     */
+    composerBottom?: ReactNode;
     className?: string;
 }
-declare function ChatView({ store, transport, onSend, safeRegistry, capabilities, permission, confirm, conversationId, user, params, greeting, subtitle, suggestions, className, onArtifact, onOpenArtifact, attachments, onAttachmentsChange, onAttachFiles, onAttachmentClick, toolbarStart, toolbarEnd, onMentionTrigger, onPlusMenu, models, model, onModelChange, modelPlacement, contexts, onContextsChange, callService, messageActions, onMessageAction, }: ChatViewProps): react.JSX.Element;
+declare function ChatView({ store, transport, onSend, safeRegistry, capabilities, permission, confirm, conversationId, user, params, greeting, subtitle, suggestions, className, onArtifact, onOpenArtifact, attachments, onAttachmentsChange, onAttachFiles, onAttachmentClick, toolbarStart, toolbarEnd, composerFooter, hideToolbar, onMentionTrigger, onPlusMenu, models, model, onModelChange, modelPlacement, contexts, onContextsChange, callService, messageActions, onMessageAction, composerBottom, }: ChatViewProps): react.JSX.Element;
 
 /**
  * ActivityTrace（spec: chat-activity-trace，设计决策 D1/D4）：
@@ -1333,10 +1424,6 @@ interface MessageActionsProps {
     /** 全部动作（含内建）点击的并行通知 */
     onMessageAction?: (actionId: string, message: ChatMessage) => void;
 }
-/** 动作图标名 → lucide 子集（白名单式，同菜单 MENU_ICONS 口径；未知名渲染占位图标，不抛错） */
-declare const MESSAGE_ACTION_ICONS: Record<string, ComponentType<{
-    size?: number;
-}>>;
 /** 收集消息的可复制文本（text / markdown part 按序拼接） */
 declare function collectMessageText(message: ChatMessage): string;
 declare function MessageActions({ message, actions, showRegenerate, onRegenerate, onEdit, onRetry, forceVisible, callService, onMessageAction, }: MessageActionsProps): react.JSX.Element | null;
@@ -1388,8 +1475,9 @@ declare function ChatLayout({ title, children }: ChatLayoutProps): react.JSX.Ele
 declare const CHAT_LAYOUT_TYPE = "chat";
 /**
  * 结构化 LayoutRegistry（兼容 @pactor-app/ui layout 层的 LayoutRegistry =
- * Registry<LayoutComponent>）：以结构化类型声明，避免对
- * @pactor-app/ui 产生运行时依赖。
+ * Registry<LayoutComponent>）：结构化类型声明，调用方传入 ui layout 层
+ * 的注册表即天然兼容（历史为零依赖约定而设；chat-icon-convergence 起
+ * chat 正式依赖 @pactor-app/ui，本结构化声明保留以收窄本文件的 API 面）。
  */
 interface ChatLayoutRegistry {
     has(name: string): boolean;
@@ -1398,4 +1486,4 @@ interface ChatLayoutRegistry {
 /** 注册 chat 布局（已注册时不覆盖，与 createLayoutRegistry 约定一致） */
 declare function registerChatLayout(layoutRegistry: ChatLayoutRegistry): void;
 
-export { ActivityTrace, type ActivityTraceProps, AppShell, type AppShellProps, ArtifactPanel, type ArtifactPanelProps, type ArtifactPatch, ArtifactStore, type BuiltinMessageAction, CHAT_COMPONENT_TYPE, CHAT_DENIED_TYPE, CHAT_LAYOUT_TYPE, CHAT_SHELL_COMPONENT_TYPE, type CapabilityActionDeps, type CapabilityHandler, Chat, type ChatArtifact, type ChatAttachment, type ChatCapabilityRegistry, type ChatConfirm, type ChatConfirmRequest, type ChatContextItem, type ChatContextSource, ChatDenied, type ChatEvent, type ChatHeaderAction, type ChatInput, ChatLayout, type ChatLayoutProps, type ChatLayoutRegistry, type ChatMenuItem, type ChatMessage, type ChatMessageAction, type ChatModelOption, type ChatPart, type ChatPermissionChecker, type ChatProps, type ChatRole, type ChatRuntime, type ChatScope, type ChatServices, ChatServicesProvider, ChatShell, type ChatShellProps, ChatSidebarMenu, type ChatSuggestion, type ChatTransport, type ChatTurnResult, ChatView, type ChatViewProps, type ChatWorkspaceProps, type ChatWorkspaceServices, Composer, type ComposerProps, ConversationStore, type CreateChatRuntimeOptions, DEFAULT_CHAT_GREETING, EmptyState, type EmptyStateProps, MENU_ICONS, MESSAGE_ACTION_ICONS, type ManualChatDriver, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, type MessagePatch, type MessageStatus, type PartPatch, type PartRef, PartRenderer, type PartRendererProps, type PartStatus, type RunChatTurnOptions, type StreamingMode, type ToolCallStatus, type ToolTraceEntry, type UseChatAutoScrollOptions, type UseChatAutoScrollResult, type UseSmoothStreamTextOptions, applyChatEvent, buildChatScope, collectMessageText, createChatId, createChatRuntime, createChatWorkspace, createManualDriver, createSafeRegistry, detectStreamingMode, guardChatDsl, pairToolTraces, registerCapabilityAction, registerChatComponent, registerChatLayout, registerChatShellComponent, runChatTurn, runRegenerateTurn, useChatAutoScroll, useChatServices, useSidebarDrawer, useSmoothStreamText };
+export { ActivityTrace, type ActivityTraceProps, AppShell, type AppShellProps, ArtifactPanel, type ArtifactPanelProps, type ArtifactPatch, ArtifactStore, type BuiltinMessageAction, CHAT_COMPONENT_TYPE, CHAT_DENIED_TYPE, CHAT_LAYOUT_TYPE, CHAT_SHELL_COMPONENT_TYPE, type CapabilityActionDeps, type CapabilityHandler, Chat, type ChatArtifact, type ChatAttachment, type ChatCapabilityRegistry, type ChatConfirm, type ChatConfirmRequest, type ChatContextItem, type ChatContextSource, ChatDenied, type ChatEvent, type ChatHeaderAction, type ChatInput, ChatLayout, type ChatLayoutProps, type ChatLayoutRegistry, type ChatMenuItem, type ChatMessage, type ChatMessageAction, type ChatModelOption, type ChatPart, type ChatPermissionChecker, type ChatProps, type ChatRole, type ChatRuntime, type ChatScope, type ChatServices, ChatServicesProvider, ChatShell, type ChatShellProps, ChatSidebarMenu, type ChatSuggestion, type ChatTransport, type ChatTurnResult, ChatView, type ChatViewProps, type ChatWorkspaceProps, type ChatWorkspaceServices, Composer, type ComposerProps, ConversationStore, type CreateChatRuntimeOptions, DEFAULT_CHAT_GREETING, EmptyState, type EmptyStateProps, type ManualChatDriver, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, type MessagePatch, type MessageStatus, type PartPatch, type PartRef, PartRenderer, type PartRendererProps, type PartStatus, type RunChatTurnOptions, type StreamingMode, type ToolCallStatus, type ToolTraceEntry, type UseChatAutoScrollOptions, type UseChatAutoScrollResult, type UseSmoothStreamTextOptions, applyChatEvent, buildChatScope, collectMessageText, createChatComponentRegistry, createChatId, createChatRuntime, createChatWorkspace, createManualDriver, createSafeRegistry, detectStreamingMode, guardChatDsl, pairToolTraces, registerCapabilityAction, registerChatComponent, registerChatLayout, registerChatShellComponent, runChatTurn, runRegenerateTurn, useChatAutoScroll, useChatServices, useSidebarDrawer, useSmoothStreamText };