weifuwu 0.89.1 → 0.90.0

package/dist/client/components/AlertGroup/AlertGroup.d.ts

@@ -6,7 +6,7 @@
  *
  *   <AlertGroup items={[{ id, message, time }]} onClose={...} />
  *
- * 裁剪（CS-05，见 design/components-cuts.md）：合并阈值固定 3 条起（少于此退化为平铺）；
+ * 裁剪（CS-05，见 docs/client.md）：合并阈值固定 3 条起（少于此退化为平铺）；
  * 不做时间线分组/虚拟化。
  */
 import type { Component } from '../../vdom/index.ts';

package/dist/client/components/Anchor/Anchor.d.ts

@@ -3,7 +3,7 @@
  *
  * 锚点导航（长文页）：items 列表 + 滚动高亮跟随 + 点击平滑滚动。
  * 滚动侦听：ctx.ui.useScrollPosition（全局/容器 scroll 监听 + rAF 节流，内置方案）。
- * 裁剪（CS-05，见 design/components-cuts.md）：嵌套滚动容器、滚动容器非视口（container 未提供时仅视口）、自动生成标题锚点。
+ * 裁剪（CS-05，见 docs/client.md）：嵌套滚动容器、滚动容器非视口（container 未提供时仅视口）、自动生成标题锚点。
  */
 import type { Component } from '../../vdom/index.ts';
 export interface AnchorItem {

package/dist/client/components/AutoComplete/AutoComplete.d.ts

@@ -10,7 +10,7 @@
  *     value={query} onChange={setQuery}
  *   />
  *
- * 裁剪（CS-05，见 design/components-cuts.md）：不做分组/虚拟化候选（Select searchable 覆盖分组场景）；
+ * 裁剪（CS-05，见 docs/client.md）：不做分组/虚拟化候选（Select searchable 覆盖分组场景）；
  * 自定义渲染用 `renderOption` 透传。
  */
 import type { Component } from '../../vdom/index.ts';

package/dist/client/components/AvatarGroup/AvatarGroup.d.ts

@@ -3,7 +3,7 @@
  *
  * 堆叠头像组（负 margin 重叠）+ max 溢出显示 +N。
  * 用于群聊成员、协作人列表。
- * 裁剪（CS-05，见 design/components-cuts.md）：hover 展开 tooltip（Tooltip 可组合）。
+ * 裁剪（CS-05，见 docs/client.md）：hover 展开 tooltip（Tooltip 可组合）。
  */
 import type { Component } from '../../vdom/index.ts';
 import { type AvatarProps } from '../Avatar/Avatar.ts';

package/dist/client/components/BackTop/BackTop.d.ts

@@ -2,15 +2,22 @@ import type { Component } from '../../vdom/index.ts';
 export interface BackTopProps {
     /** 滚动超过此高度显示（px），默认 400 */
     visibilityHeight?: number;
-    /** 滚动容器（默认 window） */
-    target?: () => HTMLElement | Window;
+    /** 滚动容器（默认 window；未就绪返回 null——attach 等待 render 重试） */
+    target?: () => HTMLElement | Window | null;
     /** 平滑滚动，默认 true */
     smooth?: boolean;
+    /** 方向（默认 'top'——回顶；'bottom'——聊天流回底浮钮） */
+    direction?: 'top' | 'bottom';
+    /** fixed 定位（默认 true——页面级）；容器内浮钮传 false（absolute——祖先需 position:relative） */
+    fixed?: boolean;
     'aria-label'?: string;
     children?: any;
     className?: string;
 }
-/** 回到顶部（对应 EP Backtop / antd FloatButton.BackTop）：滚动超阈值显示，点击回顶
- * 实现：ctx.ui.useInView（IO 封装）观察文档顶部哨兵——rootMargin 顶部向外扩展
- * visibilityHeight，哨兵离开扩展区（= 滚动超阈值）→ 显示。无 scroll 监听、无警告。 */
+/** 回到顶部/底部（对应 EP Backtop / antd FloatButton.BackTop）：滚动超阈值显示，点击回位
+ *
+ * 实现：scroll 监听（window/容器统一——阈值翻转才重渲染——无轮询无 IO）。
+ * 历史：IO 哨兵方案（useInView 观察 absolute 哨兵）在「容器滚动 + 组件渲染在
+ * 容器外」组合失效（sentinel 固定于 root 可视区——isIn 恒 true——浮钮永不显示——
+ * agent-browser 实测 2026-09）——chat 首用暴露——统一 scroll 监听。 */
 export declare const BackTop: Component<BackTopProps>;

package/dist/client/components/Button/Button.d.ts

@@ -11,6 +11,8 @@ export interface ButtonProps {
     id?: string;
     /** 透传原生 class（覆盖默认 wf-btn 组合） */
     class?: string;
+    /** 透传无障碍标签（读屏/测试定位——按钮常仅图标无文本，name 缺失即死读屏路径） */
+    'aria-label'?: string;
     onClick?: (e: MouseEvent) => void;
     children?: any;
 }

package/dist/client/components/Calendar/Calendar.d.ts

@@ -17,5 +17,5 @@ export interface CalendarProps {
     'aria-label'?: string;
 }
 /** 月历（对应 antd/EP Calendar）：月视图网格 + 事件点 + 月切换 + 日期选择。
- * 裁剪（CS-05，见 design/components-cuts.md）：周/日视图、拖拽创建事件、事件详情弹层。 */
+ * 裁剪（CS-05，见 docs/client.md）：周/日视图、拖拽创建事件、事件详情弹层。 */
 export declare const Calendar: Component<CalendarProps>;

package/dist/client/components/Carousel/Carousel.d.ts

@@ -13,5 +13,5 @@ export interface CarouselProps {
     className?: string;
 }
 /** 轮播（对应 antd/EP/shadcn Carousel）：横向滑动 + 箭头/圆点 + 自动播放 + 触摸滑动。
- * 裁剪（CS-05，见 design/components-cuts.md）：垂直模式、多图联动、淡入淡出（fade 用 CSS 可配）。 */
+ * 裁剪（CS-05，见 docs/client.md）：垂直模式、多图联动、淡入淡出（fade 用 CSS 可配）。 */
 export declare const Carousel: Component<CarouselProps>;

package/dist/client/components/Cascader/Cascader.d.ts

@@ -21,5 +21,5 @@ export interface CascaderProps {
     'aria-label'?: string;
 }
 /** 级联选择（对应 antd/EP Cascader）：多列面板逐级选择，点击叶子完成 + 可选搜索。
- * 裁剪（CS-05，见 design/components-cuts.md）：hover 展开、任意层级配置、异步加载。 */
+ * 裁剪（CS-05，见 docs/client.md）：hover 展开、任意层级配置、异步加载。 */
 export declare const Cascader: Component<CascaderProps>;

package/dist/client/components/CodeEditor/CodeEditor.d.ts

@@ -2,7 +2,7 @@
  * CodeEditor — 轻量代码编辑器（textarea + 行号——零依赖自研，不引 Monaco）
  *
  * 定位：配置/模板/脚本类轻编辑（非 IDE 级）——需要完整 IDE 体验的场景
- * 是裁剪边界（Monaco 600KB+ 违背零依赖哲学——design/components-cuts.md 登记）。
+ * 是裁剪边界（Monaco 600KB+ 违背零依赖哲学——docs/client.md 登记）。
  * 受控纪律：value 受控 + 缺 onChange → warn。
  */
 import type { Component } from '../../vdom/index.ts';

package/dist/client/components/ColorPicker/ColorPicker.d.ts

@@ -12,5 +12,5 @@ export interface ColorPickerProps {
     'aria-label'?: string;
 }
 /** 颜色选择（对应 antd/EP ColorPicker 预设版）：触发按钮 + 色板弹层 + hex 输入。
- * 裁剪（CS-05，见 design/components-cuts.md）：不做吸管/自由取色/透明度（预设色板 + hex 输入覆盖 90% 场景）。 */
+ * 裁剪（CS-05，见 docs/client.md）：不做吸管/自由取色/透明度（预设色板 + hex 输入覆盖 90% 场景）。 */
 export declare const ColorPicker: Component<ColorPickerProps>;

package/dist/client/components/DropZone/DropZone.d.ts

@@ -0,0 +1,27 @@
+/**
+ * weifuwu/components — DropZone 全区域拖放区
+ *
+ * 整容器拖放目标：文件拖入指定区域任意位置（含悬停子元素）即高亮 + drop 回调
+ * ——「现代 IM 标配」手搓实证 agent-platform Chat
+ * （apps/agent-platform/ui/pages/Chat.tsx:749-790——dragenter/leave 深度计数 +
+ * outline 高亮 + drop→addFiles）。
+ *
+ * 与 FileUpload 区分：FileUpload = 上传框组件（选择/列表/进度整体形态）；
+ * DropZone = 任意内容的**拖放容器**（消息区/看板列/画布——内容自持）。
+ *
+ * 纪律：
+ * - 零渲染高亮：dragenter/leave 回调直接 el.style.outline（不触发渲染周期——
+ *   手搓实证纪律——拖拽高频不扰渲染管线）
+ * - 深度计数（dragenter/leave 配对）——子元素边界穿越不闪烁（手搓 dragDepth 实证）
+ * - 非文件拖入忽略（files 空不回调）；disabled 全路径拦截
+ * - 事件经 useDragDrop 原语（dragover preventDefault 允许放置——vdom 事件表通道）
+ */
+import type { Component } from '../../vdom/index.ts';
+export interface DropZoneProps {
+    /** 拖放文件回调（file 数组——调用方负责后续链——与按钮链共享） */
+    onFiles?: (files: File[]) => void;
+    disabled?: boolean;
+    className?: string;
+    children?: any;
+}
+export declare const DropZone: Component<DropZoneProps>;

package/dist/client/components/Editor/Editor.d.ts

@@ -1,7 +1,7 @@
 /**
  * weifuwu/components/Editor — 富文本编辑器（事件流事务层，阶段 1）
  *
- * 架构（design/editor-events-plan.md）：文档 = fold(edit 事件流)。
+ * 架构（）：文档 = fold(edit 事件流)。
  * - 模型真相：DocState（contentEditable DOM 是渲染）
  * - 语义操作（工具栏/快捷键）→ edit:commit（before 快照 + 事件）→ undo/redo 精确
  * - 用户输入（键盘/IME/粘贴）暂由浏览器直写 DOM → onInput 同步回模型

package/dist/client/components/Editor/edit-events.d.ts

@@ -1,7 +1,7 @@
 /**
  * weifuwu/components/Editor/edit-events — 编辑事件流（第四端）
  *
- * 与 ai/sandbox 事件流同构（design/ai-events-plan.md / sandbox-events-plan.md）：
+ * 与 ai/sandbox 事件流同构（ / sandbox-events-plan.md）：
  * 环形缓冲 + 查询（按动作过滤）+ 订阅 + 全局调试工具。
  *
  * 桥接（跨层一条链）：

package/dist/client/components/Editor/model/types.d.ts

@@ -1,7 +1,7 @@
 /**
  * weifuwu/components/Editor/model — 文档模型（事件流底座）
  *
- * 核心不变量（design/editor-events-plan.md）：文档状态 = fold(edit 事件流)。
+ * 核心不变量（）：文档状态 = fold(edit 事件流)。
  * 本文档模型是纯 TS 数据结构 + 纯函数（无 DOM、无 UI）——阶段 0 验收：
  * 折叠不变量（fuzz）/ 逆操作 / HTML 往返。
  *

package/dist/client/components/Editor/tools/table.d.ts

@@ -1,7 +1,7 @@
 /**
  * weifuwu/components/Editor/tools — 表格工具
  *
- * 事件流事务层（design/editor-events-plan.md 阶段 1）：表格 = embed 事件——
+ * 事件流事务层（ 阶段 1）：表格 = embed 事件——
  * 本模块只生成 HTML（不再操作 DOM/execCommand）。
  */
 /** 生成表格 HTML（表头行加粗——模型 embed 快照） */

package/dist/client/components/Editor/tools/types.d.ts

@@ -29,7 +29,7 @@ export interface EditorAiAction {
     }) => string;
 }
 export interface EditorAiOptions {
-    /** wf: SSE 端点（POST——协议 docs/ai-contract.md） */
+    /** wf: SSE 端点（POST——协议 docs/server.md） */
     url: string;
     headers?: Record<string, string>;
     /** 自定义动作（缺省 = 内置 5 个：润色/翻译/缩写/扩写/纠错） */

package/dist/client/components/FilePreview/FilePreview.d.ts

@@ -1,7 +1,7 @@
 /**
  * weifuwu/components/FilePreview — 文件预览（office/pdf/md/html/text）
  *
- * 架构（design/file-preview-plan.md）：
+ * 架构（ —— ODES 事件流底座）：
  * - md 预览：复用 `<Markdown>` 组件（安全 token 渲染——表格/任务列表/URL 白名单）
  * - md/text 编辑：复用 `<Editor>`（事件流事务层——撤销/时光机/AI 全继承）——
  *   编辑闭环：md → markdownToHtml → Editor（DocState 模型）→ serializeMarkdown 回写

package/dist/client/components/FloatButton/FloatButton.d.ts

@@ -9,7 +9,7 @@
  *     <FloatButton icon={...} onClick={...} />
  *   </FloatButtonGroup>
  *
- * 裁剪（CS-05，见 design/components-cuts.md）：不做拖拽悬浮（Resizable 可组合）；回顶用 BackTop 语义更清晰。
+ * 裁剪（CS-05，见 docs/client.md）：不做拖拽悬浮（Resizable 可组合）；回顶用 BackTop 语义更清晰。
  */
 import type { Component } from '../../vdom/index.ts';
 export type FloatButtonPosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';

package/dist/client/components/Grid/Grid.d.ts

@@ -10,7 +10,7 @@
  *   </Grid>
  *   <Grid flex gap={8} direction="row">...</Grid>
  *
- * 裁剪（CS-05，见 design/components-cuts.md）：不做响应式断点 props（useBreakpoint 由用户驱动）；
+ * 裁剪（CS-05，见 docs/client.md）：不做响应式断点 props（useBreakpoint 由用户驱动）；
  * gutter 仅水平（垂直 gutter 低频）。
  */
 import type { Component } from '../../vdom/index.ts';

package/dist/client/components/Img/Img.d.ts

@@ -15,5 +15,12 @@ export interface ImgProps {
     preview?: boolean;
     /** 预览缩放倍率，默认 1 */
     previewScale?: number;
+    /** 加载占位（2026-09——未就绪渲染占位块；width/height 已知时布局恒定——
+     * 零追滚零闪烁——聊天图片直接受益） */
+    placeholder?: boolean;
+    /** 占位文案（加载中——默认「图片加载中…」；无 src 且失败时业务侧也可直接传失败文案） */
+    placeholderText?: string;
+    /** 加载失败文案（有 src 但解码/请求失败——默认「图片加载失败」） */
+    errorText?: string;
 }
 export declare const Img: Component<ImgProps>;

package/dist/client/components/InputNumber/InputNumber.d.ts

@@ -3,7 +3,7 @@
  *
  * 数字输入：min/max/step + 增减按钮 + precision 格式化 + 长按连增。
  * 受控 value: number | null；空值 → null；输入 clamp 到 min/max。
- * 裁剪（CS-05，见 design/components-cuts.md）：千分位货币格式（业务自拼）。
+ * 裁剪（CS-05，见 docs/client.md）：千分位货币格式（业务自拼）。
  */
 import type { Component } from '../../vdom/index.ts';
 export interface InputNumberProps {

package/dist/client/components/JSONViewer/JSONViewer.d.ts

@@ -3,7 +3,7 @@
  *
  * 结构化 JSON 浏览（工具调用 args / API 响应）：递归树 + 折叠 + 类型色 + 路径复制 + 懒展开。
  * 零依赖（无 raw JSON.parse 展示——VNode 渲染天然转义）。
- * 裁剪（CS-05，见 design/components-cuts.md）：JSON 编辑、超大对象流式渲染（懒展开覆盖 100 键级）。
+ * 裁剪（CS-05，见 docs/client.md）：JSON 编辑、超大对象流式渲染（懒展开覆盖 100 键级）。
  */
 import type { Component } from '../../vdom/index.ts';
 export interface JSONViewerProps {

package/dist/client/components/Link/Link.d.ts

@@ -6,7 +6,7 @@
  *
  *   <Link href="/docs" variant="primary" icon="→">文档</Link>
  *
- * 裁剪（CS-05，见 design/components-cuts.md）：不做 hover 弹层预览/图标内置枚举（icon 任意 VNode）。
+ * 裁剪（CS-05，见 docs/client.md）：不做 hover 弹层预览/图标内置枚举（icon 任意 VNode）。
  */
 import type { Component } from '../../vdom/index.ts';
 export interface LinkProps {

package/dist/client/components/LogViewer/LogViewer.d.ts

@@ -3,7 +3,7 @@
  *
  * 日志流查看器（Agent 执行日志 / CI 输出）：ANSI 着色 + 虚拟滚动 + 自动跟随。
  * 复用 VirtualList 滚动基座（useScrollPosition + rAF 节流）。
- * 裁剪（CS-05，见 design/components-cuts.md）：正则高亮、多日志源合并、搜索定位。
+ * 裁剪（CS-05，见 docs/client.md）：正则高亮、多日志源合并、搜索定位。
  */
 import type { Component } from '../../vdom/index.ts';
 export interface LogViewerProps {

package/dist/client/components/Markdown/parser.d.ts

@@ -7,7 +7,7 @@
  * 支持块级：标题(#~####) / 段落 / 列表(有序·无序·GFM 任务) / 围栏代码块 / 引用 / 分割线 / GFM 表格
  * 支持行内：**粗体** / *斜体* / ~~删除线~~ / `行内代码` / [文本](链接)
  *
- * 诚实裁剪（CS-05，见 design/components-cuts.md）：脚注/raw HTML/自动链接/语法高亮（raw HTML 安全红线——VNode 天然转义；语法高亮破零依赖）
+ * 诚实裁剪（CS-05，见 docs/client.md）：脚注/raw HTML/自动链接/语法高亮（raw HTML 安全红线——VNode 天然转义；语法高亮破零依赖）
  */
 export interface MdInline {
     type: 'text' | 'code' | 'bold' | 'italic' | 'del' | 'link';

package/dist/client/components/Math/Math.d.ts

@@ -3,7 +3,7 @@
  *
  * 支持子集：上下标（x^2, x_1）、分数（\frac{a}{b}）、根号（\sqrt{x}）、
  * 希腊字母（\alpha \beta \pi）、求和（\sum_{i=1}^{n}）
- * 裁剪边界（design/components-cuts.md）：完整 LaTeX 引擎是独立项目——
+ * 裁剪边界（docs/client.md）：完整 LaTeX 引擎是独立项目——
  * 本组件覆盖教学/文档场景 80% 公式；复杂排版（矩阵/多行对齐）不渲染（诚实渲染原文）。
  */
 import type { Component } from '../../vdom/index.ts';

package/dist/client/components/Mentions/Mentions.d.ts

@@ -15,5 +15,5 @@ export interface MentionsProps {
     size?: 'sm' | 'md' | 'lg';
 }
 /** @提及输入（对应 antd Mentions）：输入 prefix + 关键词弹出候选，点击/Enter 插入。
- * 裁剪（CS-05，见 design/components-cuts.md）：不做多 prefix/自定义高亮渲染/远程搜索（options 静态传入）。 */
+ * 裁剪（CS-05，见 docs/client.md）：不做多 prefix/自定义高亮渲染/远程搜索（options 静态传入）。 */
 export declare const Mentions: Component<MentionsProps>;

package/dist/client/components/Menu/Menu.d.ts

@@ -3,7 +3,7 @@
  *
  * 导航菜单（侧栏导航）：分组项 + 图标 + 选中态 + 方向键导航 + Enter 激活 + 子菜单 + 折叠。
  * 用于 SaaS 应用侧边导航（替代手写 nav-item 循环）。
- * 裁剪（CS-05，见 design/components-cuts.md）：水平菜单栏（Menubar，独立组件）、子菜单自动互斥。折叠态子菜单浮层已实现（openPopup 内核基座）。
+ * 裁剪（CS-05，见 docs/client.md）：水平菜单栏（Menubar，独立组件）、子菜单自动互斥。折叠态子菜单浮层已实现（openPopup 内核基座）。
  */
 import type { Component } from '../../vdom/index.ts';
 export interface MenuItem {

package/dist/client/components/Menubar/Menubar.d.ts

@@ -18,5 +18,5 @@ export interface MenubarProps {
     'aria-label'?: string;
 }
 /** 水平菜单栏（对应 shadcn Menubar）：trigger 点击展开下拉，←→ 切换菜单，Escape 关闭。
- * 裁剪（CS-05，见 design/components-cuts.md）：hover 展开、子菜单、可拖拽菜单。 */
+ * 裁剪（CS-05，见 docs/client.md）：hover 展开、子菜单、可拖拽菜单。 */
 export declare const Menubar: Component<MenubarProps>;

package/dist/client/components/MessageBubble/MessageBubble.d.ts

@@ -4,7 +4,7 @@
  * 独立消息气泡（从 AiChat 气泡层抽取，业务聊天页复用）。
  * 复用 layout 的 wf-bubble 原语：user → --own，assistant → --ai。
  * content 支持文本或任意 VNode（可与 Markdown 组合）。
- * 裁剪（CS-05，见 design/components-cuts.md）：不做打字指示动画（Loading 已有）。
+ * 裁剪（CS-05，见 docs/client.md）：不做打字指示动画（Loading 已有）。
  */
 import type { Component } from '../../vdom/index.ts';
 export type MessageBubbleRole = 'user' | 'assistant';

package/dist/client/components/NavBar/NavBar.d.ts

@@ -0,0 +1,32 @@
+/**
+ * weifuwu/components — NavBar 移动端顶栏（antd-mobile NavBar / MUI AppBar 对位）
+ *
+ * 移动端 App 应用外壳顶栏：left 槽（返回/菜单按钮）+ 标题（单行截断）+ right 槽
+ * （操作按钮）——消费侧手搓实证 agent-platform `ap-topbar`
+ * （apps/agent-platform/ui/components/AppLayout.tsx:142——汉堡 + 品牌 + 设置）。
+ *
+ * 与近义组件区分（易混对照——components-map）：
+ * - PageHeader = 桌面**页内容**标题 + 操作区（页面内）；NavBar = 移动端**外壳**顶栏
+ * - AppShell/Layout = 整壳（侧栏+内容）；NavBar 独立组件——应用层组合
+ *   （与 TabBar 独立同构——顶部对位）
+ *
+ * 纪律：
+ * - 纯展示壳——无内部状态（交互全在调用方 VNode——组合式）
+ * - fixed = position:sticky（滚动常驻——ap-topbar 实证）+ safe-area-inset-top 避让
+ * - 标题对齐：align='center'（iOS 语义——默认）/ 'left'（品牌左对齐——ap-topbar 实证）
+ */
+import type { Component } from '../../vdom/index.ts';
+export interface NavBarProps {
+    /** 标题（单行截断——不传 = 纯工具栏） */
+    title?: string;
+    /** 左区任意 VNode（返回/菜单按钮——组合式） */
+    left?: any;
+    /** 右区任意 VNode（操作按钮） */
+    right?: any;
+    /** 标题对齐（默认 'center'——iOS 语义；'left'——品牌左对齐） */
+    align?: 'left' | 'center';
+    /** sticky 常驻（position:sticky top:0 + safe-area-inset-top——移动端 App 顶栏） */
+    fixed?: boolean;
+    className?: string;
+}
+export declare const NavBar: Component<NavBarProps>;

package/dist/client/components/NavMenu/NavMenu.d.ts

@@ -9,7 +9,7 @@
  * 弹层纪律（）：子菜单/嵌套子菜单全部经 openPopup 内核
  * （createPortal + fixed + 视口夹紧 + Escape + 外部点击）——不 absolute 定位。
  *
- * 裁剪（CS-05，见 design/components-cuts.md）：不做 hover 延迟微调/子菜单动画曲线定制；
+ * 裁剪（CS-05，见 docs/client.md）：不做 hover 延迟微调/子菜单动画曲线定制；
  * 折叠态交还 useBreakpoint 由用户驱动。
  */
 import type { Component } from '../../vdom/index.ts';

package/dist/client/components/OfficeEditor/ai/ai-bridge.d.ts

@@ -1,7 +1,7 @@
 /**
  * weifuwu/components/OfficeEditor/ai — ODES × AI 事件流对接
  *
- * 设计（design/office-events-plan.md §9）：AI 落地 = 普通 op + ai 元数据。
+ * 设计（ §9）：AI 落地 = 普通 op + ai 元数据。
  * 本模块：AI 回复 → OfficeOp[] 默认解析（按 mode）+ 事件流桥接发射。
  *
  * xlsx formula 模式解析：

package/dist/client/components/OfficeEditor/model/types.d.ts

@@ -1,7 +1,7 @@
 /**
  * weifuwu/components/OfficeEditor/model — ODES（office 文档事件流标准）协议层
  *
- * 设计（design/office-events-plan.md）：
+ * 设计（）：
  * - 文档状态 = fold(事件流)（与 Editor/ai/sandbox 四端同构）
  * - docx 的 IR = Editor DocState（op = EditEvent 全量复用——段落流同构）
  * - xlsx = 网格模型（稀疏 cells Map——`A1` 引用语义）

package/dist/client/components/Popconfirm/Popconfirm.d.ts

@@ -11,7 +11,7 @@
  *
  * - 受控 open/onOpenChange；非受控点击触发
  * - 确认后自动关闭（onConfirm 后 setOpen(false)）
- * - 裁剪（CS-05，见 design/components-cuts.md）：不做气泡内表单/自定义箭头
+ * - 裁剪（CS-05，见 docs/client.md）：不做气泡内表单/自定义箭头
  */
 import type { Component } from '../../vdom/index.ts';
 import type { Placement } from '../../vdom/hooks/popup.ts';

package/dist/client/components/Result/Result.d.ts

@@ -3,7 +3,7 @@
  *
  * 结果页：status + title + desc + extra（操作按钮区）。
  * 用于注册完成/操作成功/404/403 页。
- * 裁剪（CS-05，见 design/components-cuts.md）：不做内置路由跳转（页面自身处理）。
+ * 裁剪（CS-05，见 docs/client.md）：不做内置路由跳转（页面自身处理）。
  */
 import type { Component } from '../../vdom/index.ts';
 export type ResultStatus = 'success' | 'error' | 'warning' | 'info';

package/dist/client/components/Scrollbar/Scrollbar.d.ts

@@ -6,7 +6,7 @@
  *
  *   <Scrollbar maxHeight={300}>长内容</Scrollbar>
  *
- * 裁剪（CS-05，见 design/components-cuts.md）：不做虚拟滚动/拖动滚动条 thumb（VirtualList 覆盖虚拟化）。
+ * 裁剪（CS-05，见 docs/client.md）：不做虚拟滚动/拖动滚动条 thumb（VirtualList 覆盖虚拟化）。
  */
 import type { Component } from '../../vdom/index.ts';
 export interface ScrollbarProps {

package/dist/client/components/SheetGrid/SheetGrid.d.ts

@@ -1,7 +1,7 @@
 /**
  * weifuwu/components/SheetGrid — xlsx 网格编辑器（ODES 事件流底座）
  *
- * 设计（design/office-events-plan.md）：文档 = fold(事件流)——SheetGrid 的每个
+ * 设计（）：文档 = fold(事件流)——SheetGrid 的每个
  * 编辑操作 = OfficeOp（cell-set/insert-rows/...）→ editEmit('office') → commit
  * （before 快照 + ops——撤销一步）。
  *

package/dist/client/components/SlideCanvas/SlideCanvas.d.ts

@@ -1,7 +1,7 @@
 /**
  * weifuwu/components/SlideCanvas — pptx 画布编辑器（ODES 事件流——阶段 3）
  *
- * 设计（design/office-events-plan.md）：文档 = fold(事件流)——每个编辑 =
+ * 设计（）：文档 = fold(事件流)——每个编辑 =
  * OfficeOp（shape-add/remove/move/resize/set）→ editEmit('office') → commit。
  *
  * - 画布：960×540 幻灯片区域（缩放适配容器——scale 因子）

package/dist/client/components/TagsInput/TagsInput.d.ts

@@ -3,7 +3,7 @@
  *
  * 标签输入：回车/逗号添加、Backspace 删除、去重、maxTags 限制。
  * 中文输入法 composition 感知（输入法候选词确认的 Enter 不触发添加）。
- * 裁剪（CS-05，见 design/components-cuts.md）：不做下拉建议（组合 Select searchable）。
+ * 裁剪（CS-05，见 docs/client.md）：不做下拉建议（组合 Select searchable）。
  */
 import type { Component } from '../../vdom/index.ts';
 export interface TagsInputProps {

package/dist/client/components/Timeline/Timeline.d.ts

@@ -4,7 +4,7 @@
  * 时间线：节点（状态色圆点/自定义）+ 标题 + 时间 + 内容 + 连接线。
  * 竖向（left/alternate）+ 横向（horizontal）。
  * 用于执行日志、审批历史、审计记录、步骤进度。
- * 裁剪（CS-05，见 design/components-cuts.md）：不做折叠节点。
+ * 裁剪（CS-05，见 docs/client.md）：不做折叠节点。
  */
 import type { Component } from '../../vdom/index.ts';
 export type TimelineStatus = 'default' | 'info' | 'success' | 'warning' | 'error';

package/dist/client/components/Transfer/Transfer.d.ts

@@ -18,5 +18,5 @@ export interface TransferProps {
     searchPlaceholder?: string;
 }
 /** 穿梭框（对应 antd/EP Transfer）：双列表 + 中间穿梭按钮 + 可选搜索。
- * 裁剪（CS-05，见 design/components-cuts.md）：拖拽排序、自定义渲染。 */
+ * 裁剪（CS-05，见 docs/client.md）：拖拽排序、自定义渲染。 */
 export declare const Transfer: Component<TransferProps>;

package/dist/client/components/VirtualList/VirtualList.d.ts

@@ -16,7 +16,7 @@ export interface VirtualListProps {
 /**
  * 虚拟列表（对应 EP VirtualTable）：固定高度 items 只渲染可见窗口，
  * spacer 撑总高 + 绝对定位可见项。1000+ 条列表性能关键。
- * 裁剪（CS-05，见 design/components-cuts.md）：动态高度（ResizeObserver 测量）、滚动平滑（sticky 场景）。
+ * 裁剪（CS-05，见 docs/client.md）：动态高度（ResizeObserver 测量）、滚动平滑（sticky 场景）。
  * 滚动跟随：ctx.ui.useScrollPosition（内置全局 scroll 监听 + rAF 节流）——
  * 像素级 scrollTop 响应式，无组件自建 scroll 监听。
  */

package/dist/client/components/VirtualTable/VirtualTable.d.ts

@@ -5,7 +5,7 @@
  * 复用 VirtualList 滚动基座（useScrollPosition 像素级 scrollTop + rAF 节流）。
  * 排序：受控 sortKey/sortOrder + onSort（与 Table 同款模式）。
  * 行选择：rowSelection（受控 selectedRowKeys + onChange，复选框列）。
- * 裁剪（CS-05，见 design/components-cuts.md）：列虚拟化（横向）、行编辑、单元格合并、树形表格。
+ * 裁剪（CS-05，见 docs/client.md）：列虚拟化（横向）、行编辑、单元格合并、树形表格。
  */
 import type { Component } from '../../vdom/index.ts';
 import type { TableColumn } from '../Table/Table.ts';

package/dist/client/components/Watermark/Watermark.d.ts

@@ -15,5 +15,5 @@ export interface WatermarkProps {
     className?: string;
 }
 /** 水印（对应 antd Watermark）：canvas 绘制平铺文字 + overlay 覆盖内容（pointer-events none）。
- * 裁剪（CS-05，见 design/components-cuts.md）：图片水印、多行文字、动态旋转。 */
+ * 裁剪（CS-05，见 docs/client.md）：图片水印、多行文字、动态旋转。 */
 export declare const Watermark: Component<WatermarkProps>;

package/dist/client/components/index.d.ts

@@ -38,6 +38,8 @@ export type { EmptyStateProps } from './EmptyState/EmptyState.ts';
 export { Tabs } from './Tabs/Tabs.ts';
 export { TabBar } from './TabBar/TabBar.ts';
 export type { TabBarProps, TabBarItem } from './TabBar/TabBar.ts';
+export { NavBar } from './NavBar/NavBar.ts';
+export type { NavBarProps } from './NavBar/NavBar.ts';
 export { ActionSheet } from './ActionSheet/ActionSheet.ts';
 export type { ActionSheetProps, ActionSheetItem } from './ActionSheet/ActionSheet.ts';
 export { PromptTemplate } from './PromptTemplate/PromptTemplate.ts';
@@ -81,6 +83,8 @@ export { Divider } from './Divider/Divider.ts';
 export type { DividerProps } from './Divider/Divider.ts';
 export { FileUpload } from './FileUpload/FileUpload.ts';
 export type { FileUploadProps } from './FileUpload/FileUpload.ts';
+export { DropZone } from './DropZone/DropZone.ts';
+export type { DropZoneProps } from './DropZone/DropZone.ts';
 export { FileTree } from './FileTree/FileTree.ts';
 export type { FileTreeProps, FileTreeEntry, FileTreeOpenFile } from './FileTree/FileTree.ts';
 export { AppShell } from './AppShell/AppShell.ts';