@object-ui/i18n 17.1.0 → 17.3.0

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,11 +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: '撤回当前的待审批请求以解除记录锁定',
@@ -761,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: '上一条记录',
@@ -1404,6 +1448,13 @@ const zh = {
             retry: '重试',
             retrying: '正在重试…',
         },
+        serverAction: {
+            openingTitle: '正在打开…',
+            openingBody: '正在打开…可能需要一点时间。',
+            popupBlockedTitle: '浏览器拦截了弹窗',
+            popupBlockedDescription: '浏览器阻止了新标签页的打开。',
+            popupBlockedAction: '在新标签页打开',
+        },
         shortcuts: {
             title: '键盘快捷键',
             description: '所有可用键盘快捷键的快速参考。',
@@ -1649,6 +1700,8 @@ const zh = {
             objectNotFound: '未找到对象',
             objectNotFoundDescription: '对象"{{objectName}}"在当前配置中不存在。',
             objectNotFoundHint: '请检查您的应用导航设置或从侧边栏选择其他对象。',
+            filterOrNotSavable: '该筛选条件之间使用「或」,保存到视图暂不支持这种结构。它仍会作用于当前列表 —— 取消「或」分组后才能保存到视图。',
+            filterNestedNotSavable: '该筛选使用了嵌套条件分组,保存到视图不支持这种结构。请改为单层条件列表后再保存到视图。',
             allRecords: '所有记录',
             exitDesignMode: '退出设计模式',
             enterDesignMode: '进入设计模式',
@@ -2648,6 +2701,19 @@ const zh = {
         addEnvironment: '新建环境',
         setUpProduction: '创建你的生产环境',
         addDevelopment: '新建开发环境',
+        entitlement: {
+            productionLimitTitle: '你已经有生产环境了',
+            productionLimitBody: '每个组织只包含一个生产环境。如果还需要，可以新建一个组织，或者联系我们了解企业版方案。',
+            planLockedTitle: '开发环境是付费功能',
+            planLockedBody: '{{plan}}包含一个生产环境。升级后即可添加开发环境 —— 先在开发环境里搭建，确认无误再发布到生产环境。',
+            limitTitle: '开发环境数量已达上限',
+            limitBody: '容量随 AI 席位增长。增加一个 AI 席位，或归档一个不再使用的开发环境来腾出名额。',
+            limitBodyWithCount: '开发环境已使用 {{used}}/{{limit}} 个。容量随 AI 席位增长 —— 增加一个 AI 席位，或归档一个不再使用的开发环境来腾出名额。',
+            freePlan: '免费版',
+            namedPlan: '{{plan}} 版',
+            upgradeCta: '升级套餐',
+            contactSalesCta: '联系销售',
+        },
     },
     cloudConnection: {
         checking: '正在检查连接…',
@@ -3033,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/useObjectLabel.js

@@ -185,6 +185,23 @@ export function useObjectLabel() {
                 ? [`reports.${reportName}.${tail}`, `reports.${base}.${tail}`]
                 : [`reports.${reportName}.${tail}`];
         };
+        /**
+         * Build suffix candidates for a list-view scoped key.
+         *
+         * The runtime uses qualified view ids (`<objectName>.<viewName>`) in URLs
+         * and metadata records, while translation bundles are keyed by the authored
+         * view name under `_views`. Resolve the unqualified name first so every
+         * surface can pass its canonical id without leaking the metadata fallback.
+         */
+        const viewSuffixes = (objectName, viewName, tail) => {
+            const objectNames = [objectName, stripNamespace(objectName)];
+            const matchedPrefix = objectNames
+                .map((name) => `${name}.`)
+                .find((prefix) => viewName.startsWith(prefix));
+            const shortViewName = matchedPrefix ? viewName.slice(matchedPrefix.length) : viewName;
+            const viewNames = shortViewName === viewName ? [viewName] : [shortViewName, viewName];
+            return viewNames.flatMap((name) => objectSuffixes(objectName, `_views.${name}.${tail}`));
+        };
         return {
             /**
              * Resolve translated object label, falling back to objectDef.label.
@@ -294,14 +311,14 @@ export function useObjectLabel() {
              * Resolve translated list-view label.
              * Convention (per @objectstack/spec): `{ns}.objects.{objectName}._views.{viewName}.label`.
              */
-            viewLabel: (objectName, viewName, fallback) => resolve(objectSuffixes(objectName, `_views.${viewName}.label`), fallback),
+            viewLabel: (objectName, viewName, fallback) => resolve(viewSuffixes(objectName, viewName, 'label'), fallback),
             /**
              * Resolve translated list-view description.
              * Convention: `{ns}.objects.{objectName}._views.{viewName}.description`.
              */
             viewDescription: (objectName, viewName, fallback) => {
                 const fb = fallback ?? '';
-                const resolved = resolve(objectSuffixes(objectName, `_views.${viewName}.description`), fb);
+                const resolved = resolve(viewSuffixes(objectName, viewName, 'description'), fb);
                 return resolved || undefined;
             },
             /**
@@ -314,10 +331,10 @@ export function useObjectLabel() {
                 if (!fallback)
                     return undefined;
                 const title = fallback.title
-                    ? resolve(objectSuffixes(objectName, `_views.${viewName}.emptyState.title`), fallback.title)
+                    ? resolve(viewSuffixes(objectName, viewName, 'emptyState.title'), fallback.title)
                     : fallback.title;
                 const message = fallback.message
-                    ? resolve(objectSuffixes(objectName, `_views.${viewName}.emptyState.message`), fallback.message)
+                    ? resolve(viewSuffixes(objectName, viewName, 'emptyState.message'), fallback.message)
                     : fallback.message;
                 return { ...fallback, title, message };
             },

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.1.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"