weifuwu 0.93.2 → 0.94.0

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

@@ -0,0 +1,40 @@
+/** ListScaffold：列表页骨架（PageHeader + 工具栏 + loading/empty + 内容插槽）（showcase /components/listscaffold） */
+import type { Component, VNodeChild } from '../../vdom/index.ts';
+/**
+ * weifuwu/client/components — ListScaffold
+ *
+ * 列表页骨架原语：PageHeader + 搜索/工具区 + loading/empty 态 + 内容插槽。
+ * 各页面差异在内容循环（render 插槽）——头部/状态区单点一致。
+ * 组合 PageHeader/EmptyState/Loading（库内组合——无自有样式——布局类单源）。
+ *
+ * **empty 显式契约**（agent-platform ListScaffold 空态与列表并存 bug 修复——
+ * 2027-09 沉淀入库）：empty 仅在 `isEmpty` 时渲染——**有数据也显示空态**
+ * 的空态/列表并存已消除（原实现 empty 条件缺失 isEmpty——双段显示）。
+ * loading 优先于 empty（加载中不闪空态）——空态在 loading 后判断。
+ *
+ * 来源：agent-platform ListScaffold（>1 消费者 Agents/Departments——
+ * 入库判负登记已推翻：用户指令 = 框架层第二消费面确立）。
+ */
+export interface ListScaffoldProps {
+    /** 页面标题（PageHeader title） */
+    title: string;
+    /** 标题副文案 */
+    sub?: string;
+    /** header 右区（按钮组——JSX 子元素面） */
+    actions?: VNodeChild;
+    /** 搜索/筛选工具区（loading 时仍渲染——搜索框可用） */
+    toolbar?: VNodeChild;
+    /** 加载中（loading 优先于 empty——不闪空态） */
+    loading?: boolean;
+    /** 空态定义（图标/文案/提示） */
+    empty?: {
+        icon?: string | null;
+        text?: string;
+        hint?: string;
+    };
+    /** 内容空（empty 仅在 isEmpty 时显示） */
+    isEmpty?: boolean;
+    /** 内容插槽（页面核心循环——children 在 empty 之后——有数据时渲染） */
+    children?: VNodeChild;
+}
+export declare const ListScaffold: Component<ListScaffoldProps>;

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

@@ -1,6 +1,6 @@
 /** LogViewer：日志流：ANSI 着色 + 虚拟滚动 + 自动跟随 + 复制（showcase /components/logviewer） */
 /**
- * weifuwu/components — LogViewer
+ * weifuwu/client/components — LogViewer
  *
  * 日志流查看器（Agent 执行日志 / CI 输出）：ANSI 着色 + 虚拟滚动 + 自动跟随。
  * 复用 VirtualList 滚动基座（useScrollPosition + rAF 节流）。

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

@@ -1,6 +1,6 @@
 /** Markdown：AI 回复渲染：安全子集 parser + 代码块 + 链接白名单（showcase /components/markdown） */
 /**
- * weifuwu/components — Markdown
+ * weifuwu/client/components — Markdown
  *
  * AI 回复/富文本渲染。安全子集解析 → VNode 渲染（天然转义，无 innerHTML 注入面）。
  * 与 CodeBlock 组合渲染代码围栏。

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

@@ -1,6 +1,6 @@
 /** Markdown：AI 回复渲染：安全子集 parser + 代码块 + 链接白名单（showcase /components/markdown） */
 /**
- * weifuwu/components — Markdown 安全子集 parser
+ * weifuwu/client/components — Markdown 安全子集 parser
  *
  * 零依赖自研解析器，输出结构化 token（非 HTML 字符串）——
  * 组件层以 VNode 渲染，天然转义任何用户/AI 内容（无 innerHTML 注入面）。

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

@@ -1,6 +1,6 @@
 /** Menu：侧栏导航：分组 + 图标 + 选中态 + 方向键（showcase /components/menu） */
 /**
- * weifuwu/components — Menu
+ * weifuwu/client/components — Menu
  *
  * 导航菜单（侧栏导航）：分组项 + 图标 + 选中态 + 方向键导航 + Enter 激活 + 子菜单 + 折叠。
  * 用于 SaaS 应用侧边导航（替代手写 nav-item 循环）。
@@ -15,6 +15,8 @@ export interface MenuItem {
     group?: string;
     active?: boolean;
     danger?: boolean;
+    /** 计数徽标（数字 → Badge count 胶囊——99+ 溢出；label 直传自定义形态） */
+    badge?: string | number;
     onClick?: () => void;
     /** 子菜单项（有 children 即渲染为可展开子菜单） */
     children?: MenuItem[];

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

@@ -1,6 +1,6 @@
 /** MessageBubble：消息气泡：user/assistant + streaming/error 状态 + actions（showcase /components/messagebubble） */
 /**
- * weifuwu/components — MessageBubble
+ * weifuwu/client/components — MessageBubble
  *
  * 独立消息气泡（从 AiChat 气泡层抽取，业务聊天页复用）。
  * 复用 layout 的 wf-bubble 原语：user → --own，assistant → --ai。

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

@@ -1,6 +1,10 @@
 /** Modal：自定义宽度 + closable 控制关闭按钮（showcase /components/modal） */
 /**
- * weifuwu/components — Modal
+ * weifuwu/client/components — Modal
+ *
+ * 行为面（2027-09 分层抽象 W2）：openPopup 生命周期/焦点 trap/滚动锁/Esc/
+ * 遮罩点击 → useOverlay 契约（手搓面消除——行为正确性结构性保证）。
+ * 组件只写皮：overlay（遮罩）+ content（面板）+ 关闭按钮/标题/footer。
  */
 import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface ModalProps {

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

@@ -1,6 +1,6 @@
 /** NavBar：移动端顶栏——left 槽（返回/菜单）+ 标题截断 + right 槽（antd-mobile NavBar 对位）（showcase /components/navbar） */
 /**
- * weifuwu/components — NavBar 移动端顶栏（antd-mobile NavBar / MUI AppBar 对位）
+ * weifuwu/client/components — NavBar 移动端顶栏（antd-mobile NavBar / MUI AppBar 对位）
  *
  * 移动端 App 应用外壳顶栏：left 槽（返回/菜单按钮）+ 标题（单行截断）+ right 槽
  * （操作按钮）——消费侧手搓实证 agent-platform `ap-topbar`

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

@@ -1,6 +1,6 @@
 /** NavMenu：顶部导航：多级 hover 弹出 + 键盘（shadcn NavigationMenu）（showcase /components/navmenu） */
 /**
- * weifuwu/components — NavMenu 顶部导航
+ * weifuwu/client/components — NavMenu 顶部导航
  *
  * 三库等价：shadcn NavigationMenu（特有——antd/EP 用 Menu 横向模式）。
  * 顶部水平导航 + 多级 hover 弹出 + 键盘（→ 进入子菜单 / ← 返回 / Escape 关闭）：

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

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

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

@@ -1,5 +1,5 @@
 /**
- * weifuwu/components/OfficeEditor/model/apply — ODES 折叠（fold）纯函数
+ * weifuwu/client/components/OfficeEditor/model/apply — ODES 折叠（fold）纯函数
  *
  * 核心不变量：snapshot = fold(全部事件)——apply 每个 op 得到新状态（不可变）。
  * - docx：委托 Editor applyEdit（EditEvent 全量复用——零新逻辑）

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

@@ -1,5 +1,5 @@
 /**
- * weifuwu/components/OfficeEditor/model — ODES（office 文档事件流标准）协议层
+ * weifuwu/client/components/OfficeEditor/model — ODES（office 文档事件流标准）协议层
  *
  * 设计（）：
  * - 文档状态 = fold(事件流)（与 Editor/ai/sandbox 四端同构）

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

@@ -1,6 +1,6 @@
 /** PasswordInput：密码输入：眼睛按钮切换可见性（showcase /components/passwordinput） */
 /**
- * weifuwu/components — PasswordInput
+ * weifuwu/client/components — PasswordInput
  *
  * 密码输入：眼睛按钮切换可见性。Input 子集（label/error/hint/required/autoComplete 透传）。
  */

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

@@ -1,6 +1,6 @@
 /** Popconfirm：气泡确认：危险操作防误触 + 复用 usePopup 基座（showcase /components/popconfirm） */
 /**
- * weifuwu/components — Popconfirm 气泡确认
+ * weifuwu/client/components — Popconfirm 气泡确认
  *
  * 三库等价：antd Popconfirm / Element Plus Popconfirm。
  * 复用 openPopup 内核（Popover 同级基座）——验证弹层体系可组合性：

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

@@ -1,6 +1,6 @@
 /** Popover：通用弹出层，click/hover 触发，4 方向（showcase /components/popover） */
 /**
- * weifuwu/components — Popover
+ * weifuwu/client/components — Popover
  *
  * 命令式弹窗（一个形态——ctx.ui.openPopup——toast 心智）：click/hover 双触发
  * （hover 触屏自动降级 tap）+ 受控 open + 外部点击（document 级，取代原 overlay）

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

@@ -1,6 +1,6 @@
 /** PromptTemplate：提示词模板编辑器——变量 chips 插入 + 实时预览填充（AI 场景痛点）（showcase /components/prompttemplate） */
 /**
- * weifuwu/components — PromptTemplate 提示词模板编辑器（AI 场景）
+ * weifuwu/client/components — PromptTemplate 提示词模板编辑器（AI 场景）
  *
  * agent-platform 类应用的提示词管理痛点：变量占位 `{{var}}` 记忆/拼写错误 +
  * 填充结果不可见。组件提供：

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

@@ -1,6 +1,6 @@
 /** RelationGraph：关系图谱——环形/网格布局 + 类型着色 + 选中交互（人物/组织/网络）（showcase /components/relationgraph） */
 /**
- * weifuwu/components — RelationGraph
+ * weifuwu/client/components — RelationGraph
  *
  * 关系图谱可视化（人物关系/社会网络/组织协作——agent 世界的核心交互面）：
  * 确定性布局（环形/网格——零物理模拟——组件库零依赖纪律）+ SVG 渲染

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

@@ -1,6 +1,6 @@
 /** Result：结果页：success/error/warning/info + extra 操作区（showcase /components/result） */
 /**
- * weifuwu/components — Result
+ * weifuwu/client/components — Result
  *
  * 结果页：status + title + desc + extra（操作按钮区）。
  * 用于注册完成/操作成功/404/403 页。

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

@@ -1,6 +1,6 @@
 /** Scrollbar：自定义滚动容器：webkit 样式 + hover 显示（showcase /components/scrollbar） */
 /**
- * weifuwu/components — Scrollbar 自定义滚动容器
+ * weifuwu/client/components — Scrollbar 自定义滚动容器
  *
  * 三库等价：EP Scrollbar / shadcn ScrollArea（容器滚动区域）。
  * webkit 滚动条样式封装 + hover 显示：

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

@@ -1,6 +1,6 @@
-/** SheetGrid：weifuwu/components/SheetGrid — xlsx 网格编辑器（ODES 事件流底座） 设计（）：文档 = fold(事件流)——SheetGrid 的每个（showcase /components/sheetgrid） */
+/** SheetGrid：weifuwu/client/components/SheetGrid — xlsx 网格编辑器（ODES 事件流底座） 设计（）：文档 = fold(事件流)——SheetGrid 的每个（showcase /components/sheetgrid） */
 /**
- * weifuwu/components/SheetGrid — xlsx 网格编辑器（ODES 事件流底座）
+ * weifuwu/client/components/SheetGrid — xlsx 网格编辑器（ODES 事件流底座）
  *
  * 设计（）：文档 = fold(事件流)——SheetGrid 的每个
  * 编辑操作 = OfficeOp（cell-set/insert-rows/...）→ editEmit('office') → commit

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

@@ -1,6 +1,6 @@
 /** Skeleton：text/circle/rect/image/avatar/table 六种变体（showcase /components/skeleton） */
 /**
- * weifuwu/components — Skeleton
+ * weifuwu/client/components — Skeleton
  */
 import type { Component } from '../../vdom/index.ts';
 export type SkeletonVariant = 'text' | 'circle' | 'rect' | 'image' | 'avatar' | 'table';

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

@@ -1,6 +1,6 @@
-/** SlideCanvas：weifuwu/components/SlideCanvas — pptx 画布编辑器（ODES 事件流——阶段 3） 设计（）：文档 = fold(事件流)——每个编辑 =（showcase /components/slidecanvas） */
+/** SlideCanvas：weifuwu/client/components/SlideCanvas — pptx 画布编辑器（ODES 事件流——阶段 3） 设计（）：文档 = fold(事件流)——每个编辑 =（showcase /components/slidecanvas） */
 /**
- * weifuwu/components/SlideCanvas — pptx 画布编辑器（ODES 事件流——阶段 3）
+ * weifuwu/client/components/SlideCanvas — pptx 画布编辑器（ODES 事件流——阶段 3）
  *
  * 设计（）：文档 = fold(事件流)——每个编辑 =
  * OfficeOp（shape-add/remove/move/resize/set）→ editEmit('office') → commit。

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

@@ -1,6 +1,6 @@
 /** Space：间距容器：size/direction/wrap + split 分隔符（showcase /components/space） */
 /**
- * weifuwu/components — Space 间距容器
+ * weifuwu/client/components — Space 间距容器
  *
  * 三库等价：antd Space / EP Space。flex gap 布局原语组件化：
  * size/direction/wrap/align + split 分隔符。

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

@@ -0,0 +1,25 @@
+/** StatusDot：状态点（on/tone 语义——label 缺省只渲染点）（showcase /components/statusdot） */
+import type { Component, VNodeChild } from '../../vdom/index.ts';
+/**
+ * weifuwu/client/components — StatusDot
+ *
+ * 状态点原语（颜色语义——一个状态一个声音）。
+ * 契约（agent-platform StatusDot 语言化——原名「自带默认文案的运行中/已暂停」
+ * 与调用方状态标签撞车——双标签实证修复）：
+ * - **label 缺省只渲染点**（文字是调用方职责——防双标签）
+ * - tone 覆盖点/文字色：success 绿（健康运行）· warning 黄（降级）·
+ *   error 红（故障）· default 灰（非活跃）
+ * - on 是主开关（true→success · false→default）——tone 仅在非绿非灰时传
+ *
+ * 来源：agent-platform ui.tsx StatusDot（平台原语——库无状态点面——
+ * 入库：通用状态语义组件）。
+ */
+export interface StatusDotProps {
+    /** 状态开关（true→success · false→default） */
+    on?: boolean;
+    /** 状态文案（缺省只渲染点——文字是调用方职责） */
+    label?: VNodeChild;
+    /** 覆盖色（非绿非灰时传——降级/故障） */
+    tone?: 'success' | 'warning' | 'error' | 'default';
+}
+export declare const StatusDot: Component<StatusDotProps>;

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

@@ -1,6 +1,6 @@
 /** TabBar：底部标签栏——移动端 App 主导航（3-5 tab + icon/badge/受控激活 + safe-area 避让）（showcase /components/tabbar） */
 /**
- * weifuwu/components — TabBar 底部标签栏（移动端导航）
+ * weifuwu/client/components — TabBar 底部标签栏（移动端导航）
  *
  * 3-5 个底部 tab（icon + label + 可选 badge 角标）——移动端 App 主导航
  * （MUI BottomNavigation 对位；examples/patterns/Mobile.tsx 手搓底部导航的组件化）。

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

@@ -1,6 +1,6 @@
 /** TagsInput：标签输入：回车/逗号添加 + 中文输入法感知（showcase /components/tagsinput） */
 /**
- * weifuwu/components — TagsInput
+ * weifuwu/client/components — TagsInput
  *
  * 标签输入：回车/逗号添加、Backspace 删除、去重、maxTags 限制。
  * 中文输入法 composition 感知（输入法候选词确认的 Enter 不触发添加）。

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

@@ -1,4 +1,10 @@
 /** Textarea：多行文本，支持 rows/label/error/hint（showcase /components/textarea） */
+/**
+ * weifuwu/client/components — Textarea
+ *
+ * 2027-09 原语全面化 W2：label/required/error/hint 块 + aria 连接 → useField
+ * 契约——组件只写输入面（textarea + showCount 业务）。
+ */
 import type { Component } from '../../vdom/index.ts';
 export interface TextareaProps {
     label?: string;

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

@@ -1,6 +1,6 @@
 /** ThemeSwitch：主题切换：auto/light/dark，localStorage 持久化（showcase /components/themeswitch） */
 /**
- * weifuwu/components — ThemeSwitch 主题切换器
+ * weifuwu/client/components — ThemeSwitch 主题切换器
  *
  * 三段式切换：auto（跟随系统偏好）/ light（强制亮色）/ dark（强制暗色）。
  * 对应 layout 的暗色双段激活机制：

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

@@ -1,6 +1,6 @@
 /** Timeline：时间线：节点状态色 + 时间 + 内容（执行日志/审批历史）（showcase /components/timeline） */
 /**
- * weifuwu/components — Timeline
+ * weifuwu/client/components — Timeline
  *
  * 时间线：节点（状态色圆点/自定义）+ 标题 + 时间 + 内容 + 连接线。
  * 竖向（left/alternate）+ 横向（horizontal）。

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

@@ -1,6 +1,6 @@
 /** Tooltip：hover 浮动提示，4 方向（showcase /components/tooltip） */
 /**
- * weifuwu/components — Tooltip
+ * weifuwu/client/components — Tooltip
  *
  * 命令式弹窗（一个形态——ctx.ui.openPopup——toast 心智）：hover 触发
  * （触屏自动降级 tap）+ 定位/视口 clamp + Escape + 外部点击关闭。

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

@@ -1,6 +1,6 @@
 /** VirtualTable：虚拟表格：10k 行固定表头 + 可见窗口渲染 + 排序（showcase /components/virtualtable） */
 /**
- * weifuwu/components — VirtualTable
+ * weifuwu/client/components — VirtualTable
  *
  * 虚拟表格（数据密集场景）：固定表头 + 虚拟滚动表体，10k+ 行只渲染可见窗口。
  * 复用 VirtualList 滚动基座（useScrollPosition 像素级 scrollTop + rAF 节流）。

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

@@ -1,6 +1,6 @@
 /** WordCloud：词云——权重→字号映射 · 圆心同心环发散布局 · SVG textLength 定宽（零依赖自绘——SSR 一致零重叠）（showcase /components/wordcloud） */
 /**
- * weifuwu/components — WordCloud
+ * weifuwu/client/components — WordCloud
  *
  * 词云——权重→字号映射 · **中心同心环发散布局**（SVG textLength 定宽——
  * 渲染宽度精确 = 估算宽——同输入同输出——SSR≡SPA 零差异 + 词矩形零重叠）

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

@@ -1,9 +1,9 @@
 /**
- * weifuwu/components — HTML 原语
+ * weifuwu/client/components — HTML 原语
  *
  * 使用方式:
- *   import { Button, Input } from 'weifuwu/components'
- *   import 'weifuwu/components/style.css'
+ *   import { Button, Input } from 'weifuwu/client/components'
+ *   import 'weifuwu/client/components/style.css'
  */
 export { Icon } from './Icon/Icon.ts';
 export type { IconProps, IconName } from './Icon/Icon.ts';
@@ -290,3 +290,9 @@ export { Math } from './Math/Math.ts';
 export type { MathProps } from './Math/Math.ts';
 export { WordCloud } from './WordCloud/WordCloud.ts';
 export type { WordCloudProps, WordCloudData } from './WordCloud/WordCloud.ts';
+export { CronPicker } from './CronPicker/CronPicker.ts';
+export type { CronPickerProps } from './CronPicker/CronPicker.ts';
+export { ListScaffold } from './ListScaffold/ListScaffold.ts';
+export type { ListScaffoldProps } from './ListScaffold/ListScaffold.ts';
+export { StatusDot } from './StatusDot/StatusDot.ts';
+export type { StatusDotProps } from './StatusDot/StatusDot.ts';