weifuwu 0.93.1 → 0.93.3

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

@@ -1,3 +1,4 @@
+/** DropZone：全区域拖放区——整容器拖入文件高亮 + onFiles 回调（现代 IM 标配——Chat 手搓证据）（showcase /components/dropzone） */
 /**
  * weifuwu/components — DropZone 全区域拖放区
  *
@@ -16,12 +17,12 @@
  * - 非文件拖入忽略（files 空不回调）；disabled 全路径拦截
  * - 事件经 useDragDrop 原语（dragover preventDefault 允许放置——vdom 事件表通道）
  */
-import type { Component } from '../../vdom/index.ts';
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface DropZoneProps {
     /** 拖放文件回调（file 数组——调用方负责后续链——与按钮链共享） */
     onFiles?: (files: File[]) => void;
     disabled?: boolean;
     className?: string;
-    children?: any;
+    children?: VNodeChild;
 }
 export declare const DropZone: Component<DropZoneProps>;

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

@@ -1,10 +1,11 @@
+/** Dropdown：下拉菜单，支持 danger variant（showcase /components/dropdown） */
 /**
  * weifuwu/components — Dropdown
  *
  * openPopup 内核：click 触发 + 受控 open + 外部点击/Escape（document 级，
  * 弹层在 portal 中按 Escape 也能关）+ 定位/视口 clamp + portal。
  */
-import type { Component } from '../../vdom/index.ts';
+import type { Component, VNodeChild } from '../../vdom/index.ts';
 export interface DropdownItem {
     label: string;
     value?: string;
@@ -13,7 +14,7 @@ export interface DropdownItem {
     onClick?: () => void;
 }
 export interface DropdownProps {
-    trigger: any;
+    trigger?: VNodeChild;
     items?: DropdownItem[];
     open?: boolean;
     /** 关闭回调（面板内 Escape / 外部点击） */

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

@@ -1,3 +1,4 @@
+/** Editor：富文本编辑器，contentEditable + toolbar，零依赖（showcase /components/editor） */
 /**
  * weifuwu/components/Editor — 富文本编辑器（事件流事务层，阶段 1）
  *

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

@@ -1,3 +1,4 @@
+/** Editor：富文本编辑器，contentEditable + toolbar，零依赖（showcase /components/editor） */
 /**
  * weifuwu/components/Editor/edit-events — 编辑事件流（第四端）
  *

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

@@ -1,3 +1,4 @@
+/** Editor：富文本编辑器，contentEditable + toolbar，零依赖（showcase /components/editor） */
 /**
  * weifuwu/components/Editor/model/apply — 事件应用（文档 = fold(事件流)）
  *

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

@@ -1,3 +1,4 @@
+/** Editor：富文本编辑器，contentEditable + toolbar，零依赖（showcase /components/editor） */
 /**
  * weifuwu/components/Editor/model/diff — 文本 diff（AI 建议对比用）
  *

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

@@ -1,3 +1,4 @@
+/** Editor：富文本编辑器，contentEditable + toolbar，零依赖（showcase /components/editor） */
 /**
  * weifuwu/components/Editor/model/dom — offset ↔ DOM 桥
  *

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/ListScaffold/ListScaffold.d.ts

@@ -0,0 +1,40 @@
+/** ListScaffold：列表页骨架（PageHeader + 工具栏 + loading/empty + 内容插槽）（showcase /components/list-scaffold） */
+import type { Component, VNodeChild } from '../../vdom/index.ts';
+/**
+ * weifuwu/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/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,15 +6,17 @@
  * 用于 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;
     danger?: boolean;
+    /** 计数徽标（数字 → Badge count 胶囊——99+ 溢出；label 直传自定义形态） */
+    badge?: string | number;
     onClick?: () => void;
     /** 子菜单项（有 children 即渲染为可展开子菜单） */
     children?: MenuItem[];