Skip to content

fix(app-shell): Studio's nav save leaves out entries with no target, and its banner clears on the next landed save (objectui#11776) - #11835

Merged
objectstack-fleet[bot] merged 5 commits into
mainfrom
claude/issue-11776-nav-placeholder-save
Oct 7, 2026
Merged

objectstack-fleet[bot] merged 5 commits into
mainfrom
claude/issue-11776-nav-placeholder-save

Conversation

@objectstack-fleet

Copy link
Copy Markdown
Contributor

Fixes #11776
Clause-②: no

Studio's navigation editor no longer sends an unbound "Add nav item" entry, so autosave stops failing while one is on the canvas. The error banner from a failed nav save now clears when a later nav save lands. Each row's remove control can now be reached and used from the keyboard.

Left out of this PR: the Changes panel's no-op "Update" row (the card's fourth expectation). The seat cut it to objectui#11807, and nothing here touches the Changes panel.

What changed

  • What a nav save sends. navPayloadOf (in AppNavCanvas.tsx) returns the editor's navigation with every entry that names no target for its type left out, at every depth.
    • A group is always kept. An entry with no type is still left out, as before.
    • The target of each type is read from one table, NAV_TARGET_READS. The card's own navTarget reads the same table, so what a card shows as its target and what the save treats as a target cannot drift apart.
    • doNavSave calls it. The spec and the server are unchanged.
  • The placeholder stays on the canvas, in its place. While the buffer holds an entry the save left out, the buffer stays dirty.
    • Without this, the re-read that a landed save triggers would install the served draft over the placeholder, and it would vanish right after the autosave. This was measured by mutation M1 below.
    • Binding the entry is the edit that sends it.
  • The banner. The nav save's failure now lives in its own state, navError, shown in the same canvas banner.
    • It clears when a nav save lands, on a conflict "reload", and when a read-only answer puts the nav buffer back.
    • A failure the open leaf is showing (the pillar's error) is left alone. A pin covers this.
  • The remove control is always mounted and in the tab order. It is shown on card hover, on the card's keyboard focus, and on its own keyboard focus.
    • While hidden it has no width and gives back the row's gap, so the card lays out exactly as on BASE.

The PM's hypotheses, measured

  • H1, confirmed. "Add nav item" inserts { id, type: 'object' }, and the old filter in doNavSave dropped only entries with no type.
    • Chromium payloads are in the browser section below.
    • Nesting: the canvas adds entries only at the root, and the inspector binds only root entries. So an unbound nested entry cannot be produced through Studio's UI, and served drafts are spec-valid. The recursion is pinned at the function level (a placeholder inside a group, and inside an object's nested views).
  • H2, confirmed. The producer is InterfacesPillar's pillar-local error state, set by doNavSave's catch.
    • The only place the pillar ever cleared it was the start of the leaf-draft load effect.
    • The shared useDraftAutoSave holds no error state and is untouched, so no other pillar is involved.
  • H3, partly wrong. The control was already a span with role="button", tabIndex={0}, and an accessible name ("Remove nav item"). So no engine.* row is added.
    • It was not hidden with opacity. It was mounted only while a JS hover state was true (onMouseEnter/onMouseLeave), so for a keyboard user it was not in the DOM at all.
  • H4, confirmed, with one correction. The id backfill for a root entry with no id ran after the filter and used the filtered index, so leaving an entry out moved a generated id. A spec-valid separator may have no id, so this was reachable.
    • The backfill now uses the editor position, before anything is left out.
    • What is sent is the editor's array minus the untargeted entries, in order, with the same object references (pinned).

Real-browser reading (dev-only harness, not committed)

Chromium, 1440×900. The harness mounted InterfacesPillar the way the surface mounts it, over the real console metadata client. A Playwright route handler played the server: it parsed every app PUT with the spec's AppSchema and answered refusals in the /meta write door's issue shape. The harness was then removed (git status clean).

Step BASE 8273f4b This branch
Add nav item, leave it unbound, autosave PUT 400, navigation nav_home, nav_landing, nav_item_3 (type object, no objectName). Banner: "• navigation.2.objectName — Invalid input: expected string, received undefined" PUT 200, navigation nav_home, nav_landing. No banner. nav_item_3 still on the canvas, third. Leave guard holds
Remove the placeholder, autosave PUT 200, but the banner stays PUT 200, no banner
Add two entries, bind the second, then the first (n/a) PUT 200 …, nav_item_4, then PUT 200 …, nav_item_3, nav_item_4. Leave guard released
A failed nav save (503), then remove that row with Tab + Enter (n/a) Banner "Service unavailable", then PUT 200 and the banner clears
Remove control at rest / card hovered / card keyboard-focused / itself focused at rest: not in the DOM opacity 0, width 0 / 1, 24px / 1, 24px / 1, 24px with :focus-visible. Tab from the card lands on it
Card label widths at rest (px) 102, 85, 128 102, 85, 128
Done after everything is bound (n/a) closes editing

The label-width row matters. The first version of this branch always reserved the control's 24px, which cost every label 32px at rest ("Landing menu" truncated at 53 of 79px). Commit 194fa98 fixes that.

Pins

Reverse check and ablations

  • BASE source with the new pins (git checkout 8273f4b of the two source files, restored from HEAD, blob hashes equal, git diff HEAD empty): 38 failed, 5 passed.
    • The 5 that pass: the two spec-only pins, the fixture pin, and the two controls.
    • Direction as predicted. The first pillar pin received accepted: false with { id: 'nav_item_3', type: 'object' } in the payload.
  • M1 (via ablation-replace.mjs; anchor 1 → 0, blob moved, restored to HEAD): if (sent.unmoved() && !leftOut) → if (sent.unmoved()). The "stays on the canvas" pin fails: the rail shows only Home menu, Landing menu after the re-read.
  • M2: the landed-save setNavError(null) removed. The banner pin fails: "Service unavailable" is still shown.
    • The first M2 attempt was refused by the tool, because its replacement was a substring of its anchor. That attempt was a no-op and is not counted. The re-run landed.

Gates, on 2e408c7

  • pnpm --filter '@object-ui/app-shell^...' build: exit 0. It ran before the edits; the dependency closure is upstream of every touched file.
  • pnpm exec vitest run on 60 files: every StudioDesignSurface*, AppNavCanvas* and AppPreview* test, studio-locale.i18n, ResourceEditPage.navDeepLink-11153, and navSurface.test.ts. Result: Test Files 60 passed (60), Tests 420 passed (420).
  • pnpm --filter @object-ui/app-shell type-check: exit 0, and the script name was echoed. --listFilesOnly shows all six touched test files are in the tsconfig.test.json program.
  • Exit 0 for each:
    • check:control-bytes
    • check:new-line-citations (0 new)
    • check:changeset-claims
    • check:pending-changeset-literals
    • check:vi-mock-specifiers
    • check:vi-mock-inherit
    • check:vi-mock-override-shape
    • check:test-path-roots
    • check:metadata-write-doors
    • check-changeset-presence (1 changeset declared)
    • check-changeset-no-major
  • ESLint on the 8 touched files only. CI's pnpm lint (turbo eslint . per package) owns the full run. The narrowed run gave 0 errors, and its 16 warnings are exactly BASE's 16 for the two sources, by rule. The narrowing is proven by three facts:
    • the population is CI's own eslint . under the root eslint.config.js;
    • the count of 8 files comes from --format json;
    • the config enables no type-aware linting (no projectService, parserOptions.project or type-checked preset), so this diff cannot change a verdict in an untouched file.

Deviations and fence

  • navPayloadOf is a module export of AppNavCanvas.tsx, as the PM's route allowed. It does not reach the package entry: index.ts re-exports a named list, and exports has only .. The react-refresh/only-export-components disable follows the precedent of renderStudioGridList.
  • No @object-ui/types member, prop, or packages/i18n/** key is added. Every file is inside the claim's surface.

Acceptance notes (not carded; carrier: none)

  • "Done" with an unbound entry on the canvas keeps nav editing open, and nothing says why. This follows objectui#11189's rule that "Done" never closes over an unsent edit. The entry is selected when it is added, so its inspector shows "Choose an object; the menu item will open its record list." This is left for the seat to rule on.
  • A browser reload drops an unbound entry. It is never stored, because the spec refuses it and keeping it would need a draft-schema change. The leave guard warns before the reload.
  • The leaf's own draft save (doSave) never clears its own failure on a later landed save either. It is the same class of defect, read in source only, and outside this claim's surface.
  • The metadata-admin app editor (AppPreview, off-limits here) uses the same canvas "Add nav item". Whether its save sends the placeholder was not measured.
  • The remove control is a role="button" span inside the card's button element. Chromium focuses it and activates it (measured). Other browser engines were not measured.
  • After Enter removes the focused row, focus falls to the document body.

Dispatched by the domain:ui seat 1 PM; implemented in session https://claude.ai/code/session_01DrKzdPdyLLBW3qpZ4vtk7z.


Generated by Claude Code

claude added 5 commits October 7, 2026 21:45
…and its banner clears on the next landed save (objectui#11776)

"Add nav item" births { id, type: 'object' }, which the spec refuses until an
object is picked; the nav save sent it, so every autosave failed with
"navigation.N.objectName - Invalid input". The save now sends the editor's
navigation less every entry that names no target for its type, at every
depth (navPayloadOf, beside AppNavCanvas's own target reader), and keeps the
buffer dirty while it holds such an entry, so the entry stays on the canvas
in its place until it is bound.

The nav save's failure is held apart from the pillar's error and cleared when
a nav save lands. The row's remove control is in the tab order and shown on
keyboard focus.

Claude-Session: https://claude.ai/code/session_01DrKzdPdyLLBW3qpZ4vtk7z
Co-authored-by: Claude <noreply@anthropic.com>
…h a save sends (objectui#11776)

objectui#11189, #11204, #11232 and #11167 took "Add nav item" alone as their
edit. That entry names no target, which the spec refuses; the double took it
because it parses nothing. A save now leaves such an entry out, so the edit
these pins send is an Add bound to a fixture object in its inspector. The
two "sends nothing" pins that a bare Add would now pass vacuously measure a
sendable edit again. What each pin pins is unchanged.

Claude-Session: https://claude.ai/code/session_01DrKzdPdyLLBW3qpZ4vtk7z
Co-authored-by: Claude <noreply@anthropic.com>
… so it reads the banner alone (objectui#11776)

Claude-Session: https://claude.ai/code/session_01DrKzdPdyLLBW3qpZ4vtk7z
Co-authored-by: Claude <noreply@anthropic.com>
… card lays out as before (objectui#11776)

Always mounted at full width, the invisible control cost every card's label
32px at rest; measured in Chromium, "Landing menu" truncated. Hidden, it now
has no width and gives back the row's gap; the card's hover, the card's
keyboard focus and its own keyboard focus show it at full size.

Claude-Session: https://claude.ai/code/session_01DrKzdPdyLLBW3qpZ4vtk7z
Co-authored-by: Claude <noreply@anthropic.com>
…s module (objectui#11776)

It reads the card's own target table, so it lives beside it; it is a pure
function, not a component, and the package entry does not re-export it. The
inline disable follows the file-level precedent renderStudioGridList set, so
the touched files lint with BASE's warning set.

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

github-actions Bot commented Oct 7, 2026

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 336 chunks) 3521.3 KB 3551.8 KB
Main entry chunk (gzip) 156.9 KB 350 KB
Entry file index-CYrCeWVX.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.68KB 139.46KB
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) 266.88KB 67.46KB
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) 38.37KB 10.31KB
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.82KB 39.17KB
plugin-designer (index.js) 231.46KB 48.87KB
plugin-detail (index.js) 247.86KB 65.27KB
plugin-editor (index.js) 2.23KB 1.05KB
plugin-form (index.js) 176.62KB 45.75KB
plugin-gantt (index.js) 179.17KB 45.07KB
plugin-grid (index.js) 239.75KB 65.92KB
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) 39.10KB 11.81KB
plugin-tree (index.js) 15.07KB 5.33KB
plugin-view (index.js) 91.07KB 22.93KB
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 7, 2026 22:30
@objectstack-fleet
objectstack-fleet Bot enabled auto-merge October 7, 2026 22:30
@objectstack-fleet
objectstack-fleet Bot added this pull request to the merge queue Oct 7, 2026
Merged via the queue into main with commit 03fc85d Oct 7, 2026
45 checks passed
@objectstack-fleet
objectstack-fleet Bot deleted the claude/issue-11776-nav-placeholder-save branch October 7, 2026 22:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

2 participants