Skip to content

refactor(app-shell): bind DeclaredActionsBar's row through usePredicateRecordContext (#4080) - #4268

Merged
yinlianghui merged 1 commit into
mainfrom
claude/issue-4080-declared-bar-predicate-hook
Aug 11, 2026
Merged

refactor(app-shell): bind DeclaredActionsBar's row through usePredicateRecordContext (#4080)#4268
yinlianghui merged 1 commit into
mainfrom
claude/issue-4080-declared-bar-predicate-hook

Conversation

@yinlianghui

Copy link
Copy Markdown
Collaborator

Fixes#4080

DeclaredActionsBar held an inline copy of the three-way row binding — { ...row, record: row, data: row } — added by #4077 to fix its root-only predicate scope. #4079 fixed the same fault on the four generic action renderers and, rather than repeating the expression a fifth time, gave the rule one name: usePredicateRecordContext, exported from @object-ui/react beside useCondition. The bar kept its copy.

This is that migration: one import, one substitution, the inline useMemo deleted. The long rationale in the bar's comment moves to a pointer at the definition, keeping only what is specific to this bar (every declared action on sys_approval_request gates on record.viewer.*, so a root-only bag made the whole server-declared decision set invisible here).

The one semantic subtlety — the helper's semantics are kept

The two copies differ in exactly one place, which is why this is a migration rather than a rename. With no row, usePredicateRecordContext binds NOTHING; the inline copy bound { record: {}, data: {} }. useCondition evaluates on the local context merged OVER the ambient predicate scope, so the inline shape blanks out a record a host had put in the scope itself — a legitimate pattern, and how action-group-dropdown-visible.test.tsx drives the group's dropdown leaves.

Per the card, the helper's semantics are the ones kept. That corner is unreachable in the bar today (it is always mounted over a record), so no user-visible behaviour changes; the point is that the bar no longer holds a second answer to the question.

Premise check

Verified on the branch tip before implementing, all three still true:

  • inline useMemo live at DeclaredActionsBar.tsx:148;
  • usePredicateRecordContext exported at packages/react/src/hooks/useExpression.ts:142;
  • the bar already imports useCondition from @object-ui/react, so no new dependency edge.

Tests

Two pins on the bar, deliberately different in kind, plus one at the helper level.

  • Equivalence (row present) — all three spellings (record.status, bare status, data.status) reach the same verdict, both halves per spelling with the ungated companion asserting the bar itself rendered. Green before and after; it is not a mutation detector for this change and the comment says so.
  • Convergence (no row) — the bar mounted with no row inside a PredicateScopeProvider that supplies record: the host's row must still reach the predicate. This is the one place the copies part.
  • Helper level (useExpression.test.ts) — the return shape itself: no row yields an empty bag, and record / data are absent rather than present-and-undefined, so the ambient record survives the merge. Not a duplicate of existing coverage: the no-row semantics is pinned behaviourally through the renderers in action-record-predicate-root.test.tsx and incidentally by the dropdown suite, but nothing pinned the contract one level below a rendered verdict, which is what the bar now depends on.
npx vitest run packages/app-shell/src/views/ packages/components/src/renderers/action/
Test Files 217 passed (217)
Tests 2283 passed | 1 skipped (2284)
pnpm --filter @object-ui/app-shell --filter @object-ui/react type-check → both Done
npx eslint (the 3 changed files) → 0 errors
node scripts/check-control-bytes.mjs → OK (3982 files)

Reverse verification

Direction predicted before running, and it matched. The fix was taken out with git checkout origin/main -- DeclaredActionsBar.tsx (never git stash — shared stack), then restored from HEAD.

× with NO row of its own, the bar does not shadow a host-supplied ambient `record`
Test Files 1 failed | 1 passed (2)
Tests 1 failed | 59 passed (60)

The convergence pin went red, alone. The equivalence pin stayed green in both directions — honestly, that is the expected result and not a weak test: the two copies agree on every row that exists, so nothing about a row-present predicate can distinguish them. The helper-level pins stayed green both ways too; they do not touch the bar.

Changeset

The card said "no changeset". scripts/check-changeset-presence.mjs arbitrates and disagrees — @object-ui/app-shell is a released package and this is a change under its src/ — so the gate is followed: @object-ui/app-shell: patch. The empty-frontmatter form was considered and rejected; it asserts "no published behaviour changes", and the no-row binding of an exported component did change, even where no host reaches it. check-changeset-no-major is green, and no skip-changeset label is requested (#3724).


Generated by Claude Code

…teRecordContext (#4080)
objectui#4077 fixed the bar's root-only predicate binding with an inline
`{ ...row, record: row, data: row }`. objectui#4079 fixed the same fault on
the four generic action renderers and, rather than repeating the expression,
gave the rule one name — `usePredicateRecordContext`, exported from
`@object-ui/react` beside `useCondition`. The bar kept its copy.
Two implementations of one binding rule is the shape objectui#3367 / #3842
rule against, and this family has already paid for it once at the
`toPredicateInput` level (objectui#3314 — two normalizations drifted and the
same `visible:` predicate reached different verdicts depending on which path
surfaced the action). Nothing had drifted here; the migration is a
substitution, not a fix.
The helper's semantics are KEPT, not the inline ones. On no row it binds
NOTHING, where the inline copy bound `{ record: {}, data: {} }` — and since
`useCondition` merges this context OVER the ambient predicate scope, the
inline shape blanks out a `record` the host put in the scope itself. No host
mounts this bar without a row, so nothing user-visible changes; the point is
that the bar no longer holds a second answer to the question.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017Qqyix2QcnpUC9XeYVDzx3
@vercel

vercelBot commented Aug 11, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
objectuiIgnoredIgnoredAug 11, 2026 9:56am

Request Review

@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Main entry (gzip)28.5 KB350 KB
Entry fileindex-BkVwYI_j.js
StatusPASS

📦 Bundle Size Report

PackageSizeGzipped
app-shell (index.js)8.88KB3.25KB
app-shell (runtime-config.js)7.42KB2.32KB
app-shell (types.js)0.01KB0.04KB
app-shell (urlParams.js)7.57KB2.97KB
auth (AuthContext.js)0.31KB0.24KB
auth (AuthGuard.js)1.17KB0.53KB
auth (AuthProvider.js)22.10KB4.37KB
auth (AuthShell.js)3.49KB1.40KB
auth (ForgotPasswordForm.js)12.21KB3.45KB
auth (LoginForm.js)18.13KB5.39KB
auth (PreviewBanner.js)0.90KB0.50KB
auth (RegisterForm.js)6.64KB2.21KB
auth (SocialSignInButtons.js)9.60KB3.89KB
auth (UserMenu.js)3.40KB1.22KB
auth (auth-gate-events.js)1.29KB0.66KB
auth (authStyles.js)5.04KB1.72KB
auth (createAuthClient.js)35.76KB9.11KB
auth (createAuthenticatedFetch.js)4.37KB1.69KB
auth (index.js)2.35KB1.07KB
auth (org-roles.js)6.66KB2.78KB
auth (phone-identifier.js)1.11KB0.66KB
auth (types.js)0.59KB0.35KB
auth (useAuth.js)4.91KB0.87KB
auth (useIsWorkspaceAdmin.js)1.61KB0.85KB
collaboration (CommentThread.js)26.07KB7.56KB
collaboration (LiveCursors.js)3.17KB1.27KB
collaboration (PresenceAvatars.js)6.49KB2.64KB
collaboration (PresenceProvider.js)2.79KB1.13KB
collaboration (index.js)1.65KB0.73KB
collaboration (useCollaborationTranslation.js)6.05KB2.52KB
collaboration (useCommentSearch.js)1.98KB0.88KB
collaboration (useConflictResolution.js)7.75KB1.86KB
collaboration (useMentionNotifications.js)1.81KB0.68KB
collaboration (usePresence.js)6.33KB1.84KB
collaboration (useRealtimeSubscription.js)7.91KB2.01KB
components (index.js)488.62KB108.26KB
core (index.js)3.04KB1.15KB
create-plugin (index.js)10.08KB3.26KB
data-objectstack (index.js)150.04KB39.79KB
fields (index.js)228.45KB56.62KB
i18n (LocalizationContext.js)1.76KB0.96KB
i18n (currency.js)1.22KB0.64KB
i18n (i18n.js)4.32KB1.77KB
i18n (index.js)2.65KB1.06KB
i18n (pickLocalized.js)1.70KB0.83KB
i18n (provider.js)16.38KB5.47KB
i18n (useObjectLabel.js)27.59KB6.63KB
i18n (useSafeTranslation.js)4.52KB1.96KB
layout (index.js)38.98KB10.85KB
mobile (MobileProvider.js)0.92KB0.49KB
mobile (ResponsiveContainer.js)0.94KB0.38KB
mobile (breakpoints.js)1.51KB0.70KB
mobile (createOfflineDataSource.js)5.61KB1.74KB
mobile (index.js)1.50KB0.62KB
mobile (offlineQueue.js)3.91KB1.35KB
mobile (pwa.js)0.97KB0.49KB
mobile (serviceWorker.js)1.48KB0.62KB
mobile (serviceWorkerSource.js)3.41KB1.48KB
mobile (useBreakpoint.js)1.54KB0.65KB
mobile (useGesture.js)6.96KB1.98KB
mobile (useOfflineSync.js)1.99KB0.72KB
mobile (usePullToRefresh.js)2.53KB0.85KB
mobile (useResponsive.js)0.71KB0.42KB
mobile (useResponsiveConfig.js)1.36KB0.63KB
mobile (useSpecGesture.js)4.32KB1.64KB
mobile (useTouchTarget.js)1.01KB0.54KB
permissions (MePermissionsProvider.js)8.75KB3.06KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)3.67KB1.12KB
permissions (evaluator.js)4.41KB1.44KB
permissions (index.js)0.91KB0.41KB
permissions (store.js)0.91KB0.42KB
permissions (useFieldPermissions.js)1.28KB0.52KB
permissions (usePermissions.js)1.55KB0.71KB
plugin-ai (index.js)15.71KB3.79KB
plugin-calendar (index.js)45.23KB12.45KB
plugin-charts (index.js)61.73KB17.54KB
plugin-chatbot (index.js)180.33KB42.79KB
plugin-dashboard (index.js)118.67KB30.75KB
plugin-designer (index.js)210.91KB42.67KB
plugin-detail (index.js)238.88KB59.71KB
plugin-editor (index.js)2.46KB1.10KB
plugin-form (index.js)114.58KB27.68KB
plugin-gantt (index.js)164.14KB39.98KB
plugin-grid (index.js)187.97KB49.90KB
plugin-kanban (index.js)48.60KB13.41KB
plugin-list (index.js)110.31KB26.76KB
plugin-map (index.js)17.00KB5.32KB
plugin-markdown (index.js)13.72KB4.69KB
plugin-report (index.js)40.58KB10.58KB
plugin-timeline (index.js)26.21KB7.52KB
plugin-tree (index.js)8.50KB2.88KB
plugin-view (index.js)84.03KB20.55KB
providers (DataSourceProvider.js)0.75KB0.39KB
providers (MetadataProvider.js)1.37KB0.59KB
providers (ThemeProvider.js)1.90KB0.85KB
providers (UploadProvider.js)11.71KB3.53KB
providers (index.js)0.44KB0.22KB
providers (types.js)0.01KB0.04KB
react-runtime (index.js)5.67KB2.37KB
react (LazyPluginLoader.js)3.77KB1.33KB
react (SchemaRenderer.js)23.71KB7.96KB
react (data-invalidation.js)5.05KB2.08KB
react (index.js)1.23KB0.66KB
react (spec-input.js)0.20KB0.18KB
sdui-parser (codegen.js)4.09KB1.74KB
sdui-parser (index.js)4.47KB2.03KB
sdui-parser (parse.js)10.04KB2.82KB
sdui-parser (types.js)0.29KB0.24KB
sdui-parser (validate.js)4.69KB1.48KB
types (ai.js)0.20KB0.17KB
types (api-types.js)0.20KB0.18KB
types (app.js)2.87KB0.99KB
types (base.js)0.20KB0.18KB
types (blocks.js)0.20KB0.18KB
types (complex.js)0.20KB0.18KB
types (crud.js)0.20KB0.18KB
types (dashboard-filter-alias.js)6.23KB2.74KB
types (data-display.js)0.20KB0.18KB
types (data-protocol.js)0.20KB0.19KB
types (data.js)0.20KB0.18KB
types (designer.js)1.87KB0.85KB
types (disclosure.js)0.20KB0.18KB
types (error-code.js)1.54KB0.88KB
types (feedback.js)0.20KB0.18KB
types (field-types.js)0.20KB0.18KB
types (form.js)0.20KB0.18KB
types (http-retry.js)4.32KB2.02KB
types (index.js)3.05KB1.52KB
types (layout.js)0.20KB0.18KB
types (managed-by.js)0.19KB0.18KB
types (mobile.js)2.59KB1.31KB
types (navigation.js)0.20KB0.18KB
types (objectql.js)0.20KB0.18KB
types (overlay.js)0.20KB0.18KB
types (permissions.js)0.20KB0.18KB
types (plugin-scope.js)0.20KB0.18KB
types (record-components.js)0.20KB0.19KB
types (record-semantics.js)1.28KB0.67KB
types (registry.js)0.20KB0.18KB
types (reports.js)0.20KB0.18KB
types (spec-report.js)5.05KB1.93KB
types (system-fields.js)3.33KB1.54KB
types (theme.js)0.20KB0.18KB
types (ui-action.js)3.40KB1.71KB
types (views.js)0.20KB0.18KB
types (widget.js)0.20KB0.18KB

Size Limits

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

@yinlianghui
yinlianghui marked this pull request as ready for review August 11, 2026 10:06
@yinlianghui
yinlianghui added this pull request to the merge queueAug 11, 2026
Merged via the queue into main with commit 4cb0562Aug 11, 2026
21 checks passed
@yinlianghui
yinlianghui deleted the claude/issue-4080-declared-bar-predicate-hook branch August 11, 2026 10:06
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[finding] DeclaredActionsBar keeps an inline copy of the three-way row binding now named usePredicateRecordContext

2 participants

@yinlianghui@claude