Skip to content

fix(plugin-detail): stop the loading-frame record is not defined noise on record:alert - #5797

Merged
os-zhuang merged 1 commit into
mainfrom
claude/issue-5776-record-not-defined-loading-frame
Aug 23, 2026
Merged

fix(plugin-detail): stop the loading-frame record is not defined noise on record:alert#5797
os-zhuang merged 1 commit into
mainfrom
claude/issue-5776-record-not-defined-loading-frame

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Fixes#5776

What was wrong

record:alert's visible predicate (usePredicateRecordContext + useCondition) is evaluated on every render — Rules of Hooks means the hook must run even in the frame before useRecordContext().data has loaded. In that frame record is undefined, and usePredicateRecordContext deliberately binds an empty context bag then (its own doc: "No row → bind NOTHING", so a host-supplied ambient record isn't shadowed by a record that merely hasn't loaded yet).

A bare-string (or ${…}-wrapped) predicate referencing record.* against that empty bag faults with a bare ReferenceError: record is not defined, which ExpressionEvaluator.evaluate's catch logs via console.warn on every page load — including the correct, working ones, since the exact same predicate resolves fine one frame later once record populates. The banner's own visibility was never wrong (it already hides unconditionally while !record); only the diagnostic was permanently misleading.

Re-measured on today's origin/main (cd6a328fe, post @objectstack/* 17.2.0 refresh) — the mechanism and message are unchanged from the objectstack#11247 evidence at the old pin.

The fix

record-alert.tsx now derives one recordLoaded flag and uses it in two places that used to diverge slightly (!record || Object.keys(record).length === 0 vs. no gate at all):

  • The predicate passed to useCondition is recordLoaded ? predicateInput : undefinedevaluateCondition(undefined) short-circuits to true without ever touching the evaluator, so nothing is evaluated (and nothing can fault) in a frame whose banner is hidden regardless.
  • The existing "hide while unloaded" early return now reads !recordLoaded — the exact same expression, not a re-derived one, so the two can never drift apart.

A predicate that is genuinely broken (bad field, bad syntax) is not touched by this change — once record is populated it's evaluated for real, faults for real, and still logs for real. That pairing is pinned directly (see tests below).

Tests

New file packages/plugin-detail/src/renderers/__tests__/record-alert.loadingFrameDiagnostic.test.tsx, real toPredicateInput/useCondition pipeline (objectui#3941 doubling convention — only the data layer is mocked):

  • Reproduced first (confirmed red pre-fix): loading frame with a bare-string record.* predicate logged Failed to evaluate expression: ${record.status == 'in_review'} / record is not defined, for both eventual polarities.
  • Pin 1: loading frame emits no evaluation-failure warning, then the SAME predicate resolves correctly (both "holds" and "fails" polarities) with no warning once record populates.
  • Pin 2 (the pairing half): a predicate that references a field unrelated to loading (bogus_unbound_field.status == 'x') against an already-loaded record still logs Failed to evaluate expression — proving this isn't the diagnostic silenced outright.

Full existing record:alert suites (record-alert.test.tsx, .rowBinding.test.tsx, .visibleWhen.evidence.test.tsx) plus the new file: 39/39 passed. Full plugin-detail package: 868/868 passed (pnpm exec vitest run packages/plugin-detail/, from repo root per this repo's invocation guard). pnpm --filter @object-ui/plugin-detail run type-check: clean. Targeted eslint --no-inline-config on both touched files: 0 errors (pre-existing no-explicit-any warnings only, matching this file's existing style). node scripts/check-changeset-presence.mjs / check-changeset-no-major.mjs: both pass with the added patch changeset.

Scope

Deliberately narrow to record:alert's bare-string/legacy-${…} path — the sizing datum on the source card measured this as the only surface currently authoring bare-string predicates (all 6 other visibleWhen values across 34 pages are {dialect:'cel'} envelopes). No behavior change to any predicate verdict; diagnostic hygiene only.


Generated by Claude Code

…ise on record:alert
`record:alert`'s bare/`${…}` `visible` predicate is evaluated on every render
(Rules of Hooks), including the frame before `useRecordContext().data` loads.
In that frame `usePredicateRecordContext` binds an empty context bag by
design (no `record` key), so a predicate referencing `record.*` faults with
`record is not defined` — logged on every load, including working ones,
since the same predicate resolves fine one frame later. The banner already
hides unconditionally while unloaded, so the verdict in that frame was never
consulted. Skip evaluating the predicate while `record` hasn't loaded (same
condition the early-return already used); a genuinely-broken predicate still
faults and still logs once `record` is populated.
Fixes#5776
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EuPCi56cnGyykygi3z9w4m
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Eager closure (gzip, 52 chunks)3225.3 KB3990.2 KB
Main entry chunk (gzip)152.6 KB350 KB
Entry fileindex-O-EHH29O.js
StatusPASS

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

PackageSizeGzipped
app-shell (consoleActionDispatch.js)0.20KB0.19KB
app-shell (index.js)10.04KB3.72KB
app-shell (runtime-config.js)12.80KB4.47KB
app-shell (types.js)0.01KB0.04KB
app-shell (urlParams.js)10.06KB3.86KB
auth (ActiveOrganizationStorage.js)25.05KB9.16KB
auth (AuthContext.js)0.31KB0.24KB
auth (AuthGuard.js)2.07KB1.00KB
auth (AuthProvider.js)33.99KB8.57KB
auth (AuthShell.js)3.49KB1.40KB
auth (ForgotPasswordForm.js)12.21KB3.45KB
auth (LoginForm.js)18.15KB5.39KB
auth (PreviewBanner.js)0.90KB0.50KB
auth (RegisterForm.js)6.65KB2.22KB
auth (SocialSignInButtons.js)9.61KB3.89KB
auth (UserMenu.js)3.41KB1.23KB
auth (auth-gate-events.js)1.29KB0.66KB
auth (authStyles.js)5.04KB1.72KB
auth (createAuthClient.js)40.21KB10.80KB
auth (createAuthenticatedFetch.js)8.46KB3.43KB
auth (index.js)3.19KB1.44KB
auth (invitation-status.js)1.22KB0.70KB
auth (org-roles.js)6.66KB2.78KB
auth (phone-identifier.js)1.11KB0.66KB
auth (types.js)0.59KB0.35KB
auth (useAuth.js)5.30KB1.02KB
auth (useWorkspaceAdminStatus.js)5.13KB2.35KB
collaboration (CommentThread.js)26.08KB7.56KB
collaboration (LiveCursors.js)3.17KB1.27KB
collaboration (PresenceAvatars.js)6.49KB2.64KB
collaboration (PresenceProvider.js)2.79KB1.13KB
collaboration (index.js)1.68KB0.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)503.77KB113.91KB
core (index.js)4.92KB1.97KB
create-plugin (index.js)10.08KB3.26KB
data-objectstack (index.js)164.55KB45.67KB
fields (index.js)238.40KB59.89KB
i18n (LocalizationContext.js)1.76KB0.96KB
i18n (currency.js)1.22KB0.64KB
i18n (i18n.js)4.28KB1.75KB
i18n (index.js)3.44KB1.39KB
i18n (pickLocalized.js)7.62KB3.26KB
i18n (provider.js)23.13KB7.63KB
i18n (useDisplayLocale.js)2.85KB1.45KB
i18n (useObjectLabel.js)33.40KB8.71KB
i18n (useSafeTranslation.js)7.77KB3.13KB
layout (index.js)38.95KB10.97KB
mobile (MobileProvider.js)0.92KB0.49KB
mobile (ResponsiveContainer.js)0.94KB0.38KB
mobile (breakpoints.js)1.51KB0.70KB
mobile (createOfflineDataSource.js)5.61KB1.75KB
mobile (index.js)1.55KB0.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.72KB0.42KB
mobile (useResponsiveConfig.js)1.37KB0.63KB
mobile (useSpecGesture.js)4.32KB1.64KB
mobile (useTouchTarget.js)1.01KB0.54KB
permissions (MePermissionsProvider.js)9.53KB3.38KB
permissions (PermissionContext.js)0.31KB0.25KB
permissions (PermissionGuard.js)0.89KB0.45KB
permissions (PermissionProvider.js)4.64KB1.50KB
permissions (evaluator.js)5.12KB1.74KB
permissions (index.js)0.93KB0.41KB
permissions (store.js)0.91KB0.42KB
permissions (useFieldPermissions.js)1.28KB0.53KB
permissions (usePermissions.js)1.93KB0.88KB
plugin-ai (index.js)15.75KB3.80KB
plugin-calendar (index.js)46.62KB12.83KB
plugin-charts (index.js)64.65KB18.32KB
plugin-chatbot (index.js)181.41KB43.22KB
plugin-dashboard (index.js)128.41KB32.95KB
plugin-designer (index.js)212.30KB42.80KB
plugin-detail (index.js)242.34KB60.99KB
plugin-editor (index.js)2.46KB1.10KB
plugin-form (index.js)125.63KB30.64KB
plugin-gantt (index.js)164.10KB39.87KB
plugin-grid (index.js)200.79KB54.26KB
plugin-kanban (index.js)52.93KB14.60KB
plugin-list (index.js)111.80KB27.20KB
plugin-map (index.js)20.06KB6.62KB
plugin-markdown (index.js)13.72KB4.69KB
plugin-report (index.js)43.49KB11.93KB
plugin-timeline (index.js)26.49KB7.59KB
plugin-tree (index.js)8.50KB2.88KB
plugin-view (index.js)84.61KB20.74KB
providers (DataSourceProvider.js)0.75KB0.39KB
providers (MetadataProvider.js)1.37KB0.59KB
providers (ThemeProvider.js)1.90KB0.85KB
providers (UploadProvider.js)11.66KB3.50KB
providers (index.js)0.45KB0.23KB
providers (types.js)0.01KB0.04KB
react-runtime (index.js)5.62KB2.34KB
react (LazyPluginLoader.js)3.77KB1.33KB
react (SchemaRenderer.js)44.39KB14.99KB
react (data-invalidation.js)5.05KB2.08KB
react (index.js)1.33KB0.69KB
react (schema-input.js)2.32KB1.24KB
react (spec-input.js)0.20KB0.18KB
sdui-parser (codegen.js)5.41KB2.34KB
sdui-parser (dashboard-widget-options.js)3.08KB1.30KB
sdui-parser (index.js)4.93KB2.24KB
sdui-parser (input-type.js)2.84KB1.40KB
sdui-parser (parse.js)12.13KB3.65KB
sdui-parser (provenance.js)3.66KB1.82KB
sdui-parser (types.js)0.28KB0.23KB
sdui-parser (validate.js)7.54KB2.63KB
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-inflight.js)8.87KB3.73KB
types (http-retry.js)4.32KB2.02KB
types (index.js)3.88KB1.85KB
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 (spec-ui-namespace.js)0.20KB0.19KB
types (system-fields.js)3.33KB1.54KB
types (theme.js)3.40KB1.68KB
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

@os-zhuang
os-zhuang marked this pull request as ready for review August 23, 2026 11:39
@os-zhuang
os-zhuang added this pull request to the merge queueAug 23, 2026
Merged via the queue into main with commit 641543fAug 23, 2026
23 checks passed
@os-zhuang
os-zhuang deleted the claude/issue-5776-record-not-defined-loading-frame branch August 23, 2026 11:40
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

2 participants

@os-zhuang@claude