@object-ui/i18n 3.3.0 → 3.3.2

package/dist/locales/zh.js

@@ -559,6 +559,17 @@ const zh = {
             ungrouped: '通用',
             deleteConfirmTitle: '删除字段？',
             deleteConfirmMessage: '这将永久删除该字段。此字段中的现有数据将丢失。',
+            basicSection: '基础',
+            typeSpecificSection: '类型设置',
+            advancedSection: '高级',
+            typeCategory: {
+                text: '文本',
+                number: '数字',
+                date: '日期时间',
+                choice: '选择',
+                relation: '关联',
+                advanced: '高级',
+            },
         },
     },
     console: {
@@ -575,6 +586,16 @@ const zh = {
             loadingConfig: '正在加载配置',
             preparingWorkspace: '正在准备工作区',
         },
+        error: {
+            connectionFailed: '无法连接到服务器',
+            serverUnreachable: '无法访问服务器 {{url}}。',
+            checkServer: '请检查网络连接，或确认后端服务正在运行。',
+            timeout: '连接超时（10 秒）。',
+        },
+        actions: {
+            retry: '重试',
+            retrying: '正在重试…',
+        },
         shortcuts: {
             title: '键盘快捷键',
             description: '所有可用键盘快捷键的快速参考。',
@@ -830,5 +851,62 @@ const zh = {
         timeout: '请求超时，请重试。',
         unknown: '发生未知错误。',
     },
+    workspace: {
+        label: '工作区',
+        default: '我的工作区',
+        switch: '切换工作区',
+        create: '创建工作区',
+        createTitle: '创建工作区',
+        createDescription: '工作区是团队协作的共享空间。',
+        createButton: '创建工作区',
+        nameLabel: '工作区名称',
+        namePlaceholder: '例如：极客科技',
+        slugLabel: 'URL 标识',
+        slugHint: '用于 URL 中，仅支持小写字母、数字和连字符。',
+        invite: '邀请成员',
+        members: '成员',
+        settings: '工作区设置',
+    },
+    sidebar: {
+        settings: '设置',
+        help: '帮助',
+        helpTooltip: '帮助与文档',
+        activityFeed: '活动动态',
+    },
+    home: {
+        title: '首页',
+        subtitle: '您的工作区仪表盘',
+        nav: '首页',
+        allApps: '全部应用',
+        loading: '正在加载工作区...',
+        recent: '最近使用',
+        starred: '收藏',
+        welcome: '欢迎使用 ObjectUI',
+        welcomeDescription: '从创建您的第一个应用开始，或者先完成系统设置。',
+        createFirstApp: '创建您的第一个应用',
+        systemSettings: '系统设置',
+        quickActions: {
+            title: '快捷操作',
+            createApp: '创建应用',
+            createAppDesc: '从新应用开始',
+            manageObjects: '管理对象',
+            manageObjectsDesc: '配置数据模型',
+            systemSettings: '系统设置',
+            systemSettingsDesc: '配置您的工作区',
+        },
+        recentApps: {
+            title: '最近访问',
+            itemType: {
+                object: '对象',
+                dashboard: '仪表盘',
+                page: '页面',
+                record: '记录',
+            },
+        },
+        appCard: {
+            noDescription: '暂无描述',
+            default: '默认',
+        },
+    },
 };
 export default zh;

package/dist/useObjectLabel.d.ts

@@ -50,6 +50,43 @@ export declare function useObjectLabel(): {
      * Resolve translated field label, falling back to the provided fallback string.
      */
     fieldLabel: (objectName: string, fieldName: string, fallback: string) => string;
+    /**
+     * Resolve a translated select option label for a given object field.
+     * Falls back to the provided fallback (usually the English option label).
+     */
+    fieldOptionLabel: (objectName: string, fieldName: string, optionValue: string, fallback: string) => string;
+    /**
+     * Translate all options for a given field, returning a new options array
+     * with translated labels. Pass the objectName and fieldName to look up
+     * translations; the original label is used as fallback.
+     */
+    translateOptions: (objectName: string, fieldName: string, options: Array<{
+        value: string;
+        label: string;
+        [key: string]: any;
+    }>) => Array<{
+        value: string;
+        label: string;
+        [key: string]: any;
+    }>;
+    /**
+     * Resolve translated app label, falling back to appDef.label.
+     * Looks up `{ns}.apps.{appName}.label` from loaded i18next resources.
+     */
+    appLabel: (appDef: {
+        name: string;
+        label?: string;
+    }) => string;
+    /**
+     * Resolve translated app description, falling back to appDef.description.
+     * Returns the translated value even when metadata has no description —
+     * translation-only descriptions (defined only in i18n bundles) are common
+     * in examples where the app metadata is English-only.
+     */
+    appDescription: (appDef: {
+        name: string;
+        description?: string;
+    }) => string | undefined;
 };
 /**
  * Safe wrapper for useObjectLabel that falls back to identity functions
@@ -58,4 +95,13 @@ export declare function useObjectLabel(): {
  */
 export declare function useSafeFieldLabel(): {
     fieldLabel: (objectName: string, fieldName: string, fallback: string) => string;
+    translateOptions: (objectName: string, fieldName: string, options: Array<{
+        value: string;
+        label: string;
+        [key: string]: any;
+    }>) => Array<{
+        value: string;
+        label: string;
+        [key: string]: any;
+    }>;
 };

package/dist/useObjectLabel.js

@@ -48,7 +48,8 @@ export function useObjectLabel() {
     /**
      * 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.*.
+     * an `objects`, `fields`, or `apps` sub-key — e.g. "crm" when resources
+     * include crm.objects.* or crm.apps.*.
      */
     const getAppNamespaces = () => {
         if (!i18n || typeof i18n.getResourceBundle !== 'function')
@@ -58,17 +59,30 @@ export function useObjectLabel() {
         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));
+            && (bundle[key].objects || bundle[key].fields || bundle[key].apps));
+    };
+    /**
+     * Strip an ObjectStack namespace prefix (e.g. `crm__lead` → `lead`) so that
+     * translations authored against short object names still resolve when the
+     * runtime presents fully-qualified names. The first `__` separates the
+     * package namespace from the base name; everything after is preserved.
+     */
+    const stripNamespace = (name) => {
+        const idx = name.indexOf('__');
+        return idx > 0 ? name.slice(idx + 2) : name;
     };
     /** Try resolving a key across all discovered app namespaces. */
-    const resolve = (suffix, fallback) => {
+    const resolve = (suffixes, fallback) => {
+        const suffixList = Array.isArray(suffixes) ? suffixes : [suffixes];
         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;
+                for (const suffix of suffixList) {
+                    const key = `${ns}.${suffix}`;
+                    const translated = t(key, { defaultValue: '' });
+                    if (translated && translated !== key && translated !== '') {
+                        return translated;
+                    }
                 }
             }
         }
@@ -77,23 +91,75 @@ export function useObjectLabel() {
         }
         return fallback;
     };
+    /** Build suffix candidates: prefer the given name, fall back to the base (unprefixed) name. */
+    const objectSuffixes = (objectName, tail) => {
+        const base = stripNamespace(objectName);
+        return base !== objectName
+            ? [`objects.${objectName}.${tail}`, `objects.${base}.${tail}`]
+            : [`objects.${objectName}.${tail}`];
+    };
+    const fieldSuffixes = (objectName, fieldName) => {
+        const base = stripNamespace(objectName);
+        return base !== objectName
+            ? [`fields.${objectName}.${fieldName}`, `fields.${base}.${fieldName}`]
+            : [`fields.${objectName}.${fieldName}`];
+    };
+    const optionSuffixes = (objectName, fieldName, optionValue) => {
+        const base = stripNamespace(objectName);
+        return base !== objectName
+            ? [
+                `fieldOptions.${objectName}.${fieldName}.${optionValue}`,
+                `fieldOptions.${base}.${fieldName}.${optionValue}`,
+            ]
+            : [`fieldOptions.${objectName}.${fieldName}.${optionValue}`];
+    };
     return {
         /**
          * Resolve translated object label, falling back to objectDef.label.
          */
-        objectLabel: (objectDef) => resolve(`objects.${objectDef.name}.label`, objectDef.label),
+        objectLabel: (objectDef) => resolve(objectSuffixes(objectDef.name, 'label'), objectDef.label),
         /**
          * Resolve translated object description, falling back to objectDef.description.
          */
         objectDescription: (objectDef) => {
             if (!objectDef.description)
                 return undefined;
-            return resolve(`objects.${objectDef.name}.description`, objectDef.description);
+            return resolve(objectSuffixes(objectDef.name, 'description'), objectDef.description);
         },
         /**
          * Resolve translated field label, falling back to the provided fallback string.
          */
-        fieldLabel: (objectName, fieldName, fallback) => resolve(`fields.${objectName}.${fieldName}`, fallback),
+        fieldLabel: (objectName, fieldName, fallback) => resolve(fieldSuffixes(objectName, fieldName), fallback),
+        /**
+         * Resolve a translated select option label for a given object field.
+         * Falls back to the provided fallback (usually the English option label).
+         */
+        fieldOptionLabel: (objectName, fieldName, optionValue, fallback) => resolve(optionSuffixes(objectName, fieldName, optionValue), fallback),
+        /**
+         * Translate all options for a given field, returning a new options array
+         * with translated labels. Pass the objectName and fieldName to look up
+         * translations; the original label is used as fallback.
+         */
+        translateOptions: (objectName, fieldName, options) => options.map(opt => ({
+            ...opt,
+            label: resolve(optionSuffixes(objectName, fieldName, opt.value), opt.label),
+        })),
+        /**
+         * Resolve translated app label, falling back to appDef.label.
+         * Looks up `{ns}.apps.{appName}.label` from loaded i18next resources.
+         */
+        appLabel: (appDef) => resolve(`apps.${appDef.name}.label`, appDef.label ?? appDef.name),
+        /**
+         * Resolve translated app description, falling back to appDef.description.
+         * Returns the translated value even when metadata has no description —
+         * translation-only descriptions (defined only in i18n bundles) are common
+         * in examples where the app metadata is English-only.
+         */
+        appDescription: (appDef) => {
+            const fallback = appDef.description ?? '';
+            const resolved = resolve(`apps.${appDef.name}.description`, fallback);
+            return resolved || undefined;
+        },
     };
 }
 /**
@@ -103,12 +169,13 @@ export function useObjectLabel() {
  */
 export function useSafeFieldLabel() {
     try {
-        const { fieldLabel } = useObjectLabel();
-        return { fieldLabel };
+        const { fieldLabel, translateOptions } = useObjectLabel();
+        return { fieldLabel, translateOptions };
     }
     catch {
         return {
             fieldLabel: (_objectName, _fieldName, fallback) => fallback,
+            translateOptions: (_objectName, _fieldName, options) => options,
         };
     }
 }

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@object-ui/i18n",
-  "version": "3.3.0",
+  "version": "3.3.2",
   "type": "module",
   "sideEffects": false,
   "license": "MIT",
   "description": "Internationalization (i18n) support for Object UI with 10+ language packs, RTL layout, and date/currency formatting.",
-  "homepage": "https://www.objectui.org",
+  "homepage": "https://www.objectui.org/docs/packages/i18n",
   "repository": {
     "type": "git",
-    "url": "https://github.com/objectstack-ai/objectui.git",
+    "url": "git+https://github.com/objectstack-ai/objectui.git",
     "directory": "packages/i18n"
   },
   "bugs": {
@@ -30,8 +30,8 @@
     }
   },
   "dependencies": {
-    "i18next": "^26.0.4",
-    "react-i18next": "^17.0.2"
+    "i18next": "^26.0.8",
+    "react-i18next": "^17.0.6"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"
@@ -39,9 +39,32 @@
   "devDependencies": {
     "@types/react": "19.2.14",
     "react": "19.2.5",
-    "typescript": "^6.0.2",
-    "vitest": "^4.1.4"
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
   },
+  "keywords": [
+    "objectui",
+    "sdui",
+    "schema-driven-ui",
+    "react",
+    "tailwind",
+    "shadcn",
+    "objectstack",
+    "i18n",
+    "internationalization",
+    "localization",
+    "rtl"
+  ],
+  "author": "ObjectStack Team <team@objectstack.ai>",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
   "scripts": {
     "build": "tsc",
     "test": "vitest run",

package/.turbo/turbo-build.log

@@ -1,4 +0,0 @@
-
-> @object-ui/i18n@3.3.0 build /home/runner/work/objectui/objectui/packages/i18n
-> tsc
-

package/src/__tests__/i18n.test.ts

@@ -1,255 +0,0 @@
-import { describe, it, expect, beforeEach } from 'vitest';
-import {
-  createI18n,
-  getDirection,
-  getAvailableLanguages,
-  builtInLocales,
-  isRTL,
-  RTL_LANGUAGES,
-  formatDate,
-  formatDateTime,
-  formatCurrency,
-  formatNumber,
-} from '../index';
-
-describe('@object-ui/i18n', () => {
-  describe('createI18n', () => {
-    it('creates an i18next instance with default config', () => {
-      const i18n = createI18n({ detectBrowserLanguage: false });
-      expect(i18n).toBeDefined();
-      expect(i18n.language).toBe('en');
-    });
-
-    it('creates an instance with specified default language', () => {
-      const i18n = createI18n({ defaultLanguage: 'zh', detectBrowserLanguage: false });
-      expect(i18n.language).toBe('zh');
-    });
-
-    it('loads all built-in locales', () => {
-      const i18n = createI18n({ detectBrowserLanguage: false });
-      const langs = getAvailableLanguages(i18n);
-      expect(langs).toContain('en');
-      expect(langs).toContain('zh');
-      expect(langs).toContain('ja');
-      expect(langs).toContain('ko');
-      expect(langs).toContain('de');
-      expect(langs).toContain('fr');
-      expect(langs).toContain('es');
-      expect(langs).toContain('pt');
-      expect(langs).toContain('ru');
-      expect(langs).toContain('ar');
-      expect(langs.length).toBeGreaterThanOrEqual(10);
-    });
-
-    it('translates common keys in English', () => {
-      const i18n = createI18n({ defaultLanguage: 'en', detectBrowserLanguage: false });
-      expect(i18n.t('common.save')).toBe('Save');
-      expect(i18n.t('common.cancel')).toBe('Cancel');
-      expect(i18n.t('common.delete')).toBe('Delete');
-      expect(i18n.t('common.loading')).toBe('Loading...');
-      expect(i18n.t('common.selectOption')).toBe('Select an option');
-      expect(i18n.t('common.select')).toBe('Select...');
-    });
-
-    it('translates new form keys in English', () => {
-      const i18n = createI18n({ defaultLanguage: 'en', detectBrowserLanguage: false });
-      expect(i18n.t('form.createTitle', { object: 'Contact' })).toBe('Create Contact');
-      expect(i18n.t('form.editTitle', { object: 'Contact' })).toBe('Edit Contact');
-      expect(i18n.t('form.createDescription', { object: 'Contact' })).toBe('Add a new Contact to your database.');
-      expect(i18n.t('form.editDescription', { object: 'Contact' })).toBe('Update details for Contact');
-      expect(i18n.t('form.saveRecord')).toBe('Save Record');
-    });
-
-    it('translates common keys in Chinese', () => {
-      const i18n = createI18n({ defaultLanguage: 'zh', detectBrowserLanguage: false });
-      expect(i18n.t('common.save')).toBe('保存');
-      expect(i18n.t('common.cancel')).toBe('取消');
-      expect(i18n.t('common.delete')).toBe('删除');
-      expect(i18n.t('common.loading')).toBe('加载中...');
-      expect(i18n.t('common.selectOption')).toBe('请选择');
-      expect(i18n.t('common.select')).toBe('选择...');
-    });
-
-    it('translates new form keys in Chinese', () => {
-      const i18n = createI18n({ defaultLanguage: 'zh', detectBrowserLanguage: false });
-      expect(i18n.t('form.createTitle', { object: '联系人' })).toBe('新建联系人');
-      expect(i18n.t('form.editTitle', { object: '联系人' })).toBe('编辑联系人');
-      expect(i18n.t('form.createDescription', { object: '联系人' })).toBe('向数据库添加新的联系人。');
-      expect(i18n.t('form.editDescription', { object: '联系人' })).toBe('更新联系人的详情');
-      expect(i18n.t('form.saveRecord')).toBe('保存记录');
-    });
-
-    it('translates toolbarEnabledCount in Chinese (not English fallback)', () => {
-      const i18n = createI18n({ defaultLanguage: 'zh', detectBrowserLanguage: false });
-      expect(i18n.t('console.objectView.toolbarEnabledCount', { count: 3, total: 5 })).toBe('已启用 3/5 项');
-    });
-
-    it('translates common keys in Japanese', () => {
-      const i18n = createI18n({ defaultLanguage: 'ja', detectBrowserLanguage: false });
-      expect(i18n.t('common.save')).toBe('保存');
-      expect(i18n.t('common.cancel')).toBe('キャンセル');
-    });
-
-    it('translates common keys in Korean', () => {
-      const i18n = createI18n({ defaultLanguage: 'ko', detectBrowserLanguage: false });
-      expect(i18n.t('common.save')).toBe('저장');
-      expect(i18n.t('common.cancel')).toBe('취소');
-    });
-
-    it('supports interpolation in validation messages', () => {
-      const i18n = createI18n({ defaultLanguage: 'en', detectBrowserLanguage: false });
-      expect(i18n.t('validation.required', { field: 'Name' })).toBe('Name is required');
-      expect(i18n.t('validation.minLength', { field: 'Password', min: 8 })).toBe(
-        'Password must be at least 8 characters',
-      );
-    });
-
-    it('supports interpolation in Chinese', () => {
-      const i18n = createI18n({ defaultLanguage: 'zh', detectBrowserLanguage: false });
-      expect(i18n.t('validation.required', { field: '姓名' })).toBe('姓名不能为空');
-    });
-
-    it('falls back to English for unknown language', () => {
-      const i18n = createI18n({ defaultLanguage: 'xx', fallbackLanguage: 'en', detectBrowserLanguage: false });
-      expect(i18n.t('common.save')).toBe('Save');
-    });
-
-    it('merges custom resources with built-in locales', () => {
-      const i18n = createI18n({
-        defaultLanguage: 'en',
-        detectBrowserLanguage: false,
-        resources: {
-          en: { custom: { greeting: 'Hello!' } },
-        },
-      });
-      expect(i18n.t('custom.greeting')).toBe('Hello!');
-      // Built-in translations still work
-      expect(i18n.t('common.save')).toBe('Save');
-    });
-
-    it('changes language dynamically', async () => {
-      const i18n = createI18n({ defaultLanguage: 'en', detectBrowserLanguage: false });
-      expect(i18n.t('common.save')).toBe('Save');
-
-      await i18n.changeLanguage('zh');
-      expect(i18n.language).toBe('zh');
-      expect(i18n.t('common.save')).toBe('保存');
-
-      await i18n.changeLanguage('ja');
-      expect(i18n.language).toBe('ja');
-      expect(i18n.t('common.save')).toBe('保存');
-    });
-  });
-
-  describe('getDirection', () => {
-    it('returns ltr for English', () => {
-      expect(getDirection('en')).toBe('ltr');
-    });
-
-    it('returns ltr for Chinese', () => {
-      expect(getDirection('zh')).toBe('ltr');
-    });
-
-    it('returns rtl for Arabic', () => {
-      expect(getDirection('ar')).toBe('rtl');
-    });
-
-    it('returns ltr for unknown languages', () => {
-      expect(getDirection('xx')).toBe('ltr');
-    });
-  });
-
-  describe('isRTL', () => {
-    it('returns true for Arabic', () => {
-      expect(isRTL('ar')).toBe(true);
-    });
-
-    it('returns false for English', () => {
-      expect(isRTL('en')).toBe(false);
-    });
-
-    it('returns false for Chinese', () => {
-      expect(isRTL('zh')).toBe(false);
-    });
-  });
-
-  describe('RTL_LANGUAGES', () => {
-    it('includes Arabic', () => {
-      expect(RTL_LANGUAGES).toContain('ar');
-    });
-
-    it('includes Hebrew', () => {
-      expect(RTL_LANGUAGES).toContain('he');
-    });
-  });
-
-  describe('builtInLocales', () => {
-    it('has 10 built-in language packs', () => {
-      expect(Object.keys(builtInLocales).length).toBe(10);
-    });
-
-    it('all locales have the same top-level keys', () => {
-      const enKeys = Object.keys(builtInLocales.en).sort();
-      for (const [lang, locale] of Object.entries(builtInLocales)) {
-        const keys = Object.keys(locale).sort();
-        expect(keys).toEqual(enKeys);
-      }
-    });
-
-    it('all locales have common section keys matching English', () => {
-      const enCommonKeys = Object.keys(builtInLocales.en.common).sort();
-      for (const [lang, locale] of Object.entries(builtInLocales)) {
-        const keys = Object.keys(locale.common).sort();
-        expect(keys).toEqual(enCommonKeys);
-      }
-    });
-  });
-
-  describe('formatDate', () => {
-    it('formats a date with default options', () => {
-      const result = formatDate(new Date(2026, 0, 15), { locale: 'en' });
-      expect(result).toContain('Jan');
-      expect(result).toContain('15');
-      expect(result).toContain('2026');
-    });
-
-    it('formats a date with short style', () => {
-      const result = formatDate(new Date(2026, 0, 15), { locale: 'en', style: 'short' });
-      expect(result).toContain('15');
-    });
-
-    it('returns string for invalid dates', () => {
-      const result = formatDate('invalid-date');
-      expect(result).toBe('invalid-date');
-    });
-  });
-
-  describe('formatCurrency', () => {
-    it('formats USD by default', () => {
-      const result = formatCurrency(1234.56, { locale: 'en' });
-      expect(result).toContain('1,234.56');
-    });
-
-    it('formats EUR', () => {
-      const result = formatCurrency(1234.56, { locale: 'de', currency: 'EUR' });
-      expect(result).toContain('1.234,56');
-    });
-
-    it('formats CNY', () => {
-      const result = formatCurrency(1234.56, { locale: 'zh', currency: 'CNY' });
-      expect(result).toContain('1,234.56');
-    });
-  });
-
-  describe('formatNumber', () => {
-    it('formats a number with default locale', () => {
-      const result = formatNumber(1234567.89, { locale: 'en' });
-      expect(result).toContain('1,234,567.89');
-    });
-
-    it('formats with compact notation', () => {
-      const result = formatNumber(1234567, { locale: 'en', notation: 'compact' });
-      expect(result).toContain('M'); // e.g. 1.2M
-    });
-  });
-});