weifuwu 0.38.2 → 0.39.0

package/dist/client/index.d.ts

@@ -15,7 +15,7 @@
  *   extendCtx                            → ctx 扩展
  *   WfuiContext / AppMiddleware / RouteDef → 类型
  */
-export { h, jsx, jsxs, jsxDEV, Fragment } from './vnode.ts';
+export { h, jsx, jsxs, jsxDEV, Fragment, Portal, createPortal } from './vnode.ts';
 export type { VNode, VNodeType, Component } from './vnode.ts';
 export { createApp } from './app.ts';
 export { router, RouteView } from './router.ts';
@@ -33,6 +33,8 @@ export { i18n } from './i18n.ts';
 export type { I18nOptions, I18nState } from './i18n.ts';
 export { lockScroll, unlockScroll } from './scroll-lock.ts';
 export { trapFocus } from './focus-trap.ts';
+export { computeFixedPos } from './popup.ts';
+export type { FixedPos, Placement } from './popup.ts';
 export { confirm } from './confirm.ts';
 export type { ConfirmOptions, ConfirmState } from './confirm.ts';
 export { zhCN } from './locale/zh_CN.ts';

package/dist/client/index.js

@@ -1,5 +1,6 @@
 // src/client/vnode.ts
 var Fragment = /* @__PURE__ */ Symbol("Fragment");
+var Portal = /* @__PURE__ */ Symbol("Portal");
 function jsx(type, props, key) {
   return {
     type,
@@ -27,17 +28,25 @@ function normalizeProps(props) {
   }
   return result;
 }
+function createPortal(children, portalKey) {
+  return {
+    type: Portal,
+    props: { children, portalKey },
+    key: portalKey ?? void 0
+  };
+}
 
 // src/client/render.ts
+var SVG_NS = "http://www.w3.org/2000/svg";
+var SVG_TAGS = /* @__PURE__ */ new Set(["svg", "path", "circle", "line", "rect", "text", "g", "polyline", "polygon", "ellipse", "defs", "use", "clipPath", "mask", "linearGradient", "radialGradient", "stop", "tspan"]);
+var _renderCount = 0;
 var mutationMethods = ["push", "pop", "splice", "shift", "unshift", "sort", "reverse"];
 var wrappedCache = /* @__PURE__ */ new WeakMap();
-function wrapDeep(val, dirty) {
-  if (val === null || typeof val !== "object") return val;
-  if (val instanceof Node) return val;
-  if (typeof Blob !== "undefined" && val instanceof Blob) return val;
-  if (wrappedCache.has(val)) return wrappedCache.get(val);
-  const handler = Array.isArray(val) ? {
+function makeProxyHandler(dirty) {
+  const isSkip = (k) => typeof k === "string" && k.startsWith("_");
+  return {
     get(target, key, receiver) {
+      if (isSkip(key)) return Reflect.get(target, key, receiver);
       const v = Reflect.get(target, key, receiver);
       if (typeof key === "string" && mutationMethods.includes(key) && typeof v === "function") {
         return function(...args) {
@@ -49,37 +58,25 @@ function wrapDeep(val, dirty) {
       return wrapDeep(v, dirty);
     },
     set(target, key, v) {
-      Reflect.set(target, key, wrapDeep(v, dirty));
-      dirty();
-      return true;
-    }
-  } : {
-    get(_target, key, receiver) {
-      const v = Reflect.get(_target, key, receiver);
-      return wrapDeep(v, dirty);
-    },
-    set(target, key, v) {
-      Reflect.set(target, key, wrapDeep(v, dirty));
-      dirty();
+      const old = Reflect.get(target, key);
+      if (old === v) return true;
+      Reflect.set(target, key, isSkip(key) ? v : wrapDeep(v, dirty));
+      if (!isSkip(key)) dirty();
       return true;
     }
   };
-  const proxy = new Proxy(val, handler);
+}
+function wrapDeep(val, dirty) {
+  if (val === null || typeof val !== "object") return val;
+  if (val instanceof Node) return val;
+  if (typeof Blob !== "undefined" && val instanceof Blob) return val;
+  if (wrappedCache.has(val)) return wrappedCache.get(val);
+  const proxy = new Proxy(val, makeProxyHandler(dirty));
   wrappedCache.set(val, proxy);
   return proxy;
 }
 function createComponentProxy(target, dirty) {
-  return new Proxy(target, {
-    set(t, k, v) {
-      if (t[k] === v) return true;
-      t[k] = wrapDeep(v, dirty);
-      dirty();
-      return true;
-    },
-    get(t, k) {
-      return wrapDeep(t[k], dirty);
-    }
-  });
+  return new Proxy(target, makeProxyHandler(dirty));
 }
 function render(input, ctx) {
   return renderValue(input, ctx);
@@ -89,6 +86,9 @@ function renderValue(v, ctx) {
   if (typeof v === "string" || typeof v === "number") return document.createTextNode(String(v));
   if (Array.isArray(v)) return renderArray(v, ctx);
   const vnode = v;
+  if (vnode.type === Portal) {
+    return renderPortal(vnode, ctx);
+  }
   if (vnode.type === Fragment) {
     const frag = document.createDocumentFragment();
     forEach(vnode.props?.children, (child) => frag.appendChild(renderValue(child, ctx)));
@@ -97,16 +97,27 @@ function renderValue(v, ctx) {
   if (typeof vnode.type === "function") {
     return renderComponent(vnode.type, vnode.props, vnode, ctx);
   }
-  const el = document.createElement(vnode.type);
+  const tag = vnode.type;
+  const el = SVG_TAGS.has(tag) ? document.createElementNS(SVG_NS, tag) : document.createElement(tag);
   vnode.el = el;
+  let selectValue;
   for (const [key, value] of Object.entries(vnode.props ?? {})) {
-    if (key === "children" || key === "key" || key === "ref") continue;
+    if (key === "children" || key === "key" || key === "ref" || key === "value") continue;
     setProp(el, key, value);
   }
+  if ("value" in (vnode.props ?? {}) && el instanceof HTMLSelectElement) {
+    selectValue = vnode.props.value;
+  } else if ("value" in (vnode.props ?? {})) {
+    setProp(el, "value", vnode.props.value);
+  }
   const flatChildren = flattenChildren(vnode.props?.children);
   for (const child of flatChildren) {
     el.appendChild(renderValue(child, ctx));
   }
+  if (selectValue !== void 0) {
+    ;
+    el.value = String(selectValue);
+  }
   if (vnode.props?.ref) {
     const result = vnode.props.ref(el);
     if (typeof result === "function") vnode._cleanup = result;
@@ -119,8 +130,13 @@ function renderComponent(Comp, props, vnode, ctx) {
   ctx.ui = ctx.ui ?? {};
   ctx.ui.ready = !!prev$;
   const _target = vnode._$;
-  ctx.ui.$ = createComponentProxy(_target, () => ctx.ui?.dirty?.());
+  const _dirtyFn = () => {
+    if (_renderCount > 0) return;
+    ctx.ui?.dirty?.();
+  };
+  ctx.ui.$ = createComponentProxy(_target, _dirtyFn);
   let childVNode;
+  _renderCount++;
   try {
     childVNode = Comp(props, ctx);
   } catch (e) {
@@ -132,6 +148,8 @@ function renderComponent(Comp, props, vnode, ctx) {
       console.error("Component render error:", e);
       childVNode = null;
     }
+  } finally {
+    _renderCount--;
   }
   if (childVNode == null) {
     vnode._child = null;
@@ -145,6 +163,41 @@ function renderArray(arr, ctx) {
   for (const item of arr) frag.appendChild(renderValue(item, ctx));
   return frag;
 }
+function ensurePortalContainer() {
+  let c = document.getElementById("__wf_portal");
+  if (!c) {
+    c = document.createElement("div");
+    c.id = "__wf_portal";
+    c.style.cssText = "position:fixed;inset:0;pointer-events:none;z-index:9999";
+    document.body.appendChild(c);
+  }
+  return c;
+}
+function renderPortal(vnode, ctx) {
+  const container = ensurePortalContainer();
+  const sub = document.createElement("div");
+  sub.style.pointerEvents = "auto";
+  container.appendChild(sub);
+  vnode._portalEl = sub;
+  const children = normalize(vnode.props?.children);
+  vnode._child = children;
+  for (const child of children) {
+    sub.appendChild(renderValue(child, ctx));
+  }
+  const placeholder = document.createTextNode("");
+  vnode.el = placeholder;
+  return placeholder;
+}
+function patchPortal(_parent, oldNode, oldV, newV, ctx) {
+  const sub = oldV._portalEl;
+  newV._portalEl = sub;
+  if (!sub) return renderPortal(newV, ctx);
+  const newChildren = normalize(newV.props?.children);
+  const oldChildren = oldV._child || [];
+  newV._child = newChildren;
+  patchSimpleChildren(sub, oldChildren, newChildren, ctx);
+  return oldNode ?? document.createTextNode("");
+}
 function forEach(children, fn) {
   if (children == null) return;
   if (Array.isArray(children)) {
@@ -168,12 +221,17 @@ function flattenChildren(children) {
 }
 function setProp(el, key, value) {
   if (key === "class" || key === "className") {
-    el.className = String(value ?? "");
+    if (el instanceof SVGElement) el.setAttribute("class", String(value ?? ""));
+    else el.className = String(value ?? "");
   } else if (key === "style" && typeof value === "object" && value !== null) {
-    Object.assign(el.style, value);
+    const st = el.style;
+    for (const sk of Object.keys(value)) {
+      const sv = value[sk];
+      if (sv != null) st[sk] = typeof sv === "number" ? sv + "px" : String(sv);
+    }
   } else if (key.startsWith("on") && typeof value === "function") {
     el.addEventListener(key.slice(2).toLowerCase(), value);
-  } else if (key === "value" && (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement)) {
+  } else if (key === "value" && (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement || el instanceof HTMLSelectElement)) {
     ;
     el.value = String(value ?? "");
   } else if (value === true) {
@@ -224,8 +282,18 @@ function patchValue(parent, oldNode, oldInput, newInput, ctx) {
     ctx.ui = ctx.ui ?? {};
     ctx.ui.ready = !!newV._$;
     const _tgt = newV._$;
-    ctx.ui.$ = createComponentProxy(_tgt, () => ctx.ui?.dirty?.());
-    const childNew = comp(newV.props, ctx);
+    const _dirtyFn2 = () => {
+      if (_renderCount > 0) return;
+      ctx.ui?.dirty?.();
+    };
+    ctx.ui.$ = createComponentProxy(_tgt, _dirtyFn2);
+    _renderCount++;
+    let childNew;
+    try {
+      childNew = comp(newV.props, ctx);
+    } finally {
+      _renderCount--;
+    }
     newV._child = childNew;
     return patchValue(parent, oldNode, oldV._child, childNew, ctx);
   }
@@ -246,6 +314,9 @@ function patchValue(parent, oldNode, oldInput, newInput, ctx) {
     }
     return oldNode;
   }
+  if (newV.type === Portal) {
+    return patchPortal(parent, oldNode, oldV, newV, ctx);
+  }
   if (Array.isArray(newInput)) {
     const oldArr = Array.isArray(oldInput) ? oldInput : [];
     patchSimpleChildren(parent, oldArr, newInput, ctx);
@@ -260,6 +331,7 @@ function typeOf(input) {
   const v = input;
   if (typeof v.type === "function") return `fn:${v.type.name || "anon"}`;
   if (v.type === Fragment) return "fragment";
+  if (v.type === Portal) return "portal";
   if (typeof v.type === "string") return "tag:" + v.type;
   return "unknown";
 }
@@ -270,7 +342,7 @@ function patchProps(el, oldProps, newProps) {
     if (!newKeys.includes(key)) {
       if (key.startsWith("on") && typeof oldProps[key] === "function") {
         el.removeEventListener(key.slice(2).toLowerCase(), oldProps[key]);
-      } else if (key === "value" && (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement)) {
+      } else if (key === "value" && (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement || el instanceof HTMLSelectElement)) {
         ;
         el.value = "";
       } else {
@@ -283,14 +355,19 @@ function patchProps(el, oldProps, newProps) {
     const newVal = newProps?.[key];
     if (newVal !== oldVal) {
       if (key === "class" || key === "className") {
-        el.className = String(newVal ?? "");
+        if (el instanceof SVGElement) el.setAttribute("class", String(newVal ?? ""));
+        else el.className = String(newVal ?? "");
       } else if (key === "style" && typeof newVal === "object") {
-        Object.assign(el.style, newVal);
+        const st = el.style;
+        for (const sk of Object.keys(newVal)) {
+          const sv = newVal[sk];
+          if (sv != null) st[sk] = typeof sv === "number" ? sv + "px" : String(sv);
+        }
       } else if (key.startsWith("on") && typeof newVal === "function") {
         const eventName = key.slice(2).toLowerCase();
         if (typeof oldVal === "function") el.removeEventListener(eventName, oldVal);
         el.addEventListener(eventName, newVal);
-      } else if (key === "value" && (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement)) {
+      } else if (key === "value" && (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement || el instanceof HTMLSelectElement)) {
         ;
         el.value = String(newVal ?? "");
       } else if (newVal === true) {
@@ -298,7 +375,7 @@ function patchProps(el, oldProps, newProps) {
       } else if (newVal != null && newVal !== false) {
         el.setAttribute(key, String(newVal));
       } else {
-        if (key === "value" && (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement)) {
+        if (key === "value" && (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement || el instanceof HTMLSelectElement)) {
           ;
           el.value = "";
         } else {
@@ -411,9 +488,25 @@ function runRefCleanup(vnode) {
     }
   });
 }
+function cleanupPortalChildren(vnode) {
+  const child = vnode._child;
+  if (child == null) return;
+  if (Array.isArray(child)) {
+    for (const c of child) {
+      if (c && typeof c === "object") callRefCleanup(c);
+    }
+  } else if (typeof child === "object") {
+    callRefCleanup(child);
+  }
+}
 function callRefCleanup(input) {
   if (input == null || typeof input !== "object") return;
   const vnode = input;
+  if (vnode._portalEl) {
+    cleanupPortalChildren(vnode);
+    vnode._portalEl.remove();
+    vnode._portalEl = void 0;
+  }
   if (vnode._cleanup) runRefCleanup(vnode);
 }
 
@@ -914,7 +1007,22 @@ var zhCN = {
     Switch: { ariaLabel: "\u5207\u6362" },
     Breadcrumb: { ariaLabel: "\u9762\u5305\u5C51" },
     Modal: { ariaLabel: "\u5F39\u7A97" },
-    Drawer: { ariaLabel: "\u4FA7\u8FB9\u9762\u677F" }
+    Drawer: { ariaLabel: "\u4FA7\u8FB9\u9762\u677F" },
+    DatePicker: {
+      w0: "\u65E5",
+      w1: "\u4E00",
+      w2: "\u4E8C",
+      w3: "\u4E09",
+      w4: "\u56DB",
+      w5: "\u4E94",
+      w6: "\u516D",
+      hour: "\u65F6",
+      minute: "\u5206",
+      time: "\u65F6\u95F4",
+      confirm: "\u786E\u5B9A",
+      cancel: "\u53D6\u6D88",
+      placeholder: "\u9009\u62E9\u65E5\u671F"
+    }
   }
 };
 
@@ -933,7 +1041,22 @@ var enUS = {
     Switch: { ariaLabel: "Toggle" },
     Breadcrumb: { ariaLabel: "Breadcrumb" },
     Modal: { ariaLabel: "Dialog" },
-    Drawer: { ariaLabel: "Panel" }
+    Drawer: { ariaLabel: "Panel" },
+    DatePicker: {
+      w0: "Su",
+      w1: "Mo",
+      w2: "Tu",
+      w3: "We",
+      w4: "Th",
+      w5: "Fr",
+      w6: "Sa",
+      hour: "Hour",
+      minute: "Min",
+      time: "Time",
+      confirm: "OK",
+      cancel: "Cancel",
+      placeholder: "Pick a date"
+    }
   }
 };
 
@@ -1060,6 +1183,33 @@ function trapFocus(container) {
   };
 }
 
+// src/client/popup.ts
+function computeFixedPos(el, placement = "bottom", gap = 6, center = true) {
+  const rect = el.getBoundingClientRect();
+  switch (placement) {
+    case "bottom":
+      return {
+        top: rect.bottom + gap,
+        left: center ? rect.left + rect.width / 2 : rect.left
+      };
+    case "top":
+      return {
+        top: rect.top - gap,
+        left: center ? rect.left + rect.width / 2 : rect.left
+      };
+    case "left":
+      return {
+        top: center ? rect.top + rect.height / 2 : rect.top,
+        left: rect.left - gap
+      };
+    case "right":
+      return {
+        top: center ? rect.top + rect.height / 2 : rect.top,
+        left: rect.right + gap
+      };
+  }
+}
+
 // src/client/confirm.ts
 function createConfirmModal(message, options) {
   return new Promise((resolve) => {
@@ -1135,11 +1285,14 @@ export {
   ApiError,
   ErrorBoundary,
   Fragment,
+  Portal,
   RouteView,
   api,
   auth,
+  computeFixedPos,
   confirm,
   createApp,
+  createPortal,
   enUS,
   extendCtx,
   h,

package/dist/client/locale/en_US.d.ts

@@ -30,5 +30,20 @@ export declare const enUS: {
         Drawer: {
             ariaLabel: string;
         };
+        DatePicker: {
+            w0: string;
+            w1: string;
+            w2: string;
+            w3: string;
+            w4: string;
+            w5: string;
+            w6: string;
+            hour: string;
+            minute: string;
+            time: string;
+            confirm: string;
+            cancel: string;
+            placeholder: string;
+        };
     };
 };

package/dist/client/locale/zh_CN.d.ts

@@ -30,5 +30,20 @@ export declare const zhCN: {
         Drawer: {
             ariaLabel: string;
         };
+        DatePicker: {
+            w0: string;
+            w1: string;
+            w2: string;
+            w3: string;
+            w4: string;
+            w5: string;
+            w6: string;
+            hour: string;
+            minute: string;
+            time: string;
+            confirm: string;
+            cancel: string;
+            placeholder: string;
+        };
     };
 };

package/dist/client/popup.d.ts

@@ -0,0 +1,19 @@
+/**
+ * weifuwu/client — 弹出层定位工具
+ *
+ * 基于 position: fixed 的坐标计算，替代 CSS absolute 定位。
+ * 配合 createPortal 使用，让弹出层不受父级 overflow/transform 影响。
+ */
+export interface FixedPos {
+    top: number;
+    left: number;
+}
+export type Placement = 'top' | 'bottom' | 'left' | 'right';
+/**
+ * 根据触发元素和方向计算弹出层的 fixed 坐标
+ * @param el 触发元素
+ * @param placement 弹出方向
+ * @param gap 间距（px），默认 6
+ * @param center 是否居中于触发元素，默认 true
+ */
+export declare function computeFixedPos(el: HTMLElement, placement?: Placement, gap?: number, center?: boolean): FixedPos;

package/dist/client/vnode.d.ts

@@ -7,7 +7,7 @@
  *   --jsxImportSource=weifuwu/client
  */
 import type { WfuiContext } from './types.ts';
-export type VNodeType = string | Component | typeof Fragment;
+export type VNodeType = string | Component | typeof Fragment | typeof Portal;
 export interface VNode {
     type: VNodeType;
     props: Record<string, any>;
@@ -18,9 +18,13 @@ export interface VNode {
     _child?: any;
     /** ref 回调返回的清理函数，卸载时由框架调用 */
     _cleanup?: (() => void) | undefined;
+    /** Portal 子容器 DOM */
+    _portalEl?: HTMLDivElement | undefined;
 }
 export type Component<P = {}> = (props: P, ctx: WfuiContext) => VNode | null;
 export declare const Fragment: unique symbol;
+/** Portal — 将子 VNode 渲染到 document.body 下的独立容器 */
+export declare const Portal: unique symbol;
 /** JSX 类型声明 — 使 TypeScript 理解自定义 JSX 运行时 */
 declare global {
     namespace JSX {
@@ -39,3 +43,6 @@ export declare function h(type: VNodeType, props: Record<string, any> | null, ..
 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;

package/dist/components/Chart/Chart.d.ts

@@ -0,0 +1,18 @@
+/**
+ * weifuwu/components — Chart
+ *
+ * SVG 图表组件，支持 line / bar / pie / donut 四种模式。
+ * 纯函数坐标计算，tooltip 通过 DOM 事件。
+ */
+import type { Component } from '../../client/vnode.ts';
+import type { DataPoint, ChartType, ChartOptions } from './chart-utils.ts';
+export type { DataPoint, ChartType, ChartOptions };
+export interface ChartProps {
+    type?: ChartType;
+    data: DataPoint[];
+    options?: ChartOptions;
+    title?: string;
+    area?: boolean;
+    className?: string;
+}
+export declare const Chart: Component<ChartProps>;

package/dist/components/Chart/chart-utils.d.ts

@@ -0,0 +1,53 @@
+/**
+ * weifuwu/components — Chart 纯函数坐标计算
+ *
+ * 无 DOM 依赖，可测试。
+ */
+export type ChartType = 'line' | 'bar' | 'pie';
+export interface DataPoint {
+    label: string;
+    value: number;
+    color?: string;
+}
+export interface ChartOptions {
+    width?: number;
+    height?: number;
+    padding?: number;
+}
+export interface ScaleLinear {
+    (v: number): number;
+    invert?(v: number): number;
+    domain: [number, number];
+    range: [number, number];
+}
+export declare function scaleLinear(domain: [number, number], range: [number, number]): ScaleLinear;
+export declare function linePath(data: DataPoint[], xScale: ScaleLinear, yScale: ScaleLinear): string;
+export declare function areaPath(data: DataPoint[], xScale: ScaleLinear, yScale: ScaleLinear, yBase: number): string;
+export interface BarRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    color: string;
+    label: string;
+    value: number;
+}
+export declare function barRects(data: DataPoint[], xScale: ScaleLinear, yScale: ScaleLinear, barWidth?: number): BarRect[];
+export interface Arc {
+    d: string;
+    color: string;
+    label: string;
+    value: number;
+    centroid: {
+        x: number;
+        y: number;
+    };
+}
+export declare function pieArcs(data: DataPoint[], cx: number, cy: number, radius: number): Arc[];
+export declare function getDefaultColor(index: number): string;
+export interface Tick {
+    value: number;
+    y: number;
+    label: string;
+}
+export declare function getYTicks(yScale: ScaleLinear, tickCount?: number): Tick[];

package/dist/components/DatePicker/DatePicker.d.ts

@@ -0,0 +1,16 @@
+/**
+ * weifuwu/components — DatePicker
+ *
+ * 四合一日期选择器，支持 mode: date | datetime | time | range
+ * 使用 createPortal + position:fixed 定位弹出层。
+ */
+import type { Component } from '../../client/vnode.ts';
+export type DatePickerMode = 'date' | 'datetime' | 'time' | 'range';
+export interface DatePickerProps {
+    mode?: DatePickerMode;
+    value?: string;
+    onChange?: (value: string) => void;
+    placeholder?: string;
+    disabled?: boolean;
+}
+export declare const DatePicker: Component<DatePickerProps>;

package/dist/components/DatePicker/calendar-utils.d.ts

@@ -0,0 +1,30 @@
+/**
+ * weifuwu/components — DatePicker 日期计算工具
+ *
+ * 纯函数，无 DOM 依赖，可测试。
+ */
+export interface CalendarDay {
+    year: number;
+    month: number;
+    day: number;
+    isOtherMonth: boolean;
+    isToday: boolean;
+}
+export declare function getWeekdays(): string[];
+export declare function isToday(year: number, month: number, day: number): boolean;
+export declare function getDaysInMonth(year: number, month: number): number;
+export declare function getFirstDayOfMonth(year: number, month: number): number;
+/** 生成一个月历网格（6 行 × 7 列 = 42 格） */
+export declare function getCalendarGrid(year: number, month: number): CalendarDay[][];
+/** 格式化日期 */
+export declare function formatDate(year: number, month: number, day: number): string;
+export declare function formatTime(hour: number, minute: number): string;
+export declare function formatDateTime(year: number, month: number, day: number, hour: number, minute: number): string;
+/** 小时选项（00-23） */
+export declare function hourOptions(): number[];
+/** 分钟选项（00-59，步长 5） */
+export declare function minuteOptions(): number[];
+/** 日期比较：a 是否在 b 之前 */
+export declare function isBefore(a: Date, b: Date): boolean;
+/** 日期比较：a 是否在 b 之后 */
+export declare function isAfter(a: Date, b: Date): boolean;

package/dist/components/Popover/Popover.d.ts

@@ -1,19 +1,9 @@
 /**
  * weifuwu/components — Popover
- *
- * 通用弹出层组件。触发点击后在目标元素附近弹出浮动面板。
- * 点击面板外部关闭。
- *
- * 触发方式:
- *   'click' — 点击触发元素切换显示
- *   'hover' — 悬停触发元素显示，移出关闭
- *
- * 受控模式:
- *   传入 open + onOpenChange 可外部控制显示状态
- *   （Dropdown 使用此模式）
  */
 import type { Component } from '../../client/vnode.ts';
-export type PopoverPosition = 'top' | 'bottom' | 'left' | 'right';
+import type { Placement } from '../../client/popup.ts';
+export type PopoverPosition = Placement;
 export interface PopoverProps {
     content?: any;
     trigger?: 'click' | 'hover';

package/dist/components/Tooltip/Tooltip.d.ts

@@ -1,5 +1,6 @@
 import type { Component } from '../../client/vnode.ts';
-export type TooltipPosition = 'top' | 'bottom' | 'left' | 'right';
+import type { Placement } from '../../client/popup.ts';
+export type TooltipPosition = Placement;
 export interface TooltipProps {
     content: string;
     position?: TooltipPosition;