@hgt-weprotalk/mira-client 0.1.8 → 0.1.9

package/README.dev.md

@@ -1,194 +1,194 @@
-# mira-client（内部开发说明）
-
-> **仓库维护者请看本文档。** npm 包页面与 GitHub 首页默认展示 [`README.md`](./README.md)（对外接入说明）。
-
-Mira 用户侧 **Chat Widget（聊天挂件）** 前端工程。
-
-本仓库用 **React 19 + Vite 8 + TypeScript** 搭建开发基座，用于本地预览与联调；**生产交付物**通过 npm 包 `@hgt-weprotalk/mira-client` 发布，宿主（Next.js 独立站）按场景选择三种接入方式之一。
-
-需求文档见 [docs/mira-v1/](./docs/mira-v1/README.md)。
-
-| 层级 | 说明 |
-|------|------|
-| **npm 交付物** | `@hgt-weprotalk/mira-client` — React 库 + Embed 静态资源（`dist/` 仅发布 npm，不进 GitHub） |
-| **基座（Demo Shell）** | `Layout`、`pages/`、`index.html` / `use-cases*.html` — 仅开发预览，非生产交付 |
-| **服务层** | `src/services/` — Java Agent API、Zendesk、反馈、转人工等适配 |
-
-## 架构概览
-
-```
-┌──────────────────────────────────────────────────────────┐
-│  Demo Shell（本地预览）                                    │
-│    首页：React 组件直接挂载 ChatWidget（= 方式 1 生产接入）   │
-│    用例A / 用例B：模拟独立站 script / iframe 接入             │
-└──────────────────────────────────────────────────────────┘
-
-┌──────────────────────────────────────────────────────────┐
-│  Chat Widget                                              │
-│    ChatWidget → useHandoff / useChat → chatApi             │
-│         ↓                                                  │
-│    agentAdapter  ←→  /client/agentChat/*  (SSE + REST)     │
-│    zendesk/*     ←→  Smooch Web Messenger（转人工）          │
-└──────────────────────────────────────────────────────────┘
-```
-
-**分层原则**：UI / Hook 只依赖 `services/` 门面（如 `chatApi`），切换后端时改 adapter 与导出入口即可，Widget UI 无需改动。
-
-## 宿主接入（三种方式）
-
-安装 npm 包：
-
-```bash
-pnpm add @hgt-weprotalk/mira-client
-```
-
-| # | 方式 | 适用 | 说明 |
-|---|------|------|------|
-| **1** | **React 组件** | Next.js App Router（**推荐**） | `import { ChatWidget } from "@hgt-weprotalk/mira-client"`，与本地 Home 页一致 |
-| **2** | **Script Embed（用例 A）** | launcher 弹窗、非 React 页 | 同步 `dist/embed/` → `public/embed/`，加载 `chat-widget.js` + `mira-chat-host.js` |
-| **3** | **Inline iframe（用例 B）** | 宿主自控布局（抽屉/侧栏） | 自行放置 `<iframe src="/embed/frame.html?...">` + host bridge |
-
-详细文档：[20-npm包发布与三种接入方式](./docs/mira-v1/chat-widget/20-npm包发布与三种接入方式.md) · [19-宿主SDK接口](./docs/mira-v1/chat-widget/19-宿主SDK接口.md)（Embed 模式 SDK）
-
-### 方式 1 — React 组件（Next.js 推荐）
-
-参考 `src/reference/nextjs/MiraChatLauncher.tsx`（Valerion 独立站真实接入）：
-
-```tsx
-"use client";
-
-import { ChatWidget, type Locale } from "@hgt-weprotalk/mira-client";
-import "@hgt-weprotalk/mira-client/style.css";
-
-export function MiraChat({ site = "en" }: { site?: string }) {
-  return (
-    <ChatWidget
-      agentName="after_sales_assistant"
-      site={site}
-      apiBaseUrl={process.env.NEXT_PUBLIC_AGENT_API_BASE ?? "/prod-api"}
-      locale={"en-US" satisfies Locale}
-    />
-  );
-}
-```
-
-### 方式 2 — Script Embed（用例 A：launcher 弹窗）
-
-npm 安装后，将 embed 资源同步至 `public/embed/`（推荐 postinstall，见 [20 文档 §1.2](./docs/mira-v1/chat-widget/20-npm包发布与三种接入方式.md#12-方式-2--script-embed用例-alauncher-弹窗)），然后：
-
-```html
-<script
-  src="/embed/chat-widget.js"
-  data-agent-name="after_sales_assistant"
-  data-site="en"
-  defer
-></script>
-<script src="/embed/mira-chat-host.js" defer></script>
-```
-
-用例 A 采用**分离渲染**：宿主页 `chat-widget.js` 负责右下角 launcher 按钮，iframe 内仅渲染聊天面板（`panelOnly`）。本地演示：[use-cases.html](./use-cases.html)
-
-### 方式 3 — Inline iframe（用例 B）
-
-```html
-<iframe
-  id="mira-chat-inline-frame"
-  src="/embed/frame.html?agentName=after_sales_assistant&site=en&parentOrigin={ORIGIN}&layout=inline"
-  style="width: 100%; height: 100%; min-height: 700px; border: 0"
-  allow="clipboard-write"
-></iframe>
-<script src="/embed/mira-chat-host.js" defer></script>
-```
-
-本地演示：[use-cases-b.html](./use-cases-b.html)
-
-### `window.MiraChat` SDK（方式 2 / 3）
-
-| 方法 | 说明 |
-|------|------|
-| `bindUser({ loginUserId, userNickname? })` | 登录后绑定 visitor 历史（`POST /bindUser`） |
-| `setContext({ loginUserId?, userNickname?, product? })` | 传递用户 / 商品上下文 |
-| `open()` / `close()` | 打开 / 关闭聊天容器 |
-| `on("ready" \| "navigate" \| "error", handler)` | 监听 iframe 事件 |
-
-方式 1 直接使用 `setMiraChatUser` / `bindMiraChatUser` 等 import，无需 `window.MiraChat`。
-
-## 目录结构
-
-```
-mira-client/
-├── README.md                  # npm / GitHub 首页（对外）
-├── README.dev.md              # 本文件（内部）
-├── index.html                 # 首页基座（方式 1 预览）
-├── use-cases.html             # 用例A：launcher 弹窗（方式 2）
-├── use-cases-b.html           # 用例B：inline iframe（方式 3）
-├── vite.config.ts             # 开发基座 + /agent-api 代理
-├── vite.lib.config.ts         # npm 库构建
-├── vite.embed*.config.ts      # embed 脚本构建
-│
-├── src/
-│   ├── index.ts               # ★ npm 包公共入口
-│   ├── components/chat-widget/  # ★ Widget UI 源码
-│   ├── embed/                 # launcher / host-bridge / frame 源码
-│   ├── reference/nextjs/      # Next.js 宿主接入参考
-│   ├── hooks/                 # useChat、useHandoff、useZendesk
-│   ├── services/              # chat、zendesk、feedback、handoff
-│   └── pages/                 # Home、UseCases、UseCasesB（基座）
-│
-├── dist/                      # 构建产物（.gitignore，npm publish 时上传）
-└── docs/mira-v1/              # 需求与接口文档
-```
-
-## 配置与环境变量
-
-**重要**：npm 包与 embed 交付物**不依赖**宿主项目的 `.env`。生产环境由独立站通过 **React props**（方式 1）或 **script `data-*` / iframe URL 参数**（方式 2/3）传入运行时配置；本仓库 `.env` **仅用于本地 Demo Shell 开发联调**。
-
-### 开发 vs 生产
-
-| 配置项 | 本地开发（`.env`） | 生产（宿主传参） |
-|--------|-------------------|------------------|
-| Agent 名称 | `VITE_AGENT_NAME` | `agentName` prop 或 `data-agent-name` / URL `agentName` |
-| 站点 | `VITE_AGENT_SITE` | `site` prop 或 `data-site` / URL `site` |
-| Agent API 前缀 | `VITE_AGENT_API_BASE` | `apiBaseUrl` prop 或 `data-api-base-url` / URL `apiBaseUrl` |
-| 代理到 Java 后端 | `VITE_AGENT_API_TARGET`（仅 Vite dev） | **不适用** — 由宿主自行处理 |
-
-### 本地开发 `.env`（示例）
-
-```env
-VITE_AGENT_NAME=after_sales_assistant
-VITE_AGENT_SITE=en
-VITE_AGENT_API_BASE=/agent-api
-VITE_AGENT_API_TARGET=http://localhost:8080
-```
-
-### 生产：后端请求由宿主负责
-
-Widget 内所有 Agent API 请求发往 **`{apiBaseUrl}/client/agentChat/*`**。**如何连到 Java C 端 API 完全由独立站决定**（同域名反代 / BFF / 绝对路径等）。
-
-## 常用命令
-
-```bash
-npm install                 # 安装依赖
-npm run dev                 # 启动开发服务器
-npm run build               # 类型检查 + 库构建 + embed 构建
-npm run build:lib           # 仅 React 库
-npm run build:embed         # 仅 embed 脚本
-npm run typecheck           # TypeScript 检查
-npm run lint                # oxlint
-npm run test:chat-handoff   # 转人工 Playwright 冒烟
-```
-
-**发版（维护者）：**
-
-```bash
-node scripts/release-version.mjs   # bump → npm publish → tag → push
-```
-
-**用例页本地验证**：先 `npm run build:embed`，再 `npm run dev`，访问 `/use-cases.html` 或 `/use-cases-b.html`。
-
-## 生产部署注意
-
-- 宿主通过 `pnpm add @hgt-weprotalk/mira-client@x.y.z` 安装；`dist/` 在 npm 包内，不在 GitHub 仓库。
-- Next.js 推荐 **方式 1**（React 组件），接入与本地 Home 页一致。
-- 方式 2/3 需 postinstall 将 `node_modules/@hgt-weprotalk/mira-client/dist/embed/` 同步至 `public/embed/`。
-- `agentName`、`site`、`apiBaseUrl` 由宿主在接入时传参，**不要在生产依赖本仓库 `.env`**。
+# mira-client（内部开发说明）
+
+> **仓库维护者请看本文档。** npm 包页面与 GitHub 首页默认展示 [`README.md`](./README.md)（对外接入说明）。
+
+Mira 用户侧 **Chat Widget（聊天挂件）** 前端工程。
+
+本仓库用 **React 19 + Vite 8 + TypeScript** 搭建开发基座，用于本地预览与联调；**生产交付物**通过 npm 包 `@hgt-weprotalk/mira-client` 发布，宿主（Next.js 独立站）按场景选择三种接入方式之一。
+
+需求文档见 [docs/mira-v1/](./docs/mira-v1/README.md)。
+
+| 层级 | 说明 |
+|------|------|
+| **npm 交付物** | `@hgt-weprotalk/mira-client` — React 库 + Embed 静态资源（`dist/` 仅发布 npm，不进 GitHub） |
+| **基座（Demo Shell）** | `Layout`、`pages/`、`index.html` / `use-cases*.html` — 仅开发预览，非生产交付 |
+| **服务层** | `src/services/` — Java Agent API、Zendesk、反馈、转人工等适配 |
+
+## 架构概览
+
+```
+┌──────────────────────────────────────────────────────────┐
+│  Demo Shell（本地预览）                                    │
+│    首页：React 组件直接挂载 ChatWidget（= 方式 1 生产接入）   │
+│    用例A / 用例B：模拟独立站 script / iframe 接入             │
+└──────────────────────────────────────────────────────────┘
+
+┌──────────────────────────────────────────────────────────┐
+│  Chat Widget                                              │
+│    ChatWidget → useHandoff / useChat → chatApi             │
+│         ↓                                                  │
+│    agentAdapter  ←→  /client/agentChat/*  (SSE + REST)     │
+│    zendesk/*     ←→  Smooch Web Messenger（转人工）          │
+└──────────────────────────────────────────────────────────┘
+```
+
+**分层原则**：UI / Hook 只依赖 `services/` 门面（如 `chatApi`），切换后端时改 adapter 与导出入口即可，Widget UI 无需改动。
+
+## 宿主接入（三种方式）
+
+安装 npm 包：
+
+```bash
+pnpm add @hgt-weprotalk/mira-client
+```
+
+| # | 方式 | 适用 | 说明 |
+|---|------|------|------|
+| **1** | **React 组件** | Next.js App Router（**推荐**） | `import { ChatWidget } from "@hgt-weprotalk/mira-client"`，与本地 Home 页一致 |
+| **2** | **Script Embed（用例 A）** | launcher 弹窗、非 React 页 | 同步 `dist/embed/` → `public/embed/`，加载 `chat-widget.js` + `mira-chat-host.js` |
+| **3** | **Inline iframe（用例 B）** | 宿主自控布局（抽屉/侧栏） | 自行放置 `<iframe src="/embed/frame.html?...">` + host bridge |
+
+详细文档：[20-npm包发布与三种接入方式](./docs/mira-v1/chat-widget/20-npm包发布与三种接入方式.md) · [19-宿主SDK接口](./docs/mira-v1/chat-widget/19-宿主SDK接口.md)（Embed 模式 SDK）
+
+### 方式 1 — React 组件（Next.js 推荐）
+
+参考 `src/reference/nextjs/MiraChatLauncher.tsx`（Valerion 独立站真实接入）：
+
+```tsx
+"use client";
+
+import { ChatWidget, type Locale } from "@hgt-weprotalk/mira-client";
+import "@hgt-weprotalk/mira-client/style.css";
+
+export function MiraChat({ site = "en" }: { site?: string }) {
+  return (
+    <ChatWidget
+      agentName="after_sales_assistant"
+      site={site}
+      apiBaseUrl={process.env.NEXT_PUBLIC_AGENT_API_BASE ?? "/prod-api"}
+      locale={"en-US" satisfies Locale}
+    />
+  );
+}
+```
+
+### 方式 2 — Script Embed（用例 A：launcher 弹窗）
+
+npm 安装后，将 embed 资源同步至 `public/embed/`（推荐 postinstall，见 [20 文档 §1.2](./docs/mira-v1/chat-widget/20-npm包发布与三种接入方式.md#12-方式-2--script-embed用例-alauncher-弹窗)），然后：
+
+```html
+<script
+  src="/embed/chat-widget.js"
+  data-agent-name="after_sales_assistant"
+  data-site="en"
+  defer
+></script>
+<script src="/embed/mira-chat-host.js" defer></script>
+```
+
+用例 A 采用**分离渲染**：宿主页 `chat-widget.js` 负责右下角 launcher 按钮，iframe 内仅渲染聊天面板（`panelOnly`）。本地演示：[use-cases.html](./use-cases.html)
+
+### 方式 3 — Inline iframe（用例 B）
+
+```html
+<iframe
+  id="mira-chat-inline-frame"
+  src="/embed/frame.html?agentName=after_sales_assistant&site=en&parentOrigin={ORIGIN}&layout=inline"
+  style="width: 100%; height: 100%; min-height: 700px; border: 0"
+  allow="clipboard-write"
+></iframe>
+<script src="/embed/mira-chat-host.js" defer></script>
+```
+
+本地演示：[use-cases-b.html](./use-cases-b.html)
+
+### `window.MiraChat` SDK（方式 2 / 3）
+
+| 方法 | 说明 |
+|------|------|
+| `bindUser({ loginUserId, userNickname? })` | 登录后绑定 visitor 历史（`POST /bindUser`） |
+| `setContext({ loginUserId?, userNickname?, product? })` | 传递用户 / 商品上下文 |
+| `open()` / `close()` | 打开 / 关闭聊天容器 |
+| `on("ready" \| "navigate" \| "error", handler)` | 监听 iframe 事件 |
+
+方式 1 直接使用 `setMiraChatUser` / `bindMiraChatUser` 等 import，无需 `window.MiraChat`。
+
+## 目录结构
+
+```
+mira-client/
+├── README.md                  # npm / GitHub 首页（对外）
+├── README.dev.md              # 本文件（内部）
+├── index.html                 # 首页基座（方式 1 预览）
+├── use-cases.html             # 用例A：launcher 弹窗（方式 2）
+├── use-cases-b.html           # 用例B：inline iframe（方式 3）
+├── vite.config.ts             # 开发基座 + /agent-api 代理
+├── vite.lib.config.ts         # npm 库构建
+├── vite.embed*.config.ts      # embed 脚本构建
+│
+├── src/
+│   ├── index.ts               # ★ npm 包公共入口
+│   ├── components/chat-widget/  # ★ Widget UI 源码
+│   ├── embed/                 # launcher / host-bridge / frame 源码
+│   ├── reference/nextjs/      # Next.js 宿主接入参考
+│   ├── hooks/                 # useChat、useHandoff、useZendesk
+│   ├── services/              # chat、zendesk、feedback、handoff
+│   └── pages/                 # Home、UseCases、UseCasesB（基座）
+│
+├── dist/                      # 构建产物（.gitignore，npm publish 时上传）
+└── docs/mira-v1/              # 需求与接口文档
+```
+
+## 配置与环境变量
+
+**重要**：npm 包与 embed 交付物**不依赖**宿主项目的 `.env`。生产环境由独立站通过 **React props**（方式 1）或 **script `data-*` / iframe URL 参数**（方式 2/3）传入运行时配置；本仓库 `.env` **仅用于本地 Demo Shell 开发联调**。
+
+### 开发 vs 生产
+
+| 配置项 | 本地开发（`.env`） | 生产（宿主传参） |
+|--------|-------------------|------------------|
+| Agent 名称 | `VITE_AGENT_NAME` | `agentName` prop 或 `data-agent-name` / URL `agentName` |
+| 站点 | `VITE_AGENT_SITE` | `site` prop 或 `data-site` / URL `site` |
+| Agent API 前缀 | `VITE_AGENT_API_BASE` | `apiBaseUrl` prop 或 `data-api-base-url` / URL `apiBaseUrl` |
+| 代理到 Java 后端 | `VITE_AGENT_API_TARGET`（仅 Vite dev） | **不适用** — 由宿主自行处理 |
+
+### 本地开发 `.env`（示例）
+
+```env
+VITE_AGENT_NAME=after_sales_assistant
+VITE_AGENT_SITE=en
+VITE_AGENT_API_BASE=/agent-api
+VITE_AGENT_API_TARGET=http://localhost:8080
+```
+
+### 生产：后端请求由宿主负责
+
+Widget 内所有 Agent API 请求发往 **`{apiBaseUrl}/client/agentChat/*`**。**如何连到 Java C 端 API 完全由独立站决定**（同域名反代 / BFF / 绝对路径等）。
+
+## 常用命令
+
+```bash
+npm install                 # 安装依赖
+npm run dev                 # 启动开发服务器
+npm run build               # 类型检查 + 库构建 + embed 构建
+npm run build:lib           # 仅 React 库
+npm run build:embed         # 仅 embed 脚本
+npm run typecheck           # TypeScript 检查
+npm run lint                # oxlint
+npm run test:chat-handoff   # 转人工 Playwright 冒烟
+```
+
+**发版（维护者）：**
+
+```bash
+node scripts/release-version.mjs   # bump → npm publish → tag → push
+```
+
+**用例页本地验证**：先 `npm run build:embed`，再 `npm run dev`，访问 `/use-cases.html` 或 `/use-cases-b.html`。
+
+## 生产部署注意
+
+- 宿主通过 `pnpm add @hgt-weprotalk/mira-client@x.y.z` 安装；`dist/` 在 npm 包内，不在 GitHub 仓库。
+- Next.js 推荐 **方式 1**（React 组件），接入与本地 Home 页一致。
+- 方式 2/3 需 postinstall 将 `node_modules/@hgt-weprotalk/mira-client/dist/embed/` 同步至 `public/embed/`。
+- `agentName`、`site`、`apiBaseUrl` 由宿主在接入时传参，**不要在生产依赖本仓库 `.env`**。

package/dist/components/chat-widget/ChatWidget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatWidget.d.ts","sourceRoot":"","sources":["../../../src/components/chat-widget/ChatWidget.tsx"],"names":[],"mappings":"AAaA,OAAO,EAAyB,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAIhE,OAAO,mBAAmB,CAAC;AAG3B,UAAU,eAAe;IACvB,qCAAqC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wFAAwF;IACxF,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAqLD,yDAAyD;AACzD,QAAA,MAAM,UAAU,GAAI,8EAQjB,eAAe,gCA8MjB,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"ChatWidget.d.ts","sourceRoot":"","sources":["../../../src/components/chat-widget/ChatWidget.tsx"],"names":[],"mappings":"AAaA,OAAO,EAAyB,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAIhE,OAAO,mBAAmB,CAAC;AAK3B,UAAU,eAAe;IACvB,qCAAqC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wFAAwF;IACxF,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAqLD,yDAAyD;AACzD,QAAA,MAAM,UAAU,GAAI,8EAQjB,eAAe,gCA6NjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/components/chat-widget/layoutTokens.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Chat Widget 布局 token（桌面 / 移动端）。
+ * 后续可由 Agent config API 返回 overrides，经 applyChatWidgetLayoutCssVars 写入 DOM。
+ */
+export declare const CHAT_WIDGET_LAYOUT: {
+    readonly panelWidthPx: 520;
+    readonly panelHeightPx: 740;
+    readonly panelViewportTopInsetPx: 16;
+    /** React 直挂：widget bottom(20) + launcher(64) + gap(8) */
+    readonly panelLauncherReservedBlockPx: 92;
+    readonly assistantBubbleMaxWidthPx: 445;
+    readonly assistantBodyMaxWidthPx: 415;
+    readonly mobileBreakpointPx: 680;
+    readonly mobilePanelHorizontalInsetPx: 16;
+    readonly mobilePanelVerticalReservedPx: 84;
+    readonly mobileAssistantBubbleMaxWidth: "98%";
+    readonly mobileAssistantBodyMaxWidth: "calc(100vw - 44px)";
+};
+/** Embed launcher：button bottom + height + gap（与 embedDialogTokens 对齐） */
+export declare const EMBED_PANEL_LAUNCHER_RESERVED_BLOCK_PX: 92;
+export type ChatWidgetLayoutOverrides = Partial<{
+    panelWidthPx: number;
+    panelHeightPx: number;
+    assistantBubbleMaxWidthPx: number;
+    assistantBodyMaxWidthPx: number;
+}>;
+/** 将布局 overrides 转为可在 .chat_widget 或 :root 上设置的 CSS 变量 */
+export declare const layoutOverridesToCssProperties: (overrides: ChatWidgetLayoutOverrides) => Record<string, string>;
+/** 写入布局 CSS 变量（供后续 config API 调用） */
+export declare const applyChatWidgetLayoutCssVars: (element: HTMLElement, overrides?: ChatWidgetLayoutOverrides) => void;
+//# sourceMappingURL=layoutTokens.d.ts.map

package/dist/components/chat-widget/layoutTokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layoutTokens.d.ts","sourceRoot":"","sources":["../../../src/components/chat-widget/layoutTokens.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;IAI7B,yDAAyD;;;;;;;;;CASjD,CAAC;AAEX,0EAA0E;AAC1E,eAAO,MAAM,sCAAsC,IACF,CAAC;AAElD,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAC;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,yBAAyB,EAAE,MAAM,CAAC;IAClC,uBAAuB,EAAE,MAAM,CAAC;CACjC,CAAC,CAAC;AAIH,0DAA0D;AAC1D,eAAO,MAAM,8BAA8B,GACzC,WAAW,yBAAyB,KACnC,MAAM,CAAC,MAAM,EAAE,MAAM,CA0BvB,CAAC;AAEF,qCAAqC;AACrC,eAAO,MAAM,4BAA4B,GACvC,SAAS,WAAW,EACpB,YAAY,yBAAyB,KACpC,IAUF,CAAC"}

package/dist/components/chat-widget/useChatPanelViewportClamp.d.ts

@@ -0,0 +1,7 @@
+import { type RefObject } from "react";
+/**
+ * 桌面端：根据 launcher 在视口中的位置动态收紧面板 max-height，
+ * 避免 chat_panel 上沿超出可视区域（launcher 较靠上时）。
+ */
+export declare const useChatPanelViewportClamp: (widgetRef: RefObject<HTMLElement | null>, enabled: boolean, isPanelVisible: boolean) => void;
+//# sourceMappingURL=useChatPanelViewportClamp.d.ts.map

package/dist/components/chat-widget/useChatPanelViewportClamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatPanelViewportClamp.d.ts","sourceRoot":"","sources":["../../../src/components/chat-widget/useChatPanelViewportClamp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAKxD;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GACpC,WAAW,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EACxC,SAAS,OAAO,EAChB,gBAAgB,OAAO,KACtB,IAoDF,CAAC"}

package/dist/config/runtime.d.ts

@@ -1,4 +1,5 @@
 /** Chat Widget 嵌入脚本运行时配置（由 <script> data 属性注入） */
+import type { ChatWidgetLayoutOverrides } from "../components/chat-widget/layoutTokens";
 export interface HostUserInfo {
     loginUserId: string;
     name: string;
@@ -14,6 +15,8 @@ export interface ChatWidgetRuntimeConfig {
     userNickname?: string;
     hostUser?: HostUserInfo;
     productContext?: Record<string, unknown>;
+    /** 预留：Agent config API 返回的面板 / 气泡尺寸 overrides */
+    layout?: ChatWidgetLayoutOverrides;
 }
 /** 合并更新运行时配置（嵌入脚本 data 属性注入时调用） */
 export declare const setChatWidgetRuntimeConfig: (config: ChatWidgetRuntimeConfig) => void;

package/dist/config/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/config/runtime.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAID,mCAAmC;AACnC,eAAO,MAAM,0BAA0B,GACrC,QAAQ,uBAAuB,KAC9B,IAEF,CAAC;AAEF,8BAA8B;AAC9B,eAAO,MAAM,0BAA0B,QAAO,uBAC/B,CAAC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/config/runtime.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AAExF,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,iDAAiD;IACjD,MAAM,CAAC,EAAE,yBAAyB,CAAC;CACpC;AAID,mCAAmC;AACnC,eAAO,MAAM,0BAA0B,GACrC,QAAQ,uBAAuB,KAC9B,IAEF,CAAC;AAEF,8BAA8B;AAC9B,eAAO,MAAM,0BAA0B,QAAO,uBAC/B,CAAC"}