@object-ui/i18n 3.0.3 → 3.1.0

package/src/locales/zh.ts

@@ -69,6 +69,33 @@ const zh = {
     selectAllRows: '选择所有行',
     expandRow: '展开行',
     collapseRow: '折叠行',
+    hideColumn: '隐藏列',
+    freezeColumn: '冻结列',
+    unfreezeColumn: '取消冻结列',
+    pageInfo: '第 {{current}} 页，共 {{total}} 页',
+    totalRecords: '共 {{count}} 条',
+    noResults: '未找到结果',
+    noResultsHint: '请尝试调整筛选条件或搜索关键词。',
+    cancelAll: '全部取消',
+    saveAll: '全部保存 ({{count}})',
+    addRecord: '添加记录',
+    open: '打开',
+    search: '搜索...',
+    modified: '{{count}} 行已修改',
+    selected: '已选择 {{count}} 项',
+  },
+  grid: {
+    actions: '操作',
+    edit: '编辑',
+    delete: '删除',
+    export: '导出',
+    exportAs: '导出为 {{format}}',
+    loading: '加载数据中...',
+    errorLoading: '数据加载失败',
+    pullToRefresh: '下拉刷新',
+    refreshing: '刷新中…',
+    openRecord: '打开记录',
+    rowHeight: '行高: {{mode}}',
   },
   calendar: {
     today: '今天',
@@ -79,6 +106,38 @@ const zh = {
     allDay: '全天',
     noEvents: '暂无事件',
     newEvent: '新建事件',
+    moreEvents: '+{{count}} 更多',
+  },
+  list: {
+    recordCount: '{{count}} 条记录',
+    recordCountOne: '{{count}} 条记录',
+    addRecord: '添加记录',
+    tabs: '标签页',
+    allRecords: '全部记录',
+    search: '搜索',
+    filter: '筛选',
+    filterRecords: '筛选记录',
+    sort: '排序',
+    sortRecords: '排序记录',
+    group: '分组',
+    groupBy: '分组依据',
+    export: '导出',
+    exportAs: '导出为 {{format}}',
+    color: '颜色',
+    rowColor: '行颜色',
+    colorByField: '按字段着色',
+    clear: '清除',
+    none: '无',
+    hideFields: '隐藏字段',
+    noItems: '未找到项目',
+    noItemsMessage: '没有可显示的记录。请尝试调整筛选条件或添加新数据。',
+    showAll: '显示全部',
+    pullToRefresh: '下拉刷新',
+    refreshing: '刷新中…',
+    share: '分享',
+    print: '打印',
+    hideFieldsTitle: '隐藏字段',
+    dataLimitReached: '显示前 {{limit}} 条记录。可能有更多数据。',
   },
   kanban: {
     addCard: '添加卡片',
@@ -87,6 +146,41 @@ const zh = {
     deleteCard: '删除卡片',
     deleteColumn: '删除列',
   },
+  detail: {
+    back: '返回',
+    edit: '编辑',
+    editInline: '内联编辑',
+    save: '保存',
+    saveChanges: '保存更改',
+    editFieldsInline: '内联编辑字段',
+    share: '分享',
+    duplicate: '复制',
+    export: '导出',
+    viewHistory: '查看历史',
+    delete: '删除',
+    moreActions: '更多操作',
+    addToFavorites: '添加到收藏',
+    removeFromFavorites: '从收藏中移除',
+    previousRecord: '上一条记录',
+    nextRecord: '下一条记录',
+    recordOf: '第 {{current}} 条，共 {{total}} 条',
+    recordNotFound: '未找到记录',
+    recordNotFoundDescription: '您查找的记录不存在或已被删除。',
+    goBack: '返回',
+    details: '详情',
+    related: '相关',
+    relatedRecords: '{{count}} 条记录',
+    relatedRecordOne: '{{count}} 条记录',
+    noRelatedRecords: '暂无相关记录',
+    loading: '加载中...',
+    copyToClipboard: '复制到剪贴板',
+    copied: '已复制！',
+    deleteConfirmation: '确定要删除此记录吗？',
+    editRecord: '编辑记录',
+    viewAll: '查看全部',
+    new: '新建',
+    emptyValue: '—',
+  },
   chart: {
     noData: '暂无图表数据',
     loading: '图表加载中...',
@@ -98,9 +192,162 @@ const zh = {
     saveLayout: '保存布局',
     resetLayout: '重置布局',
   },
+  configPanel: {
+    save: '保存',
+    discard: '丢弃',
+    close: '关闭',
+    layout: '布局',
+    columns: '列数',
+    gap: '间距',
+    rowHeight: '行高',
+    data: '数据',
+    refreshInterval: '刷新间隔',
+    appearance: '外观',
+    title: '标题',
+    showDescription: '显示描述',
+    theme: '主题',
+    configuration: '配置',
+    general: '基本',
+    advanced: '高级',
+  },
+  appDesigner: {
+    createApp: '创建应用',
+    editApp: '编辑应用',
+    basicInfo: '基本信息',
+    objects: '业务对象',
+    navigation: '导航',
+    branding: '品牌',
+    appName: '应用名称',
+    appTitle: '标题',
+    appDescription: '描述',
+    appIcon: '图标',
+    template: '模板',
+    layout: '布局',
+    layoutSidebar: '侧边栏',
+    layoutHeader: '顶部导航',
+    layoutEmpty: '空白',
+    selectObjects: '选择对象',
+    searchObjects: '搜索对象…',
+    selectAll: '全选',
+    deselectAll: '取消全选',
+    navBuilder: '导航构建器',
+    addGroup: '添加分组',
+    addUrl: '添加链接',
+    addSeparator: '添加分隔线',
+    noNavItems: '暂无导航项。',
+    logoUrl: 'Logo 链接',
+    primaryColor: '主色调',
+    faviconUrl: '网站图标链接',
+    preview: '预览',
+    complete: '完成',
+    snakeCaseHint: '必须使用 snake_case 格式（如 my_app）',
+    modeEdit: '编辑',
+    modePreview: '预览',
+    modeCode: '代码',
+    addWidget: '添加组件',
+    widgetProperties: '组件属性',
+    dataSource: '数据源',
+    valueField: '数值字段',
+    aggregate: '聚合',
+    colorVariant: '颜色',
+    addComponent: '添加组件',
+    componentProperties: '组件属性',
+    viewType: '视图类型',
+    fields: '字段',
+    toolbar: '工具栏',
+    showSearch: '显示搜索',
+    showFilters: '显示筛选',
+    showSort: '显示排序',
+    appearance: '外观',
+    rowHeight: '行高',
+    stripedRows: '斑马纹',
+    bordered: '边框',
+    livePreview: '实时预览',
+    stepBasicDesc: '名称、标题和布局',
+    stepObjectsDesc: '选择业务对象',
+    stepNavigationDesc: '构建导航树',
+    stepBrandingDesc: 'Logo、颜色和图标',
+    noObjectsFound: '未找到对象。',
+    noNavItemsHint: '暂无导航项。请在上一步选择对象或手动添加项目。',
+    separator: '分隔线',
+    separatorLabel: '— 分隔线 —',
+    newGroup: '新建分组',
+    newLink: '新建链接',
+    saveDraft: '保存草稿',
+    cancelConfirmTitle: '放弃更改？',
+    cancelConfirmMessage: '您有未保存的更改。确定要取消吗？',
+    confirmDiscard: '放弃',
+    keepEditing: '继续编辑',
+    navNoItems: '暂无导航项。点击上方按钮添加项目。',
+    navNoPreviewItems: '无项目',
+    navLivePreview: '实时预览',
+    navCollapseGroup: '折叠分组',
+    navExpandGroup: '展开分组',
+    navAddChild: '添加子项',
+    navMoveUp: '上移',
+    navMoveDown: '下移',
+    navRemove: '移除',
+    navObjectPage: '对象页面',
+    navDashboard: '仪表盘',
+    navPage: '页面',
+    navReport: '报表',
+    navGroup: '分组',
+    navUrl: '链接',
+    navSeparator: '分隔线',
+    navTypeObject: '对象',
+    navTypeDashboard: '仪表盘',
+    navTypePage: '页面',
+    navTypeReport: '报表',
+    navTypeUrl: '链接',
+    navTypeGroup: '分组',
+    navTypeSeparator: '分隔线',
+    navTypeAction: '操作',
+    navEditIcon: '编辑图标',
+    navToggleVisible: '切换可见性',
+    navHidden: '已隐藏',
+    navExportSchema: '导出 JSON',
+    navImportSchema: '导入 JSON',
+    navExportSuccess: '导航结构已导出',
+    navImportSuccess: '导航结构已导入',
+    navImportError: '无效的导航 JSON',
+    navIconPlaceholder: '图标名称（如 Users）',
+    dashboardEditor: '仪表盘编辑器',
+    noWidgets: '暂无小组件。点击上方按钮添加。',
+    widgetLayoutSize: '布局尺寸',
+    widgetWidth: '宽度',
+    widgetHeight: '高度',
+    dashboardPreview: '仪表盘预览',
+    noWidgetsPreview: '暂无可预览的小组件',
+    pageCanvasEditor: '页面画布编辑器',
+    emptyPage: '空白页面。点击上方按钮添加组件。',
+    pagePreview: '页面预览',
+    noComponentsPreview: '暂无可预览的组件',
+    modePage: '页面',
+    modeDashboard: '仪表盘',
+    undo: '撤销',
+    redo: '重做',
+    brandingEditor: '品牌编辑器',
+    brandingExport: '导出 JSON',
+    brandingImport: '导入 JSON',
+    brandingPreview: '预览',
+    brandingSampleButton: '示例按钮',
+    brandingSampleText: '这是您的品牌主题效果预览。',
+    colorPalette: '颜色面板',
+    fontFamily: '字体',
+    fontDefault: '默认（系统）',
+    modeLight: '浅色',
+    modeDark: '深色',
+    mobilePreview: '移动端预览',
+  },
   console: {
     title: 'ObjectStack 控制台',
     initializing: '正在初始化应用程序...',
+    breadcrumb: {
+      dashboards: '仪表盘',
+      pages: '页面',
+      reports: '报告',
+      system: '系统',
+    },
     loadingSteps: {
       connecting: '正在连接数据源',
       loadingConfig: '正在加载配置',
@@ -140,6 +387,7 @@ const zh = {
       systemTheme: '系统主题',
       actions: '操作',
       openFullSearch: '打开完整搜索页面',
+      createApp: '创建新应用',
     },
     errors: {
       somethingWentWrong: '出错了',
@@ -166,6 +414,130 @@ const zh = {
       addView: '添加视图',
       designTools: '设计工具',
       new: '新建',
+      configureView: '配置视图',
+      closePanel: '关闭面板',
+      page: '页面',
+      pageConfigHint: '工具栏、导航与视图外壳设置',
+      listConfigHint: '此列表类型的数据渲染、列与外观',
+      general: '常规',
+      generalHint: '视图标题、描述和类型',
+      toolbar: '工具栏',
+      toolbarHint: '搜索、筛选、排序、分组和密度切换',
+      toolbarEnabledCount: '{{count}} of {{total}} enabled',
+      navigationSection: '导航',
+      navigationHint: '行点击行为和详情视图设置',
+      records: '记录',
+      recordsHint: '选择模式、添加记录和内联编辑',
+      exportPrint: '导出与打印',
+      exportPrintHint: '导出格式、打印和记录数显示',
+      showAllFields: '全部显示',
+      hideAllFields: '全部隐藏',
+      searchFields: '搜索字段...',
+      title: '标题',
+      description: '描述',
+      data: '数据',
+      source: '数据源',
+      columns: '列',
+      filterBy: '筛选条件',
+      sortBy: '排序条件',
+      appearance: '外观',
+      showDescription: '显示描述',
+      viewType: '视图类型',
+      userFilters: '用户筛选器',
+      enableSearch: '启用搜索',
+      enableFilter: '启用筛选',
+      enableSort: '启用排序',
+      enableHideFields: '启用隐藏字段',
+      enableGroup: '启用分组',
+      enableColor: '启用颜色',
+      enableDensity: '启用密度',
+      userActions: '用户操作',
+      addRecordViaForm: '通过表单添加记录',
+      advanced: '高级',
+      allowExport: '允许导出',
+      recordCount: '{{count}} 条记录',
+      noDescription: '无描述',
+      none: '无',
+      columnsConfigured: '{{count}} 列',
+      save: '保存',
+      discard: '丢弃',
+      createView: '创建视图',
+      newView: '新视图',
+      typeOptions: '类型选项',
+      groupByField: '分组字段',
+      startDateField: '开始日期字段',
+      titleField: '标题字段',
+      latitudeField: '纬度字段',
+      longitudeField: '经度字段',
+      imageField: '图片字段',
+      dateField: '日期字段',
+      selectField: '选择字段...',
+      gridOptionsHint: '网格视图使用上方配置的列。',
+      groupBy: '分组依据',
+      prefixField: '前缀字段',
+      fields: '字段',
+      fieldsVisible: '{{count}} 个可见',
+      sortsCount: '{{count}} 个排序',
+      filtersCount: '{{count}} 个筛选',
+      endDateField: '结束日期字段',
+      color: '颜色',
+      fieldTextColor: '字段文字颜色',
+      rowHeight: '行高',
+      wrapHeaders: '自动换行标题',
+      showFieldDescriptions: '显示字段描述',
+      collapseAllByDefault: '默认全部折叠',
+      striped: '斑马纹行',
+      bordered: '边框单元格',
+      inlineEdit: '内联编辑记录',
+      addDeleteRecordsInline: '内联添加/删除记录',
+      clickIntoRecordDetails: '点击进入记录详情',
+      navigationMode: '导航模式',
+      navigationWidth: '导航宽度',
+      navigationWidthHint: '适用于抽屉、弹窗和分屏导航模式',
+      openNewTab: '在新标签页打开',
+      openNewTabHint: '适用于页面和新窗口导航模式',
+      selectionMode: '选择模式',
+      selectionNone: '无',
+      selectionSingle: '单选',
+      selectionMultiple: '多选',
+      pageSize: '每页记录数',
+      pageSizeOptions: '每页选项',
+      exportFormats: '导出格式',
+      exportMaxRecords: '最大记录数',
+      exportIncludeHeaders: '包含表头',
+      exportFileNamePrefix: '文件名前缀',
+      searchableFields: '可搜索字段',
+      filterableFields: '可筛选字段',
+      resizableColumns: '可调整列宽',
+      densityCompact: '紧凑',
+      densityComfortable: '舒适',
+      densitySpacious: '宽松',
+      densityMode: '密度模式',
+      hiddenFields: '隐藏字段',
+      rowActions: '行操作',
+      bulkActions: '批量操作',
+      sharing: '共享',
+      sharingEnabled: '启用共享',
+      sharingVisibility: '可见性',
+      addRecordEnabled: '启用添加记录',
+      addRecordPosition: '位置',
+      addRecordMode: '模式',
+      addRecordFormView: '表单视图',
+      conditionalFormatting: '条件格式',
+      addRule: '添加规则',
+      quickFilters: '快速筛选',
+      addQuickFilter: '添加快速筛选',
+      showRecordCount: '显示记录计数',
+      allowPrinting: '允许打印',
+      virtualScroll: '虚拟滚动',
+      emptyStateTitle: '空状态标题',
+      emptyStateMessage: '空状态消息',
+      emptyStateIcon: '空状态图标',
+      ariaLabel: 'ARIA 标签',
+      ariaDescribedBy: 'ARIA 描述',
+      ariaLive: 'ARIA 实时区域',
+      accessibility: '无障碍',
+      viewTabs: '视图标签',
     },
     localeSwitcher: {
       label: '语言',

package/src/provider.tsx

@@ -3,7 +3,7 @@
  *
  * Provides I18nProvider and useObjectTranslation hook for React components.
  */
-import React, { createContext, useContext, useEffect, useMemo, useState } from 'react';
+import React, { createContext, useContext, useEffect, useMemo, useRef, useState } from 'react';
 import { I18nextProvider, useTranslation } from 'react-i18next';
 import type { i18n as I18nInstance } from 'i18next';
 import { createI18n, getDirection, type I18nConfig } from './i18n';
@@ -67,6 +67,10 @@ export function I18nProvider({ config, instance: externalInstance, loadLanguage,
   const [language, setLanguage] = useState(i18nInstance.language || 'en');
   const direction = getDirection(language);
 
+  // Track which languages have had app-specific translations loaded
+  // (separate from built-in locales that ship with the library)
+  const loadedAppLangs = useRef<Set<string>>(new Set());
+
   useEffect(() => {
     const handleLanguageChanged = (lng: string) => {
       setLanguage(lng);
@@ -83,14 +87,39 @@ export function I18nProvider({ config, instance: externalInstance, loadLanguage,
     };
   }, [i18nInstance]);
 
+  // Load app-specific translations for the initial language on mount
+  useEffect(() => {
+    if (!loadLanguage) return;
+    const currentLang = i18nInstance.language || 'en';
+    if (loadedAppLangs.current.has(currentLang)) return;
+    loadedAppLangs.current.add(currentLang);
+    loadLanguage(currentLang).then((resources) => {
+      if (resources && Object.keys(resources).length > 0) {
+        i18nInstance.addResourceBundle(currentLang, 'translation', resources, true, true);
+        // Force re-render so components pick up newly loaded translations
+        setLanguage(currentLang);
+      }
+    }).catch((err) => {
+      // Allow retry on failure by removing from loaded set
+      loadedAppLangs.current.delete(currentLang);
+      console.warn(`[i18n] Failed to load app translations for '${currentLang}':`, err);
+    });
+  }, [i18nInstance, loadLanguage]);
+
   const contextValue = useMemo<I18nContextValue>(
     () => ({
       language,
       changeLanguage: async (lang: string) => {
         // Dynamic language pack loading (v2.0.7)
-        if (loadLanguage && !i18nInstance.hasResourceBundle(lang, 'translation')) {
-          const resources = await loadLanguage(lang);
-          i18nInstance.addResourceBundle(lang, 'translation', resources, true, true);
+        if (loadLanguage && !loadedAppLangs.current.has(lang)) {
+          loadedAppLangs.current.add(lang);
+          try {
+            const resources = await loadLanguage(lang);
+            i18nInstance.addResourceBundle(lang, 'translation', resources, true, true);
+          } catch (err) {
+            loadedAppLangs.current.delete(lang);
+            console.warn(`[i18n] Failed to load app translations for '${lang}':`, err);
+          }
         }
         await i18nInstance.changeLanguage(lang);
       },

package/src/useObjectLabel.ts

@@ -0,0 +1,122 @@
+/**
+ * @object-ui/i18n - Convention-based Object & Field Label i18n
+ *
+ * Provides automatic translation resolution for object metadata labels
+ * using Salesforce-style convention-based key generation.
+ *
+ * The app namespace (e.g. "crm") is discovered dynamically from loaded
+ * i18next resources — no hardcoded app names in platform code.
+ *
+ * Convention Rules:
+ * | What               | Auto-generated key                              | Fallback              |
+ * |--------------------|-------------------------------------------------|-----------------------|
+ * | Object label       | {ns}.objects.{objectName}.label                  | objectDef.label       |
+ * | Object description | {ns}.objects.{objectName}.description             | objectDef.description |
+ * | Field label        | {ns}.fields.{objectName}.{fieldName}              | field.label           |
+ *
+ * @module useObjectLabel
+ */
+
+import { useObjectTranslation } from './provider';
+
+/**
+ * Built-in Object UI top-level locale keys — not app namespaces.
+ * Update this set when new top-level platform translation keys are added
+ * to `packages/i18n/src/locales/en.ts` to prevent them from being treated
+ * as app namespaces during dynamic namespace discovery.
+ */
+const BUILTIN_KEYS = new Set([
+  'common', 'validation', 'form', 'table', 'grid', 'calendar',
+  'list', 'kanban', 'chart', 'dashboard', 'configPanel',
+  'appDesigner', 'console', 'errors', 'detail',
+]);
+
+/**
+ * Hook for convention-based auto-resolution of object and field labels.
+ *
+ * Automatically constructs i18n keys from object/field names and looks up
+ * translations, falling back to the plain-string label when no translation exists.
+ *
+ * The app namespace is discovered dynamically from loaded i18next resources
+ * by finding top-level keys that contain an `objects` sub-key.
+ *
+ * @example
+ * ```tsx
+ * const { objectLabel, fieldLabel } = useObjectLabel();
+ * <h1>{objectLabel(objectDef)}</h1>
+ * ```
+ */
+export function useObjectLabel() {
+  const { t, i18n } = useObjectTranslation();
+
+  /**
+   * Discover app namespace(s) from loaded i18next resources.
+   * Returns top-level keys (outside built-in Object UI keys) that contain
+   * an `objects` or `fields` sub-key — e.g. "crm" when resources include crm.objects.*.
+   */
+  const getAppNamespaces = (): string[] => {
+    if (!i18n || typeof i18n.getResourceBundle !== 'function') return [];
+    const lang = i18n.language || 'en';
+    const bundle = i18n.getResourceBundle(lang, 'translation') as Record<string, any> | undefined;
+    if (!bundle) return [];
+    return Object.keys(bundle).filter(
+      (key) => !BUILTIN_KEYS.has(key) && bundle[key] && typeof bundle[key] === 'object'
+        && (bundle[key].objects || bundle[key].fields),
+    );
+  };
+
+  /** Try resolving a key across all discovered app namespaces. */
+  const resolve = (suffix: string, fallback: string): string => {
+    try {
+      const namespaces = getAppNamespaces();
+      for (const ns of namespaces) {
+        const key = `${ns}.${suffix}`;
+        const translated = t(key, { defaultValue: '' });
+        if (translated && translated !== key && translated !== '') {
+          return translated;
+        }
+      }
+    } catch {
+      // Graceful degradation when i18n provider is not available
+    }
+    return fallback;
+  };
+
+  return {
+    /**
+     * Resolve translated object label, falling back to objectDef.label.
+     */
+    objectLabel: (objectDef: { name: string; label: string }) =>
+      resolve(`objects.${objectDef.name}.label`, objectDef.label),
+
+    /**
+     * Resolve translated object description, falling back to objectDef.description.
+     */
+    objectDescription: (objectDef: { name: string; description?: string }) => {
+      if (!objectDef.description) return undefined;
+      return resolve(`objects.${objectDef.name}.description`, objectDef.description);
+    },
+
+    /**
+     * Resolve translated field label, falling back to the provided fallback string.
+     */
+    fieldLabel: (objectName: string, fieldName: string, fallback: string) =>
+      resolve(`fields.${objectName}.${fieldName}`, fallback),
+  };
+}
+
+/**
+ * Safe wrapper for useObjectLabel that falls back to identity functions
+ * when no I18nProvider is available. Suitable for plugin components that
+ * may be rendered outside an i18n context.
+ */
+export function useSafeFieldLabel() {
+  try {
+    const { fieldLabel } = useObjectLabel();
+    return { fieldLabel };
+  } catch {
+    return {
+      fieldLabel: (_objectName: string, _fieldName: string, fallback: string) => fallback,
+    };
+  }
+}