@object-ui/i18n 3.3.2 → 3.4.0

package/CHANGELOG.md

@@ -1,5 +1,7 @@
 # @object-ui/i18n
 
+## 3.4.0
+
 ## 3.3.2
 
 ## 3.3.1

package/dist/locales/en.d.ts

@@ -168,6 +168,14 @@ declare const en: {
         readonly moreViews: "{{count}} more";
         readonly activeFilters: "Active filters";
         readonly activeSort: "Active sort";
+        readonly manageViews: "Manage views";
+        readonly manageAllViews: "Manage all views…";
+        readonly searchViews: "Search views";
+        readonly addNewView: "Add new view";
+        readonly done: "Done";
+        readonly noViewsFound: "No views match your search.";
+        readonly dragToReorder: "Drag to reorder";
+        readonly defaultView: "Default view";
     };
     readonly detail: {
         readonly back: "Back";
@@ -571,6 +579,12 @@ declare const en: {
             readonly reports: "Reports";
             readonly system: "System";
         };
+        readonly nav: {
+            readonly pinItem: "Pin {{name}}";
+            readonly unpinItem: "Unpin {{name}}";
+            readonly dragToReorder: "Drag to reorder";
+            readonly favorites: "Favorites";
+        };
         readonly loadingSteps: {
             readonly connecting: "Connecting to data source";
             readonly loadingConfig: "Loading configuration";
@@ -695,6 +709,29 @@ declare const en: {
             readonly save: "Save";
             readonly discard: "Discard";
             readonly createView: "Create View";
+            readonly createViewDesc: "Pick a view type, then give it a name. You can change every setting afterwards.";
+            readonly cancel: "Cancel";
+            readonly create: "Create";
+            readonly delete: "Delete";
+            readonly deleteViewTitle: "Delete view";
+            readonly deleteViewConfirm: "Are you sure you want to delete the view \"{{name}}\"? This cannot be undone.";
+            readonly duplicateViewName: "A view with this name already exists.";
+            readonly viewTypeGrid: "Grid";
+            readonly viewTypeGridDesc: "A spreadsheet-style table of records.";
+            readonly viewTypeKanban: "Kanban";
+            readonly viewTypeKanbanDesc: "Cards grouped into columns by a single-select field.";
+            readonly viewTypeCalendar: "Calendar";
+            readonly viewTypeCalendarDesc: "Records placed on a monthly calendar by date.";
+            readonly viewTypeGallery: "Gallery";
+            readonly viewTypeGalleryDesc: "Large image cards driven by an attachment field.";
+            readonly viewTypeTimeline: "Timeline";
+            readonly viewTypeTimelineDesc: "Records along a horizontal time axis.";
+            readonly viewTypeGantt: "Gantt";
+            readonly viewTypeGanttDesc: "Project bars with start / end and dependencies.";
+            readonly viewTypeMap: "Map";
+            readonly viewTypeMapDesc: "Geographic markers from latitude / longitude fields.";
+            readonly viewTypeChart: "Chart";
+            readonly viewTypeChartDesc: "Aggregated bar / line / pie visualisations.";
             readonly newView: "New View";
             readonly typeOptions: "Type Options";
             readonly groupByField: "Group by field";
@@ -705,6 +742,7 @@ declare const en: {
             readonly imageField: "Image field";
             readonly dateField: "Date field";
             readonly selectField: "Select field...";
+            readonly noEligibleFieldForType: "No eligible field of this type. Add one to the object first.";
             readonly gridOptionsHint: "Grid view uses the columns configured above.";
             readonly groupBy: "Group by";
             readonly prefixField: "Prefix field";
@@ -862,6 +900,11 @@ declare const en: {
         readonly help: "Help";
         readonly helpTooltip: "Help & Documentation";
         readonly activityFeed: "Activity feed";
+        readonly area: "Area";
+        readonly recent: "Recent";
+        readonly favorites: "Favorites";
+        readonly starred: "Starred";
+        readonly removeFromFavorites: "Remove {{name}} from favorites";
     };
     readonly home: {
         readonly title: "Home";

package/dist/locales/en.js

@@ -168,6 +168,14 @@ const en = {
         moreViews: '{{count}} more',
         activeFilters: 'Active filters',
         activeSort: 'Active sort',
+        manageViews: 'Manage views',
+        manageAllViews: 'Manage all views…',
+        searchViews: 'Search views',
+        addNewView: 'Add new view',
+        done: 'Done',
+        noViewsFound: 'No views match your search.',
+        dragToReorder: 'Drag to reorder',
+        defaultView: 'Default view',
     },
     detail: {
         back: 'Back',
@@ -581,6 +589,12 @@ const en = {
             reports: 'Reports',
             system: 'System',
         },
+        nav: {
+            pinItem: 'Pin {{name}}',
+            unpinItem: 'Unpin {{name}}',
+            dragToReorder: 'Drag to reorder',
+            favorites: 'Favorites',
+        },
         loadingSteps: {
             connecting: 'Connecting to data source',
             loadingConfig: 'Loading configuration',
@@ -705,6 +719,29 @@ const en = {
             save: 'Save',
             discard: 'Discard',
             createView: 'Create View',
+            createViewDesc: 'Pick a view type, then give it a name. You can change every setting afterwards.',
+            cancel: 'Cancel',
+            create: 'Create',
+            delete: 'Delete',
+            deleteViewTitle: 'Delete view',
+            deleteViewConfirm: 'Are you sure you want to delete the view "{{name}}"? This cannot be undone.',
+            duplicateViewName: 'A view with this name already exists.',
+            viewTypeGrid: 'Grid',
+            viewTypeGridDesc: 'A spreadsheet-style table of records.',
+            viewTypeKanban: 'Kanban',
+            viewTypeKanbanDesc: 'Cards grouped into columns by a single-select field.',
+            viewTypeCalendar: 'Calendar',
+            viewTypeCalendarDesc: 'Records placed on a monthly calendar by date.',
+            viewTypeGallery: 'Gallery',
+            viewTypeGalleryDesc: 'Large image cards driven by an attachment field.',
+            viewTypeTimeline: 'Timeline',
+            viewTypeTimelineDesc: 'Records along a horizontal time axis.',
+            viewTypeGantt: 'Gantt',
+            viewTypeGanttDesc: 'Project bars with start / end and dependencies.',
+            viewTypeMap: 'Map',
+            viewTypeMapDesc: 'Geographic markers from latitude / longitude fields.',
+            viewTypeChart: 'Chart',
+            viewTypeChartDesc: 'Aggregated bar / line / pie visualisations.',
             newView: 'New View',
             typeOptions: 'Type Options',
             groupByField: 'Group by field',
@@ -715,6 +752,7 @@ const en = {
             imageField: 'Image field',
             dateField: 'Date field',
             selectField: 'Select field...',
+            noEligibleFieldForType: 'No eligible field of this type. Add one to the object first.',
             gridOptionsHint: 'Grid view uses the columns configured above.',
             groupBy: 'Group by',
             prefixField: 'Prefix field',
@@ -872,6 +910,11 @@ const en = {
         help: 'Help',
         helpTooltip: 'Help & Documentation',
         activityFeed: 'Activity feed',
+        area: 'Area',
+        recent: 'Recent',
+        favorites: 'Favorites',
+        starred: 'Starred',
+        removeFromFavorites: 'Remove {{name}} from favorites',
     },
     home: {
         title: 'Home',

package/dist/locales/index.d.ts

@@ -180,6 +180,14 @@ export declare const builtInLocales: {
             readonly moreViews: "{{count}} more";
             readonly activeFilters: "Active filters";
             readonly activeSort: "Active sort";
+            readonly manageViews: "Manage views";
+            readonly manageAllViews: "Manage all views…";
+            readonly searchViews: "Search views";
+            readonly addNewView: "Add new view";
+            readonly done: "Done";
+            readonly noViewsFound: "No views match your search.";
+            readonly dragToReorder: "Drag to reorder";
+            readonly defaultView: "Default view";
         };
         readonly detail: {
             readonly back: "Back";
@@ -583,6 +591,12 @@ export declare const builtInLocales: {
                 readonly reports: "Reports";
                 readonly system: "System";
             };
+            readonly nav: {
+                readonly pinItem: "Pin {{name}}";
+                readonly unpinItem: "Unpin {{name}}";
+                readonly dragToReorder: "Drag to reorder";
+                readonly favorites: "Favorites";
+            };
             readonly loadingSteps: {
                 readonly connecting: "Connecting to data source";
                 readonly loadingConfig: "Loading configuration";
@@ -707,6 +721,29 @@ export declare const builtInLocales: {
                 readonly save: "Save";
                 readonly discard: "Discard";
                 readonly createView: "Create View";
+                readonly createViewDesc: "Pick a view type, then give it a name. You can change every setting afterwards.";
+                readonly cancel: "Cancel";
+                readonly create: "Create";
+                readonly delete: "Delete";
+                readonly deleteViewTitle: "Delete view";
+                readonly deleteViewConfirm: "Are you sure you want to delete the view \"{{name}}\"? This cannot be undone.";
+                readonly duplicateViewName: "A view with this name already exists.";
+                readonly viewTypeGrid: "Grid";
+                readonly viewTypeGridDesc: "A spreadsheet-style table of records.";
+                readonly viewTypeKanban: "Kanban";
+                readonly viewTypeKanbanDesc: "Cards grouped into columns by a single-select field.";
+                readonly viewTypeCalendar: "Calendar";
+                readonly viewTypeCalendarDesc: "Records placed on a monthly calendar by date.";
+                readonly viewTypeGallery: "Gallery";
+                readonly viewTypeGalleryDesc: "Large image cards driven by an attachment field.";
+                readonly viewTypeTimeline: "Timeline";
+                readonly viewTypeTimelineDesc: "Records along a horizontal time axis.";
+                readonly viewTypeGantt: "Gantt";
+                readonly viewTypeGanttDesc: "Project bars with start / end and dependencies.";
+                readonly viewTypeMap: "Map";
+                readonly viewTypeMapDesc: "Geographic markers from latitude / longitude fields.";
+                readonly viewTypeChart: "Chart";
+                readonly viewTypeChartDesc: "Aggregated bar / line / pie visualisations.";
                 readonly newView: "New View";
                 readonly typeOptions: "Type Options";
                 readonly groupByField: "Group by field";
@@ -717,6 +754,7 @@ export declare const builtInLocales: {
                 readonly imageField: "Image field";
                 readonly dateField: "Date field";
                 readonly selectField: "Select field...";
+                readonly noEligibleFieldForType: "No eligible field of this type. Add one to the object first.";
                 readonly gridOptionsHint: "Grid view uses the columns configured above.";
                 readonly groupBy: "Group by";
                 readonly prefixField: "Prefix field";
@@ -874,6 +912,11 @@ export declare const builtInLocales: {
             readonly help: "Help";
             readonly helpTooltip: "Help & Documentation";
             readonly activityFeed: "Activity feed";
+            readonly area: "Area";
+            readonly recent: "Recent";
+            readonly favorites: "Favorites";
+            readonly starred: "Starred";
+            readonly removeFromFavorites: "Remove {{name}} from favorites";
         };
         readonly home: {
             readonly title: "Home";
@@ -1078,6 +1121,14 @@ export declare const builtInLocales: {
             readonly moreViews: "还有 {{count}} 个";
             readonly activeFilters: "筛选条件生效中";
             readonly activeSort: "排序生效中";
+            readonly manageViews: "管理视图";
+            readonly manageAllViews: "管理所有视图…";
+            readonly searchViews: "搜索视图";
+            readonly addNewView: "新建视图";
+            readonly done: "完成";
+            readonly noViewsFound: "没有匹配的视图。";
+            readonly dragToReorder: "拖动排序";
+            readonly defaultView: "默认视图";
         };
         readonly detail: {
             readonly back: "返回";
@@ -1481,6 +1532,12 @@ export declare const builtInLocales: {
                 readonly reports: "报告";
                 readonly system: "系统";
             };
+            readonly nav: {
+                readonly pinItem: "固定 {{name}}";
+                readonly unpinItem: "取消固定 {{name}}";
+                readonly dragToReorder: "拖动以重新排序";
+                readonly favorites: "收藏";
+            };
             readonly loadingSteps: {
                 readonly connecting: "正在连接数据源";
                 readonly loadingConfig: "正在加载配置";
@@ -1605,6 +1662,29 @@ export declare const builtInLocales: {
                 readonly save: "保存";
                 readonly discard: "丢弃";
                 readonly createView: "创建视图";
+                readonly createViewDesc: "先选择视图类型，再为它命名。所有设置之后都可以修改。";
+                readonly cancel: "取消";
+                readonly create: "创建";
+                readonly delete: "删除";
+                readonly deleteViewTitle: "删除视图";
+                readonly deleteViewConfirm: "确定要删除视图 \"{{name}}\" 吗？此操作无法撤销。";
+                readonly duplicateViewName: "已存在同名视图。";
+                readonly viewTypeGrid: "表格";
+                readonly viewTypeGridDesc: "电子表格风格的记录表格。";
+                readonly viewTypeKanban: "看板";
+                readonly viewTypeKanbanDesc: "按单选字段分列的卡片视图。";
+                readonly viewTypeCalendar: "日历";
+                readonly viewTypeCalendarDesc: "按日期把记录放到月历上。";
+                readonly viewTypeGallery: "画廊";
+                readonly viewTypeGalleryDesc: "由附件字段驱动的大图卡片。";
+                readonly viewTypeTimeline: "时间线";
+                readonly viewTypeTimelineDesc: "记录按横向时间轴展开。";
+                readonly viewTypeGantt: "甘特图";
+                readonly viewTypeGanttDesc: "展示项目起止时间和依赖。";
+                readonly viewTypeMap: "地图";
+                readonly viewTypeMapDesc: "根据经纬度字段显示地理标记。";
+                readonly viewTypeChart: "图表";
+                readonly viewTypeChartDesc: "聚合的柱状/折线/饼状图。";
                 readonly newView: "新视图";
                 readonly typeOptions: "类型选项";
                 readonly groupByField: "分组字段";
@@ -1615,6 +1695,7 @@ export declare const builtInLocales: {
                 readonly imageField: "图片字段";
                 readonly dateField: "日期字段";
                 readonly selectField: "选择字段...";
+                readonly noEligibleFieldForType: "没有符合条件的字段。请先在对象上添加该类型字段。";
                 readonly gridOptionsHint: "网格视图使用上方配置的列。";
                 readonly groupBy: "分组依据";
                 readonly prefixField: "前缀字段";
@@ -1772,6 +1853,11 @@ export declare const builtInLocales: {
             readonly help: "帮助";
             readonly helpTooltip: "帮助与文档";
             readonly activityFeed: "活动动态";
+            readonly area: "区域";
+            readonly recent: "最近使用";
+            readonly favorites: "收藏";
+            readonly starred: "已收藏";
+            readonly removeFromFavorites: "从收藏中移除 {{name}}";
         };
         readonly home: {
             readonly title: "首页";

package/dist/locales/zh.d.ts

@@ -168,6 +168,14 @@ declare const zh: {
         readonly moreViews: "还有 {{count}} 个";
         readonly activeFilters: "筛选条件生效中";
         readonly activeSort: "排序生效中";
+        readonly manageViews: "管理视图";
+        readonly manageAllViews: "管理所有视图…";
+        readonly searchViews: "搜索视图";
+        readonly addNewView: "新建视图";
+        readonly done: "完成";
+        readonly noViewsFound: "没有匹配的视图。";
+        readonly dragToReorder: "拖动排序";
+        readonly defaultView: "默认视图";
     };
     readonly detail: {
         readonly back: "返回";
@@ -571,6 +579,12 @@ declare const zh: {
             readonly reports: "报告";
             readonly system: "系统";
         };
+        readonly nav: {
+            readonly pinItem: "固定 {{name}}";
+            readonly unpinItem: "取消固定 {{name}}";
+            readonly dragToReorder: "拖动以重新排序";
+            readonly favorites: "收藏";
+        };
         readonly loadingSteps: {
             readonly connecting: "正在连接数据源";
             readonly loadingConfig: "正在加载配置";
@@ -695,6 +709,29 @@ declare const zh: {
             readonly save: "保存";
             readonly discard: "丢弃";
             readonly createView: "创建视图";
+            readonly createViewDesc: "先选择视图类型，再为它命名。所有设置之后都可以修改。";
+            readonly cancel: "取消";
+            readonly create: "创建";
+            readonly delete: "删除";
+            readonly deleteViewTitle: "删除视图";
+            readonly deleteViewConfirm: "确定要删除视图 \"{{name}}\" 吗？此操作无法撤销。";
+            readonly duplicateViewName: "已存在同名视图。";
+            readonly viewTypeGrid: "表格";
+            readonly viewTypeGridDesc: "电子表格风格的记录表格。";
+            readonly viewTypeKanban: "看板";
+            readonly viewTypeKanbanDesc: "按单选字段分列的卡片视图。";
+            readonly viewTypeCalendar: "日历";
+            readonly viewTypeCalendarDesc: "按日期把记录放到月历上。";
+            readonly viewTypeGallery: "画廊";
+            readonly viewTypeGalleryDesc: "由附件字段驱动的大图卡片。";
+            readonly viewTypeTimeline: "时间线";
+            readonly viewTypeTimelineDesc: "记录按横向时间轴展开。";
+            readonly viewTypeGantt: "甘特图";
+            readonly viewTypeGanttDesc: "展示项目起止时间和依赖。";
+            readonly viewTypeMap: "地图";
+            readonly viewTypeMapDesc: "根据经纬度字段显示地理标记。";
+            readonly viewTypeChart: "图表";
+            readonly viewTypeChartDesc: "聚合的柱状/折线/饼状图。";
             readonly newView: "新视图";
             readonly typeOptions: "类型选项";
             readonly groupByField: "分组字段";
@@ -705,6 +742,7 @@ declare const zh: {
             readonly imageField: "图片字段";
             readonly dateField: "日期字段";
             readonly selectField: "选择字段...";
+            readonly noEligibleFieldForType: "没有符合条件的字段。请先在对象上添加该类型字段。";
             readonly gridOptionsHint: "网格视图使用上方配置的列。";
             readonly groupBy: "分组依据";
             readonly prefixField: "前缀字段";
@@ -862,6 +900,11 @@ declare const zh: {
         readonly help: "帮助";
         readonly helpTooltip: "帮助与文档";
         readonly activityFeed: "活动动态";
+        readonly area: "区域";
+        readonly recent: "最近使用";
+        readonly favorites: "收藏";
+        readonly starred: "已收藏";
+        readonly removeFromFavorites: "从收藏中移除 {{name}}";
     };
     readonly home: {
         readonly title: "首页";

package/dist/locales/zh.js

@@ -168,6 +168,14 @@ const zh = {
         moreViews: '还有 {{count}} 个',
         activeFilters: '筛选条件生效中',
         activeSort: '排序生效中',
+        manageViews: '管理视图',
+        manageAllViews: '管理所有视图…',
+        searchViews: '搜索视图',
+        addNewView: '新建视图',
+        done: '完成',
+        noViewsFound: '没有匹配的视图。',
+        dragToReorder: '拖动排序',
+        defaultView: '默认视图',
     },
     detail: {
         back: '返回',
@@ -581,6 +589,12 @@ const zh = {
             reports: '报告',
             system: '系统',
         },
+        nav: {
+            pinItem: '固定 {{name}}',
+            unpinItem: '取消固定 {{name}}',
+            dragToReorder: '拖动以重新排序',
+            favorites: '收藏',
+        },
         loadingSteps: {
             connecting: '正在连接数据源',
             loadingConfig: '正在加载配置',
@@ -705,6 +719,29 @@ const zh = {
             save: '保存',
             discard: '丢弃',
             createView: '创建视图',
+            createViewDesc: '先选择视图类型，再为它命名。所有设置之后都可以修改。',
+            cancel: '取消',
+            create: '创建',
+            delete: '删除',
+            deleteViewTitle: '删除视图',
+            deleteViewConfirm: '确定要删除视图 "{{name}}" 吗？此操作无法撤销。',
+            duplicateViewName: '已存在同名视图。',
+            viewTypeGrid: '表格',
+            viewTypeGridDesc: '电子表格风格的记录表格。',
+            viewTypeKanban: '看板',
+            viewTypeKanbanDesc: '按单选字段分列的卡片视图。',
+            viewTypeCalendar: '日历',
+            viewTypeCalendarDesc: '按日期把记录放到月历上。',
+            viewTypeGallery: '画廊',
+            viewTypeGalleryDesc: '由附件字段驱动的大图卡片。',
+            viewTypeTimeline: '时间线',
+            viewTypeTimelineDesc: '记录按横向时间轴展开。',
+            viewTypeGantt: '甘特图',
+            viewTypeGanttDesc: '展示项目起止时间和依赖。',
+            viewTypeMap: '地图',
+            viewTypeMapDesc: '根据经纬度字段显示地理标记。',
+            viewTypeChart: '图表',
+            viewTypeChartDesc: '聚合的柱状/折线/饼状图。',
             newView: '新视图',
             typeOptions: '类型选项',
             groupByField: '分组字段',
@@ -715,6 +752,7 @@ const zh = {
             imageField: '图片字段',
             dateField: '日期字段',
             selectField: '选择字段...',
+            noEligibleFieldForType: '没有符合条件的字段。请先在对象上添加该类型字段。',
             gridOptionsHint: '网格视图使用上方配置的列。',
             groupBy: '分组依据',
             prefixField: '前缀字段',
@@ -872,6 +910,11 @@ const zh = {
         help: '帮助',
         helpTooltip: '帮助与文档',
         activityFeed: '活动动态',
+        area: '区域',
+        recent: '最近使用',
+        favorites: '收藏',
+        starred: '已收藏',
+        removeFromFavorites: '从收藏中移除 {{name}}',
     },
     home: {
         title: '首页',

package/dist/useObjectLabel.d.ts

@@ -87,6 +87,68 @@ export declare function useObjectLabel(): {
         name: string;
         description?: string;
     }) => string | 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: string, groupId: string, fallback: string) => string;
+    /**
+     * Resolve translated dashboard label, falling back to dashboardDef.label.
+     * Convention: `{ns}.dashboards.{dashboardName}.label`.
+     */
+    dashboardLabel: (dashboardDef: {
+        name: string;
+        label?: string;
+    }) => string;
+    /**
+     * 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: {
+        name: string;
+        description?: string;
+    }) => string | 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: string, actionKey: string, fallback: string) => string;
+    /**
+     * Resolve translated widget title within a dashboard.
+     * Convention: `{ns}.dashboards.{dashboardName}.widgets.{widgetId}.title`.
+     */
+    widgetTitle: (dashboardName: string, widgetId: string, fallback: string) => string;
+    /**
+     * 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: string, widgetId: string, fallback?: string) => string | undefined;
+    /**
+     * Resolve translated page label, falling back to pageDef.label.
+     * Convention: `{ns}.pages.{pageName}.label`.
+     */
+    pageLabel: (pageDef: {
+        name: string;
+        label?: string;
+    }) => string;
+    /**
+     * Resolve translated report label, falling back to reportDef.label.
+     * Convention: `{ns}.reports.{reportName}.label`.
+     */
+    reportLabel: (reportDef: {
+        name: string;
+        label?: string;
+    }) => string;
 };
 /**
  * Safe wrapper for useObjectLabel that falls back to identity functions
@@ -104,4 +166,5 @@ export declare function useSafeFieldLabel(): {
         label: string;
         [key: string]: any;
     }>;
+    fieldOptionLabel: (objectName: string, fieldName: string, optionValue: string, fallback: string) => string;
 };

package/dist/useObjectLabel.js

@@ -59,7 +59,8 @@ export function useObjectLabel() {
         if (!bundle)
             return [];
         return Object.keys(bundle).filter((key) => !BUILTIN_KEYS.has(key) && bundle[key] && typeof bundle[key] === 'object'
-            && (bundle[key].objects || bundle[key].fields || bundle[key].apps));
+            && (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
@@ -113,6 +114,35 @@ export function useObjectLabel() {
             ]
             : [`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.
@@ -160,6 +190,64 @@ export function useObjectLabel() {
             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),
     };
 }
 /**
@@ -169,13 +257,14 @@ export function useObjectLabel() {
  */
 export function useSafeFieldLabel() {
     try {
-        const { fieldLabel, translateOptions } = useObjectLabel();
-        return { fieldLabel, translateOptions };
+        const { fieldLabel, translateOptions, fieldOptionLabel } = useObjectLabel();
+        return { fieldLabel, translateOptions, fieldOptionLabel };
     }
     catch {
         return {
             fieldLabel: (_objectName, _fieldName, fallback) => fallback,
             translateOptions: (_objectName, _fieldName, options) => options,
+            fieldOptionLabel: (_objectName, _fieldName, _optionValue, fallback) => fallback,
         };
     }
 }

package/package.json

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