weifuwu 0.93.0 → 0.93.2

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

@@ -1,3 +1,4 @@
+/** Editor：富文本编辑器，contentEditable + toolbar，零依赖（showcase /components/editor） */
 /**
  * weifuwu/components/Editor/model/history — undo/redo 栈（commit 粒度）
  *

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

@@ -1,3 +1,4 @@
+/** Editor：富文本编辑器，contentEditable + toolbar，零依赖（showcase /components/editor） */
 /**
  * weifuwu/components/Editor/model/html — HTML ⇄ DocState 序列化
  *

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

@@ -1,3 +1,4 @@
+/** Editor：富文本编辑器，contentEditable + toolbar，零依赖（showcase /components/editor） */
 /**
  * weifuwu/components/Editor/model/inverse — 事件逆操作（undo 基元）
  *

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

@@ -1,3 +1,4 @@
+/** Editor：富文本编辑器，contentEditable + toolbar，零依赖（showcase /components/editor） */
 /**
  * weifuwu/components/Editor/model — 文档模型（事件流底座）
  *

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

@@ -1,3 +1,4 @@
+/** Editor：富文本编辑器，contentEditable + toolbar，零依赖（showcase /components/editor） */
 /**
  * weifuwu/components/Editor/tools — 表格工具
  *

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

@@ -1,3 +1,4 @@
+/** Editor：富文本编辑器，contentEditable + toolbar，零依赖（showcase /components/editor） */
 /**
  * weifuwu/components/Editor/tools — 工具栏渲染
  */

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

@@ -1,3 +1,4 @@
+/** Editor：富文本编辑器，contentEditable + toolbar，零依赖（showcase /components/editor） */
 /**
  * weifuwu/components/Editor/tools — 类型定义
  */

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

@@ -1,9 +1,10 @@
-import type { Component, VNode } from '../../vdom/index.ts';
+/** EmptyState：空状态占位，支持 icon/text/hint/action（showcase /components/emptystate） */
+import type { Component, VNode, VNodeChild } from '../../vdom/index.ts';
 export interface EmptyStateProps {
     /** 图标——VNode（推荐 <Icon />）或字符串（emoji/字形）；默认 Icon inbox（P3：组件内禁裸 emoji） */
     icon?: string | VNode | null;
     text?: string;
     hint?: string;
-    children?: any;
+    children?: VNodeChild;
 }
 export declare const EmptyState: Component<EmptyStateProps>;

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

@@ -1,3 +1,4 @@
+/** ExportCSV：数据导出 CSV——RFC 4180 转义 + BOM（Excel 兼容）零依赖（showcase /components/exportcsv） */
 /**
  * ExportCSV — 数据导出 CSV（零依赖：纯函数 + ctx.browser.downloadFile）
  *
@@ -5,7 +6,7 @@
  *   exportCSV({ data: rows, filename: 'orders.csv', columns: [{ key, label }] })
  *   <ExportCSV data={rows} filename="orders.csv">导出</ExportCSV>
  */
-import type { Component } from '../../vdom/index.ts';
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface CsvColumn {
     key: string;
     label?: string;
@@ -15,12 +16,12 @@ export interface ExportCsvOptions {
     filename?: string;
     columns?: CsvColumn[];
     /** 值格式化（默认 String；null/undefined → 空） */
-    format?: (value: any, key: string) => string;
+    format?: (value: VNodeChild, key: string) => string;
 }
 /** 纯函数：data → CSV 字符串（RFC 4180：引号转义 + BOM 防 Excel 乱码） */
 export declare function toCsv({ data, columns, format }: ExportCsvOptions): string;
 export interface ExportCSVProps extends ExportCsvOptions {
-    children?: any;
+    children?: VNodeChild;
     variant?: 'primary' | 'secondary' | 'ghost' | 'danger';
     size?: 'sm' | 'md' | 'lg';
     disabled?: boolean;

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

@@ -1,9 +1,10 @@
-import type { Component } from '../../vdom/index.ts';
+/** Field：label+error+hint 容器（showcase /components/field） */
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface FieldProps {
     label?: string;
     required?: boolean;
     error?: string;
     hint?: string;
-    children?: any;
+    children?: VNodeChild;
 }
 export declare const Field: Component<FieldProps>;

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

@@ -1,3 +1,4 @@
+/** FilePreview：文件预览（md/html/pdf/office）——基于事件流，可编辑（showcase /components/filepreview） */
 /**
  * weifuwu/components/FilePreview — 文件预览（office/pdf/md/html/text）
  *

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

@@ -1,3 +1,4 @@
+/** FilePreview：文件预览（md/html/pdf/office）——基于事件流，可编辑（showcase /components/filepreview） */
 /**
  * weifuwu/components/FilePreview/markdown — Markdown 转换（编辑桥）
  *

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

@@ -1,3 +1,4 @@
+/** FileTree：文件树浏览器——面包屑 + 列表/编辑态 + 上传（受控——数据源无关）（showcase /components/filetree） */
 /**
  * weifuwu/components — FileTree
  *

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

@@ -1,7 +1,8 @@
+/** FileUpload：文件上传，拖拽区 + 文件列表 + accept/maxSize（showcase /components/fileupload） */
 /**
  * weifuwu/components — FileUpload
  */
-import type { Component } from '../../vdom/index.ts';
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface FileUploadProps {
     accept?: string;
     multiple?: boolean;
@@ -15,6 +16,6 @@ export interface FileUploadProps {
     uploading?: boolean;
     /** 上传进度 0-100（父层驱动） */
     progress?: number;
-    children?: any;
+    children?: VNodeChild;
 }
 export declare const FileUpload: Component<FileUploadProps>;

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

@@ -1,3 +1,4 @@
+/** FloatButton：悬浮按钮组：展开状态机 + badge（showcase /components/floatbutton） */
 /**
  * weifuwu/components — FloatButton 悬浮操作按钮
  *
@@ -11,10 +12,10 @@
  *
  * 裁剪（CS-05，见 docs/client.md）：不做拖拽悬浮（Resizable 可组合）；回顶用 BackTop 语义更清晰。
  */
-import type { Component } from '../../vdom/index.ts';
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export type FloatButtonPosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
 export interface FloatButtonProps {
-    icon?: any;
+    icon?: VNodeChild;
     badge?: number | string;
     position?: FloatButtonPosition;
     /** 'static'：组内子项（不 fixed——独立 fixed 会与主按钮重叠） */
@@ -22,13 +23,13 @@ export interface FloatButtonProps {
     disabled?: boolean;
     onClick?: () => void;
     'aria-label'?: string;
-    children?: any;
+    children?: VNodeChild;
 }
 /** 单个悬浮按钮 */
 export declare const FloatButton: Component<FloatButtonProps>;
 export interface FloatButtonGroupProps {
     position?: FloatButtonPosition;
-    children?: any;
+    children?: VNodeChild;
 }
 /** 悬浮按钮组：主按钮展开/收起子按钮 */
 export declare const FloatButtonGroup: Component<FloatButtonGroupProps>;

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

@@ -1,4 +1,5 @@
-import type { Component } from '../../vdom/index.ts';
+/** Form：内置验证规则：required/pattern/minLength/自定义（showcase /components/form） */
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface ValidationRule {
     required?: boolean;
     pattern?: RegExp;
@@ -15,7 +16,7 @@ export interface FormProps {
     validation?: Record<string, ValidationRule[]>;
     /** 验证失败时回调，接收字段名→错误消息的对象 */
     onError?: (errors: Record<string, string>) => void;
-    children?: any;
+    children?: VNodeChild;
 }
 /** 验证函数：字段值 → 验证规则 → 错误消息 */
 export declare function validateValues(values: Record<string, any>, rules: Record<string, ValidationRule[]>): Promise<Record<string, string>>;

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

@@ -1,3 +1,4 @@
+/** Grid：24 栅格 + gutter + flex 容器模式（Row/Col/Flex 等价）（showcase /components/grid） */
 /**
  * weifuwu/components — Grid 栅格 + Flex 容器
  *
@@ -13,20 +14,20 @@
  * 裁剪（CS-05，见 docs/client.md）：不做响应式断点 props（useBreakpoint 由用户驱动）；
  * gutter 仅水平（垂直 gutter 低频）。
  */
-import type { Component } from '../../vdom/index.ts';
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface GridProps {
     gutter?: number;
     flex?: boolean;
     gap?: number;
     direction?: 'row' | 'column';
     align?: 'start' | 'center' | 'end' | 'stretch';
-    children?: any;
+    children?: VNodeChild;
 }
 export interface ColProps {
     /** 0-24 栅格跨度；0 = flex:1 占剩余 */
     span?: number;
     gutter?: number;
-    children?: any;
+    children?: VNodeChild;
 }
 /** 栅格跨度 → 宽度（纯函数——可单测/SSR） */
 export declare function gridColumns(span: number): string;

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

@@ -1,3 +1,4 @@
+/** Highlight：搜索词高亮：分词渲染 mark，大小写不敏感（showcase /components/highlight） */
 /**
  * weifuwu/components — Highlight
  *

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

@@ -1,3 +1,4 @@
+/** HoverCard：悬停富内容卡：openDelay 延迟 + 任意 VNode（shadcn）（showcase /components/hovercard） */
 /**
  * weifuwu/components — HoverCard
  *
@@ -5,14 +6,14 @@
  * （触屏自动降级 tap）+ openDelay/closeDelay + 定位/视口 clamp + Escape。
  * 对应 shadcn HoverCard。
  */
-import type { Component } from '../../vdom/index.ts';
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 import type { Placement } from '../../vdom/hooks/popup.ts';
 export type HoverCardPosition = Placement;
 export interface HoverCardProps {
     /** 富内容（任意 VNode，区别于 Tooltip 的 string） */
-    content: any;
+    content?: VNodeChild;
     position?: HoverCardPosition;
-    children: any;
+    children?: VNodeChild;
     disabled?: boolean;
     /** 悬停打开延迟（ms），默认 150 */
     openDelay?: number;

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

@@ -1,3 +1,4 @@
+/** Icon：stroke SVG 图标集，currentColor 着色，随字号缩放（showcase /components/icon） */
 /**
  * weifuwu/components — Icon 内联 SVG 图标
  *

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

@@ -1,3 +1,4 @@
+/** ImageCropper：图片裁剪——canvas 原生 API + 拖拽裁剪框 + 比例控制（零依赖）（showcase /components/imagecropper） */
 /**
  * ImageCropper — 图片裁剪（canvas 原生 API + 拖拽裁剪框，零依赖）
  *

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

@@ -1,3 +1,4 @@
+/** Img：图片 \\<img\\> 组件：fallback / lazy / preview 点击放大（showcase /components/img） */
 /**
  * weifuwu/components — Img
  */

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

@@ -1,16 +1,17 @@
+/** InView：进入视窗后懒加载内容，支持 IntersectionObserver（showcase /components/inview） */
 /**
  * weifuwu/components — InView
  *
  * 进入视窗后替换占位符为真实内容。
  * 实现：ctx.ui.useInView（IO 封装）——滚动/尺寸变化由合成器线程评估，无 scroll 监听。
  */
-import type { Component } from '../../vdom/index.ts';
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface InViewProps {
     once?: boolean;
     threshold?: number;
     rootMargin?: string;
-    placeholder?: any;
+    placeholder?: VNodeChild;
     onEnter?: () => void;
-    children?: any;
+    children?: VNodeChild;
 }
 export declare const InView: Component<InViewProps>;

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

@@ -1,4 +1,5 @@
-import type { Component } from '../../vdom/index.ts';
+/** InfiniteScroll：无限滚动：底部哨兵触底加载 + loading/end 态（showcase /components/infinitescroll） */
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface InfiniteScrollProps {
     hasMore?: boolean;
     loading?: boolean;
@@ -6,7 +7,7 @@ export interface InfiniteScrollProps {
     onLoadMore?: () => void;
     /** 提前触发距离（px） */
     threshold?: number;
-    children?: any;
+    children?: VNodeChild;
     loadMoreText?: string;
     endText?: string;
     className?: string;

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

@@ -1,3 +1,4 @@
+/** Input：text/email/password/number，支持 label/error/hint/required（showcase /components/input） */
 import type { Component } from '../../vdom/index.ts';
 export interface InputProps {
     label?: string;

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

@@ -1,3 +1,4 @@
+/** InputNumber：数字输入：min/max/step + 增减按钮 + precision（showcase /components/inputnumber） */
 /**
  * weifuwu/components — InputNumber
  *

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

@@ -1,3 +1,4 @@
+/** JSONViewer：结构化 JSON：递归折叠 + 类型色 + 路径复制 + 懒展开（showcase /components/jsonviewer） */
 /**
  * weifuwu/components — JSONViewer
  *

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

@@ -1,3 +1,4 @@
+/** JsonSchemaForm：JSON Schema → 参数输入表单：类型映射 + 必填/范围校验 + 嵌套/数组（AI 工具参数输入面）（showcase /components/jsonschemaform） */
 import type { Component } from '../../vdom/index.ts';
 import type { UIContext } from '../../vdom/index.ts';
 /**

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

@@ -1,3 +1,4 @@
+/** Kanban：看板：原生 DnD 拖拽 + 跨列/重排 + 悬停高亮（showcase /components/kanban） */
 import type { Component } from '../../vdom/index.ts';
 export interface KanbanItem {
     id: string;

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

@@ -1,9 +1,10 @@
-import type { Component } from '../../vdom/index.ts';
+/** Label：独立标签（required 星号）+ 宽高比容器（内容填满）（showcase /components/label） */
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface LabelProps {
     htmlFor?: string;
     /** 必填星号 */
     required?: boolean;
-    children?: any;
+    children?: VNodeChild;
     className?: string;
     [key: string]: any;
 }

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

@@ -1,3 +1,4 @@
+/** Layout：布局外壳：Sider 折叠 + Header/Content/Footer 骨架（antd Layout / shadcn Sidebar 等价）（showcase /components/layout） */
 /**
  * weifuwu/components — Layout 布局外壳
  *
@@ -18,11 +19,11 @@
  * - 响应式折叠交还用户：useBreakpoint 驱动 collapsed（裁剪：不自动抽屉化）
  * - 静态外壳见 layout `_app-shell.css`（wf-app-shell/wf-sidebar/wf-main）
  */
-import type { Component } from '../../vdom/index.ts';
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface LayoutProps {
     style?: any;
     className?: string;
-    children?: any;
+    children?: VNodeChild;
 }
 export interface LayoutSiderProps {
     width?: number | string;
@@ -33,19 +34,19 @@ export interface LayoutSiderProps {
     collapsible?: boolean;
     onCollapse?: (collapsed: boolean) => void;
     /** 触发器内容（默认 chevron Icon） */
-    trigger?: any;
-    children?: any;
+    trigger?: VNodeChild;
+    children?: VNodeChild;
 }
 export interface LayoutHeaderProps {
-    children?: any;
+    children?: VNodeChild;
     style?: any;
 }
 export interface LayoutContentProps {
-    children?: any;
+    children?: VNodeChild;
     style?: any;
 }
 export interface LayoutFooterProps {
-    children?: any;
+    children?: VNodeChild;
     style?: any;
 }
 /** 布局容器：含 Sider → row（横向），否则 column（纵向） */

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

@@ -1,3 +1,4 @@
+/** Link：文字链接：语义色/下划线/disabled/新窗口（showcase /components/link） */
 /**
  * weifuwu/components — Link 文字链接
  *
@@ -8,15 +9,15 @@
  *
  * 裁剪（CS-05，见 docs/client.md）：不做 hover 弹层预览/图标内置枚举（icon 任意 VNode）。
  */
-import type { Component } from '../../vdom/index.ts';
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface LinkProps {
     href?: string;
     variant?: 'default' | 'primary' | 'danger' | 'muted';
     underline?: boolean;
     disabled?: boolean;
     target?: string;
-    icon?: any;
+    icon?: VNodeChild;
     onClick?: (e: any) => void;
-    children?: any;
+    children?: VNodeChild;
 }
 export declare const Link: Component<LinkProps>;

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

@@ -1,10 +1,11 @@
+/** List：通用列表：renderItem + divided + header/footer/empty（showcase /components/list） */
 /**
  * weifuwu/components — List
  *
  * 通用列表：items + renderItem + header/footer/empty 占位。
  * 定位：Table 大材小用的消息/文件/成员列表场景。
  */
-import type { Component } from '../../vdom/index.ts';
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface ListProps<T = any> {
     items: T[];
     renderItem: (item: T, index: number) => any;
@@ -12,8 +13,8 @@ export interface ListProps<T = any> {
      * 身份跟随内容的 key（如项 id），否则默认下标 = 位置身份，增删后项状态会继承错位（规则表 §3） */
     keyBy?: (item: T, index: number) => string | number;
     divided?: boolean;
-    header?: any;
-    footer?: any;
+    header?: VNodeChild;
+    footer?: VNodeChild;
     emptyText?: string;
     emptyIcon?: any;
     className?: string;

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

@@ -1,3 +1,4 @@
+/** Loading：加载状态，支持自定义文字（showcase /components/loading） */
 import type { Component } from '../../vdom/index.ts';
 export interface LoadingProps {
     text?: string;

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

@@ -1,3 +1,4 @@
+/** LogViewer：日志流：ANSI 着色 + 虚拟滚动 + 自动跟随 + 复制（showcase /components/logviewer） */
 /**
  * weifuwu/components — LogViewer
  *

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

@@ -1,3 +1,4 @@
+/** Markdown：AI 回复渲染：安全子集 parser + 代码块 + 链接白名单（showcase /components/markdown） */
 /**
  * weifuwu/components — Markdown
  *

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

@@ -1,3 +1,4 @@
+/** Markdown：AI 回复渲染：安全子集 parser + 代码块 + 链接白名单（showcase /components/markdown） */
 /**
  * weifuwu/components — Markdown 安全子集 parser
  *

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

@@ -1,3 +1,4 @@
+/** MarkdownEditor：分屏 Markdown 编辑器——textarea + 实时预览（复用 Markdown parser 零漂移）（showcase /components/markdowneditor） */
 /**
  * MarkdownEditor — 分屏 Markdown 编辑器（textarea + 实时预览）
  *

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

@@ -1,3 +1,4 @@
+/** Math：轻量公式渲染——自研 LaTeX 子集（上下标/分数/根号/希腊字母——零依赖不引 KaTeX）（showcase /components/math） */
 /**
  * Math — 轻量公式渲染（自研 LaTeX 子集——不引 KaTeX，零依赖）
  *

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

@@ -1,3 +1,4 @@
+/** Mentions：@提及：composition 抑制 + 过滤插入（antd Mentions）（showcase /components/mentions） */
 import type { Component } from '../../vdom/index.ts';
 export interface MentionsOption {
     value: string;

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

@@ -1,3 +1,4 @@
+/** Menu：侧栏导航：分组 + 图标 + 选中态 + 方向键（showcase /components/menu） */
 /**
  * weifuwu/components — Menu
  *
@@ -5,11 +6,11 @@
  * 用于 SaaS 应用侧边导航（替代手写 nav-item 循环）。
  * 裁剪（CS-05，见 docs/client.md）：水平菜单栏（Menubar，独立组件）、子菜单自动互斥。折叠态子菜单浮层已实现（openPopup 内核基座）。
  */
-import type { Component } from '../../vdom/index.ts';
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface MenuItem {
     key: string;
-    label: any;
-    icon?: any;
+    label?: VNodeChild;
+    icon?: VNodeChild;
     /** 分组标题（相邻同组项之间插分组头） */
     group?: string;
     active?: boolean;

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

@@ -1,8 +1,9 @@
-import type { Component } from '../../vdom/index.ts';
+/** Menubar：水平菜单栏：←→ 切换 + ↓ 展开（shadcn Menubar）（showcase /components/menubar） */
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface MenubarItem {
     key: string;
     label: string;
-    icon?: any;
+    icon?: VNodeChild;
     shortcut?: string;
     disabled?: boolean;
     onSelect?: () => void;

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

@@ -1,3 +1,4 @@
+/** MessageBubble：消息气泡：user/assistant + streaming/error 状态 + actions（showcase /components/messagebubble） */
 /**
  * weifuwu/components — MessageBubble
  *
@@ -6,15 +7,15 @@
  * content 支持文本或任意 VNode（可与 Markdown 组合）。
  * 裁剪（CS-05，见 docs/client.md）：不做打字指示动画（Loading 已有）。
  */
-import type { Component } from '../../vdom/index.ts';
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export type MessageBubbleRole = 'user' | 'assistant';
 export type MessageBubbleStatus = 'complete' | 'streaming' | 'error';
 export interface MessageBubbleProps {
-    content: any;
+    content?: VNodeChild;
     role: MessageBubbleRole;
     status?: MessageBubbleStatus;
     /** 气泡尾部操作区（重试/复制按钮等，VNode 或数组） */
-    actions?: any;
+    actions?: VNodeChild;
     className?: string;
 }
 export declare const MessageBubble: Component<MessageBubbleProps>;

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

@@ -1,13 +1,14 @@
+/** Modal：自定义宽度 + closable 控制关闭按钮（showcase /components/modal） */
 /**
  * weifuwu/components — Modal
  */
-import type { Component } from '../../vdom/index.ts';
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface ModalProps {
     open?: boolean;
     title?: string;
     onClose?: () => void;
-    children?: any;
-    footer?: any;
+    children?: VNodeChild;
+    footer?: VNodeChild;
     /** 自定义宽度，如 '500px'、'80%'，默认 400px */
     width?: string;
     /** 是否显示关闭按钮，默认 true */

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

@@ -1,3 +1,4 @@
+/** NavBar：移动端顶栏——left 槽（返回/菜单）+ 标题截断 + right 槽（antd-mobile NavBar 对位）（showcase /components/navbar） */
 /**
  * weifuwu/components — NavBar 移动端顶栏（antd-mobile NavBar / MUI AppBar 对位）
  *

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

@@ -1,3 +1,4 @@
+/** NavMenu：顶部导航：多级 hover 弹出 + 键盘（shadcn NavigationMenu）（showcase /components/navmenu） */
 /**
  * weifuwu/components — NavMenu 顶部导航
  *
@@ -12,10 +13,10 @@
  * 裁剪（CS-05，见 docs/client.md）：不做 hover 延迟微调/子菜单动画曲线定制；
  * 折叠态交还 useBreakpoint 由用户驱动。
  */
-import type { Component } from '../../vdom/index.ts';
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface NavMenuItem {
     key: string;
-    label?: any;
+    label?: VNodeChild;
     children?: NavMenuItem[];
     disabled?: boolean;
 }

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

@@ -1,3 +1,4 @@
+/** Notification：队列式通知：notification.success/error/warning 命令式（antd 对齐）（showcase /components/notification） */
 import type { Component } from '../../vdom/index.ts';
 export type NotificationType = 'success' | 'error' | 'info' | 'warning';
 export type NotificationPosition = 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left';

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

@@ -1,9 +1,10 @@
-import type { Component } from '../../vdom/index.ts';
+/** PageHeader：页面标题栏，支持 sub + 右侧操作区 + display 大标题（showcase /components/pageheader） */
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface PageHeaderProps {
     title: string;
     sub?: string;
     /** 顶级页面大标题（display 档 30px），默认 21px */
     display?: boolean;
-    children?: any;
+    children?: VNodeChild;
 }
 export declare const PageHeader: Component<PageHeaderProps>;

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

@@ -1,3 +1,4 @@
+/** Pagination：分页器，自动计算页码范围（showcase /components/pagination） */
 import type { Component } from '../../vdom/index.ts';
 export interface PaginationProps {
     total: number;

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

@@ -1,3 +1,4 @@
+/** PasswordInput：密码输入：眼睛按钮切换可见性（showcase /components/passwordinput） */
 /**
  * weifuwu/components — PasswordInput
  *

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

@@ -1,3 +1,4 @@
+/** PinInput：验证码输入：自动聚焦/粘贴分派/Backspace 回退（shadcn InputOTP）（showcase /components/pininput） */
 import type { Component } from '../../vdom/index.ts';
 export interface PinInputProps {
     /** 位数，默认 6 */