@object-ui/i18n 17.2.0 → 17.3.0

package/dist/locales/zh.d.ts

@@ -81,6 +81,10 @@ declare const zh: {
         readonly select: "选择...";
         readonly openChat: "打开聊天";
         readonly closeChat: "关闭聊天";
+        readonly closePanel: "关闭面板";
+        readonly resizeDrawer: "调整面板宽度";
+        readonly itemCount: "{{count}} 项";
+        readonly itemCountOne: "{{count}} 项";
         readonly toggleSidebar: "切换侧边栏";
         readonly package: "软件包";
     };
@@ -105,6 +109,7 @@ declare const zh: {
         readonly url: "请输入有效的URL";
         readonly pattern: "{{field}}格式不正确";
         readonly formInvalid: "请检查表单中标记的字段:{{fields}}";
+        readonly formInvalidJoiner: "、";
         readonly unique: "{{field}}必须唯一";
         readonly type: "{{field}}必须是有效的{{type}}";
     };
@@ -129,12 +134,21 @@ declare const zh: {
         readonly stepOf: "第{{current}}步，共{{total}}步";
         readonly createTitle: "新建{{object}}";
         readonly editTitle: "编辑{{object}}";
+        readonly viewTitle: "查看{{object}}";
+        readonly createTargetOrg: "创建到{{org}}";
         readonly saveRecord: "保存";
         readonly create: "创建";
         readonly update: "更新";
         readonly createSuccess: "{{object}}创建成功";
         readonly updateSuccess: "{{object}}更新成功";
         readonly deleteSuccess: "{{object}}删除成功";
+        readonly fullscreen: {
+            readonly title: "编辑文本";
+            readonly description: "编辑完整的文本内容，然后保存或取消更改。";
+            readonly done: "完成";
+            readonly toggle: "全屏编辑{{label}}";
+            readonly textFallback: "文本";
+        };
     };
     readonly fields: {
         readonly relativeDate: {
@@ -174,6 +188,10 @@ declare const zh: {
             readonly basicEditorHint: "富文本编辑器（基础）";
             readonly placeholder: "请输入文字...";
         };
+        readonly options: {
+            readonly empty: "暂无可选项";
+            readonly selectFirst: "请先选择{{fields}}";
+        };
         readonly objectRef: {
             readonly loading: "正在加载对象…";
             readonly placeholder: "请选择对象";
@@ -201,6 +219,13 @@ declare const zh: {
             readonly editAsJson: "以 JSON 编辑";
             readonly useVisualBuilder: "使用可视化构建器";
         };
+        readonly tags: {
+            readonly placeholder: "输入后回车添加…";
+        };
+        readonly textarea: {
+            readonly characterCount: "已输入 {{count}} 个字符，最多 {{max}} 个";
+            readonly charactersRemaining: "还可输入 {{count}} 个字符";
+        };
     };
     readonly table: {
         readonly rowsPerPage: "每页行数";
@@ -666,6 +691,12 @@ declare const zh: {
             readonly over: "超载";
             readonly empty: "没有可分配的任务。";
         };
+        readonly quickFilter: {
+            readonly all: "全部";
+            readonly clear: "清除筛选";
+            readonly empty: "无可选项";
+            readonly resultSummary: "显示 {shown} / {total} 项任务";
+        };
         readonly readOnly: "只读";
         readonly readOnlyHint: "此视图已禁用编辑。";
         readonly lockedHint: "无编辑权限";
@@ -716,14 +747,15 @@ declare const zh: {
         readonly editInlineHint: "双击编辑";
         readonly lockedByApproval: "审批中已锁定";
         readonly lockedTooltip: "该记录有待审批的请求，编辑已被锁定";
-        readonly writeStrippedTitle: "部分字段未保存";
-        readonly writeStrippedReadonly: "以下字段为只读，未保存：{{fields}}";
-        readonly writeStrippedByState: "以下字段在记录当前状态下不可编辑，未保存：{{fields}}";
+        readonly writeStrippedTitle: "已保存，但部分字段未生效";
+        readonly writeStrippedReadonly: "以下字段为只读，未生效：{{fields}}";
+        readonly writeStrippedByState: "以下字段在记录当前状态下不可编辑，未生效：{{fields}}";
         readonly approvalPendingEditable: "审批中 · 可编辑";
         readonly approvalPendingTooltip: "该记录有待审批的请求，但当前审批节点仍允许编辑";
         readonly approvalProgress: "审批 — 已通过 {{got}} / 共需 {{need}}";
         readonly approvalProgressGroups: "会签 — 已完成 {{got}} / 共 {{need}} 个组";
         readonly approvalProgressLabel: "审批进度";
+        readonly approvalsPanelTitle: "审批";
         readonly cancelApproval: "撤回审批";
         readonly cancelApprovalInFlight: "撤回中…";
         readonly cancelApprovalTooltip: "撤回当前的待审批请求以解除记录锁定";
@@ -751,6 +783,15 @@ declare const zh: {
         readonly viewHistory: "查看历史";
         readonly delete: "删除";
         readonly moreActions: "更多操作";
+        readonly addReaction: "添加表情回应";
+        readonly pageHeaderActions: "页面标题栏操作";
+        readonly emojiPicker: "表情选择器";
+        readonly reactionCount: "{{emoji}} {{count}} 个回应";
+        readonly reactionCountOne: "{{emoji}} {{count}} 个回应";
+        readonly recordDetail: "记录详情";
+        readonly recordDetailWithLabel: "{{label}}详情";
+        readonly openAsFullPage: "以完整页面打开";
+        readonly recordDetailOverlay: "{{title}} 的记录详情浮层。";
         readonly addToFavorites: "添加到收藏";
         readonly removeFromFavorites: "从收藏中移除";
         readonly previousRecord: "上一条记录";
@@ -1378,6 +1419,13 @@ declare const zh: {
             readonly retry: "重试";
             readonly retrying: "正在重试…";
         };
+        readonly serverAction: {
+            readonly openingTitle: "正在打开…";
+            readonly openingBody: "正在打开…可能需要一点时间。";
+            readonly popupBlockedTitle: "浏览器拦截了弹窗";
+            readonly popupBlockedDescription: "浏览器阻止了新标签页的打开。";
+            readonly popupBlockedAction: "在新标签页打开";
+        };
         readonly shortcuts: {
             readonly title: "键盘快捷键";
             readonly description: "所有可用键盘快捷键的快速参考。";
@@ -1615,6 +1663,8 @@ declare const zh: {
             readonly objectNotFound: "未找到对象";
             readonly objectNotFoundDescription: "对象\"{{objectName}}\"在当前配置中不存在。";
             readonly objectNotFoundHint: "请检查您的应用导航设置或从侧边栏选择其他对象。";
+            readonly filterOrNotSavable: "该筛选条件之间使用「或」,保存到视图暂不支持这种结构。它仍会作用于当前列表 —— 取消「或」分组后才能保存到视图。";
+            readonly filterNestedNotSavable: "该筛选使用了嵌套条件分组,保存到视图不支持这种结构。请改为单层条件列表后再保存到视图。";
             readonly allRecords: "所有记录";
             readonly exitDesignMode: "退出设计模式";
             readonly enterDesignMode: "进入设计模式";
@@ -3007,5 +3057,39 @@ declare const zh: {
         readonly addSort: "添加排序";
         readonly removeSort: "删除排序";
     };
+    readonly collaboration: {
+        readonly commentCount: "{{count}} 条评论";
+        readonly commentCountOne: "{{count}} 条评论";
+        readonly resolvedSuffix: " · 已解决";
+        readonly sortComments: "评论排序";
+        readonly sortOldest: "最早优先";
+        readonly sortNewest: "最新优先";
+        readonly resolve: "标记已解决";
+        readonly reopen: "重新打开";
+        readonly justNow: "刚刚";
+        readonly minutesAgo: "{{count}} 分钟前";
+        readonly hoursAgo: "{{count}} 小时前";
+        readonly daysAgo: "{{count}} 天前";
+        readonly edited: "(已编辑)";
+        readonly reactionCount: "{{count}} 个回应";
+        readonly reactionCountOne: "{{count}} 个回应";
+        readonly addThumbsUp: "点赞";
+        readonly reply: "回复";
+        readonly reactThumbsUp: "以点赞回应";
+        readonly reactHeart: "以爱心回应";
+        readonly cancelReply: "取消回复";
+        readonly replyingTo: "正在回复 {{name}}…";
+        readonly replyingToComment: "正在回复该评论…";
+        readonly commentPlaceholder: "添加评论…(输入 @ 提及他人)";
+        readonly send: "发送";
+        readonly presentUserCount: "{{count}} 人在线";
+        readonly presentUserCountOne: "{{count}} 人在线";
+        readonly moreUserCount: "另有 {{count}} 人";
+        readonly moreUserCountOne: "另有 {{count}} 人";
+        readonly userStatusTitle: "{{name}}({{status}})";
+        readonly statusActive: "活跃";
+        readonly statusIdle: "空闲";
+        readonly statusAway: "离开";
+    };
 };
 export default zh;

package/dist/locales/zh.js

@@ -84,6 +84,10 @@ const zh = {
         select: '选择...',
         openChat: '打开聊天',
         closeChat: '关闭聊天',
+        closePanel: '关闭面板',
+        resizeDrawer: '调整面板宽度',
+        itemCount: '{{count}} 项',
+        itemCountOne: '{{count}} 项',
         toggleSidebar: '切换侧边栏',
         package: '软件包',
     },
@@ -108,6 +112,7 @@ const zh = {
         url: '请输入有效的URL',
         pattern: '{{field}}格式不正确',
         formInvalid: '请检查表单中标记的字段:{{fields}}',
+        formInvalidJoiner: '、',
         unique: '{{field}}必须唯一',
         type: '{{field}}必须是有效的{{type}}',
     },
@@ -132,12 +137,21 @@ const zh = {
         stepOf: '第{{current}}步，共{{total}}步',
         createTitle: '新建{{object}}',
         editTitle: '编辑{{object}}',
+        viewTitle: '查看{{object}}',
+        createTargetOrg: '创建到{{org}}',
         saveRecord: '保存',
         create: '创建',
         update: '更新',
         createSuccess: '{{object}}创建成功',
         updateSuccess: '{{object}}更新成功',
         deleteSuccess: '{{object}}删除成功',
+        fullscreen: {
+            title: '编辑文本',
+            description: '编辑完整的文本内容，然后保存或取消更改。',
+            done: '完成',
+            toggle: '全屏编辑{{label}}',
+            textFallback: '文本',
+        },
     },
     fields: {
         relativeDate: {
@@ -177,6 +191,10 @@ const zh = {
             basicEditorHint: '富文本编辑器（基础）',
             placeholder: '请输入文字...',
         },
+        options: {
+            empty: '暂无可选项',
+            selectFirst: '请先选择{{fields}}',
+        },
         objectRef: {
             loading: '正在加载对象…',
             placeholder: '请选择对象',
@@ -204,6 +222,13 @@ const zh = {
             editAsJson: '以 JSON 编辑',
             useVisualBuilder: '使用可视化构建器',
         },
+        tags: {
+            placeholder: '输入后回车添加…',
+        },
+        textarea: {
+            characterCount: '已输入 {{count}} 个字符，最多 {{max}} 个',
+            charactersRemaining: '还可输入 {{count}} 个字符',
+        },
     },
     table: {
         rowsPerPage: '每页行数',
@@ -678,6 +703,12 @@ const zh = {
             over: '超载',
             empty: '没有可分配的任务。',
         },
+        quickFilter: {
+            all: '全部',
+            clear: '清除筛选',
+            empty: '无可选项',
+            resultSummary: '显示 {shown} / {total} 项任务',
+        },
         readOnly: '只读',
         readOnlyHint: '此视图已禁用编辑。',
         lockedHint: '无编辑权限',
@@ -728,14 +759,15 @@ const zh = {
         editInlineHint: '双击编辑',
         lockedByApproval: '审批中已锁定',
         lockedTooltip: '该记录有待审批的请求，编辑已被锁定',
-        writeStrippedTitle: '部分字段未保存',
-        writeStrippedReadonly: '以下字段为只读，未保存：{{fields}}',
-        writeStrippedByState: '以下字段在记录当前状态下不可编辑，未保存：{{fields}}',
+        writeStrippedTitle: '已保存，但部分字段未生效',
+        writeStrippedReadonly: '以下字段为只读，未生效：{{fields}}',
+        writeStrippedByState: '以下字段在记录当前状态下不可编辑，未生效：{{fields}}',
         approvalPendingEditable: '审批中 · 可编辑',
         approvalPendingTooltip: '该记录有待审批的请求，但当前审批节点仍允许编辑',
         approvalProgress: '审批 — 已通过 {{got}} / 共需 {{need}}',
         approvalProgressGroups: '会签 — 已完成 {{got}} / 共 {{need}} 个组',
         approvalProgressLabel: '审批进度',
+        approvalsPanelTitle: '审批',
         cancelApproval: '撤回审批',
         cancelApprovalInFlight: '撤回中…',
         cancelApprovalTooltip: '撤回当前的待审批请求以解除记录锁定',
@@ -764,6 +796,15 @@ const zh = {
         viewHistory: '查看历史',
         delete: '删除',
         moreActions: '更多操作',
+        addReaction: '添加表情回应',
+        pageHeaderActions: '页面标题栏操作',
+        emojiPicker: '表情选择器',
+        reactionCount: '{{emoji}} {{count}} 个回应',
+        reactionCountOne: '{{emoji}} {{count}} 个回应',
+        recordDetail: '记录详情',
+        recordDetailWithLabel: '{{label}}详情',
+        openAsFullPage: '以完整页面打开',
+        recordDetailOverlay: '{{title}} 的记录详情浮层。',
         addToFavorites: '添加到收藏',
         removeFromFavorites: '从收藏中移除',
         previousRecord: '上一条记录',
@@ -1407,6 +1448,13 @@ const zh = {
             retry: '重试',
             retrying: '正在重试…',
         },
+        serverAction: {
+            openingTitle: '正在打开…',
+            openingBody: '正在打开…可能需要一点时间。',
+            popupBlockedTitle: '浏览器拦截了弹窗',
+            popupBlockedDescription: '浏览器阻止了新标签页的打开。',
+            popupBlockedAction: '在新标签页打开',
+        },
         shortcuts: {
             title: '键盘快捷键',
             description: '所有可用键盘快捷键的快速参考。',
@@ -1652,6 +1700,8 @@ const zh = {
             objectNotFound: '未找到对象',
             objectNotFoundDescription: '对象"{{objectName}}"在当前配置中不存在。',
             objectNotFoundHint: '请检查您的应用导航设置或从侧边栏选择其他对象。',
+            filterOrNotSavable: '该筛选条件之间使用「或」,保存到视图暂不支持这种结构。它仍会作用于当前列表 —— 取消「或」分组后才能保存到视图。',
+            filterNestedNotSavable: '该筛选使用了嵌套条件分组,保存到视图不支持这种结构。请改为单层条件列表后再保存到视图。',
             allRecords: '所有记录',
             exitDesignMode: '退出设计模式',
             enterDesignMode: '进入设计模式',
@@ -3049,5 +3099,39 @@ const zh = {
         addSort: '添加排序',
         removeSort: '删除排序',
     },
+    collaboration: {
+        commentCount: '{{count}} 条评论',
+        commentCountOne: '{{count}} 条评论',
+        resolvedSuffix: ' · 已解决',
+        sortComments: '评论排序',
+        sortOldest: '最早优先',
+        sortNewest: '最新优先',
+        resolve: '标记已解决',
+        reopen: '重新打开',
+        justNow: '刚刚',
+        minutesAgo: '{{count}} 分钟前',
+        hoursAgo: '{{count}} 小时前',
+        daysAgo: '{{count}} 天前',
+        edited: '(已编辑)',
+        reactionCount: '{{count}} 个回应',
+        reactionCountOne: '{{count}} 个回应',
+        addThumbsUp: '点赞',
+        reply: '回复',
+        reactThumbsUp: '以点赞回应',
+        reactHeart: '以爱心回应',
+        cancelReply: '取消回复',
+        replyingTo: '正在回复 {{name}}…',
+        replyingToComment: '正在回复该评论…',
+        commentPlaceholder: '添加评论…(输入 @ 提及他人)',
+        send: '发送',
+        presentUserCount: '{{count}} 人在线',
+        presentUserCountOne: '{{count}} 人在线',
+        moreUserCount: '另有 {{count}} 人',
+        moreUserCountOne: '另有 {{count}} 人',
+        userStatusTitle: '{{name}}({{status}})',
+        statusActive: '活跃',
+        statusIdle: '空闲',
+        statusAway: '离开',
+    },
 };
 export default zh;

package/dist/provider.d.ts

@@ -6,6 +6,28 @@
 import React from 'react';
 import type { i18n as I18nInstance } from 'i18next';
 import { type I18nConfig } from './i18n';
+/**
+ * `localStorage` key holding the user's explicit language choice.
+ *
+ * Follows the console's existing preference-key convention
+ * (`objectui-favorites`, `objectui-recent-items`), and sits beside the theme
+ * preference the same avatar menu writes — a language switch is a preference,
+ * not ephemeral UI state, so it belongs in storage (AGENTS.md §5 #8).
+ *
+ * Exported so an app that builds its own i18next instance (and therefore owns
+ * its bootstrap language — see {@link I18nProviderProps.instance}) can honour
+ * the same preference, and so a sign-out flow can clear it.
+ */
+export declare const LOCALE_STORAGE_KEY = "objectui-locale";
+/**
+ * Read the persisted language choice, or `null` when nothing is stored.
+ *
+ * Defensive by design: `localStorage` does not exist under SSR and *throws* on
+ * access in Safari private mode / partitioned iframes. A language preference is
+ * never worth taking the app down for, so every failure degrades to "nothing
+ * stored".
+ */
+export declare function readStoredLanguage(): string | null;
 interface I18nContextValue {
     /** Current language code */
     language: string;
@@ -39,6 +61,26 @@ export interface I18nProviderProps {
      * ```
      */
     loadLanguage?: (lang: string) => Promise<Record<string, unknown>>;
+    /**
+     * Remember the active language in `localStorage` ({@link LOCALE_STORAGE_KEY})
+     * and restore it on the next mount. Default: `true`.
+     *
+     * Every language change on the instance is persisted — whether it came from
+     * this provider's `changeLanguage`, a switcher calling
+     * `i18n.changeLanguage()` directly, or app code — because the promise the UI
+     * makes ("this is my language now") must not depend on which API the caller
+     * reached for.
+     *
+     * The *restore* half only applies to an instance this provider creates: when
+     * you pass your own {@link I18nProviderProps.instance}, its bootstrap
+     * language is yours to choose (call {@link readStoredLanguage} if you want
+     * the same preference honoured).
+     *
+     * Set `false` for surfaces that must stay on a fixed language regardless of
+     * what the user picked elsewhere on the origin — previews, demos, screenshot
+     * harnesses.
+     */
+    persistLanguage?: boolean;
     /** Children to render */
     children: React.ReactNode;
 }
@@ -52,7 +94,7 @@ export interface I18nProviderProps {
  * </I18nProvider>
  * ```
  */
-export declare function I18nProvider({ config, instance: externalInstance, loadLanguage, children }: I18nProviderProps): React.FunctionComponentElement<React.ProviderProps<I18nContextValue | null>>;
+export declare function I18nProvider({ config, instance: externalInstance, loadLanguage, persistLanguage, children, }: I18nProviderProps): React.FunctionComponentElement<React.ProviderProps<I18nContextValue | null>>;
 /**
  * Hook to access Object UI i18n context
  *

package/dist/provider.js

@@ -6,6 +6,100 @@
 import React, { createContext, useContext, useEffect, useMemo, useRef, useState } from 'react';
 import { I18nextProvider, useTranslation } from 'react-i18next';
 import { createI18n, getDirection } from './i18n';
+import { builtInLocales } from './locales/index';
+/**
+ * `localStorage` key holding the user's explicit language choice.
+ *
+ * Follows the console's existing preference-key convention
+ * (`objectui-favorites`, `objectui-recent-items`), and sits beside the theme
+ * preference the same avatar menu writes — a language switch is a preference,
+ * not ephemeral UI state, so it belongs in storage (AGENTS.md §5 #8).
+ *
+ * Exported so an app that builds its own i18next instance (and therefore owns
+ * its bootstrap language — see {@link I18nProviderProps.instance}) can honour
+ * the same preference, and so a sign-out flow can clear it.
+ */
+export const LOCALE_STORAGE_KEY = 'objectui-locale';
+/**
+ * Read the persisted language choice, or `null` when nothing is stored.
+ *
+ * Defensive by design: `localStorage` does not exist under SSR and *throws* on
+ * access in Safari private mode / partitioned iframes. A language preference is
+ * never worth taking the app down for, so every failure degrades to "nothing
+ * stored".
+ */
+export function readStoredLanguage() {
+    if (typeof window === 'undefined')
+        return null;
+    try {
+        return window.localStorage.getItem(LOCALE_STORAGE_KEY);
+    }
+    catch {
+        return null;
+    }
+}
+function writeStoredLanguage(lang) {
+    if (typeof window === 'undefined')
+        return;
+    try {
+        window.localStorage.setItem(LOCALE_STORAGE_KEY, lang);
+    }
+    catch {
+        // Storage blocked or full — the switch still applies for this session.
+    }
+}
+function clearStoredLanguage() {
+    if (typeof window === 'undefined')
+        return;
+    try {
+        window.localStorage.removeItem(LOCALE_STORAGE_KEY);
+    }
+    catch {
+        // Nothing readable means nothing to purge.
+    }
+}
+/**
+ * Languages `createI18n(config)` will know about: the built-in packs plus any
+ * extra `config.resources`.
+ *
+ * `hasOwnProperty` rather than `in`: a junk stored value like `constructor`
+ * would pass an `in` check against the locale map's prototype.
+ */
+function isKnownLanguage(lang, config) {
+    const own = Object.prototype.hasOwnProperty;
+    return own.call(builtInLocales, lang) || Boolean(config?.resources && own.call(config.resources, lang));
+}
+/**
+ * Resolve the bootstrap config for a provider-owned i18next instance, applying
+ * a stored language choice when there is a usable one.
+ *
+ * Applied at instance creation rather than through a post-mount
+ * `changeLanguage`, because the very first render must already be in the right
+ * locale: `<html lang>` seeds the `Accept-Language` header on every API call
+ * (`createAuthenticatedFetch`, issue #1319), so a late switch would fetch the
+ * first wave of server-resolved metadata labels in the wrong language and then
+ * have to remount to fix it.
+ *
+ * A stored choice outranks browser detection (which itself outranks
+ * `defaultLanguage` in `createI18n`) — otherwise a user who picked 中文 on a
+ * `ja` browser would be handed `ja` back on every reload, and the preference
+ * would be unusable for exactly the users who need it.
+ *
+ * A stored value the app no longer offers is dropped *and purged*, so one stale
+ * entry can never lock the UI to a locale that has no translations.
+ */
+function resolveBootstrapConfig(config, persist) {
+    if (!persist)
+        return config;
+    const stored = readStoredLanguage();
+    if (!stored)
+        return config;
+    if (!isKnownLanguage(stored, config)) {
+        clearStoredLanguage();
+        return config;
+    }
+    return { ...config, defaultLanguage: stored, detectBrowserLanguage: false };
+}
 const ObjectI18nContext = createContext(null);
 /**
  * I18nProvider - Wraps your app with i18n support
@@ -17,8 +111,8 @@ const ObjectI18nContext = createContext(null);
  * </I18nProvider>
  * ```
  */
-export function I18nProvider({ config, instance: externalInstance, loadLanguage, children }) {
-    const i18nInstance = useMemo(() => externalInstance || createI18n(config), [externalInstance, config]);
+export function I18nProvider({ config, instance: externalInstance, loadLanguage, persistLanguage = true, children, }) {
+    const i18nInstance = useMemo(() => externalInstance || createI18n(resolveBootstrapConfig(config, persistLanguage)), [externalInstance, config, persistLanguage]);
     const [language, setLanguage] = useState(i18nInstance.language || 'en');
     const direction = getDirection(language);
     // Track which languages have had app-specific translations loaded
@@ -27,6 +121,14 @@ export function I18nProvider({ config, instance: externalInstance, loadLanguage,
     useEffect(() => {
         const handleLanguageChanged = (lng) => {
             setLanguage(lng);
+            // Remember the choice. This is the single choke point every switch runs
+            // through — i18next fires `languageChanged` for the context's
+            // `changeLanguage` and for a direct `i18n.changeLanguage()` alike — so no
+            // switcher can be wired in a way that silently forgets the preference.
+            // Bootstrap does NOT fire this event, so restoring a stored language
+            // never re-writes it.
+            if (persistLanguage)
+                writeStoredLanguage(lng);
             // Update document direction for RTL support
             if (typeof document !== 'undefined') {
                 document.documentElement.dir = getDirection(lng);
@@ -49,7 +151,7 @@ export function I18nProvider({ config, instance: externalInstance, loadLanguage,
         return () => {
             i18nInstance.off('languageChanged', handleLanguageChanged);
         };
-    }, [i18nInstance]);
+    }, [i18nInstance, persistLanguage]);
     // Load app-specific translations for the initial language on mount
     useEffect(() => {
         if (!loadLanguage)

package/dist/useSafeTranslation.js

@@ -17,7 +17,23 @@ export function createSafeTranslation(defaults, testKey) {
         let value = defaults[key] || key;
         if (options) {
             for (const [k, v] of Object.entries(options)) {
-                value = value.replace(`{{${k}}}`, String(v));
+                // `split(needle).join(value)` — deliberately not `replace`, and not
+                // `replaceAll` either (objectui#3418). This path must agree with
+                // i18next, which serves the *provider* path; any divergence is a
+                // silent fork that only shows up on provider-less hosts, where we are
+                // least likely to see it:
+                //   1. `replace` with a string needle substitutes only the FIRST
+                //      occurrence. i18next substitutes every one, so a sentence that
+                //      repeats a placeholder ("Selected {{count}} of {{count}} items"
+                //      — natural in many locales, and often required by RTL /
+                //      agglutinative word order) leaked literal braces to users.
+                //   2. `replace` AND `replaceAll` both interpret `$&`, `` $` ``, `$'`
+                //      and `$$` in the *replacement* string. i18next does not. Values
+                //      here are runtime data — record labels, search terms — so this
+                //      one is reachable today, unlike (1).
+                // split/join is literal on both sides, which is exactly i18next's
+                // behaviour, and needs no regex escaping of the placeholder name.
+                value = value.split(`{{${k}}}`).join(String(v));
             }
         }
         return value;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@object-ui/i18n",
-  "version": "17.2.0",
+  "version": "17.3.0",
   "type": "module",
   "sideEffects": false,
   "license": "MIT",
@@ -37,7 +37,7 @@
     "react": "^18.0.0 || ^19.0.0"
   },
   "devDependencies": {
-    "@types/react": "19.2.17",
+    "@types/react": "19.2.18",
     "react": "19.2.8",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"