@object-ui/i18n 3.1.4 → 3.3.0

package/dist/locales/zh.d.ts

@@ -32,6 +32,8 @@ declare const zh: {
         readonly noResults: "未找到结果";
         readonly required: "必填";
         readonly optional: "选填";
+        readonly selectOption: "请选择";
+        readonly select: "选择...";
     };
     readonly validation: {
         readonly required: "{{field}}不能为空";
@@ -54,6 +56,11 @@ declare const zh: {
         readonly saveError: "保存失败";
         readonly unsavedChanges: "您有未保存的更改，确定要离开吗？";
         readonly stepOf: "第{{current}}步，共{{total}}步";
+        readonly createTitle: "新建{{object}}";
+        readonly editTitle: "编辑{{object}}";
+        readonly createDescription: "向数据库添加新的{{object}}。";
+        readonly editDescription: "更新{{object}}的详情";
+        readonly saveRecord: "保存记录";
     };
     readonly table: {
         readonly rowsPerPage: "每页行数";
@@ -146,6 +153,22 @@ declare const zh: {
         readonly deleteCard: "删除卡片";
         readonly deleteColumn: "删除列";
     };
+    readonly view: {
+        readonly rename: "重命名";
+        readonly duplicateView: "复制视图";
+        readonly shareView: "共享视图";
+        readonly setAsDefault: "设为默认";
+        readonly pinView: "固定视图";
+        readonly unpinView: "取消固定";
+        readonly changeViewType: "更改视图类型";
+        readonly deleteView: "删除视图";
+        readonly addView: "添加视图";
+        readonly unsavedChanges: "未保存的更改";
+        readonly saveAsView: "另存为视图";
+        readonly moreViews: "还有 {{count}} 个";
+        readonly activeFilters: "筛选条件生效中";
+        readonly activeSort: "排序生效中";
+    };
     readonly detail: {
         readonly back: "返回";
         readonly edit: "编辑";
@@ -191,11 +214,137 @@ declare const zh: {
         readonly sortBy: "排序";
         readonly filterPlaceholder: "筛选...";
         readonly highlightFields: "关键字段";
+        readonly comments: "评论";
+        readonly searchComments: "搜索评论…";
+        readonly addCommentPlaceholder: "添加评论… (Ctrl+Enter 提交)";
+        readonly noMatchingComments: "没有匹配的评论";
+        readonly noCommentsYet: "暂无评论";
+        readonly pinned: "已置顶";
+        readonly pin: "置顶";
+        readonly unpin: "取消置顶";
+        readonly justNow: "刚刚";
+        readonly minutesAgo: "{{count}}分钟前";
+        readonly hoursAgo: "{{count}}小时前";
+        readonly daysAgo: "{{count}}天前";
+        readonly dropFilesToUpload: "拖拽文件到此处或点击上传";
+        readonly attachmentCount: "{{count}} 个附件";
+        readonly attachmentCountPlural: "{{count}} 个附件";
+        readonly removeAttachment: "移除附件";
+        readonly unifiedDiff: "统一视图";
+        readonly sideBySideDiff: "并排视图";
+        readonly noChanges: "无变更";
+        readonly previousVersion: "旧版本";
+        readonly currentVersion: "新版本";
+        readonly discussion: "讨论";
+        readonly showDiscussion: "显示讨论 ({{count}})";
+        readonly hideDiscussion: "隐藏讨论";
+        readonly bold: "粗体 (Ctrl+B)";
+        readonly italic: "斜体 (Ctrl+I)";
+        readonly listFormat: "列表";
+        readonly inlineCode: "行内代码";
+        readonly mentionSomeone: "提及某人";
+        readonly preview: "预览";
+        readonly submitComment: "提交 (Ctrl+Enter)";
+        readonly writeComment: "写评论…";
+        readonly subscribedTooltip: "已订阅 — 点击取消订阅";
+        readonly unsubscribedTooltip: "订阅通知";
+        readonly firstRecord: "第一条记录 (Home)";
+        readonly previousRecordKey: "上一条记录 (←)";
+        readonly nextRecordKey: "下一条记录 (→)";
+        readonly lastRecord: "最后一条记录 (End)";
+        readonly noRecords: "无记录";
+        readonly searchWhileNavigating: "导航时搜索";
+        readonly searchRecords: "搜索记录…";
+        readonly allActivity: "全部动态";
+        readonly commentsOnly: "仅评论";
+        readonly fieldChangesFilter: "字段变更";
+        readonly tasksOnly: "仅任务";
+        readonly leaveCommentPlaceholder: "留下评论… (Ctrl+Enter 提交)";
+        readonly noActivity: "暂无活动记录";
+        readonly loadMore: "加载更多";
+        readonly edited: "(已编辑)";
+        readonly via: "通过 {{source}}";
+        readonly replyCount: "{{count}} 条回复";
+        readonly replyCountPlural: "{{count}} 条回复";
+        readonly replyPlaceholder: "回复…";
+        readonly filterActivity: "筛选活动";
+        readonly openDiscussion: "打开讨论面板";
+        readonly closeDiscussion: "关闭讨论面板";
+        readonly subscribeAriaLabel: "订阅通知";
+        readonly unsubscribeAriaLabel: "取消订阅通知";
+        readonly clearSearch: "清除搜索";
     };
     readonly chart: {
         readonly noData: "暂无图表数据";
         readonly loading: "图表加载中...";
     };
+    readonly map: {
+        readonly searchLocations: "搜索位置…";
+        readonly locationDetails: "位置详情";
+        readonly markersCount: "{{count}} 个标记";
+        readonly invalidCoordinates: "{{count}} 条记录因坐标缺失或无效已从地图中排除。";
+        readonly invalidCoordinatesPlural: "{{count}} 条记录因坐标缺失或无效已从地图中排除。";
+    };
+    readonly workflow: {
+        readonly draft: "草稿";
+        readonly active: "活跃";
+        readonly paused: "已暂停";
+        readonly completed: "已完成";
+        readonly cancelled: "已取消";
+        readonly save: "保存";
+        readonly publish: "发布";
+        readonly addNode: "添加节点";
+        readonly workflowFlow: "工作流程";
+        readonly properties: "属性";
+        readonly connections: "连接";
+        readonly quickConnect: "快速连接";
+        readonly fromPlaceholder: "从...";
+        readonly toPlaceholder: "到...";
+        readonly connect: "连接";
+        readonly label: "标签";
+        readonly type: "类型";
+        readonly description: "描述";
+        readonly assignee: "负责人";
+        readonly assigneeType: "负责人类型";
+        readonly user: "用户";
+        readonly role: "角色";
+        readonly group: "组";
+        readonly expression: "表达式";
+        readonly timeoutMinutes: "超时时间（分钟）";
+        readonly selectNodeToEdit: "选择节点以编辑其属性";
+        readonly workflowTitle: "工作流标题";
+        readonly newWorkflow: "新工作流";
+        readonly outConnections: "{{count}} 个输出";
+        readonly start: "开始";
+        readonly end: "结束";
+        readonly task: "任务";
+        readonly userTask: "用户任务";
+        readonly serviceTask: "服务任务";
+        readonly scriptTask: "脚本任务";
+        readonly approval: "审批";
+        readonly condition: "条件";
+        readonly parallelGateway: "并行网关";
+        readonly joinGateway: "合并网关";
+        readonly boundaryEvent: "边界事件";
+        readonly delay: "延迟";
+        readonly notification: "通知";
+        readonly webhook: "Webhook";
+        readonly allowConcurrency: "允许（并发执行）";
+        readonly forbidConcurrency: "禁止（跳过新任务）";
+        readonly replaceConcurrency: "替换（取消现有任务）";
+        readonly queueConcurrency: "排队（等待当前完成）";
+        readonly conditionEvent: "条件";
+        readonly manualEvent: "手动";
+        readonly webhookEvent: "Webhook";
+        readonly timerEvent: "定时器";
+        readonly signalEvent: "信号";
+        readonly versionHistory: "版本历史";
+        readonly importBpmn: "导入 BPMN";
+        readonly exportBpmn: "导出 BPMN";
+        readonly undo: "撤销";
+        readonly redo: "重做";
+        readonly resetZoom: "重置缩放";
+    };
     readonly dashboard: {
         readonly addWidget: "添加组件";
         readonly removeWidget: "移除组件";
@@ -349,6 +498,58 @@ declare const zh: {
         readonly modeLight: "浅色";
         readonly modeDark: "深色";
         readonly mobilePreview: "移动端预览";
+        readonly objectManager: {
+            readonly title: "对象管理器";
+            readonly addObject: "新建对象";
+            readonly searchPlaceholder: "搜索对象…";
+            readonly noObjects: "未找到对象。";
+            readonly objectName: "API 名称";
+            readonly objectLabel: "标签";
+            readonly pluralLabel: "复数标签";
+            readonly icon: "图标";
+            readonly selectIcon: "选择图标…";
+            readonly group: "分组";
+            readonly noGroup: "无分组";
+            readonly sortOrder: "排序";
+            readonly enabled: "启用";
+            readonly relationships: "关系";
+            readonly systemBadge: "系统";
+            readonly fieldCount: "{{count}} 个字段";
+            readonly ungrouped: "未分组";
+            readonly deleteConfirmTitle: "删除对象？";
+            readonly deleteConfirmMessage: "这将永久删除该对象及其所有字段。此操作无法撤销。";
+        };
+        readonly fieldDesigner: {
+            readonly title: "字段设计器";
+            readonly addField: "新建字段";
+            readonly searchPlaceholder: "搜索字段…";
+            readonly allTypes: "所有类型";
+            readonly noFields: "未找到字段。";
+            readonly fieldName: "API 名称";
+            readonly fieldLabel: "标签";
+            readonly fieldType: "类型";
+            readonly fieldGroup: "分组";
+            readonly description: "描述";
+            readonly required: "必填";
+            readonly unique: "唯一";
+            readonly readOnly: "只读";
+            readonly hidden: "隐藏";
+            readonly indexed: "索引";
+            readonly externalId: "外部 ID";
+            readonly trackHistory: "追踪历史";
+            readonly defaultValue: "默认值";
+            readonly placeholder: "占位文本";
+            readonly referenceTo: "引用对象";
+            readonly formula: "公式";
+            readonly options: "选项";
+            readonly addOption: "添加选项";
+            readonly validationRules: "验证规则";
+            readonly addRule: "添加规则";
+            readonly systemBadge: "系统";
+            readonly ungrouped: "通用";
+            readonly deleteConfirmTitle: "删除字段？";
+            readonly deleteConfirmMessage: "这将永久删除该字段。此字段中的现有数据将丢失。";
+        };
     };
     readonly console: {
         readonly title: "ObjectStack 控制台";
@@ -434,7 +635,7 @@ declare const zh: {
             readonly generalHint: "视图标题、描述和类型";
             readonly toolbar: "工具栏";
             readonly toolbarHint: "搜索、筛选、排序、分组和密度切换";
-            readonly toolbarEnabledCount: "{{count}} of {{total}} enabled";
+            readonly toolbarEnabledCount: "已启用 {{count}}/{{total}} 项";
             readonly navigationSection: "导航";
             readonly navigationHint: "行点击行为和详情视图设置";
             readonly records: "记录";

package/dist/locales/zh.js

@@ -32,6 +32,8 @@ const zh = {
         noResults: '未找到结果',
         required: '必填',
         optional: '选填',
+        selectOption: '请选择',
+        select: '选择...',
     },
     validation: {
         required: '{{field}}不能为空',
@@ -54,6 +56,11 @@ const zh = {
         saveError: '保存失败',
         unsavedChanges: '您有未保存的更改，确定要离开吗？',
         stepOf: '第{{current}}步，共{{total}}步',
+        createTitle: '新建{{object}}',
+        editTitle: '编辑{{object}}',
+        createDescription: '向数据库添加新的{{object}}。',
+        editDescription: '更新{{object}}的详情',
+        saveRecord: '保存记录',
     },
     table: {
         rowsPerPage: '每页行数',
@@ -146,6 +153,22 @@ const zh = {
         deleteCard: '删除卡片',
         deleteColumn: '删除列',
     },
+    view: {
+        rename: '重命名',
+        duplicateView: '复制视图',
+        shareView: '共享视图',
+        setAsDefault: '设为默认',
+        pinView: '固定视图',
+        unpinView: '取消固定',
+        changeViewType: '更改视图类型',
+        deleteView: '删除视图',
+        addView: '添加视图',
+        unsavedChanges: '未保存的更改',
+        saveAsView: '另存为视图',
+        moreViews: '还有 {{count}} 个',
+        activeFilters: '筛选条件生效中',
+        activeSort: '排序生效中',
+    },
     detail: {
         back: '返回',
         edit: '编辑',
@@ -191,11 +214,147 @@ const zh = {
         sortBy: '排序',
         filterPlaceholder: '筛选...',
         highlightFields: '关键字段',
+        // Comments
+        comments: '评论',
+        searchComments: '搜索评论…',
+        addCommentPlaceholder: '添加评论… (Ctrl+Enter 提交)',
+        noMatchingComments: '没有匹配的评论',
+        noCommentsYet: '暂无评论',
+        pinned: '已置顶',
+        pin: '置顶',
+        unpin: '取消置顶',
+        justNow: '刚刚',
+        minutesAgo: '{{count}}分钟前',
+        hoursAgo: '{{count}}小时前',
+        daysAgo: '{{count}}天前',
+        // Attachments
+        dropFilesToUpload: '拖拽文件到此处或点击上传',
+        attachmentCount: '{{count}} 个附件',
+        attachmentCountPlural: '{{count}} 个附件',
+        removeAttachment: '移除附件',
+        // Diff
+        unifiedDiff: '统一视图',
+        sideBySideDiff: '并排视图',
+        noChanges: '无变更',
+        previousVersion: '旧版本',
+        currentVersion: '新版本',
+        // Discussion
+        discussion: '讨论',
+        showDiscussion: '显示讨论 ({{count}})',
+        hideDiscussion: '隐藏讨论',
+        // Rich text editor
+        bold: '粗体 (Ctrl+B)',
+        italic: '斜体 (Ctrl+I)',
+        listFormat: '列表',
+        inlineCode: '行内代码',
+        mentionSomeone: '提及某人',
+        preview: '预览',
+        submitComment: '提交 (Ctrl+Enter)',
+        writeComment: '写评论…',
+        // Subscription
+        subscribedTooltip: '已订阅 — 点击取消订阅',
+        unsubscribedTooltip: '订阅通知',
+        // Navigation
+        firstRecord: '第一条记录 (Home)',
+        previousRecordKey: '上一条记录 (←)',
+        nextRecordKey: '下一条记录 (→)',
+        lastRecord: '最后一条记录 (End)',
+        noRecords: '无记录',
+        searchWhileNavigating: '导航时搜索',
+        searchRecords: '搜索记录…',
+        // Activity timeline
+        allActivity: '全部动态',
+        commentsOnly: '仅评论',
+        fieldChangesFilter: '字段变更',
+        tasksOnly: '仅任务',
+        leaveCommentPlaceholder: '留下评论… (Ctrl+Enter 提交)',
+        noActivity: '暂无活动记录',
+        loadMore: '加载更多',
+        edited: '(已编辑)',
+        via: '通过 {{source}}',
+        // Replies
+        replyCount: '{{count}} 条回复',
+        replyCountPlural: '{{count}} 条回复',
+        replyPlaceholder: '回复…',
+        // 无障碍标签
+        filterActivity: '筛选活动',
+        openDiscussion: '打开讨论面板',
+        closeDiscussion: '关闭讨论面板',
+        subscribeAriaLabel: '订阅通知',
+        unsubscribeAriaLabel: '取消订阅通知',
+        clearSearch: '清除搜索',
     },
     chart: {
         noData: '暂无图表数据',
         loading: '图表加载中...',
     },
+    map: {
+        searchLocations: '搜索位置…',
+        locationDetails: '位置详情',
+        markersCount: '{{count}} 个标记',
+        invalidCoordinates: '{{count}} 条记录因坐标缺失或无效已从地图中排除。',
+        invalidCoordinatesPlural: '{{count}} 条记录因坐标缺失或无效已从地图中排除。',
+    },
+    workflow: {
+        draft: '草稿',
+        active: '活跃',
+        paused: '已暂停',
+        completed: '已完成',
+        cancelled: '已取消',
+        save: '保存',
+        publish: '发布',
+        addNode: '添加节点',
+        workflowFlow: '工作流程',
+        properties: '属性',
+        connections: '连接',
+        quickConnect: '快速连接',
+        fromPlaceholder: '从...',
+        toPlaceholder: '到...',
+        connect: '连接',
+        label: '标签',
+        type: '类型',
+        description: '描述',
+        assignee: '负责人',
+        assigneeType: '负责人类型',
+        user: '用户',
+        role: '角色',
+        group: '组',
+        expression: '表达式',
+        timeoutMinutes: '超时时间（分钟）',
+        selectNodeToEdit: '选择节点以编辑其属性',
+        workflowTitle: '工作流标题',
+        newWorkflow: '新工作流',
+        outConnections: '{{count}} 个输出',
+        start: '开始',
+        end: '结束',
+        task: '任务',
+        userTask: '用户任务',
+        serviceTask: '服务任务',
+        scriptTask: '脚本任务',
+        approval: '审批',
+        condition: '条件',
+        parallelGateway: '并行网关',
+        joinGateway: '合并网关',
+        boundaryEvent: '边界事件',
+        delay: '延迟',
+        notification: '通知',
+        webhook: 'Webhook',
+        allowConcurrency: '允许（并发执行）',
+        forbidConcurrency: '禁止（跳过新任务）',
+        replaceConcurrency: '替换（取消现有任务）',
+        queueConcurrency: '排队（等待当前完成）',
+        conditionEvent: '条件',
+        manualEvent: '手动',
+        webhookEvent: 'Webhook',
+        timerEvent: '定时器',
+        signalEvent: '信号',
+        versionHistory: '版本历史',
+        importBpmn: '导入 BPMN',
+        exportBpmn: '导出 BPMN',
+        undo: '撤销',
+        redo: '重做',
+        resetZoom: '重置缩放',
+    },
     dashboard: {
         addWidget: '添加组件',
         removeWidget: '移除组件',
@@ -349,6 +508,58 @@ const zh = {
         modeLight: '浅色',
         modeDark: '深色',
         mobilePreview: '移动端预览',
+        objectManager: {
+            title: '对象管理器',
+            addObject: '新建对象',
+            searchPlaceholder: '搜索对象…',
+            noObjects: '未找到对象。',
+            objectName: 'API 名称',
+            objectLabel: '标签',
+            pluralLabel: '复数标签',
+            icon: '图标',
+            selectIcon: '选择图标…',
+            group: '分组',
+            noGroup: '无分组',
+            sortOrder: '排序',
+            enabled: '启用',
+            relationships: '关系',
+            systemBadge: '系统',
+            fieldCount: '{{count}} 个字段',
+            ungrouped: '未分组',
+            deleteConfirmTitle: '删除对象？',
+            deleteConfirmMessage: '这将永久删除该对象及其所有字段。此操作无法撤销。',
+        },
+        fieldDesigner: {
+            title: '字段设计器',
+            addField: '新建字段',
+            searchPlaceholder: '搜索字段…',
+            allTypes: '所有类型',
+            noFields: '未找到字段。',
+            fieldName: 'API 名称',
+            fieldLabel: '标签',
+            fieldType: '类型',
+            fieldGroup: '分组',
+            description: '描述',
+            required: '必填',
+            unique: '唯一',
+            readOnly: '只读',
+            hidden: '隐藏',
+            indexed: '索引',
+            externalId: '外部 ID',
+            trackHistory: '追踪历史',
+            defaultValue: '默认值',
+            placeholder: '占位文本',
+            referenceTo: '引用对象',
+            formula: '公式',
+            options: '选项',
+            addOption: '添加选项',
+            validationRules: '验证规则',
+            addRule: '添加规则',
+            systemBadge: '系统',
+            ungrouped: '通用',
+            deleteConfirmTitle: '删除字段？',
+            deleteConfirmMessage: '这将永久删除该字段。此字段中的现有数据将丢失。',
+        },
     },
     console: {
         title: 'ObjectStack 控制台',
@@ -434,7 +645,7 @@ const zh = {
             generalHint: '视图标题、描述和类型',
             toolbar: '工具栏',
             toolbarHint: '搜索、筛选、排序、分组和密度切换',
-            toolbarEnabledCount: '{{count}} of {{total}} enabled',
+            toolbarEnabledCount: '已启用 {{count}}/{{total}} 项',
             navigationSection: '导航',
             navigationHint: '行点击行为和详情视图设置',
             records: '记录',

package/dist/useSafeTranslation.d.ts

@@ -0,0 +1,5 @@
+export declare function createSafeTranslation(defaults: Record<string, string>, testKey: string): () => {
+    t: (key: string, options?: Record<string, unknown>) => string;
+} | {
+    t: import("i18next").TFunction<string, undefined>;
+};

package/dist/useSafeTranslation.js

@@ -0,0 +1,46 @@
+/**
+ * Safe translation hook with fallback to default strings.
+ *
+ * When no I18nProvider is available (e.g., in tests or standalone usage),
+ * this hook falls back to the provided default translations instead of
+ * returning raw i18n keys.
+ *
+ * @param defaults - Fallback English translations keyed by i18n key
+ * @param testKey - A key to test if i18n is properly configured (must be in defaults)
+ */
+import { useObjectTranslation } from './provider';
+export function createSafeTranslation(defaults, testKey) {
+    return function useSafeTranslation() {
+        try {
+            const result = useObjectTranslation();
+            const testValue = result.t(testKey);
+            if (testValue === testKey) {
+                return {
+                    t: (key, options) => {
+                        let value = defaults[key] || key;
+                        if (options) {
+                            for (const [k, v] of Object.entries(options)) {
+                                value = value.replace(`{{${k}}}`, String(v));
+                            }
+                        }
+                        return value;
+                    },
+                };
+            }
+            return { t: result.t };
+        }
+        catch {
+            return {
+                t: (key, options) => {
+                    let value = defaults[key] || key;
+                    if (options) {
+                        for (const [k, v] of Object.entries(options)) {
+                            value = value.replace(`{{${k}}}`, String(v));
+                        }
+                    }
+                    return value;
+                },
+            };
+        }
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@object-ui/i18n",
-  "version": "3.1.4",
+  "version": "3.3.0",
   "type": "module",
   "sideEffects": false,
   "license": "MIT",
@@ -30,17 +30,17 @@
     }
   },
   "dependencies": {
-    "i18next": "^25.10.4",
-    "react-i18next": "^16.6.2"
+    "i18next": "^26.0.4",
+    "react-i18next": "^17.0.2"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"
   },
   "devDependencies": {
     "@types/react": "19.2.14",
-    "react": "19.2.4",
-    "typescript": "^5.9.3",
-    "vitest": "^4.1.0"
+    "react": "19.2.5",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.4"
   },
   "scripts": {
     "build": "tsc",

package/src/__tests__/i18n.test.ts

@@ -47,6 +47,17 @@ describe('@object-ui/i18n', () => {
       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', () => {
@@ -55,6 +66,22 @@ describe('@object-ui/i18n', () => {
       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', () => {

package/src/index.ts

@@ -37,6 +37,9 @@ export { createI18n, getDirection, getAvailableLanguages, type I18nConfig, type
 // React integration
 export { I18nProvider, useObjectTranslation, useI18nContext, type I18nProviderProps } from './provider';
 
+// Safe translation hook factory
+export { createSafeTranslation } from './useSafeTranslation';
+
 // Convention-based object/field label i18n
 export { useObjectLabel, useSafeFieldLabel } from './useObjectLabel';