Skip to content

fix(app-shell,plugin-detail): titles and links that name a list of records read the plural label (objectui#11733) - #11746

Merged
objectstack-fleet[bot] merged 2 commits into
mainfrom
claude/issue-11733-list-links-plural
Oct 6, 2026
Merged

objectstack-fleet[bot] merged 2 commits into
mainfrom
claude/issue-11733-list-links-plural

Conversation

@objectstack-fleet

Copy link
Copy Markdown
Contributor

Fixes #11733

Clause-②: no

What changed

PR objectui#11728 (objectui#11696) gave useObjectLabel() an objectPluralLabel(objectDef) resolver (the translated plural, else the declared pluralLabel, else the singular) and used it for the object list page title, the /data title and the object breadcrumb. Every other place that names a LIST of an object's records now reads it too. Record-scoped text keeps objectLabel.

Card location Producer Change
1. Related-list section titles RecordDetailView, the single-relationship title objectPluralLabel over the child object ("Tasks")
1. Related-list section titles deriveRelatedLists, the title it composes when a child points at the parent through more than one field new listLabel option; RecordDetailView passes objectPluralLabel, so the title reads "Opportunities · Partner Project". It was built from the child's raw, untranslated label before
1. Renderer fallback record:related_list with no title (record-related-list.tsx) the bundle's objects.NAME.pluralLabel, else the translated label, else the humanized name
same family record:reference_rail entries with no title: each card title and the "+ N empty (…)" line (record-reference-rail.tsx) the same as the row above
2. Record form page breadcrumb link RecordFormPage the shared label is split: the link reads listLabel (plural); the "Create …" / "Edit …" title and the save toast keep label (singular)
3. Favorites ObjectView's star button the saved favorite's label is the plural
3. Recent items useRecentItemLabel, object kind calls objectPluralLabel at the call site; useNavTargetLabel is not touched
4. Record back-link fallback ObjectView, both builders (the list schema's onNavigate and the record-link bridge's openRecord) viewOriginLabel(…) || objectPluralLabel(objectDef)
4. Record back-link fallback AppContent, a create that lands on the new record's page the handed-over originLabel is the plural

Where it landed beyond the claim's file surface, and why

The claim named RecordDetailView, record-related-list.tsx, RecordFormPage, ObjectView and the recent-item label. Three more files, each the producer of a surface the card's acceptance covers:

  • packages/app-shell/src/utils/deriveRelatedLists.ts: it produces the multi-relationship related-list title (card location 1). Left alone, the record page would read "Tasks" next to "Opportunity · Partner Project". The new option is internal: deriveRelatedLists is not re-exported from app-shell's package entry (exports is . only, and src/index.ts names no deriveRelatedLists), so nothing published widens.
  • packages/app-shell/src/console/AppContent.tsx: the second producer of the record page's location.state.from.label (card location 4), on the create path. The enumeration pin covers it.
  • packages/plugin-detail/src/renderers/record-reference-rail.tsx: two objectLabel( hits under the enumeration pin's packages/plugin-detail/src, and both name lists.

Clause-②: no still holds: no new export and no new locale key. plugin-detail reaches objectPluralLabel through the hook it already calls (useSafeFieldLabel() returns useObjectLabel()). record-related-list.tsx narrows with 'objectPluralLabel' in i18n instead of the as any cast its singular read used.

The nav entry, unchanged by ruling

useNavTargetLabel's object rung still calls objectLabel, per step 3 of the spec's nav-label rule, as the seat ruled on objectui#11696. The recent-item object kind no longer asks it, and calls objectPluralLabel itself. The recent-item pin's last case asserts that useNavTargetLabel still answers "Project" / "项目" for the same object.

Enumeration pin

git grep -n 'objectLabel(' -- packages/app-shell/src packages/plugin-detail/src, tests excluded, at head 50e8f98: 12 hits (20 at base 17acfbb), 0 of them in plugin-detail. apps/console/src has 0. Each remaining hit:

File Symbol Classification
AppContent.tsx handleCrudSuccess's label (save toasts form.updateSuccess / form.createSuccess) record-scoped: the toast for the one saved record
AppContent.tsx the child-task branch of handleRecordFormSuccess (the same toasts) record-scoped
AppContent.tsx the global record-form modal's title (form.editTitle / form.createTitle), 2 hits record-scoped: "Edit …" / "Create …"
useNavTargetLabel.ts case 'object' the nav-entry inheritance (spec step 3), unchanged by the seat's ruling on objectui#11696
ObjectDataPage.tsx NavigationOverlay title record-scoped: the record drawer title
ObjectView.tsx useObjectActions({ objectLabel }) record-scoped: the delete confirmation and toasts. The label is attributive to "record(s)": "Delete 3 Project records?", "Project deleted successfully"
ObjectView.tsx the ImportWizard objectLabel prop an object-kind action phrase, the "New …" class: the "Import {{object}}" title and the template file name. Kept singular, as PR objectui#11728's contract review classified it. It is a one-line change if the seat reads it as naming a list
ObjectView.tsx two NavigationOverlay titles record-scoped: the record drawer title
RecordDetailView.tsx recordDelete.confirmCopy({ label }) in the header's delete action record-scoped: names the one record
RecordFormPage.tsx const label record-scoped: it now feeds only the title and the save toast

Tests

Seven pins, each named after this issue. In every zh-CN fixture pluralLabel is a different word from label (项目 / 项目清单), so an assertion can tell which key was read. Each has a no-plural control.

  • ObjectView.listLinksPlural-11733.test.tsx: a real ObjectView in a real i18next instance (the 11696 harness). It reads the favorite the star button saves, and the way-back label each builder hands the record route (a list probe calls schema.onNavigate and the bridge's openRecord). The fixture's list view has no label, which is when the fallback applies.
  • RecordFormPage.listLinkPlural-11733.test.tsx: the link reads the plural; the title and toast read the singular. Cells: en create, en edit, zh-CN, control.
  • RecordDetailView.relatedListTitlePlural-11733.test.tsx: single- and multi-relationship titles, en and zh-CN, control.
  • useRecentItemLabel.objectPlural-11733.test.tsx: en, zh-CN, control, the machine-name floor, and the unchanged nav-entry inheritance.
  • AppContent.createLandingOriginPlural-11733.test.tsx: the AppContent.declaredVisibilityKeys harness with a real i18next instance. The modal's onSuccess is called with a saved id for a page-surface object, and the record route's probe shows the state it received. The save runs outside act: an awaited React 19 act there did not return before the test timeout.
  • record-related-list.titlePlural-11733.test.tsx and record-reference-rail.titlePlural-11733.test.tsx: plurals from the bundle only (these renderers hold the object's name, not its definition), en and zh-CN, with controls.

Reverse verification (on a46d4a9, the implementation commit)

Mutations went through objectstack's scripts/ablation-replace.mjs. Each anchor's declared hit count was met and each file's blob changed. A script-held trap restored every path, proven by each blob equal to HEAD and an empty git diff HEAD. The direction was written down before each run.

  • Leg A: every list-naming site back to the singular (11 anchors in 8 files). Predicted 19 red and 12 green. Observed Tests 19 failed | 12 passed (31). The failures read expected 'Project' to be 'Projects', expected '项目' to be '项目清单', and the form link 'Project' / '项目'. Every control stayed green.
  • Leg B: only deriveRelatedLists back to the raw label. Predicted 2 red and 1 green on the RecordDetailView pin. Observed Tests 2 failed | 1 passed (3): "Unable to find an element with the text: Opportunities · Primary Project" and the same for "商机列表 · Primary Project".

50e8f98 changes only the types of the AppContent pin's modal probe.

Gates

Command Head Exit The gate's own verdict
pnpm exec vitest run over the 7 new pins 50e8f98 0 Test Files 7 passed (7) · Tests 31 passed (31)
pnpm exec vitest run packages/plugin-detail/ a46d4a9 0 Test Files 243 passed | 1 skipped (244) · Tests 2401 passed | 8 skipped (2409)
pnpm exec vitest run over 242 app-shell test files (declared narrowing, below) a46d4a9 0 Test Files 242 passed (242) · Tests 2141 passed (2141)
pnpm exec vitest run over 24 apps/console test files that name AppContent, ObjectView, RecordDetailView, RecordFormPage, useRecentItemLabel, ConsoleLayout or the related-list blocks a46d4a9 0 Test Files 24 passed (24) · Tests 603 passed (603)
pnpm --filter @object-ui/app-shell type-check (dependency closure built first: turbo, 28 tasks) 50e8f98 0 script echoed (tsc --noEmit && tsc -p tsconfig.test.json); the five app-shell pins are in its file list
pnpm --filter @object-ui/plugin-detail type-check a46d4a9 (no plugin-detail file changed since) 0 script echoed; both plugin-detail pins are in its file list
pnpm exec eslint on the 15 touched .ts / .tsx files 50e8f98 0 0 errors. No warning falls on a line this branch added except the existing react-hooks/exhaustive-deps warning on the synthParts deps line in RecordDetailView, which base 17acfbb carries too (it names other members)
pnpm check:control-bytes 50e8f98 0 check-control-bytes: OK
pnpm check:test-path-roots 50e8f98 0 check-test-path-roots: OK
pnpm check:changeset-claims 50e8f98 0 No pending changeset names a file this change touches.
pnpm check:pending-changeset-literals 50e8f98 0 No test source names a pending changeset.
pnpm check:vi-mock-specifiers / vi-mock-inherit / vi-mock-override-shape 50e8f98 0 / 0 / 0 each OK
pnpm check:new-line-citations 50e8f98 0 0 new citation(s)
node scripts/check-changeset-presence.mjs 50e8f98 0 15 source file(s) of 2 released package(s) changed, and this change declares 1 changeset(s)
node scripts/check-changeset-no-major.mjs 50e8f98 0 No changeset declares a major bump.

Declared narrowing. The app-shell run covers the 242 of its 1043 tracked test files that name a touched module or one of its consumers. The selection is git grep -l over app-shell's test files for RecordDetailView, RecordFormPage, ObjectView, AppContent, useRecentItemLabel, deriveRelatedLists, useNavTargetLabel, RecentApps, HomeRail, CommandPalette, UnifiedSidebar, StudioHomePage, useFavorites, FavoritesProvider and the related-list / reference-rail blocks. The other files are left to CI's full pnpm test. Blind spot: a test that renders these modules through a component whose name matches none of those words. The narrowed runs are on a46d4a9; 50e8f98 changes one pin's types only, and that pin re-ran on 50e8f98.

Acceptance notes (observations, not filed; no carrier)

  • A favorite saved before this change keeps the label it was stored with. Favorites store their text, and object favorites have no refresh path (refreshLabel is called for record favorites only). Starring again saves the plural. Read from source, not measured.
  • record:related_list and record:reference_rail never read the related object's declared label or pluralLabel, because they hold its name only. Their fallback was bundle-then-humanized before and stays that way. With no bundle entry, an object with a declared plural is still headed by its humanized name there.
  • The relationship-field half of the multi-relationship title ("· Partner Project") is the field's authored label, untranslated, as before.
  • ImportWizard keeps the singular (see the enumeration table).

Session: https://claude.ai/code/session_01CGZy1BGCjdN5cXqL9cnvB8


Generated by Claude Code

claude added 2 commits October 6, 2026 20:07
…cords read the plural label (objectui#11733)

objectui#11696 gave useObjectLabel() an objectPluralLabel resolver and used
it for the object list page title and its breadcrumb. The other places that
name a list of an object's records still read the singular. Each now reads
objectPluralLabel; record-scoped text keeps objectLabel.

- RecordDetailView: related-list section titles. deriveRelatedLists takes a
  listLabel option for the multi-relationship title it composes, and the
  detail page passes the same resolver.
- record:related_list and record:reference_rail (plugin-detail): the
  untitled fallback heading, the rail cards and the rail's empty line.
- RecordFormPage: the shared label is split; the breadcrumb link to the list
  reads the plural, the title and the save toast keep the singular.
- ObjectView: the favorite entry and the record page's way back when the
  open view has no label; AppContent: the way back handed to the page a
  create lands on.
- useRecentItemLabel: a recent object entry reads the plural at the call
  site; useNavTargetLabel's nav-entry inheritance is unchanged.

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

github-actions Bot commented Oct 6, 2026

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 331 chunks) 3327.7 KB 3330.4 KB
Main entry chunk (gzip) 154.8 KB 350 KB
Entry file index-Xt67nx5w.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 (consoleActionDispatch.js) 0.20KB 0.19KB
app-shell (index.js) 17.82KB 6.58KB
app-shell (runtime-config.js) 22.59KB 7.89KB
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) 40.22KB 10.61KB
auth (AuthShell.js) 3.49KB 1.40KB
auth (ForgotPasswordForm.js) 12.21KB 3.45KB
auth (LoginForm.js) 18.15KB 5.40KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.72KB 2.24KB
auth (SocialSignInButtons.js) 9.70KB 3.93KB
auth (UserMenu.js) 3.39KB 1.21KB
auth (auth-gate-events.js) 1.29KB 0.66KB
auth (authStyles.js) 5.04KB 1.72KB
auth (createAuthClient.js) 40.70KB 10.94KB
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) 6.66KB 2.78KB
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.11KB 7.97KB
collaboration (LiveCursors.js) 3.17KB 1.27KB
collaboration (PresenceAvatars.js) 6.28KB 2.60KB
collaboration (PresenceProvider.js) 2.79KB 1.13KB
collaboration (index.js) 1.68KB 0.73KB
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) 579.15KB 139.25KB
core (index.js) 10.00KB 3.96KB
create-plugin (index.js) 27.94KB 9.51KB
data-objectstack (index.js) 235.41KB 65.46KB
fields (index.js) 263.41KB 66.72KB
i18n (LocalizationContext.js) 1.76KB 0.96KB
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) 37.51KB 10.04KB
i18n (useSafeTranslation.js) 7.14KB 2.92KB
layout (index.js) 41.50KB 11.82KB
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) 13.86KB 5.00KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 6.52KB 2.26KB
permissions (discardProofCache.js) 1.04KB 0.55KB
permissions (evaluator.js) 8.33KB 3.07KB
permissions (index.js) 0.93KB 0.41KB
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.04KB 3.92KB
plugin-calendar (index.js) 53.39KB 15.52KB
plugin-charts (index.js) 84.26KB 23.05KB
plugin-chatbot (index.js) 199.63KB 47.46KB
plugin-dashboard (index.js) 144.26KB 38.97KB
plugin-designer (index.js) 231.46KB 48.87KB
plugin-detail (index.js) 247.73KB 65.20KB
plugin-editor (index.js) 2.23KB 1.05KB
plugin-form (index.js) 177.09KB 45.89KB
plugin-gantt (index.js) 179.16KB 45.06KB
plugin-grid (index.js) 238.51KB 65.53KB
plugin-kanban (index.js) 52.17KB 16.37KB
plugin-list (index.js) 116.85KB 29.12KB
plugin-map (index.js) 25.60KB 8.62KB
plugin-markdown (index.js) 13.88KB 4.80KB
plugin-report (index.js) 44.12KB 12.29KB
plugin-timeline (index.js) 38.90KB 11.74KB
plugin-tree (index.js) 15.07KB 5.33KB
plugin-view (index.js) 90.64KB 22.85KB
providers (DataSourceProvider.js) 0.75KB 0.39KB
providers (MetadataProvider.js) 1.37KB 0.59KB
providers (ThemeProvider.js) 1.90KB 0.85KB
providers (UploadProvider.js) 11.81KB 3.58KB
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) 120.63KB 39.56KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 4.50KB 2.06KB
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.08KB 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.80KB
sdui-parser (provenance.js) 3.84KB 1.90KB
sdui-parser (types.js) 0.28KB 0.23KB
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 (record-components.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.25KB
types (system-fields.js) 3.33KB 1.54KB
types (theme.js) 6.28KB 2.87KB
types (ui-action.js) 8.11KB 3.32KB
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
objectstack-fleet Bot marked this pull request as ready for review October 6, 2026 21:06
@objectstack-fleet
objectstack-fleet Bot enabled auto-merge October 6, 2026 21:06
@objectstack-fleet
objectstack-fleet Bot added this pull request to the merge queue Oct 6, 2026
Merged via the queue into main with commit 885a96f Oct 6, 2026
45 checks passed
@objectstack-fleet
objectstack-fleet Bot deleted the claude/issue-11733-list-links-plural branch October 6, 2026 21:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

2 participants