weifuwu 0.70.0 → 0.72.0

package/dist/dev/index.js

@@ -11,7 +11,7 @@ registerHooks({
       const result = transformSync(code, {
         loader: url.endsWith(".tsx") ? "tsx" : "ts",
         jsx: "automatic",
-        jsxImportSource: "weifuwu/client",
+        jsxImportSource: "weifuwu/ui-dom",
         format: "esm",
         sourcemap: "inline",
         target: "node22"

package/dist/index.js

@@ -4236,7 +4236,7 @@ var HtmlSafe = class {
   }
 };
 
-// src/client/vnode.ts
+// src/ui-dom/vnode.ts
 var ASYNC_MARK = "__wfAsyncComponent";
 function isAsyncComponent(type) {
   return typeof type === "function" && type?.[ASYNC_MARK] === true;
@@ -4244,7 +4244,7 @@ function isAsyncComponent(type) {
 var Fragment = /* @__PURE__ */ Symbol("Fragment");
 var Portal = /* @__PURE__ */ Symbol("Portal");
 
-// src/client/reactive.ts
+// src/ui-dom/reactive.ts
 function createReactiveState(dirty) {
   const proxyCache = /* @__PURE__ */ new WeakMap();
   const watchers = /* @__PURE__ */ new Set();
@@ -4690,7 +4690,7 @@ function ui() {
           format: "esm",
           platform: "browser",
           jsx: "automatic",
-          jsxImportSource: "weifuwu/client",
+          jsxImportSource: "weifuwu/ui-dom",
           write: false,
           metafile: true
         });
@@ -4745,7 +4745,7 @@ function ui() {
   };
 }
 
-// src/client/route-match.ts
+// src/ui-dom/route-match.ts
 function joinPaths(a, b) {
   if (!b || b === "/") return a || "/";
   const left = a.endsWith("/") ? a.slice(0, -1) : a;
@@ -4787,11 +4787,18 @@ function extractParams(path, match) {
   const m = path.match(match.re);
   if (m) {
     for (let i = 0; i < match.keys.length; i++) {
-      params[match.keys[i]] = decodeURIComponent(m[i + 1]);
+      params[match.keys[i]] = safeDecode(m[i + 1]);
     }
   }
   return params;
 }
+function safeDecode(s) {
+  try {
+    return decodeURIComponent(s);
+  } catch {
+    return s;
+  }
+}
 
 // src/ui/ssr-page.ts
 var DEFAULT_TEMPLATE = (p) => `<!DOCTYPE html>

package/dist/layout/weifuwu-layout.css

@@ -46,6 +46,7 @@
   --wf-dark-bg-hover: rgba(255, 255, 255, 0.06);      /* 暗色 hover 反白 */
   --wf-dark-surface-shadow: 0 1px 3px rgba(0, 0, 0, 0.3);
   --wf-dark-shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.2);
+  --wf-dark-shadow-inset: inset 0 1px 2px rgba(0, 0, 0, 0.3);
   --wf-dark-shadow: 0 1px 3px rgba(0, 0, 0, 0.3);
   --wf-dark-shadow-md: 0 4px 12px rgba(0, 0, 0, 0.4);
   --wf-dark-shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.4);
@@ -82,6 +83,7 @@
 
   /* ── 阴影 ── */
   --wf-shadow-sm: 0 1px 2px rgba(0,0,0,0.05);
+  --wf-shadow-inset: inset 0 1px 2px rgba(0,0,0,0.04);  /* 内阴影：凹槽/轨道深度（Switch/ThemeSwitch） */
   --wf-shadow: 0 1px 3px rgba(0,0,0,0.08);
   --wf-shadow-md: 0 4px 12px rgba(0,0,0,0.1);
   --wf-shadow-lg: 0 10px 15px -3px rgba(0,0,0,0.1);
@@ -222,6 +224,7 @@
 
   /* ── 浮层遮罩（Modal/Drawer overlay，暗色经 --wf-dark-overlay 映射） ── */
   --wf-overlay: rgba(0, 0, 0, 0.4);
+  --wf-overlay-blur: 4px;  /* 遮罩毛玻璃（弹层现代质感，不支持 backdrop-filter 的环境自动降级为纯色） */
 
   /* ── 表单控件 ── */
   --wf-accent-color: var(--wf-color-primary);
@@ -307,6 +310,7 @@
   --wf-shadow: var(--wf-dark-shadow);
   --wf-shadow-md: var(--wf-dark-shadow-md);
   --wf-shadow-lg: var(--wf-dark-shadow-lg);
+  --wf-shadow-inset: var(--wf-dark-shadow-inset);
 
   --wf-color-primary-text: var(--wf-dark-brand-500);
   --wf-color-success-text: var(--wf-dark-green-500);
@@ -357,6 +361,7 @@
     --wf-shadow: var(--wf-dark-shadow);
     --wf-shadow-md: var(--wf-dark-shadow-md);
     --wf-shadow-lg: var(--wf-dark-shadow-lg);
+    --wf-shadow-inset: var(--wf-dark-shadow-inset);
 
     --wf-color-primary-text: var(--wf-dark-brand-500);
     --wf-color-success-text: var(--wf-dark-green-500);
@@ -377,6 +382,36 @@
   box-sizing: border-box;
 }
 
+/* 选区色：primary 调（文字反白，与品牌一致） */
+::selection {
+  background: var(--wf-color-primary-bg);
+  color: var(--wf-color-primary-text);
+}
+
+/* 主题滚动条（全局——所有滚动区一致；Firefox thin + WebKit 样式） */
+* {
+  scrollbar-width: thin;
+  scrollbar-color: var(--wf-color-border-dark) transparent;
+}
+::-webkit-scrollbar {
+  width: 8px;
+  height: 8px;
+}
+::-webkit-scrollbar-track {
+  background: transparent;
+}
+::-webkit-scrollbar-thumb {
+  background: var(--wf-color-border-dark);
+  border-radius: var(--wf-radius-sm);
+  border: 2px solid transparent;
+  background-clip: padding-box;
+}
+::-webkit-scrollbar-thumb:hover {
+  background: var(--wf-color-text-secondary);
+  background-clip: padding-box;
+  border: 2px solid transparent;
+}
+
 :root {
   /* 原生控件/滚动条跟随主题；暗色激活时在 _dark.css 中切为 dark */
   color-scheme: light;
@@ -447,11 +482,20 @@ button {
   padding: var(--wf-control-pad-y) var(--wf-space-md);
   min-height: var(--wf-control-height);
   cursor: pointer;
+  transition: border-color var(--wf-dur-fast) var(--wf-ease-out),
+              color var(--wf-dur-fast) var(--wf-ease-out),
+              box-shadow var(--wf-dur-fast) var(--wf-ease-out),
+              background-color var(--wf-dur-fast) var(--wf-ease-out),
+              filter var(--wf-dur-fast) var(--wf-ease-out);
 }
 button:hover {
   border-color: var(--wf-color-primary);
   color: var(--wf-color-primary-text);
 }
+button:active:not(:disabled),
+[role="button"]:active {
+  filter: brightness(0.95); /* 按压反馈：不偏移布局，适用任意宽度（block/inline） */
+}
 
 /* 键盘焦点：button 与 [tabindex] 统一 focus ring（仅键盘触发，鼠标点击不闪） */
 button:focus-visible,
@@ -460,6 +504,15 @@ button:focus-visible,
   box-shadow: var(--wf-focus-ring);
 }
 
+[role="button"] {
+  cursor: pointer;
+  transition: background-color var(--wf-dur-fast) var(--wf-ease-out),
+              border-color var(--wf-dur-fast) var(--wf-ease-out),
+              box-shadow var(--wf-dur-fast) var(--wf-ease-out),
+              color var(--wf-dur-fast) var(--wf-ease-out),
+              filter var(--wf-dur-fast) var(--wf-ease-out);
+}
+
 /* 触屏设备（coarse pointer）：交互目标提升到 44px（Apple HIG / WCAG 2.5.8） */
 @media (pointer: coarse) {
   button,
@@ -571,10 +624,13 @@ body.wf-dragging {
 }
 
 @layer layout {
-/* stack — 纵向堆叠 */
+/* stack — 纵向堆叠（L3：gap 默认值 :where() 零优先级——wf-gap-* 等覆盖工具
+   靠优先级获胜，不再依赖 import 顺序） */
 .wf-stack {
   display: flex;
   flex-direction: column;
+}
+:where(.wf-stack) {
   gap: var(--wf-gap, var(--wf-gap-md));
 }
 @media (min-width: 640px) { .wf-stack\@sm { flex-direction: row; align-items: var(--wf-align, center); } }
@@ -585,6 +641,8 @@ body.wf-dragging {
 .wf-stack-reverse {
   display: flex;
   flex-direction: column-reverse;
+}
+:where(.wf-stack-reverse) {
   gap: var(--wf-gap, var(--wf-gap-md));
 }
 @media (min-width: 640px) { .wf-stack-reverse\@sm { flex-direction: row-reverse; align-items: var(--wf-align, center); } }
@@ -593,10 +651,13 @@ body.wf-dragging {
 }
 
 @layer layout {
-/* row — 横向排列 */
+/* row — 横向排列（L3：gap/align 默认值 :where() 零优先级——wf-gap-*、wf-top 等
+   覆盖工具靠优先级获胜，不再依赖 import 顺序） */
 .wf-row {
   display: flex;
   flex-wrap: wrap;
+}
+:where(.wf-row) {
   gap: var(--wf-gap, var(--wf-gap-md));
   align-items: var(--wf-align, center);
 }
@@ -609,6 +670,8 @@ body.wf-dragging {
   display: flex;
   flex-direction: row-reverse;
   flex-wrap: wrap;
+}
+:where(.wf-row-reverse) {
   gap: var(--wf-gap, var(--wf-gap-md));
   align-items: var(--wf-align, center);
 }
@@ -618,10 +681,12 @@ body.wf-dragging {
 }
 
 @layer layout {
-/* split — 两端展开 */
+/* split — 两端展开（L3：align/gap 默认值 :where() 零优先级） */
 .wf-split {
   display: flex;
   justify-content: space-between;
+}
+:where(.wf-split) {
   align-items: var(--wf-align, center);
   gap: var(--wf-gap, var(--wf-gap-md));
 }
@@ -641,10 +706,12 @@ body.wf-dragging {
 }
 
 @layer layout {
-/* between — 两端对齐（行内垂直居中） */
+/* between — 两端对齐（行内垂直居中；L3：align/gap 默认值 :where() 零优先级） */
 .wf-between {
   display: flex;
   justify-content: space-between;
+}
+:where(.wf-between) {
   align-items: var(--wf-align, center);
   gap: var(--wf-gap, var(--wf-gap-md));
 }
@@ -654,57 +721,69 @@ body.wf-dragging {
 }
 
 @layer layout {
-/* right — 靠右对齐 */
+/* right — 靠右对齐（L3：align/gap 默认值 :where() 零优先级） */
 .wf-right {
   display: flex;
   justify-content: flex-end;
+}
+:where(.wf-right) {
   align-items: var(--wf-align, center);
   gap: var(--wf-gap, var(--wf-gap-md));
 }
 }
 
 @layer layout {
-/* top — 顶部对齐 */
+/* top — 顶部对齐（L3：gap 默认值 :where() 零优先级；align-items 是身份属性） */
 .wf-top {
   display: flex;
   align-items: flex-start;
+}
+:where(.wf-top) {
   gap: var(--wf-gap, var(--wf-gap-md));
 }
 }
 
 @layer layout {
-/* bottom — 底部对齐 */
+/* bottom — 底部对齐（L3：gap 默认值 :where() 零优先级；align-items 是身份属性） */
 .wf-bottom {
   display: flex;
   align-items: flex-end;
+}
+:where(.wf-bottom) {
   gap: var(--wf-gap, var(--wf-gap-md));
 }
 }
 
 @layer layout {
-/* stretch — 拉伸对齐 */
+/* stretch — 拉伸对齐（L3：gap 默认值 :where() 零优先级；align-items 是身份属性） */
 .wf-stretch {
   display: flex;
   align-items: stretch;
+}
+:where(.wf-stretch) {
   gap: var(--wf-gap, var(--wf-gap-md));
 }
 }
 
 @layer layout {
-/* around — 均匀环绕分布 */
+/* around — 均匀环绕分布（L3：align/gap 默认值 :where() 零优先级） */
 .wf-around {
   display: flex;
   justify-content: space-around;
+}
+:where(.wf-around) {
   align-items: var(--wf-align, center);
   gap: var(--wf-gap, var(--wf-gap-md));
 }
 }
 
 @layer layout {
-/* evenly — 均匀分布 */
+/* evenly — 均匀分布（L3：align/gap 默认值 :where() 零优先级） */
 .wf-evenly {
   display: flex;
   justify-content: space-evenly;
+}
+:where(.wf-evenly) {
   align-items: var(--wf-align, center);
   gap: var(--wf-gap, var(--wf-gap-md));
 }
@@ -720,7 +799,9 @@ body.wf-dragging {
 }
 
 @layer layout {
-/* fixed — 固定不伸缩 */
+/* flex-none — 固定不伸缩（推荐名；wf-fixed 为兼容别名——易与 position:fixed 混淆，
+   position:fixed 请用 wf-pin） */
+.wf-flex-none,
 .wf-fixed {
   flex: none;
 }
@@ -881,19 +962,24 @@ body.wf-dragging {
 }
 
 @layer layout {
-/* grid — 二维网格 */
+/* grid — 二维网格（L3：gap 默认值 :where() 零优先级） */
 .wf-grid {
   display: grid;
   grid-template-columns: var(--wf-cols, repeat(auto-fill, minmax(280px, 1fr)));
+}
+:where(.wf-grid) {
   gap: var(--wf-gap, var(--wf-gap-lg));
 }
 }
 
 @layer layout {
-/* cluster — 换行簇 */
+/* cluster — 换行簇（L3：justify/align/gap 默认值 :where() 零优先级——
+   wf-right 等分布工具叠加时靠优先级获胜） */
 .wf-cluster {
   display: flex;
   flex-wrap: wrap;
+}
+:where(.wf-cluster) {
   gap: var(--wf-gap, var(--wf-gap-sm));
   justify-content: var(--wf-justify, center);
   align-items: var(--wf-align, center);
@@ -901,7 +987,7 @@ body.wf-dragging {
 }
 
 @layer layout {
-/* scroll — 可滚动容器 */
+/* scroll — 可滚动容器（全局滚动条样式见 _base.css；此类仅标记语义 + overflow） */
 .wf-scroll {
   overflow: auto;
 }
@@ -963,6 +1049,19 @@ body.wf-dragging {
 }
 }
 
+@layer utilities {
+/* flex — 弹性盒 display 工具（补全 display 族：block/inline/inline-block/contents/hidden/flex）
+ * 核心场景：响应式显隐的 flex 容器——`wf-hidden wf-flex@lg`（窄隐宽显且保持 flex 布局）。
+ * 不可用 wf-block@lg 替代：block 会覆盖 wf-stack 的 display:flex，
+ * 致 flex-direction/gap/mt-auto 全部静默失效（layouts-demo 侧栏 mt-auto 实测踩坑）。 */
+.wf-flex {
+  display: flex;
+}
+@media (min-width: 640px) { .wf-flex\@sm { display: flex; } }
+@media (min-width: 768px) { .wf-flex\@md { display: flex; } }
+@media (min-width: 1024px) { .wf-flex\@lg { display: flex; } }
+}
+
 @layer layout {
 /* container — 内容宽度约束居中 */
 /* width: 100% 必须：margin: 0 auto 在 flex 父中阻止 stretch（宽度=内容）
@@ -992,10 +1091,13 @@ body.wf-dragging {
 
 @layer layout {
 /* nowrap — 不换行（只管 flex-wrap——不定义 align-items，避免与
-   wf-stretch 等对齐工具叠加冲突：双份 CSS 下 nowrap 后置曾覆盖 stretch） */
+   wf-stretch 等对齐工具叠加冲突：双份 CSS 下 nowrap 后置曾覆盖 stretch；
+   L3：gap 默认值 :where() 零优先级） */
 .wf-nowrap {
   display: flex;
   flex-wrap: nowrap;
+}
+:where(.wf-nowrap) {
   gap: var(--wf-gap, var(--wf-gap-md));
 }
 }
@@ -1038,6 +1140,20 @@ body.wf-dragging {
 .wf-py-xl { padding-top: var(--wf-space-xl); padding-bottom: var(--wf-space-xl); }
 .wf-py-2xl { padding-top: var(--wf-space-2xl); padding-bottom: var(--wf-space-2xl); }
 
+/* ── padding: 单侧顶/底（幽灵类防线抓出 wf-pt-md/wf-pb-md 误用——补全家族） ── */
+.wf-pt-xs { padding-top: var(--wf-space-xs); }
+.wf-pt-sm { padding-top: var(--wf-space-sm); }
+.wf-pt-md { padding-top: var(--wf-space-md); }
+.wf-pt-lg { padding-top: var(--wf-space-lg); }
+.wf-pt-xl { padding-top: var(--wf-space-xl); }
+.wf-pt-2xl { padding-top: var(--wf-space-2xl); }
+.wf-pb-xs { padding-bottom: var(--wf-space-xs); }
+.wf-pb-sm { padding-bottom: var(--wf-space-sm); }
+.wf-pb-md { padding-bottom: var(--wf-space-md); }
+.wf-pb-lg { padding-bottom: var(--wf-space-lg); }
+.wf-pb-xl { padding-bottom: var(--wf-space-xl); }
+.wf-pb-2xl { padding-bottom: var(--wf-space-2xl); }
+
 /* ── margin：重置 ── */
 .wf-m-0 { margin: 0; }
 .wf-p-0 { padding: 0; }
@@ -1067,6 +1183,8 @@ body.wf-dragging {
 /* ── margin: auto（居中） ── */
 .wf-mx-auto { margin-left: auto; margin-right: auto; }
 .wf-my-auto { margin-top: auto; margin-bottom: auto; }
+.wf-mt-auto { margin-top: auto; }  /* flex 列推底（侧栏 footer——曾写不存在类静默失效） */
+.wf-mb-auto { margin-bottom: auto; }
 
 /* ── gap：直接设置 gap 属性（不设 --wf-gap 变量——变量会继承污染子孙：
    壳 root wf-gap-none 曾让 KPI grid 的 gap: var(--wf-gap) = 0 卡无间距） ── */

package/dist/ui/index.d.ts

@@ -26,7 +26,7 @@
  * ```
  */
 import type { Middleware } from '../types.ts';
-import type { Component, AsyncComponent } from '../client/vnode.ts';
+import type { Component, AsyncComponent } from '../ui-dom/vnode.ts';
 declare module '../types.ts' {
     interface Context {
         ui: {

package/dist/ui/ssr-page.d.ts

@@ -8,7 +8,7 @@
  * 与客户端 router() 共用同一份路由定义（route-match.ts），SPA/SSR 一个声明。
  */
 import type { Middleware } from '../types.ts';
-import type { RouteDef } from '../client/types.ts';
+import type { RouteDef } from '../ui-dom/types.ts';
 export interface UiSsrOptions {
     /** 前端路由定义（与 router() 共享同一份） */
     routes: RouteDef[];

package/dist/ui/ssr.d.ts

@@ -11,7 +11,7 @@
  *
  * 产物为 HtmlSafe 标记的安全 HTML 片段，可直接内联进 ctx.ui.html 模板。
  */
-import type { Component, AsyncComponent } from '../client/vnode.ts';
+import type { Component, AsyncComponent } from '../ui-dom/vnode.ts';
 import { HtmlSafe } from './html-safe.ts';
 export { HtmlSafe } from './html-safe.ts';
 export interface SsrOptions {

package/dist/ui-dom/Confirm.d.ts

@@ -0,0 +1,44 @@
+/**
+ * weifuwu/components — Confirm 确认对话框
+ *
+ * 声明式：基于 Modal 封装，footer 自带「取消 / 确定」按钮。
+ * 命令式：confirm() 中间件注入 ctx.confirm()，返回 Promise<boolean>。
+ */
+import type { Component } from './vnode.ts';
+import type { AppMiddleware } from './types.ts';
+export interface ConfirmProps {
+    open?: boolean;
+    title?: string;
+    /** 提示内容（文本或任意 VNode） */
+    message?: any;
+    confirmText?: string;
+    cancelText?: string;
+    variant?: 'primary' | 'danger';
+    /** 对话框宽度，如 '500px'、'80%'，默认 Modal 的 400px */
+    width?: string;
+    /** 遮罩点击是否取消（默认 false：危险操作防误触；显式传 true 可恢复） */
+    maskClosable?: boolean;
+    onConfirm?: () => void;
+    onCancel?: () => void;
+}
+/** 命令式 ctx.confirm 的选项（ConfirmProps 的子集） */
+export interface ConfirmOptions {
+    title?: string;
+    confirmText?: string;
+    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()
+ *
+ * 每次调用挂载 Confirm 组件到独立容器（mountVNode），
+ * resolve 后 callRefCleanup 清理（含 Modal 的 portal DOM）+ 移除容器。
+ */
+export declare function confirm(): AppMiddleware<{}, ConfirmInjected>;
+export declare const Confirm: Component<ConfirmProps>;

package/dist/ui-dom/Notification.d.ts

@@ -0,0 +1,70 @@
+import type { Component } from './vnode.ts';
+import type { AppMiddleware } from './types.ts';
+export type NotificationType = 'success' | 'error' | 'info' | 'warning';
+export type NotificationPosition = 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left';
+export interface NotificationItem {
+    id: string;
+    type: NotificationType;
+    title: string;
+    description?: string;
+    /** 自动关闭时间（ms），0 = 不自动关闭，默认 4500 */
+    duration?: number;
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+}
+export interface NotificationProps {
+    items?: NotificationItem[];
+    onRemove?: (id: string) => void;
+    position?: NotificationPosition;
+    /** 全局默认自动关闭时间（ms），默认 4500 */
+    duration?: number;
+    /** 最大显示条数，超出移除最早，默认 0 = 不限制 */
+    max?: number;
+}
+export interface NotificationOptions {
+    position?: NotificationPosition;
+    duration?: number;
+    max?: number;
+}
+/** 通知（对应 antd/EP Notification 队列式）：title + description + icon + 操作，聚合角落 */
+export declare const Notification: Component<NotificationProps>;
+export interface NotificationInjected {
+    notification: {
+        (title: string, opts?: {
+            type?: NotificationType;
+            description?: string;
+            duration?: number;
+            action?: NotificationItem['action'];
+        }): void;
+        open: (opts: {
+            type?: NotificationType;
+            title: string;
+            description?: string;
+            duration?: number;
+            action?: NotificationItem['action'];
+        }) => void;
+        success: (opts: {
+            title: string;
+            description?: string;
+            duration?: number;
+        }) => void;
+        error: (opts: {
+            title: string;
+            description?: string;
+            duration?: number;
+        }) => void;
+        info: (opts: {
+            title: string;
+            description?: string;
+            duration?: number;
+        }) => void;
+        warning: (opts: {
+            title: string;
+            description?: string;
+            duration?: number;
+        }) => void;
+    };
+}
+export declare function notification(opts?: NotificationOptions): AppMiddleware<{}, NotificationInjected>;

package/dist/ui-dom/Toast.d.ts

@@ -0,0 +1,43 @@
+import type { Component } from './vnode.ts';
+import type { AppMiddleware } from './types.ts';
+export type ToastType = 'success' | 'error' | 'info' | 'warning';
+export type ToastPosition = 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left' | 'top-center';
+export interface ToastItem {
+    id: string;
+    type: ToastType;
+    message: string;
+    /** 此条目的自动消失时间（ms），覆盖 Toast 的默认 duration */
+    duration?: number;
+    /** 操作按钮（如"撤销"）：点击不自动关闭，由回调自行移除 */
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+}
+export interface ToastProps {
+    toasts?: ToastItem[];
+    onRemove?: (id: string) => void;
+    /** 容器位置，默认 top-right */
+    position?: ToastPosition;
+    /** 全局默认自动消失时间（ms），0 = 不自动消失，默认 0 */
+    duration?: number;
+    /** 最大显示条数，超出时移除最早条目，默认 0 = 不限制 */
+    max?: number;
+}
+/** 命令式 ctx.toast 的全局配置 */
+export interface ToastOptions {
+    position?: ToastPosition;
+    /** 默认自动消失时间（ms），0 = 不消失，默认 3000 */
+    duration?: number;
+    /** 最大显示条数，超出移除最早，默认 3 */
+    max?: number;
+}
+export declare const Toast: Component<ToastProps>;
+/** 命令式 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/{client → ui-dom}/diff.d.ts

@@ -6,11 +6,12 @@
  *   diff.ts → registry.ts（callRefCleanup）
  *   render.ts 不依赖 diff.ts（单向，无环）
  */
+import type { VNodeChild } from './vnode.ts';
 import type { WfuiContext } from './types.ts';
-export declare function patchValue(parent: Node, oldNode: Node | null, oldInput: any, newInput: any, ctx: WfuiContext): Node | null;
-export declare function patchProps(el: Element, oldProps: any, newProps: any): void;
+export declare function patchValue(parent: Node, oldNode: Node | null, oldInput: VNodeChild, newInput: VNodeChild, ctx: WfuiContext): Node | null;
+export declare function patchProps(el: Element, oldProps: Record<string, unknown> | null, newProps: Record<string, unknown>): void;
 /** 为无 key 的子节点自动分配位置 key，确保 keyed diff 正确性 */
-export declare function ensureKeys(oldChildren: any[], newChildren: any[]): void;
+export declare function ensureKeys(oldChildren: VNodeChild[], newChildren: VNodeChild[]): void;
 /**
  * 将 children 映射到它们实际产生的 DOM 节点（每个 child 一个 Node[]）。
  *
@@ -18,10 +19,10 @@ export declare function ensureKeys(oldChildren: any[], newChildren: any[]): void
  * null/boolean/Portal 产生 0 个。explicitNodes 提供限定范围（Fragment 子项
  * 用其自身 _childNodes），否则从 source（parent.childNodes 或给定快照）按计数游标分配。
  */
-export declare function mapChildDomNodes(source: Node[], children: any[]): (Node[] | null)[];
-export declare function normalize(children: any): any[];
+export declare function mapChildDomNodes(source: Node[], children: VNodeChild[]): (Node[] | null)[];
+export declare function normalize(children: VNodeChild): VNodeChild[];
 /**
  * keyed 子节点 diff。返回每个 new child 的 DOM 节点范围（newNodes，可为空）。
  * oldNodes：old children → 实际 DOM 节点（mapChildDomNodes 结果）。
  */
-export declare function patchKeyedChildren(parent: Node, oldChildren: any[], newChildren: any[], ctx: WfuiContext, oldNodes?: (Node[] | null)[], rangeStart?: Node | null): (Node[] | null)[];
+export declare function patchKeyedChildren(parent: Node, oldChildren: VNodeChild[], newChildren: VNodeChild[], ctx: WfuiContext, oldNodes?: (Node[] | null)[], rangeStart?: Node | null): (Node[] | null)[];