@wisdomgarden/torque 0.2.1 → 0.2.2

package/dist/common/is-dev.d.ts

@@ -0,0 +1 @@
+export declare const isDev: () => boolean;

package/dist/common/is-dev.js

@@ -0,0 +1,5 @@
+"use client";
+const e = () => typeof process < "u" && process.env.NODE_ENV !== "production";
+export {
+  e as isDev
+};

package/dist/components/popover/popover.js

@@ -1,39 +1,40 @@
 "use client";
-import { jsx as ie } from "react/jsx-runtime";
-import { offset as le, flip as ae, size as de, shift as ue, limitShift as fe, arrow as me, hide as pe, useFloating as ge, autoUpdate as ve } from "@floating-ui/react-dom";
-import { useDirection as he, getFloatingPosition as Ee } from "@mantine/core";
-import B, { useRef as l, useId as xe, useCallback as r, useEffect as J, useMemo as K } from "react";
+import { jsx as le } from "react/jsx-runtime";
+import { offset as ae, flip as de, size as ue, shift as fe, limitShift as me, arrow as pe, hide as he, useFloating as ve, autoUpdate as ge } from "@floating-ui/react-dom";
+import { useDirection as Ee, getFloatingPosition as we } from "@mantine/core";
+import K, { useRef as c, useId as xe, useCallback as r, useEffect as D, useMemo as Q } from "react";
+import { isDev as Pe } from "../../common/is-dev.js";
 import { useEscapeClose as Re } from "./hooks.js";
-import { PopoverContext as Q } from "./popover-context.js";
-const v = 8, Te = ({
-  children: W,
-  position: X = "bottom",
-  offset: C = 8,
-  opened: N,
-  defaultOpened: Y = !1,
-  onOpenChange: T,
-  disabled: b = !1,
-  withArrow: i = !1,
-  arrowSize: a = 8,
-  trigger: I = "click",
+import { PopoverContext as W } from "./popover-context.js";
+const w = 8, Ie = ({
+  children: X,
+  position: Y = "bottom",
+  offset: N = 8,
+  opened: T,
+  defaultOpened: Z = !1,
+  onOpenChange: u,
+  disabled: I = !1,
+  withArrow: l = !1,
+  arrowSize: f = 8,
+  trigger: a = "click",
   openDelay: L = 0,
   closeDelay: M = 100,
-  closeOnClickOutside: S = !0,
-  closeOnEscape: Z = !0,
-  restoreFocus: z,
-  strategy: h = "absolute",
-  initialFocusRef: $,
-  trapFocus: D = !1,
-  preventAutoFocus: G = !1,
-  "aria-labelledby": H
+  closeOnClickOutside: $ = !0,
+  closeOnEscape: z = !0,
+  restoreFocus: ee,
+  strategy: x = "absolute",
+  initialFocusRef: S,
+  trapFocus: G = !1,
+  preventAutoFocus: H = !1,
+  "aria-labelledby": j
 }) => {
-  const E = B.useContext(Q), j = E?.registerNestedFloatingElement, x = E ? E.depth + 1 : 0, R = N !== void 0, [ee, te] = B.useState(Y), o = R ? N : ee, d = l(null), u = l(null), f = l(null), F = l(/* @__PURE__ */ new Set()), P = l(void 0), y = xe(), { dir: ne } = he(), n = r(
+  const P = K.useContext(W), k = P?.registerNestedFloatingElement, R = P ? P.depth + 1 : 0, d = T !== void 0, [te, ne] = K.useState(Z), o = d ? T : te, m = c(null), p = c(null), h = c(null), y = c(/* @__PURE__ */ new Set()), F = c(void 0), b = xe(), { dir: oe } = Ee(), n = r(
     (e) => {
-      R || te(e), T?.(e);
+      d || ne(e), u?.(e);
     },
-    [R, T]
-  ), w = r(() => n(!1), [n]), k = r(() => n(!o), [o, n]), s = r(() => {
-    window.clearTimeout(P.current), P.current = void 0;
+    [d, u]
+  ), C = r(() => n(!1), [n]), q = r(() => n(!o), [o, n]), s = r(() => {
+    window.clearTimeout(F.current), F.current = void 0;
   }, []), O = r(
     (e) => {
       s();
@@ -42,153 +43,159 @@ const v = 8, Te = ({
         n(e);
         return;
       }
-      P.current = window.setTimeout(() => n(e), t);
+      F.current = window.setTimeout(() => n(e), t);
     },
     [s, L, M, n]
   );
-  J(() => s, [s]);
-  const U = r(
+  D(() => s, [s]);
+  const U = c(!1);
+  D(() => {
+    !Pe() || U.current || !d || a === "none" || u || (U.current = !0, console.warn(
+      `[@wisdomgarden/torque] <Popover trigger="${a}"> is controlled through \`opened\` but got no \`onOpenChange\`, so every built-in trigger resolves to a no-op — including the \`openDelay\` / \`closeDelay\` timers, which still run and then have nowhere to report. Pass \`onOpenChange\`, or use trigger="none" if the host owns the open state.`
+    ));
+  }, [d, a, u]);
+  const V = r(
     (e) => {
-      F.current.add(e);
-      const t = j?.(e);
+      y.current.add(e);
+      const t = k?.(e);
       return () => {
-        F.current.delete(e), t?.();
+        y.current.delete(e), t?.();
       };
     },
-    [j]
-  ), m = r(() => {
-    const e = f.current ? [f.current] : [];
-    return F.current.forEach((t) => {
+    [k]
+  ), v = r(() => {
+    const e = h.current ? [h.current] : [];
+    return y.current.forEach((t) => {
       t.isConnected && e.push(t);
     }), Array.from(new Set(e));
   }, []);
-  J(() => {
-    if (!S || !o) return;
+  D(() => {
+    if (!$ || !o) return;
     const e = (t) => {
-      const g = t.composedPath(), c = u.current;
-      c && g.includes(c) || m().some((ce) => g.includes(ce)) || w();
+      const E = t.composedPath(), i = p.current;
+      i && E.includes(i) || v().some((ce) => E.includes(ce)) || C();
     };
     return document.addEventListener("mousedown", e, !0), document.addEventListener("touchstart", e, !0), () => {
       document.removeEventListener("mousedown", e, !0), document.removeEventListener("touchstart", e, !0);
     };
-  }, [S, o, w, m]), Re(
-    Z,
+  }, [$, o, C, v]), Re(
+    z,
     o,
-    w,
-    u,
-    y,
-    x,
-    z
+    C,
+    p,
+    b,
+    R,
+    ee
   );
-  const oe = K(
+  const re = Q(
     () => [
-      le(C + (i ? a / 2 : 0)),
-      ae({ padding: v }),
+      ae(N + (l ? f / 2 : 0)),
+      de({ padding: w }),
       // 必须在 shift 之前：否则 availableHeight 是 shift 推动后的位置算出的（≈整屏），高度约束失效
-      de({
-        padding: v,
-        apply({ availableWidth: e, availableHeight: t, rects: g, elements: c }) {
-          c.floating.style.setProperty(
+      ue({
+        padding: w,
+        apply({ availableWidth: e, availableHeight: t, rects: E, elements: i }) {
+          i.floating.style.setProperty(
             "--t-popover-available-width",
             `${Math.max(0, e)}px`
-          ), c.floating.style.setProperty(
+          ), i.floating.style.setProperty(
             "--t-popover-available-height",
             `${Math.max(0, t)}px`
-          ), c.floating.style.setProperty(
+          ), i.floating.style.setProperty(
             "--t-popover-reference-width",
-            `${g.reference.width}px`
+            `${E.reference.width}px`
           );
         }
       }),
-      ue({
-        padding: v,
+      fe({
+        padding: w,
         crossAxis: !0,
         mainAxis: !0,
-        limiter: fe()
+        limiter: me()
       }),
-      ...i ? (
+      ...l ? (
         // floating-ui 的 arrow 中间件按设计就是收一个 ref 对象（它在定位阶段自己读
         // .current），不是我们在渲染期读 ref 的值。没有保留该 API 的改写方式。
         // eslint-disable-next-line react-hooks/refs
-        [me({ element: d, padding: v })]
+        [pe({ element: m, padding: w })]
       ) : [],
-      pe()
+      he()
     ],
-    [C, i, a, d]
+    [N, l, f, m]
   ), {
-    x: V,
-    y: _,
-    refs: p,
-    placement: re,
-    middlewareData: q
-  } = ge({
+    x: _,
+    y: A,
+    refs: g,
+    placement: se,
+    middlewareData: B
+  } = ve({
     open: o,
-    strategy: h,
-    placement: Ee(ne, X),
-    middleware: oe,
-    whileElementsMounted: ve
-  }), A = re.split("-")[0], se = K(
+    strategy: x,
+    placement: we(oe, Y),
+    middleware: re,
+    whileElementsMounted: ge
+  }), J = se.split("-")[0], ie = Q(
     () => ({
       opened: o,
       setOpen: n,
-      toggle: k,
-      trigger: I,
-      disabled: b,
-      id: y,
-      withArrow: i,
-      arrowSize: a,
-      x: V,
-      y: _,
-      strategy: h,
-      resolvedSide: A,
-      middlewareData: q,
+      toggle: q,
+      trigger: a,
+      disabled: I,
+      id: b,
+      withArrow: l,
+      arrowSize: f,
+      x: _,
+      y: A,
+      strategy: x,
+      resolvedSide: J,
+      middlewareData: B,
       scheduleHover: O,
       cancelHoverTimer: s,
-      referenceRef: u,
-      floatingRef: f,
-      arrowRef: d,
-      setReference: p.setReference,
-      setFloating: p.setFloating,
-      depth: x,
-      registerNestedFloatingElement: U,
-      getFloatingScopeElements: m,
-      initialFocusRef: $,
-      trapFocus: D,
-      preventAutoFocus: G,
-      ariaLabelledby: H
+      referenceRef: p,
+      floatingRef: h,
+      arrowRef: m,
+      setReference: g.setReference,
+      setFloating: g.setFloating,
+      depth: R,
+      registerNestedFloatingElement: V,
+      getFloatingScopeElements: v,
+      initialFocusRef: S,
+      trapFocus: G,
+      preventAutoFocus: H,
+      ariaLabelledby: j
     }),
     [
       o,
       n,
-      k,
+      q,
+      a,
       I,
       b,
-      y,
-      i,
-      a,
-      V,
+      l,
+      f,
       _,
-      h,
       A,
-      q,
+      x,
+      J,
+      B,
       O,
       s,
-      u,
-      f,
-      d,
-      p.setReference,
-      p.setFloating,
-      x,
-      U,
+      p,
+      h,
       m,
-      $,
-      D,
+      g.setReference,
+      g.setFloating,
+      R,
+      V,
+      v,
+      S,
       G,
-      H
+      H,
+      j
     ]
   );
-  return /* @__PURE__ */ ie(Q.Provider, { value: se, children: W });
+  return /* @__PURE__ */ le(W.Provider, { value: ie, children: X });
 };
 export {
-  Te as Popover
+  Ie as Popover
 };

package/dist/components/popover/popover.types.d.ts

@@ -22,7 +22,11 @@ export interface PopoverProps {
      */
     offset?: number;
     /**
-     * 受控模式：是否展开
+     * 受控模式：是否展开。
+     *
+     * 受控之后内部不再持有开关状态，所有内部触发都只转发给 `onOpenChange`，
+     * 所以除 `trigger="none"` 外**必须同时提供 `onOpenChange`** ——
+     * 漏传会让 click / hover 以及 `openDelay` / `closeDelay` 全部静默失效。
      */
     opened?: boolean;
     /**
@@ -31,7 +35,8 @@ export interface PopoverProps {
      */
     defaultOpened?: boolean;
     /**
-     * 展开状态变更回调
+     * 展开状态变更回调。受控与非受控都会调用；受控下它是内部触发唯一的出口，
+     * 必须无条件回写，业务上的启用与否交给 `disabled`。
      */
     onOpenChange?: (opened: boolean) => void;
     /**
@@ -64,6 +69,10 @@ export interface PopoverProps {
     /**
      * hover 关闭延迟（ms），留出鼠标从触发元素移动到浮层的时间。
      * 仅 `trigger="hover"` 生效。
+     *
+     * 设为 `0` 即取消这段缓冲：鼠标离开触发元素就同步关闭，够不到浮层，键盘也 Tab 不进去。
+     * 想要「只给看、不给进一步操作」的富文本 tooltip 就该设 `0`，但浮层内容必须纯展示；
+     * 浮层内有可交互内容时不要设 `0`。
      * @default 100
      */
     closeDelay?: number;

package/dist/provider/hooks.js

@@ -1,26 +1,27 @@
 "use client";
 import { useContext as n } from "react";
-import { UiContext as r } from "./ui-context.js";
-const c = () => typeof process < "u" && process.env.NODE_ENV !== "production", t = () => n(r), d = () => t().locale, u = () => {
+import { isDev as r } from "../common/is-dev.js";
+import { UiContext as a } from "./ui-context.js";
+const t = () => n(a), u = () => t().locale, p = () => {
   const { deviceType: e } = t();
   return { deviceType: e };
-}, p = () => {
+}, v = () => {
   const { deviceType: e } = t();
   return {
     isMobile: e === "mobile",
     isTablet: e === "tablet",
     isDesktop: e === "desktop"
   };
-}, o = /* @__PURE__ */ new Set(), v = (e) => {
-  const { linkComponent: s, hasProvider: i } = t();
-  return c() && !i && !o.has(e) && (o.add(e), console.warn(
+}, o = /* @__PURE__ */ new Set(), f = (e) => {
+  const { linkComponent: i, hasProvider: s } = t();
+  return r() && !s && !o.has(e) && (o.add(e), console.warn(
     `[@wisdomgarden/torque] <${e}> rendered outside <UiProvider>, falling back to a plain <a>. On a host with a router this silently turns client-side navigation into a full page load.`
-  )), s;
+  )), i;
 };
 export {
-  p as useCheckDevice,
-  u as useDeviceType,
-  d as useLocale,
+  v as useCheckDevice,
+  p as useDeviceType,
+  u as useLocale,
   t as useUiContext,
-  v as useUiLink
+  f as useUiLink
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wisdomgarden/torque",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Torque Design — Wisdom Garden's base UI component library for React.",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",