@toimc/vue 0.0.1 → 0.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 toimc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,374 @@
+# @toimc/vue
+
+Vue 3.5+ AI 聊天界面组件库：对话容器、消息流、提示词输入、思维链、工具调用、多模态附件、引用溯源、GenUI 动态渲染——62 个组件开箱即用，且全部可深度组合。样式经 `@layer` 分层 + `.ai-chat-` 前缀隔离，宿主一行未分层 CSS 即可覆盖任意设计令牌。
+
+组件与 AI 后端完全解耦：数据层来自 [`@toimc/core`](../core) 的 `useChat` + `ChatAdapter` 接口，fetch SSE、mock 剧本、Mastra 网关都能接——本包不持有任何密钥，也不发任何网络请求。
+
+## 安装
+
+```bash
+npm i @toimc/vue
+```
+
+- peer 依赖 `vue ^3.5.0`（宿主自备）
+- `@toimc/core` 为直接依赖，随安装自动带入
+- **`@toimc/markdown` 是 optionalDependencies**：npm 会自动装上，但不是硬依赖（见下）
+
+样式必须显式引入一次（子路径导出，含 Design Token 与全部组件样式）：
+
+```ts
+import '@toimc/vue/style.css'
+```
+
+### Markdown 渲染（可选装配）
+
+不注入渲染器时 `MessageContent` 回退纯文本渲染，不报错。接入 `@toimc/markdown`（Shiki 高亮 + KaTeX 公式 + Mermaid 沙箱 iframe）或任意宿主自制渲染组件，方式二选一：
+
+```ts
+// 方式一：应用入口一次性装配（推荐）——全树消息自动启用 Markdown
+import { markdownRendererKey } from '@toimc/vue'
+import { MarkdownRenderer } from '@toimc/markdown'
+
+app.provide(markdownRendererKey, MarkdownRenderer)
+```
+
+```vue
+<!-- 方式二：组件 setup 中注入 -->
+<script setup lang="ts">
+import { provideMarkdownRenderer } from '@toimc/vue'
+import { MarkdownRenderer } from '@toimc/markdown'
+
+provideMarkdownRenderer(MarkdownRenderer)
+</script>
+```
+
+注入的是「组件」本身——想换渲染实现只需换注入对象，消息组件零改动。
+
+## 最小可用示例
+
+`ChatAdapter` 是唯一需要宿主实现的东西（AsyncGenerator 流式契约）：
+
+```vue
+<script setup lang="ts">
+import '@toimc/vue/style.css'
+import { useChat } from '@toimc/core'
+import {
+  Conversation,
+  ConversationContent,
+  ConversationEmpty,
+  Message,
+  MessageContent,
+  PromptInput,
+  PromptInputTextarea,
+  PromptInputSubmit,
+} from '@toimc/vue'
+import type { ChatAdapter } from '@toimc/core'
+
+const adapter: ChatAdapter = {
+  async *sendMessage({ messages, signal }) {
+    const res = await fetch('/api/chat', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ messages }),
+      signal,
+    })
+    const reader = res.body!.getReader()
+    const decoder = new TextDecoder()
+    while (true) {
+      const { done, value } = await reader.read()
+      if (done) break
+      yield { type: 'text', content: decoder.decode(value, { stream: true }) }
+    }
+    yield { type: 'done', content: '' }
+  },
+}
+
+const chat = useChat(adapter)
+</script>
+
+<template>
+  <Conversation>
+    <ConversationContent>
+      <ConversationEmpty v-if="chat.messages.length === 0">
+        <h3>有什么可以帮你的？</h3>
+      </ConversationEmpty>
+
+      <Message v-for="msg in chat.messages" :key="msg.id" :from="msg.role">
+        <MessageContent>{{ msg.content }}</MessageContent>
+      </Message>
+    </ConversationContent>
+
+    <PromptInput>
+      <PromptInputTextarea @send="(t) => chat.send(t)" />
+      <PromptInputSubmit />
+    </PromptInput>
+  </Conversation>
+</template>
+```
+
+## 组件总览（62 个 · 14 能力域）
+
+每个组件的完整 API（Props / Events / Slots / 交互示例）见文档站对应页（`packages/docs/components/`，仓库根 `pnpm dev:docs` 本地启动）。
+
+### 通用 Shared（10）
+
+流式文本与表单原语、轻提示等无 AI 语义的基础件，均可独立使用。
+
+| 组件 | 职责 |
+| --- | --- |
+| StreamText | 文本逐字流式输出（打字机光标） |
+| Button | 按钮原语 |
+| Input | 输入框原语 |
+| Select | 下拉选择原语 |
+| Radio | 单选原语 |
+| Shimmer | 加载微光占位 |
+| Toast | 轻提示 |
+| LanguageToggle | 中英文切换按钮 |
+| ModelIcon | 模型厂商图标 |
+| JsonDiffView | JSON 差异对比视图 |
+
+文档：[stream-text](../docs/components/stream-text.md) · [button](../docs/components/button.md) · [input](../docs/components/input.md) · [select](../docs/components/select.md) · [radio](../docs/components/radio.md) · [shimmer](../docs/components/shimmer.md) · [toast](../docs/components/toast.md) · [language-toggle](../docs/components/language-toggle.md) · [model-icon](../docs/components/model-icon.md) · [json-diff-view](../docs/components/json-diff-view.md)
+
+### 对话容器 Conversation（4）
+
+对话页骨架：布局容器、滚动消息区、空状态、回到底部。
+
+| 组件 | 职责 |
+| --- | --- |
+| Conversation | 对话布局容器（消息区 + 输入区 + 主题承载） |
+| ConversationContent | 滚动消息区 |
+| ConversationEmpty | 空会话欢迎屏容器 |
+| ConversationScrollBtn | 「回到底部」悬浮按钮（配合 useScrollAnchor 的未读计数） |
+
+文档：[conversation](../docs/components/conversation.md) · [conversation-scroll-btn](../docs/components/conversation-scroll-btn.md)
+
+### 消息 Message（8）
+
+消息项与正文聚合渲染。
+
+| 组件 | 职责 |
+| --- | --- |
+| Message | 消息项布局（按 role 分侧） |
+| MessageContent | 正文聚合：Markdown（注入渲染器）/ 思考块 / 流式三点 / 工具调用卡（GenUI 优先） |
+| MessageActions | 操作按钮容器（hover 显隐） |
+| MessageAction | 单个操作按钮 |
+| MessageAttachments | 消息附件展示区 |
+| ThinkingBlock | 可折叠思考过程块（进行中 / 已完成 / 耗时） |
+| MessageFeedback | 点赞 / 点踩 |
+| BranchPicker | 多分支回复切换（‹ 2/3 ›） |
+
+文档：[message](../docs/components/message.md) · [message-actions](../docs/components/message-actions.md) · [message-feedback](../docs/components/message-feedback.md) · [branch-picker](../docs/components/branch-picker.md)
+
+### 预设操作 MessageAction\*（5）
+
+常用消息操作的开箱预设，均基于 MessageAction 组装。
+
+| 组件 | 职责 |
+| --- | --- |
+| MessageActionCopy | 复制消息全文（配合 useClipboard） |
+| MessageActionRetry | 重新生成 |
+| MessageActionSpeak | 朗读消息（配合 useSpeechOutput） |
+| MessageActionEdit | 编辑后重发 |
+| MessageActionFeedback | 点赞点踩预设 |
+
+文档：[message-actions](../docs/components/message-actions.md)
+
+### 思维链 Thinking（1）
+
+| 组件 | 职责 |
+| --- | --- |
+| ThinkingChain | 多步骤思维链时间线（pending / active / complete / error 分步状态） |
+
+文档：[thinking-chain](../docs/components/thinking-chain.md)
+
+### 提示词输入 PromptInput（12）
+
+自适应输入系统：sendKey 键位切换、IME 组合输入防御、多模态附件管道（上传 / 粘贴 / 拖拽）、建议词触发。
+
+| 组件 | 职责 |
+| --- | --- |
+| PromptInput | 输入容器（组合根） |
+| PromptInputBody | 表单体（label + 控件布局） |
+| PromptInputTextarea | 自适应高度文本域，`@send` 触发发送 |
+| PromptInputHeader | 顶部插槽区 |
+| PromptInputFooter | 底部插槽区 |
+| PromptInputTools | 工具按钮行容器 |
+| PromptInputButton | 通用工具按钮 |
+| PromptInputMicButton | 语音输入按钮（配合 useSpeechInput） |
+| PromptInputSubmit | 发送 / 停止中断双态按钮 |
+| PromptInputUploadButton | 文件上传按钮 |
+| PromptInputAttachments | 待发送附件预览列表 |
+| PromptInputSuggestion | 建议词触发面板（parseSuggestion / filterSuggestions 一并导出） |
+
+文档：[prompt-input](../docs/components/prompt-input.md) · [prompt-input-suggestion](../docs/components/prompt-input-suggestion.md)
+
+### A/B 对比 Comparison（1）
+
+| 组件 | 职责 |
+| --- | --- |
+| ComparisonMessage | A/B 双列对比消息，点选收集用户偏好后原地固化 |
+
+文档：[comparison-message](../docs/components/comparison-message.md)
+
+### 附件展示 Attachment（6）
+
+| 组件 | 职责 |
+| --- | --- |
+| Attachments | 附件列表容器（grid / inline / list 布局） |
+| Attachment | 单个附件卡 |
+| AttachmentPreview | 图片缩略图预览 |
+| AttachmentInfo | 文件名 / 大小信息 |
+| AttachmentRemove | 删除按钮 |
+| AttachmentEmpty | 空状态 |
+
+文档：[attachments](../docs/components/attachments.md)
+
+### 工具调用 ToolCall（6）
+
+| 组件 | 职责 |
+| --- | --- |
+| ToolCall | 工具调用可折叠面板（calling / completed / error 等 6 态状态机） |
+| ToolCallHeader | 面板头：状态图标 + 工具名 + 耗时 |
+| ToolCallContent | 面板展开体 |
+| ToolCallInput | 调用参数 JSON |
+| ToolCallOutput | 执行结果 JSON |
+| ToolConfirmation | 等待人工审批的确认交互 |
+
+文档：[tool-call](../docs/components/tool-call.md) · [tool-confirmation](../docs/components/tool-confirmation.md)
+
+### 引用溯源 Citation（2）
+
+| 组件 | 职责 |
+| --- | --- |
+| InlineCitation | 行内引用角标（悬浮展示 quote 片段） |
+| Sources | 来源列表（http(s) 白名单校验后渲染外链，isSafeHttpUrl 可独立复用） |
+
+文档：[inline-citation](../docs/components/inline-citation.md) · [sources](../docs/components/sources.md)
+
+### GenUI 动态渲染（3）
+
+生成式 UI：schema → 组件注册表 → 动态渲染。
+
+| 组件 | 职责 |
+| --- | --- |
+| GenUIRenderer | UISchema 动态渲染（props 经 sanitizeGenuiProps 消毒，未注册组件回退 ToolCall 面板） |
+| WeatherCard | 内置示例：天气卡 |
+| PlanActions | 内置示例：计划操作组 |
+
+注册表函数一并导出：`registerGenuiComponent` / `resolveGenuiComponent` / `unregisterGenuiComponent`。文档：[genui-renderer](../docs/components/genui-renderer.md)
+
+### 欢迎引导 Welcome（2）
+
+| 组件 | 职责 |
+| --- | --- |
+| Welcome | 首屏欢迎语 |
+| Prompts | 推荐提示词模板（点击即填） |
+
+文档：[welcome](../docs/components/welcome.md)
+
+### 图片预览 Preview（1）
+
+| 组件 | 职责 |
+| --- | --- |
+| ImageLightbox | 灯箱预览（Esc 关闭、方向键翻页），可独立于消息流使用 |
+
+文档：[image-lightbox](../docs/components/image-lightbox.md)
+
+### 模型接入 Provider（1）
+
+| 组件 | 职责 |
+| --- | --- |
+| ProviderSettingsDialog | 自定义模型端点新增 / 编辑 / 删除表单（存储中立，密钥交宿主持有） |
+
+文档：[provider-settings-dialog](../docs/components/provider-settings-dialog.md)
+
+## Composables 与工具函数
+
+来自 `@toimc/core`（纯逻辑，不依赖 DOM）：
+
+| 名称 | 职责 |
+| --- | --- |
+| useChat | 聊天状态机：send / stop、messages、streaming / error 状态 |
+| truncateContext / resolveTokenCount | 上下文窗口裁剪与 token 计数 |
+| estimateTokens | token 估算 |
+| generateId / createUserMessage / createAssistantMessage | ID 与消息工厂 |
+| copyText | 剪贴板写入 |
+| splitAtoms / joinAtoms | Markdown 原子切分与重组（流式增量单元） |
+| isUISchema | GenUI UISchema 判别 |
+
+来自 `@toimc/vue`（依赖 Vue 响应式）：
+
+| 名称 | 职责 |
+| --- | --- |
+| useTheme / resolvedTheme / componentTheme | 明暗主题（模块级单例，见下节） |
+| useThemePreset | 主题预设与自定义变量写入容器根 |
+| useMarkdownRenderer / provideMarkdownRenderer | Markdown 渲染器注入通道（见上文装配示例） |
+| useScrollAnchor | 滚动锚定：isAtBottom / 未读计数 / scrollToBottom / bindContainer |
+| useClipboard | copyText 的响应式包装（copied 状态自动复位） |
+| useLayoutConfig | 结构化布局配置 → CSS 变量字典 + Conversation 布局 props |
+| useSpeechInput | 语音输入（Web Speech API 识别） |
+| useSpeechOutput / splitSentences | 语音朗读与按句切分 |
+| compressImageToDataUrl | 图片压缩为 JPEG dataUrl（发送用 dataUrl、预览用 url 分离） |
+| aiChatI18n / setAiChatLocale / getInitialLocale | 国际化（见下节） |
+| tokensMeta | 设计令牌元数据（令牌定制参考） |
+| registerGenuiComponent 等注册表函数 | GenUI 组件注册（见上文 GenUI 节） |
+
+## 主题与国际化
+
+### 明暗主题
+
+`useTheme` 是模块级单例：多处调用共享状态，`'light' | 'dark' | 'system'` 三模式，`system` 跟随 `prefers-color-scheme`；解析结果自动写入 `data-theme` 属性，写入位置由 `target` 决定——`'html'`（默认，写宿主根）或 `'component'`（写组件根子树，不碰宿主 `<html>`）。默认持久化到 `localStorage['ai-chat-theme']`，SSR 安全。
+
+```ts
+import { useTheme } from '@toimc/vue'
+
+const { theme, resolvedTheme, setTheme, toggleTheme } = useTheme()
+setTheme('dark') // 'light' | 'dark' | 'system'
+toggleTheme()
+```
+
+### 主题预设
+
+`presets` 内置四套 accent 色阶预设：`default`（默认靛蓝）/ `purple`（优雅紫）/ `green`（自然绿）/ `warm`（暖橙），经 `useThemePreset` 应用到容器根 inline style，只替换原始层 accent 变量、不动语义层。
+
+### CSS Variables 覆盖
+
+组件全部引用 `--ai-chat-*` 令牌，且令牌定义在 `ai-chat-tokens` 层内——宿主一行**未分层** CSS 即可覆盖，无需 `!important`：
+
+```css
+:root {
+  --ai-chat-color-accent-500: #8b5cf6;
+}
+```
+
+### 国际化
+
+内置 `zh-CN` / `en-US` 双语字典，`zh-CN` 为 source of truth，`en-US` 以 `satisfies MessageSchema` 锁定 key 结构（缺 key / 写错 key 编译期报错）。初始化按「已存偏好 → 浏览器语言 → zh-CN」兜底：
+
+```ts
+import { aiChatI18n, setAiChatLocale } from '@toimc/vue'
+
+setAiChatLocale('en-US') // 写 locale + 同步 <html lang> + 持久化
+```
+
+## 特色能力
+
+- **流式渲染**：`StreamText` 打字机光标；`StreamChunk` 契约（text / tool_call / thinking / error / done）贯穿组件层，正文流式期间思考块结束时光标不双闪。
+- **思维链**：`ThinkingBlock` 单消息可折叠思考块；`ThinkingChain` 多步骤时间线，分步 pending / active / complete / error。
+- **工具调用**：`ToolCall` 六态面板 + `ToolConfirmation` 人工审批；`MessageContent` 传 `toolCalls` 即渲染（opt-in），时序上卡片置于总结文字之前。
+- **多模态**：`PromptInputUploadButton` / `PromptInputAttachments` 承接上传 / 粘贴 / 拖拽；`compressImageToDataUrl` 压缩图片（预览走 blob url、发送走 dataUrl）；`ImageLightbox` 全屏预览。
+- **GenUI**：`GenUIRenderer` 按 UISchema 从注册表取组件动态渲染，props 经 `sanitizeGenuiProps` 消毒，未注册回退 ToolCall 面板——工具结果从 JSON 变成真正的 UI。
+- **语音**：`useSpeechInput` 识别 + `PromptInputMicButton` 输入；`useSpeechOutput` 朗读 + `MessageActionSpeak` 一键播报，按句切分驱动。
+- **A/B 对比**：`ComparisonMessage` 双列对比，点选即收集偏好并原地固化。
+- **引用溯源**：`InlineCitation` 行内角标悬浮展示引文，`Sources` 来源列表仅放行 http(s) 外链。
+
+## 相关包
+
+| 包 | 说明 |
+| --- | --- |
+| [@toimc/core](../core) | 核心类型与 useChat / ChatAdapter（本包运行时依赖） |
+| [@toimc/markdown](../markdown) | Markdown 渲染：Shiki + KaTeX + Mermaid 沙箱（可选依赖，见上文装配） |
+| [@toimc/agents](../agents) | 服务端模型适配层（多协议适配器） |
+| [@toimc/server](../server) | Hono 聊天网关（SSE） |
+
+完整文档在仓库 `packages/docs/`（VitePress）：33 个组件页 + 7 个 composable 页，Props / Events / Slots 全表与交互示例；仓库根 `pnpm dev:docs` 本地启动。

package/dist/attachment/Attachment.vue.d.ts

@@ -2,10 +2,12 @@ import { Attachment } from '@toimc/core';
 type __VLS_Props = {
     data: Attachment;
 };
-declare var __VLS_1: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
+declare const __VLS_template: () => {
+    __VLS_Slots: {
+        default?: (props: {}) => any;
+    };
 };
+type __VLS_Slots = ReturnType<typeof __VLS_template>['__VLS_Slots'];
 declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/attachment/Attachment.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Attachment.vue.d.ts","sourceRoot":"","sources":["../../src/attachment/Attachment.vue"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,KAAK,WAAW,GAAG;IACjB,IAAI,EAAE,UAAU,CAAA;CACjB,CAAC;AAyBF,QAAA,IAAI,OAAO,IAAW,CAAE;AACxB,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,CAAC;AAG/C,QAAA,MAAM,UAAU,kSAEd,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AACzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}
+{"version":3,"file":"Attachment.vue.d.ts","sourceRoot":"","sources":["../../src/attachment/Attachment.vue"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAI7C,KAAK,WAAW,GAAG;IACjB,IAAI,EAAE,UAAU,CAAA;CACjB,CAAC;AAiBF,QAAA,MAAM,cAAc;;kBASN,CAAC,KAAK,IAAgB,KAAK,GAAG;;CAI3C,CAAC;AACF,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,aAAa,CAAC,CAAC;AAEpE,QAAA,MAAM,UAAU,kSAEd,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AACzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}

package/dist/attachment/AttachmentEmpty.vue.d.ts

@@ -1,7 +1,9 @@
-declare var __VLS_1: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
+declare const __VLS_template: () => {
+    __VLS_Slots: {
+        default?: (props: {}) => any;
+    };
 };
+type __VLS_Slots = ReturnType<typeof __VLS_template>['__VLS_Slots'];
 declare const __VLS_base: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/attachment/AttachmentEmpty.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AttachmentEmpty.vue.d.ts","sourceRoot":"","sources":["../../src/attachment/AttachmentEmpty.vue"],"names":[],"mappings":"AAkDA,QAAA,IAAI,OAAO,IAAW,CAAE;AACxB,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,CAAC;AAK/C,QAAA,MAAM,UAAU,+QACd,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AACzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}
+{"version":3,"file":"AttachmentEmpty.vue.d.ts","sourceRoot":"","sources":["../../src/attachment/AttachmentEmpty.vue"],"names":[],"mappings":"AAmCA,QAAA,MAAM,cAAc;;kBAUN,CAAC,KAAK,IAAgB,KAAK,GAAG;;CAM3C,CAAC;AACF,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,aAAa,CAAC,CAAC;AAEpE,QAAA,MAAM,UAAU,+QACd,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AACzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}

package/dist/attachment/AttachmentInfo.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AttachmentInfo.vue.d.ts","sourceRoot":"","sources":["../../src/attachment/AttachmentInfo.vue"],"names":[],"mappings":"AAwFA,QAAA,MAAM,YAAY,+QAChB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}
+{"version":3,"file":"AttachmentInfo.vue.d.ts","sourceRoot":"","sources":["../../src/attachment/AttachmentInfo.vue"],"names":[],"mappings":"AAmFA,QAAA,MAAM,YAAY,+QAChB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}

package/dist/attachment/AttachmentRemove.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AttachmentRemove.vue.d.ts","sourceRoot":"","sources":["../../src/attachment/AttachmentRemove.vue"],"names":[],"mappings":"AA0GA,QAAA,MAAM,YAAY;;;;iFAEhB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}
+{"version":3,"file":"AttachmentRemove.vue.d.ts","sourceRoot":"","sources":["../../src/attachment/AttachmentRemove.vue"],"names":[],"mappings":"AA+GA,QAAA,MAAM,YAAY;;;;iFAEhB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}

package/dist/attachment/Attachments.vue.d.ts

@@ -1,12 +1,14 @@
 type __VLS_Props = {
     variant?: 'grid' | 'inline' | 'list';
 };
-declare var __VLS_1: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
+declare const __VLS_template: () => {
+    __VLS_Slots: {
+        default?: (props: {}) => any;
+    };
 };
+type __VLS_Slots = ReturnType<typeof __VLS_template>['__VLS_Slots'];
 declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    variant: "grid" | "inline" | "list";
+    variant: "list" | "grid" | "inline";
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/attachment/Attachments.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Attachments.vue.d.ts","sourceRoot":"","sources":["../../src/attachment/Attachments.vue"],"names":[],"mappings":"AAuCA,KAAK,WAAW,GAAG;IACf,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAA;CACrC,CAAC;AA4BJ,QAAA,IAAI,OAAO,IAAW,CAAE;AACxB,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,CAAC;AAK/C,QAAA,MAAM,UAAU;aApCF,MAAM,GAAG,QAAQ,GAAG,MAAM;6EAuCtC,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}
+{"version":3,"file":"Attachments.vue.d.ts","sourceRoot":"","sources":["../../src/attachment/Attachments.vue"],"names":[],"mappings":"AAyCA,KAAK,WAAW,GAAG;IACf,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAA;CACrC,CAAC;AAoBJ,QAAA,MAAM,cAAc;;kBAUN,CAAC,KAAK,IAAgB,KAAK,GAAG;;CAM3C,CAAC;AACF,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,aAAa,CAAC,CAAC;AAEpE,QAAA,MAAM,UAAU;;6EAGd,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}

package/dist/citation/InlineCitation.vue.d.ts

@@ -0,0 +1,19 @@
+import { MessageSource } from '@toimc/core';
+interface Props {
+    /** 显示编号，从 1 起 */
+    index: number;
+    /** 该角标关联的来源；多来源时卡片内轮播 */
+    sources: MessageSource[];
+    /** 悬浮卡宽度 px，默认 300 */
+    cardWidth?: number;
+}
+declare const __VLS_export: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    select: (source: MessageSource) => any;
+}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{
+    onSelect?: ((source: MessageSource) => any) | undefined;
+}>, {
+    cardWidth: number;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;
+//# sourceMappingURL=InlineCitation.vue.d.ts.map

package/dist/citation/InlineCitation.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InlineCitation.vue.d.ts","sourceRoot":"","sources":["../../src/citation/InlineCitation.vue"],"names":[],"mappings":"AA8RA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAMhD,UAAU,KAAK;IACb,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,yBAAyB;IACzB,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AA4KD,QAAA,MAAM,YAAY;;;;;;6EAIhB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}

package/dist/citation/Sources.vue.d.ts

@@ -0,0 +1,40 @@
+import { MessageSource } from '@toimc/core';
+interface Props {
+    sources: MessageSource[];
+    /** 分组标题，默认 i18n citation.sources（含计数） */
+    title?: string;
+    /** 横排徽标模式（Popover 展示详情）；默认 false = 折叠列表 */
+    inline?: boolean;
+    /** inline 模式最多直接显示数，超出折叠进 Popover，默认 3 */
+    maxInline?: number;
+    /** 初始展开态（非 inline 模式），默认 false 折叠 */
+    defaultOpen?: boolean;
+}
+declare const __VLS_template: () => {
+    __VLS_Slots: {
+        source?: (props: {
+            source: MessageSource;
+            index: number;
+        }) => any;
+    };
+};
+type __VLS_Slots = ReturnType<typeof __VLS_template>['__VLS_Slots'];
+declare const __VLS_base: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    select: (source: MessageSource, index: number) => any;
+}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{
+    onSelect?: ((source: MessageSource, index: number) => any) | undefined;
+}>, {
+    title: string;
+    inline: boolean;
+    maxInline: number;
+    defaultOpen: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+//# sourceMappingURL=Sources.vue.d.ts.map

package/dist/citation/Sources.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sources.vue.d.ts","sourceRoot":"","sources":["../../src/citation/Sources.vue"],"names":[],"mappings":"AAgXA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAMhD,UAAU,KAAK;IACb,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2CAA2C;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qCAAqC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAiED,QAAA,MAAM,cAAc;;iBAgOP,CAAC,KAAK;;;SAAgB,KAAK,GAAG;;CAM1C,CAAC;AACF,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,aAAa,CAAC,CAAC;AAEpE,QAAA,MAAM,UAAU;;;;;;;;;6EAId,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}

package/dist/citation/index.d.ts

@@ -0,0 +1,4 @@
+export { default as InlineCitation } from './InlineCitation.vue';
+export { default as Sources } from './Sources.vue';
+export { isSafeHttpUrl } from './url';
+//# sourceMappingURL=index.d.ts.map

package/dist/citation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/citation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA"}

package/dist/citation/url.d.ts

@@ -0,0 +1,3 @@
+/** http(s) 白名单校验（frontend-security 第 4 条）：url 型来源渲染外链前必须通过 */
+export declare function isSafeHttpUrl(url: string): boolean;
+//# sourceMappingURL=url.d.ts.map

package/dist/citation/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/citation/url.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOlD"}

package/dist/comparison/ComparisonMessage.vue.d.ts

@@ -9,20 +9,22 @@ type __VLS_Props = {
     stackOnMobile?: boolean;
     disabled?: boolean;
 };
-declare var __VLS_1: {
-    label: string;
-}, __VLS_8: {}, __VLS_10: {
-    label: string;
-}, __VLS_17: {};
-type __VLS_Slots = {} & {
-    left?: (props: typeof __VLS_1) => any;
-} & {
-    'action-left'?: (props: typeof __VLS_8) => any;
-} & {
-    right?: (props: typeof __VLS_10) => any;
-} & {
-    'action-right'?: (props: typeof __VLS_17) => any;
+declare const __VLS_template: () => {
+    __VLS_Slots: {
+        left?: (props: {
+            label: string;
+        }) => any;
+    } & {
+        'action-left'?: (props: {}) => any;
+    } & {
+        right?: (props: {
+            label: string;
+        }) => any;
+    } & {
+        'action-right'?: (props: {}) => any;
+    };
 };
+type __VLS_Slots = ReturnType<typeof __VLS_template>['__VLS_Slots'];
 declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     prefer: (args_0: {
         chosen: Side;

package/dist/comparison/ComparisonMessage.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ComparisonMessage.vue.d.ts","sourceRoot":"","sources":["../../src/comparison/ComparisonMessage.vue"],"names":[],"mappings":"AAiMA,KAAK,IAAI,GAAG,GAAG,GAAG,GAAG,CAAA;AAErB,KAAK,WAAW,GAAG;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAC;AAwKJ,QAAA,IAAI,OAAO;;CAAU,EAAE,OAAO,IAAU,EAAE,QAAQ;;CAAU,EAAE,QAAQ,IAAY,CAAE;AACpF,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,GACzC;IAAE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,OAAO,KAAK,GAAG,CAAA;CAAE,GAClD;IAAE,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,GAC3C;IAAE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,CAAC;AAKvD,QAAA,MAAM,UAAU;;gBAhKK,IAAI;cAAQ,MAAM;eAAS,MAAM;;;;gBAAjC,IAAI;cAAQ,MAAM;eAAS,MAAM;;;cAnBvC,OAAO;YAHT,IAAI,GAAG,IAAI;mBAEJ,OAAO;6EAwLzB,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}
+{"version":3,"file":"ComparisonMessage.vue.d.ts","sourceRoot":"","sources":["../../src/comparison/ComparisonMessage.vue"],"names":[],"mappings":"AAmMA,KAAK,IAAI,GAAG,GAAG,GAAG,GAAG,CAAA;AAErB,KAAK,WAAW,GAAG;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAC;AAwDJ,QAAA,MAAM,cAAc;;eAgHT,CAAC,KAAK;;SAAgB,KAAK,GAAG;;wBACrB,CAAC,KAAK,IAAgB,KAAK,GAAG;;gBACtC,CAAC,KAAK;;SAAiB,KAAK,GAAG;;yBACtB,CAAC,KAAK,IAAiB,KAAK,GAAG;;CAMnD,CAAC;AACF,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,aAAa,CAAC,CAAC;AAEpE,QAAA,MAAM,UAAU;;gBAlKK,IAAI;cAAQ,MAAM;eAAS,MAAM;;;;gBAAjC,IAAI;cAAQ,MAAM;eAAS,MAAM;;;;;;6EAsKpD,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}

package/dist/composables/useClipboard.d.ts

@@ -0,0 +1,7 @@
+import { Ref } from 'vue';
+/** copyText 的响应式包装：复制成功后 copied 置 true，resetDelay 毫秒后自动复位 */
+export declare function useClipboard(resetDelay?: number): {
+    copied: Ref<boolean>;
+    copy: (text: string) => Promise<boolean>;
+};
+//# sourceMappingURL=useClipboard.d.ts.map

package/dist/composables/useClipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClipboard.d.ts","sourceRoot":"","sources":["../../src/composables/useClipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AAGpE,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,UAAU,SAAO,GAAG;IAC/C,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IACpB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CACzC,CAoCA"}

package/dist/composables/useScrollAnchor.d.ts

@@ -1,6 +1,8 @@
 import { Ref } from 'vue';
 export interface ScrollAnchorContext {
     isAtBottom: Ref<boolean>;
+    /** 离底期间容器内容新增导致的未读计数（贴底时恒为 0） */
+    unreadCount: Ref<number>;
     scrollToBottom: () => void;
     bindContainer: (el: HTMLElement | null) => void;
 }

package/dist/composables/useScrollAnchor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useScrollAnchor.d.ts","sourceRoot":"","sources":["../../src/composables/useScrollAnchor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AAEnC,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IACxB,cAAc,EAAE,MAAM,IAAI,CAAA;IAC1B,aAAa,EAAE,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;CAChD;AAED,wBAAgB,eAAe,CAAC,SAAS,SAAK,GAAG,mBAAmB,CAqCnE"}
+{"version":3,"file":"useScrollAnchor.d.ts","sourceRoot":"","sources":["../../src/composables/useScrollAnchor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AAEnC,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IACxB,iCAAiC;IACjC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACxB,cAAc,EAAE,MAAM,IAAI,CAAA;IAC1B,aAAa,EAAE,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;CAChD;AAED,wBAAgB,eAAe,CAAC,SAAS,SAAK,GAAG,mBAAmB,CA+EnE"}