weifuwu 0.74.0 → 0.76.0

package/dist/index.d.ts

@@ -31,8 +31,6 @@ export type { Ai, ApprovalRequest } from './ai/contracts.ts';
 export type { AiOptions, AiInjected, AiClient, AiClientModule, ChatResponse, AgentConfig, AgentTool, AgentRunner, ToolContext, AgentRunResult, AgentStep, WfEmitter, } from './ai/index.ts';
 export type { WfStreamEvent, WfMessageStart, WfToken, WfUsage, WfDone, WfError, WfErrorCode, WfToolCall, WfToolResult, WfToolProgress, WfStep, WfApprovalRequest, WfApprovalResponse, WfApprovalDecision, ChatMessage, ChatParams, MessageRole, ToolCall, ToolDefinition, } from './ai/types.ts';
 export { ui } from './ui/index.ts';
-export { uiSsr } from './ui/ssr-page.ts';
-export type { UiSsrOptions } from './ui/ssr-page.ts';
 export type { GraphQLOptions, GraphQLHandler } from './graphql.ts';
 export { postgres, MIGRATIONS_TABLE } from './postgres/index.ts';
 export type { PostgresOptions, PostgresClient, PostgresInjected } from './postgres/types.ts';

package/dist/index.js

@@ -3540,7 +3540,7 @@ function createAgent(client, config) {
       if (signal?.aborted) return;
       if (!finish.toolCalls?.length) {
         emit("wf:usage", usage);
-        emit("wf:done", { content: finish.content, usage });
+        emit("wf:done", { content: finish.content, usage, reasoning: finish.reasoning_content });
         return;
       }
       all.push({
@@ -3638,318 +3638,27 @@ var HtmlSafe = class {
 };
 
 // src/ui-dom/vnode.ts
-var ASYNC_MARK = "__wfAsyncComponent";
-function isAsyncComponent(type) {
-  return typeof type === "function" && type?.[ASYNC_MARK] === true;
-}
 var Fragment = /* @__PURE__ */ Symbol("Fragment");
 var Portal = /* @__PURE__ */ Symbol("Portal");
 
-// src/ui-dom/debug.ts
-var _enabled = null;
-function uiDebugEnabled() {
-  if (_enabled !== null) return _enabled;
-  _enabled = typeof process !== "undefined" && process.env?.UI_DEBUG === "1" || globalThis.__UI_DEBUG === true || typeof localStorage !== "undefined" && localStorage.getItem("__UI_DEBUG") === "1";
-  return _enabled;
-}
-var _depth = 0;
-var counters = /* @__PURE__ */ new Map();
-function uiLog(label, msg, opts) {
-  if (!uiDebugEnabled()) return;
-  const n = (counters.get(label) ?? 0) + 1;
-  counters.set(label, n);
-  const first = 10;
-  const every = opts?.throttle ?? 100;
-  if (n > first && n % every !== 0) return;
-  const d = opts?.depth !== void 0 ? opts.depth : _depth;
-  const indent = "  ".repeat(Math.min(d, 30));
-  console.log(`[ui-debug] ${indent}${label}#${n} ${msg}`);
-}
-
-// src/ui-dom/reactive.ts
-function createReactiveState(dirty) {
-  const _debugSets = /* @__PURE__ */ new Map();
-  const _dbg = (key, label) => {
-    const n = (_debugSets.get(key) ?? 0) + 1;
-    _debugSets.set(key, n);
-    if (n <= 5 || n % 100 === 0) uiLog(label, key + " count=" + n, { throttle: 100 });
-  };
-  const proxyCache = /* @__PURE__ */ new WeakMap();
-  const watchers = /* @__PURE__ */ new Set();
-  const reactive = (target) => {
-    if (target === null || typeof target !== "object") return target;
-    if (target instanceof Set || target instanceof Map) {
-      if (proxyCache.has(target)) return proxyCache.get(target);
-      const MUTATING = target instanceof Set ? /* @__PURE__ */ new Set(["add", "delete", "clear"]) : /* @__PURE__ */ new Set(["set", "delete", "clear"]);
-      const proxy2 = new Proxy(target, {
-        get(t, prop) {
-          const v = Reflect.get(t, prop);
-          if (typeof v === "function") {
-            if (!MUTATING.has(String(prop))) return v.bind(t);
-            return (...args) => {
-              const result = v.apply(t, args);
-              dirty();
-              for (const w of watchers) w();
-              return result;
-            };
-          }
-          return v;
-        },
-        set(t, key, value) {
-          Reflect.set(t, key, value);
-          _dbg(String(key), "set");
-          dirty();
-          for (const w of watchers) w();
-          return true;
-        }
-      });
-      proxyCache.set(target, proxy2);
-      return proxy2;
-    }
-    if (target instanceof Date || target instanceof RegExp) return target;
-    if (proxyCache.has(target)) return proxyCache.get(target);
-    const proxy = new Proxy(target, {
-      set(target2, key, value) {
-        const old = Reflect.get(target2, key);
-        if (old === value) return true;
-        Reflect.set(target2, key, value);
-        dirty();
-        for (const w of watchers) w();
-        return true;
-      },
-      get(target2, key) {
-        const value = Reflect.get(target2, key);
-        if (typeof value === "object" && value !== null) return reactive(value);
-        return value;
-      },
-      deleteProperty(target2, key) {
-        if (Reflect.has(target2, key)) {
-          Reflect.deleteProperty(target2, key);
-          dirty();
-          for (const w of watchers) w();
-        }
-        return true;
-      }
-    });
-    proxyCache.set(target, proxy);
-    return proxy;
-  };
-  const root = reactive({});
-  Object.defineProperty(root, "__watch", {
-    value: (cb) => {
-      watchers.add(cb);
-      return () => {
-        watchers.delete(cb);
-      };
-    },
-    writable: false,
-    enumerable: false
-  });
-  return root;
-}
-
-// src/ui/ssr.ts
+// src/ui-dom/vdom/ssr.ts
+var VOID_TAGS = /* @__PURE__ */ new Set(["area", "base", "br", "col", "embed", "hr", "img", "input", "link", "meta", "param", "source", "track", "wbr"]);
+var SVG_TAGS = /* @__PURE__ */ new Set(["svg", "path", "circle", "rect", "line", "polyline", "polygon", "g", "text", "defs", "use", "clipPath"]);
 function escape(s) {
   return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
-var VOID_TAGS = /* @__PURE__ */ new Set([
-  "area",
-  "base",
-  "br",
-  "col",
-  "embed",
-  "hr",
-  "img",
-  "input",
-  "link",
-  "meta",
-  "param",
-  "source",
-  "track",
-  "wbr"
-]);
 function classToString(v) {
   if (typeof v === "string") return v;
   if (Array.isArray(v)) return v.filter(Boolean).join(" ");
-  if (v && typeof v === "object") {
-    return Object.entries(v).filter(([, b]) => b).map(([k]) => k).join(" ");
-  }
+  if (v && typeof v === "object") return Object.entries(v).filter(([, on]) => on).map(([k]) => k).join(" ");
   return "";
 }
 function styleToString(v) {
-  if (typeof v === "string") return v;
-  if (v && typeof v === "object") {
-    return Object.entries(v).filter(([, x]) => x != null).map(([k, x]) => `${k}:${typeof x === "number" ? x + "px" : String(x)}`).join(";");
-  }
-  return "";
-}
-function createSsrContext(serverCtx, dataStore) {
-  const usedIds = /* @__PURE__ */ new Set();
-  const ui2 = {
-    $: () => createReactiveState(() => {
-    }),
-    dirty: () => {
-    },
-    render: () => {
-    },
-    selfId: (name) => {
-      if (usedIds.has(name)) throw new Error(`[weifuwu] Duplicate component ID: "${name}"`);
-      usedIds.add(name);
-    },
-    useMedia: () => {
-    },
-    useBreakpoint: () => {
-    },
-    usePopupPosition: () => ({ top: 0, left: 0, refresh: () => {
-    } }),
-    // 新原语族：SSR 确定性 no-op（不启动监听/会话/取数；组件挂载不崩即契约）
-    useHoverCapable: () => false,
-    useVisualViewport: () => ({ height: 0, offsetTop: 0, keyboardOpen: false }),
-    useLongPress: () => ({}),
-    useInView: () => ({ isIn: false, ready: false, observe: () => {
-    }, refresh: () => {
-    }, disconnect: () => {
-    } }),
-    useScrollPosition: () => ({ y: 0, refresh: () => {
-    } }),
-    useStableRef: (init) => (el) => {
-      if (el) init?.(el);
-    },
-    useGlobalKey: () => () => {
-    },
-    useReducedMotion: () => false,
-    useAnimationEnd: () => () => {
-    },
-    useTween: (target) => {
-      const handle = { value: target, reset: (to) => {
-        handle.value = to;
-      } };
-      return handle;
-    },
-    useDrag: () => ({ onPointerDown: () => {
-    } }),
-    useDragDrop: () => ({ dropProps: {}, dragProps: {} }),
-    useControlled: (options) => ({
-      value: options.value,
-      setValue: (v) => {
-        options.onChange?.(v);
-      },
-      controlled: options.value !== void 0
-    }),
-    useControlledInput: (options) => ({
-      value: options.value,
-      setValue: (v) => {
-        options.onChange?.(v);
-      },
-      controlled: options.value !== void 0,
-      keyword: "",
-      setKeyword: () => {
-      },
-      selectedLabel: "",
-      setSelectedLabel: () => {
-      }
-    }),
-    useOpen: (options) => ({
-      get open() {
-        return !!options.open;
-      },
-      setOpen: (v) => {
-        options.onOpenChange?.(v);
-      },
-      triggerProps: {}
-    }),
-    useAsync: () => ({ data: void 0, loading: true, error: void 0, reload: () => {
-    } }),
-    usePopup: () => ({
-      open: false,
-      setOpen: () => {
-      },
-      wrapProps: {},
-      portal: () => null,
-      refresh: () => {
-      }
-    }),
-    usePresence: () => ({
-      phase: "closed",
-      ref: () => {
-      },
-      sync: (open2) => open2 ? "open" : "closed"
-    }),
-    useDialog: () => ({
-      phase: "closed",
-      rootRef: () => {
-      },
-      panelRef: () => {
-      },
-      sync: (open2) => open2 ? "open" : "closed"
-    }),
-    // SSR 确定性空态：会话不启动（无事件/无网络），仅保证挂载不崩
-    useChat: () => ({
-      messages: [],
-      input: "",
-      streaming: false,
-      error: null,
-      usage: null,
-      step: null,
-      send: () => {
-      },
-      stop: () => {
-      },
-      retry: () => {
-      },
-      clear: () => {
-      },
-      approve: async () => {
-      },
-      dispose: () => {
-      }
-    })
-  };
-  const browser = {
-    activeElement: () => null,
-    byId: () => null,
-    query: () => null,
-    createElement: () => null,
-    bodyAppend: () => {
-    },
-    bodyRemove: () => {
-    },
-    copyText: async () => false,
-    execCommand: () => false,
-    selectionText: () => null,
-    getSelection: () => null,
-    queryCommandState: () => false,
-    queryCommandValue: () => "",
-    viewportHeight: () => 0,
-    scrollTop: () => 0,
-    hash: () => "",
-    setHash: () => {
-    },
-    timeout: () => 0,
-    rootElement: () => null,
-    storageGet: () => null,
-    storageSet: () => {
-    }
-  };
-  const ctx = Object.create(serverCtx ?? {});
-  ctx.ui = ui2;
-  ctx.browser = browser;
-  ctx.data = {
-    async get(key, fetcher) {
-      if (dataStore.has(key)) return dataStore.get(key);
-      if (!fetcher) return void 0;
-      const val = await fetcher();
-      dataStore.set(key, val);
-      return val;
-    },
-    set(key, val) {
-      dataStore.set(key, val);
-    },
-    has(key) {
-      return dataStore.has(key);
-    }
-  };
-  return ctx;
+  return Object.entries(v).filter(([, val]) => val != null).map(([k, val]) => {
+    const key = k.replace(/[A-Z]/g, (m) => "-" + m.toLowerCase());
+    const value = typeof val === "number" && val !== 0 ? `${val}px` : String(val);
+    return `${key}:${value}`;
+  }).join(";");
 }
 async function renderSsr(input, ctx) {
   if (input == null || typeof input === "boolean") return "";
@@ -3960,37 +3669,13 @@ async function renderSsr(input, ctx) {
     return s;
   }
   const vnode = input;
-  if (vnode.type === Portal) return renderSsr(vnode.props?.children, ctx);
-  if (vnode.type === Fragment) return renderSsr(vnode.props?.children, ctx);
+  if (vnode.type === Portal || vnode.type === Fragment) return renderSsr(vnode.props?.children, ctx);
   if (typeof vnode.type === "function") {
-    const Comp = vnode.type;
-    if (isAsyncComponent(vnode.type)) {
-      const def = await vnode.type({}, ctx);
-      if (typeof def !== "function") {
-        throw new Error(
-          `asyncComponent factory <${vnode.type.name || "anonymous"}> must return a Component (initProps, ctx) => (props) => VNode.`
-        );
-      }
-      const childCtx2 = Object.create(ctx);
-      const renderFn2 = def(vnode.props ?? {}, childCtx2);
-      if (typeof renderFn2 !== "function") {
-        throw new Error(
-          `Component ${Comp.name || "anonymous"} must return a render function. Use (init_props, ctx) => (props) => VNode pattern.`
-        );
-      }
-      return renderSsr(renderFn2(vnode.props ?? {}), childCtx2);
-    }
     const childCtx = Object.create(ctx);
-    let renderFn;
-    try {
-      renderFn = Comp(vnode.props ?? {}, childCtx);
-    } catch (e) {
-      throw e;
-    }
-    if (renderFn instanceof Promise) renderFn = await renderFn;
+    const renderFn = await vnode.type(vnode.props ?? {}, childCtx);
     if (typeof renderFn !== "function") {
       throw new Error(
-        `Component ${Comp.name || "anonymous"} must return a render function. Use (init_props, ctx) => (props) => VNode pattern.`
+        `Component ${vnode.type.name || "anonymous"} must return a render function. Use (init_props, ctx) => (props) => VNode pattern.`
       );
     }
     return renderSsr(renderFn(vnode.props ?? {}), childCtx);
@@ -4016,6 +3701,10 @@ async function renderSsr(input, ctx) {
       attrs.push(` style="${escape(styleToString(value))}"`);
       continue;
     }
+    if (key === "draggable" || key === "contenteditable" || key === "spellcheck") {
+      attrs.push(` ${key}="${value ? "true" : "false"}"`);
+      continue;
+    }
     if (value === true) {
       attrs.push(` ${key}`);
       continue;
@@ -4024,21 +3713,140 @@ async function renderSsr(input, ctx) {
     attrs.push(` ${key}="${escape(String(value))}"`);
   }
   const attrStr = attrs.join("");
+  const svgWrap = SVG_TAGS.has(tag);
   if (VOID_TAGS.has(tag)) return `<${tag}${attrStr}>`;
   if (innerHTML !== void 0) return `<${tag}${attrStr}>${innerHTML}</${tag}>`;
   const children = await renderSsr(props.children, ctx);
+  if (svgWrap) return `<${tag}${attrStr}>${children}</${tag}>`;
   return `<${tag}${attrStr}>${children}</${tag}>`;
 }
-async function ssrToString(Comp, props, serverCtx, opts = {}) {
-  const dataStore = opts.data ?? /* @__PURE__ */ new Map();
-  const ctx = createSsrContext(serverCtx, dataStore);
-  const html = await renderSsr({ type: Comp, props: props ?? {}, key: void 0 }, ctx);
-  return new HtmlSafe(html);
+function createSsrUi() {
+  const noop = () => () => {
+  };
+  const noopReturn = () => ({});
+  return {
+    _selfId: "_wf_root",
+    render: () => {
+    },
+    dirty: () => {
+    },
+    $: () => ({}),
+    selfId: () => {
+    },
+    bumpCtxVersion: () => {
+    },
+    setMounting: () => {
+    },
+    endMounting: () => {
+    },
+    // hooks no-op（组件 SSR 安全——不注册监听/定时器）
+    useChat: () => ({ messages: [], input: "", streaming: false, error: null, usage: null, step: null, send: () => {
+    }, stop: () => {
+    }, retry: () => {
+    }, clear: () => {
+    }, approve: () => {
+    }, subscribe: () => () => {
+    } }),
+    useExternal: (store) => store,
+    useMedia: noop,
+    useBreakpoint: noop,
+    usePopupPosition: () => ({ top: 0, left: 0, refresh: () => {
+    } }),
+    useHoverCapable: () => false,
+    useStableRef: (init) => (el) => {
+      if (el) init?.(el);
+    },
+    useVisualViewport: () => ({ height: 0, offsetTop: 0, keyboardOpen: false }),
+    usePopup: () => ({ open: false, setOpen: () => {
+    }, wrapProps: {}, portal: () => null, refresh: () => {
+    } }),
+    useLongPress: noopReturn,
+    useInView: () => ({ isIn: false, ready: false, observe: () => {
+    }, refresh: () => {
+    }, disconnect: () => {
+    } }),
+    useScrollPosition: () => ({ y: 0, refresh: () => {
+    } }),
+    useAsync: () => ({ data: void 0, loading: true, error: void 0, reload: () => {
+    } }),
+    useControlled: () => ({ value: void 0, setValue: () => {
+    }, controlled: false }),
+    useControlledInput: () => ({ value: void 0, setValue: () => {
+    }, keyword: "", setKeyword: () => {
+    }, selectedLabel: "", setSelectedLabel: () => {
+    }, controlled: false }),
+    useOpen: () => ({ open: false, setOpen: () => {
+    }, triggerProps: {} }),
+    usePresence: () => ({ phase: "closed", ref: () => {
+    }, sync: () => "closed" }),
+    useDialog: () => ({ phase: "closed", rootRef: () => {
+    }, panelRef: () => {
+    }, sync: (open2) => open2 ? "open" : "closed" }),
+    useGlobalKey: () => () => {
+    },
+    useDrag: noopReturn,
+    useDragDrop: () => ({ dropProps: {}, dragProps: {} }),
+    useReducedMotion: () => true,
+    // SSR 无动画——组件直落终值
+    useAnimationEnd: () => () => {
+    },
+    useTween: (t) => {
+      let v = t;
+      return {
+        get value() {
+          return v;
+        },
+        set value(n) {
+          v = n;
+        },
+        reset: (n) => {
+          if (n !== void 0) v = n;
+          return v;
+        }
+      };
+    }
+  };
+}
+function createSsrContext(serverCtx, dataStore) {
+  const ctx = {
+    ...serverCtx,
+    ui: createSsrUi(),
+    browser: void 0
+  };
+  const dataCache = /* @__PURE__ */ new Map();
+  ctx.data = {
+    async get(key, fetcher) {
+      const entry = dataCache.get(key);
+      if (entry && "value" in entry) return entry.value;
+      if (entry?.promise) return entry.promise;
+      if (!fetcher) return void 0;
+      const promise = Promise.resolve().then(() => fetcher()).then((val) => {
+        dataCache.set(key, { value: val });
+        dataStore.set(key, val);
+        return val;
+      });
+      dataCache.set(key, { promise });
+      return promise;
+    },
+    set(key, value) {
+      dataCache.set(key, { value });
+      dataStore.set(key, value);
+    },
+    has(key) {
+      return dataCache.has(key);
+    }
+  };
+  return ctx;
 }
 function serializeData(data) {
   const json = JSON.stringify(Object.fromEntries(data)).replace(/</g, "\\u003c");
   return `<script>window.__DATA__=${json};</script>`;
 }
+async function ssrToString(Comp, props, serverCtx, opts = {}) {
+  const dataStore = opts.data ?? /* @__PURE__ */ new Map();
+  const ctx = createSsrContext(serverCtx, dataStore);
+  return renderSsr({ type: Comp, props: props ?? {}, key: void 0 }, ctx);
+}
 
 // src/ui/index.ts
 function escape2(s) {
@@ -4186,105 +3994,6 @@ function ui() {
   };
 }
 
-// src/ui-dom/route-match.ts
-function joinPaths(a, b) {
-  if (!b || b === "/") return a || "/";
-  const left = a.endsWith("/") ? a.slice(0, -1) : a;
-  const right = b.startsWith("/") ? b : "/" + b;
-  return left + right;
-}
-function compilePath(path) {
-  const keys = [];
-  const reStr = path.replace(/:(\w+)/g, (_, key) => {
-    keys.push(key);
-    return "([^/]+)";
-  }).replace(/\*/g, ".*");
-  return { re: new RegExp(`^${reStr}$`), keys };
-}
-function flattenRoutes(routes, basePath = "", chain = []) {
-  const result = [];
-  for (const route of routes) {
-    const fullPath = joinPaths(basePath, route.path);
-    const { re, keys } = compilePath(fullPath);
-    const fullChain = [...chain, route];
-    result.push({ re, keys, def: route, chain: fullChain });
-    if (route.children) {
-      result.push(...flattenRoutes(route.children, fullPath, fullChain));
-    }
-  }
-  return result;
-}
-function matchRoute(path, routes) {
-  let best = null;
-  for (const fr of routes) {
-    if (path.match(fr.re)) {
-      if (!best || fr.chain.length > best.chain.length) best = fr;
-    }
-  }
-  return best;
-}
-function extractParams(path, match) {
-  const params = {};
-  const m = path.match(match.re);
-  if (m) {
-    for (let i = 0; i < match.keys.length; i++) {
-      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>
-<html lang="zh-CN">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>${escapeHtml(p.title)}</title>
-  ${(p.styles ?? []).map((s) => `<link rel="stylesheet" href="${escapeHtml(s)}">`).join("\n  ")}
-</head>
-<body>
-  <div id="root">${p.html}</div>
-  ${p.dataScript}
-  ${p.bundle ? `<script src="${escapeHtml(p.bundle)}"></script>` : ""}
-</body>
-</html>`;
-function escapeHtml(s) {
-  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
-}
-function uiSsr(opts) {
-  const flatRoutes = flattenRoutes(opts.routes);
-  const template = opts.template ?? DEFAULT_TEMPLATE;
-  return async (req, ctx, next) => {
-    if (req.method !== "GET") return next(req, ctx);
-    const url = new URL(req.url);
-    const match = matchRoute(url.pathname, flatRoutes);
-    if (!match) return next(req, ctx);
-    const params = extractParams(url.pathname, match);
-    const def = match.chain[match.chain.length - 1] ?? match.def;
-    const pageCtx = Object.assign(Object.create(ctx), {
-      params,
-      route: { path: url.pathname, params, query: Object.fromEntries(url.searchParams) }
-    });
-    if (!def.component) return next(req, ctx);
-    const data = /* @__PURE__ */ new Map();
-    const html = await ssrToString(def.component, {}, pageCtx, { data });
-    const title = opts.title ? opts.title({ params, def }) : def.title || "weifuwu";
-    const dataScript = new HtmlSafe(serializeData(data)).toString();
-    const body = template({ html: html.toString(), dataScript, title, bundle: opts.bundle, styles: opts.styles });
-    return new Response(body, {
-      headers: { "Content-Type": "text/html; charset=utf-8" }
-    });
-  };
-}
-
 // src/db/postgres/connection.ts
 import net3 from "node:net";
 import crypto2 from "node:crypto";
@@ -8341,7 +8050,6 @@ export {
   serverError,
   tooManyRequests,
   ui,
-  uiSsr,
   unauthorized,
   unprocessable,
   userSystem,

package/dist/layout/weifuwu-layout.css

@@ -852,6 +852,15 @@ body.wf-dragging {
   max-width: min(var(--wf-popup-max, 480px), calc(100vw - 32px));
   box-sizing: border-box;
 }
+
+/* usePopup mask 模式遮罩：全屏 fixed，z-index 低于面板（overlay=80 < popover=120），
+ * 模态语义阻断页面交互；点击遮罩关闭（maskClosable 门控在组件层） */
+.wf-popup-mask {
+  position: fixed;
+  inset: 0;
+  z-index: var(--wf-z-overlay);
+  background: var(--wf-overlay);
+}
 }
 
 @layer layout {

package/dist/test/client/setup.d.ts

@@ -0,0 +1,12 @@
+/**
+ * weifuwu/ui-dom 测试环境 setup
+ *
+ * 在每个测试文件开头调用：
+ * ```ts
+ * import { setupJsdom } from './setup.ts'
+ * setupJsdom()
+ * ```
+ *
+ * 提供 JSDOM 浏览器全局环境，供 jsx-runtime / signal 等模块使用。
+ */
+export declare function setupJsdom(): void;