@pactor-app/chat 1.1.0 → 1.2.0

package/README.md

@@ -21,7 +21,7 @@ import '@pactor-app/chat/styles.css';
 ## 示例
 
 ```tsx
-import { createShadcnComponentRegistry } from '@pactor-app/ui/components';
+import { createComponentRegistry } from '@pactor-app/ui/components';
 import {
   ChatView,
   ConversationStore,
@@ -31,7 +31,7 @@ import {
 
 const store = new ConversationStore();
 // Safe Registry：LLM 生成的 DSL 只渲染白名单内的组件
-const safeRegistry = createSafeRegistry(createShadcnComponentRegistry(), [
+const safeRegistry = createSafeRegistry(createComponentRegistry(), [
   'Statistic',
   'Card',
 ]);
@@ -78,6 +78,7 @@ driver.complete();
 - **`<AppShell sidebar brand? locationKey? className?>`**：应用外壳——侧栏插槽 + 主区。桌面（≥768px）侧栏与主区 flex 同行；移动端（<768px）侧栏退出文档流变为覆盖抽屉（遮罩 + 顶栏菜单按钮 + `brand` 品牌区），断点由 CSS 媒体查询表达，JS 只管开合。抽屉打开时 Escape / 遮罩点击关闭；`locationKey` 变化（路由 / 会话切换）渲染期自动关闭；移动端关闭时侧栏容器 `inert`。侧栏内容经 `useSidebarDrawer()` 取 `{ close }`（壳外返回 null），导航后可关闭抽屉。
 - **`registerChatLayout(layoutRegistry)`**：注册 `chat` 布局（header 标题区 + ChatView 区，V1 无会话历史侧栏），`resolveLayout(registry, 'chat')` 命中。
 - **`Chat` / `registerChatComponent(registry)`**：一等 DSL 聊天工作区组件，见下节。
+- **`createChatComponentRegistry()`**：便捷工厂——创建含全部内置组件 + Chat / ChatShell 的组件注册表，直接作为 `createPactorApplication` 的 `componentRegistry` 选项。
 - **`createChatWorkspace(services)`**：React 直连路径的工作区工厂（内部与 Chat 共用同一组合），见下文「DSL 页面：createChatWorkspace」。
 
 ## Chat：一等 DSL 组件

package/dist/index.cjs

@@ -45,6 +45,7 @@ __export(index_exports, {
   applyChatEvent: () => applyChatEvent,
   buildChatScope: () => buildChatScope,
   collectMessageText: () => collectMessageText,
+  createChatComponentRegistry: () => createChatComponentRegistry,
   createChatId: () => createChatId,
   createChatRuntime: () => createChatRuntime,
   createChatWorkspace: () => createChatWorkspace,
@@ -4188,6 +4189,11 @@ function registerChatComponent(registry) {
   }
   registerChatShellComponent(registry);
 }
+function createChatComponentRegistry() {
+  const registry = (0, import_components12.createComponentRegistry)();
+  registerChatComponent(registry);
+  return registry;
+}
 
 // src/view/ChatLayout.tsx
 var import_jsx_runtime22 = require("react/jsx-runtime");
@@ -4230,6 +4236,7 @@ function registerChatLayout(layoutRegistry) {
   applyChatEvent,
   buildChatScope,
   collectMessageText,
+  createChatComponentRegistry,
   createChatId,
   createChatRuntime,
   createChatWorkspace,

package/dist/index.d.cts

@@ -1016,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）：
@@ -1463,7 +1477,7 @@ declare const CHAT_LAYOUT_TYPE = "chat";
  * 结构化 LayoutRegistry（兼容 @pactor-app/ui layout 层的 LayoutRegistry =
  * Registry<LayoutComponent>）：结构化类型声明，调用方传入 ui layout 层
  * 的注册表即天然兼容（历史为零依赖约定而设；chat-icon-convergence 起
- * chat 正式依赖 ui kit，本结构化声明保留以收窄本文件的 API 面）。
+ * chat 正式依赖 @pactor-app/ui，本结构化声明保留以收窄本文件的 API 面）。
  */
 interface ChatLayoutRegistry {
     has(name: string): boolean;
@@ -1472,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, 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

@@ -1016,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）：
@@ -1463,7 +1477,7 @@ declare const CHAT_LAYOUT_TYPE = "chat";
  * 结构化 LayoutRegistry（兼容 @pactor-app/ui layout 层的 LayoutRegistry =
  * Registry<LayoutComponent>）：结构化类型声明，调用方传入 ui layout 层
  * 的注册表即天然兼容（历史为零依赖约定而设；chat-icon-convergence 起
- * chat 正式依赖 ui kit，本结构化声明保留以收窄本文件的 API 面）。
+ * chat 正式依赖 @pactor-app/ui，本结构化声明保留以收窄本文件的 API 面）。
  */
 interface ChatLayoutRegistry {
     has(name: string): boolean;
@@ -1472,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, 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.js

@@ -3847,7 +3847,7 @@ function createChatWorkspace(services) {
 }
 
 // src/view/Chat.tsx
-import { Icon as Icon11, RailTooltip } from "@pactor-app/ui/components";
+import { createComponentRegistry, Icon as Icon11, RailTooltip } from "@pactor-app/ui/components";
 import { Fragment as Fragment10, useEffect as useEffect10, useRef as useRef13 } from "react";
 
 // src/view/chrome/menu.tsx
@@ -4144,6 +4144,11 @@ function registerChatComponent(registry) {
   }
   registerChatShellComponent(registry);
 }
+function createChatComponentRegistry() {
+  const registry = createComponentRegistry();
+  registerChatComponent(registry);
+  return registry;
+}
 
 // src/view/ChatLayout.tsx
 import { jsx as jsx22, jsxs as jsxs14 } from "react/jsx-runtime";
@@ -4185,6 +4190,7 @@ export {
   applyChatEvent,
   buildChatScope,
   collectMessageText,
+  createChatComponentRegistry,
   createChatId,
   createChatRuntime,
   createChatWorkspace,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pactor-app/chat",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Pactor chat: AI message rendering protocol (message model, streaming reducer, safe registry, capability action) and chat runtime view (ChatView / MessageBubble / PartRenderer / Composer / chat layout)",
   "keywords": [
     "pactor",
@@ -49,11 +49,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@pactor-app/ui": "1.1.0",
-    "@pactor-app/permission": "1.1.0",
-    "@pactor-app/markdown": "1.1.0",
-    "@pactor-app/core": "1.1.0",
-    "@pactor-app/runtime": "1.1.0"
+    "@pactor-app/core": "1.2.0",
+    "@pactor-app/markdown": "1.2.0",
+    "@pactor-app/permission": "1.2.0",
+    "@pactor-app/runtime": "1.2.0",
+    "@pactor-app/ui": "1.2.0"
   },
   "peerDependencies": {
     "react": ">=18"

package/styles.css

@@ -68,7 +68,6 @@
   height: 100%;
   gap: 12px;
   color: var(--pactor-chat-fg);
-  background: var(--pactor-chat-bg);
   font-size: 14px;
   line-height: 1.6;
 }
@@ -183,7 +182,6 @@
   width: 100%;
   max-width: var(--pactor-chat-content-width);
   margin-inline: auto;
-  background: var(--pactor-chat-bg);
   color: var(--pactor-chat-fg);
   font-size: 14px;
   line-height: 1.6;
@@ -314,6 +312,7 @@
   width: 100%;
   min-height: 0;
   overflow: hidden;
+  background: var(--pactor-chat-bg);
 }
 
 /* 面板打开时 host 内的直子：AppShell 填满剩余空间；workspace 只缩不伸，
@@ -620,7 +619,8 @@
 
 
 /* 消息滚动区：overflow-anchor none 配合 useChatAutoScroll（防浏览器
-   滚动锚定与贴底跟随互相拉扯）；上下 mask 渐隐 + 6px 细滚动条 */
+   滚动锚定与贴底跟随互相拉扯）；上下 mask 渐隐 + 6px 细滚动条；
+   顶部留 24px 内边距（与 mask 渐隐带同宽，首条消息不贴顶） */
 .pactor-chat-messages {
   position: relative;
   flex: 1;
@@ -630,7 +630,7 @@
   display: flex;
   flex-direction: column;
   gap: 16px;
-  padding: 4px 2px;
+  padding: 24px 2px 4px;
   scrollbar-width: thin;
   scrollbar-color: var(--pactor-chat-border) transparent;
   -webkit-mask-image: linear-gradient(