@object-ui/i18n 0.5.0

package/src/locales/ja.ts

@@ -0,0 +1,112 @@
+/**
+ * 日本語 (ja) - Japanese language pack for Object UI
+ */
+const ja = {
+  common: {
+    loading: '読み込み中...',
+    save: '保存',
+    cancel: 'キャンセル',
+    delete: '削除',
+    edit: '編集',
+    create: '作成',
+    search: '検索',
+    filter: 'フィルター',
+    reset: 'リセット',
+    confirm: '確認',
+    close: '閉じる',
+    back: '戻る',
+    next: '次へ',
+    previous: '前へ',
+    submit: '送信',
+    refresh: '更新',
+    export: 'エクスポート',
+    import: 'インポート',
+    yes: 'はい',
+    no: 'いいえ',
+    ok: 'OK',
+    actions: '操作',
+    more: 'もっと見る',
+    selectAll: 'すべて選択',
+    clearAll: 'すべてクリア',
+    noData: 'データがありません',
+    noResults: '結果が見つかりません',
+    required: '必須',
+    optional: '任意',
+  },
+  validation: {
+    required: '{{field}}は必須です',
+    minLength: '{{field}}は{{min}}文字以上で入力してください',
+    maxLength: '{{field}}は{{max}}文字以下で入力してください',
+    min: '{{field}}は{{min}}以上にしてください',
+    max: '{{field}}は{{max}}以下にしてください',
+    email: '有効なメールアドレスを入力してください',
+    url: '有効なURLを入力してください',
+    pattern: '{{field}}の形式が正しくありません',
+    unique: '{{field}}は一意である必要があります',
+    type: '{{field}}は有効な{{type}}である必要があります',
+  },
+  form: {
+    addItem: '項目を追加',
+    removeItem: '項目を削除',
+    fieldRequired: 'この項目は必須です',
+    invalidFormat: '形式が正しくありません',
+    saveSuccess: '保存しました',
+    saveError: '保存に失敗しました',
+    unsavedChanges: '保存されていない変更があります。このページを離れますか？',
+    stepOf: 'ステップ {{current}} / {{total}}',
+  },
+  table: {
+    rowsPerPage: '1ページの行数',
+    showing: '{{total}}件中{{from}}〜{{to}}件を表示',
+    noRows: '表示するデータがありません',
+    sortAsc: '昇順',
+    sortDesc: '降順',
+    filterColumn: '{{column}}でフィルター',
+    columns: '列',
+    exportCSV: 'CSVエクスポート',
+    exportExcel: 'Excelエクスポート',
+    selectRow: '行を選択',
+    selectAllRows: 'すべての行を選択',
+    expandRow: '行を展開',
+    collapseRow: '行を折りたたむ',
+  },
+  calendar: {
+    today: '今日',
+    month: '月',
+    week: '週',
+    day: '日',
+    agenda: '予定表',
+    allDay: '終日',
+    noEvents: '予定はありません',
+    newEvent: '新しい予定',
+  },
+  kanban: {
+    addCard: 'カードを追加',
+    addColumn: 'カラムを追加',
+    moveCard: 'カードを移動',
+    deleteCard: 'カードを削除',
+    deleteColumn: 'カラムを削除',
+  },
+  chart: {
+    noData: 'チャートデータがありません',
+    loading: 'チャート読み込み中...',
+  },
+  dashboard: {
+    addWidget: 'ウィジェットを追加',
+    removeWidget: 'ウィジェットを削除',
+    editLayout: 'レイアウトを編集',
+    saveLayout: 'レイアウトを保存',
+    resetLayout: 'レイアウトをリセット',
+  },
+  errors: {
+    networkError: 'ネットワークエラーです。接続を確認してください。',
+    serverError: 'サーバーエラーです。後でもう一度お試しください。',
+    notFound: 'リソースが見つかりません。',
+    unauthorized: 'この操作を実行する権限がありません。',
+    forbidden: 'アクセスが拒否されました。',
+    timeout: 'リクエストがタイムアウトしました。もう一度お試しください。',
+    unknown: '予期しないエラーが発生しました。',
+  },
+} as const;
+
+export default ja;

package/src/locales/ko.ts

@@ -0,0 +1,112 @@
+/**
+ * 한국어 (ko) - Korean language pack for Object UI
+ */
+const ko = {
+  common: {
+    loading: '로딩 중...',
+    save: '저장',
+    cancel: '취소',
+    delete: '삭제',
+    edit: '편집',
+    create: '생성',
+    search: '검색',
+    filter: '필터',
+    reset: '초기화',
+    confirm: '확인',
+    close: '닫기',
+    back: '뒤로',
+    next: '다음',
+    previous: '이전',
+    submit: '제출',
+    refresh: '새로고침',
+    export: '내보내기',
+    import: '가져오기',
+    yes: '예',
+    no: '아니오',
+    ok: '확인',
+    actions: '작업',
+    more: '더보기',
+    selectAll: '모두 선택',
+    clearAll: '모두 지우기',
+    noData: '데이터 없음',
+    noResults: '결과를 찾을 수 없습니다',
+    required: '필수',
+    optional: '선택',
+  },
+  validation: {
+    required: '{{field}}은(는) 필수입니다',
+    minLength: '{{field}}은(는) 최소 {{min}}자 이상이어야 합니다',
+    maxLength: '{{field}}은(는) 최대 {{max}}자까지 가능합니다',
+    min: '{{field}}은(는) {{min}} 이상이어야 합니다',
+    max: '{{field}}은(는) {{max}} 이하여야 합니다',
+    email: '유효한 이메일 주소를 입력해주세요',
+    url: '유효한 URL을 입력해주세요',
+    pattern: '{{field}} 형식이 올바르지 않습니다',
+    unique: '{{field}}은(는) 고유해야 합니다',
+    type: '{{field}}은(는) 유효한 {{type}}이어야 합니다',
+  },
+  form: {
+    addItem: '항목 추가',
+    removeItem: '항목 제거',
+    fieldRequired: '이 필드는 필수입니다',
+    invalidFormat: '형식이 올바르지 않습니다',
+    saveSuccess: '저장되었습니다',
+    saveError: '저장에 실패했습니다',
+    unsavedChanges: '저장하지 않은 변경사항이 있습니다. 페이지를 떠나시겠습니까?',
+    stepOf: '{{total}}단계 중 {{current}}단계',
+  },
+  table: {
+    rowsPerPage: '페이지당 행 수',
+    showing: '{{total}}개 중 {{from}}~{{to}} 표시',
+    noRows: '표시할 데이터가 없습니다',
+    sortAsc: '오름차순 정렬',
+    sortDesc: '내림차순 정렬',
+    filterColumn: '{{column}} 필터',
+    columns: '열',
+    exportCSV: 'CSV 내보내기',
+    exportExcel: 'Excel 내보내기',
+    selectRow: '행 선택',
+    selectAllRows: '모든 행 선택',
+    expandRow: '행 펼치기',
+    collapseRow: '행 접기',
+  },
+  calendar: {
+    today: '오늘',
+    month: '월',
+    week: '주',
+    day: '일',
+    agenda: '일정',
+    allDay: '종일',
+    noEvents: '일정이 없습니다',
+    newEvent: '새 일정',
+  },
+  kanban: {
+    addCard: '카드 추가',
+    addColumn: '열 추가',
+    moveCard: '카드 이동',
+    deleteCard: '카드 삭제',
+    deleteColumn: '열 삭제',
+  },
+  chart: {
+    noData: '차트 데이터가 없습니다',
+    loading: '차트 로딩 중...',
+  },
+  dashboard: {
+    addWidget: '위젯 추가',
+    removeWidget: '위젯 제거',
+    editLayout: '레이아웃 편집',
+    saveLayout: '레이아웃 저장',
+    resetLayout: '레이아웃 초기화',
+  },
+  errors: {
+    networkError: '네트워크 오류입니다. 연결을 확인해주세요.',
+    serverError: '서버 오류입니다. 나중에 다시 시도해주세요.',
+    notFound: '리소스를 찾을 수 없습니다.',
+    unauthorized: '이 작업을 수행할 권한이 없습니다.',
+    forbidden: '접근이 거부되었습니다.',
+    timeout: '요청 시간이 초과되었습니다. 다시 시도해주세요.',
+    unknown: '예기치 않은 오류가 발생했습니다.',
+  },
+} as const;
+
+export default ko;

package/src/locales/pt.ts

@@ -0,0 +1,112 @@
+/**
+ * Português (pt) - Portuguese language pack for Object UI
+ */
+const pt = {
+  common: {
+    loading: 'Carregando...',
+    save: 'Salvar',
+    cancel: 'Cancelar',
+    delete: 'Excluir',
+    edit: 'Editar',
+    create: 'Criar',
+    search: 'Pesquisar',
+    filter: 'Filtrar',
+    reset: 'Redefinir',
+    confirm: 'Confirmar',
+    close: 'Fechar',
+    back: 'Voltar',
+    next: 'Próximo',
+    previous: 'Anterior',
+    submit: 'Enviar',
+    refresh: 'Atualizar',
+    export: 'Exportar',
+    import: 'Importar',
+    yes: 'Sim',
+    no: 'Não',
+    ok: 'OK',
+    actions: 'Ações',
+    more: 'Mais',
+    selectAll: 'Selecionar tudo',
+    clearAll: 'Limpar tudo',
+    noData: 'Sem dados',
+    noResults: 'Nenhum resultado encontrado',
+    required: 'Obrigatório',
+    optional: 'Opcional',
+  },
+  validation: {
+    required: '{{field}} é obrigatório',
+    minLength: '{{field}} deve ter pelo menos {{min}} caracteres',
+    maxLength: '{{field}} deve ter no máximo {{max}} caracteres',
+    min: '{{field}} deve ser pelo menos {{min}}',
+    max: '{{field}} deve ser no máximo {{max}}',
+    email: 'Por favor, insira um endereço de e-mail válido',
+    url: 'Por favor, insira uma URL válida',
+    pattern: 'O formato de {{field}} é inválido',
+    unique: '{{field}} deve ser único',
+    type: '{{field}} deve ser um {{type}} válido',
+  },
+  form: {
+    addItem: 'Adicionar item',
+    removeItem: 'Remover item',
+    fieldRequired: 'Este campo é obrigatório',
+    invalidFormat: 'Formato inválido',
+    saveSuccess: 'Salvo com sucesso',
+    saveError: 'Falha ao salvar',
+    unsavedChanges: 'Você tem alterações não salvas. Tem certeza de que deseja sair?',
+    stepOf: 'Etapa {{current}} de {{total}}',
+  },
+  table: {
+    rowsPerPage: 'Linhas por página',
+    showing: 'Mostrando {{from}} a {{to}} de {{total}}',
+    noRows: 'Nenhuma linha para exibir',
+    sortAsc: 'Ordenar crescente',
+    sortDesc: 'Ordenar decrescente',
+    filterColumn: 'Filtrar {{column}}',
+    columns: 'Colunas',
+    exportCSV: 'Exportar CSV',
+    exportExcel: 'Exportar Excel',
+    selectRow: 'Selecionar linha',
+    selectAllRows: 'Selecionar todas as linhas',
+    expandRow: 'Expandir linha',
+    collapseRow: 'Recolher linha',
+  },
+  calendar: {
+    today: 'Hoje',
+    month: 'Mês',
+    week: 'Semana',
+    day: 'Dia',
+    agenda: 'Agenda',
+    allDay: 'Dia inteiro',
+    noEvents: 'Sem eventos',
+    newEvent: 'Novo evento',
+  },
+  kanban: {
+    addCard: 'Adicionar cartão',
+    addColumn: 'Adicionar coluna',
+    moveCard: 'Mover cartão',
+    deleteCard: 'Excluir cartão',
+    deleteColumn: 'Excluir coluna',
+  },
+  chart: {
+    noData: 'Nenhum dado de gráfico disponível',
+    loading: 'Carregando gráfico...',
+  },
+  dashboard: {
+    addWidget: 'Adicionar widget',
+    removeWidget: 'Remover widget',
+    editLayout: 'Editar layout',
+    saveLayout: 'Salvar layout',
+    resetLayout: 'Redefinir layout',
+  },
+  errors: {
+    networkError: 'Erro de rede. Por favor, verifique sua conexão.',
+    serverError: 'Erro no servidor. Por favor, tente novamente mais tarde.',
+    notFound: 'Recurso não encontrado.',
+    unauthorized: 'Você não tem permissão para realizar esta ação.',
+    forbidden: 'Acesso negado.',
+    timeout: 'Tempo limite excedido. Por favor, tente novamente.',
+    unknown: 'Ocorreu um erro inesperado.',
+  },
+} as const;
+
+export default pt;

package/src/locales/ru.ts

@@ -0,0 +1,112 @@
+/**
+ * Русский (ru) - Russian language pack for Object UI
+ */
+const ru = {
+  common: {
+    loading: 'Загрузка...',
+    save: 'Сохранить',
+    cancel: 'Отмена',
+    delete: 'Удалить',
+    edit: 'Редактировать',
+    create: 'Создать',
+    search: 'Поиск',
+    filter: 'Фильтр',
+    reset: 'Сбросить',
+    confirm: 'Подтвердить',
+    close: 'Закрыть',
+    back: 'Назад',
+    next: 'Далее',
+    previous: 'Назад',
+    submit: 'Отправить',
+    refresh: 'Обновить',
+    export: 'Экспорт',
+    import: 'Импорт',
+    yes: 'Да',
+    no: 'Нет',
+    ok: 'ОК',
+    actions: 'Действия',
+    more: 'Ещё',
+    selectAll: 'Выбрать все',
+    clearAll: 'Очистить все',
+    noData: 'Нет данных',
+    noResults: 'Результаты не найдены',
+    required: 'Обязательно',
+    optional: 'Необязательно',
+  },
+  validation: {
+    required: 'Поле {{field}} обязательно для заполнения',
+    minLength: '{{field}} должно содержать не менее {{min}} символов',
+    maxLength: '{{field}} должно содержать не более {{max}} символов',
+    min: '{{field}} должно быть не менее {{min}}',
+    max: '{{field}} должно быть не более {{max}}',
+    email: 'Пожалуйста, введите корректный адрес электронной почты',
+    url: 'Пожалуйста, введите корректный URL',
+    pattern: 'Неверный формат поля {{field}}',
+    unique: '{{field}} должно быть уникальным',
+    type: '{{field}} должно быть допустимым {{type}}',
+  },
+  form: {
+    addItem: 'Добавить элемент',
+    removeItem: 'Удалить элемент',
+    fieldRequired: 'Это поле обязательно',
+    invalidFormat: 'Неверный формат',
+    saveSuccess: 'Успешно сохранено',
+    saveError: 'Ошибка сохранения',
+    unsavedChanges: 'У вас есть несохранённые изменения. Вы уверены, что хотите покинуть страницу?',
+    stepOf: 'Шаг {{current}} из {{total}}',
+  },
+  table: {
+    rowsPerPage: 'Строк на странице',
+    showing: 'Показано с {{from}} по {{to}} из {{total}}',
+    noRows: 'Нет строк для отображения',
+    sortAsc: 'Сортировка по возрастанию',
+    sortDesc: 'Сортировка по убыванию',
+    filterColumn: 'Фильтр по {{column}}',
+    columns: 'Столбцы',
+    exportCSV: 'Экспорт в CSV',
+    exportExcel: 'Экспорт в Excel',
+    selectRow: 'Выбрать строку',
+    selectAllRows: 'Выбрать все строки',
+    expandRow: 'Развернуть строку',
+    collapseRow: 'Свернуть строку',
+  },
+  calendar: {
+    today: 'Сегодня',
+    month: 'Месяц',
+    week: 'Неделя',
+    day: 'День',
+    agenda: 'Расписание',
+    allDay: 'Весь день',
+    noEvents: 'Нет событий',
+    newEvent: 'Новое событие',
+  },
+  kanban: {
+    addCard: 'Добавить карточку',
+    addColumn: 'Добавить колонку',
+    moveCard: 'Переместить карточку',
+    deleteCard: 'Удалить карточку',
+    deleteColumn: 'Удалить колонку',
+  },
+  chart: {
+    noData: 'Нет данных для графика',
+    loading: 'Загрузка графика...',
+  },
+  dashboard: {
+    addWidget: 'Добавить виджет',
+    removeWidget: 'Удалить виджет',
+    editLayout: 'Редактировать макет',
+    saveLayout: 'Сохранить макет',
+    resetLayout: 'Сбросить макет',
+  },
+  errors: {
+    networkError: 'Ошибка сети. Проверьте подключение к интернету.',
+    serverError: 'Ошибка сервера. Попробуйте позже.',
+    notFound: 'Ресурс не найден.',
+    unauthorized: 'У вас нет прав для выполнения этого действия.',
+    forbidden: 'Доступ запрещён.',
+    timeout: 'Время ожидания истекло. Попробуйте снова.',
+    unknown: 'Произошла непредвиденная ошибка.',
+  },
+} as const;
+
+export default ru;

package/src/locales/zh.ts

@@ -0,0 +1,112 @@
+/**
+ * 中文 (zh) - Chinese language pack for Object UI
+ */
+const zh = {
+  common: {
+    loading: '加载中...',
+    save: '保存',
+    cancel: '取消',
+    delete: '删除',
+    edit: '编辑',
+    create: '新建',
+    search: '搜索',
+    filter: '筛选',
+    reset: '重置',
+    confirm: '确认',
+    close: '关闭',
+    back: '返回',
+    next: '下一步',
+    previous: '上一步',
+    submit: '提交',
+    refresh: '刷新',
+    export: '导出',
+    import: '导入',
+    yes: '是',
+    no: '否',
+    ok: '确定',
+    actions: '操作',
+    more: '更多',
+    selectAll: '全选',
+    clearAll: '清除全部',
+    noData: '暂无数据',
+    noResults: '未找到结果',
+    required: '必填',
+    optional: '选填',
+  },
+  validation: {
+    required: '{{field}}不能为空',
+    minLength: '{{field}}至少需要{{min}}个字符',
+    maxLength: '{{field}}最多{{max}}个字符',
+    min: '{{field}}不能小于{{min}}',
+    max: '{{field}}不能大于{{max}}',
+    email: '请输入有效的邮箱地址',
+    url: '请输入有效的URL',
+    pattern: '{{field}}格式不正确',
+    unique: '{{field}}必须唯一',
+    type: '{{field}}必须是有效的{{type}}',
+  },
+  form: {
+    addItem: '添加项目',
+    removeItem: '移除项目',
+    fieldRequired: '此字段为必填项',
+    invalidFormat: '格式不正确',
+    saveSuccess: '保存成功',
+    saveError: '保存失败',
+    unsavedChanges: '您有未保存的更改，确定要离开吗？',
+    stepOf: '第{{current}}步，共{{total}}步',
+  },
+  table: {
+    rowsPerPage: '每页行数',
+    showing: '显示第{{from}}到{{to}}条，共{{total}}条',
+    noRows: '暂无数据',
+    sortAsc: '升序排列',
+    sortDesc: '降序排列',
+    filterColumn: '筛选{{column}}',
+    columns: '列',
+    exportCSV: '导出CSV',
+    exportExcel: '导出Excel',
+    selectRow: '选择行',
+    selectAllRows: '选择所有行',
+    expandRow: '展开行',
+    collapseRow: '折叠行',
+  },
+  calendar: {
+    today: '今天',
+    month: '月',
+    week: '周',
+    day: '日',
+    agenda: '日程',
+    allDay: '全天',
+    noEvents: '暂无事件',
+    newEvent: '新建事件',
+  },
+  kanban: {
+    addCard: '添加卡片',
+    addColumn: '添加列',
+    moveCard: '移动卡片',
+    deleteCard: '删除卡片',
+    deleteColumn: '删除列',
+  },
+  chart: {
+    noData: '暂无图表数据',
+    loading: '图表加载中...',
+  },
+  dashboard: {
+    addWidget: '添加组件',
+    removeWidget: '移除组件',
+    editLayout: '编辑布局',
+    saveLayout: '保存布局',
+    resetLayout: '重置布局',
+  },
+  errors: {
+    networkError: '网络错误，请检查网络连接。',
+    serverError: '服务器错误，请稍后重试。',
+    notFound: '资源未找到。',
+    unauthorized: '您没有权限执行此操作。',
+    forbidden: '访问被拒绝。',
+    timeout: '请求超时，请重试。',
+    unknown: '发生未知错误。',
+  },
+} as const;
+
+export default zh;

package/src/provider.tsx

@@ -0,0 +1,125 @@
+/**
+ * @object-ui/i18n - React integration
+ *
+ * Provides I18nProvider and useObjectTranslation hook for React components.
+ */
+import React, { createContext, useContext, useEffect, useMemo, useState } from 'react';
+import { I18nextProvider, useTranslation } from 'react-i18next';
+import type { i18n as I18nInstance } from 'i18next';
+import { createI18n, getDirection, type I18nConfig } from './i18n';
+
+interface I18nContextValue {
+  /** Current language code */
+  language: string;
+  /** Change the active language */
+  changeLanguage: (lang: string) => Promise<void>;
+  /** Current text direction ('ltr' or 'rtl') */
+  direction: 'ltr' | 'rtl';
+  /** The underlying i18next instance */
+  i18n: I18nInstance;
+}
+
+const ObjectI18nContext = createContext<I18nContextValue | null>(null);
+
+export interface I18nProviderProps {
+  /** i18n configuration options */
+  config?: I18nConfig;
+  /** Pre-created i18next instance (overrides config) */
+  instance?: I18nInstance;
+  /** Children to render */
+  children: React.ReactNode;
+}
+
+/**
+ * I18nProvider - Wraps your app with i18n support
+ *
+ * @example
+ * ```tsx
+ * <I18nProvider config={{ defaultLanguage: 'zh' }}>
+ *   <App />
+ * </I18nProvider>
+ * ```
+ */
+export function I18nProvider({ config, instance: externalInstance, children }: I18nProviderProps) {
+  const i18nInstance = useMemo(
+    () => externalInstance || createI18n(config),
+    [externalInstance], // eslint-disable-line react-hooks/exhaustive-deps
+  );
+
+  const [language, setLanguage] = useState(i18nInstance.language || 'en');
+  const direction = getDirection(language);
+
+  useEffect(() => {
+    const handleLanguageChanged = (lng: string) => {
+      setLanguage(lng);
+      // Update document direction for RTL support
+      if (typeof document !== 'undefined') {
+        document.documentElement.dir = getDirection(lng);
+        document.documentElement.lang = lng;
+      }
+    };
+
+    i18nInstance.on('languageChanged', handleLanguageChanged);
+    return () => {
+      i18nInstance.off('languageChanged', handleLanguageChanged);
+    };
+  }, [i18nInstance]);
+
+  const contextValue = useMemo<I18nContextValue>(
+    () => ({
+      language,
+      changeLanguage: async (lang: string) => {
+        await i18nInstance.changeLanguage(lang);
+      },
+      direction,
+      i18n: i18nInstance,
+    }),
+    [language, direction, i18nInstance],
+  );
+
+  return React.createElement(
+    ObjectI18nContext.Provider,
+    { value: contextValue },
+    React.createElement(I18nextProvider, { i18n: i18nInstance }, children),
+  );
+}
+
+/**
+ * Hook to access Object UI i18n context
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { t, language, changeLanguage, direction } = useObjectTranslation();
+ *   return <div dir={direction}>{t('common.save')}</div>;
+ * }
+ * ```
+ */
+export function useObjectTranslation(ns?: string) {
+  const context = useContext(ObjectI18nContext);
+  const { t, i18n } = useTranslation(ns);
+
+  return {
+    /** Translation function */
+    t,
+    /** Current language code */
+    language: context?.language || i18n.language || 'en',
+    /** Change the active language */
+    changeLanguage: context?.changeLanguage || (async (lang: string) => { await i18n.changeLanguage(lang); }),
+    /** Current text direction */
+    direction: context?.direction || 'ltr',
+    /** The underlying i18next instance */
+    i18n,
+  };
+}
+
+/**
+ * Hook to access the i18n context directly
+ */
+export function useI18nContext(): I18nContextValue {
+  const context = useContext(ObjectI18nContext);
+  if (!context) {
+    throw new Error('useI18nContext must be used within an I18nProvider');
+  }
+  return context;
+}