weifuwu 0.93.1 → 0.93.3

package/README.md

@@ -98,7 +98,7 @@ router.get('*', async (req, ctx) => {
 | `weifuwu/vdom` | UIRouter / uiServe / uiSsr | 前端路由唯一入口 + 浏览器 boot + SSR（结构吸收） |
 | `weifuwu/vdom` | 命令流引擎 + hooks 全家 | 渲染周期/事件代理/三状态机 + useAsyncData/usePopup/useControlled/… |
 | `weifuwu/components` | **134 个组件** | Button/Table/Modal/AiChat/… + `toast()`/`confirm()` 命令式中间件 |
-| `weifuwu/layout` | CSS 布局 | 50 个布局原语 + 98 个工具类 + 178 个主题 Token |
+| `weifuwu/layout` | CSS 布局 | 50 个布局原语 + 98 个工具类 + 176 个主题 Token |
 | `weifuwu` | rateLimit / email / userSystem / messager / queue / scheduler / ai / graphql | SaaS 地基中间件（ctx 注入） |
 | `weifuwu/dev` | dev loader | `--import weifuwu/dev` 直接跑 `.ts/.tsx` |
 

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

@@ -1,8 +1,9 @@
-import type { Component } from '../../vdom/index.ts';
+/** Accordion：折叠面板，支持多个 items（showcase /components/accordion） */
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface AccordionItem {
     key: string;
     title: string;
-    content?: any;
+    content?: VNodeChild;
     disabled?: boolean;
 }
 export interface AccordionProps {

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

@@ -1,3 +1,4 @@
+/** ActionSheet：动作面板——移动端底部滑出（命令列表 + 取消按钮，usePopup 会话级模态）（showcase /components/actionsheet） */
 /**
  * weifuwu/components — ActionSheet 动作面板（移动端底部滑出）
  *

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

@@ -1,10 +1,11 @@
-import type { Component } from '../../vdom/index.ts';
+/** Affix：回到顶部（滚动超 400px 显示）+ 固定导航（距顶 80px 钉住）（showcase /components/affix） */
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface AffixProps {
     /** 距视口顶部偏移，滚动超过该值后固定（px），默认 0 */
     offsetTop?: number;
     /** 滚动容器（默认 window） */
     target?: () => HTMLElement | Window;
-    children?: any;
+    children?: VNodeChild;
     className?: string;
     [key: string]: any;
 }

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

@@ -1,3 +1,4 @@
+/** AiChat：useChat + 标准对话界面：流式 token / 工具卡 / 审批卡 / 自动滚动，协议对页面透明（showcase /components/aichat） */
 /**
  * AiChat — 标准 AI 对话组件（useChat 的标准展示层）
  *
@@ -15,7 +16,7 @@
  *
  * ```tsx
  * const $ = ctx.ui.useChat({ url: '/api/chat', approveUrl: '/api/approve' })  // audit-exempt: 用法示例文档（组件契约 = 接收 useChat handle）
- * return () => h(AiChat, { chat: $ })
+ * return ()=> h(AiChat, { chat: $ })
  * ```
  */
 import type { Component } from '../../vdom/index.ts';

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

@@ -1,9 +1,10 @@
-import type { Component } from '../../vdom/index.ts';
+/** Alert：信息提示条，4 种 variant + closable（showcase /components/alert） */
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export type AlertVariant = 'info' | 'success' | 'warning' | 'error';
 export interface AlertProps {
     variant?: AlertVariant;
     closable?: boolean;
     onClose?: () => void;
-    children?: any;
+    children?: VNodeChild;
 }
 export declare const Alert: Component<AlertProps>;

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

@@ -1,3 +1,4 @@
+/** AlertGroup：通知合并组：≥3 条折叠为 +N，点击展开（showcase /components/alertgroup） */
 /**
  * weifuwu/components — AlertGroup 通知合并组
  *
@@ -9,10 +10,10 @@
  * 裁剪（CS-05，见 docs/client.md）：合并阈值固定 3 条起（少于此退化为平铺）；
  * 不做时间线分组/虚拟化。
  */
-import type { Component } from '../../vdom/index.ts';
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface AlertGroupItem {
     id: string;
-    message: any;
+    message?: VNodeChild;
     time?: string;
     variant?: 'info' | 'success' | 'warning' | 'error';
 }

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

@@ -1,3 +1,4 @@
+/** Anchor：锚点导航：滚动高亮跟随 + 点击平滑滚动（showcase /components/anchor） */
 /**
  * weifuwu/components — Anchor
  *
@@ -5,10 +6,10 @@
  * 滚动侦听：ctx.ui.useScrollPosition（全局/容器 scroll 监听 + rAF 节流，内置方案）。
  * 裁剪（CS-05，见 docs/client.md）：嵌套滚动容器、滚动容器非视口（container 未提供时仅视口）、自动生成标题锚点。
  */
-import type { Component } from '../../vdom/index.ts';
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface AnchorItem {
     href: string;
-    title: any;
+    title?: VNodeChild;
 }
 export interface AnchorProps {
     items: AnchorItem[];

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

@@ -1,3 +1,4 @@
+/** AppShell：应用壳——品牌 + 分组导航 + 用户区 + 主内容（受控——父层驱动）（showcase /components/appshell） */
 /**
  * weifuwu/components — AppShell
  *
@@ -10,21 +11,34 @@
  * （wf-app-shell + wf-sidebar 系列 + wf-main——grid 栅格 + 移动端降级），
  * 组件只补品牌区/用户区细节（AppShell.css）。
  *
+ * **移动抽屉（W2——AppLayout 功能面入库）**：`mobile` prop 父层驱动
+ * （useBreakpoint 交还用户——库惯例同 Layout/NavMenu「响应式折叠交还用户」；
+ * 零 breakpoint 内建保证 SSR 首帧确定性——node 无 matchMedia 时 useBreakpoint
+ * 恒返回基档（mobile）导致 SSR≡SPA 首帧不一致（absorb 违例——实证））。
+ * <768 侧栏转抽屉（translateX 滑入——layout 堆叠降级被替换）+ 遮罩 + 移动
+ * 顶栏（NavBar——汉堡开抽屉 · 右侧设置）+ aside 头部关闭按钮。
+ *
+ * **导航徽标（W2）**：nav[].badge → Menu badge 胶囊（Badge count——
+ * 99+ 溢出内建）——审批待办计数场景。
+ *
  * 状态约定（父层驱动）：
  * - nav/path：菜单数据与当前路由（activeKey 计算）
  * - user：用户信息（null = 未登录——父层守卫跳登录）
  * - onNavigate/onLogout/onSettings：回调上抛
  * - loading：守卫加载态（骨架占位）
+ * - mobile：移动模式（父层 breakpoint 判定）——抽屉/顶栏分支
  */
-import type { Component } from '../../vdom/index.ts';
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface AppShellNavItem {
     key: string;
     label: string;
-    icon?: any;
+    icon?: VNodeChild;
     group?: string;
+    /** 导航徽标（数字 → Badge count 胶囊——99+ 溢出内建） */
+    badge?: string | number;
 }
 export interface AppShellProps {
-    /** 导航菜单项（Menu items——key/label/icon/group） */
+    /** 导航菜单项（Menu items——key/label/icon/group/badge） */
     nav?: AppShellNavItem[];
     /** 当前路由路径（activeKey 匹配——'/' 精确，其余前缀） */
     path?: string;
@@ -46,10 +60,14 @@ export interface AppShellProps {
     /** 守卫加载态（骨架占位——不渲染菜单/用户） */
     loading?: boolean;
     /** 主内容区 */
-    children?: any;
+    children?: VNodeChild;
     /** 自定义底部（覆盖用户区——高级场景） */
-    footer?: any;
+    footer?: VNodeChild;
     /** 侧栏宽度（layout 变量——默认 240px） */
     sidebarWidth?: string;
+    /** 移动顶栏标题（默认 brand.name） */
+    mobileTitle?: string;
+    /** 移动模式（父层 breakpoint 判定——抽屉/顶栏分支；SSR 一致性：默认 false） */
+    mobile?: boolean;
 }
 export declare const AppShell: Component<AppShellProps>;

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

@@ -1,3 +1,4 @@
+/** ApprovalCard：HITL 审批卡片：pending 可批/拒 + 修改参数（JsonSchemaForm）· approved/rejected/timeout 终态（showcase /components/approvalcard） */
 import type { Component } from '../../vdom/index.ts';
 import { type JsonSchema } from '../JsonSchemaForm/JsonSchemaForm.ts';
 import type { WfApprovalRequest } from '../../../server/ai/types.ts';
@@ -10,8 +11,8 @@ import type { WfApprovalRequest } from '../../../server/ai/types.ts';
  * ```tsx
  * <ApprovalCard
  *   request={approvalReq}
- *   onApprove={() => respond('approved')}
- *   onReject={(note) => respond('rejected', note)}
+ *   onApprove={()=> respond('approved')}
+ *   onReject={(note)=> respond('rejected', note)}
  * />
  * ```
  */

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

@@ -1,8 +1,9 @@
-import type { Component } from '../../vdom/index.ts';
+/** AspectRatio：独立标签（required 星号）+ 宽高比容器（内容填满）（showcase /components/aspectratio） */
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface AspectRatioProps {
     /** 宽/高比，默认 16/9 */
     ratio?: number;
-    children?: any;
+    children?: VNodeChild;
     className?: string;
     [key: string]: any;
 }

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

@@ -1,3 +1,4 @@
+/** AuthPage：认证页骨架：居中卡片 + logo + 表单插槽 + 错误条 + 提交 loading（登录/注册复用）（showcase /components/authpage） */
 /**
  * weifuwu/components — AuthPage
  *
@@ -9,7 +10,7 @@
  *
  * 使用两阶段模型 + render-only。无状态（props 驱动）。
  */
-import type { Component, VNode } from '../../vdom/index.ts';
+import type { Component, VNode, VNodeChild } from '../../vdom/index.ts';
 import type { HookEnv } from '../../vdom/hooks/env.ts';
 export interface AuthPageProps {
     /** 标题（如「登录」） */
@@ -19,7 +20,7 @@ export interface AuthPageProps {
     /** logo / 头像位（VNode——Avatar 或图片） */
     logo?: VNode | null;
     /** 表单字段插槽 */
-    children?: any;
+    children?: VNodeChild;
     /** 底部链接位（登录↔注册切换） */
     footer?: VNode | null;
     /** 提交按钮文案 */

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

@@ -1,3 +1,4 @@
+/** AutoComplete：输入联想：自由输入 + 过滤下拉 + 键盘流 + 选中回填（showcase /components/autocomplete） */
 /**
  * weifuwu/components — AutoComplete 输入联想
  *
@@ -13,10 +14,10 @@
  * 裁剪（CS-05，见 docs/client.md）：不做分组/虚拟化候选（Select searchable 覆盖分组场景）；
  * 自定义渲染用 `renderOption` 透传。
  */
-import type { Component } from '../../vdom/index.ts';
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface AutoCompleteOption {
     value: string;
-    label?: any;
+    label?: VNodeChild;
     disabled?: boolean;
 }
 export interface AutoCompleteProps {

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

@@ -1,3 +1,4 @@
+/** Avatar：头像（首字母/图片），3 种 size（showcase /components/avatar） */
 import type { Component } from '../../vdom/index.ts';
 export interface AvatarProps {
     name?: string;

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

@@ -1,3 +1,4 @@
+/** AvatarGroup：头像组：堆叠 + max 溢出 +N（showcase /components/avatargroup） */
 /**
  * weifuwu/components — AvatarGroup
  *

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

@@ -1,4 +1,5 @@
-import type { Component } from '../../vdom/index.ts';
+/** BackTop：回到顶部（滚动超 400px 显示）+ 固定导航（距顶 80px 钉住）（showcase /components/backtop） */
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface BackTopProps {
     /** 滚动超过此高度显示（px），默认 400 */
     visibilityHeight?: number;
@@ -11,7 +12,7 @@ export interface BackTopProps {
     /** fixed 定位（默认 true——页面级）；容器内浮钮传 false（absolute——祖先需 position:relative） */
     fixed?: boolean;
     'aria-label'?: string;
-    children?: any;
+    children?: VNodeChild;
     className?: string;
 }
 /** 回到顶部/底部（对应 EP Backtop / antd FloatButton.BackTop）：滚动超阈值显示，点击回位

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

@@ -1,9 +1,10 @@
-import type { Component } from '../../vdom/index.ts';
+/** Badge：状态标签 + 圆点，6 种 variant（showcase /components/badge） */
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export type BadgeVariant = 'default' | 'primary' | 'success' | 'warning' | 'danger' | 'info' | 'error';
 export interface BadgeProps {
     variant?: BadgeVariant;
     dot?: boolean;
-    children?: any;
+    children?: VNodeChild;
     /** 数值角标（与 children 互斥；超出 overflowCount 显示 N+） */
     count?: number;
     /** 数值溢出阈值，默认 99（count > 阈值 → 阈值+） */

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

@@ -1,3 +1,4 @@
+/** Breadcrumb：面包屑导航，支持 aria-current（showcase /components/breadcrumb） */
 import type { Component } from '../../vdom/index.ts';
 export interface BreadcrumbItem {
     label: string;

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

@@ -1,4 +1,5 @@
-import type { Component } from '../../vdom/index.ts';
+/** Button：4 variants × 3 sizes + loading + block + disabled（showcase /components/button） */
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface ButtonProps {
     variant?: 'primary' | 'secondary' | 'ghost' | 'danger' | 'danger-ghost';
     size?: 'sm' | 'md' | 'lg';
@@ -14,6 +15,6 @@ export interface ButtonProps {
     /** 透传无障碍标签（读屏/测试定位——按钮常仅图标无文本，name 缺失即死读屏路径） */
     'aria-label'?: string;
     onClick?: (e: MouseEvent) => void;
-    children?: any;
+    children?: VNodeChild;
 }
 export declare const Button: Component<ButtonProps>;

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

@@ -1,3 +1,4 @@
+/** Calendar：月历：事件点 + 月切换 + 日期选择（antd/EP Calendar）（showcase /components/calendar） */
 import type { Component } from '../../vdom/index.ts';
 export interface CalendarEvent {
     key: string;

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

@@ -1,4 +1,5 @@
-import type { Component } from '../../vdom/index.ts';
+/** Card：容器，支持 default/outlined/clickable（showcase /components/card） */
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface CardProps {
     variant?: 'default' | 'outlined';
     /** 便捷：outlined = variant 'outlined' */
@@ -14,6 +15,6 @@ export interface CardProps {
     /** id 属性（锚点定位——AgentDetail Tab 导航用） */
     id?: string;
     style?: Record<string, string>;
-    children?: any;
+    children?: VNodeChild;
 }
 export declare const Card: Component<CardProps>;

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

@@ -1,6 +1,7 @@
-import type { Component } from '../../vdom/index.ts';
+/** Carousel：轮播：箭头/圆点/循环 + 自动播放（三库共识）（showcase /components/carousel） */
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface CarouselProps {
-    children: any[];
+    children?: VNodeChild[];
     /** 自动播放 */
     autoplay?: boolean;
     /** 自动播放间隔（ms），默认 3000 */

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

@@ -1,3 +1,4 @@
+/** Cascader：级联选择：多列面板逐级推进（antd/EP Cascader）（showcase /components/cascader） */
 import type { Component } from '../../vdom/index.ts';
 export interface CascaderOption {
     value: string;

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

@@ -1,3 +1,4 @@
+/** Chart：SVG 图表：line/bar/pie/radar/gauge/scatter——零依赖自绘（showcase /components/chart） */
 /**
  * weifuwu/components — Chart
  */

package/dist/client/components/Chart/chart-utils.d.ts

@@ -1,3 +1,4 @@
+/** Chart：SVG 图表：line/bar/pie/radar/gauge/scatter——零依赖自绘（showcase /components/chart） */
 /**
  * weifuwu/components — Chart 纯函数坐标计算
  *

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

@@ -1,3 +1,4 @@
+/** ChatInput：独立聊天输入条（AiChat 抽取）：单行/多行 + streaming 停止 + IME 安全——不自带聊天逻辑（showcase /components/chatinput） */
 /**
  * weifuwu/components — ChatInput
  *

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

@@ -1,3 +1,4 @@
+/** Checkbox：带 label 的复选框，支持 checked/disabled（showcase /components/checkbox） */
 import type { Component } from '../../vdom/index.ts';
 export interface CheckboxProps {
     label?: string;

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

@@ -1,3 +1,4 @@
+/** CheckboxGroup：复选框组：数组受控 + 栅格列数（antd Checkbox.Group）（showcase /components/checkboxgroup） */
 import type { Component } from '../../vdom/index.ts';
 export interface CheckboxGroupOption {
     value: string;

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

@@ -1,3 +1,4 @@
+/** CitationCard：RAG 引用来源：折叠「引用 N 条」+ 条目列表（序号/标题/来源/片段/链接）+ 溢出 +N（showcase /components/citationcard） */
 import type { Component } from '../../vdom/index.ts';
 import type { UIContext } from '../../vdom/index.ts';
 /**
@@ -10,7 +11,7 @@ import type { UIContext } from '../../vdom/index.ts';
  * <CitationCard
  *   items={[{ id, title, source, snippet, url? }]}
  *   maxVisible={3}
- *   onOpen={(c) => openDoc(c.id)}
+ *   onOpen={(c)=> openDoc(c.id)}
  * />
  * ```
  */

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

@@ -1,3 +1,4 @@
+/** CodeBlock：代码块：语言标签 + 复制按钮 + 横向滚动（showcase /components/codeblock） */
 /**
  * weifuwu/components — CodeBlock
  *

package/dist/client/components/CodeBlock/highlight.d.ts

@@ -1,3 +1,4 @@
+/** CodeBlock：代码块：语言标签 + 复制按钮 + 横向滚动（showcase /components/codeblock） */
 /**
  * weifuwu/components — 轻量语法高亮 tokenizer
  *

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

@@ -1,3 +1,4 @@
+/** CodeEditor：轻量代码编辑器——textarea + 行号 + Tab 缩进（零依赖，不引 Monaco）（showcase /components/codeeditor） */
 /**
  * CodeEditor — 轻量代码编辑器（textarea + 行号——零依赖自研，不引 Monaco）
  *

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

@@ -1,13 +1,14 @@
-import type { Component } from '../../vdom/index.ts';
+/** Collapse：行内折叠：异步 loading + extra 操作区（区别于 Accordion）（showcase /components/collapse） */
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface CollapseItem {
     key: string;
     title: string;
     /** 标题图标 */
-    icon?: any;
+    icon?: VNodeChild;
     /** 标题右侧操作区 */
-    extra?: any;
+    extra?: VNodeChild;
     /** 展开内容（惰性渲染：未展开不渲染） */
-    content?: any;
+    content?: VNodeChild;
     /** 异步加载态：展开时显示 loading 指示 */
     loading?: boolean;
 }

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

@@ -1,3 +1,4 @@
+/** ColorPicker：颜色选择：预设色板 + hex 输入（Popover 弹层）（showcase /components/colorpicker） */
 import type { Component } from '../../vdom/index.ts';
 export interface ColorPickerProps {
     /** 受控颜色值（hex，如 #4f6ef7） */

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

@@ -1,8 +1,9 @@
-import type { Component } from '../../vdom/index.ts';
+/** Command：命令面板：⌘K 全局快捷键 + 键盘流（shadcn Command）（showcase /components/command） */
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface CommandItem {
     key: string;
     label: string;
-    icon?: any;
+    icon?: VNodeChild;
     /** 显示快捷键（如 'G S'） */
     shortcut?: string;
     group?: string;

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

@@ -1,15 +1,16 @@
+/** Confirm：确认对话框，Promise 化 await 调用（showcase /components/confirm） */
 /**
  * weifuwu/components — Confirm 确认对话框
  *
  * 声明式：基于 Modal 封装，footer 自带「取消 / 确定」按钮。
  * 命令式：confirm() 中间件注入 ctx.confirm()，返回 Promise<boolean>。
  */
-import type { Component } from '../../vdom/index.ts';
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface ConfirmProps {
     open?: boolean;
     title?: string;
     /** 提示内容（文本或任意 VNode） */
-    message?: any;
+    message?: VNodeChild;
     confirmText?: string;
     cancelText?: string;
     variant?: 'primary' | 'danger';

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

@@ -1,15 +1,16 @@
-import type { Component } from '../../vdom/index.ts';
+/** ContextMenu：右键菜单：光标定位 + 方向键 + danger 变体（shadcn）（showcase /components/contextmenu） */
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface ContextMenuItem {
     key: string;
     label: string;
-    icon?: any;
+    icon?: VNodeChild;
     variant?: 'default' | 'danger';
     disabled?: boolean;
     onClick?: () => void;
 }
 export interface ContextMenuProps {
     items?: ContextMenuItem[];
-    children: any;
+    children?: VNodeChild;
     'aria-label'?: string;
     className?: string;
 }

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

@@ -1,3 +1,4 @@
+/** CopyButton：复制按钮：clipboard + execCommand 降级 + 成功状态机（showcase /components/copybutton） */
 import type { Component } from '../../vdom/index.ts';
 export interface CopyButtonProps {
     /** 要复制的文本 */

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

@@ -0,0 +1,31 @@
+/** CronPicker：cron 表达式快捷输入（预置常见 + 自由编辑）（showcase /components/cronpicker） */
+import type { Component } from '../../vdom/index.ts';
+/**
+ * weifuwu/components — CronPicker
+ *
+ * cron 表达式输入原语：预置语义 + 自由编辑双通道。
+ * - 预置面：常见档（每分钟/每 5 分钟/每小时/每天/工作日——单源 PRESETS）
+ * - 自由面：Input 直编（任何 cron 表达式——服务端解析器裁决语义）
+ * - 契约：preset 选中 → onChange（五段 * / N / N-M / N,M 与 server 解析器
+ *   语义对齐——见 src/server/... cron 解析面）；自由输入全量直传。
+ *
+ * 来源：agent-platform CronPicker（平台层单一消费者 workflow 详情——入
+ * 库判负登记已推翻（用户指令 = 第二消费面确立）——库件标准形（Select 单源
+ * 表单面——替换原生 select）。
+ */
+export interface CronPickerProps {
+    value: string;
+    onChange?: (v: string) => void;
+    /** 预置档（默认 6 档——Preset 可覆盖——自定义场景） */
+    presets?: {
+        label: string;
+        value: string;
+    }[];
+    /** 预设选择占位文案 */
+    placeholder?: string;
+}
+export declare const CRON_PRESETS: {
+    label: string;
+    value: string;
+}[];
+export declare const CronPicker: Component<CronPickerProps>;

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

@@ -1,3 +1,4 @@
+/** DatePicker：日期选择器，四种模式：date/datetime/time/range（showcase /components/datepicker） */
 /**
  * weifuwu/components — DatePicker
  *

package/dist/client/components/DatePicker/calendar-utils.d.ts

@@ -1,3 +1,4 @@
+/** DatePicker：日期选择器，四种模式：date/datetime/time/range（showcase /components/datepicker） */
 /**
  * weifuwu/components — DatePicker 日期计算工具
  *

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

@@ -1,13 +1,14 @@
+/** Descriptions：描述列表：label/value 栅格 + bordered + span（详情页）（showcase /components/descriptions） */
 /**
  * weifuwu/components — Descriptions
  *
  * 详情字段展示：label/value 栅格（<dl> 语义结构，屏幕阅读器友好）。
  * 用于 Agent 配置展示、实体详情、订单信息等只读字段场景。
  */
-import type { Component } from '../../vdom/index.ts';
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface DescriptionItem {
-    label: any;
-    value: any;
+    label?: VNodeChild;
+    value?: VNodeChild;
     /** 跨列数（栅格列，默认 1） */
     span?: number;
 }

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

@@ -1,3 +1,4 @@
+/** DiffView：代码 diff：LCS 行级对比 + 未变块折叠 + 三态着色（showcase /components/diffview） */
 import type { Component } from '../../vdom/index.ts';
 export interface DiffViewProps {
     /** 旧代码 */

package/dist/client/components/DiffView/diff-utils.d.ts

@@ -1,3 +1,4 @@
+/** DiffView：代码 diff：LCS 行级对比 + 未变块折叠 + 三态着色（showcase /components/diffview） */
 export type DiffLineType = 'add' | 'remove' | 'same';
 export interface DiffLine {
     type: DiffLineType;

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

@@ -1,6 +1,7 @@
-import type { Component } from '../../vdom/index.ts';
+/** Divider：分割线，支持 horizontal/vertical/带文字（showcase /components/divider） */
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface DividerProps {
     vertical?: boolean;
-    children?: any;
+    children?: VNodeChild;
 }
 export declare const Divider: Component<DividerProps>;

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

@@ -1,15 +1,16 @@
+/** Drawer：侧边面板，左右滑入 + ESC 关闭（showcase /components/drawer） */
 /**
  * weifuwu/components — Drawer
  */
-import type { Component } from '../../vdom/index.ts';
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export type DrawerPosition = 'left' | 'right';
 export interface DrawerProps {
     open?: boolean;
     title?: string;
     position?: DrawerPosition;
     onClose?: () => void;
-    children?: any;
-    footer?: any;
+    children?: VNodeChild;
+    footer?: VNodeChild;
     /** 面板宽度（默认 360px——--wf-drawer-width 变量） */
     width?: string;
 }