Skip to content
This repository was archived by the owner on Nov 4, 2026. It is now read-only.

fix(app-shell): resolve a report's inline locale label and description to the viewer's language (objectui#13470) - #13487

Merged
objectstack-fleet[bot] merged 2 commits into
mainfrom
claude/project-thread-j5a2c7
Oct 25, 2026
Merged

objectstack-fleet[bot] merged 2 commits into
mainfrom
claude/project-thread-j5a2c7

Conversation

@objectstack-fleet

Copy link
Copy Markdown
Contributor

Requested by Elon · project thread

  • Adds no product-specific widget, dialog, hook or string (see AGENTS.md › Product-neutral renderer)

Fixes #13470
Clause-②: no
Metadata-protocol: none

What changed

ReportSchema in @objectstack/spec types a report's label and description as I18nLabel, so an inline locale map such as { 'zh-CN', en } is valid metadata, and the /meta read serves it unchanged. Four places on the report route drew it raw:

  • ReportView's page heading (previewReport.title || previewReport.label) and the line under it (previewReport.description). React refused the object as a child (error Task: Refactor Monorepo to Support Lazy-Loaded Plugins #31) and the page was blank for every viewer, the card's repro.
  • The app bar's report crumb in AppHeader. It handed the served label to reportLabel as its fallback, and reportLabel returns an unmatched fallback untouched, so the map reached JSX there too. With ReportView fixed alone, the page stayed blank through this crumb (measured: the ablation below).
  • The drill drawer's title for a whole-report drill (empty group key) fell back to String(reportData.label), which reads [object Object].

Each now resolves the map in the viewer's language (useObjectTranslation().language) with metadataText, the app-shell reader the app's report index (useAppReportEntries) and recent items already name a report with. It is the spec's resolveI18nLabel, which agrees limb for limb with pickLocalized (the resolver the objectui#13380 fix used) and spells a miss undefined, so the existing fallbacks ('Report Viewer', the humanized slug, the report name) keep working through ??. A plain-string label or description draws exactly as before. One changeset: @object-ui/app-shell patch.

The other surfaces that print a report's label or description were checked and already resolve the map: the app's report index (AppReportIndexView) and the ⌘K palette's app-report rows both read useAppReportEntries, which calls metadataText. The palette's navigation rows print the navigation entry's own label, not the report's.

Tests

New pins, both mounting the real component under a real I18nProvider, each leg in en and zh-CN, with a plain-string report as the control:

  • packages/app-shell/src/views/ReportView.inlineLocaleLabel-13470.test.tsx: the card's repro report, with the map on both label and description. Legs HEADING_MAP_RESOLVES, DESCRIPTION_MAP_RESOLVES, DRILL_TITLE_MAP_RESOLVES, PLAIN_STRING_CONTROL.
  • packages/app-shell/src/layout/__tests__/AppHeader.reportCrumbInlineLocale-13470.test.tsx: the AppHeader.dashboardReportCrumb-12273 harness with useObjectLabel real. Legs LABEL_MAP_RESOLVES, PLAIN_STRING_CONTROL.

Readings, all at head 899902d:

  • The two new files: Test Files 2 passed (2), Tests 12 passed (12).
  • Every test file that imports ReportView, AppHeader, AppReportIndexView or appReportIndex (39 files, found by git grep over test files), with pnpm exec vitest run --maxWorkers=2: Test Files 39 passed (39), Tests 323 passed (323).
  • turbo run type-check --filter=@object-ui/app-shell --concurrency=2: 30 successful, 30 total. The package's type-check chains tsconfig.test.json, so both new test files are type-checked.
  • eslint on the four touched files: 0 errors. The 44 warnings are on lines this PR does not change.
  • node scripts/check-changeset-presence.mjs: pass (1 changeset for 1 released package). pnpm check:new-line-citations: 0 new citations. node scripts/check-changeset-no-major.mjs: pass.

Narrowed, declared: the whole packages/app-shell/ suite at --maxWorkers=2 printed nothing for 60 minutes on this shared container and was stopped, so it is NOT MEASURED locally; CI's sharded pnpm test runs it. The narrowed set is every test that imports a changed module. Its blind spot: a test that mounts these components through another import path without naming them.

Ablation, one site at a time on the committed fix. Each leg put the pre-fix line back, ran the two new files, then restored the file with git checkout HEAD and confirmed git diff HEAD was empty:

  • heading reverted: 6 failed, 6 passed. Every map leg of the ReportView file fails on Objects are not valid as a React child (found: object with keys {zh-CN, en}); the control legs and the crumb file pass.
  • description reverted: 6 failed, 6 passed, the same error.
  • drill title reverted: 2 failed, 10 passed. Only DRILL_TITLE_MAP_RESOLVES fails, in both languages, and the drawer reads [object Object].
  • crumb reverted: 2 failed, 10 passed. Only the crumb file's LABEL_MAP_RESOLVES legs fail, on the same React error Task: Refactor Monorepo to Support Lazy-Loaded Plugins #31.

Acceptance notes

  • Same defect on the page route, measured, not fixed here (outside this card's file surface): AppHeader's page branch hands pageDef.label to pageLabel as its fallback the same way, and PageSchema.label is I18nLabel too. A throwaway probe (not committed) mounted this PR's crumb harness at /apps/srm/page/welcome with that page's label set to { 'zh-CN', en }: it fails on Objects are not valid as a React child (found: object with keys {zh-CN, en}), so a page with an inline-map label blanks its route. Handed to the seat to file.
  • DatasetReportRenderer's resolveText (the heading of each block of a joined report) reads only a map's default entry, so a block label written as { 'zh-CN', en } shows the block's name instead of either string. Read-only observation from the code, not measured; nothing filed.
  • ReportView still reads previewReport.title before label. ReportSchema declares no root title, so the arm reads a key no valid document carries (the dashboard view retired its twin under ADR-0049). Left as it was, now resolved like label; outside this card.
  • The report crumb still passes through the reports.NAME.label bundle lookup (reportLabel), while the page heading draws the served label as given. That split predates this PR and is unchanged.

🤖 Generated with Claude Code

https://claude.ai/code/session_01EsHaC5nYMcJgk2Nr6fbVdG

…n to the viewer's language (objectui#13470)

ReportSchema types a report's label and description as I18nLabel, so an
inline locale map ({ en, 'zh-CN' }) is valid metadata and is served
unchanged. ReportView drew both raw into the page heading and the line
under it, and the app bar's report crumb handed the label to reportLabel
as its fallback, so the map reached JSX and React error #31 blanked the
report page for every viewer. A whole-report drill titled its drawer
"[object Object]".

All four sites now resolve the map with metadataText in the viewer's
language, the reader the app's report index and recent items already
name a report with.

Claude-Session: https://claude.ai/code/session_01EsHaC5nYMcJgk2Nr6fbVdG
Co-authored-by: Claude <noreply@anthropic.com>
…nes (objectui#13470)

Claude-Session: https://claude.ai/code/session_01EsHaC5nYMcJgk2Nr6fbVdG
Co-authored-by: Claude <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 85 chunks) 3014.5 KB 3496.0 KB
Main entry chunk (gzip) 80.3 KB 350 KB
Entry file index-COrvRwB2.js —
Status PASS —

The eager closure is every chunk the entry reaches through static imports — what the browser fetches and parses before the app renders. The entry chunk on its own is a small fraction of it.


📦 Bundle Size Report

Package Size Gzipped
app-shell (buildIdentity.js) 0.80KB 0.49KB
app-shell (consoleActionDispatch.js) 0.20KB 0.19KB
app-shell (index.js) 21.41KB 7.90KB
app-shell (runtime-config.js) 24.52KB 8.48KB
app-shell (types.js) 0.01KB 0.04KB
app-shell (urlParams.js) 10.11KB 3.87KB
auth (ActiveOrganizationStorage.js) 27.95KB 10.04KB
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 2.07KB 1.00KB
auth (AuthProvider.js) 45.59KB 12.03KB
auth (AuthShell.js) 3.49KB 1.40KB
auth (ForgotPasswordForm.js) 12.21KB 3.45KB
auth (LoginForm.js) 20.67KB 6.12KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.72KB 2.24KB
auth (SocialSignInButtons.js) 9.74KB 3.94KB
auth (UserMenu.js) 3.39KB 1.21KB
auth (auth-gate-events.js) 1.62KB 0.83KB
auth (authStyles.js) 5.27KB 1.86KB
auth (createAuthClient.js) 42.84KB 11.66KB
auth (createAuthenticatedFetch.js) 8.54KB 3.46KB
auth (index.js) 3.63KB 1.64KB
auth (invitation-status.js) 1.22KB 0.70KB
auth (org-roles.js) 8.84KB 3.61KB
auth (phone-identifier.js) 1.11KB 0.66KB
auth (types.js) 0.59KB 0.35KB
auth (useAuth.js) 5.30KB 1.02KB
auth (useWorkspaceAdminStatus.js) 11.08KB 4.58KB
collaboration (CommentThread.js) 27.26KB 8.03KB
collaboration (LiveCursors.js) 3.17KB 1.27KB
collaboration (PresenceAvatars.js) 6.28KB 2.60KB
collaboration (PresenceProvider.js) 2.79KB 1.13KB
collaboration (commentAuthorship.js) 1.39KB 0.78KB
collaboration (index.js) 1.93KB 0.85KB
collaboration (useCollaborationTranslation.js) 6.50KB 2.52KB
collaboration (useCommentSearch.js) 1.98KB 0.88KB
collaboration (useConflictResolution.js) 7.75KB 1.86KB
collaboration (useMentionNotifications.js) 1.81KB 0.68KB
collaboration (usePresence.js) 6.33KB 1.84KB
collaboration (useRealtimeSubscription.js) 7.91KB 2.01KB
components (index.js) 614.94KB 150.52KB
core (index.js) 10.18KB 4.04KB
create-plugin (index.js) 27.94KB 9.51KB
data-objectstack (index.js) 253.04KB 70.68KB
fields (index.js) 295.90KB 75.88KB
i18n (LocalizationContext.js) 2.92KB 1.42KB
i18n (builtinAggregateLabels.js) 0.86KB 0.49KB
i18n (currency.js) 2.59KB 1.22KB
i18n (fallbackInterpolation.js) 6.25KB 2.77KB
i18n (i18n.js) 8.87KB 3.64KB
i18n (index.js) 5.52KB 2.39KB
i18n (pickLocalized.js) 9.86KB 3.95KB
i18n (provider.js) 39.35KB 12.88KB
i18n (translateFn.js) 0.20KB 0.18KB
i18n (useDisplayLocale.js) 3.52KB 1.76KB
i18n (useObjectLabel.js) 36.87KB 9.88KB
i18n (useSafeTranslation.js) 7.14KB 2.92KB
layout (index.js) 41.17KB 11.96KB
mobile (MobileProvider.js) 0.92KB 0.49KB
mobile (ResponsiveContainer.js) 0.94KB 0.38KB
mobile (breakpoints.js) 1.51KB 0.70KB
mobile (createOfflineDataSource.js) 5.61KB 1.75KB
mobile (index.js) 1.99KB 0.87KB
mobile (offlineQueue.js) 3.91KB 1.35KB
mobile (pwa.js) 0.97KB 0.49KB
mobile (serviceWorker.js) 1.48KB 0.62KB
mobile (serviceWorkerSource.js) 3.41KB 1.48KB
mobile (useBreakpoint.js) 1.54KB 0.65KB
mobile (useGesture.js) 6.96KB 1.98KB
mobile (useOfflineSync.js) 1.99KB 0.72KB
mobile (usePullToRefresh.js) 6.62KB 2.45KB
mobile (useResponsive.js) 0.72KB 0.42KB
mobile (useSpecGesture.js) 5.52KB 2.10KB
mobile (useTouchTarget.js) 1.01KB 0.54KB
permissions (MePermissionsProvider.js) 15.35KB 5.51KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 6.82KB 2.38KB
permissions (ServerReadScope.js) 4.03KB 1.82KB
permissions (discardProofCache.js) 1.04KB 0.55KB
permissions (evaluator.js) 8.33KB 3.07KB
permissions (index.js) 0.99KB 0.43KB
permissions (store.js) 0.91KB 0.42KB
permissions (useFieldPermissions.js) 1.28KB 0.53KB
permissions (usePermissions.js) 4.83KB 2.27KB
plugin-ai (index.js) 16.01KB 3.91KB
plugin-calendar (index.js) 55.41KB 16.19KB
plugin-charts (index.js) 88.30KB 24.33KB
plugin-chatbot (core.js) 5.22KB 2.18KB
plugin-chatbot (index.js) 237.93KB 56.26KB
plugin-dashboard (index.js) 147.15KB 39.95KB
plugin-designer (index.js) 232.83KB 50.01KB
plugin-detail (index.js) 267.21KB 71.14KB
plugin-editor (index.js) 2.21KB 1.04KB
plugin-form (index.js) 185.46KB 48.48KB
plugin-gantt (index.js) 178.19KB 45.06KB
plugin-grid (index.js) 278.30KB 77.57KB
plugin-kanban (index.js) 64.27KB 19.81KB
plugin-list (index.js) 149.60KB 39.26KB
plugin-map (index.js) 27.11KB 8.99KB
plugin-markdown (index.js) 13.79KB 4.79KB
plugin-report (index.js) 46.42KB 13.06KB
plugin-timeline (index.js) 39.30KB 11.87KB
plugin-tree (index.js) 15.25KB 5.38KB
plugin-view (index.js) 94.26KB 24.27KB
providers (DataSourceProvider.js) 0.75KB 0.39KB
providers (MetadataProvider.js) 1.37KB 0.59KB
providers (ThemeProvider.js) 1.90KB 0.85KB
providers (UploadProvider.js) 12.07KB 3.68KB
providers (index.js) 0.45KB 0.23KB
providers (types.js) 0.01KB 0.04KB
react-runtime (index.js) 5.62KB 2.34KB
react (LazyPluginLoader.js) 4.47KB 1.63KB
react (SchemaRenderer.js) 129.13KB 42.23KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 4.71KB 2.11KB
react (schema-input.js) 4.31KB 2.07KB
react (spec-input.js) 0.20KB 0.18KB
sdui-parser (body-dialect.js) 4.50KB 1.99KB
sdui-parser (codegen.js) 9.45KB 3.76KB
sdui-parser (dashboard-widget-options.js) 3.07KB 1.30KB
sdui-parser (index.js) 7.30KB 3.12KB
sdui-parser (input-type.js) 2.84KB 1.40KB
sdui-parser (parse.js) 25.28KB 7.81KB
sdui-parser (provenance.js) 3.84KB 1.90KB
sdui-parser (types.js) 0.29KB 0.24KB
sdui-parser (validate.js) 23.87KB 7.83KB
types (ai.js) 4.39KB 2.17KB
types (api-types.js) 0.20KB 0.18KB
types (app.js) 4.12KB 1.61KB
types (authoring-nodes.js) 0.20KB 0.19KB
types (base.js) 0.20KB 0.18KB
types (blocks.js) 0.20KB 0.18KB
types (cloud.js) 0.20KB 0.18KB
types (complex.js) 4.44KB 2.07KB
types (crud.js) 0.20KB 0.18KB
types (dashboard-filter-alias.js) 6.23KB 2.74KB
types (dashboard-widget-layout.js) 2.06KB 0.96KB
types (data-display.js) 3.75KB 1.85KB
types (data-protocol.js) 0.20KB 0.19KB
types (data.js) 0.20KB 0.18KB
types (designer.js) 1.85KB 0.85KB
types (disclosure.js) 0.20KB 0.18KB
types (error-code.js) 1.54KB 0.88KB
types (expression.js) 0.20KB 0.18KB
types (feedback.js) 0.20KB 0.18KB
types (field-types.js) 1.13KB 0.65KB
types (form.js) 0.20KB 0.18KB
types (http-inflight.js) 8.87KB 3.73KB
types (http-retry.js) 4.32KB 2.02KB
types (icon-key-migration.js) 4.26KB 1.63KB
types (index.js) 5.78KB 2.70KB
types (layout.js) 0.20KB 0.18KB
types (managed-by.js) 0.19KB 0.18KB
types (mobile.js) 5.00KB 2.39KB
types (navigation.js) 0.20KB 0.18KB
types (node-slots.js) 7.18KB 2.34KB
types (objectql.js) 0.20KB 0.18KB
types (overlay.js) 0.20KB 0.18KB
types (permissions.js) 2.52KB 1.31KB
types (plugin-scope.js) 0.20KB 0.18KB
types (product-blocks.js) 0.20KB 0.19KB
types (record-approval-decision.js) 0.20KB 0.20KB
types (record-components.js) 0.20KB 0.19KB
types (record-panels.js) 0.20KB 0.19KB
types (record-semantics.js) 1.28KB 0.67KB
types (registry.js) 0.20KB 0.18KB
types (reports.js) 0.20KB 0.18KB
types (select-option.js) 0.20KB 0.19KB
types (spec-report.js) 4.99KB 1.96KB
types (spec-ui-namespace.js) 0.20KB 0.19KB
types (strict-authoring-face.js) 19.93KB 7.26KB
types (system-fields.js) 3.33KB 1.54KB
types (theme.js) 6.28KB 2.87KB
types (ui-action.js) 8.48KB 3.50KB
types (views.js) 0.20KB 0.18KB
types (widget.js) 0.20KB 0.18KB

Size Limits

  • ✅ Core packages should be < 50KB gzipped
  • ✅ Component packages should be < 100KB gzipped
  • ⚠️ Plugin packages should be < 150KB gzipped

@objectstack-fleet

Copy link
Copy Markdown
Contributor Author

席位核对 — ACCEPT · PR #13487 @ 899902d6b4a2d84058fe491c02e9c29676dbec4c · domain:ui#4 · 2026-10-25T01:52Z

Reviewer of record: session_01XWGTsmqrtrt1Zqh1ioWqsT (seat 4). Implemented-by: session_01EsHaC5nYMcJgk2Nr6fbVdG on claude/project-thread-j5a2c7. Card objectui#13470, claim 6391380639, report 6392069300.

  1. Shape: draft, base main, Fixes #13470. No other open card number sits next to a closing keyword. 5 files (+379 −9): ReportView.tsx, AppHeader.tsx, two new pins, one changeset. All are inside the claimed surface: AppHeader's report crumb is a "nav surface that prints a report label".
  2. Premise measured: the four sites drew I18nLabel raw on cd70b78: the heading, the description, the whole-report drill title (String(label)) and the crumb (reportLabel returns its fallback untouched). Each now goes through metadataText(…, language). The seat read it on origin/main: useNavTargetLabel.ts:74-77 returns undefined for a blank or unresolvable value. So ?? keeps the old || fall-through to 'Report Viewer', the humanized slug and the report name, and a plain string draws as before. The dev's per-site ablation turns only that site's legs red.
  3. Gates on this head: 33 check-runs success (Lint, Type Check, Test shards 1–16 and the aggregate Test, Build & E2E, Build Docs, Repo Gates, the changeset family, Line Citation Gate, Governed Surface Queue Guard, Bundle Analysis, Test (dist pins), label, Live E2E (informational)) and 3 skipped (coverage jobs, dependabot). mergeable_state: clean. CI's sharded run covers the whole app-shell suite the dev could not finish locally (declared in the body).
  4. Accepted deviations: title is still read before label (an undeclared key, now resolved like label). The crumb still passes through the reports.NAME.label bundle lookup while the heading draws the served label. Both predate this PR and are recorded in its Acceptance notes.
  5. Out of scope: the page-route twin, measured by a probe, is filed as objectui#13488. DatasetReportRenderer.resolveText reading only default is unmeasured code reading, so it stays in Acceptance notes.
  6. Landing: not governed (no .claude/**, skills/**, AGENTS.md, workflows). Changeset: @object-ui/app-shell patch, Clause-② no / Metadata-protocol none. The seat read its paragraph against the diff and it matches. The maintainer's standing landing word was given in this seat's project thread at 2026-10-25T01:48Z, so the seat lands it.

Generated by Claude Code

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Report page goes blank (React error #31) when a report's label or description is the spec's inline locale map (I18nLabel { zh-CN, en })

2 participants