Skip to content

fix(components): bind the row three ways on the four action renderers (#4075) - #4079

Merged
yinlianghui merged 1 commit into
mainfrom
claude/issue-4075-action-predicate-binding
Aug 10, 2026
Merged

fix(components): bind the row three ways on the four action renderers (#4075)#4079
yinlianghui merged 1 commit into
mainfrom
claude/issue-4075-action-predicate-binding

Conversation

@yinlianghui

@yinlianghui yinlianghui commented Aug 10, 2026

Copy link
Copy Markdown
Collaborator

Fixes #4075

The defect, confirmed on current main

useCondition(pred, ctx) evaluates on new ExpressionEvaluator({ ...scope, ...ctx }), so a context bag that is the row spread flat resolves the shorthand spelling and nothing else. The four action renderers passed exactly that — or, on three of the leaves, no row at all.

renderer what it passed as predicate context, before
action:button the row spread flat (data prop)
action:icon nothing — the data prop was never read, and landed in the props spread onto the DOM button
action:menu item nothing (undefined)
action:group inline + dropdown leaves nothing

record. is not a mistaken spelling, it is the canonical one: ExpressionEvaluator's CEL path binds it (bag.record as the record namespace, ExpressionEvaluator.ts:276-291), evalRowPredicate binds it on the record header, list rows, the row kebab and conditional formatting, and the server enforces with it. Under a root-only bag record.viewer.can_act does not read as false — the legacy evaluator throws record is not defined, and a fail-closed visible turns that throw into "hidden".

The issue's premise holds on current main (re-verified post-#4070/#4077; the line numbers moved, the fault did not). Measured as the pre-fix baseline of the new suite: 30 red / 38 green, and the red cases land on different polarities per site, because each site has a different error policy — a detail the card could not predict and the suite states out loud:

  • fail-CLOSED visible (action:button, action:menu): the holding record.* case is red (the throw hides a gate that held). Its failing sibling is green for the wrong reason — hidden either way — so both polarities are asserted and labelled.
  • fail-SOFT legs (action:icon / action:group visible, every disabled / enabled leg): the failing case is red, because the throw returns the fail-soft true — shown, or greyed out for everybody.

Route taken: route 1 (bind in place), not route 2 (move onto evalRowPredicate)

The card left this open and asked for the reasoning. Route 2 was rejected after reading the pins, not on cost:

So this follows #4077's merged precedent — with the one-implementation preference (#3367, #3842) honoured where it actually applies: the three-way binding is written once, as usePredicateRecordContext in @object-ui/react beside useCondition, not copy-pasted into four files.

What changed

  • packages/react/src/hooks/useExpression.ts — new usePredicateRecordContext(record). Binds record.status / bare status / data.status, with record and data written after the spread so a row carrying a field named record cannot shadow the root. evalRowPredicate's rule and precedence, restated for this tier.
  • the four renderers — all bind through that helper. action:icon reads its data prop at all; ActionMenuItem, InlineActionButton and DropdownActionItem take an optional record prop their hosts now pass.
  • action-bar.tsx — forwards the row into the overflow menu it builds, not just to its inline members. Without it an action's predicate answered a different question purely because it spilled past maxVisible — and mobileMaxVisible defaults to 1, which made the verdict a function of the viewport.

Deliberately unchanged: the evaluation entry, and each site's error policy. A genuinely faulting predicate still fails closed on action:button / action:menu visible and still fails soft elsewhere — pinned in both directions so the binding fix cannot be read as having quietly changed the policy too. That fail-soft visible asymmetry is pre-existing and already recorded in #3871's table; it is not this PR's to decide.

One regression the existing suite caught, and the rule it produced

The first cut bound an empty record when no row was present. That blanked out a record supplied through the ambient predicate scope — a legitimate host pattern, and how action-group-dropdown-visible.test.tsx drives these leaves. Two of its cases went red.

The rule now: no row → bind nothing; only a row that is actually present may shadow the scope. "This surface has no row of its own" and "this surface's row is empty" are different statements. Both directions are pinned in the new suite (ambient record still resolves with no data prop; an explicit data prop still wins over an ambient one).

Verification

  • new suite action-record-predicate-root.test.tsx — 4 renderers x 3 roots x 2 polarities + the nested record.viewer.can_act shape + per-site fault cases + the ambient-scope pair. Before the fix: 30 failed / 38 passed. After: 70 passed. Every "not rendered" assertion carries an ungated companion, so a green can never mean the host itself vanished.
  • packages/components + packages/react + packages/app-shell + packages/plugin-grid519 files, 4979 passed, 1 skipped, 0 failed.
  • type-check on both touched packages: Done. eslint on the touched surface: 0 errors. check:control-bytes, changeset:check: OK.
  • Merged origin/main (picking up objectui: 登录页在无会话时仍拉 /meta/*,登录前刷 30 条 401 报错,且日志打成 [object Object] 无法定位 #4042's app-shell / HTTP-logging work — disjoint packages) and re-ran the action + react suites: 731 passed.

Changeset: .changeset/action-record-predicate-root-4075.md (patch on @object-ui/components and @object-ui/react).

Out of scope, noted not fixed

DeclaredActionsBar (app-shell) still carries its own inline copy of the three-way binding from #4077. It is correct and identical today, and migrating it onto usePredicateRecordContext would retire the duplicate — but it is not this card's surface. Filed as #4080 (observation-class; it also records the one semantic difference the migration must preserve).


Generated by Claude Code

…#4075)

`action:button` / `action:icon` / `action:menu` / `action:group` gated their
actions on `useCondition(pred, ctx)` with the row spread flat — or, on three
of the leaves, with no row at all. Only the bare-field shorthand resolved, so
the CANONICAL `record.` root threw `record is not defined`; a fail-closed
`visible` turned that into "hidden" and a correctly-authored predicate deleted
its own button. Every declared action on `sys_approval_request` gates on
`record.viewer.*`, which is how the same binding suppressed the whole
server-declared approval decision set until #4077 fixed the declared-action bar.

All four now bind `record.status` / bare `status` / `data.status` through one
named helper (`usePredicateRecordContext`, beside `useCondition` in
`@object-ui/react`) — `evalRowPredicate`'s rule, restated for this tier.
`action:icon` reads its `data` prop at all; the menu/group leaves receive the
row from their host; `action:bar` forwards the row into the overflow menu it
builds, so a predicate no longer answers a different question because its
action spilled past `maxVisible`.

The evaluation entry and every site's error policy are untouched: a genuinely
faulting predicate still fails closed where it did and soft where it did. A
surface with no row binds nothing rather than an empty record, so a host that
supplies the row through the ambient scope is not blanked out.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017Qqyix2QcnpUC9XeYVDzx3
@vercel

vercel Bot commented Aug 10, 2026

Copy link
Copy Markdown

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

1 Skipped Deployment
Project Deployment Actions Updated (UTC)
objectui Ignored Ignored Aug 10, 2026 5:18am

Request Review

@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Main entry (gzip) 28.3 KB 350 KB
Entry file index-DDELVm3j.js
Status PASS

📦 Bundle Size Report

Package Size Gzipped
app-shell (index.js) 8.66KB 3.13KB
app-shell (runtime-config.js) 7.42KB 2.32KB
app-shell (types.js) 0.01KB 0.04KB
app-shell (urlParams.js) 7.57KB 2.97KB
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 1.17KB 0.53KB
auth (AuthProvider.js) 22.10KB 4.37KB
auth (AuthShell.js) 3.49KB 1.40KB
auth (ForgotPasswordForm.js) 12.21KB 3.45KB
auth (LoginForm.js) 18.13KB 5.39KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.64KB 2.21KB
auth (SocialSignInButtons.js) 9.60KB 3.89KB
auth (UserMenu.js) 3.40KB 1.22KB
auth (auth-gate-events.js) 1.29KB 0.66KB
auth (authStyles.js) 5.04KB 1.72KB
auth (createAuthClient.js) 35.76KB 9.11KB
auth (createAuthenticatedFetch.js) 4.37KB 1.69KB
auth (index.js) 2.35KB 1.07KB
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) 4.91KB 0.87KB
auth (useIsWorkspaceAdmin.js) 1.61KB 0.85KB
collaboration (CommentThread.js) 26.07KB 7.56KB
collaboration (LiveCursors.js) 3.17KB 1.27KB
collaboration (PresenceAvatars.js) 6.49KB 2.64KB
collaboration (PresenceProvider.js) 2.79KB 1.13KB
collaboration (index.js) 1.65KB 0.73KB
collaboration (useCollaborationTranslation.js) 6.05KB 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) 484.11KB 106.78KB
core (index.js) 3.04KB 1.15KB
create-plugin (index.js) 10.08KB 3.26KB
data-objectstack (index.js) 140.66KB 36.25KB
fields (index.js) 228.51KB 56.69KB
i18n (LocalizationContext.js) 1.76KB 0.96KB
i18n (currency.js) 1.22KB 0.64KB
i18n (i18n.js) 4.32KB 1.77KB
i18n (index.js) 2.65KB 1.06KB
i18n (pickLocalized.js) 1.70KB 0.83KB
i18n (provider.js) 9.48KB 3.27KB
i18n (useObjectLabel.js) 27.59KB 6.63KB
i18n (useSafeTranslation.js) 4.52KB 1.96KB
layout (index.js) 38.84KB 10.80KB
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.74KB
mobile (index.js) 1.50KB 0.62KB
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) 2.53KB 0.85KB
mobile (useResponsive.js) 0.71KB 0.42KB
mobile (useResponsiveConfig.js) 1.36KB 0.63KB
mobile (useSpecGesture.js) 4.32KB 1.64KB
mobile (useTouchTarget.js) 1.01KB 0.54KB
permissions (MePermissionsProvider.js) 8.75KB 3.06KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 3.67KB 1.12KB
permissions (evaluator.js) 4.41KB 1.44KB
permissions (index.js) 0.91KB 0.41KB
permissions (store.js) 0.91KB 0.42KB
permissions (useFieldPermissions.js) 1.28KB 0.52KB
permissions (usePermissions.js) 1.55KB 0.71KB
plugin-ai (index.js) 15.71KB 3.79KB
plugin-calendar (index.js) 45.23KB 12.45KB
plugin-charts (index.js) 61.49KB 17.48KB
plugin-chatbot (index.js) 180.33KB 42.79KB
plugin-dashboard (index.js) 118.50KB 30.66KB
plugin-designer (index.js) 210.51KB 42.51KB
plugin-detail (index.js) 237.80KB 59.48KB
plugin-editor (index.js) 2.46KB 1.10KB
plugin-form (index.js) 113.81KB 27.53KB
plugin-gantt (index.js) 162.79KB 39.67KB
plugin-grid (index.js) 187.97KB 49.79KB
plugin-kanban (index.js) 48.53KB 13.38KB
plugin-list (index.js) 109.96KB 26.64KB
plugin-map (index.js) 17.00KB 5.32KB
plugin-markdown (index.js) 13.72KB 4.69KB
plugin-report (index.js) 40.58KB 10.58KB
plugin-timeline (index.js) 26.21KB 7.52KB
plugin-tree (index.js) 8.50KB 2.88KB
plugin-view (index.js) 84.03KB 20.55KB
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.71KB 3.53KB
providers (index.js) 0.44KB 0.22KB
providers (types.js) 0.01KB 0.04KB
react-runtime (index.js) 5.67KB 2.37KB
react (LazyPluginLoader.js) 3.77KB 1.33KB
react (SchemaRenderer.js) 23.71KB 7.95KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 1.23KB 0.66KB
react (spec-input.js) 0.20KB 0.18KB
sdui-parser (codegen.js) 4.09KB 1.74KB
sdui-parser (index.js) 4.47KB 2.03KB
sdui-parser (parse.js) 10.04KB 2.82KB
sdui-parser (types.js) 0.29KB 0.24KB
sdui-parser (validate.js) 4.69KB 1.48KB
types (ai.js) 0.20KB 0.17KB
types (api-types.js) 0.20KB 0.18KB
types (app.js) 2.87KB 0.99KB
types (base.js) 0.20KB 0.18KB
types (blocks.js) 0.20KB 0.18KB
types (complex.js) 0.20KB 0.18KB
types (crud.js) 0.20KB 0.18KB
types (data-display.js) 0.20KB 0.18KB
types (data-protocol.js) 0.20KB 0.19KB
types (data.js) 0.20KB 0.18KB
types (designer.js) 1.87KB 0.85KB
types (disclosure.js) 0.20KB 0.18KB
types (error-code.js) 1.54KB 0.88KB
types (feedback.js) 0.20KB 0.18KB
types (field-types.js) 0.20KB 0.18KB
types (form.js) 0.20KB 0.18KB
types (http-retry.js) 4.32KB 2.02KB
types (index.js) 2.71KB 1.34KB
types (layout.js) 0.20KB 0.18KB
types (managed-by.js) 0.19KB 0.18KB
types (mobile.js) 2.59KB 1.31KB
types (navigation.js) 0.20KB 0.18KB
types (objectql.js) 0.20KB 0.18KB
types (overlay.js) 0.20KB 0.18KB
types (permissions.js) 0.20KB 0.18KB
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 (spec-report.js) 5.05KB 1.93KB
types (system-fields.js) 3.33KB 1.54KB
types (theme.js) 0.20KB 0.18KB
types (ui-action.js) 3.40KB 1.71KB
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

@yinlianghui
yinlianghui marked this pull request as ready for review August 10, 2026 05:28
@yinlianghui
yinlianghui added this pull request to the merge queue Aug 10, 2026
Merged via the queue into main with commit 8aad9fd Aug 10, 2026
21 checks passed
@yinlianghui
yinlianghui deleted the claude/issue-4075-action-predicate-binding branch August 10, 2026 05:28
Sign up for free to 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.

console: action:button / action:icon / action:menu bind the row only at the bare root, so a declared visible written as record.* faults and fails closed

2 participants