@wisdomgarden/torque 0.1.0

package/dist/components/notifications/notification.js

@@ -0,0 +1,79 @@
+"use client";
+import { jsxs as o, jsx as i, Fragment as d } from "react/jsx-runtime";
+import { Stack as s, Group as m, Space as n, Text as f } from "@mantine/core";
+import { hideNotification as h, showNotification as p } from "@mantine/notifications";
+import { Icon as u } from "@wisdomgarden/torque-icons";
+import { useNotificationA11y as w } from "../../common/use-notification-a11y.js";
+import "../../provider/ui-context.js";
+import "react";
+import { useLocale as N } from "../../provider/hooks.js";
+import { IconButton as x } from "../icon-button/icon-button.js";
+import a from "./notification.module.css.js";
+function C(e) {
+  const t = N(), r = {
+    success: "success-fill",
+    info: "info-fill",
+    warning: "warning-fill-triangle",
+    error: "error-fill"
+  };
+  let l = e.title, c = e.message;
+  l || (l = c, c = void 0);
+  const g = w();
+  return /* @__PURE__ */ o(s, { gap: 0, className: a.notification, children: [
+    /* @__PURE__ */ o(m, { gap: 0, wrap: "nowrap", children: [
+      /* @__PURE__ */ i(s, { gap: 0, children: /* @__PURE__ */ i(
+        u,
+        {
+          name: r[e.type ?? "info"],
+          useOriginalColor: !0,
+          width: 28,
+          height: 28,
+          role: "img",
+          "aria-label": g[e.type ?? "info"]
+        }
+      ) }),
+      /* @__PURE__ */ i(n, { w: 16 }),
+      /* @__PURE__ */ o(s, { gap: 0, className: a.contentStack, children: [
+        /* @__PURE__ */ i(f, { span: !0, fw: 600, className: a.title, fz: 14, lh: "22px", children: l }),
+        /* @__PURE__ */ i(n, { w: 6 }),
+        /* @__PURE__ */ i(f, { span: !0, className: a.message, fz: 14, lh: "22px", children: c })
+      ] }),
+      /* @__PURE__ */ i(n, { w: 16 }),
+      /* @__PURE__ */ i(
+        x,
+        {
+          iconName: "close",
+          "aria-label": t.close,
+          variant: "text",
+          onClick: () => {
+            h(e.getId());
+          }
+        }
+      )
+    ] }),
+    e.renderBottom && /* @__PURE__ */ o(d, { children: [
+      /* @__PURE__ */ i(n, { h: 8 }),
+      /* @__PURE__ */ i(m, { children: e.renderBottom(e.getId) })
+    ] })
+  ] });
+}
+function M(e) {
+  let t = "";
+  const r = {
+    ...e,
+    getId: () => t
+  };
+  return t = p({
+    id: e.id,
+    message: /* @__PURE__ */ i(C, { ...r }),
+    autoClose: e.autoClose ?? 5e3,
+    withCloseButton: !1,
+    onClose: e.onClose,
+    onOpen: e.onOpen,
+    position: "top-right"
+  }), t;
+}
+export {
+  C as Notification,
+  M as showNotification
+};

package/dist/components/notifications/notification.module.css.js

@@ -0,0 +1,14 @@
+"use client";
+const t = "_notification_rnwhl_2", n = "_contentStack_rnwhl_11", e = "_title_rnwhl_17", c = "_message_rnwhl_26", o = {
+  notification: t,
+  contentStack: n,
+  title: e,
+  message: c
+};
+export {
+  n as contentStack,
+  o as default,
+  c as message,
+  t as notification,
+  e as title
+};

package/dist/components/notifications/notification.types.d.ts

@@ -0,0 +1,25 @@
+import { NotificationData } from '@mantine/notifications';
+/**
+ * 全局通知组件的配置选项
+ */
+export interface NotificationOption {
+    /** 通知的唯一标识符。如果不提供，将自动生成一个随机 ID */
+    id?: string;
+    /** 通知的标题。如果未提供 `message`，则 `title` 将作为主要文本显示 */
+    title?: string | React.ReactNode;
+    /** 通知的详细内容描述 */
+    message?: string | React.ReactNode;
+    /** 通知类型，决定图标和无障碍播报内容 */
+    type?: 'success' | 'error' | 'warning' | 'info';
+    /** 自动关闭的时间（毫秒）。设置为 false 则不自动关闭。默认为 5000ms */
+    autoClose?: boolean | number;
+    /** 通知关闭时的回调函数 */
+    onClose?: (props: NotificationData) => void;
+    /** 通知打开时的回调函数 */
+    onOpen?: (props: NotificationData) => void;
+    /**
+     * 自定义渲染底部区域（如操作按钮）。
+     * @param getId - 获取当前通知 ID 的函数，可用于在点击按钮后手动关闭该通知
+     */
+    renderBottom?: (getId: () => string) => React.ReactNode;
+}

package/dist/components/notifications/notifications.d.ts

@@ -0,0 +1,42 @@
+import { cleanNotifications, cleanNotificationsQueue, hideNotification, updateNotification, updateNotificationsState } from '@mantine/notifications';
+import { NotificationOption } from './notification.types';
+/**
+ * 全局通知指令
+ * 用于在屏幕右上角显示较为详细的反馈信息、操作引导或系统通知。
+ */
+export declare const notifications: {
+    /**
+     * 显示一个默认（通常为 info 类型）的通知
+     * @param option - 通知配置项
+     * @returns 通知的唯一 ID
+     */
+    show: (option: NotificationOption) => string;
+    /**
+     * 显示一个错误类型的通知
+     * @param option - 通知配置项
+     * @returns 通知的唯一 ID
+     */
+    showError: (option: NotificationOption) => string;
+    /**
+     * 显示一个成功类型的通知
+     * @param option - 通知配置项
+     * @returns 通知的唯一 ID
+     */
+    showSuccess: (option: NotificationOption) => string;
+    /**
+     * 显示一个警告类型的通知
+     * @param option - 通知配置项
+     * @returns 通知的唯一 ID
+     */
+    showWarning: (option: NotificationOption) => string;
+    /** 根据 ID 隐藏指定的通知 */
+    hide: typeof hideNotification;
+    /** 更新已存在的通知内容 */
+    update: typeof updateNotification;
+    /** 清除所有当前显示的通知 */
+    clean: typeof cleanNotifications;
+    /** 清除通知队列 */
+    cleanQueue: typeof cleanNotificationsQueue;
+    /** 更新通知状态 */
+    updateState: typeof updateNotificationsState;
+};

package/dist/components/notifications/notifications.js

@@ -0,0 +1,42 @@
+"use client";
+import { updateNotificationsState as i, cleanNotificationsQueue as o, cleanNotifications as r, updateNotification as a, hideNotification as n } from "@mantine/notifications";
+import { showNotification as e } from "./notification.js";
+const u = {
+  /**
+   * 显示一个默认（通常为 info 类型）的通知
+   * @param option - 通知配置项
+   * @returns 通知的唯一 ID
+   */
+  show: (t) => e(t),
+  /**
+   * 显示一个错误类型的通知
+   * @param option - 通知配置项
+   * @returns 通知的唯一 ID
+   */
+  showError: (t) => (t.type = "error", e(t)),
+  /**
+   * 显示一个成功类型的通知
+   * @param option - 通知配置项
+   * @returns 通知的唯一 ID
+   */
+  showSuccess: (t) => (t.type = "success", e(t)),
+  /**
+   * 显示一个警告类型的通知
+   * @param option - 通知配置项
+   * @returns 通知的唯一 ID
+   */
+  showWarning: (t) => (t.type = "warning", e(t)),
+  /** 根据 ID 隐藏指定的通知 */
+  hide: n,
+  /** 更新已存在的通知内容 */
+  update: a,
+  /** 清除所有当前显示的通知 */
+  clean: r,
+  /** 清除通知队列 */
+  cleanQueue: o,
+  /** 更新通知状态 */
+  updateState: i
+};
+export {
+  u as notifications
+};

package/dist/components/number-input/index.d.ts

@@ -0,0 +1,2 @@
+export { NumberInput } from './number-input';
+export type * from './number-input.types';

package/dist/components/number-input/index.js

@@ -0,0 +1,5 @@
+"use client";
+import { NumberInput as t } from "./number-input.js";
+export {
+  t as NumberInput
+};

package/dist/components/number-input/number-input.d.ts

@@ -0,0 +1,8 @@
+import { NumberInputProps } from './number-input.types';
+/**
+ * 数字输入框组件 (NumberInput)
+ *
+ * 基于 `react-number-format` 和 `@mantine/hooks` 封装，提供带加减按钮的数字输入能力，
+ * 支持严格/失焦/自动等多种极值约束 (clamp) 行为，并统一项目表单 UI 规范。
+ */
+export declare function NumberInput(props: NumberInputProps): import("react").JSX.Element;

package/dist/components/number-input/number-input.js

@@ -0,0 +1,161 @@
+"use client";
+import { jsx as l, Fragment as F, jsxs as T } from "react/jsx-runtime";
+import { Space as A } from "@mantine/core";
+import { useId as O, useMergedRef as J, useUncontrolled as K } from "@mantine/hooks";
+import { clsx as Q } from "clsx";
+import { useRef as X, useState as W } from "react";
+import { NumericFormat as Y } from "../../node_modules/.pnpm/react-number-format@5.4.5_react-dom@19.2.8_react@19.2.8__react@19.2.8/node_modules/react-number-format/dist/react-number-format.es.js";
+import { useFormWrapperProps as Z } from "../../common/use-form-wrapper-props.js";
+import { NumberInputLeft as $ } from "../_inner/number/number-input-left.js";
+import { NumberInputRight as ee } from "../_inner/number/number-input-right.js";
+import { BaseInput as te } from "../base-input/base-input.js";
+import { FormItemWrapper as re } from "../form-wrapper/form-item-wrapper.js";
+import ne from "./number-input.module.css.js";
+const L = (t, n, o) => {
+  if (t === void 0)
+    return !0;
+  const f = n === void 0 || t >= n, u = o === void 0 || t <= o;
+  return f && u;
+}, v = (t, n, o) => n !== void 0 && t < n ? n : o !== void 0 && t > o ? o : t;
+function be(t) {
+  const n = O(t.id), { wrapProps: o, rest: f, outerDescribedBy: u } = Z(t, n), {
+    value: p,
+    defaultValue: y,
+    onChange: _,
+    onBlur: R,
+    onInput: D,
+    onFocus: C,
+    clampBehavior: g = ["auto", "blur"],
+    buttonPosition: B = "both-sides",
+    formatOnBlurOnly: h = !0,
+    fixedDecimalScale: N = !0,
+    ref: S,
+    ...E
+  } = f, { min: i, max: s, decimalScale: M } = E, P = X(null), j = J(P, S), V = Array.isArray(g) ? g : [g], [I, c] = K({
+    value: p,
+    defaultValue: y?.toString(),
+    finalValue: "",
+    onChange: _
+  }), [w, x] = W(null), d = h && w !== null, U = (e) => {
+    h && w === null && x(e.currentTarget.value), C?.(e);
+  }, k = (e) => V.includes("strict") ? L(e.floatValue, i, s) : !0, q = (e, r) => {
+    r.source === "event" && (d && x(e.formattedValue), c(e.floatValue ?? ""));
+  }, z = (e) => {
+    if (h && w !== null) {
+      const a = e.currentTarget.value, m = parseFloat(a);
+      if (isNaN(m))
+        c("");
+      else {
+        let b = V.length > 0 ? v(m, i, s) : m;
+        M !== void 0 && (b = Number(b.toFixed(M))), c(b);
+      }
+      x(null), R?.(e);
+      return;
+    }
+    let r = I;
+    if (V.includes("blur")) {
+      const a = Number(I);
+      r = isNaN(a) ? "" : v(a, i, s), c(r), e.target.value = r.toString();
+    }
+    R?.(e);
+  }, G = (e) => {
+    const r = e.currentTarget.value;
+    if (!r) {
+      c("");
+      return;
+    }
+    if (!d && V.includes("auto")) {
+      const a = parseFloat(r);
+      if (isNaN(a))
+        return;
+      const m = I.toString(), b = !m, H = r.length < m.length && i !== void 0 && a < i;
+      if (b || H)
+        return;
+      L(a, i, s) ? r.endsWith("-") && (e.currentTarget.value = v(-a, i, s).toString()) : e.currentTarget.value = v(a, i, s).toString();
+    }
+    D?.(e);
+  };
+  return /* @__PURE__ */ l(re, { ...o, id: n, children: /* @__PURE__ */ l(
+    oe,
+    {
+      ...E,
+      fixedDecimalScale: d ? !1 : N,
+      ...d ? { decimalScale: void 0 } : {},
+      id: n,
+      "aria-describedby": u,
+      buttonPosition: B,
+      onValueSet: (e) => {
+        const r = v(e, i, s);
+        c(r), d && x(r.toString()), P.current?.focus();
+      },
+      renderRoot: (e) => /* @__PURE__ */ l(
+        Y,
+        {
+          getInputRef: j,
+          onValueChange: q,
+          onBlur: z,
+          onInput: G,
+          onFocus: U,
+          allowNegative: i === void 0 || i < 0,
+          isAllowed: k,
+          allowedDecimalSeparators: [".", "。", "．"],
+          ...e
+        }
+      ),
+      value: d ? w : I?.toString()
+    }
+  ) });
+}
+const oe = (t) => {
+  const [n, o] = W(!1), f = O(t.id), {
+    onValueSet: u,
+    hideControls: p,
+    buttonPosition: y,
+    min: _,
+    max: R,
+    clampBehavior: D,
+    step: C,
+    disableManualInput: g,
+    renderRightSection: B,
+    renderLeftSection: h,
+    ...N
+  } = t, S = { ...t.classNames };
+  return S.wrapper = Q(
+    S.wrapper,
+    !p && ne.wrapperWithControls
+  ), /* @__PURE__ */ l(
+    te,
+    {
+      borderRadius: "sm",
+      ...N,
+      readOnly: N.readOnly || g,
+      imeSafe: !1,
+      classNames: S,
+      id: f,
+      onMouseEnter: () => {
+        o(!0);
+      },
+      onMouseLeave: () => {
+        o(!1);
+      },
+      renderLeftSection: /* @__PURE__ */ l(F, { children: h || !p && /* @__PURE__ */ T(F, { children: [
+        /* @__PURE__ */ l($, { ...t, onValueSet: u }),
+        /* @__PURE__ */ l(A, { w: 8 })
+      ] }) }),
+      renderRightSection: /* @__PURE__ */ l(F, { children: B || !p && /* @__PURE__ */ T(F, { children: [
+        /* @__PURE__ */ l(A, { w: 8 }),
+        /* @__PURE__ */ l(
+          ee,
+          {
+            ...t,
+            onValueSet: u,
+            mouseEnter: n
+          }
+        )
+      ] }) })
+    }
+  );
+};
+export {
+  be as NumberInput
+};

package/dist/components/number-input/number-input.module.css.js

@@ -0,0 +1,8 @@
+"use client";
+const t = "_wrapperWithControls_1m7gp_2", r = {
+  wrapperWithControls: t
+};
+export {
+  r as default,
+  t as wrapperWithControls
+};

package/dist/components/number-input/number-input.types.d.ts

@@ -0,0 +1,65 @@
+import { NumericFormatProps } from 'react-number-format';
+import { InnerInputProps } from '../base-input';
+/**
+ * 边界值约束行为类型
+ * - `strict`: 严格模式，不允许输入超出 min/max 范围的值。
+ * - `blur`: 失焦时触发，当输入框失去焦点时，自动将值修正（clamp）到 min/max 范围内。
+ * - `auto`: 自动模式，在输入时自动修正值到 min/max 范围内。
+ */
+export type ClampBehavior = 'strict' | 'blur' | 'auto';
+/**
+ * 数字输入框特有的样式与控制属性
+ */
+export interface NumberInputStyleProps {
+    /**
+     * 控制加减按钮的显示位置
+     * - `both-sides`: 输入框两侧分别显示减号和加号按钮（默认）
+     * - `end-side`: 输入框右侧集中显示加减按钮（类似原生 type="number"）
+     */
+    buttonPosition?: 'both-sides' | 'end-side';
+    /** 允许输入的最小值 */
+    min?: number;
+    /** 允许输入的最大值 */
+    max?: number;
+    /**
+     * 边界值约束行为，可以是单个行为或组合数组。
+     * 默认为 `['auto', 'blur']`
+     */
+    clampBehavior?: ClampBehavior | ClampBehavior[];
+    /** 当前数值（受控模式） */
+    value?: number | string;
+    /** 值变化时的回调函数 */
+    onChange?: (value: number | string) => void;
+    /** 点击加减按钮时，每次增加或减少的步长。默认为 1 */
+    step?: number;
+    /**
+     * 仅禁止键盘手动输入，左右加减按钮仍可点击改值。
+     *
+     * 用于「只能按固定 step 调整、不允许手输」的场景（如课堂表现成绩按计分单位加减）。
+     * 与 `readOnly` / `disabled` 的区别：那两者会连加减按钮一起锁死，表达的是「整体不可编辑」。
+     */
+    disableManualInput?: boolean;
+    /**
+     * 仅在失焦时格式化。默认开启（产品默认行为）。
+     *
+     * 开启后，输入过程中不应用 decimalScale / fixedDecimalScale 补位与 clamp 修正，
+     * 所见即所输（可自由输入 `1.`、删除补位的 `0` 等）；失焦时统一做
+     * clamp（遵循 clampBehavior，配置为空数组则不钳制）并按 decimalScale 四舍五入后提交。
+     * 传 `false` 恢复 react-number-format 的边输入边格式化行为。
+     */
+    formatOnBlurOnly?: boolean;
+    /**
+     * 小数位不足时是否用 0 补齐（需配合 decimalScale 使用）。
+     * 封装层默认开启（react-number-format 原生默认为 false）：
+     * decimalScale=1 时整数 5 显示为 `5.0`。传 `false` 关闭补位。
+     */
+    fixedDecimalScale?: boolean;
+}
+/**
+ * 数字输入框组件的完整属性接口
+ * 结合了项目内部的 InputProps、react-number-format 的属性以及特有控制属性。
+ */
+export type NumberInputProps = Omit<InnerInputProps, 'value' | 'onChange'> & Omit<NumericFormatProps, keyof InnerInputProps | 'onValueChange' | 'customInput'> & NumberInputStyleProps & {
+    /** 是否隐藏加减控制按钮。设为 true 时，仅显示为一个纯净的数字输入框 */
+    hideControls?: boolean;
+};

package/dist/components/paper/index.d.ts

@@ -0,0 +1 @@
+export { Paper } from './paper';

package/dist/components/paper/index.js

@@ -0,0 +1,5 @@
+"use client";
+import { Paper as o } from "./paper.js";
+export {
+  o as Paper
+};

package/dist/components/paper/paper.d.ts

@@ -0,0 +1,7 @@
+import { LayoutElement } from '../box/box.types';
+import type { PaperProps } from '../flex/layout.types';
+/**
+ * 视觉表面容器（卡片/面板）。默认 `--t-fill-8` 主题化背景，
+ * 可配置阴影和圆角。不参与布局——内部排版请嵌套 Flex / Group / Stack。
+ */
+export declare function Paper<T extends LayoutElement = 'div'>(props: PaperProps<T>): import("react").JSX.Element;

package/dist/components/paper/paper.js

@@ -0,0 +1,15 @@
+"use client";
+import { jsx as m } from "react/jsx-runtime";
+import { clsx as i } from "clsx";
+import { Box as n } from "../box/box.js";
+import c from "./paper.module.css.js";
+function u(t) {
+  const { shadow: o, radius: r = "lg", className: s, ...a } = t, e = {
+    ...o && o !== "none" && { "data-shadow": o },
+    "data-radius": r
+  };
+  return /* @__PURE__ */ m(n, { className: i(c.root, s), ...e, ...a });
+}
+export {
+  u as Paper
+};

package/dist/components/paper/paper.module.css.js

@@ -0,0 +1,8 @@
+"use client";
+const o = "_root_9k0up_2", t = {
+  root: o
+};
+export {
+  t as default,
+  o as root
+};

package/dist/components/password-input/index.d.ts

@@ -0,0 +1,2 @@
+export { PasswordInput } from './password-input';
+export type { PasswordInputProps } from './password-input';

package/dist/components/password-input/index.js

@@ -0,0 +1,5 @@
+"use client";
+import { PasswordInput as r } from "./password-input.js";
+export {
+  r as PasswordInput
+};

package/dist/components/password-input/password-input.d.ts

@@ -0,0 +1,15 @@
+import { InnerInputProps } from '../base-input';
+/**
+ * 密码输入框组件的属性接口。
+ * 继承自内部基础输入框属性 `InnerInputProps`。
+ */
+export type PasswordInputProps = InnerInputProps;
+/**
+ * 密码输入框组件 (PasswordInput)
+ *
+ * 该组件封装了底层的 `BaseInput`，并内置了密码可见性的切换功能（显示/隐藏密码）。
+ * 同时集成了表单包装器 (`FormItemWrapper`)，支持直接传入 label、description、error 等表单常用属性。
+ *
+ * @param props 密码输入框的属性配置
+ */
+export declare const PasswordInput: (props: PasswordInputProps) => import("react").JSX.Element;

package/dist/components/password-input/password-input.js

@@ -0,0 +1,32 @@
+"use client";
+import { jsx as t } from "react/jsx-runtime";
+import { useId as d } from "@mantine/hooks";
+import { useState as n } from "react";
+import { useFormWrapperProps as f } from "../../common/use-form-wrapper-props.js";
+import "../../provider/ui-context.js";
+import { useLocale as l } from "../../provider/hooks.js";
+import { BaseInput as w } from "../base-input/base-input.js";
+import { getFormProps as u } from "../base-input/util.js";
+import { FormItemWrapper as I } from "../form-wrapper/form-item-wrapper.js";
+const L = (r) => {
+  const s = l(), [o, a] = n("password"), e = d(r.id), { wrapProps: i, rest: m, outerDescribedBy: p } = f(r, e), c = () => {
+    a(o === "password" ? "text" : "password");
+  };
+  return /* @__PURE__ */ t(I, { ...i, id: e, children: /* @__PURE__ */ t(
+    w,
+    {
+      ...m,
+      ...u(r, r.onClear),
+      imeSafe: !1,
+      type: o,
+      rightIconName: o === "password" ? "eye-close" : "eye",
+      rightIconAriaLabel: o === "password" ? s.showPassword : s.hidePassword,
+      onRightIconClick: c,
+      id: e,
+      "aria-describedby": p
+    }
+  ) });
+};
+export {
+  L as PasswordInput
+};

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

@@ -0,0 +1,17 @@
+import React from 'react';
+import { PopoverSide, PopoverTrigger } from './popover.types';
+export declare function useAnimatedMount(opened: boolean, keepMounted?: boolean): {
+    mounted: boolean;
+    animState: 'open' | 'closing';
+    handleTransitionEnd: () => void;
+};
+export declare function usePopoverFocus(trigger: PopoverTrigger, opened: boolean, animState: 'open' | 'closing', mounted: boolean, floatingRef: React.RefObject<HTMLDivElement | null>, getFloatingScopeElements: () => HTMLElement[], initialFocusRef?: React.RefObject<HTMLElement | null>, preventAutoFocus?: boolean): void;
+export declare function getFocusableElements(containers: Array<HTMLElement | null>): HTMLElement[];
+export declare function useEscapeClose(closeOnEscape: boolean, opened: boolean, close: () => void, referenceRef: React.RefObject<HTMLElement | null>, id: string, depth: number, restoreFocus?: () => void): void;
+export declare function useArrowStyle(withArrow: boolean, arrowData: {
+    x?: number;
+    y?: number;
+} | undefined, resolvedSide: PopoverSide, arrowSize: number): React.CSSProperties;
+export declare function useTriggerProps(disabled: boolean, trigger: PopoverTrigger, mergedReferenceRef: React.Ref<HTMLElement>, id: string, toggle: () => void, opened: boolean, setOpen: (next: boolean) => void, hoverTimerRef: React.RefObject<number | undefined>, userOnClick?: React.MouseEventHandler<HTMLElement>, userOnKeyDown?: React.KeyboardEventHandler<HTMLElement>): React.HTMLAttributes<HTMLElement> & {
+    ref?: React.Ref<HTMLElement>;
+};