chore(spec): regenerate generated surfaces from the merged tree

os-regen four-step after merging origin/main: docs references, api-surface,
authorable-surface (base + system). check:generated 10/10, check:spec-parsed-alias
756 OK, check:i18n-coverage none new.

Author: claude

content/docs/references/index.mdx

@@ -1,6 +1,6 @@
 ---
 title: Protocol Reference
-description: Every schema published by @objectstack/spec — 1605 schemas across 14 protocol modules
+description: Every schema published by @objectstack/spec — 1606 schemas across 14 protocol modules
 ---
 
 {/* ⚠️  AUTO-GENERATED — DO NOT EDIT. Run build-docs.ts to regenerate. Hand-written docs live in the module folders under content/docs/. */}
@@ -32,8 +32,8 @@ counts are sums of the rows they head. Regenerate with
 | [Shared Protocol](/docs/references/shared) | 8 | 31 | Primitives used across every protocol — identifiers, HTTP, expressions, error maps, enums. |
 | [Studio Protocol](/docs/references/studio) | 3 | 35 | Studio designer metadata — the authoring surfaces for the protocols above. |
 | [System Protocol](/docs/references/system) | 37 | 296 | The runtime environment — logging, jobs, cache, metrics, notifications, i18n and compliance. |
-| [UI Protocol](/docs/references/ui) | 16 | 146 | Apps, pages, views, dashboards, reports, actions and themes — the ObjectUI layer. |
-| **Total** | **200** | **1605** | 14 protocol modules |
+| [UI Protocol](/docs/references/ui) | 16 | 147 | Apps, pages, views, dashboards, reports, actions and themes — the ObjectUI layer. |
+| **Total** | **200** | **1606** | 14 protocol modules |
 
 ---
 
@@ -366,7 +366,7 @@ The runtime environment — logging, jobs, cache, metrics, notifications, i18n a
 
 ## UI Protocol
 
-**Source:** `packages/spec/src/ui/` · **Import:** `@objectstack/spec/ui` · **16 pages, 146 schemas**
+**Source:** `packages/spec/src/ui/` · **Import:** `@objectstack/spec/ui` · **16 pages, 147 schemas**
 
 Apps, pages, views, dashboards, reports, actions and themes — the ObjectUI layer.
 
@@ -380,7 +380,7 @@ Apps, pages, views, dashboards, reports, actions and themes — the ObjectUI lay
 | [`component.zod.ts`](/docs/references/ui/component) | `AIChatWindowProps`, `ElementButtonProps`, `ElementFilterProps`, `ElementFormProps`, `ElementImageProps`, `ElementMetadataViewerProps`, `ElementNumberProps`, `ElementRecordPickerProps`, `ElementTextInputProps`, `ElementTextProps`, `PageAccordionProps`, `PageCardProps`, `PageContainerProps`, `PageHeaderProps`, `PageTabsProps`, `RecordActivityProps`, `RecordChatterProps`, `RecordDetailsProps`, `RecordHighlightsField`, `RecordHighlightsProps`, `RecordPathProps`, `RecordRelatedListProps` |
 | [`dashboard.zod.ts`](/docs/references/ui/dashboard) | `Dashboard`, `DashboardHeader`, `DashboardHeaderAction`, `DashboardWidget`, `DashboardWidgetOptions`, `GlobalFilter`, `GlobalFilterOptionsFrom`, `WidgetActionType`, `WidgetColorVariant` |
 | [`dataset.zod.ts`](/docs/references/ui/dataset) | `Dataset`, `DatasetDimension`, `DatasetMeasure`, `DerivedMeasureOp` |
-| [`i18n.zod.ts`](/docs/references/ui/i18n) | `AriaProps`, `I18nLabel` |
+| [`i18n.zod.ts`](/docs/references/ui/i18n) | `AriaProps`, `I18nLabel`, `InlineLocaleMap` |
 | [`notification.zod.ts`](/docs/references/ui/notification) | `NotificationPosition`, `NotificationSeverity`, `NotificationType` |
 | [`page.zod.ts`](/docs/references/ui/page) | `ElementDataSource`, `InterfacePageConfig`, `Page`, `PageComponent`, `PageComponentType`, `PageRegion`, `PageType`, `PageVariable` |
 | [`report.zod.ts`](/docs/references/ui/report) | `JoinedReportBlock`, `Report`, `ReportChart`, `ReportSort`, `ReportType` |

content/docs/references/system/settings-manifest.mdx

@@ -77,7 +77,7 @@ const result = ResolvedSettingValueSchema.parse(data);
 | :--- | :--- | :--- | :--- |
 | **namespace** | `string` | ✅ | Namespace (snake_case, globally unique) |
 | **version** | `integer` | optional | Manifest schema version |
-| **label** | `string` | ✅ | Display label |
+| **label** | `string \| Record<string, string>` | ✅ | Display label |
 | **icon** | `string` | optional | Icon (Lucide) |
 | **description** | `string` | optional | Short description |
 | **helpText** | `string` | optional | Markdown help text shown above specifiers |
@@ -86,7 +86,7 @@ const result = ResolvedSettingValueSchema.parse(data);
 | **writePermission** | `string` | optional | Permission required to write |
 | **category** | `string` | optional | Settings hub category |
 | **order** | `number` | optional | Display order |
-| **specifiers** | `{ type: Enum<'group' \| 'child_pane' \| 'info_banner' \| 'title_value' \| 'text' \| 'textarea' \| … +13 more>; id?: string; key?: string; label: string; … }[]` | ✅ | Page contents (ordered) |
+| **specifiers** | `{ type: Enum<'group' \| 'child_pane' \| 'info_banner' \| 'title_value' \| 'text' \| 'textarea' \| … +13 more>; id?: string; key?: string; label: string \| Record<string, string>; … }[]` | ✅ | Page contents (ordered) |
 | **visible** | `string \| { dialect: Enum<'cel' \| 'cron' \| 'template'>; source?: string; ast?: any; meta?: object }` | optional | Whole-manifest visibility |
 | **featureFlag** | `string` | optional | Gate manifest visibility on a feature flag |
 | **beta** | `boolean` | optional | Show a Beta chip on the page |
@@ -100,7 +100,7 @@ const result = ResolvedSettingValueSchema.parse(data);
 
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
-| **manifest** | `{ namespace: string; version?: integer; label: string; icon?: string; … }` | ✅ |  |
+| **manifest** | `{ namespace: string; version?: integer; label: string \| Record<string, string>; icon?: string; … }` | ✅ |  |
 | **values** | `Record<string, { value: any; source: Enum<'env' \| 'global' \| 'tenant' \| 'user' \| 'default'>; locked: boolean; lockedReason?: string; … }>` | ✅ | Effective values keyed by specifier.key |
 
 
@@ -115,7 +115,7 @@ const result = ResolvedSettingValueSchema.parse(data);
 | **type** | `Enum<'group' \| 'child_pane' \| 'info_banner' \| 'title_value' \| 'text' \| 'textarea' \| 'password' \| 'email' \| 'url' \| 'phone' \| 'number' \| 'toggle' \| 'select' \| 'radio' \| … +5 more>` | ✅ | Specifier variant |
 | **id** | `string` | optional | Stable identifier (snake_case) |
 | **key** | `string` | optional | Storage key (snake_case) |
-| **label** | `string` | ✅ | Display label |
+| **label** | `string \| Record<string, string>` | ✅ | Display label |
 | **description** | `string` | optional | Help text |
 | **icon** | `string` | optional | Icon name (Lucide) |
 | **default** | `any` | optional | Default value |
@@ -129,7 +129,7 @@ const result = ResolvedSettingValueSchema.parse(data);
 | **writePermission** | `string` | optional | Permission required to write this specifier |
 | **deprecated** | `boolean` | optional | Mark deprecated |
 | **replacedBy** | `string` | optional | Replacement key (used when deprecated=true) |
-| **options** | `{ value: string \| number \| boolean; label: string; description?: string; icon?: string }[]` | optional | Options for select/radio/multiselect |
+| **options** | `{ value: string \| number \| boolean; label: string \| Record<string, string>; description?: string; icon?: string }[]` | optional | Options for select/radio/multiselect |
 | **valueDomain** | `Enum<'iana_time_zone' \| 'iso_4217_currency' \| 'iso_3166_alpha2'>` | optional | Standard value domain enforced on write (options degrade to a UI suggestion list) |
 | **min** | `number` | optional |  |
 | **max** | `number` | optional |  |
@@ -138,7 +138,7 @@ const result = ResolvedSettingValueSchema.parse(data);
 | **maxLength** | `integer` | optional |  |
 | **pattern** | `string` | optional | Regex pattern (text only) |
 | **rows** | `integer` | optional |  |
-| **handler** | `{ kind: 'http'; method?: Enum<'GET' \| 'POST' \| 'PUT' \| 'DELETE' \| 'PATCH'>; url: string; body?: Record<string, any>; … } \| { kind: 'action'; name: string; params?: Record<string, any>; confirmText?: string } \| { kind: 'navigate'; url: string; target?: Enum<'_self' \| '_blank'> }` | optional | Action handler (action_button) |
+| **handler** | `{ kind: 'http'; method?: Enum<'GET' \| 'POST' \| 'PUT' \| 'DELETE' \| 'PATCH'>; url: string; body?: Record<string, any>; … } \| { kind: 'action'; name: string; params?: Record<string, any>; confirmText?: string \| Record<string, string> } \| { kind: 'navigate'; url: string; target?: Enum<'_self' \| '_blank'> }` | optional | Action handler (action_button) |
 | **childNamespace** | `string` | optional | Sub-namespace (child_pane) |
 | **bannerText** | `string` | optional | Markdown body (info_banner) |
 | **bannerSeverity** | `Enum<'info' \| 'success' \| 'warning' \| 'error'>` | optional |  |
@@ -184,7 +184,7 @@ This schema accepts one of the following structures:
 | **method** | `Enum<'GET' \| 'POST' \| 'PUT' \| 'DELETE' \| 'PATCH'>` | ✅ |  |
 | **url** | `string` | ✅ | Endpoint URL; supports $`{...}` interpolation |
 | **body** | `Record<string, any>` | optional | Optional JSON body; supports $`{...}` interpolation |
-| **confirmText** | `string` | optional | Confirm dialog text before invoking (omit = no confirm) |
+| **confirmText** | `string \| Record<string, string>` | optional | Confirm dialog text before invoking (omit = no confirm) |
 
 ---
 
@@ -197,7 +197,7 @@ This schema accepts one of the following structures:
 | **kind** | `'action'` | ✅ |  |
 | **name** | `string` | ✅ | Registered action machine name |
 | **params** | `Record<string, any>` | optional |  |
-| **confirmText** | `string` | optional | Display label (plain string; i18n keys are auto-generated by the framework) |
+| **confirmText** | `string \| Record<string, string>` | optional | Display label — the default-language string, or an inline locale map (`{ en, "zh-CN" }`) resolved at render time |
 
 ---
 
@@ -223,7 +223,7 @@ This schema accepts one of the following structures:
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
 | **value** | `string \| number \| boolean` | ✅ | Stored value |
-| **label** | `string` | ✅ | Display label |
+| **label** | `string \| Record<string, string>` | ✅ | Display label |
 | **description** | `string` | optional | Optional helper text |
 | **icon** | `string` | optional | Optional Lucide icon name |
 

content/docs/references/ui/dataset.mdx

@@ -49,13 +49,13 @@ const result = DatasetSchema.parse(data);
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
 | **name** | `string` | ✅ | Dataset unique name |
-| **label** | `string` | ✅ | Dataset label |
-| **description** | `string` | optional | Display label (plain string; i18n keys are auto-generated by the framework) |
+| **label** | `string \| Record<string, string>` | ✅ | Dataset label |
+| **description** | `string \| Record<string, string>` | optional | Display label — the default-language string, or an inline locale map (`{ en, "zh-CN" }`) resolved at render time |
 | **object** | `string` | ✅ | Base object name |
 | **include** | `string[]` | optional | Relationship names/paths to join (derived from object graph; max 3 hops) |
 | **filter** | `any` | optional | Intrinsic dataset scope filter |
-| **dimensions** | `{ name: string; label?: string; field: string; type?: Enum<'string' \| 'number' \| 'date' \| 'boolean' \| 'lookup'>; … }[]` | ✅ | Groupable axes |
-| **measures** | `{ name: string; label?: string; aggregate?: Enum<'count' \| 'sum' \| 'avg' \| 'min' \| 'max' \| 'count_distinct'>; field?: string; … }[]` | ✅ | Aggregatable values |
+| **dimensions** | `{ name: string; label?: string \| Record<string, string>; field: string; type?: Enum<'string' \| 'number' \| 'date' \| 'boolean' \| 'lookup'>; … }[]` | ✅ | Groupable axes |
+| **measures** | `{ name: string; label?: string \| Record<string, string>; aggregate?: Enum<'count' \| 'sum' \| 'avg' \| 'min' \| 'max' \| 'count_distinct'>; field?: string; … }[]` | ✅ | Aggregatable values |
 | **protection** | `{ lock: Enum<'none' \| 'no-overlay' \| 'no-delete' \| 'full'>; reason: string; docsUrl?: string }` | optional | Package author protection block — lock policy for this dataset. |
 | **_lock** | `Enum<'none' \| 'no-overlay' \| 'no-delete' \| 'full'>` | optional | Item-level lock — controls overlay & delete (ADR-0010). |
 | **_lockReason** | `string` | optional | Human-readable reason shown when a write is refused by _lock. |
@@ -75,7 +75,7 @@ const result = DatasetSchema.parse(data);
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
 | **name** | `string` | ✅ | Dimension name — referenced by presentations |
-| **label** | `string` | optional | Display label (plain string; i18n keys are auto-generated by the framework) |
+| **label** | `string \| Record<string, string>` | optional | Display label — the default-language string, or an inline locale map (`{ en, "zh-CN" }`) resolved at render time |
 | **field** | `string` | ✅ | Base field, or `relationship[.relationship].field` path |
 | **type** | `Enum<'string' \| 'number' \| 'date' \| 'boolean' \| 'lookup'>` | optional |  |
 | **dateGranularity** | `Enum<'day' \| 'week' \| 'month' \| 'quarter' \| 'year'>` | optional |  |
@@ -90,7 +90,7 @@ const result = DatasetSchema.parse(data);
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
 | **name** | `string` | ✅ | Measure name — e.g. "revenue"; defined once |
-| **label** | `string` | optional | Display label (plain string; i18n keys are auto-generated by the framework) |
+| **label** | `string \| Record<string, string>` | optional | Display label — the default-language string, or an inline locale map (`{ en, "zh-CN" }`) resolved at render time |
 | **aggregate** | `Enum<'count' \| 'sum' \| 'avg' \| 'min' \| 'max' \| 'count_distinct'>` | optional | Aggregation (sum/avg/count/...); omit when `derived` is set |
 | **field** | `string` | optional | Aggregated field; optional for count(*) |
 | **filter** | `any` | optional |  |

packages/spec/api-surface/system.json

@@ -749,6 +749,7 @@
     "VectorClock (type)",
     "VectorClockSchema (const)",
     "ViewLike (interface)",
+    "ViewTabLike (interface)",
     "WidgetLike (interface)",
     "WorkerConfig (type)",
     "WorkerConfigParsed (type)",
@@ -802,6 +803,7 @@
     "resolveSettingsOptionLabel (function)",
     "resolveSettingsSourceLabel (function)",
     "resolveSettingsTitle (function)",
+    "resolveTabLabel (function)",
     "resolveViewDescription (function)",
     "resolveViewLabel (function)",
     "s3StorageExample (const)",