feat(i18n): translate action description (closes the last gap of action i18n) (#1778)

Action labels, confirm text, success messages, and parameter
label/placeholder/helpText/option-label already resolve through i18n. The one
piece the convention was missing is the action's own `description` (the
explanatory line shown in the param dialog / sheet / drawer header), which
flowed through to useActionModal raw.

- Add an `actionDescription` resolver to useObjectLabel (mirrors actionSuccess;
  convention `objects.{object}._actions.{action}.description`, falls back to
  globalActions, then the metadata literal).
- Wire it where the action descriptor is built before the dialog opens —
  useConsoleActionRuntime + RecordDetailView — so the dialog receives a
  localized description (identical mechanism to the already-working
  actionParamText wiring).

Note: no shipped action currently sets a top-level `description`, so this is a
forward-looking capability with no visible change today; it closes the
"description not translatable" half of the issue. Verified by build + the full
app-shell (546) and i18n (120) suites; the test mock gains actionDescription so
the runtime tests stay green.

Closes the i18n-action gap tracked in cloud#73.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: os-zhuang

packages/app-shell/src/hooks/__tests__/useConsoleActionRuntime.test.tsx

@@ -33,6 +33,7 @@ vi.mock('@object-ui/i18n', () => ({
     fieldOptionLabel: (_o: any, _f: any, _v: any, l: any) => l,
     actionParamText: (_o: any, _a: any, _p: any, _attr: any, fallback: any) => fallback,
     actionParamOptionLabel: (_o: any, _a: any, _p: any, _v: any, fallback: any) => fallback,
+    actionDescription: (_o: any, _a: any, fallback: any) => fallback,
   }),
 }));
 

packages/app-shell/src/hooks/useConsoleActionRuntime.tsx

@@ -87,7 +87,7 @@ export function useConsoleActionRuntime(opts: ConsoleActionRuntimeOptions): Cons
   const { dataSource, objects, objectName, onRefresh } = opts;
   const navigate = useNavigate();
   const { user, activeOrganization } = useAuth();
-  const { fieldLabel, fieldOptionLabel, actionParamText, actionParamOptionLabel } = useObjectLabel();
+  const { fieldLabel, fieldOptionLabel, actionParamText, actionParamOptionLabel, actionDescription } = useObjectLabel();
 
   const objectDef = useMemo(
     () => (objectName ? objects?.find((o: any) => o.name === objectName) : undefined),
@@ -152,7 +152,7 @@ export function useConsoleActionRuntime(opts: ConsoleActionRuntimeOptions): Cons
         open: true,
         params: localized,
         title: action?.label || action?.title,
-        description: action?.description,
+        description: actionDescription(objForI18n, action?.name, action?.description),
         resolve,
       });
     });

packages/app-shell/src/views/RecordDetailView.tsx

@@ -119,7 +119,7 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
   const location = useLocation();
   const originFrom = (location.state as any)?.from as { pathname?: string; label?: string } | undefined;
   const { t } = useObjectTranslation();
-  const { objectLabel, viewLabel: _vLabel, sectionLabel, actionLabel, actionConfirm, actionSuccess, actionParamText, actionParamOptionLabel, fieldLabel, fieldOptionLabel } = useObjectLabel();
+  const { objectLabel, viewLabel: _vLabel, sectionLabel, actionLabel, actionConfirm, actionSuccess, actionParamText, actionParamOptionLabel, actionDescription, fieldLabel, fieldOptionLabel } = useObjectLabel();
   const { isFavorite, toggleFavorite, refreshLabel: refreshFavoriteLabel } = useFavorites();
   const { addRecentItem } = useRecentItems();
   const [isLoading, setIsLoading] = useState(true);
@@ -341,7 +341,7 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
         params: localized,
         // Title the dialog as the action rather than the generic "Action parameters".
         title: action?.label || action?.title,
-        description: action?.description,
+        description: actionDescription(objForI18n, action?.name, action?.description),
         resolve,
       });
     });

packages/i18n/src/useObjectLabel.ts

@@ -385,6 +385,23 @@ export function useObjectLabel() {
       return resolved || undefined;
     },
 
+    /**
+     * Resolve translated action description (the explanatory line shown in the
+     * action's param dialog / sheet / drawer header).
+     * Convention: `{ns}.objects.{objectName}._actions.{actionName}.description`.
+     * Falls back to `{ns}.globalActions.{actionName}.description`, then the
+     * metadata's literal string; undefined when nothing resolves.
+     */
+    actionDescription: (objectName: string | undefined, actionName: string | undefined, fallback?: string) => {
+      const fb = fallback ?? '';
+      if (!actionName) return fb || undefined;
+      const suffixes = objectName
+        ? objectSuffixes(objectName, `_actions.${actionName}.description`)
+        : `globalActions.${actionName}.description`;
+      const resolved = resolve(suffixes, fb);
+      return resolved || undefined;
+    },
+
     /**
      * Resolve translated action-PARAMETER text (label / placeholder / helpText).
      * Convention: `{ns}.objects.{objectName}._actions.{actionName}.params.{paramName}.{attr}`.