Skip to content

fix(app-shell,i18n): the keyboard-shortcuts dialog lists only shortcuts a mounted handler advertises (objectui#11674) - #11708

Merged
objectstack-fleet[bot] merged 5 commits into
mainfrom
claude/issue-11674-shortcuts-dialog-wired-only
Oct 6, 2026
Merged

objectstack-fleet[bot] merged 5 commits into
mainfrom
claude/issue-11674-shortcuts-dialog-wired-only

Conversation

@objectstack-fleet

Copy link
Copy Markdown
Contributor

Fixes #11674

Clause-②: no (narrowing)

The claim wrote Clause-②: no, with the rule that it becomes no (narrowing) if published console.shortcuts.* locale keys retire. Seven do, so the line reads no (narrowing). No accept set widens, and @object-ui/app-shell exports nothing new.

What was wrong (measured on origin/main at c3623eb)

The dialog was a static list, kept apart from every key handler. Every row, by the handler it had:

Old row Handler on main Verdict
⌘K Open command palette CommandPaletteProvider keydown (k with ⌘ or Ctrl) wired
? Show keyboard shortcuts the dialog's own keydown wired
Esc Close dialog / panel Radix dismiss, on every Dialog and Sheet wired
B Toggle sidebar the SidebarProvider listener (synced Shadcn primitive) answers b with ⌘ or Ctrl only. A bare B does nothing wrong chord
⌘/ Focus search none dead
N Create new record none. useCrudShortcuts / useKeyboardShortcuts have no caller outside their module dead
R Refresh data none. The only r listener is the approvals inbox's reject key, on that page only dead
⌘E Edit selected record none dead
⌘⇧O New chat, ⌘⇧S Toggle conversations list AiChatPage only (matchAiChatShortcut). The dialog mounts in AppContent (/apps/...) and /ai is not under it, so neither handler is mounted where the rows were shown not wired where listed
⌘D Toggle dark mode none dead

The card named five of these. The order asked for every row to be measured, which added R and the AI pair.

What changed

  • packages/app-shell/src/chrome/advertisedShortcuts.ts (new). A small module store, the same shape as assistantBus. The code that owns a handler calls useAdvertiseShortcut(descriptor, enabled?) beside it, so the shortcut is advertised while the handler is mounted. useAdvertisedShortcuts() reads the current set. A descriptor is { id, group, chord, label }. The keycaps come from the chord (shortcutKeycaps), and label is a literal t('…') call so the i18n gates read the key (see the probe below).
  • KeyboardShortcutsDialog has no list of its own any more. It renders the advertised shortcuts, grouped (general, navigation, aiChat) and sorted by their text, and each row carries data-shortcut-id. It advertises its own ?, and Esc (Radix's dismiss) beside the Dialog that Esc closes.
  • CommandPaletteProvider advertises ⌘K beside its keydown handler.
  • ConsoleLayout's inner component, which sits inside SidebarProvider, advertises ⌘B. The listener belongs to the primitive. packages/components/src/ui/sidebar.tsx was read and not edited.
  • AiChatPage advertises ⌘⇧O and ⌘⇧S beside the listener that calls matchAiChatShortcut. So they are listed only where that page is mounted, and today the dialog is not mounted there.
  • @object-ui/i18n. Seven keys were read only by the dead rows, and they are removed from all ten packs: console.shortcuts.focusSearch, createRecord, refreshData, editRecord, toggleDarkMode, groups.dataViews, groups.preferences. Two i18n test comments cited toggleDarkMode as an example of ё, and they are reworded. One of them also carried a stale ё count, which is dropped, not re-counted.
  • The app-shell README gains a "Keyboard-shortcuts dialog" section. The changeset is .changeset/11674-shortcuts-dialog-wired-only.md, minor for both packages, with the key removal spelled out as BREAKING at minor under the repo's version policy.

Inside an app, the dialog now lists ⌘K, ?, Esc and ⌘B.

Landing point: the order expected the static list in KeyboardShortcutsDialog.tsx. That file is where the list was. The fix also touches three files that register handlers, and only to advertise them, as the claim's file surface allows.

The pin

packages/app-shell/src/chrome/KeyboardShortcutsDialog.wiredOnly-11674.test.tsx:

  • Every listed row fires. The test mounts the dialog where AppContent mounts it: inside the real ConsoleLayout, with the real AppShell, SidebarProvider and CommandPaletteProvider. It opens the dialog with ?shortcuts=1. For each row it fires the chord that the row's own advertisement declares, once with ⌘ and once with Ctrl, each on a fresh mount, and checks the real handler's effect: the palette opens, the dialog opens, the dialog closes, the sidebar collapses. The rows must equal the advertisements, keycaps included, and must equal the probe table's keys. So a listed row that nothing can fire fails, and the loop cannot pass by running nothing.
  • The list is derived. A row is listed while its advertiser is mounted and leaves when the advertiser unmounts.
  • The AI page's chords are the ones its real matcher answers. matchAiChatShortcut returns the right action for both chords.
  • Control. A bare b, the old row, does not toggle the sidebar.

Ablations (one-off, run from committed HEAD 05c1f48, restore proved by blob hash)

  • The defect's own shape. The sidebar's advertisement was set back to a bare b (chord: { key: 'b' }) with ablation-replace (anchor 1 → 0, blob de7e99c048be → 93c37705f9e4). The pin went red, Tests 1 failed | 4 passed (5), at the sidebar probe: data-sidebar-open stayed "true". Restored: blob == HEAD de7e99c048be, git diff HEAD empty.
  • The old static dialog. KeyboardShortcutsDialog.tsx was swapped for its c3623eb bytes (createRecord marker 1, useAdvertiseShortcut 0, blob ad882b0dc950). The test went red, Tests 2 failed | 3 passed (5): the pin and the derivation case. Restored: blob == HEAD f766b2845931.
  • The i18n gate reads the descriptor labels. t('console.shortcuts.toggleSidebar') in the sidebar descriptor was renamed to a key no pack has. check:i18n-keys exited 1 with [missing-key] console.shortcuts.toggleSidebarProbe at ConsoleLayout.tsx. Restored: blob == HEAD.

Gates (objectui's own; derived by hand from package.json and .github/workflows/)

All at HEAD 05c1f48. Each exit code was captured before any pipe.

Gate Exit Reading
pnpm exec vitest run --maxWorkers=2 packages/i18n/ packages/app-shell/src/chrome/ packages/app-shell/src/layout/ packages/app-shell/src/context/ packages/app-shell/src/console/__tests__/ packages/app-shell/src/console/ai/__tests__/ (under the verify lock) 0 Test Files 193 passed (193), Tests 2096 passed, 13 skipped
pnpm --workspace-concurrency=2 --filter "@object-ui/app-shell^..." build 0 dependency closure built
pnpm --filter @object-ui/app-shell type-check (both tsc legs) 0 tsconfig.test.json --listFilesOnly lists the new pin
pnpm --filter @object-ui/i18n type-check 0
eslint over the 6 changed app-shell files, --format json 0 0 errors. 38 warnings, against 36 on the 4 modified files at c3623eb (read through --stdin). The +2 are react-refresh/only-export-components on the two exported AI-page descriptors
eslint over the 12 changed i18n files, --format json 0 0 errors, 0 warnings
check:i18n-keys 0 every call-site key resolves (3273 keys)
check:i18n-drift 0 0 en values changed; 7 keys removed
check:i18n-dead-keys (report-only) 0 0 console.shortcuts.* candidates; pack keys 3273
check:i18n-designer-parity, check:control-bytes, check:new-line-citations (0 new), check:vi-mock-specifiers, check:vi-mock-inherit, check:vi-mock-override-shape, check:unreferenced-sources, check:test-path-roots, check:changeset-claims, check:pending-changeset-literals 0 each
node scripts/check-changeset-no-major.mjs, check-changeset-presence.mjs (18 source files, 2 packages, 1 changeset), check-changeset-fixed.mjs 0 each
check:readme-exports NOT MEASURED PREREQUISITE: it needs every package's dist. No export moved, and the new README section has no fenced import
check:eager-locale-catalogues NOT MEASURED PREREQUISITE: it needs apps/console/dist/eager-closure.json

Why the lint narrowing holds:

  • The population is each package's lint script, eslint ..
  • eslint.config.js sets no parserOptions.project or projectService, so no lint is type-aware.
  • No rule under eslint-rules/ reads another file.

So this diff cannot change the verdict on a file it did not touch. The full pnpm test, repo-wide pnpm lint and the apps/console suites are left to CI.

Declared narrowing: the verify lock was held for about 26 minutes by a sibling's full-suite run. During that time the single pin file, and the ablations, ran without the lock (--maxWorkers=1). The final runs in the table above went through the lock.

Acceptance notes (observations, not filed)

  • ⌘⇧I, the chat-dock toggle in ConsoleLayout, is wired and not advertised. A row needs a new console.shortcuts.* key in ten packs. That is a widening, outside this claim's Clause-②: no. With this mechanism it costs one useAdvertiseShortcut call and the key. Carrier: none.
  • Page-scoped shortcuts are wired and not advertised: QuickFind ⌘⇧M, the resource editor's ⌘S / ⌘\ / Esc, the approvals inbox's list keys, the performance panel's Ctrl+Shift+P, and useDebugMode's Ctrl+Shift+D. Once advertised, each would be listed only on its own page. This PR reads "lists exactly the shortcuts that are wired" as "lists no shortcut that is not wired", plus the chrome layer that owned the old list.
  • useKeyboardShortcuts, useCrudShortcuts and getShortcutDescriptions in @object-ui/react are published and have zero callers. This is dead code, and wiring it is not this card's question.
  • The keycaps draw ⌘ on every platform, as before. Every advertised handler also accepts Ctrl.
  • The dialog is not mounted on /ai, and the /ai header hides the Help-menu entry. So the AI pair is listed nowhere today. That is correct under the rule, and it is unchanged.
  • Not measured, inferred from source: the SidebarProvider listener does not skip editable targets, so ⌘B inside a rich-text field may toggle the sidebar.

Generated by Claude Code

claude added 5 commits October 6, 2026 07:52
…ts a mounted handler advertises (objectui#11674)

The dialog was a static list; N, Cmd/Ctrl+E, Cmd/Ctrl+/, Cmd/Ctrl+D and a
bare B had no handler. Each handler now advertises its shortcut beside
itself (advertisedShortcuts.ts) and the dialog lists what is advertised.
The sidebar row reads its real chord, Cmd/Ctrl+B. The seven
console.shortcuts keys only the dead rows read are retired from all ten
packs.

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

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

Claude-Session: https://claude.ai/code/session_01FngvPpdrnhHMdHHq6vwwju
Co-authored-by: Claude <noreply@anthropic.com>
…l; read the registry in the pin through the DOM (objectui#11674)

Claude-Session: https://claude.ai/code/session_01FngvPpdrnhHMdHHq6vwwju
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) 3322.8 KB 3330.4 KB
Main entry chunk (gzip) 153.1 KB 350 KB
Entry file index-BRLhbYfr.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.22KB 6.37KB
app-shell (runtime-config.js) 22.52KB 7.86KB
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) 574.72KB 137.94KB
core (index.js) 10.00KB 3.96KB
create-plugin (index.js) 27.94KB 9.51KB
data-objectstack (index.js) 232.57KB 64.51KB
fields (index.js) 262.75KB 66.62KB
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.24KB 2.27KB
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) 35.66KB 9.49KB
i18n (useSafeTranslation.js) 7.14KB 2.92KB
layout (index.js) 41.18KB 11.71KB
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.17KB 15.46KB
plugin-charts (index.js) 84.26KB 23.05KB
plugin-chatbot (index.js) 198.81KB 47.14KB
plugin-dashboard (index.js) 143.75KB 38.87KB
plugin-designer (index.js) 231.41KB 48.84KB
plugin-detail (index.js) 247.23KB 65.04KB
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.48KB 65.51KB
plugin-kanban (index.js) 52.17KB 16.37KB
plugin-list (index.js) 116.72KB 29.10KB
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.83KB 11.71KB
plugin-tree (index.js) 14.51KB 5.15KB
plugin-view (index.js) 90.23KB 22.73KB
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

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

Labels

documentation Improvements or additions to documentation package: app-shell package: i18n tests

Projects

None yet

Development

Successfully merging this pull request may close these issues.

console: the Keyboard Shortcuts dialog advertises N, ⌘/Ctrl+E, ⌘/Ctrl+/, ⌘/Ctrl+D and B, and none of them does anything

2 participants