haze-ui 1.25.0 → 1.26.0

package/dist/types/hooks/useDebouncedCallback.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 返回 `fn` 的防抖版本（尾触发）：窗口内连续调用只在最后一次调用
+ * 的窗口到期后执行一次，参数取最后一次调用。
+ *
+ * ```tsx
+ * const save = useDebouncedCallback((draft) => persist(draft), 500);
+ * <Textarea onChange={(e) => save(e.target.value)} />;
+ * ```
+ *
+ * - `fn` 与 `delayMs` 都经 ref 透传：调用时始终执行「最新一次渲染」
+ *   的闭包（事件回调里读到最新 state，无需把 fn 写进依赖）。
+ * - 返回的函数引用跨渲染稳定（空依赖 `useCallback` + ref 计时），
+ *   可安全放进子组件的 props 比较 / effect 依赖。
+ * - `delayMs` 变更即时生效：下一次调度起用新窗口。
+ * - 卸载时取消挂起的计时器且不 flush——尾调用不会在组件消失后触发。
+ *
+ * @param fn 需要防抖的函数（引用可任意变化）。
+ * @param delayMs 防抖窗口（毫秒）。
+ * @returns 引用稳定的防抖函数。
+ */
+export declare function useDebouncedCallback<A extends unknown[]>(fn: (...args: A) => void, delayMs: number): (...args: A) => void;

package/dist/types/hooks/useDebouncedValue.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 返回 `value` 的防抖镜像：值停止变化 `delayMs` 后才同步到最新值。
+ *
+ * ```tsx
+ * const debouncedQuery = useDebouncedValue(query, 300);
+ * useEffect(() => { search(debouncedQuery); }, [debouncedQuery]);
+ * ```
+ *
+ * - 内部派生状态（镜像没有「父组件控制」的语义，不走 useControl）。
+ * - 挂载首帧直接返回当时的 `value`（不防抖）；窗口内快速变化的
+ *   中间值永远不会暴露。
+ * - `delayMs` 变更即时生效：计时器依赖 `[value, delayMs]`，任一变化
+ *   都重启窗口。
+ * - 卸载清理计时器，不会对已卸载组件 setState。
+ *
+ * @param value 需要防抖的值。
+ * @param delayMs 防抖窗口（毫秒）。
+ * @returns 防抖后的值。
+ */
+export declare function useDebouncedValue<T>(value: T, delayMs: number): T;

package/dist/types/hooks/useMediaQuery.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 订阅一条 CSS 媒体查询，返回当前是否匹配。
+ *
+ * ```tsx
+ * const isWide = useMediaQuery('(min-width: 768px)');
+ * ```
+ *
+ * - 底层 `window.matchMedia` + `useSyncExternalStore`；query 变化时
+ *   自动换订阅。
+ * - SSR：服务端渲染与 hydration 首帧恒返回 `false`（不访问
+ *   `window`、不建立订阅）；水合后与真实结果不一致时以一次额外
+ *   渲染收敛，无 hydration mismatch。
+ *
+ * @param query CSS 媒体查询字符串，如 `'(min-width: 768px)'`。
+ * @returns 当前是否匹配（SSR 阶段恒为 `false`）。
+ */
+export declare function useMediaQuery(query: string): boolean;

package/dist/types/hooks/usePrefersReducedMotion.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 用户是否开启了系统级「减少动态效果」偏好（`prefers-reduced-motion`）。
+ *
+ * 与 tokens 的 `@media (prefers-reduced-motion: reduce)` 全局 CSS 降级
+ * （duration → 0ms）呼应：CSS 侧管组件自身的过渡/动画，本 hook 供
+ * JS 侧编排决策——跳过视差、自动轮播、滚动驱动动画等 CSS 覆盖不到
+ * 的动效。
+ *
+ * - SSR：继承 useMediaQuery 语义——服务端渲染与 hydration 首帧恒
+ *   `false`，水合后以一次额外渲染收敛，无 hydration mismatch。
+ *
+ * @returns 用户偏好减少动态效果时为 `true`。
+ */
+export declare function usePrefersReducedMotion(): boolean;

package/dist/types/index.d.ts

@@ -123,6 +123,8 @@ export { PasswordInput, PasswordInputCore } from './components/PasswordInput';
 export type { PasswordInputProps, PasswordInputCoreProps } from './components/PasswordInput';
 export { TagInput, TagInputCore } from './components/TagInput';
 export type { TagInputProps, TagInputCoreProps } from './components/TagInput';
+export { Mentions, MentionsCore } from './components/Mentions';
+export type { MentionsProps, MentionsCoreProps, MentionsOption } from './components/Mentions';
 export { InlineEdit } from './components/InlineEdit';
 export type { InlineEditProps } from './components/InlineEdit';
 export { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator } from './components/DropdownMenu';
@@ -154,10 +156,10 @@ export type { BottomSheetProps } from './components/BottomSheet';
 export { SwipeAction } from './components/SwipeAction';
 export type { SwipeActionProps } from './components/SwipeAction';
 export { default as LocaleProvider, useStrings } from './components/LocaleProvider';
-export { defaultStrings } from './components/LocaleProvider';
+export { defaultStrings, enUS, zhCN } from './components/LocaleProvider';
 export type { LocaleProviderProps, HazeStrings } from './components/LocaleProvider';
 export { DataTable } from './components/DataTable';
-export type { DataTableProps, DataTableColumnDef, DataTableColumnMeta } from './components/DataTable';
+export type { DataTableProps, DataTableColumnDef, DataTableColumnMeta, DataTableVirtualized, } from './components/DataTable';
 export { Kbd } from './components/Kbd';
 export type { KbdProps } from './components/Kbd';
 export { AvatarGroup } from './components/AvatarGroup';
@@ -204,7 +206,8 @@ export { LogViewer } from './components/LogViewer';
 export type { LogViewerProps, LogEntry, LogLevel } from './components/LogViewer';
 export { AsyncSection } from './components/AsyncSection';
 export type { AsyncSectionProps } from './components/AsyncSection';
-export { useTitle } from './hooks';
+export { useTitle, useMediaQuery, usePrefersReducedMotion, useDebouncedValue, useDebouncedCallback, useClipboard, } from './hooks';
+export type { UseClipboardResult } from './hooks';
 export { FormItem } from './form';
 export type { FieldValidator, FormItemAsProps, FormItemBinding, FormItemOwnProps, FormItemProps, FormItemRawElement, FormItemRawElementBinding, FormInstance, PathValueOf, } from './form';
 export { useControl } from 'react-use-control';

package/dist/utils/classnames.js

@@ -1,3 +1,4 @@
+"use client";
 //#region src/lib/utils/classnames.ts
 function e(...e) {
 	let t = [], n = (e) => {

package/dist/utils/collision.js

@@ -1,3 +1,4 @@
+"use client";
 //#region src/lib/utils/collision.ts
 function e(e) {
 	return typeof e == "number" ? {

package/dist/utils/floating.js

@@ -1,4 +1,5 @@
 
+"use client";
 import { classnames as e } from "./classnames.js";
 import { whenExitSettles as t } from "./presence.js";
 import { computeFloatingPosition as n, resolvePadding as r } from "./collision.js";

package/dist/utils/focus-scope.js

@@ -1,3 +1,4 @@
+"use client";
 import { focusFirst as e, getTabbables as t } from "./focus.js";
 import { useCallback as n, useEffect as r, useLayoutEffect as i, useRef as a } from "react";
 //#region src/lib/utils/focus-scope.ts

package/dist/utils/focus.js

@@ -1,3 +1,4 @@
+"use client";
 //#region src/lib/utils/focus.ts
 var e = [
 	"a[href]:not([disabled])",

package/dist/utils/menuKeyboard.js

@@ -1,3 +1,4 @@
+"use client";
 import { useCallback as e, useEffect as t, useRef as n } from "react";
 //#region src/lib/utils/menuKeyboard.ts
 var r = 500, i = "[role=\"menuitem\"]:not([disabled])";

package/dist/utils/presence.js

@@ -1,3 +1,4 @@
+"use client";
 import { cloneElement as e, useEffect as t, useRef as n, useState as r } from "react";
 //#region src/lib/utils/presence.tsx
 var i = /* @__PURE__ */ new WeakMap();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "haze-ui",
-  "version": "1.25.0",
+  "version": "1.26.0",
   "type": "module",
   "description": "A React UI component library powered by react-use-control and Linaria",
   "main": "./dist/index.js",
@@ -41,7 +41,7 @@
   "scripts": {
     "start": "vite",
     "build": "BUILD_LIB=true vite build && node scripts/split-css.mjs && node scripts/generate-registry.mjs && tsc -p tsconfig.lib.json && tsc-alias -p tsconfig.lib.json",
-    "build:demo": "BABEL_ENV=development BUILD_DEMO=true vite build && cp dist/index.html dist/404.html",
+    "build:demo": "BABEL_ENV=development BUILD_DEMO=true vite build && cp dist/index.html dist/404.html && cp llms.txt dist/",
     "commit": "lint-staged && git-cz -n",
     "coverage": "vitest run --coverage",
     "lint": "eslint --fix src *.mjs",
@@ -78,11 +78,19 @@
   "author": "wmzy",
   "license": "MIT",
   "peerDependencies": {
-    "react": "^19.0.0"
+    "@tanstack/react-table": "^9.2.4",
+    "react": "^19.0.0",
+    "react-f0rm": "^1.1.1"
+  },
+  "peerDependenciesMeta": {
+    "@tanstack/react-table": {
+      "optional": true
+    },
+    "react-f0rm": {
+      "optional": true
+    }
   },
   "dependencies": {
-    "@tanstack/react-table": "^9.2.4",
-    "react-f0rm": "^1.1.1",
     "react-use-control": "^1.6.0"
   },
   "devDependencies": {
@@ -90,7 +98,6 @@
     "@babel/core": "^8.0.1",
     "@babel/preset-env": "^8.0.2",
     "@babel/preset-typescript": "^8.0.1",
-    "@faker-js/faker": "^10.6.0",
     "@for-fun/event-emitter": "^1.1.0",
     "@linaria/core": "^8.2.0",
     "@native-router/core": "^1.16.1",
@@ -98,13 +105,13 @@
     "@playwright/test": "^1.62.1",
     "@size-limit/esbuild": "^13.0.3",
     "@size-limit/file": "^13.0.3",
+    "@tanstack/react-table": "^9.2.4",
     "@testing-library/jest-dom": "^7.0.1",
     "@testing-library/react": "^16.3.3",
     "@testing-library/user-event": "^14.6.7",
     "@types/culori": "^4.0.1",
     "@types/jest-axe": "^3.5.9",
     "@types/node": "^26.4.1",
-    "@types/ramda": "^0.32.0",
     "@types/react": "^19.2.18",
     "@types/react-dom": "^19.2.7",
     "@vitejs/plugin-react": "^6.1.1",
@@ -116,24 +123,19 @@
     "commitizen": "^4.3.2",
     "core-js": "^3.50.0",
     "culori": "^4.0.2",
-    "date-fns": "^4.4.0",
     "eslint": "^10.9.1",
     "eslint-plugin-compat": "^7.0.2",
     "gh-pages": "^6.3.0",
     "husky": "^9.1.7",
     "jest-axe": "^11.0.0",
     "jsdom": "^30.0.1",
-    "json-schema-faker": "^0.6.3",
     "lint-staged": "^17.4.1",
     "lucide-react": "^1.41.0",
     "prettier": "^3.9.6",
-    "qss": "^3.0.0",
-    "ramda": "^0.32.0",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
+    "react-f0rm": "^1.1.1",
     "react-icons": "^5.7.0",
-    "react-toolroom": "^1.1.0",
-    "rollup-plugin-type-as-json-schema": "^0.2.6",
     "semantic-release": "^25.0.9",
     "size-limit": "^13.0.3",
     "terser": "^5.51.2",