Skip to content

fix(react): a page node whose visibility predicate faults is withheld (objectui#13299) - #13302

Merged
objectstack-fleet[bot] merged 1 commit into
mainfrom
claude/issue-13299-node-visibility-fail-closed
Oct 21, 2026
Merged

objectstack-fleet[bot] merged 1 commit into
mainfrom
claude/issue-13299-node-visibility-fail-closed

Conversation

@objectstack-fleet

Copy link
Copy Markdown
Contributor

Fixes #13299
Clause-②: no

What

A page node whose DECLARED visibility predicate faults on evaluation (over the CEL AST bound, a type error, an unbound root, a missing function) is no longer rendered. As objectui#13286 already did for a page:tabs item, page visibility gates now fail closed.

  • packages/react/src/SchemaRenderer.tsx: visibilityGateKind became visibilityFaultOutcome(key, raw), which answers both what a fault DECIDES on a leg and which consequence the report prints. evaluateVisibilityPredicate uses it in both branches. Production keeps ONE engine call: onFault records the fault on that call and the faulted call answers with the fail-closed verdict (no second throwOnError evaluation). The dev branch's throwOnError catch returns the same verdict. Reports go through the shared reportUnresolvableVisibilityPredicate and its dedupe set, with the 'withholding' consequence on a declared SHOW-leg predicate. The docblocks that said the fail-open semantics were "not its to move" are rewritten.
  • packages/components/src/renderers/layout/containers.tsx: the page:tabs count-probe gate isGateOpen mirrors the node gate (same onFault flag, same hasDeclaredPredicate test, same 'withholding' copy), so a badge counts what is drawn.
  • content/docs/guide/metadata-diagnostics.md: page visibility gates (node and tab item) fail closed; form field rules keep their fail-open. The node example's consequence line, which said the gate "did NOT bite", is replaced by a sentence naming what the fault does on each leg.
  • .changeset/13299-node-visibility-fail-closed.md: patch for @object-ui/react and @object-ui/components.

Every leg, and where a fault lands

Leg Polarity in shouldHide Declared predicate faults Blank gate (declares nothing)
visibleWhen negated false -> not rendered (was: shown) · copy 'withholding' fail-soft true -> shown · copy 'visibility'
visible negated not rendered (was: shown) · 'withholding' shown · 'visibility'
visibleOn negated not rendered (was: shown) · 'withholding' shown · 'visibility'
hidden not negated true -> not rendered (unchanged) · 'concealment' never evaluated (hasDeclaredPredicate guard)
hiddenOn not negated not rendered (unchanged) · 'concealment' never evaluated

disabled / disabledOn route through evaluateEnablementPredicate, which shares no helper with the visibility chain; they are unchanged. hasDeclaredPredicate is asked only on the fault path, because it reports a blank gate as a side effect and a non-faulting predicate must stay as silent as it was.

Pins

New: packages/react/src/__tests__/SchemaRenderer.nodeVisibilityFailClosed-13299.test.tsx (rows a-d, each in the production and the development module graph) and packages/components/src/__tests__/page-node-visibility-fail-closed-13299.test.tsx (rows e and f).

  • (a) a throwing visibleWhen is not rendered, and two renders log ONE warning that says WITHHELD.
  • (b) visible, visibleOn (and a faulting CEL envelope on visibleWhen) are not rendered; hidden, hiddenOn are not rendered with the concealment copy.
  • (c) CONTROL: true shows, false hides, absent shows, blank '' and blank envelope show; no WITHHELD line.
  • (d) a 120-term OR chain over the AST bound is withheld; a 4-term one shows. The [bounds] reason is asserted in production only: the dev throwOnError probe reports a generic CEL reason for the same fault (pre-existing, see Acceptance notes).
  • (e) the tab badge does not count a list withheld by an unbound root, by an over-budget source, or by a faulting gate on a container above it; CONTROLS: a true gate and a blank gate are counted.
  • (f) CONTROL: a form field visibleWhen that faults is still drawn.

Existing fail-open pins flipped (each now asserts withheld)

packages/react:

  • SchemaRenderer.productionPredicateFaultWarning.test.tsx: the seven verdict assertions in groups 1, 2 and 4 (BARE, CEL, template, three-ids, distinct-source, two-hundred-row, dev-vs-prod).
  • SchemaRenderer.concealmentGateFaultDiagnostic.test.tsx: group 2 (three negated legs) now asserts withheld + the withholding clause, with the old "did NOT bite" sentence pinned absent.
  • SchemaRenderer.visibleWhenRecordBinding.test.tsx: "binds the record ROOT only", leg 3 "warns ... and WITHHOLDS", "the bare-string dialect is loud too", the production case, and the objectui#6487 advice case.
  • SchemaRenderer.nodeGateDataPredicate.test.tsx: 3b and 5d.
  • SchemaRenderer.dataRootUnbound-9308.test.tsx: leg 7.
  • SchemaRenderer.disabledGateFaultDiagnostic.test.tsx: the visibility-copy tail in group 4 is now the withholding paragraph.

Outside packages/react (the same flip, made false by this change; declared as a file-surface extension):

  • packages/components/src/__tests__/page-tabs-count-visible-when-12987.test.tsx: the fail-open count case now asserts the list is not counted.
  • packages/components/src/renderers/complex/__tests__/data-table-empty-action-visible-when.test.tsx: the faulting emptyAction is withheld.
  • packages/components/src/renderers/form/__tests__/predicate-scope-parity-6010.test.tsx: the FAULTED group now expects the page node closed and the four form surfaces open.
  • packages/app-shell/src/providers/__tests__/hasCapability-13006.render.test.tsx: three cases (not loaded, unreported, refused map) now withhold the node.
  • packages/plugin-detail/src/renderers/__tests__/record-alert.rowBinding.test.tsx: group C shorthand is withheld on both rows.

Verification (at 321c1f244d)

  • Targeted vitest, --maxWorkers=1, under the shared lock: react family naming SchemaRenderer (55 files, 893 tests) run first; the 7 react files touched re-run green (130/130); page:tabs family + new components file (12 files, 77/77); consumer files in app-shell / plugin-detail / components / apps/console / examples (24 files) re-run after the flips, then the four flipped ones (37/37); a wider sweep of 19 files that render SchemaRenderer with a gate and a fault/warn assertion (586/586).
  • Type-check: closure build --filter '@object-ui/app-shell^...' --filter '@object-ui/plugin-detail^...' exit 0, then type-check (which runs tsc --noEmit && tsc -p tsconfig.test.json) for react, components, app-shell, plugin-detail: all exit 0.
  • Lint narrowed to the 15 changed TS/TSX files, the way each package's lint script runs eslint: exit 0, 0 errors. Population: eslint.config.js lints **/*.{ts,tsx}; count from --format json; invariance: the config sets no parserOptions.project / projectService, so type-aware linting is off and this diff cannot move a verdict on an untouched file.
  • Gates, each exit 0: check:phantom-deps, check:self-import, check:unreferenced-sources, check:doc-example-readers, check:handler-key-reads, check:side-effects-array, check:element-data-source-declaration, check:spec-symbols, check:action-forward-parity, check:designer-field-key-parity, check:icon-record-names, check:i18n-keys, check:i18n-drift, check:i18n-designer-parity, check:control-bytes, check:new-line-citations, check:test-path-roots, scripts/check-hand-rolled-comment-mask.mjs, scripts/check-changeset-fixed.mjs, scripts/check-changeset-presence.mjs. Control-byte self-scan over the diff: no hits.
  • Declared to CI: the full test directories of packages/react, packages/components, packages/app-shell, packages/plugin-detail (no whole-directory runs here, per the dispatch), and every other package's suite.

Ablation (one-shot, nothing left in the tree)

Restored the fail-soft verdict on the node gate in both branches (return fault ? fault.verdict : verdict; to return verdict;, and the dev catch's return fault.verdict; to return true;) through ablation-replace.mjs (anchor hits 1 -> 0 on disk for each, under a restore trap), then ran both new files: 10 failed / 12 passed. Red: (a) x2 builds, (b) visible / visibleOn / CEL envelope x2 builds, (d) x2 builds. Green: (c) x2, (f), and (b) hidden / hiddenOn x2 builds. The hidden / hiddenOn rows staying green is the expected direction, not a hole: their fail-soft true already hid, so the ablation does not move them. (e) stays green too because the count-probe gate is a separate site the ablation does not touch. Restore proven by blob hash: SchemaRenderer.tsx blob after restore = HEAD blob e2f0700ce56e, git diff HEAD empty.

Acceptance notes

  • Measured behaviour shifts, all the ruled direction: a record.* node gate on a surface where no row is bound (including a record page before the row has loaded) is now withheld rather than shown; a current_user.hasCapability(...) node gate is withheld while the capability list is not loaded, and stays withheld on a backend that never reports systemPermissions; a row-action shorthand (status == 'x', unbound since objectui#5741) withholds its node. None of these looked like essential content that needs fail-open, so no fork is reported.
  • The shared 'withholding' consequence copy in visibilityDiagnostic.ts was written for the app-shell navigation gate and says "a navigation entry". It now prints for page nodes (and since objectui#13286 for tab items). That file is outside this card's surface; not changed here.
  • The dev branch's throwOnError probe reports a generic CEL reason for an over-budget source, while production's onFault reports the engine's [bounds] reason. Pre-existing; the verdict and the line count agree.
  • record:alert's own renderer-level useCondition (gate 2) is still fail-soft. End to end the node chain now withholds the shorthand case first, so it only shows when a node-level visibleWhen wins the chain and a faulting properties.visible reaches gate 2.

Generated by Claude Code

… (objectui#13299)

A declared visibleWhen / visible / visibleOn predicate that cannot be
evaluated (over the CEL bounds, a type error, an unbound root, a missing
function) now fails closed: the node is not rendered, the direction
objectui#13286 set for a page:tabs item. The fault is read off the single
engine call's onFault in production (no second throwOnError evaluation),
reported once through the shared reporter with the 'withholding'
consequence. hidden / hiddenOn already hid on a fault and are unchanged;
a blank gate still means "no gate". The page:tabs count-probe gate mirrors
the node gate, so a badge does not count a withheld list. Form field rules
keep their fail-open. Existing fail-open pins are flipped.

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

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 77 chunks) 3224.9 KB 3744.1 KB
Main entry chunk (gzip) 81.2 KB 350 KB
Entry file index-C0AGEBVs.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 (buildIdentity.js) 0.80KB 0.49KB
app-shell (consoleActionDispatch.js) 0.20KB 0.19KB
app-shell (index.js) 21.41KB 7.90KB
app-shell (runtime-config.js) 24.52KB 8.48KB
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) 45.59KB 12.03KB
auth (AuthShell.js) 3.49KB 1.40KB
auth (ForgotPasswordForm.js) 12.21KB 3.45KB
auth (LoginForm.js) 20.67KB 6.12KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.72KB 2.24KB
auth (SocialSignInButtons.js) 9.74KB 3.94KB
auth (UserMenu.js) 3.39KB 1.21KB
auth (auth-gate-events.js) 1.62KB 0.83KB
auth (authStyles.js) 5.27KB 1.86KB
auth (createAuthClient.js) 42.84KB 11.66KB
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.26KB 8.03KB
collaboration (LiveCursors.js) 3.17KB 1.27KB
collaboration (PresenceAvatars.js) 6.28KB 2.60KB
collaboration (PresenceProvider.js) 2.79KB 1.13KB
collaboration (commentAuthorship.js) 1.39KB 0.78KB
collaboration (index.js) 1.93KB 0.85KB
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) 617.54KB 150.58KB
core (index.js) 10.18KB 4.04KB
create-plugin (index.js) 27.94KB 9.51KB
data-objectstack (index.js) 252.96KB 70.67KB
fields (index.js) 294.69KB 75.35KB
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) 36.87KB 9.88KB
i18n (useSafeTranslation.js) 7.14KB 2.92KB
layout (index.js) 41.40KB 12.01KB
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) 15.35KB 5.51KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 6.82KB 2.38KB
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) 55.56KB 16.21KB
plugin-charts (index.js) 86.06KB 23.66KB
plugin-chatbot (index.js) 238.47KB 56.30KB
plugin-dashboard (index.js) 147.53KB 39.95KB
plugin-designer (index.js) 233.95KB 50.08KB
plugin-detail (index.js) 267.56KB 71.11KB
plugin-editor (index.js) 2.23KB 1.05KB
plugin-form (index.js) 186.64KB 48.54KB
plugin-gantt (index.js) 178.46KB 45.13KB
plugin-grid (index.js) 276.74KB 76.89KB
plugin-kanban (index.js) 64.49KB 19.83KB
plugin-list (index.js) 149.81KB 39.28KB
plugin-map (index.js) 27.17KB 9.00KB
plugin-markdown (index.js) 13.88KB 4.80KB
plugin-report (index.js) 46.66KB 13.13KB
plugin-timeline (index.js) 39.31KB 11.88KB
plugin-tree (index.js) 15.27KB 5.40KB
plugin-view (index.js) 94.54KB 24.33KB
providers (DataSourceProvider.js) 0.75KB 0.39KB
providers (MetadataProvider.js) 1.37KB 0.59KB
providers (ThemeProvider.js) 1.90KB 0.85KB
providers (UploadProvider.js) 12.07KB 3.68KB
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) 129.13KB 42.23KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 4.71KB 2.11KB
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.07KB 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.81KB
sdui-parser (provenance.js) 3.84KB 1.90KB
sdui-parser (types.js) 0.29KB 0.24KB
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 (product-blocks.js) 0.20KB 0.19KB
types (record-approval-decision.js) 0.20KB 0.20KB
types (record-components.js) 0.20KB 0.19KB
types (record-panels.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.26KB
types (system-fields.js) 3.33KB 1.54KB
types (theme.js) 6.28KB 2.87KB
types (ui-action.js) 8.48KB 3.50KB
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 21, 2026 06:12
@objectstack-fleet
objectstack-fleet Bot enabled auto-merge October 21, 2026 06:12
@objectstack-fleet
objectstack-fleet Bot added this pull request to the merge queue Oct 21, 2026
Merged via the queue into main with commit 3aafc0d Oct 21, 2026
37 checks passed
@objectstack-fleet
objectstack-fleet Bot deleted the claude/issue-13299-node-visibility-fail-closed branch October 21, 2026 06:26
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.

SchemaRenderer node visibleWhen still fails open on a fault; page:tabs items now fail closed

2 participants