@wisdomgarden/torque 0.1.0

package/README.md

@@ -0,0 +1,75 @@
+# @wisdomgarden/torque
+
+基于 Web 2.0 设计规范的 Wisdom Garden UI 组件库，提供统一的组件 API 与 `--t-*` 设计 token。
+
+## 安装
+
+```bash
+pnpm add @wisdomgarden/torque @wisdomgarden/torque-styles @wisdomgarden/torque-icons
+```
+
+三个包是一组:
+
+| 包                        | 作用                       | 为什么是 peerDependency                         |
+| ------------------------- | -------------------------- | ----------------------------------------------- |
+| `@wisdomgarden/torque-styles` | `--t-*` 设计 token(纯 CSS) | 组件样式全部建立在这些变量上,不引入等于没有样式 |
+| `@wisdomgarden/torque-icons`  | 图标集 + `<Icon>`          | `setIconLoader` 是模块级状态,必须单实例         |
+
+react / react-dom / `@mantine/*` 同样是 peerDependency —— 它们不打进本包产物,版本跟随宿主,保证单实例。
+
+## 接入
+
+样式入口按 `@layer reset, mantine, lib` 分层,顺序不能乱:
+
+```css
+@layer reset, mantine, lib;
+
+@import '@mantine/core/styles.css' layer(mantine);
+@import '@wisdomgarden/torque/dist/index.css';
+@import '@wisdomgarden/torque-styles';
+```
+
+`@wisdomgarden/torque-styles` 能写成裸路径,是因为它声明了 `style` 字段 —— postcss-import
+不解析 `exports` 表,认的是这个字段。
+
+组件侧挂 Provider:
+
+```tsx
+import { UiProvider } from '@wisdomgarden/torque';
+import { zhHans } from '@wisdomgarden/torque/locale';
+
+<UiProvider locale={zhHans} deviceType={deviceType}>
+  {children}
+</UiProvider>;
+```
+
+- `locale` —— 组件内部的文案(关闭、清除、暂无数据、分页……),包内附 5 个语言预设,本包零 i18n 依赖
+- `deviceType` —— 决定下拉、菜单等组件走桌面浮层还是移动端抽屉
+
+图标开箱即用,不需要注册任何东西,详见 `@wisdomgarden/torque-icons`。
+
+## 用法
+
+```tsx
+import { Button, Select, Table } from '@wisdomgarden/torque';
+```
+
+也可以按组件深路径引,少走一层桶:
+
+```tsx
+import { Button } from '@wisdomgarden/torque/components/button';
+```
+
+## 样式约定
+
+组件样式一律是组件级 CSS Module,包在 `@layer lib` 内,颜色/间距/圆角全部走 `--t-*`。
+**包内不使用 Tailwind 工具类** —— 那需要宿主的构建管线扫描生成,发布成 npm 包后无法依赖。
+
+根节点带稳定类名(如 `t-button`)供外部覆盖;因为组件样式在 `@layer lib` 里,宿主
+未分层的样式天然优先级更高,直接写 className 即可覆盖。
+
+## 构建
+
+Vite lib mode,`preserveModules` 保持一模块一文件。entry 由 `package.json` 的
+`exports` 表驱动 —— 那是"哪些路径必须存在"的契约,由它生成 entry 可以保证两者不会
+不一致。构建末尾 `verify-exports.mjs` 会把每个子路径解析一遍并落盘检查。

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

@@ -0,0 +1,60 @@
+import { UseFormReturnType } from '@mantine/form';
+import { Ref } from 'react';
+/** 组件基础尺寸定义，包含极小(xs)到极大(xl)的所有选项 */
+export type ComponentSizeBase = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+/** 精简版组件尺寸定义，去除了极小(xs)和极大(xl)，常用于输入框、选择器等 */
+export type SimpleComponentSizeBase = Exclude<ComponentSizeBase, 'xs' | 'xl'>;
+/** 按钮组件尺寸 */
+export type ButtonSize = ComponentSizeBase;
+/** 输入框组件尺寸 */
+export type InputSize = SimpleComponentSizeBase;
+/** 下拉选择器组件尺寸 */
+export type SelectSize = SimpleComponentSizeBase;
+/** 标签页组件尺寸 */
+export type TabSize = SimpleComponentSizeBase;
+/** 图标按钮(IconButton)的主题颜色 */
+export type IconButtonColor = 'brand' | 'red' | 'black' | 'white';
+/**
+ * 根节点类名属性
+ * 用于外部传入自定义类名
+ */
+export interface RootClassNameProps {
+    className?: string;
+}
+export interface InputWrapProps {
+    /** 用于提示或警告的文本，支持 ReactNode 以嵌入链接、图标等 */
+    description?: string | React.ReactNode;
+    /** 发生错误时显示的提示信息，或布尔值标识错误状态 */
+    error?: boolean | string;
+    /** 表单字段的名称/标签，支持 ReactNode 以嵌入图标等 */
+    label?: string | React.ReactNode;
+    /** true: 必填, false: 非必填 */
+    required?: boolean;
+    /** true: 显示必填星号 (*), false: 不显示星号 */
+    withAsterisk?: boolean;
+    /** 布局方式，vertical: 标签在上方, horizontal: 标签在左侧。默认值为 vertical */
+    layout?: 'vertical' | 'horizontal';
+    /** 当布局为 horizontal 时，此属性代表左侧标签区域的宽度，默认值为 70 */
+    labelWidth?: string | number;
+    /** true: 在没有星号时仍保留星号占用的宽度空间, false: 不保留。默认值为 false */
+    keepAsteriskWidth?: boolean;
+    /** 当 borderRadius 为 'full' 时，标签会带有 4px 的左边距 */
+    borderRadius?: 'full' | 'sm';
+    /** 标签的自定义 className */
+    labelClassName?: string;
+    /** 错误提示节点的自定义 className */
+    errorClassName?: string;
+    /** 水平布局下标签容器的自定义 style，与默认 style 合并以覆盖 width / maxWidth / paddingTop 等 */
+    labelWrapperStyle?: React.CSSProperties;
+}
+export interface FormProps {
+    /** 传入form表单对象，内部会自动处理表单属性 */
+    form?: UseFormReturnType<any, (values: any) => any>;
+    /** 字段的属性名 */
+    fieldName?: string;
+}
+export interface RefProps<T extends HTMLElement> {
+    /** React ref 引用，用于访问底层 DOM 元素或组件实例 */
+    ref?: Ref<T | null>;
+}
+export type CommonColor = 'red' | 'orange' | 'yellow' | 'green' | 'brand' | 'blue' | 'air-blue' | 'violet' | 'grape' | 'magenta' | 'gray';

package/dist/common/components.types.js

@@ -0,0 +1 @@
+"use client";

package/dist/common/dayjs.d.ts

@@ -0,0 +1,7 @@
+import day from 'dayjs';
+/**
+ * 组件库内的 dayjs 实例：与宿主全局 dayjs 包装一致，默认把时间转换到本地时区。
+ * （date-picker 的显示/解析语义依赖 .tz() 的默认行为）
+ */
+export declare const dayjs: (date?: Parameters<typeof day>[0]) => day.Dayjs;
+export type { Dayjs } from 'dayjs';

package/dist/common/dayjs.js

@@ -0,0 +1,10 @@
+"use client";
+import t from "dayjs";
+import o from "dayjs/plugin/timezone";
+import m from "dayjs/plugin/utc";
+t.extend(m);
+t.extend(o);
+const d = (e) => t(e).tz();
+export {
+  d as dayjs
+};

package/dist/common/use-css-variable-value.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 获取 CSS 变量的实际值
+ * @param cssVariable - CSS 变量名称或 var() 格式的字符串
+ * @returns CSS 变量的解析值，如果解析失败则返回原始值
+ */
+export declare const useCssVariableValue: (cssVariable: string) => string;

package/dist/common/use-css-variable-value.js

@@ -0,0 +1,23 @@
+"use client";
+import { useComputedColorScheme as c } from "@mantine/core";
+import { useState as n, useEffect as l } from "react";
+const S = (e) => {
+  const [r, o] = n(""), u = c();
+  return l(() => {
+    try {
+      if (e.startsWith("var(")) {
+        const t = e.match(/var\((--[^)]+)\)/)?.[1];
+        if (t) {
+          const m = getComputedStyle(document.documentElement).getPropertyValue(t).trim() || e;
+          o(m);
+        }
+      } else
+        o(e);
+    } catch (t) {
+      console.error("Error getting CSS variable:", t), o(e);
+    }
+  }, [e, u]), r;
+};
+export {
+  S as useCssVariableValue
+};

package/dist/common/use-css-variable-values.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 批量获取多个 CSS 变量的实际值。
+ *
+ * 相比多次调用 `useCssVariableValue`，此 hook 在一次 effect 内只调用一次
+ * `getComputedStyle`，并合并为单个 state，适合图表等一次需要读取大量颜色变量的场景。
+ *
+ * @param cssVariables - 键为业务别名、值为变量名或 `var()` 字符串的对象
+ * @returns 与入参同名的解析结果对象，解析失败时回退为原始值
+ */
+export declare const useCssVariableValues: <K extends string>(cssVariables: Record<K, string>) => Record<K, string>;

package/dist/common/use-css-variable-values.js

@@ -0,0 +1,25 @@
+"use client";
+import { useComputedColorScheme as l } from "@mantine/core";
+import { useState as y, useEffect as S } from "react";
+const v = (o) => {
+  const m = l(), r = Object.keys(o), u = r.map((e) => `${e}:${o[e]}`).join("|"), [s, p] = y(
+    () => Object.fromEntries(r.map((e) => [e, ""]))
+  );
+  return S(() => {
+    try {
+      const e = getComputedStyle(document.documentElement), f = (t) => {
+        if (!t.startsWith("var(")) return t;
+        const c = t.match(/var\((--[^)]+)\)/)?.[1];
+        return c && e.getPropertyValue(c).trim() || t;
+      }, n = {};
+      for (const t of Object.keys(o))
+        n[t] = f(o[t]);
+      p(n);
+    } catch (e) {
+      console.error("Error getting CSS variables:", e);
+    }
+  }, [u, m]), s;
+};
+export {
+  v as useCssVariableValues
+};

package/dist/common/use-form-wrapper-props.d.ts

@@ -0,0 +1,48 @@
+import { GetInputPropsReturnType } from '@mantine/form';
+import { FormProps, InputWrapProps } from './components.types';
+/**
+ * 用于从表单组件属性中获取 InputWrap 属性的工具函数。
+ *
+ * @param props - 表单组件属性
+ * @param id - 外部已生成的稳定 id（来自 useId），用于派生 errorId / descriptionId
+ *             以及合并 aria-describedby。不传时仅做 props 拆分，不生成 a11y 关联。
+ */
+export declare const useFormWrapperProps: <T extends FormProps & InputWrapProps & {
+    className?: string;
+}>(props: T, id?: string) => {
+    wrapProps: {
+        description: import("react").ReactNode;
+        label: import("react").ReactNode;
+        required: boolean | undefined;
+        withAsterisk: boolean | undefined;
+        labelWidth: string | number | undefined;
+        layout: "vertical" | "horizontal" | undefined;
+        keepAsteriskWidth: boolean | undefined;
+        borderRadius: "sm" | "full" | undefined;
+        labelWrapperStyle: import("react").CSSProperties | undefined;
+        className: string | undefined;
+        error: any;
+        errorId: string | undefined;
+        descriptionId: string | undefined;
+        labelId: string | undefined;
+        labelClassName: string | undefined;
+        errorClassName: string | undefined;
+    };
+    rest: Omit<T, "error" | "form" | "label" | "className" | "description" | "required" | "withAsterisk" | "labelWidth" | "layout" | "keepAsteriskWidth" | "borderRadius" | "labelWrapperStyle" | "fieldName" | "labelClassName" | "errorClassName"> & {
+        borderRadius: "sm" | "full" | undefined;
+        error: any;
+        onChange?: any;
+        value?: any;
+        defaultValue?: any;
+        checked?: any;
+        defaultChecked?: any;
+        onFocus?: any;
+        onBlur?: any;
+        required: boolean | undefined;
+    };
+    formProps: GetInputPropsReturnType | undefined;
+    outerDescribedBy: string | undefined;
+    errorId: string | undefined;
+    descriptionId: string | undefined;
+    labelId: string | undefined;
+};

package/dist/common/use-form-wrapper-props.js

@@ -0,0 +1,59 @@
+"use client";
+const $ = (l, r) => {
+  const {
+    description: a,
+    error: u,
+    label: i,
+    required: n,
+    withAsterisk: m,
+    labelWidth: f,
+    layout: y,
+    keepAsteriskWidth: v,
+    borderRadius: c,
+    labelWrapperStyle: P,
+    className: I,
+    form: d,
+    fieldName: p,
+    labelClassName: N,
+    errorClassName: W,
+    ...h
+  } = l;
+  let e;
+  d && p && (e = { ...d.getInputProps(p) });
+  const o = e?.error ?? u, k = l["aria-describedby"], s = r && o && typeof o == "string" ? `${r}-error` : void 0, t = r && a ? `${r}-description` : void 0, b = r && i ? `${r}-label` : void 0, w = [k, s, t].filter(Boolean).join(" ") || void 0;
+  return {
+    wrapProps: {
+      description: a,
+      label: i,
+      required: n,
+      withAsterisk: m,
+      labelWidth: f,
+      layout: y,
+      keepAsteriskWidth: v,
+      borderRadius: c,
+      labelWrapperStyle: P,
+      className: I,
+      error: o,
+      errorId: s,
+      descriptionId: t,
+      labelId: b,
+      labelClassName: N,
+      errorClassName: W
+    },
+    rest: {
+      ...h,
+      required: n,
+      ...e,
+      borderRadius: c,
+      error: o
+    },
+    formProps: e,
+    outerDescribedBy: w,
+    errorId: s,
+    descriptionId: t,
+    labelId: b
+  };
+};
+export {
+  $ as useFormWrapperProps
+};

package/dist/common/use-ime-safe-input.d.ts

@@ -0,0 +1,10 @@
+import type { ChangeEvent, CompositionEvent } from 'react';
+type InputLikeElement = HTMLInputElement | HTMLTextAreaElement;
+type InputValue = string | number | readonly string[] | undefined;
+export declare function useImeSafeInput(externalValue: InputValue, commit: (value: string) => void): {
+    value: InputValue;
+    onChange(event: ChangeEvent<InputLikeElement>): void;
+    onCompositionStart(): void;
+    onCompositionEnd(event: CompositionEvent<InputLikeElement>): void;
+};
+export {};

package/dist/common/use-ime-safe-input.js

@@ -0,0 +1,23 @@
+"use client";
+import { useRef as s, useState as a } from "react";
+function i(l, u) {
+  const n = s(!1), [r, t] = a(null);
+  return {
+    value: r ?? l,
+    onChange(o) {
+      const e = o.currentTarget.value;
+      n.current ? t(e) : (r !== null && t(null), u(e));
+    },
+    onCompositionStart() {
+      n.current = !0;
+    },
+    onCompositionEnd(o) {
+      n.current = !1;
+      const e = o.currentTarget.value;
+      t(null), u(e);
+    }
+  };
+}
+export {
+  i as useImeSafeInput
+};

package/dist/common/use-notification-a11y.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 用于处理notification，message的无障碍属性的工具函数
+ */
+export declare const useNotificationA11y: () => Record<string, string>;

package/dist/common/use-notification-a11y.js

@@ -0,0 +1,18 @@
+"use client";
+import "../provider/ui-context.js";
+import "react/jsx-runtime";
+import "react";
+import { useLocale as r } from "../provider/hooks.js";
+const s = () => {
+  const o = r();
+  return {
+    success: o.success,
+    info: o.tip,
+    warning: o.warning,
+    help: o.tip,
+    error: o.error
+  };
+};
+export {
+  s as useNotificationA11y
+};

package/dist/common/use-sticky-box.d.ts

@@ -0,0 +1,9 @@
+import { ComponentProps } from 'react';
+export type StickyBoxConfig = {
+    offsetTop?: number;
+    offsetBottom?: number;
+    bottom?: boolean;
+};
+export type UseStickyBoxOptions = StickyBoxConfig;
+export declare const useStickyBox: ({ offsetTop, offsetBottom, bottom, }?: StickyBoxConfig) => import("react").Dispatch<import("react").SetStateAction<HTMLElement | null>>;
+export type StickyBoxCompProps = StickyBoxConfig & Pick<ComponentProps<'div'>, 'children' | 'className' | 'style'>;

package/dist/common/use-sticky-box.js

@@ -0,0 +1,217 @@
+"use client";
+import { useState as V, useEffect as D } from "react";
+const j = (t) => {
+  let e = t;
+  for (; e = e.parentElement; ) {
+    const s = getComputedStyle(e, null).getPropertyValue(
+      "overflow-y"
+    );
+    if (e === document.body) return window;
+    if (s === "auto" || s === "scroll" || s === "overlay")
+      return e;
+  }
+  return window;
+}, M = (t) => t.firstChild ? t.firstChild.offsetParent === t : !0, z = (t, e) => {
+  let s = t, n = 0;
+  M(e) || (n += t.offsetTop - e.offsetTop, e = t.offsetParent, n += -t.offsetTop);
+  do
+    n += s.offsetTop, s = s.offsetParent;
+  while (s && s !== e);
+  return n;
+}, I = (t) => {
+  let e = t.parentElement;
+  for (; e && getComputedStyle(e, null).getPropertyValue("display") === "contents"; )
+    e = e.parentElement;
+  return e || window;
+};
+let S = null;
+typeof CSS < "u" && CSS.supports && (CSS.supports("position", "sticky") ? S = "sticky" : CSS.supports("position", "-webkit-sticky") && (S = "-webkit-sticky"));
+let C = !1;
+try {
+  const t = Object.defineProperty({}, "passive", {
+    get() {
+      C = { passive: !0 };
+    }
+  }), e = () => {
+  };
+  window.addEventListener("testPassive", e, t), window.removeEventListener("testPassive", e, t);
+} catch {
+}
+const L = (t) => {
+  const { el: e, onChange: s, unsubs: n, measure: i } = t;
+  if (e === window) {
+    const l = () => ({
+      top: 0,
+      left: 0,
+      height: window.innerHeight,
+      width: window.innerWidth
+    }), r = i(l()), u = () => {
+      Object.assign(r, i(l())), s();
+    };
+    return window.addEventListener("resize", u, C), n.push(() => window.removeEventListener("resize", u)), r;
+  } else {
+    const l = i(e.getBoundingClientRect()), r = () => {
+      Object.assign(
+        l,
+        i(e.getBoundingClientRect())
+      ), s();
+    }, u = new ResizeObserver(r);
+    return u.observe(e), n.push(() => u.disconnect()), l;
+  }
+}, N = (t) => {
+  const e = getComputedStyle(t, null), s = parseInt(
+    e.getPropertyValue("padding-top"),
+    10
+  ), n = parseInt(
+    e.getPropertyValue("padding-bottom"),
+    10
+  );
+  return { top: s, bottom: n };
+}, A = (t, e, s) => {
+  const { bottom: n, offsetBottom: i, offsetTop: l } = s, r = j(t);
+  let u = !1;
+  const E = () => {
+    u || requestAnimationFrame(() => {
+      const o = k();
+      if (o !== d)
+        m(o);
+      else if (o === 1 && !n) {
+        const { height: f } = w, { height: a } = P;
+        t.style.top = `${f - a - i}px`;
+      } else if (o === 2) {
+        const { height: f, offsetTop: a } = w, { height: p, naturalTop: c } = b, { height: y } = P, h = Math.max(
+          0,
+          a + g + f - (c + y + i)
+        );
+        if (n) {
+          const v = Math.max(
+            0,
+            p - y - h
+          );
+          t.style.bottom = `${v}px`;
+        } else
+          t.style.top = `${h}px`;
+      }
+      u = !1;
+    }), u = !0;
+  };
+  let g = r === window ? window.scrollY : r.scrollTop;
+  const $ = (o) => {
+    const { offsetTop: f, height: a } = w, { naturalTop: p } = b, { height: c } = P;
+    return o + f + a >= p + c + x + i;
+  }, k = () => {
+    const { height: o } = w, { height: f } = P;
+    return f + l + i <= o ? 3 : $(g) ? 1 : 2;
+  }, R = r !== window && M(r), w = L({
+    el: r,
+    onChange: E,
+    unsubs: e,
+    measure: ({ height: o, top: f }) => ({
+      height: o,
+      offsetTop: R ? f : 0
+    })
+  }), T = I(t), O = T === window ? { top: 0, bottom: 0 } : N(T), b = L({
+    el: T,
+    onChange: E,
+    unsubs: e,
+    measure: ({ height: o }) => ({
+      height: o - O.top - O.bottom,
+      naturalTop: T === window ? 0 : z(T, r) + O.top + w.offsetTop
+    })
+  }), P = L({
+    el: t,
+    onChange: E,
+    unsubs: e,
+    measure: ({ height: o }) => ({ height: o })
+  });
+  let x = 0, d = k();
+  const m = (o) => {
+    const f = d;
+    if (d = o, f === 2 && (x = -1), o === 3) {
+      t.style.position = S, n ? t.style.bottom = `${i}px` : t.style.top = `${l}px`;
+      return;
+    }
+    const { height: a, offsetTop: p } = w, { height: c, naturalTop: y } = b, { height: h } = P;
+    if (o === 2)
+      if (t.style.position = "relative", x = f === 0 ? Math.max(
+        0,
+        p + g - y + l
+      ) : Math.max(
+        0,
+        p + g + a - (y + h + i)
+      ), n) {
+        const v = Math.max(
+          0,
+          c - h - x
+        );
+        t.style.bottom = `${v}px`;
+      } else
+        t.style.top = `${x}px`;
+    else
+      t.style.position = S, o === 1 ? n ? t.style.bottom = `${i}px` : t.style.top = `${a - h - i}px` : n ? t.style.bottom = `${a - h - i}px` : t.style.top = `${l}px`;
+  };
+  m(d);
+  const B = (o) => {
+    if (o === g) return;
+    const f = o - g;
+    if (g = o, d === 3) return;
+    const { offsetTop: a, height: p } = w, { naturalTop: c, height: y } = b, { height: h } = P;
+    if (f > 0)
+      if (d === 0) {
+        if (o + a + l > c) {
+          const v = Math.max(
+            0,
+            a + g - c + l
+          );
+          o + a + p <= c + h + v + i ? m(
+            2
+            /* relative */
+          ) : m(
+            1
+            /* stickyBottom */
+          );
+        }
+      } else d === 2 && $(o) && m(
+        1
+        /* stickyBottom */
+      );
+    else if (d === 1) {
+      if (a + o + p < c + y + i) {
+        const v = Math.max(
+          0,
+          a + g + p - (c + h + i)
+        );
+        a + o + l >= c + v ? m(
+          2
+          /* relative */
+        ) : m(
+          0
+          /* stickyTop */
+        );
+      }
+    } else d === 2 && a + o + l < c + x && m(
+      0
+      /* stickyTop */
+    );
+  }, H = r === window ? () => B(window.scrollY) : () => B(r.scrollTop);
+  r.addEventListener("scroll", H, C), r.addEventListener("mousewheel", H, C), e.push(
+    () => r.removeEventListener("scroll", H),
+    () => r.removeEventListener("mousewheel", H)
+  );
+}, F = ({
+  offsetTop: t = 0,
+  offsetBottom: e = 0,
+  bottom: s = !1
+} = {}) => {
+  const [n, i] = V(null);
+  return D(() => {
+    if (!n || !S) return;
+    const l = [];
+    return A(n, l, { offsetBottom: e, offsetTop: t, bottom: s }), () => {
+      l.forEach((r) => r());
+    };
+  }, [n, e, t, s]), i;
+};
+export {
+  F as useStickyBox
+};

package/dist/common/util.d.ts

@@ -0,0 +1,5 @@
+import { TransitionProps } from '../components/_inner/base-select/common/select.types';
+/**
+ * 全局统一的 combobox 过渡效果
+ */
+export declare const comboboxTransitionProps: TransitionProps;

package/dist/common/util.js

@@ -0,0 +1,14 @@
+"use client";
+const o = {
+  transition: {
+    in: { opacity: 1, transform: "scaleY(1)" },
+    out: { opacity: 0, transform: "scaleY(0)" },
+    common: { transformOrigin: "top" },
+    transitionProperty: "transform, opacity"
+  },
+  duration: 200,
+  timingFunction: "ease"
+};
+export {
+  o as comboboxTransitionProps
+};

package/dist/components/_inner/base-select/common/searchable.d.ts

@@ -0,0 +1,5 @@
+import { SelectOptions } from './select.types';
+/** 低于该选项数的短列表一屏可览，搜索框反而是干扰。 */
+export declare const SEARCHABLE_OPTION_THRESHOLD = 10;
+/** 显式传入的 `searchable` 优先；未传时按选项数量自动判断。 */
+export declare const resolveSearchable: (searchable: boolean | undefined, options: SelectOptions[] | undefined) => boolean;

package/dist/components/_inner/base-select/common/searchable.js

@@ -0,0 +1,6 @@
+"use client";
+const H = 10, O = (e, E) => e ?? (E?.length ?? 0) >= 10;
+export {
+  H as SEARCHABLE_OPTION_THRESHOLD,
+  O as resolveSearchable
+};