weifuwu 0.60.0 → 0.61.0

package/dist/client/middleware/api.d.ts

@@ -23,6 +23,8 @@ export interface ApiOptions {
     baseURL?: string;
     /** 默认请求头 */
     headers?: Record<string, string>;
+    /** 动态鉴权 token：非空时自动加 `Authorization: Bearer <token>`（请求头未显式指定时） */
+    token?: () => string | null;
     /** 请求拦截器 */
     onRequest?: (req: {
         url: string;

package/dist/client/motion.d.ts

@@ -0,0 +1,8 @@
+/**
+ * weifuwu/client — 动效工具
+ *
+ * animateOut：挂 --exit 类播退场动画，animationend 后回调。
+ * - reduced-motion 下动画时长被 _base.css 降为 0.01ms，animationend 立即触发，等效瞬时关闭
+ * - 兜底 timeout：类未命中动画（防御）或 animationend 丢失时不挂死
+ */
+export declare function animateOut(el: HTMLElement, onDone: () => void, fallbackMs?: number): void;

package/dist/client/registry.d.ts

@@ -0,0 +1,34 @@
+/**
+ * weifuwu/client 注册表 — 组件实例 ID 注册 + async 工厂缓存 + ref 清理
+ *
+ * 从 render.ts 拆出（P2 结构拆分）：本文件无内部依赖（仅 vnode/types），
+ * render/diff/hydration/app 各模块共享同一实例状态。
+ * ⚠️ 模块状态共享约束：本文件必须保持单实例（dist 消费端由 build.mjs 外部化保证）。
+ */
+import type { VNode, Component, AsyncComponent } from './vnode.ts';
+import type { WfuiContext } from './types.ts';
+export declare const idRegistry: Map<string, VNode>;
+type UnmountHook = (id: string) => void;
+/** 注册组件卸载钩子（组件从 idRegistry 注销时触发，含 _customId） */
+export declare function onComponentUnmount(hook: UnmountHook): void;
+interface FactoryEntry {
+    promise: Promise<Component<any, any>>;
+    resolved?: Component<any, any>;
+}
+/**
+ * 清空 async 工厂缓存。
+ * 页面上下文切换时调用（路由导航/登录登出）——工厂内 ctx.data.get 的 key 依赖 ctx（如 route.params），
+ * 上下文变化后旧缓存定义的数据已失效，需要让工厂以新 ctx 重新执行。
+ */
+export declare function clearAsyncComponentCache(): void;
+/** 启动 async 工厂（幂等，缓存）：返回 entry，promise resolve 后 resolved 可用 */
+export declare function startAsyncFactory(Comp: AsyncComponent, ctx: WfuiContext): FactoryEntry;
+/** async 模式：await 工厂定义（初次渲染/服务端遍历/未来 hydration） */
+export declare function resolveAsyncFactory(Comp: AsyncComponent, ctx: WfuiContext): Promise<Component>;
+/** sync 模式：工厂已解析 → 定义；未解析 → undefined（占位 + 完成后整树重渲染） */
+export declare function resolveAsyncFactorySync(Comp: AsyncComponent): Component | undefined;
+/** 通知 ref 清理 + Portal 子容器清理 */
+export declare function callRefCleanup(input: any): void;
+/** 供 hydration/mount 路径生成新组件 ID（保持与 idRegistry 同源递增） */
+export declare function nextComponentId(): string;
+export {};

package/dist/client/render.d.ts

@@ -10,26 +10,25 @@
  *
  * 状态管理：组件使用闭包变量 + ctx.ui.render() 手动触发重渲染。
  */
-import type { VNode } from './vnode.ts';
+import type { VNode, Component, AsyncComponent } from './vnode.ts';
 import type { WfuiContext } from './types.ts';
-export declare const idRegistry: Map<string, VNode>;
+export declare const SVG_NS = "http://www.w3.org/2000/svg";
+export declare const SVG_TAGS: Set<string>;
 export declare function render(input: any, ctx: WfuiContext): Node | null;
+export declare function renderValue(v: any, ctx: WfuiContext): Node | null;
 /**
- * 清空 async 工厂缓存。
- * 页面上下文切换时调用（路由导航/登录登出）——工厂内 ctx.data.get 的 key 依赖 ctx（如 route.params），
- * 上下文变化后旧缓存定义的数据已失效，需要让工厂以新 ctx 重新执行。
+ * 同步 mount 组件（async 工厂占位策略）：
+ *   - 同步组件 → def(props, ctx) → render fn → 输出 VNode
+ *   - async 工厂已解析 → 同同步组件
+ *   - async 工厂未解析 → 占位（返回 null）+ 启动工厂 + 完成后整树重渲染
  */
-export declare function clearAsyncComponentCache(): void;
+export declare function mountComponent(Comp: Component | AsyncComponent, props: any, vnode: VNode, ctx: WfuiContext): VNode | null;
 /** 首次渲染 Portal：创建远程容器、渲染子节点（不返回占位节点） */
 export declare function renderPortal(vnode: VNode, ctx: WfuiContext): void;
 /** 更新 Portal：复用远程容器，patch 子节点（不操作父 DOM） */
 export declare function patchPortal(oldV: VNode | null, newV: VNode, ctx: WfuiContext): void;
-export declare function patchValue(parent: Node, oldNode: Node | null, oldInput: any, newInput: any, ctx: WfuiContext): Node | null;
-/** 通知 ref 清理 + Portal 子容器清理 */
-export declare function callRefCleanup(input: any): void;
+/** 展平嵌套数组 */
+export declare function flattenChildren(children: any): any[];
 export declare function mountVNode(container: Element, vnode: VNode, ctx: WfuiContext): void;
-/**
- * Hydration 挂载入口：收养 container 内现有服务端 HTML。
- * 渲染完收尾：删除服务端有、客户端没有的残留 DOM。
- */
-export declare function hydrateVNode(container: Element, vnode: VNode, ctx: WfuiContext): Promise<void>;
+export { callRefCleanup, idRegistry, clearAsyncComponentCache, nextComponentId } from './registry.ts';
+export { patchValue } from './diff.ts';

package/dist/client/types.d.ts

@@ -15,6 +15,13 @@ export interface PopupPositionOptions {
         width?: number;
     };
 }
+/** 异步取数工具返回值 — ctx.ui.useAsync()（data/loading/error 响应式，reload 重跑） */
+export interface UseAsyncHandle<T = any> {
+    data?: T;
+    loading: boolean;
+    error?: unknown;
+    reload: () => void;
+}
 /** 弹层位置跟踪器 — usePopupPosition 的返回值 */
 export interface PopupPosition {
     top: number;
@@ -44,8 +51,22 @@ export interface WfuiContext {
          * ```
          */
         useChat: (options: UseChatOptions) => UseChatHandle;
+        /** 响应式媒体查询：注册监听，值变化时自动 dirty（立即回调一次当前值） */
+        useMedia: (query: string, callback: (matches: boolean) => void) => void;
+        /** 响应式断点：mobile/tablet/desktop 或自定义断点，值变化时自动 dirty */
+        useBreakpoint: (bpsOrCallback: Record<string, string> | ((vp: string) => void), callback?: (vp: string) => void) => void;
         /** 弹层位置跟踪：滚动/resize 时自动重算 fixed 坐标 */
         usePopupPosition: (options: PopupPositionOptions) => PopupPosition;
+        /**
+         * 异步取数工具（mount 阶段调用）：loading/error 自动管理 + 数据就绪自动渲染。
+         *
+         * ```tsx
+         * const list = ctx.ui.useAsync(() => ctx.api.get<User[]>('/users'))
+         * return () => list.loading ? h(Loading) : list.data?.map(...)
+         * ```
+         * data/loading/error 响应式；reload() 重跑；组件卸载后旧 Promise resolve 不再触发渲染。
+         */
+        useAsync: <T = any>(fetcher: () => Promise<T>) => UseAsyncHandle<T>;
         /** 注册组件实例的自定义语义 ID，同名冲突抛错 */
         selfId: (name: string) => void;
         /** 当前组件实例 ID（仅供内部使用，通过 ctx 扩展注入） */
@@ -107,6 +128,13 @@ export interface WfuiContext {
         logout: () => void;
         [key: string]: any;
     };
+    /** 命令式确认（由 components 的 confirm() 中间件注入）：ctx.confirm(msg) → Promise<boolean> */
+    confirm?: (message: string, options?: Record<string, any>) => Promise<boolean>;
+    /** 命令式轻提示（由 components 的 toast() 中间件注入）：ctx.toast(msg, type?, duration?, action?) */
+    toast?: (message: string, type?: string, duration?: number, action?: {
+        label: string;
+        onClick: () => void;
+    }) => void;
 }
 /** 中间件签名 */
 /**

package/dist/client/ui.d.ts

@@ -0,0 +1,56 @@
+/**
+ * weifuwu/client ctx.ui 工厂 — createApp 注入的 UI 能力
+ *
+ * 从 app.ts 拆出（P2 结构拆分）。createUi(deps) 返回完整 ui 对象：
+ * render / dirty / $ / useChat / useMedia / useBreakpoint / usePopupPosition / selfId
+ *
+ * 内部状态（_selfId/_selfVNode/_dirtySet/_ctxVersion）集中建模为 UiInternal，
+ * 消除 app.ts 中散落的 `as any`——跨模块状态误用由编译器拦截。
+ */
+import type { WfuiContext, PopupPosition } from './types.ts';
+import type { VNode } from './vnode.ts';
+/** 内部 UI 状态（ctx.ui 扩展字段）——跨模块共享，编译器可检查 */
+export interface UiInternal {
+    _selfId?: string;
+    _selfVNode?: VNode;
+    _dirtySet: Set<string>;
+    _ctxVersion: number;
+    bumpCtxVersion(): void;
+    /** 异步批处理调度标记（dirty 微任务防重入） */
+    _dirtyScheduled?: boolean;
+    /** ctx.ui.$() 的 WeakMap 缓存（每组件一个 $ 容器） */
+    _$cache?: Record<string, any>;
+}
+/** createUi 依赖（由 createApp 注入 app 级闭包状态） */
+export interface UiDeps {
+    ctx: WfuiContext;
+    renderByIds: (ids: string[]) => void;
+    getSelfId: (ui: any) => string | undefined;
+    dirtyBatch: Set<string>;
+    dirtySet: Set<string>;
+    mediaRegistry: Map<string, {
+        mql?: MediaQueryList;
+        handler?: (e: MediaQueryListEvent) => void;
+        mqls?: Array<{
+            mql: MediaQueryList;
+            handler: () => void;
+        }>;
+    }>;
+    popupTrackers: Map<string, {
+        pos: PopupPosition;
+        getEl: () => HTMLElement | null;
+        isOpen: () => boolean;
+        compute: (rect: DOMRect) => {
+            top: number;
+            left: number;
+            width?: number;
+        };
+    }>;
+    schedulePopupRecompute: () => void;
+    /** 惰性挂载全局 scroll/resize 监听（幂等） */
+    ensurePopupListeners: () => void;
+    destroyPopupListeners: () => void;
+    /** 渲染保护期（dirty 被忽略） */
+    isRendering: () => boolean;
+}
+export declare function createUi(deps: UiDeps): WfuiContext['ui'] & UiInternal;

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

@@ -1,5 +1,5 @@
 import type { Component } from '../../client/vnode.ts';
-export type BadgeVariant = 'default' | 'primary' | 'success' | 'warning' | 'danger' | 'info';
+export type BadgeVariant = 'default' | 'primary' | 'success' | 'warning' | 'danger' | 'info' | 'error';
 export interface BadgeProps {
     variant?: BadgeVariant;
     dot?: boolean;

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

@@ -6,6 +6,9 @@ export interface ButtonProps {
     loading?: boolean;
     disabled?: boolean;
     type?: 'button' | 'submit';
+    title?: string;
+    /** 透传原生 class（覆盖默认 wf-btn 组合） */
+    class?: string;
     onClick?: (e: MouseEvent) => void;
     children?: any;
 }

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

@@ -1,6 +1,8 @@
 import type { Component } from '../../client/vnode.ts';
 export interface CardProps {
     variant?: 'default' | 'outlined';
+    /** 便捷：outlined = variant 'outlined' */
+    outlined?: boolean;
     padding?: 'sm' | 'md' | 'lg';
     clickable?: boolean;
     /** hover 抬升（阴影 + 上移），适合可点击/可悬停的卡片 */

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

@@ -16,6 +16,8 @@ export interface ConfirmProps {
     variant?: 'primary' | 'danger';
     /** 对话框宽度，如 '500px'、'80%'，默认 Modal 的 400px */
     width?: string;
+    /** 遮罩点击是否取消（默认 false：危险操作防误触；显式传 true 可恢复） */
+    maskClosable?: boolean;
     onConfirm?: () => void;
     onCancel?: () => void;
 }
@@ -26,6 +28,11 @@ export interface ConfirmOptions {
     cancelText?: string;
     variant?: 'primary' | 'danger';
     width?: string;
+    maskClosable?: boolean;
+}
+/** 命令式 ctx.confirm 的注入类型（AppMiddleware<{}, ConfirmInjected>） */
+export interface ConfirmInjected {
+    confirm: (message: string, options?: ConfirmOptions) => Promise<boolean>;
 }
 /**
  * 命令式中间件：注入 ctx.confirm()
@@ -33,5 +40,5 @@ export interface ConfirmOptions {
  * 每次调用挂载 Confirm 组件到独立容器（mountVNode），
  * resolve 后 callRefCleanup 清理（含 Modal 的 portal DOM）+ 移除容器。
  */
-export declare function confirm(): AppMiddleware;
+export declare function confirm(): AppMiddleware<{}, ConfirmInjected>;
 export declare const Confirm: Component<ConfirmProps>;

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

@@ -13,5 +13,7 @@ export interface DropdownProps {
     trigger: any;
     items?: DropdownItem[];
     open?: boolean;
+    /** 关闭回调（面板内 Escape） */
+    onOpenChange?: (open: boolean) => void;
 }
 export declare const Dropdown: Component<DropdownProps>;

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

@@ -0,0 +1,19 @@
+/**
+ * weifuwu/components — Icon 内联 SVG 图标
+ *
+ * 24px stroke 风格（feather-like），currentColor 着色随文字/上下文，
+ * 零外部依赖（FS-05）。组件内部图标统一走这里，替换文本字形/emoji。
+ *
+ * 用法：
+ *   h(Icon, { name: 'close' })
+ *   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' | 'sort' | 'sort-asc' | 'sort-desc' | 'check' | 'close' | 'alert' | 'info' | 'warning' | 'pause' | 'settings' | 'search' | 'send' | 'stop' | 'retry' | 'upload' | 'trash' | 'edit' | 'plus';
+export interface IconProps {
+    name: IconName;
+    /** 尺寸，默认 1em（随字号缩放） */
+    size?: number | string;
+    className?: string;
+}
+export declare const Icon: Component<IconProps>;

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

@@ -13,5 +13,10 @@ export interface InputProps {
     variant?: 'default' | 'borderless';
     onInput?: (e: Event) => void;
     onChange?: (e: Event) => void;
+    /** 原生 input 属性透传（type=number 时 min/max/step 等） */
+    min?: string | number;
+    max?: string | number;
+    step?: string | number;
+    [key: string]: any;
 }
 export declare const Input: Component<InputProps>;

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

@@ -12,5 +12,7 @@ export interface ModalProps {
     width?: string;
     /** 是否显示关闭按钮，默认 true */
     closable?: boolean;
+    /** 点击遮罩是否关闭，默认 true（危险确认应设 false） */
+    maskClosable?: boolean;
 }
 export declare const Modal: Component<ModalProps>;

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

@@ -2,6 +2,8 @@ import type { Component } from '../../client/vnode.ts';
 export interface PageHeaderProps {
     title: string;
     sub?: string;
+    /** 顶级页面大标题（display 档 30px），默认 21px */
+    display?: boolean;
     children?: any;
 }
 export declare const PageHeader: Component<PageHeaderProps>;

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

@@ -7,5 +7,7 @@ export interface StatCardProps {
     icon?: string;
     /** 点击跳转/交互（悬停抬升 + role=button） */
     onClick?: () => void;
+    /** 数字从 0 递增动画（reduced-motion 下直接终值），仅数值类型生效 */
+    animate?: boolean;
 }
 export declare const StatCard: Component<StatCardProps>;

package/dist/components/Table/Table.d.ts

@@ -24,5 +24,9 @@ export interface TableProps {
     emptyText?: string;
     /** 表格最小宽度（窄屏横向滚动，如 '720px'） */
     minWidth?: string;
+    /** 加载中：保留表头，渲染骨架行 */
+    loading?: boolean;
+    /** 骨架行数，默认 3 */
+    loadingRows?: number;
 }
 export declare const Table: Component<TableProps>;

package/dist/components/Toast/Toast.d.ts

@@ -8,6 +8,11 @@ export interface ToastItem {
     message: string;
     /** 此条目的自动消失时间（ms），覆盖 Toast 的默认 duration */
     duration?: number;
+    /** 操作按钮（如"撤销"）：点击不自动关闭，由回调自行移除 */
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
 }
 export interface ToastProps {
     toasts?: ToastItem[];
@@ -28,4 +33,11 @@ export interface ToastOptions {
     max?: number;
 }
 export declare const Toast: Component<ToastProps>;
-export declare function toast(opts?: ToastOptions): AppMiddleware;
+/** 命令式 ctx.toast 的注入类型（AppMiddleware<{}, ToastInjected>） */
+export interface ToastInjected {
+    toast: (message: string, type?: ToastType, duration?: number, action?: {
+        label: string;
+        onClick: () => void;
+    }) => void;
+}
+export declare function toast(opts?: ToastOptions): AppMiddleware<{}, ToastInjected>;

package/dist/components/index.d.ts

@@ -5,6 +5,8 @@
  *   import { Button, Input } from 'weifuwu/components'
  *   import 'weifuwu/components/style.css'
  */
+export { Icon } from './Icon/Icon.ts';
+export type { IconProps, IconName } from './Icon/Icon.ts';
 export { Button } from './Button/Button.ts';
 export type { ButtonProps } from './Button/Button.ts';
 export { Input } from './Input/Input.ts';