@object-ui/i18n 4.3.0 → 4.5.0

package/dist/useObjectLabel.js

@@ -16,6 +16,7 @@
  *
  * @module useObjectLabel
  */
+import { useMemo } from 'react';
 import { useObjectTranslation } from './provider';
 /**
  * Built-in Object UI top-level locale keys — not app namespaces.
@@ -45,282 +46,299 @@ const BUILTIN_KEYS = new Set([
  */
 export function useObjectLabel() {
     const { t, i18n } = useObjectTranslation();
-    /**
-     * Discover app namespace(s) from loaded i18next resources.
-     * Returns top-level keys (outside built-in Object UI keys) that contain
-     * an `objects`, `fields`, or `apps` sub-key — e.g. "crm" when resources
-     * include crm.objects.* or crm.apps.*.
-     */
-    const getAppNamespaces = () => {
-        if (!i18n || typeof i18n.getResourceBundle !== 'function')
-            return [];
-        const lang = i18n.language || 'en';
-        const bundle = i18n.getResourceBundle(lang, 'translation');
-        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].apps
-                || bundle[key].dashboards || bundle[key].pages || bundle[key].reports));
-    };
-    /**
-     * 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 = (suffixes, fallback) => {
-        const suffixList = Array.isArray(suffixes) ? suffixes : [suffixes];
-        try {
-            const namespaces = getAppNamespaces();
-            for (const ns of namespaces) {
-                for (const suffix of suffixList) {
-                    const key = `${ns}.${suffix}`;
-                    const translated = t(key, { defaultValue: '' });
-                    if (translated && translated !== key && translated !== '') {
-                        return translated;
-                    }
-                }
-            }
-        }
-        catch {
-            // Graceful degradation when i18n provider is not available
-        }
-        return fallback;
-    };
-    /** 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}`];
-    };
-    /**
-     * Build suffix candidates for a dashboard-scoped key. Mirrors the
-     * object/field convention: prefer the (possibly namespaced) dashboard name,
-     * fall back to the unprefixed base name.
-     */
-    const dashboardSuffixes = (dashboardName, tail) => {
-        const base = stripNamespace(dashboardName);
-        return base !== dashboardName
-            ? [`dashboards.${dashboardName}.${tail}`, `dashboards.${base}.${tail}`]
-            : [`dashboards.${dashboardName}.${tail}`];
-    };
-    /**
-     * Build suffix candidates for a page-scoped key.
-     */
-    const pageSuffixes = (pageName, tail) => {
-        const base = stripNamespace(pageName);
-        return base !== pageName
-            ? [`pages.${pageName}.${tail}`, `pages.${base}.${tail}`]
-            : [`pages.${pageName}.${tail}`];
-    };
-    /**
-     * Build suffix candidates for a report-scoped key.
-     */
-    const reportSuffixes = (reportName, tail) => {
-        const base = stripNamespace(reportName);
-        return base !== reportName
-            ? [`reports.${reportName}.${tail}`, `reports.${base}.${tail}`]
-            : [`reports.${reportName}.${tail}`];
-    };
-    return {
-        /**
-         * Resolve translated object label, falling back to 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(objectSuffixes(objectDef.name, 'description'), objectDef.description);
-        },
-        /**
-         * Resolve translated field label, falling back to the provided fallback string.
-         */
-        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;
-        },
-        /**
-         * Resolve translated label for a navigation group within an app.
-         * Convention: `{ns}.apps.{appName}.navigation.{groupId}.label`.
-         *
-         * Mirrors `objectLabel`/`dashboardLabel` so app metadata can keep
-         * English fallbacks while translation packs supply localised
-         * sidebar group labels (e.g. "Sales" → "销售") without explicit
-         * I18nLabel `{ key, defaultValue }` annotations.
-         */
-        navGroupLabel: (appName, groupId, fallback) => resolve(`apps.${appName}.navigation.${groupId}.label`, fallback),
-        /**
-         * Resolve translated dashboard label, falling back to dashboardDef.label.
-         * Convention: `{ns}.dashboards.{dashboardName}.label`.
-         */
-        dashboardLabel: (dashboardDef) => resolve(dashboardSuffixes(dashboardDef.name, 'label'), dashboardDef.label ?? dashboardDef.name),
-        /**
-         * Resolve translated dashboard description, falling back to
-         * dashboardDef.description. Returns undefined when neither metadata nor
-         * translation provides one.
-         * Convention: `{ns}.dashboards.{dashboardName}.description`.
-         */
-        dashboardDescription: (dashboardDef) => {
-            const fallback = dashboardDef.description ?? '';
-            const resolved = resolve(dashboardSuffixes(dashboardDef.name, 'description'), fallback);
-            return resolved || undefined;
-        },
-        /**
-         * Resolve translated dashboard header-action label.
-         * Convention: `{ns}.dashboards.{dashboardName}.actions.{actionKey}.label`.
-         * The actionKey is typically the action's `actionUrl` (e.g.
-         * `create_opportunity`) or its English label slugified.
-         */
-        dashboardActionLabel: (dashboardName, actionKey, fallback) => resolve(dashboardSuffixes(dashboardName, `actions.${actionKey}.label`), fallback),
-        /**
-         * Resolve translated widget title within a dashboard.
-         * Convention: `{ns}.dashboards.{dashboardName}.widgets.{widgetId}.title`.
-         */
-        widgetTitle: (dashboardName, widgetId, fallback) => resolve(dashboardSuffixes(dashboardName, `widgets.${widgetId}.title`), fallback),
-        /**
-         * Resolve translated widget description within a dashboard.
-         * Convention: `{ns}.dashboards.{dashboardName}.widgets.{widgetId}.description`.
-         * Returns undefined when neither metadata nor translation provides one.
-         */
-        widgetDescription: (dashboardName, widgetId, fallback) => {
-            const fb = fallback ?? '';
-            const resolved = resolve(dashboardSuffixes(dashboardName, `widgets.${widgetId}.description`), fb);
-            return resolved || undefined;
-        },
-        /**
-         * Resolve translated page label, falling back to pageDef.label.
-         * Convention: `{ns}.pages.{pageName}.label`.
-         */
-        pageLabel: (pageDef) => resolve(pageSuffixes(pageDef.name, 'label'), pageDef.label ?? pageDef.name),
-        /**
-         * Resolve translated report label, falling back to reportDef.label.
-         * Convention: `{ns}.reports.{reportName}.label`.
-         */
-        reportLabel: (reportDef) => resolve(reportSuffixes(reportDef.name, 'label'), reportDef.label ?? reportDef.name),
-        /**
-         * 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),
+    // Memoize the entire returned object — all closures below reference `t`/`i18n`
+    // and stay valid until the language changes. Returning a fresh object on every
+    // render was busting downstream `useMemo`/`useCallback` deps in heavy consumers
+    // like ListView.filterFields, causing avoidable recomputation.
+    return useMemo(() => {
         /**
-         * Resolve translated list-view description.
-         * Convention: `{ns}.objects.{objectName}._views.{viewName}.description`.
+         * Discover app namespace(s) from loaded i18next resources.
+         * Returns top-level keys (outside built-in Object UI keys) that contain
+         * an `objects`, `fields`, or `apps` sub-key — e.g. "crm" when resources
+         * include crm.objects.* or crm.apps.*.
          */
-        viewDescription: (objectName, viewName, fallback) => {
-            const fb = fallback ?? '';
-            const resolved = resolve(objectSuffixes(objectName, `_views.${viewName}.description`), fb);
-            return resolved || undefined;
-        },
+        const getAppNamespaces = () => {
+            if (!i18n || typeof i18n.getResourceBundle !== 'function')
+                return [];
+            const lang = i18n.language || 'en';
+            const bundle = i18n.getResourceBundle(lang, 'translation');
+            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].apps
+                    || bundle[key].dashboards || bundle[key].pages || bundle[key].reports));
+        };
         /**
-         * Resolve translated form-section label.
-         * Convention: `{ns}.objects.{objectName}._sections.{sectionName}.label`.
+         * 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.
          */
-        sectionLabel: (objectName, sectionName, fallback) => resolve(objectSuffixes(objectName, `_sections.${sectionName}.label`), fallback),
+        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 = (suffixes, fallback) => {
+            const suffixList = Array.isArray(suffixes) ? suffixes : [suffixes];
+            try {
+                const namespaces = getAppNamespaces();
+                for (const ns of namespaces) {
+                    for (const suffix of suffixList) {
+                        const key = `${ns}.${suffix}`;
+                        const translated = t(key, { defaultValue: '' });
+                        if (translated && translated !== key && translated !== '') {
+                            return translated;
+                        }
+                    }
+                }
+            }
+            catch {
+                // Graceful degradation when i18n provider is not available
+            }
+            return fallback;
+        };
+        /** 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}`];
+        };
         /**
-         * Resolve translated action label.
-         * Convention: `{ns}.objects.{objectName}._actions.{actionName}.label`.
-         * Falls back to `{ns}.globalActions.{actionName}.label` when objectName is omitted.
+         * Build suffix candidates for a dashboard-scoped key. Mirrors the
+         * object/field convention: prefer the (possibly namespaced) dashboard name,
+         * fall back to the unprefixed base name.
          */
-        actionLabel: (objectName, actionName, fallback) => {
-            if (objectName) {
-                return resolve(objectSuffixes(objectName, `_actions.${actionName}.label`), fallback);
-            }
-            return resolve(`globalActions.${actionName}.label`, fallback);
-        },
+        const dashboardSuffixes = (dashboardName, tail) => {
+            const base = stripNamespace(dashboardName);
+            return base !== dashboardName
+                ? [`dashboards.${dashboardName}.${tail}`, `dashboards.${base}.${tail}`]
+                : [`dashboards.${dashboardName}.${tail}`];
+        };
         /**
-         * Resolve translated action confirmation prompt.
-         * Convention: `{ns}.objects.{objectName}._actions.{actionName}.confirmText`.
-         * Returns undefined when no translation and no fallback exist.
+         * Build suffix candidates for a page-scoped key.
          */
-        actionConfirm: (objectName, actionName, fallback) => {
-            const fb = fallback ?? '';
-            const suffixes = objectName
-                ? objectSuffixes(objectName, `_actions.${actionName}.confirmText`)
-                : `globalActions.${actionName}.confirmText`;
-            const resolved = resolve(suffixes, fb);
-            return resolved || undefined;
-        },
+        const pageSuffixes = (pageName, tail) => {
+            const base = stripNamespace(pageName);
+            return base !== pageName
+                ? [`pages.${pageName}.${tail}`, `pages.${base}.${tail}`]
+                : [`pages.${pageName}.${tail}`];
+        };
         /**
-         * Resolve translated action success message.
-         * Convention: `{ns}.objects.{objectName}._actions.{actionName}.successMessage`.
+         * Build suffix candidates for a report-scoped key.
          */
-        actionSuccess: (objectName, actionName, fallback) => {
-            const fb = fallback ?? '';
-            const suffixes = objectName
-                ? objectSuffixes(objectName, `_actions.${actionName}.successMessage`)
-                : `globalActions.${actionName}.successMessage`;
-            const resolved = resolve(suffixes, fb);
-            return resolved || undefined;
-        },
-    };
+        const reportSuffixes = (reportName, tail) => {
+            const base = stripNamespace(reportName);
+            return base !== reportName
+                ? [`reports.${reportName}.${tail}`, `reports.${base}.${tail}`]
+                : [`reports.${reportName}.${tail}`];
+        };
+        return {
+            /**
+             * Resolve translated object label, falling back to 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(objectSuffixes(objectDef.name, 'description'), objectDef.description);
+            },
+            /**
+             * Resolve translated field label, falling back to the provided fallback string.
+             */
+            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;
+            },
+            /**
+             * Resolve translated label for a navigation group within an app.
+             * Convention: `{ns}.apps.{appName}.navigation.{groupId}.label`.
+             *
+             * Mirrors `objectLabel`/`dashboardLabel` so app metadata can keep
+             * English fallbacks while translation packs supply localised
+             * sidebar group labels (e.g. "Sales" → "销售") without explicit
+             * I18nLabel `{ key, defaultValue }` annotations.
+             */
+            navGroupLabel: (appName, groupId, fallback) => resolve(`apps.${appName}.navigation.${groupId}.label`, fallback),
+            /**
+             * Resolve translated dashboard label, falling back to dashboardDef.label.
+             * Convention: `{ns}.dashboards.{dashboardName}.label`.
+             */
+            dashboardLabel: (dashboardDef) => resolve(dashboardSuffixes(dashboardDef.name, 'label'), dashboardDef.label ?? dashboardDef.name),
+            /**
+             * Resolve translated dashboard description, falling back to
+             * dashboardDef.description. Returns undefined when neither metadata nor
+             * translation provides one.
+             * Convention: `{ns}.dashboards.{dashboardName}.description`.
+             */
+            dashboardDescription: (dashboardDef) => {
+                const fallback = dashboardDef.description ?? '';
+                const resolved = resolve(dashboardSuffixes(dashboardDef.name, 'description'), fallback);
+                return resolved || undefined;
+            },
+            /**
+             * Resolve translated dashboard header-action label.
+             * Convention: `{ns}.dashboards.{dashboardName}.actions.{actionKey}.label`.
+             * The actionKey is typically the action's `actionUrl` (e.g.
+             * `create_opportunity`) or its English label slugified.
+             */
+            dashboardActionLabel: (dashboardName, actionKey, fallback) => resolve(dashboardSuffixes(dashboardName, `actions.${actionKey}.label`), fallback),
+            /**
+             * Resolve translated widget title within a dashboard.
+             * Convention: `{ns}.dashboards.{dashboardName}.widgets.{widgetId}.title`.
+             */
+            widgetTitle: (dashboardName, widgetId, fallback) => resolve(dashboardSuffixes(dashboardName, `widgets.${widgetId}.title`), fallback),
+            /**
+             * Resolve translated widget description within a dashboard.
+             * Convention: `{ns}.dashboards.{dashboardName}.widgets.{widgetId}.description`.
+             * Returns undefined when neither metadata nor translation provides one.
+             */
+            widgetDescription: (dashboardName, widgetId, fallback) => {
+                const fb = fallback ?? '';
+                const resolved = resolve(dashboardSuffixes(dashboardName, `widgets.${widgetId}.description`), fb);
+                return resolved || undefined;
+            },
+            /**
+             * Resolve translated page label, falling back to pageDef.label.
+             * Convention: `{ns}.pages.{pageName}.label`.
+             */
+            pageLabel: (pageDef) => resolve(pageSuffixes(pageDef.name, 'label'), pageDef.label ?? pageDef.name),
+            /**
+             * Resolve translated report label, falling back to reportDef.label.
+             * Convention: `{ns}.reports.{reportName}.label`.
+             */
+            reportLabel: (reportDef) => resolve(reportSuffixes(reportDef.name, 'label'), reportDef.label ?? reportDef.name),
+            /**
+             * 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),
+            /**
+             * 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);
+                return resolved || undefined;
+            },
+            /**
+             * Resolve translated form-section label.
+             * Convention: `{ns}.objects.{objectName}._sections.{sectionName}.label`.
+             */
+            sectionLabel: (objectName, sectionName, fallback) => resolve(objectSuffixes(objectName, `_sections.${sectionName}.label`), fallback),
+            /**
+             * Resolve translated action label.
+             * Convention: `{ns}.objects.{objectName}._actions.{actionName}.label`.
+             * Falls back to `{ns}.globalActions.{actionName}.label` when objectName is omitted.
+             */
+            actionLabel: (objectName, actionName, fallback) => {
+                if (objectName) {
+                    return resolve(objectSuffixes(objectName, `_actions.${actionName}.label`), fallback);
+                }
+                return resolve(`globalActions.${actionName}.label`, fallback);
+            },
+            /**
+             * Resolve translated action confirmation prompt.
+             * Convention: `{ns}.objects.{objectName}._actions.{actionName}.confirmText`.
+             * Returns undefined when no translation and no fallback exist.
+             */
+            actionConfirm: (objectName, actionName, fallback) => {
+                const fb = fallback ?? '';
+                const suffixes = objectName
+                    ? objectSuffixes(objectName, `_actions.${actionName}.confirmText`)
+                    : `globalActions.${actionName}.confirmText`;
+                const resolved = resolve(suffixes, fb);
+                return resolved || undefined;
+            },
+            /**
+             * Resolve translated action success message.
+             * Convention: `{ns}.objects.{objectName}._actions.{actionName}.successMessage`.
+             */
+            actionSuccess: (objectName, actionName, fallback) => {
+                const fb = fallback ?? '';
+                const suffixes = objectName
+                    ? objectSuffixes(objectName, `_actions.${actionName}.successMessage`)
+                    : `globalActions.${actionName}.successMessage`;
+                const resolved = resolve(suffixes, fb);
+                return resolved || undefined;
+            },
+        };
+    }, [t, i18n]);
 }
+/**
+ * Stable identity fallbacks for `useSafeFieldLabel` — referenced from a
+ * module-level constant so consumers using the fallback branch don't get a
+ * fresh object reference on every render (which would invalidate downstream
+ * memoization in heavy components like ListView).
+ */
+const SAFE_FIELD_LABEL_FALLBACK = {
+    fieldLabel: (_objectName, _fieldName, fallback) => fallback,
+    translateOptions: (_objectName, _fieldName, options) => options,
+    fieldOptionLabel: (_objectName, _fieldName, _optionValue, fallback) => fallback,
+    sectionLabel: (_objectName, _sectionName, fallback) => fallback,
+};
 /**
  * Safe wrapper for useObjectLabel that falls back to identity functions
  * when no I18nProvider is available. Suitable for plugin components that
  * may be rendered outside an i18n context.
  */
 export function useSafeFieldLabel() {
+    let resolved = null;
     try {
-        const { fieldLabel, translateOptions, fieldOptionLabel, sectionLabel } = useObjectLabel();
-        return { fieldLabel, translateOptions, fieldOptionLabel, sectionLabel };
+        resolved = useObjectLabel();
     }
     catch {
-        return {
-            fieldLabel: (_objectName, _fieldName, fallback) => fallback,
-            translateOptions: (_objectName, _fieldName, options) => options,
-            fieldOptionLabel: (_objectName, _fieldName, _optionValue, fallback) => fallback,
-            sectionLabel: (_objectName, _sectionName, fallback) => fallback,
-        };
+        resolved = null;
     }
+    // useObjectLabel already returns a stable (memoized) object per language —
+    // pass-through avoids creating a fresh wrapper here. The module-level
+    // fallback object is reused when no provider is mounted.
+    return resolved ?? SAFE_FIELD_LABEL_FALLBACK;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@object-ui/i18n",
-  "version": "4.3.0",
+  "version": "4.5.0",
   "type": "module",
   "sideEffects": false,
   "license": "MIT",