weifuwu 0.69.0 → 0.71.0

package/dist/client/ui.d.ts

@@ -18,17 +18,23 @@ export interface UiInternal {
     bumpCtxVersion(): void;
     /** 异步批处理调度标记（dirty 微任务防重入） */
     _dirtyScheduled?: boolean;
+    /** 渲染期调 render() 的推迟标记（防重入——见 ui.ts render 实现） */
+    _pendingRender?: boolean;
+    /** 渲染期调 dirty() 的推迟标记（防重入——见 ui.ts dirty 实现） */
+    _pendingDirty?: boolean;
     /** ctx.ui.$() 的 WeakMap 缓存（每组件一个 $ 容器） */
     _$cache?: Record<string, any>;
     /** mount 阶段标记（内部——mountComponent 包裹） */
     setMounting: (v: boolean) => void;
     endMounting: () => void;
+    /** ErrorBoundary 注入的错误处理器（子组件 render 抛错时调用） */
+    _errorHandler?: (err: unknown) => void;
 }
 /** createUi 依赖（由 createApp 注入 app 级闭包状态） */
 export interface UiDeps {
     ctx: WfuiContext;
     renderByIds: (ids: string[]) => void;
-    getSelfId: (ui: any) => string | undefined;
+    getSelfId: (ui: WfuiContext['ui'] | undefined) => string | undefined;
     dirtyBatch: Set<string>;
     dirtySet: Set<string>;
     mediaRegistry: Map<string, {

package/dist/client/vnode.d.ts

@@ -8,19 +8,24 @@
  */
 import type { WfuiContext } from './types.ts';
 export type VNodeType = string | Component<any, any> | AsyncComponent | typeof Fragment | typeof Portal;
+/**
+ * VNode 子节点合法值——组件可返回/渲染的多态内容。
+ * 递归联合：string/number/VNode/array/null/boolean 任意组合。
+ */
+export type VNodeChild = VNode | string | number | boolean | null | undefined | VNodeChild[];
 export interface VNode {
     type: VNodeType;
     props: Record<string, any>;
     key?: string;
     el?: Node;
     /** 子 VNode 缓存（用于 patchValue diff，避免重复执行组件） */
-    _child?: any;
+    _child?: VNode | VNode[] | null;
     /** 远程 DOM 容器（Portal 等 remote VNode 的 DOM 所在处） */
     _remoteEl?: HTMLElement | undefined;
     /** VNode 的 DOM 归属：'local' 在父 DOM 树下，'remote' 在别处 */
     _placement?: 'local' | 'remote';
     /** 两阶段组件的 render 函数（mount 返回的函数） */
-    _render?: (props: any) => VNode | null;
+    _render?: (props: Record<string, unknown>) => VNode | null;
     /** 组件实例 ID（如 '_wf_0'） */
     _id?: string;
     /** 自定义组件 ID（ctx.ui.selfId() 注册，跨组件精准刷新） */
@@ -29,6 +34,8 @@ export interface VNode {
     _parentNode?: Node;
     /** 组件输出的第一个 DOM 节点 */
     _refNode?: Node | null;
+    /** Fragment 展开后的多个直属 DOM 节点范围（diff 对齐用，见 diff.ts） */
+    _childNodes?: Node[];
     /** 组件 mount/render 时的 ctx 版本号（供三态 skip 判定） */
     _ctxVersion?: number;
 }
@@ -73,7 +80,7 @@ export declare const Portal: unique symbol;
 declare global {
     namespace JSX {
         type Element = VNode | null;
-        type ElementType = string | Component<any>;
+        type ElementType = string | Component<any, any>;
         interface IntrinsicAttributes {
             key?: string | number;
         }
@@ -86,10 +93,10 @@ export declare function jsx(type: VNodeType, props: Record<string, any> | null,
 export declare const jsxs: typeof jsx;
 export declare function jsxDEV(type: VNodeType, props: Record<string, any> | null, key?: string | null): VNode;
 /** `h`（hyperscript）支持 variadic children: `h('div', {class:'x'}, child1, child2)` */
-export declare function h(type: VNodeType, props: Record<string, any> | null, ...children: any[]): VNode;
+export declare function h(type: VNodeType, props: Record<string, any> | null, ...children: VNodeChild[]): VNode;
 export declare function isNative(vnode: VNode): boolean;
 export declare function isComponent(vnode: VNode): boolean;
 export declare function isFragment(vnode: VNode): boolean;
 export declare function isPortal(vnode: VNode): boolean;
 /** Portal VNode — 子节点渲染到 document.body#__wf_portal 中 */
-export declare function createPortal(children: any, portalKey?: string): VNode;
+export declare function createPortal(children: VNodeChild, portalKey?: string): VNode;

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

@@ -26,5 +26,7 @@ export interface ApprovalCardProps {
     onReject?: (note?: string) => void;
     /** 自定义详情渲染（默认显示 name + args） */
     renderDetail?: (request: WfApprovalRequest) => any;
+    /** 提交中（按钮禁用 + 文案反馈，防连点） */
+    loading?: boolean;
 }
 export declare const ApprovalCard: Component<ApprovalCardProps>;

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

@@ -4,5 +4,11 @@ export interface BadgeProps {
     variant?: BadgeVariant;
     dot?: boolean;
     children?: any;
+    /** 数值角标（与 children 互斥；超出 overflowCount 显示 N+） */
+    count?: number;
+    /** 数值溢出阈值，默认 99（count > 阈值 → 阈值+） */
+    overflowCount?: number;
+    /** count=0 时是否显示（默认 false 隐藏，antd showZero=false 语义） */
+    showZero?: boolean;
 }
 export declare const Badge: Component<BadgeProps>;

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

@@ -10,6 +10,8 @@ export interface CardProps {
     /** 选中态（边框高亮 + 品牌浅底），适合选择卡片 */
     active?: boolean;
     onClick?: () => void;
+    className?: string;
+    style?: Record<string, string>;
     children?: any;
 }
 export declare const Card: Component<CardProps>;

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

@@ -14,8 +14,12 @@ export interface CascaderProps {
     disabled?: boolean;
     error?: string;
     label?: string;
+    /** 显示搜索框（面板内，关键词时扁平过滤结果列表） */
+    showSearch?: boolean;
+    /** 搜索占位符 */
+    searchPlaceholder?: string;
     'aria-label'?: string;
 }
-/** 级联选择（对应 antd/EP Cascader）：多列面板逐级选择，点击叶子完成。
- * 裁剪：hover 展开、搜索、任意层级配置、异步加载。 */
+/** 级联选择（对应 antd/EP Cascader）：多列面板逐级选择，点击叶子完成 + 可选搜索。
+ * 裁剪：hover 展开、任意层级配置、异步加载。 */
 export declare const Cascader: Component<CascaderProps>;

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

@@ -1,9 +1,9 @@
 /**
  * weifuwu/components — CodeBlock
  *
- * 代码展示块：语言标签 + 复制按钮 + 横向滚动。
+ * 代码展示块：语言标签 + 复制按钮 + 横向滚动 + 自研轻量语法高亮
+ * （highlight.ts tokenizer——零依赖 FS-05）。
  * 由 Markdown 代码围栏复用；也可独立使用。
- * 裁剪：不做语法高亮（零依赖，语言标签仅展示）。
  */
 import type { Component } from '../../client/vnode.ts';
 export interface CodeBlockProps {

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

@@ -0,0 +1,15 @@
+/**
+ * weifuwu/components — 轻量语法高亮 tokenizer
+ *
+ * 零依赖（FS-05）：正则单 pass 扫描，覆盖常见语法（注释/字符串/关键字/
+ * 数字/函数调用/JSX 标签/操作符）。不追求完美分词（不做括号配对、多行
+ * 字符串状态机），聚焦"代码可读性"——足够支撑文档/源码展示。
+ *
+ * 返回 token 数组：{ type: 'comment'|'string'|'keyword'|'number'|
+ * 'function'|'jsx-tag'|'jsx-attr'|'operator'|'text', text }
+ */
+export type HighlightToken = {
+    type: string;
+    text: string;
+};
+export declare function tokenize(code: string, lang?: string): HighlightToken[];

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

@@ -10,5 +10,7 @@ export interface DrawerProps {
     onClose?: () => void;
     children?: any;
     footer?: any;
+    /** 面板宽度（默认 360px——--wf-drawer-width 变量） */
+    width?: string;
 }
 export declare const Drawer: Component<DrawerProps>;

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

@@ -1,6 +1,7 @@
-import type { Component } from '../../client/vnode.ts';
+import type { Component, VNode } from '../../client/vnode.ts';
 export interface EmptyStateProps {
-    icon?: string;
+    /** 图标——VNode（推荐 <Icon />）或字符串（emoji/字形）；默认 Icon inbox（P3：组件内禁裸 emoji） */
+    icon?: string | VNode | null;
     text?: string;
     hint?: string;
     children?: any;

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

@@ -9,7 +9,7 @@
  *   h(Icon, { name: 'check', size: 16 })
  */
 import type { Component } from '../../client/vnode.ts';
-export type IconName = 'chevron-down' | 'chevron-up' | 'chevron-left' | 'chevron-right' | 'arrow-left' | 'arrow-up' | 'arrow-down' | 'arrow-right' | 'sort' | 'sort-asc' | 'sort-desc' | 'check' | 'close' | 'alert' | 'info' | 'warning' | 'pause' | 'settings' | 'search' | 'send' | 'stop' | 'retry' | 'upload' | 'trash' | 'edit' | 'plus' | 'copy' | 'eye' | 'eye-off' | 'star';
+export type IconName = 'chevron-down' | 'chevron-up' | 'chevron-left' | 'chevron-right' | 'arrow-left' | 'arrow-up' | 'arrow-down' | 'arrow-right' | 'sort' | 'sort-asc' | 'sort-desc' | 'check' | 'close' | 'alert' | 'info' | 'warning' | 'pause' | 'settings' | 'search' | 'send' | 'stop' | 'retry' | 'upload' | 'trash' | 'edit' | 'plus' | 'copy' | 'eye' | 'eye-off' | 'star' | 'dashboard' | 'grid' | 'box' | 'users' | 'user' | 'home' | 'folder' | 'file' | 'file-text' | 'calendar' | 'clock' | 'bell' | 'menu' | 'activity' | 'trending-up' | 'trending-down' | 'database' | 'server' | 'heart' | 'refresh' | 'message' | 'inbox' | 'shield' | 'zap' | 'target' | 'mail' | 'external-link' | 'log-out' | 'lock' | 'list' | 'bar-chart' | 'gauge' | 'paperclip' | 'filter' | 'layers' | 'map-pin' | 'book-open' | 'github' | 'tag' | 'phone' | 'more-vertical' | 'check-circle' | 'alert-circle' | 'wifi' | 'cpu' | 'hard-drive' | 'globe' | 'briefcase' | 'layout';
 export interface IconProps {
     name: IconName;
     /** 尺寸，默认 1em（随字号缩放） */

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

@@ -1,9 +1,9 @@
 /**
  * weifuwu/components — InputNumber
  *
- * 数字输入：min/max/step + 增减按钮 + precision 格式化。
+ * 数字输入：min/max/step + 增减按钮 + precision 格式化 + 长按连增。
  * 受控 value: number | null；空值 → null；输入 clamp 到 min/max。
- * 裁剪：不做长按连增/千分位货币（见 roadmap）。
+ * 裁剪：不做千分位货币（见 roadmap）。
  */
 import type { Component } from '../../client/vnode.ts';
 export interface InputNumberProps {

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

@@ -20,6 +20,8 @@
  */
 import type { Component } from '../../client/vnode.ts';
 export interface LayoutProps {
+    style?: any;
+    className?: string;
     children?: any;
 }
 export interface LayoutSiderProps {

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

@@ -4,25 +4,31 @@
  * 零依赖自研解析器，输出结构化 token（非 HTML 字符串）——
  * 组件层以 VNode 渲染，天然转义任何用户/AI 内容（无 innerHTML 注入面）。
  *
- * 支持块级：标题(#~####) / 段落 / 列表(有序·无序) / 围栏代码块 / 引用 / 分割线
- * 支持行内：**粗体** / *斜体* / `行内代码` / [文本](链接)
+ * 支持块级：标题(#~####) / 段落 / 列表(有序·无序·GFM 任务) / 围栏代码块 / 引用 / 分割线 / GFM 表格
+ * 支持行内：**粗体** / *斜体* / ~~删除线~~ / `行内代码` / [文本](链接)
  *
- * 诚实裁剪：GFM 表格/任务列表/删除线/脚注/raw HTML/自动链接/语法高亮（见 roadmap）
+ * 诚实裁剪：脚注/raw HTML/自动链接/语法高亮（见 roadmap）
  */
 export interface MdInline {
-    type: 'text' | 'code' | 'bold' | 'italic' | 'link';
+    type: 'text' | 'code' | 'bold' | 'italic' | 'del' | 'link';
     text?: string;
     href?: string;
     children?: MdInline[];
 }
 export interface MdBlock {
-    type: 'heading' | 'paragraph' | 'list' | 'code' | 'quote' | 'hr';
+    type: 'heading' | 'paragraph' | 'list' | 'code' | 'quote' | 'hr' | 'table';
     level?: number;
     inline?: MdInline[];
     ordered?: boolean;
     items?: MdInline[][];
+    /** GFM 任务列表：与 items 平行，null=非任务项 */
+    checks?: (boolean | null)[];
     lang?: string;
     code?: string;
+    /** GFM 表格 */
+    headers?: string[];
+    rows?: string[][];
+    aligns?: ('left' | 'center' | 'right')[];
 }
 /** 链接安全：仅 http/https；javascript:/data:/vbscript: 一律拒绝 */
 export declare function safeUrl(href: string): string | null;

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

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

package/dist/components/ProgressBar/ProgressBar.d.ts

@@ -1,8 +1,13 @@
 import type { Component } from '../../client/vnode.ts';
 export interface ProgressBarProps {
+    /** 进度值；undefined = indeterminate（不确定态，动画扫动） */
     value?: number;
     max?: number;
     label?: string;
     showValue?: boolean;
+    /** 状态色（default/success/error/warning） */
+    status?: 'default' | 'success' | 'error' | 'warning';
+    /** 尺寸 */
+    size?: 'sm' | 'md' | 'lg';
 }
 export declare const ProgressBar: Component<ProgressBarProps>;

package/dist/components/Rate/Rate.d.ts

@@ -11,6 +11,8 @@ export interface RateProps {
     disabled?: boolean;
     /** 点击当前评分值 → 清除为 0（antd 对齐） */
     allowClear?: boolean;
+    /** 允许半星（0.5 精度；点击左半=半星，右半=整星） */
+    allowHalf?: boolean;
     'aria-label'?: string;
 }
 export declare const Rate: Component<RateProps>;

package/dist/components/Sparkline/Sparkline.d.ts

@@ -12,6 +12,8 @@ export interface SparklineProps {
     fill?: boolean;
     /** 平滑曲线（Catmull-Rom）——默认折线 */
     smooth?: boolean;
+    /** 可访问名（提供则 role=img + aria-label，否则 aria-hidden 装饰） */
+    label?: string;
     className?: string;
 }
 /**

package/dist/components/StatCard/StatCard.d.ts

@@ -1,10 +1,12 @@
-import type { Component } from '../../client/vnode.ts';
+import type { Component, VNode } from '../../client/vnode.ts';
 export interface StatCardProps {
     label: string;
-    value: string | number;
+    /** 展示值——countdown 模式下可选（显示剩余时间） */
+    value?: string | number;
     trend?: 'up' | 'down';
     trendLabel?: string;
-    icon?: string;
+    /** 图标——字符串（emoji/字形）或 VNode（推荐 <Icon name=... />，禁 emoji 装饰的场景用后者） */
+    icon?: string | VNode | null;
     /** 点击跳转/交互（悬停抬升 + role=button） */
     onClick?: () => void;
     /** 数字从 0 递增动画（reduced-motion 下直接终值），仅数值类型生效 */

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

@@ -1,9 +1,10 @@
 /**
  * weifuwu/components — Timeline
  *
- * 竖向时间线：节点（状态色圆点/自定义）+ 标题 + 时间 + 内容 + 连接线。
- * 用于执行日志、审批历史、审计记录。
- * 裁剪：不做横向时间线/折叠节点（见 roadmap）。
+ * 时间线：节点（状态色圆点/自定义）+ 标题 + 时间 + 内容 + 连接线。
+ * 竖向（left/alternate）+ 横向（horizontal）。
+ * 用于执行日志、审批历史、审计记录、步骤进度。
+ * 裁剪：不做折叠节点。
  */
 import type { Component } from '../../client/vnode.ts';
 export type TimelineStatus = 'default' | 'info' | 'success' | 'warning' | 'error';
@@ -19,7 +20,7 @@ export interface TimelineItem {
 }
 export interface TimelineProps {
     items: TimelineItem[];
-    mode?: 'left' | 'alternate';
+    mode?: 'left' | 'alternate' | 'horizontal';
     reverse?: boolean;
 }
 export declare const Timeline: Component<TimelineProps>;

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

@@ -12,7 +12,11 @@ export interface TransferProps {
     titles?: [string, string];
     size?: 'sm' | 'md' | 'lg';
     disabled?: boolean;
+    /** 显示搜索框（每侧独立过滤，内部态） */
+    showSearch?: boolean;
+    /** 搜索占位符 */
+    searchPlaceholder?: string;
 }
-/** 穿梭框（对应 antd/EP Transfer）：双列表 + 中间穿梭按钮。
- * 裁剪：搜索过滤、拖拽排序、自定义渲染。 */
+/** 穿梭框（对应 antd/EP Transfer）：双列表 + 中间穿梭按钮 + 可选搜索。
+ * 裁剪：拖拽排序、自定义渲染。 */
 export declare const Transfer: Component<TransferProps>;

package/dist/components/Tree/Tree.d.ts

@@ -20,10 +20,12 @@ export interface TreeProps {
     expandOnClick?: boolean;
     checkedKeys?: string[];
     onCheck?: (keys: string[]) => void;
+    /** 搜索过滤（label 含 searchValue 的节点 + 祖先；自动展开匹配路径 + 高亮） */
+    searchValue?: string;
     className?: string;
 }
 /**
  * 树形（对应 antd/EP Tree）：递归节点 + 展开/折叠 + 单选 + 勾选（父子联动 +
- * indeterminate 半选态）。裁剪：拖拽、异步加载、搜索过滤。
+ * indeterminate 半选态 + 搜索过滤 searchValue）。裁剪：拖拽、异步加载。
  */
 export declare const Tree: Component<TreeProps>;

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

@@ -4,7 +4,8 @@
  * 虚拟表格（数据密集场景）：固定表头 + 虚拟滚动表体，10k+ 行只渲染可见窗口。
  * 复用 VirtualList 滚动基座（useScrollPosition 像素级 scrollTop + rAF 节流）。
  * 排序：受控 sortKey/sortOrder + onSort（与 Table 同款模式）。
- * 裁剪：行选择（rowSelection）、列虚拟化（横向）、行编辑、单元格合并、树形表格。
+ * 行选择：rowSelection（受控 selectedRowKeys + onChange，复选框列）。
+ * 裁剪：列虚拟化（横向）、行编辑、单元格合并、树形表格。
  */
 import type { Component } from '../../client/vnode.ts';
 import type { TableColumn } from '../Table/Table.ts';
@@ -27,6 +28,13 @@ export interface VirtualTableProps {
     emptyText?: string;
     /** 行点击 */
     onRowClick?: (row: any, index: number) => void;
+    /** 行选择配置（受控） */
+    rowSelection?: {
+        selectedRowKeys: (string | number)[];
+        onChange?: (selectedRowKeys: (string | number)[], selectedRows: any[]) => void;
+        /** 行 key 字段名，默认 'id'；无该字段回退到索引 */
+        rowKey?: string;
+    };
     className?: string;
 }
 export declare const VirtualTable: Component<VirtualTableProps>;

package/dist/components/index.d.ts

@@ -28,7 +28,7 @@ export type { ModalProps } from './Modal/Modal.ts';
 export { Confirm, confirm } from './Confirm/Confirm.ts';
 export type { ConfirmProps, ConfirmOptions } from './Confirm/Confirm.ts';
 export { Toast, toast } from './Toast/Toast.ts';
-export type { ToastProps, ToastItem, ToastType, ToastPosition, ToastOptions } from './Toast/Toast.ts';
+export type { ToastProps, ToastItem, ToastType, ToastPosition, ToastOptions, ToastInjected } from './Toast/Toast.ts';
 export { Alert } from './Alert/Alert.ts';
 export type { AlertProps, AlertVariant } from './Alert/Alert.ts';
 export { Loading } from './Loading/Loading.ts';