@object-ui/i18n 4.0.10 → 4.0.11

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @object-ui/i18n
 
+## 4.0.11
+
+### Patch Changes
+
+- 1909bc3: Add `transformSpecTranslations` / `isSpecTranslationData` helpers to
+  `@object-ui/i18n` so apps no longer need to maintain their own copy of the
+  `@objectstack/spec` `TranslationData` → flat namespace transform.
+
+  The new transform preserves **every** `_`-prefixed object scope by
+  convention (`_views`, `_actions`, `_sections`, `_notifications`, `_errors`,
+  `_options`, plus anything added in future spec versions), which fixes a
+  class of silent-failure regressions where new spec scopes were dropped
+  during transformation — leaving e.g. list-view labels to fall back to the
+  untranslated source string.
+
+  `@object-ui/console`'s `loadLanguage.ts` is rewritten to delegate to the
+  shared helper.
+
 ## 4.0.10
 
 ## 4.0.9

package/dist/index.d.ts

@@ -47,3 +47,4 @@ export { default as ru } from './locales/ru';
 export { default as ar } from './locales/ar';
 export { formatDate, formatDateTime, formatRelativeTime, formatCurrency, formatNumber, type DateFormatOptions, type CurrencyFormatOptions, type NumberFormatOptions, } from './utils/index';
 export { resolvePlural, formatDateSpec, formatNumberSpec, applyLocaleConfig, type SpecPluralRule, type SpecDateFormat, type SpecNumberFormat, type SpecLocaleConfig, } from './utils/index';
+export { isSpecTranslationData, transformSpecTranslations, type SpecTranslationData, } from './utils/index';

package/dist/index.js

@@ -54,3 +54,7 @@ export { default as ar } from './locales/ar';
 export { formatDate, formatDateTime, formatRelativeTime, formatCurrency, formatNumber, } from './utils/index';
 // Spec-aligned formatters (v2.0.7)
 export { resolvePlural, formatDateSpec, formatNumberSpec, applyLocaleConfig, } from './utils/index';
+// Spec TranslationData → flat namespace transform (consumed by
+// `useObjectLabel`). Exposed so apps don't have to copy/paste — see
+// `apps/console/src/loadLanguage.ts` for the canonical consumer.
+export { isSpecTranslationData, transformSpecTranslations, } from './utils/index';

package/dist/locales/en.d.ts

@@ -213,6 +213,8 @@ declare const en: {
         readonly moveCard: "Move card";
         readonly deleteCard: "Delete card";
         readonly deleteColumn: "Delete column";
+        readonly noCards: "No cards";
+        readonly cardTitlePlaceholder: "Enter card title...";
     };
     readonly timeline: {
         readonly bucket: {
@@ -250,6 +252,8 @@ declare const en: {
         readonly dragToReorder: "Drag to reorder";
         readonly defaultView: "Default view";
         readonly tabActionsFor: "View actions for {{name}}";
+        readonly readonlyAriaLabel: "Read-only view";
+        readonly readonlyTooltip: "System view — duplicate to customize.";
     };
     readonly detail: {
         readonly back: "Back";
@@ -444,6 +448,16 @@ declare const en: {
         readonly saveLayout: "Save layout";
         readonly resetLayout: "Reset layout";
         readonly total: "Total";
+        readonly noDataAvailable: "No data available";
+        readonly noDataSourceFor: "No data source available for";
+        readonly trend: {
+            readonly vsLastQuarter: "vs last quarter";
+            readonly vsLastMonth: "vs last month";
+            readonly vsLastWeek: "vs last week";
+            readonly vsLastYear: "vs last year";
+            readonly vsYesterday: "vs yesterday";
+            readonly vsPreviousPeriod: "vs previous period";
+        };
     };
     readonly configPanel: {
         readonly save: "Save";

package/dist/locales/en.js

@@ -213,6 +213,8 @@ const en = {
         moveCard: 'Move card',
         deleteCard: 'Delete card',
         deleteColumn: 'Delete column',
+        noCards: 'No cards',
+        cardTitlePlaceholder: 'Enter card title...',
     },
     timeline: {
         bucket: {
@@ -250,6 +252,8 @@ const en = {
         dragToReorder: 'Drag to reorder',
         defaultView: 'Default view',
         tabActionsFor: 'View actions for {{name}}',
+        readonlyAriaLabel: 'Read-only view',
+        readonlyTooltip: 'System view — duplicate to customize.',
     },
     detail: {
         back: 'Back',
@@ -454,6 +458,16 @@ const en = {
         saveLayout: 'Save layout',
         resetLayout: 'Reset layout',
         total: 'Total',
+        noDataAvailable: 'No data available',
+        noDataSourceFor: 'No data source available for',
+        trend: {
+            vsLastQuarter: 'vs last quarter',
+            vsLastMonth: 'vs last month',
+            vsLastWeek: 'vs last week',
+            vsLastYear: 'vs last year',
+            vsYesterday: 'vs yesterday',
+            vsPreviousPeriod: 'vs previous period',
+        },
     },
     configPanel: {
         save: 'Save',

package/dist/locales/index.d.ts

@@ -225,6 +225,8 @@ export declare const builtInLocales: {
             readonly moveCard: "Move card";
             readonly deleteCard: "Delete card";
             readonly deleteColumn: "Delete column";
+            readonly noCards: "No cards";
+            readonly cardTitlePlaceholder: "Enter card title...";
         };
         readonly timeline: {
             readonly bucket: {
@@ -262,6 +264,8 @@ export declare const builtInLocales: {
             readonly dragToReorder: "Drag to reorder";
             readonly defaultView: "Default view";
             readonly tabActionsFor: "View actions for {{name}}";
+            readonly readonlyAriaLabel: "Read-only view";
+            readonly readonlyTooltip: "System view — duplicate to customize.";
         };
         readonly detail: {
             readonly back: "Back";
@@ -456,6 +460,16 @@ export declare const builtInLocales: {
             readonly saveLayout: "Save layout";
             readonly resetLayout: "Reset layout";
             readonly total: "Total";
+            readonly noDataAvailable: "No data available";
+            readonly noDataSourceFor: "No data source available for";
+            readonly trend: {
+                readonly vsLastQuarter: "vs last quarter";
+                readonly vsLastMonth: "vs last month";
+                readonly vsLastWeek: "vs last week";
+                readonly vsLastYear: "vs last year";
+                readonly vsYesterday: "vs yesterday";
+                readonly vsPreviousPeriod: "vs previous period";
+            };
         };
         readonly configPanel: {
             readonly save: "Save";
@@ -1419,6 +1433,8 @@ export declare const builtInLocales: {
             readonly moveCard: "移动卡片";
             readonly deleteCard: "删除卡片";
             readonly deleteColumn: "删除列";
+            readonly noCards: "暂无卡片";
+            readonly cardTitlePlaceholder: "输入卡片标题...";
         };
         readonly timeline: {
             readonly bucket: {
@@ -1456,6 +1472,8 @@ export declare const builtInLocales: {
             readonly dragToReorder: "拖动排序";
             readonly defaultView: "默认视图";
             readonly tabActionsFor: "{{name}} 的视图操作";
+            readonly readonlyAriaLabel: "只读视图";
+            readonly readonlyTooltip: "系统视图 — 复制后可自定义。";
         };
         readonly detail: {
             readonly back: "返回";
@@ -1650,6 +1668,16 @@ export declare const builtInLocales: {
             readonly saveLayout: "保存布局";
             readonly resetLayout: "重置布局";
             readonly total: "总计";
+            readonly noDataAvailable: "暂无数据";
+            readonly noDataSourceFor: "没有可用的数据源：";
+            readonly trend: {
+                readonly vsLastQuarter: "较上季度";
+                readonly vsLastMonth: "较上月";
+                readonly vsLastWeek: "较上周";
+                readonly vsLastYear: "较去年";
+                readonly vsYesterday: "较昨日";
+                readonly vsPreviousPeriod: "较上期";
+            };
         };
         readonly configPanel: {
             readonly save: "保存";

package/dist/locales/zh.d.ts

@@ -213,6 +213,8 @@ declare const zh: {
         readonly moveCard: "移动卡片";
         readonly deleteCard: "删除卡片";
         readonly deleteColumn: "删除列";
+        readonly noCards: "暂无卡片";
+        readonly cardTitlePlaceholder: "输入卡片标题...";
     };
     readonly timeline: {
         readonly bucket: {
@@ -250,6 +252,8 @@ declare const zh: {
         readonly dragToReorder: "拖动排序";
         readonly defaultView: "默认视图";
         readonly tabActionsFor: "{{name}} 的视图操作";
+        readonly readonlyAriaLabel: "只读视图";
+        readonly readonlyTooltip: "系统视图 — 复制后可自定义。";
     };
     readonly detail: {
         readonly back: "返回";
@@ -444,6 +448,16 @@ declare const zh: {
         readonly saveLayout: "保存布局";
         readonly resetLayout: "重置布局";
         readonly total: "总计";
+        readonly noDataAvailable: "暂无数据";
+        readonly noDataSourceFor: "没有可用的数据源：";
+        readonly trend: {
+            readonly vsLastQuarter: "较上季度";
+            readonly vsLastMonth: "较上月";
+            readonly vsLastWeek: "较上周";
+            readonly vsLastYear: "较去年";
+            readonly vsYesterday: "较昨日";
+            readonly vsPreviousPeriod: "较上期";
+        };
     };
     readonly configPanel: {
         readonly save: "保存";

package/dist/locales/zh.js

@@ -213,6 +213,8 @@ const zh = {
         moveCard: '移动卡片',
         deleteCard: '删除卡片',
         deleteColumn: '删除列',
+        noCards: '暂无卡片',
+        cardTitlePlaceholder: '输入卡片标题...',
     },
     timeline: {
         bucket: {
@@ -250,6 +252,8 @@ const zh = {
         dragToReorder: '拖动排序',
         defaultView: '默认视图',
         tabActionsFor: '{{name}} 的视图操作',
+        readonlyAriaLabel: '只读视图',
+        readonlyTooltip: '系统视图 — 复制后可自定义。',
     },
     detail: {
         back: '返回',
@@ -454,6 +458,16 @@ const zh = {
         saveLayout: '保存布局',
         resetLayout: '重置布局',
         total: '总计',
+        noDataAvailable: '暂无数据',
+        noDataSourceFor: '没有可用的数据源：',
+        trend: {
+            vsLastQuarter: '较上季度',
+            vsLastMonth: '较上月',
+            vsLastWeek: '较上周',
+            vsLastYear: '较去年',
+            vsYesterday: '较昨日',
+            vsPreviousPeriod: '较上期',
+        },
     },
     configPanel: {
         save: '保存',

package/dist/utils/index.d.ts

@@ -1,2 +1,3 @@
 export { formatDate, formatDateTime, formatRelativeTime, formatCurrency, formatNumber, type DateFormatOptions, type CurrencyFormatOptions, type NumberFormatOptions, } from './formatting';
 export { resolvePlural, formatDateSpec, formatNumberSpec, applyLocaleConfig, type SpecPluralRule, type SpecDateFormat, type SpecNumberFormat, type SpecLocaleConfig, } from './spec-formatters';
+export { isSpecTranslationData, transformSpecTranslations, type SpecTranslationData, } from './spec-translations';

package/dist/utils/index.js

@@ -1,2 +1,3 @@
 export { formatDate, formatDateTime, formatRelativeTime, formatCurrency, formatNumber, } from './formatting';
 export { resolvePlural, formatDateSpec, formatNumberSpec, applyLocaleConfig, } from './spec-formatters';
+export { isSpecTranslationData, transformSpecTranslations, } from './spec-translations';

package/dist/utils/spec-translations.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Adapters between `@objectstack/spec` `TranslationData` (the wire format
+ * served by `/api/v1/i18n/translations/:locale`) and the flat namespace
+ * tree that `@object-ui/i18n`'s `useObjectLabel` hook reads.
+ *
+ * The spec format nests every per-object scope (`fields`, `_views`,
+ * `_actions`, …) under `objects.<n>.*`. `useObjectLabel` resolves keys
+ * in two different shapes depending on the scope:
+ *
+ *   - **Flattened scopes** — `fields` becomes a top-level `fields.<obj>.<fld>`
+ *     string map (and field options become `fieldOptions.<obj>.<fld>.<value>`)
+ *     so per-field label lookup is cheap.
+ *   - **Nested scopes** — every `_`-prefixed key (`_views`, `_actions`,
+ *     `_sections`, `_notifications`, `_errors`, `_options`, …) is preserved
+ *     verbatim under `objects.<n>._xxx`, matching the resolver
+ *     conventions documented in `useObjectLabel` (e.g.
+ *     `viewLabel` reads `objects.<n>._views.<view>.label`).
+ *
+ * The "preserve every `_`-prefixed key" rule is intentional: it future-proofs
+ * the transform so newly-introduced spec scopes do **not** need a code change
+ * here to flow through to the UI. This prevents a class of silent-failure
+ * regressions where a new scope (e.g. `_views`) is added to the spec but the
+ * console transform forgets to copy it, leaving lookups to fall back to the
+ * untranslated source label.
+ */
+/**
+ * Minimal shape of a `@objectstack/spec` `TranslationData` payload. We only
+ * type the fields this transformer reads; everything else is forwarded
+ * through opaquely.
+ */
+export interface SpecTranslationData {
+    objects?: Record<string, {
+        label?: string;
+        pluralLabel?: string;
+        description?: string;
+        fields?: Record<string, {
+            label?: string;
+            options?: Record<string, string>;
+            [key: string]: unknown;
+        }>;
+        [key: string]: unknown;
+    }>;
+    apps?: unknown;
+    messages?: unknown;
+    validationMessages?: unknown;
+    dashboards?: unknown;
+    globalActions?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * Detect whether the given record uses the spec `TranslationData` format.
+ *
+ * Returns `true` when `data.objects` exists and at least one entry has a
+ * nested `fields` object (the distinguishing trait vs. an already-flattened
+ * namespace tree).
+ */
+export declare function isSpecTranslationData(data: Record<string, unknown> | null | undefined): data is SpecTranslationData;
+/**
+ * Transform a `@objectstack/spec` `TranslationData` payload into the
+ * namespaced tree expected by `useObjectLabel`.
+ *
+ * The output is wrapped under an `app` namespace key so the hook's
+ * `getAppNamespaces()` discovery (which keys off the presence of `objects`
+ * and `fields`) picks it up automatically.
+ *
+ * Behaviour:
+ *   - `objects.<n>.label / pluralLabel / description` — copied verbatim.
+ *   - `objects.<n>._*` — every underscore-prefixed key (any depth) is
+ *     preserved as-is. This is the rule that prevents future spec scopes
+ *     (`_views`, `_actions`, `_sections`, `_notifications`, `_errors`,
+ *     `_options`, anything new) from silently disappearing.
+ *   - `objects.<n>.fields.<f>.label` — flattened to `fields.<n>.<f>`.
+ *   - `objects.<n>.fields.<f>.options` — flattened to
+ *     `fieldOptions.<n>.<f>.<value>`.
+ *   - `apps / messages / validationMessages / dashboards / globalActions`
+ *     — copied verbatim to the `app` namespace root.
+ *   - Any other top-level key on the source payload is also copied through,
+ *     so new top-level spec namespaces flow through without a code change.
+ */
+export declare function transformSpecTranslations(data: SpecTranslationData): Record<string, unknown>;

package/dist/utils/spec-translations.js

@@ -0,0 +1,141 @@
+/**
+ * Adapters between `@objectstack/spec` `TranslationData` (the wire format
+ * served by `/api/v1/i18n/translations/:locale`) and the flat namespace
+ * tree that `@object-ui/i18n`'s `useObjectLabel` hook reads.
+ *
+ * The spec format nests every per-object scope (`fields`, `_views`,
+ * `_actions`, …) under `objects.<n>.*`. `useObjectLabel` resolves keys
+ * in two different shapes depending on the scope:
+ *
+ *   - **Flattened scopes** — `fields` becomes a top-level `fields.<obj>.<fld>`
+ *     string map (and field options become `fieldOptions.<obj>.<fld>.<value>`)
+ *     so per-field label lookup is cheap.
+ *   - **Nested scopes** — every `_`-prefixed key (`_views`, `_actions`,
+ *     `_sections`, `_notifications`, `_errors`, `_options`, …) is preserved
+ *     verbatim under `objects.<n>._xxx`, matching the resolver
+ *     conventions documented in `useObjectLabel` (e.g.
+ *     `viewLabel` reads `objects.<n>._views.<view>.label`).
+ *
+ * The "preserve every `_`-prefixed key" rule is intentional: it future-proofs
+ * the transform so newly-introduced spec scopes do **not** need a code change
+ * here to flow through to the UI. This prevents a class of silent-failure
+ * regressions where a new scope (e.g. `_views`) is added to the spec but the
+ * console transform forgets to copy it, leaving lookups to fall back to the
+ * untranslated source label.
+ */
+/**
+ * Detect whether the given record uses the spec `TranslationData` format.
+ *
+ * Returns `true` when `data.objects` exists and at least one entry has a
+ * nested `fields` object (the distinguishing trait vs. an already-flattened
+ * namespace tree).
+ */
+export function isSpecTranslationData(data) {
+    if (!data)
+        return false;
+    const objects = data.objects;
+    if (!objects || typeof objects !== 'object' || Array.isArray(objects))
+        return false;
+    for (const obj of Object.values(objects)) {
+        if (obj && typeof obj === 'object' && !Array.isArray(obj) && 'fields' in obj) {
+            return true;
+        }
+    }
+    return false;
+}
+/** Top-level keys that are copied through unchanged onto the `app` namespace. */
+const PASSTHROUGH_TOP_LEVEL_KEYS = [
+    'apps',
+    'messages',
+    'validationMessages',
+    'dashboards',
+    'globalActions',
+];
+/**
+ * Transform a `@objectstack/spec` `TranslationData` payload into the
+ * namespaced tree expected by `useObjectLabel`.
+ *
+ * The output is wrapped under an `app` namespace key so the hook's
+ * `getAppNamespaces()` discovery (which keys off the presence of `objects`
+ * and `fields`) picks it up automatically.
+ *
+ * Behaviour:
+ *   - `objects.<n>.label / pluralLabel / description` — copied verbatim.
+ *   - `objects.<n>._*` — every underscore-prefixed key (any depth) is
+ *     preserved as-is. This is the rule that prevents future spec scopes
+ *     (`_views`, `_actions`, `_sections`, `_notifications`, `_errors`,
+ *     `_options`, anything new) from silently disappearing.
+ *   - `objects.<n>.fields.<f>.label` — flattened to `fields.<n>.<f>`.
+ *   - `objects.<n>.fields.<f>.options` — flattened to
+ *     `fieldOptions.<n>.<f>.<value>`.
+ *   - `apps / messages / validationMessages / dashboards / globalActions`
+ *     — copied verbatim to the `app` namespace root.
+ *   - Any other top-level key on the source payload is also copied through,
+ *     so new top-level spec namespaces flow through without a code change.
+ */
+export function transformSpecTranslations(data) {
+    const objects = {};
+    const fields = {};
+    const fieldOptions = {};
+    const srcObjects = data.objects;
+    if (srcObjects) {
+        for (const [objName, objData] of Object.entries(srcObjects)) {
+            if (!objData || typeof objData !== 'object')
+                continue;
+            const obj = {};
+            if (objData.label)
+                obj.label = objData.label;
+            if (objData.pluralLabel)
+                obj.pluralLabel = objData.pluralLabel;
+            if (objData.description)
+                obj.description = objData.description;
+            // Preserve EVERY `_`-prefixed nested scope (e.g. `_views`, `_actions`,
+            // `_sections`, `_notifications`, `_errors`, `_options`, …). Doing this
+            // by-convention (rather than a whitelist) means new spec scopes flow
+            // through without a code change here.
+            for (const [k, v] of Object.entries(objData)) {
+                if (k.startsWith('_'))
+                    obj[k] = v;
+            }
+            objects[objName] = obj;
+            // Flatten fields: objects.<n>.fields.<f>.label → fields.<n>.<f>
+            if (objData.fields && typeof objData.fields === 'object') {
+                const fieldEntries = Object.entries(objData.fields);
+                for (const [fieldName, fieldData] of fieldEntries) {
+                    if (fieldData?.label) {
+                        if (!fields[objName])
+                            fields[objName] = {};
+                        fields[objName][fieldName] = fieldData.label;
+                    }
+                    if (fieldData?.options &&
+                        typeof fieldData.options === 'object' &&
+                        Object.keys(fieldData.options).length > 0) {
+                        if (!fieldOptions[objName])
+                            fieldOptions[objName] = {};
+                        fieldOptions[objName][fieldName] = fieldData.options;
+                    }
+                }
+            }
+        }
+    }
+    const appNs = {};
+    if (Object.keys(objects).length > 0)
+        appNs.objects = objects;
+    if (Object.keys(fields).length > 0)
+        appNs.fields = fields;
+    if (Object.keys(fieldOptions).length > 0)
+        appNs.fieldOptions = fieldOptions;
+    for (const key of PASSTHROUGH_TOP_LEVEL_KEYS) {
+        if (data[key] !== undefined)
+            appNs[key] = data[key];
+    }
+    // Forward any future top-level namespace we don't explicitly know about,
+    // skipping the ones we've already consumed or flattened.
+    const consumedTopLevel = new Set(['objects', ...PASSTHROUGH_TOP_LEVEL_KEYS]);
+    for (const [k, v] of Object.entries(data)) {
+        if (consumedTopLevel.has(k))
+            continue;
+        appNs[k] = v;
+    }
+    return { app: appNs };
+}

package/package.json

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