@qhr123/sa2kit 0.2.0 → 0.3.1

package/dist/i18n/index.d.ts

@@ -0,0 +1,306 @@
+/**
+ * i18n 类型定义
+ */
+type Locale = 'zh-CN' | 'zh-TW' | 'en-US' | 'ja-JP';
+type TranslationKey = string;
+type TranslationValue = string | {
+    [key: string]: TranslationValue;
+};
+type Translations = {
+    [key: string]: TranslationValue;
+};
+type LocaleResources = {
+    [locale in Locale]?: Translations;
+};
+interface TranslateOptions {
+    defaultValue?: string;
+    count?: number;
+    context?: Record<string, any>;
+}
+type InterpolateFunction = (template: string, data: Record<string, any>) => string;
+interface I18nConfig {
+    locale: Locale;
+    fallbackLocale?: Locale;
+    resources: LocaleResources;
+    interpolate?: InterpolateFunction;
+}
+interface I18nInstance {
+    locale: Locale;
+    t: (key: string, options?: TranslateOptions) => string;
+    setLocale: (locale: Locale) => void;
+    addResources: (locale: Locale, resources: Translations) => void;
+    getLocale: () => Locale;
+}
+interface I18nAdapter {
+    getSystemLocale: () => Locale;
+    saveLocale: (locale: Locale) => Promise<void>;
+    loadLocale: () => Promise<Locale | null>;
+}
+
+/**
+ * 轻量级 i18n 核心实现
+ * 支持：翻译、插值、复数、嵌套键、类型安全
+ */
+
+/**
+ * 创建 i18n 实例
+ */
+declare function createI18n(config: I18nConfig): I18nInstance;
+/**
+ * 初始化全局 i18n
+ */
+declare function initI18n(config: I18nConfig): I18nInstance;
+/**
+ * 获取全局 i18n 实例
+ */
+declare function getI18n(): I18nInstance;
+/**
+ * 快捷翻译函数
+ */
+declare function t(key: string, options?: TranslateOptions): string;
+
+/**
+ * React hooks for i18n
+ */
+
+/**
+ * useTranslation Hook
+ * React 组件中使用翻译
+ */
+declare function useTranslation(): {
+    t: (key: string, options?: TranslateOptions) => string;
+    locale: Locale;
+    setLocale: (newLocale: Locale) => void;
+};
+/**
+ * useLocale Hook
+ * 只获取和设置语言，不包含翻译函数
+ */
+declare function useLocale(): {
+    locale: Locale;
+    setLocale: (newLocale: Locale) => void;
+};
+
+/**
+ * 简体中文翻译
+ */
+declare const _default$1: {
+    readonly app: {
+        readonly name: "LyricNote";
+        readonly fullName: "LyricNote - 歌词笔记";
+        readonly icon: "🎵";
+        readonly description: "一个强大的歌词和笔记管理应用";
+        readonly author: "LyricNote Team";
+        readonly copyright: `\u00A9 ${number} LyricNote`;
+        readonly version: "1.0.0";
+    };
+    readonly titles: {
+        readonly main: "🎵 LyricNote";
+        readonly admin: "LyricNote 管理后台";
+        readonly withVersion: "LyricNote v1.0.0";
+        readonly welcome: "欢迎使用 LyricNote";
+        readonly about: "关于 LyricNote";
+    };
+    readonly common: {
+        readonly hello: "你好";
+        readonly welcome: "欢迎";
+        readonly confirm: "确认";
+        readonly cancel: "取消";
+        readonly save: "保存";
+        readonly delete: "删除";
+        readonly edit: "编辑";
+        readonly back: "返回";
+        readonly next: "下一步";
+        readonly submit: "提交";
+        readonly finish: "完成";
+        readonly loading: "加载中...";
+        readonly success: "操作成功";
+        readonly error: "操作失败";
+        readonly retry: "重试";
+        readonly empty: "暂无数据";
+    };
+    readonly nav: {
+        readonly home: "首页";
+        readonly lyrics: "歌词";
+        readonly create: "创作";
+        readonly collection: "收藏";
+        readonly profile: "我的";
+        readonly settings: "设置";
+        readonly history: "历史";
+        readonly logout: "退出登录";
+    };
+    readonly user: {
+        readonly login: "登录";
+        readonly register: "注册";
+        readonly username: "用户名";
+        readonly password: "密码";
+        readonly email: "邮箱";
+        readonly phone: "手机号";
+        readonly nickname: "昵称";
+    };
+    readonly pages: {
+        readonly home: {
+            readonly title: "首页";
+            readonly description: "一个强大的歌词和笔记管理应用";
+        };
+        readonly profile: {
+            readonly title: "个人中心";
+            readonly description: "管理您的个人信息和偏好设置";
+        };
+        readonly admin: {
+            readonly title: "LyricNote 管理后台";
+            readonly description: "系统管理和数据统计";
+        };
+        readonly login: {
+            readonly title: "登录";
+            readonly description: "登录到 LyricNote";
+        };
+    };
+    readonly validation: {
+        readonly required: "{{field}}不能为空";
+        readonly invalid_email: "邮箱格式不正确";
+        readonly password_too_short: "密码至少需要{{count}}个字符";
+        readonly password_weak: "密码强度不够";
+        readonly passwords_not_match: "两次密码不一致";
+    };
+    readonly status: {
+        readonly loading: "加载中...";
+        readonly success: "操作成功";
+        readonly error: "操作失败";
+        readonly empty: "暂无数据";
+        readonly network_error: "网络错误，请稍后重试";
+    };
+    readonly errors: {
+        readonly network: "网络错误，请稍后重试";
+        readonly server: "服务器错误";
+        readonly unauthorized: "未授权，请先登录";
+        readonly not_found: "未找到相关内容";
+        readonly unknown: "未知错误";
+    };
+    readonly success: {
+        readonly saved: "保存成功";
+        readonly deleted: "删除成功";
+        readonly updated: "更新成功";
+        readonly created: "创建成功";
+    };
+    readonly language: {
+        readonly label: "语言";
+        readonly zh_cn: "简体中文";
+        readonly zh_tw: "繁體中文";
+        readonly en_us: "English";
+        readonly ja_jp: "日本語";
+    };
+};
+
+/**
+ * English translations
+ */
+declare const _default: {
+    readonly app: {
+        readonly name: "LyricNote";
+        readonly fullName: "LyricNote - Lyrics & Notes";
+        readonly icon: "🎵";
+        readonly description: "A powerful lyrics and notes management app";
+        readonly author: "LyricNote Team";
+        readonly copyright: `\u00A9 ${number} LyricNote`;
+        readonly version: "1.0.0";
+    };
+    readonly titles: {
+        readonly main: "🎵 LyricNote";
+        readonly admin: "LyricNote Admin";
+        readonly withVersion: "LyricNote v1.0.0";
+        readonly welcome: "Welcome to LyricNote";
+        readonly about: "About LyricNote";
+    };
+    readonly common: {
+        readonly hello: "Hello";
+        readonly welcome: "Welcome";
+        readonly confirm: "Confirm";
+        readonly cancel: "Cancel";
+        readonly save: "Save";
+        readonly delete: "Delete";
+        readonly edit: "Edit";
+        readonly back: "Back";
+        readonly next: "Next";
+        readonly submit: "Submit";
+        readonly finish: "Finish";
+        readonly loading: "Loading...";
+        readonly success: "Success";
+        readonly error: "Error";
+        readonly retry: "Retry";
+        readonly empty: "No data";
+    };
+    readonly nav: {
+        readonly home: "Home";
+        readonly lyrics: "Lyrics";
+        readonly create: "Create";
+        readonly collection: "Collection";
+        readonly profile: "Profile";
+        readonly settings: "Settings";
+        readonly history: "History";
+        readonly logout: "Logout";
+    };
+    readonly user: {
+        readonly login: "Login";
+        readonly register: "Register";
+        readonly username: "Username";
+        readonly password: "Password";
+        readonly email: "Email";
+        readonly phone: "Phone";
+        readonly nickname: "Nickname";
+    };
+    readonly pages: {
+        readonly home: {
+            readonly title: "Home";
+            readonly description: "A powerful lyrics and notes management app";
+        };
+        readonly profile: {
+            readonly title: "Profile";
+            readonly description: "Manage your personal information and preferences";
+        };
+        readonly admin: {
+            readonly title: "LyricNote Admin";
+            readonly description: "System management and data statistics";
+        };
+        readonly login: {
+            readonly title: "Login";
+            readonly description: "Login to LyricNote";
+        };
+    };
+    readonly validation: {
+        readonly required: "{{field}} is required";
+        readonly invalid_email: "Invalid email format";
+        readonly password_too_short: "Password must be at least {{count}} characters";
+        readonly password_weak: "Password is too weak";
+        readonly passwords_not_match: "Passwords do not match";
+    };
+    readonly status: {
+        readonly loading: "Loading...";
+        readonly success: "Success";
+        readonly error: "Error";
+        readonly empty: "No data";
+        readonly network_error: "Network error, please try again later";
+    };
+    readonly errors: {
+        readonly network: "Network error, please try again later";
+        readonly server: "Server error";
+        readonly unauthorized: "Unauthorized, please login first";
+        readonly not_found: "Not found";
+        readonly unknown: "Unknown error";
+    };
+    readonly success: {
+        readonly saved: "Saved successfully";
+        readonly deleted: "Deleted successfully";
+        readonly updated: "Updated successfully";
+        readonly created: "Created successfully";
+    };
+    readonly language: {
+        readonly label: "Language";
+        readonly zh_cn: "简体中文";
+        readonly zh_tw: "繁體中文";
+        readonly en_us: "English";
+        readonly ja_jp: "日本語";
+    };
+};
+
+export { type I18nAdapter, type I18nConfig, type I18nInstance, type Locale, type LocaleResources, type TranslateOptions, type TranslationKey, type TranslationValue, type Translations, createI18n, _default as enUS, getI18n, initI18n, t, useLocale, useTranslation, _default$1 as zhCN };

package/dist/i18n/index.js

@@ -0,0 +1,369 @@
+'use strict';
+
+var react = require('react');
+
+// src/i18n/i18n.ts
+function defaultInterpolate(template, data) {
+  return template.replace(/\{\{(\w+)\}\}/g, (match, key) => {
+    return data[key]?.toString() ?? match;
+  });
+}
+function getNestedValue(obj, path) {
+  const keys = path.split(".");
+  let result = obj;
+  for (const key of keys) {
+    if (result && typeof result === "object" && key in result) {
+      result = result[key];
+    } else {
+      return void 0;
+    }
+  }
+  return result;
+}
+function createI18n(config) {
+  let currentLocale = config.locale;
+  const fallbackLocale = config.fallbackLocale || "zh-CN";
+  const resources = config.resources || {};
+  const interpolate = config.interpolate || defaultInterpolate;
+  function t2(key, options = {}) {
+    const { defaultValue, count, context = {} } = options;
+    let translation = getNestedValue(resources[currentLocale], key);
+    if (translation === void 0 && currentLocale !== fallbackLocale) {
+      translation = getNestedValue(resources[fallbackLocale], key);
+    }
+    if (translation === void 0) {
+      return defaultValue || key;
+    }
+    if (typeof translation !== "string") {
+      return JSON.stringify(translation);
+    }
+    if (count !== void 0) {
+      const pluralKey = count === 1 ? `${key}_one` : `${key}_other`;
+      const pluralTranslation = getNestedValue(resources[currentLocale], pluralKey);
+      if (pluralTranslation && typeof pluralTranslation === "string") {
+        translation = pluralTranslation;
+      }
+    }
+    const data = { ...context, count };
+    return interpolate(translation, data);
+  }
+  function setLocale(locale) {
+    currentLocale = locale;
+  }
+  function addResources(locale, newResources) {
+    if (!resources[locale]) {
+      resources[locale] = {};
+    }
+    resources[locale] = {
+      ...resources[locale],
+      ...newResources
+    };
+  }
+  function getLocale() {
+    return currentLocale;
+  }
+  return {
+    locale: currentLocale,
+    t: t2,
+    setLocale,
+    addResources,
+    getLocale
+  };
+}
+var globalI18n = null;
+function initI18n(config) {
+  globalI18n = createI18n(config);
+  return globalI18n;
+}
+function getI18n() {
+  if (!globalI18n) {
+    throw new Error("i18n not initialized. Call initI18n() first.");
+  }
+  return globalI18n;
+}
+function t(key, options) {
+  return getI18n().t(key, options);
+}
+function useTranslation() {
+  const i18n = getI18n();
+  const [locale, setLocaleState] = react.useState(i18n.getLocale());
+  const t2 = react.useCallback(
+    (key, options) => {
+      return i18n.t(key, options);
+    },
+    [locale]
+    // locale 改变时重新创建函数
+  );
+  const setLocale = react.useCallback((newLocale) => {
+    i18n.setLocale(newLocale);
+    setLocaleState(newLocale);
+  }, []);
+  return {
+    t: t2,
+    locale,
+    setLocale
+  };
+}
+function useLocale() {
+  const i18n = getI18n();
+  const [locale, setLocaleState] = react.useState(i18n.getLocale());
+  const setLocale = react.useCallback((newLocale) => {
+    i18n.setLocale(newLocale);
+    setLocaleState(newLocale);
+  }, []);
+  return {
+    locale,
+    setLocale
+  };
+}
+
+// src/i18n/locales/zh-CN.ts
+var zh_CN_default = {
+  // ==================== 应用信息 ====================
+  app: {
+    name: "LyricNote",
+    fullName: "LyricNote - \u6B4C\u8BCD\u7B14\u8BB0",
+    icon: "\u{1F3B5}",
+    description: "\u4E00\u4E2A\u5F3A\u5927\u7684\u6B4C\u8BCD\u548C\u7B14\u8BB0\u7BA1\u7406\u5E94\u7528",
+    author: "LyricNote Team",
+    copyright: `\xA9 ${(/* @__PURE__ */ new Date()).getFullYear()} LyricNote`,
+    version: "1.0.0"
+  },
+  // ==================== 应用标题 ====================
+  titles: {
+    main: "\u{1F3B5} LyricNote",
+    admin: "LyricNote \u7BA1\u7406\u540E\u53F0",
+    withVersion: "LyricNote v1.0.0",
+    welcome: "\u6B22\u8FCE\u4F7F\u7528 LyricNote",
+    about: "\u5173\u4E8E LyricNote"
+  },
+  // ==================== 通用文案 ====================
+  common: {
+    hello: "\u4F60\u597D",
+    welcome: "\u6B22\u8FCE",
+    confirm: "\u786E\u8BA4",
+    cancel: "\u53D6\u6D88",
+    save: "\u4FDD\u5B58",
+    delete: "\u5220\u9664",
+    edit: "\u7F16\u8F91",
+    back: "\u8FD4\u56DE",
+    next: "\u4E0B\u4E00\u6B65",
+    submit: "\u63D0\u4EA4",
+    finish: "\u5B8C\u6210",
+    loading: "\u52A0\u8F7D\u4E2D...",
+    success: "\u64CD\u4F5C\u6210\u529F",
+    error: "\u64CD\u4F5C\u5931\u8D25",
+    retry: "\u91CD\u8BD5",
+    empty: "\u6682\u65E0\u6570\u636E"
+  },
+  // ==================== 导航菜单 ====================
+  nav: {
+    home: "\u9996\u9875",
+    lyrics: "\u6B4C\u8BCD",
+    create: "\u521B\u4F5C",
+    collection: "\u6536\u85CF",
+    profile: "\u6211\u7684",
+    settings: "\u8BBE\u7F6E",
+    history: "\u5386\u53F2",
+    logout: "\u9000\u51FA\u767B\u5F55"
+  },
+  // ==================== 用户相关 ====================
+  user: {
+    login: "\u767B\u5F55",
+    register: "\u6CE8\u518C",
+    username: "\u7528\u6237\u540D",
+    password: "\u5BC6\u7801",
+    email: "\u90AE\u7BB1",
+    phone: "\u624B\u673A\u53F7",
+    nickname: "\u6635\u79F0"
+  },
+  // ==================== 页面标题和描述 ====================
+  pages: {
+    home: {
+      title: "\u9996\u9875",
+      description: "\u4E00\u4E2A\u5F3A\u5927\u7684\u6B4C\u8BCD\u548C\u7B14\u8BB0\u7BA1\u7406\u5E94\u7528"
+    },
+    profile: {
+      title: "\u4E2A\u4EBA\u4E2D\u5FC3",
+      description: "\u7BA1\u7406\u60A8\u7684\u4E2A\u4EBA\u4FE1\u606F\u548C\u504F\u597D\u8BBE\u7F6E"
+    },
+    admin: {
+      title: "LyricNote \u7BA1\u7406\u540E\u53F0",
+      description: "\u7CFB\u7EDF\u7BA1\u7406\u548C\u6570\u636E\u7EDF\u8BA1"
+    },
+    login: {
+      title: "\u767B\u5F55",
+      description: "\u767B\u5F55\u5230 LyricNote"
+    }
+  },
+  // ==================== 表单验证 ====================
+  validation: {
+    required: "{{field}}\u4E0D\u80FD\u4E3A\u7A7A",
+    invalid_email: "\u90AE\u7BB1\u683C\u5F0F\u4E0D\u6B63\u786E",
+    password_too_short: "\u5BC6\u7801\u81F3\u5C11\u9700\u8981{{count}}\u4E2A\u5B57\u7B26",
+    password_weak: "\u5BC6\u7801\u5F3A\u5EA6\u4E0D\u591F",
+    passwords_not_match: "\u4E24\u6B21\u5BC6\u7801\u4E0D\u4E00\u81F4"
+  },
+  // ==================== 状态提示 ====================
+  status: {
+    loading: "\u52A0\u8F7D\u4E2D...",
+    success: "\u64CD\u4F5C\u6210\u529F",
+    error: "\u64CD\u4F5C\u5931\u8D25",
+    empty: "\u6682\u65E0\u6570\u636E",
+    network_error: "\u7F51\u7EDC\u9519\u8BEF\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5"
+  },
+  // ==================== 错误消息 ====================
+  errors: {
+    network: "\u7F51\u7EDC\u9519\u8BEF\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5",
+    server: "\u670D\u52A1\u5668\u9519\u8BEF",
+    unauthorized: "\u672A\u6388\u6743\uFF0C\u8BF7\u5148\u767B\u5F55",
+    not_found: "\u672A\u627E\u5230\u76F8\u5173\u5185\u5BB9",
+    unknown: "\u672A\u77E5\u9519\u8BEF"
+  },
+  // ==================== 成功消息 ====================
+  success: {
+    saved: "\u4FDD\u5B58\u6210\u529F",
+    deleted: "\u5220\u9664\u6210\u529F",
+    updated: "\u66F4\u65B0\u6210\u529F",
+    created: "\u521B\u5EFA\u6210\u529F"
+  },
+  // ==================== 语言设置 ====================
+  language: {
+    label: "\u8BED\u8A00",
+    zh_cn: "\u7B80\u4F53\u4E2D\u6587",
+    zh_tw: "\u7E41\u9AD4\u4E2D\u6587",
+    en_us: "English",
+    ja_jp: "\u65E5\u672C\u8A9E"
+  }
+};
+
+// src/i18n/locales/en-US.ts
+var en_US_default = {
+  // ==================== App Information ====================
+  app: {
+    name: "LyricNote",
+    fullName: "LyricNote - Lyrics & Notes",
+    icon: "\u{1F3B5}",
+    description: "A powerful lyrics and notes management app",
+    author: "LyricNote Team",
+    copyright: `\xA9 ${(/* @__PURE__ */ new Date()).getFullYear()} LyricNote`,
+    version: "1.0.0"
+  },
+  // ==================== App Titles ====================
+  titles: {
+    main: "\u{1F3B5} LyricNote",
+    admin: "LyricNote Admin",
+    withVersion: "LyricNote v1.0.0",
+    welcome: "Welcome to LyricNote",
+    about: "About LyricNote"
+  },
+  // ==================== Common ====================
+  common: {
+    hello: "Hello",
+    welcome: "Welcome",
+    confirm: "Confirm",
+    cancel: "Cancel",
+    save: "Save",
+    delete: "Delete",
+    edit: "Edit",
+    back: "Back",
+    next: "Next",
+    submit: "Submit",
+    finish: "Finish",
+    loading: "Loading...",
+    success: "Success",
+    error: "Error",
+    retry: "Retry",
+    empty: "No data"
+  },
+  // ==================== Navigation ====================
+  nav: {
+    home: "Home",
+    lyrics: "Lyrics",
+    create: "Create",
+    collection: "Collection",
+    profile: "Profile",
+    settings: "Settings",
+    history: "History",
+    logout: "Logout"
+  },
+  // ==================== User ====================
+  user: {
+    login: "Login",
+    register: "Register",
+    username: "Username",
+    password: "Password",
+    email: "Email",
+    phone: "Phone",
+    nickname: "Nickname"
+  },
+  // ==================== Pages ====================
+  pages: {
+    home: {
+      title: "Home",
+      description: "A powerful lyrics and notes management app"
+    },
+    profile: {
+      title: "Profile",
+      description: "Manage your personal information and preferences"
+    },
+    admin: {
+      title: "LyricNote Admin",
+      description: "System management and data statistics"
+    },
+    login: {
+      title: "Login",
+      description: "Login to LyricNote"
+    }
+  },
+  // ==================== Form Validation ====================
+  validation: {
+    required: "{{field}} is required",
+    invalid_email: "Invalid email format",
+    password_too_short: "Password must be at least {{count}} characters",
+    password_weak: "Password is too weak",
+    passwords_not_match: "Passwords do not match"
+  },
+  // ==================== Status Messages ====================
+  status: {
+    loading: "Loading...",
+    success: "Success",
+    error: "Error",
+    empty: "No data",
+    network_error: "Network error, please try again later"
+  },
+  // ==================== Error Messages ====================
+  errors: {
+    network: "Network error, please try again later",
+    server: "Server error",
+    unauthorized: "Unauthorized, please login first",
+    not_found: "Not found",
+    unknown: "Unknown error"
+  },
+  // ==================== Success Messages ====================
+  success: {
+    saved: "Saved successfully",
+    deleted: "Deleted successfully",
+    updated: "Updated successfully",
+    created: "Created successfully"
+  },
+  // ==================== Language Settings ====================
+  language: {
+    label: "Language",
+    zh_cn: "\u7B80\u4F53\u4E2D\u6587",
+    zh_tw: "\u7E41\u9AD4\u4E2D\u6587",
+    en_us: "English",
+    ja_jp: "\u65E5\u672C\u8A9E"
+  }
+};
+
+exports.createI18n = createI18n;
+exports.enUS = en_US_default;
+exports.getI18n = getI18n;
+exports.initI18n = initI18n;
+exports.t = t;
+exports.useLocale = useLocale;
+exports.useTranslation = useTranslation;
+exports.zhCN = zh_CN_default;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map