@dofe/sso-hooks 0.1.5

package/README.md

@@ -0,0 +1,248 @@
+# @repo/hooks - React Hooks 工具库
+
+通用的 React Hooks 工具集合，支持国际化验证、错误处理、键盘快捷键等场景。
+
+## 安装
+
+### Workspace 内使用
+
+```json
+{
+  "dependencies": {
+    "@repo/hooks": "workspace:*"
+  }
+}
+```
+
+### 从 npmjs 使用
+
+```json
+{
+  "dependencies": {
+    "@dofe/sso-hooks": "^0.1.0"
+  }
+}
+```
+
+## 包含的 Hooks
+
+| Hook                     | 描述                                          | 依赖                     |
+| ------------------------ | --------------------------------------------- | ------------------------ |
+| `useDebouncedValue`      | 防抖值更新                                    | react                    |
+| `useHotkeys`             | 键盘快捷键绑定                                | react                    |
+| `usePermissions`         | 权限管理                                      | react                    |
+| `useAspectRatioSize`     | 宽高比尺寸计算                                | react                    |
+| `useOperationFeedback`   | 统一的操作反馈（toast）                       | react, sonner, next-intl |
+| `useErrorHandler`        | 统一错误处理，自动分类显示                    | react, sonner, next-intl |
+| `useI18nValidation`      | 国际化表单验证 Zod Schema 生成                | react, zod, next-intl    |
+
+## 使用示例
+
+### useDebouncedValue
+
+```typescript
+import { useDebouncedValue } from '@repo/hooks';
+
+const [search, setSearch] = useState('');
+const debouncedSearch = useDebouncedValue(search, 500);
+
+// debouncedSearch 会在 500ms 后更新
+```
+
+### useHotkeys
+
+```typescript
+import { useHotkeys } from '@repo/hooks';
+
+useHotkeys('ctrl+s', (event) => {
+  event.preventDefault();
+  handleSave();
+}, { scope: 'editor' });
+```
+
+### useI18nValidation
+
+```typescript
+import { useI18nValidation, createPasswordConfirmSchema } from '@repo/hooks';
+
+const v = useI18nValidation();
+
+// 使用预定义验证器
+const schema = z.object({
+  email: v.email(),
+  phone: v.phone(),
+  password: v.password({ min: 6, requireStrong: true }),
+  username: v.required('username'),
+  bio: v.string('description', { max: 200 }),
+});
+
+// 密码确认 schema
+const passwordSchema = createPasswordConfirmSchema(v, {
+  passwordField: 'password',
+  confirmField: 'confirmPassword',
+  minLength: 8,
+});
+```
+
+### useOperationFeedback
+
+```typescript
+import { useOperationFeedback } from '@repo/hooks';
+
+const { success, error, warning, info, loading, promise } = useOperationFeedback();
+
+success('操作成功');
+error('操作失败');
+
+// Promise toast
+const result = await promise(
+  saveData(),
+  {
+    loading: '保存中...',
+    success: '保存成功',
+    error: '保存失败',
+  }
+);
+```
+
+### useErrorHandler
+
+```typescript
+import { useErrorHandler, NetworkError, ValidationError } from '@repo/hooks';
+
+const handleError = useErrorHandler();
+
+try {
+  await fetchData();
+} catch (error) {
+  if (!response.ok) {
+    handleError(new NetworkError('网络错误'));
+  } else {
+    handleError(new ValidationError('验证失败'));
+  }
+}
+```
+
+## 目录结构
+
+```
+src/
+├── useDebouncedValue.ts     # 防抖 hook
+├── useHotkeys.ts            # 键盘快捷键 hook
+├── usePermissions.ts        # 权限 hook
+├── useAspectRatioSize.ts    # 宽高比尺寸 hook
+├── useOperationFeedback.ts  # 操作反馈 hook
+├── useErrorHandler.ts       # 错误处理 hook
+├── useI18nValidation.ts     # 国际化验证 hook
+└── index.ts                 # 导出汇总
+```
+
+## 构建
+
+```bash
+pnpm --filter @repo/hooks build
+```
+
+---
+
+## NPM 发布流程
+
+### 发布说明
+
+本包在 workspace 内使用名称 `@repo/hooks`，发布到 npmjs 时使用名称 `@dofe/sso-hooks`。
+
+发布脚本会自动处理名称转换：
+
+- `prepack` - 发布前将名称改为 `@dofe/sso-hooks`，移除 workspace 依赖
+- `postpack` - 发布后恢复为 `@repo/hooks`，恢复 workspace 依赖
+
+### 发布命令
+
+```bash
+# 进入 hooks 目录
+cd sso.dofe.ai/packages/hooks
+
+# 发布 patch 版本 (0.1.0 → 0.1.1)
+pnpm release:patch
+
+# 发布 minor 版本 (0.1.0 → 0.2.0)
+pnpm release:minor
+
+# 发布 major 版本 (0.1.0 → 1.0.0)
+pnpm release:major
+
+# 带 OTP 发布（如果启用了 2FA）
+pnpm publish:npm:otp --otp=<你的OTP码>
+```
+
+### 发布流程详解
+
+```bash
+pnpm release:patch
+```
+
+执行步骤：
+
+1. `npm version patch` - 升级版本号
+2. `pnpm run prepack` - 修改 package.json（名称、移除 workspace 依赖）
+3. `npm publish --access public` - 发布到 npmjs
+4. `pnpm run postpack` - 恢复 package.json 原始状态
+
+### 手动发布步骤（推荐）
+
+由于 npm lifecycle hooks 的复杂性，建议使用以下手动流程：
+
+```bash
+# 1. 构建包
+pnpm build
+
+# 2. 运行 prepack 修改 package.json
+node scripts/prepack.mjs
+
+# 3. 发布（使用 --ignore-scripts 避免重复运行 lifecycle hooks）
+npm publish --access public --ignore-scripts --otp=<你的OTP码>
+
+# 4. 运行 postpack 恢复 package.json
+node scripts/postpack.mjs
+```
+
+### 前置条件
+
+1. npm 账户登录：
+
+   ```bash
+   npm login
+   ```
+
+2. 验证登录状态：
+
+   ```bash
+   npm whoami
+   ```
+
+3. 确保有 `@dofe` organization 的发布权限
+
+### Peer Dependencies
+
+使用此包的项目需要安装以下依赖：
+
+```json
+{
+  "dependencies": {
+    "next-intl": "^4.0.0",
+    "react": "^19.0.0",
+    "sonner": "^2.0.0",
+    "zod": "^3.24.0"
+  }
+}
+```
+
+### 常见问题
+
+#### 发布失败 "Cannot resolve @repo/constants"
+
+确保运行了 `prepack` 脚本，它会移除 workspace 依赖。
+
+#### 本地安装失败 "Cannot resolve @repo/hooks"
+
+这是因为 workspace 依赖问题。确保在 sso.dofe.ai 项目根目录运行 `pnpm install`。

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { useDebouncedValue } from './useDebouncedValue';
+export { useErrorHandler, NetworkError, ValidationError, AuthenticationError, PermissionError } from './useErrorHandler';
+export { useHotkeys } from './useHotkeys';
+export { useI18nValidation, createPasswordConfirmSchema } from './useI18nValidation';
+export { useOperationFeedback } from './useOperationFeedback';
+export { usePermissions } from './usePermissions';
+export { useAspectRatioSize } from './useAspectRatioSize';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { useDebouncedValue } from './useDebouncedValue';
+export { useErrorHandler, NetworkError, ValidationError, AuthenticationError, PermissionError } from './useErrorHandler';
+export { useHotkeys } from './useHotkeys';
+export { useI18nValidation, createPasswordConfirmSchema } from './useI18nValidation';
+export { useOperationFeedback } from './useOperationFeedback';
+export { usePermissions } from './usePermissions';
+export { useAspectRatioSize } from './useAspectRatioSize';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/useAspectRatioSize.d.ts

@@ -0,0 +1,18 @@
+interface UseAspectRatioSizeOptions {
+    initialAspectRatio?: string;
+    initialResolution?: string;
+    initialRatioLocked?: boolean;
+    onSizeChange?: (width: number, height: number) => void;
+}
+interface UseAspectRatioSizeReturn {
+    width: number;
+    height: number;
+    ratioLocked: boolean;
+    setRatioLocked: (locked: boolean) => void;
+    handleWidthChange: (value: string, aspectRatio: string) => void;
+    handleHeightChange: (value: string, aspectRatio: string) => void;
+    updateSizeFromRatio: (aspectRatio: string, resolution: string) => void;
+}
+export declare function useAspectRatioSize({ initialAspectRatio, initialResolution, initialRatioLocked, onSizeChange, }: UseAspectRatioSizeOptions): UseAspectRatioSizeReturn;
+export {};
+//# sourceMappingURL=useAspectRatioSize.d.ts.map

package/dist/useAspectRatioSize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAspectRatioSize.d.ts","sourceRoot":"","sources":["../src/useAspectRatioSize.ts"],"names":[],"mappings":"AA2EA,UAAU,yBAAyB;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACxD;AAED,UAAU,wBAAwB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1C,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,kBAAkB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE,mBAAmB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;CACxE;AAED,wBAAgB,kBAAkB,CAAC,EACjC,kBAA0B,EAC1B,iBAAwB,EACxB,kBAAyB,EACzB,YAAY,GACb,EAAE,yBAAyB,GAAG,wBAAwB,CA2FtD"}

package/dist/useAspectRatioSize.js

@@ -0,0 +1,135 @@
+'use client';
+import { useState, useCallback, useEffect } from 'react';
+// 解析宽高比字符串为数字
+const parseAspectRatio = (ratio) => {
+    const [w, h] = ratio.split(':').map(Number);
+    return [w ?? 0, h ?? 0];
+};
+// 根据分辨率获取基准尺寸
+const getBaseSize = (resolution) => {
+    switch (resolution) {
+        case '1K':
+            return 1024;
+        case '2K':
+            return 2048;
+        case '4K':
+            return 4096;
+        default:
+            return 2048;
+    }
+};
+// 根据比例计算最大尺寸限制
+const getMaxDimensions = (aspectRatio) => {
+    const [w, h] = parseAspectRatio(aspectRatio);
+    const maxDimension = 6240;
+    if (w > h) {
+        // 横向比例：以高度为基准计算宽度
+        const maxHeight = maxDimension;
+        const maxWidth = Math.round(maxDimension * (w / h));
+        // 如果计算出的宽度超过最大限制，则以宽度为基准重新计算
+        return maxWidth > maxDimension
+            ? [maxDimension, Math.round(maxDimension * (h / w))]
+            : [maxWidth, maxHeight];
+    }
+    else {
+        // 纵向比例：以宽度为基准计算高度
+        const maxWidth = maxDimension;
+        const maxHeight = Math.round(maxDimension * (h / w));
+        // 如果计算出的高度超过最大限制，则以高度为基准重新计算
+        return maxHeight > maxDimension
+            ? [Math.round(maxDimension * (w / h)), maxDimension]
+            : [maxWidth, maxHeight];
+    }
+};
+// 根据宽高比和分辨率计算尺寸
+const calculateSize = (aspectRatio, resolution) => {
+    const [w, h] = parseAspectRatio(aspectRatio);
+    const baseSize = getBaseSize(resolution);
+    const [maxWidth, maxHeight] = getMaxDimensions(aspectRatio);
+    // 计算最适合的尺寸，保持比例
+    if (w > h) {
+        // 横向比例：宽度为主导
+        const width = Math.min(baseSize, maxWidth, Math.round(baseSize * (w / h)));
+        const height = Math.round(width * (h / w));
+        return [width, height];
+    }
+    else {
+        // 纵向比例：高度为主导
+        const height = Math.min(baseSize, maxHeight, Math.round(baseSize * (h / w)));
+        const width = Math.round(height * (w / h));
+        return [width, height];
+    }
+};
+export function useAspectRatioSize({ initialAspectRatio = '3:4', initialResolution = '2K', initialRatioLocked = true, onSizeChange, }) {
+    const [width, setWidth] = useState(() => {
+        const [w] = calculateSize(initialAspectRatio, initialResolution);
+        return w;
+    });
+    const [height, setHeight] = useState(() => {
+        const [, h] = calculateSize(initialAspectRatio, initialResolution);
+        return h;
+    });
+    const [ratioLocked, setRatioLocked] = useState(initialRatioLocked);
+    // 更新尺寸的方法
+    const updateSizeFromRatio = useCallback((aspectRatio, resolution) => {
+        const [newWidth, newHeight] = calculateSize(aspectRatio, resolution);
+        setWidth(newWidth);
+        setHeight(newHeight);
+    }, []);
+    // 处理宽度输入 - 需要外部传入当前aspectRatio
+    const handleWidthChange = useCallback((value, currentAspectRatio) => {
+        const numValue = parseInt(value);
+        // 如果输入不是有效数字，忽略
+        if (isNaN(numValue) || value === '')
+            return;
+        // 根据比例获取最大尺寸限制
+        const [maxWidth] = getMaxDimensions(currentAspectRatio);
+        // 限制在有效范围内，如果超出范围则修正
+        const clampedValue = Math.max(1, Math.min(maxWidth, numValue));
+        setWidth(clampedValue);
+        if (ratioLocked) {
+            const [w, h] = parseAspectRatio(currentAspectRatio);
+            const newHeight = Math.round(clampedValue * (h / w));
+            // 根据比例获取最大高度限制
+            const [, maxHeight] = getMaxDimensions(currentAspectRatio);
+            const clampedHeight = Math.max(1, Math.min(maxHeight, newHeight));
+            setHeight(clampedHeight);
+        }
+    }, [ratioLocked]);
+    // 处理高度输入 - 需要外部传入当前aspectRatio
+    const handleHeightChange = useCallback((value, currentAspectRatio) => {
+        const numValue = parseInt(value);
+        // 如果输入不是有效数字，忽略
+        if (isNaN(numValue) || value === '')
+            return;
+        // 根据比例获取最大尺寸限制
+        const [, maxHeight] = getMaxDimensions(currentAspectRatio);
+        // 限制在有效范围内，如果超出范围则修正
+        const clampedValue = Math.max(1, Math.min(maxHeight, numValue));
+        setHeight(clampedValue);
+        if (ratioLocked) {
+            const [w, h] = parseAspectRatio(currentAspectRatio);
+            const newWidth = Math.round(clampedValue * (w / h));
+            // 根据比例获取最大宽度限制
+            const [maxWidth] = getMaxDimensions(currentAspectRatio);
+            const clampedWidth = Math.max(1, Math.min(maxWidth, newWidth));
+            setWidth(clampedWidth);
+        }
+    }, [ratioLocked]);
+    // 同步尺寸变化到外部（如 form）
+    useEffect(() => {
+        if (onSizeChange) {
+            onSizeChange(width, height);
+        }
+    }, [width, height, onSizeChange]);
+    return {
+        width,
+        height,
+        ratioLocked,
+        setRatioLocked,
+        handleWidthChange,
+        handleHeightChange,
+        updateSizeFromRatio,
+    };
+}
+//# sourceMappingURL=useAspectRatioSize.js.map

package/dist/useAspectRatioSize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAspectRatioSize.js","sourceRoot":"","sources":["../src/useAspectRatioSize.ts"],"names":[],"mappings":"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"}

package/dist/useDebouncedValue.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 防抖 hook，延迟更新值
+ * @param value 需要防抖的值
+ * @param delay 延迟时间（毫秒），默认 500ms
+ * @returns 防抖后的值
+ */
+export declare function useDebouncedValue<T>(value: T, delay?: number): T;
+//# sourceMappingURL=useDebouncedValue.d.ts.map

package/dist/useDebouncedValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedValue.d.ts","sourceRoot":"","sources":["../src/useDebouncedValue.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,SAAM,GAAG,CAAC,CAc7D"}

package/dist/useDebouncedValue.js

@@ -0,0 +1,21 @@
+'use client';
+import { useState, useEffect } from 'react';
+/**
+ * 防抖 hook，延迟更新值
+ * @param value 需要防抖的值
+ * @param delay 延迟时间（毫秒），默认 500ms
+ * @returns 防抖后的值
+ */
+export function useDebouncedValue(value, delay = 500) {
+    const [debouncedValue, setDebouncedValue] = useState(value);
+    useEffect(() => {
+        const timer = setTimeout(() => {
+            setDebouncedValue(value);
+        }, delay);
+        return () => {
+            clearTimeout(timer);
+        };
+    }, [value, delay]);
+    return debouncedValue;
+}
+//# sourceMappingURL=useDebouncedValue.js.map

package/dist/useDebouncedValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebouncedValue.js","sourceRoot":"","sources":["../src/useDebouncedValue.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAI,KAAQ,EAAE,KAAK,GAAG,GAAG;IACxD,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAAI,KAAK,CAAC,CAAC;IAE/D,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC,EAAE,KAAK,CAAC,CAAC;QAEV,OAAO,GAAG,EAAE;YACV,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAEnB,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/useErrorHandler.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 错误类型定义
+ */
+export declare class NetworkError extends Error {
+    constructor(message: string);
+}
+export declare class ValidationError extends Error {
+    constructor(message: string);
+}
+export declare class AuthenticationError extends Error {
+    constructor(message: string);
+}
+export declare class PermissionError extends Error {
+    constructor(message: string);
+}
+/**
+ * 统一错误处理 Hook
+ *
+ * @example
+ * ```tsx
+ * const handleError = useErrorHandler();
+ *
+ * try {
+ *   await someOperation();
+ * } catch (error) {
+ *   handleError(error);
+ * }
+ * ```
+ */
+export declare function useErrorHandler(): (err: unknown, customMessage?: string) => void;
+//# sourceMappingURL=useErrorHandler.d.ts.map

package/dist/useErrorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useErrorHandler.d.ts","sourceRoot":"","sources":["../src/useErrorHandler.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,UAKrB,OAAO,kBAAkB,MAAM,UAqDxC"}

package/dist/useErrorHandler.js

@@ -0,0 +1,96 @@
+'use client';
+/**
+ * useErrorHandler - 统一的错误处理 Hook
+ * 提供友好的错误提示和错误分类处理
+ */
+import { useCallback } from 'react';
+import { useOperationFeedback } from './useOperationFeedback';
+import { useTranslations } from 'next-intl';
+/**
+ * 错误类型定义
+ */
+export class NetworkError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'NetworkError';
+    }
+}
+export class ValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ValidationError';
+    }
+}
+export class AuthenticationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'AuthenticationError';
+    }
+}
+export class PermissionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PermissionError';
+    }
+}
+/**
+ * 统一错误处理 Hook
+ *
+ * @example
+ * ```tsx
+ * const handleError = useErrorHandler();
+ *
+ * try {
+ *   await someOperation();
+ * } catch (error) {
+ *   handleError(error);
+ * }
+ * ```
+ */
+export function useErrorHandler() {
+    const { error } = useOperationFeedback();
+    const t = useTranslations('errors');
+    const handleError = useCallback((err, customMessage) => {
+        // 如果有自定义消息，直接使用
+        if (customMessage) {
+            error(customMessage);
+            return;
+        }
+        // 根据错误类型显示不同的提示
+        if (err instanceof NetworkError) {
+            error(t('network', {
+                defaultValue: '网络连接失败，请检查网络后重试',
+            }));
+        }
+        else if (err instanceof ValidationError) {
+            error(t('validation', {
+                defaultValue: '输入数据格式不正确，请检查后重试',
+            }));
+        }
+        else if (err instanceof AuthenticationError) {
+            error(t('authentication', {
+                defaultValue: '登录已过期，请重新登录',
+            }));
+        }
+        else if (err instanceof PermissionError) {
+            error(t('permission', {
+                defaultValue: '您没有权限执行此操作',
+            }));
+        }
+        else if (err instanceof Error) {
+            // 普通 Error 对象，显示错误消息
+            error(err.message ||
+                t('unknown', {
+                    defaultValue: '操作失败，请稍后重试',
+                }));
+        }
+        else {
+            // 未知错误类型
+            error(t('unknown', {
+                defaultValue: '操作失败，请稍后重试',
+            }));
+        }
+    }, [error, t]);
+    return handleError;
+}
+//# sourceMappingURL=useErrorHandler.js.map

package/dist/useErrorHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useErrorHandler.js","sourceRoot":"","sources":["../src/useErrorHandler.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,EAAE,KAAK,EAAE,GAAG,oBAAoB,EAAE,CAAC;IACzC,MAAM,CAAC,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAEpC,MAAM,WAAW,GAAG,WAAW,CAC7B,CAAC,GAAY,EAAE,aAAsB,EAAE,EAAE;QACvC,gBAAgB;QAChB,IAAI,aAAa,EAAE,CAAC;YAClB,KAAK,CAAC,aAAa,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,gBAAgB;QAChB,IAAI,GAAG,YAAY,YAAY,EAAE,CAAC;YAChC,KAAK,CACH,CAAC,CAAC,SAAS,EAAE;gBACX,YAAY,EAAE,iBAAiB;aAChC,CAAC,CACH,CAAC;QACJ,CAAC;aAAM,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;YAC1C,KAAK,CACH,CAAC,CAAC,YAAY,EAAE;gBACd,YAAY,EAAE,kBAAkB;aACjC,CAAC,CACH,CAAC;QACJ,CAAC;aAAM,IAAI,GAAG,YAAY,mBAAmB,EAAE,CAAC;YAC9C,KAAK,CACH,CAAC,CAAC,gBAAgB,EAAE;gBAClB,YAAY,EAAE,aAAa;aAC5B,CAAC,CACH,CAAC;QACJ,CAAC;aAAM,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;YAC1C,KAAK,CACH,CAAC,CAAC,YAAY,EAAE;gBACd,YAAY,EAAE,YAAY;aAC3B,CAAC,CACH,CAAC;QACJ,CAAC;aAAM,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YAChC,qBAAqB;YACrB,KAAK,CACH,GAAG,CAAC,OAAO;gBACT,CAAC,CAAC,SAAS,EAAE;oBACX,YAAY,EAAE,YAAY;iBAC3B,CAAC,CACL,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,SAAS;YACT,KAAK,CACH,CAAC,CAAC,SAAS,EAAE;gBACX,YAAY,EAAE,YAAY;aAC3B,CAAC,CACH,CAAC;QACJ,CAAC;IACH,CAAC,EACD,CAAC,KAAK,EAAE,CAAC,CAAC,CACX,CAAC;IAEF,OAAO,WAAW,CAAC;AACrB,CAAC"}