Develop (#26)

统一简化多个页面里的CopyButton调用，删除不再需要的空回调参数 * feat: 添加clearCookies函数的单元测试并修复cookie域名处理逻辑 * feat: 增强 data URI 处理，支持带参数的前缀并更新相关测试 * fix: 修正 AGENTS.md 中 TypeScript 类型检查命令的描述 * feat: 添加 settings.local.json 文件以配置 Bash 权限 * perf: 预设背景色避免 Popup 弹窗白屏闪烁 * perf: 避免图标过早实例化，传递组件引用而非 JSX 节点 * feat: 添加 useLazyTranslation 和 preloadNamespaces 函数以支持动态加载 i18n 命名空间 * feat: 使用 useLazyTranslation 替换 useTranslation 以支持懒加载翻译 * feat: 添加 PageSkeleton 组件及其测试用例以支持页面加载骨架屏 * feat: 使用骨架屏替换加载状态指示器，优化用户体验 * feat: 优化 CopyButton 组件的复制功能，添加定时器管理复制状态 * feat: 调整 chunk 大小警告阈值以优化构建性能
2026-05-20 20:07:44 +08:00
parent 7167a43763
commit 373fc0496c
24 changed files with 535 additions and 153 deletions
@@ -0,0 +1,107 @@
+import { useEffect, useMemo, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import i18n from '@/i18n';
+
+// 语言包动态导入映射
+const localeModules: Record<
+  string,
+  Record<string, () => Promise<{ default: Record<string, unknown> }>>
+> = {
+  zh: {
+    timestamp: () => import('@/i18n/locales/zh/timestamp.json'),
+    storageCleaner: () => import('@/i18n/locales/zh/storageCleaner.json'),
+    qrCode: () => import('@/i18n/locales/zh/qrCode.json'),
+    textStatistics: () => import('@/i18n/locales/zh/textStatistics.json'),
+    jwt: () => import('@/i18n/locales/zh/jwt.json'),
+    jsonDiff: () => import('@/i18n/locales/zh/jsonDiff.json'),
+    jsonFormat: () => import('@/i18n/locales/zh/jsonFormat.json'),
+    base64Converter: () => import('@/i18n/locales/zh/base64Converter.json'),
+    markdownToHtml: () => import('@/i18n/locales/zh/markdownToHtml.json'),
+    htmlToMarkdown: () => import('@/i18n/locales/zh/htmlToMarkdown.json'),
+  },
+  en: {
+    timestamp: () => import('@/i18n/locales/en/timestamp.json'),
+    storageCleaner: () => import('@/i18n/locales/en/storageCleaner.json'),
+    qrCode: () => import('@/i18n/locales/en/qrCode.json'),
+    textStatistics: () => import('@/i18n/locales/en/textStatistics.json'),
+    jwt: () => import('@/i18n/locales/en/jwt.json'),
+    jsonDiff: () => import('@/i18n/locales/en/jsonDiff.json'),
+    jsonFormat: () => import('@/i18n/locales/en/jsonFormat.json'),
+    base64Converter: () => import('@/i18n/locales/en/base64Converter.json'),
+    markdownToHtml: () => import('@/i18n/locales/en/markdownToHtml.json'),
+    htmlToMarkdown: () => import('@/i18n/locales/en/htmlToMarkdown.json'),
+  },
+};
+
+// 已加载的命名空间缓存
+const loadedNamespaces = new Set<string>();
+
+/**
+ * 清除已加载命名空间的缓存（仅用于测试）
+ * @internal
+ */
+export function __test_clearCache(): void {
+  loadedNamespaces.clear();
+}
+
+/**
+ * 动态加载 i18n 命名空间
+ */
+async function loadNamespace(ns: string, lng: string): Promise<void> {
+  const cacheKey = `${lng}:${ns}`;
+
+  if (loadedNamespaces.has(cacheKey)) {
+    return;
+  }
+
+  const langModules = localeModules[lng];
+  if (!langModules?.[ns]) {
+    return;
+  }
+
+  try {
+    const module = await langModules[ns]();
+    i18n.addResourceBundle(lng, ns, module.default, true, true);
+    loadedNamespaces.add(cacheKey);
+  } catch (error) {
+    console.error(`Failed to load namespace "${ns}" for language "${lng}":`, error);
+  }
+}
+
+/**
+ * 预加载指定命名空间（可在路由切换时调用）
+ */
+export async function preloadNamespaces(namespaces: string[]): Promise<void> {
+  const lng = i18n.language || 'en';
+  const normalizedLng = lng.startsWith('zh') ? 'zh' : 'en';
+
+  await Promise.all(namespaces.map((ns) => loadNamespace(ns, normalizedLng)));
+}
+
+/**
+ * 懒加载翻译 Hook
+ *
+ * 与 useTranslation 类似，但会在组件挂载时动态加载指定的命名空间
+ *
+ * @param ns - 命名空间或命名空间数组
+ * @returns useTranslation 的返回值
+ */
+export function useLazyTranslation(ns: string | string[]) {
+  const namespaces = useMemo(() => (Array.isArray(ns) ? ns : [ns]), [ns]);
+  const [isLoaded, setIsLoaded] = useState(false);
+  const translation = useTranslation(namespaces);
+
+  useEffect(() => {
+    const loadAll = async () => {
+      await preloadNamespaces(namespaces);
+      setIsLoaded(true);
+    };
+
+    loadAll();
+  }, [namespaces]);
+
+  return {
+    ...translation,
+    isLoaded,
+  };
+}