Skip to content

fix(react): guard a degenerate props bag against the object spread (#6752) - #6763

Merged
os-sales merged 1 commit into
mainfrom
claude/issue-6752-props-bag-degenerate-guard
Aug 29, 2026
Merged

fix(react): guard a degenerate props bag against the object spread (#6752)#6763
os-sales merged 1 commit into
mainfrom
claude/issue-6752-props-bag-degenerate-guard

Conversation

@os-sales

Copy link
Copy Markdown
Collaborator

Fixes #6752

Base: b76ca6764 (includes PR #6753 / card #6708, 46b9bc989). Head: 53185b807.

The dispatch was measurement-first, so this reports the reason before the arm

Triage's order of operations: read WHY the sibling properties branch carries a wider guard, then let the reason pick the arm. Channel-independent reason means the missing props guard is an oversight (widen it); hoist-specific reason means the asymmetry is intended (fix the comment instead).

The reason as the code states it, in the evaluation memo, verbatim before this PR:

The guard is wider than the props branch's bare truthiness on purpose: this value FEEDS the hoist, so re-shaping a degenerate properties (a string, an array) via the object spread would propagate. Non-objects skip evaluation and reach the hoist exactly as they do today.

Read alone that is hoist-specific. But the same file states the same reason a second time, at a site the hoist never reaches — propsWithoutCanonicalKeys, the objectui#5123 narrowing:

arrays are excluded for the same reason the evaluation guard excludes them — a degenerate properties must not have its shape reinterpreted here.

The two readings disagree, so I measured instead of picking.

What the measurement says

Ablating the properties guard to bare truthiness and re-rendering { type, properties: 'not-a-bag' } through the real SchemaRenderer on b76ca6764:

indexed React props schema.properties
guard present 08 "not-a-bag"
guard ablated 08 { "0": "n", "1": "o", … }

The indexed keys are identical. The hoist's own Object.entries walk enumerates a degenerate string whatever the memo guard did, so the guard does not protect the hoist — the stated reason does not survive measurement. Exactly one thing moves: whether schema.properties still holds the value the author wrote.

⇒ what the guard buys is the authored value's shape, which is channel-independent, and is what the second site already says. Arm 1: the props branch was missing the same guard for the same reason.

Reproduction, before any change

Measured on b76ca6764 through the real SchemaRenderer, one node per row:

{ type: 'test:deg', props: 'not-a-bag' }  -> React props 0,1,2,3,4,5,6,7,8   schema.props = { "0":"n", … }
{ type: 'test:deg', props: ['x','y'] }    -> React props 0,1
{ type: 'test:deg', props: 42 }           -> no indexed props, schema.props = {}
{ type: 'test:deg', props: {title,data} } -> title + data, evaluated (control)

That pre-fix reading is pasted verbatim into the pin as BASE_READING, so the "unchanged" legs are a real before/after comparison rather than a self-fulfilling snapshot.

Why the fix has two halves — also measured, not assumed

Widening the evaluation memo alone did not remove the indexed props. The bag reached propsWithoutCanonicalKeys as the authored string, was returned unchanged, and { ...outgoingPropsBag } at the createElement call re-enumerated it. Both sites object-spread the bag, so both needed the predicate:

  • the evaluation memo — so schema.props keeps the authored value;
  • propsWithoutCanonicalKeys — so the spread does not re-enumerate it. This also makes its declared return type true: it said Record<string, any> while it could hand back a string.

One isConfigBag predicate now serves both bags, the properties guard adopts it (semantics identical), and its comment states the measured reason instead of the old one.

Result

node before after
props: 'not-a-bag' nine React props 08 none; props carries "not-a-bag"
props: ['x','y'] 0, 1 none; props carries the array
props: 42 / true props prop was {} props carries 42 / true
props: { title, data } evaluated + spread per key byte-for-byte identical
properties: 'not-a-bag' 08 byte-for-byte identical (out of scope)

Ablation

Trapped on EXIT INT TERM with absolute paths; mutation proven on disk by anchor counts flipping and the blob hash changing; restore proven by git diff HEAD empty and the restored blob hash equalling the HEAD blob hash (b3bdabd0c). No rebuild leg applies: the pin imports ../SchemaRenderer as a relative source path, so nothing resolves through package exports to dist.

  • both guards removedTests 3 failed | 5 passed (8). Red: the three degenerate legs. Green by name: "a normal object props is byte-for-byte what it was before this card", "the properties channel is untouched", and both objectui#6708 diagnostic legs.
  • only the spread guard removedTests 2 failed | 6 passed (8). The two indexed-prop legs go red while "the authored value survives" stays green, which is precisely the two-halves claim.
  • restoredTests 8 passed (8).

Verification, all on 53185b807 with a clean worktree

check verdict line
pnpm exec vitest run packages/react/ Test Files 66 passed (66) · Tests 987 passed (987)
pnpm --filter @object-ui/react type-check exit 0 (tsc --noEmit and tsc -p tsconfig.test.json, so the new test file is type-checked)
eslint . in packages/react 135 files, 0 errors
pnpm check:control-bytes ✅ OK (scanned 5622 tracked text file(s))
check-changeset-presence ✅ 2 source file(s) of 1 released package(s) changed … declares 1 changeset(s)
check-changeset-no-major ✅ No changeset declares a major bump
forwardref-props-erasure.guard + check-node-esm-load Tests 47 passed (47) — the repo guards that pin this file

Every exit code was captured by redirect-then-capture, never after a pipe.

Repo-wide pnpm lint was narrowed, and the narrowing is declared: every source file in the diff lives in packages/react, and that package's own complete lint job ran (135 files from eslint's own --format json output, 0 errors). eslint.config.js sets no project / projectService, so type-aware linting is off and a TypeScript change here cannot move the verdict on any file outside the diff. CI runs the full farm regardless.

Scope

Unchanged and pinned: objectui#5123's two-bag precedence (a degenerate bag declares no key for either bag to win), the properties hoist, and objectui#6708's diagnostic (it reads the AUTHORED bag, and collectDroppedPropsKeys already refuses a non-object bag at both arguments). No new published surface. content/docs/releases/ untouched.

Filed rather than fixed here:


Generated by Claude Code

A node written `{ type: 'card', props: 'not-a-bag' }` reached `createElement`
carrying nine React props named `0` through `8`, one per character, because
`{ ...'not-a-bag' }` enumerates a string's character indices. Nothing threw and
nothing was logged.

Triage dispatched this measurement-first: read why the sibling `properties`
branch carries a wider guard, then let the reason pick the arm. The comment
claimed the guard was hoist-specific, and that did not survive measurement —
ablating it leaves the indexed keys the hoist puts on the node unchanged (the
hoist's own `Object.entries` walk enumerates a string either way) and moves only
whether `schema.properties` still holds the authored value. The reason is
channel-independent, and `propsWithoutCanonicalKeys` already states it that way
at a non-hoist site. So `props` was missing the same guard for the same reason.

Both spread sites are covered — measured: widening the evaluation memo alone let
the nine props back in via `{ ...outgoingPropsBag }`. One `isConfigBag`
predicate now serves both bags, and the `properties` comment states the measured
reason instead of the old one.

Unchanged and pinned: a normal object `props`, objectui#5123's two-bag
precedence, the `properties` hoist, and objectui#6708's diagnostic.
@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 48 chunks) 3180.0 KB 3222.7 KB
Main entry chunk (gzip) 148.2 KB 350 KB
Entry file index-D_vEiYhP.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) 11.89KB 4.50KB
app-shell (runtime-config.js) 20.61KB 7.35KB
app-shell (types.js) 0.01KB 0.04KB
app-shell (urlParams.js) 10.06KB 3.86KB
auth (ActiveOrganizationStorage.js) 25.05KB 9.16KB
auth (AuthContext.js) 0.31KB 0.24KB
auth (AuthGuard.js) 2.07KB 1.00KB
auth (AuthProvider.js) 40.18KB 10.59KB
auth (AuthShell.js) 3.49KB 1.40KB
auth (ForgotPasswordForm.js) 12.21KB 3.45KB
auth (LoginForm.js) 18.15KB 5.39KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.65KB 2.22KB
auth (SocialSignInButtons.js) 9.61KB 3.89KB
auth (UserMenu.js) 3.41KB 1.23KB
auth (auth-gate-events.js) 1.29KB 0.66KB
auth (authStyles.js) 5.04KB 1.72KB
auth (createAuthClient.js) 40.21KB 10.80KB
auth (createAuthenticatedFetch.js) 8.46KB 3.43KB
auth (index.js) 3.19KB 1.44KB
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) 5.13KB 2.35KB
collaboration (CommentThread.js) 26.08KB 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.68KB 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) 511.66KB 116.30KB
core (index.js) 5.30KB 2.13KB
create-plugin (index.js) 10.08KB 3.26KB
data-objectstack (index.js) 173.10KB 47.96KB
fields (index.js) 240.41KB 60.56KB
i18n (LocalizationContext.js) 1.76KB 0.96KB
i18n (currency.js) 1.22KB 0.64KB
i18n (fallbackInterpolation.js) 6.25KB 2.77KB
i18n (i18n.js) 4.28KB 1.75KB
i18n (index.js) 3.44KB 1.39KB
i18n (pickLocalized.js) 7.62KB 3.26KB
i18n (provider.js) 26.89KB 9.04KB
i18n (useDisplayLocale.js) 2.85KB 1.45KB
i18n (useObjectLabel.js) 33.40KB 8.71KB
i18n (useSafeTranslation.js) 5.60KB 2.33KB
layout (index.js) 38.95KB 10.97KB
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.55KB 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.72KB 0.42KB
mobile (useResponsiveConfig.js) 1.37KB 0.63KB
mobile (useSpecGesture.js) 4.32KB 1.64KB
mobile (useTouchTarget.js) 1.01KB 0.54KB
permissions (MePermissionsProvider.js) 9.53KB 3.38KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 4.64KB 1.50KB
permissions (evaluator.js) 5.12KB 1.74KB
permissions (index.js) 0.93KB 0.41KB
permissions (store.js) 0.91KB 0.42KB
permissions (useFieldPermissions.js) 1.28KB 0.53KB
permissions (usePermissions.js) 1.93KB 0.88KB
plugin-ai (index.js) 15.75KB 3.80KB
plugin-calendar (index.js) 46.89KB 12.91KB
plugin-charts (index.js) 64.66KB 18.32KB
plugin-chatbot (index.js) 190.33KB 45.10KB
plugin-dashboard (index.js) 133.44KB 34.48KB
plugin-designer (index.js) 212.87KB 43.19KB
plugin-detail (index.js) 245.43KB 62.45KB
plugin-editor (index.js) 2.46KB 1.10KB
plugin-form (index.js) 132.96KB 32.63KB
plugin-gantt (index.js) 165.20KB 40.37KB
plugin-grid (index.js) 201.53KB 54.54KB
plugin-kanban (index.js) 53.11KB 14.62KB
plugin-list (index.js) 113.11KB 27.58KB
plugin-map (index.js) 20.17KB 6.66KB
plugin-markdown (index.js) 13.72KB 4.69KB
plugin-report (index.js) 43.51KB 11.94KB
plugin-timeline (index.js) 26.98KB 7.78KB
plugin-tree (index.js) 9.00KB 3.08KB
plugin-view (index.js) 85.87KB 21.12KB
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.66KB 3.50KB
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) 73.09KB 24.34KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 2.44KB 1.21KB
react (schema-input.js) 2.32KB 1.24KB
react (spec-input.js) 0.20KB 0.18KB
sdui-parser (codegen.js) 5.41KB 2.34KB
sdui-parser (dashboard-widget-options.js) 3.08KB 1.30KB
sdui-parser (index.js) 4.93KB 2.24KB
sdui-parser (input-type.js) 2.84KB 1.40KB
sdui-parser (parse.js) 20.57KB 5.88KB
sdui-parser (provenance.js) 3.66KB 1.82KB
sdui-parser (types.js) 0.28KB 0.23KB
sdui-parser (validate.js) 10.35KB 3.60KB
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) 2.74KB 1.41KB
types (crud.js) 0.20KB 0.18KB
types (dashboard-filter-alias.js) 6.23KB 2.74KB
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 (feedback.js) 0.20KB 0.18KB
types (field-types.js) 0.20KB 0.18KB
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) 4.72KB 2.24KB
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 (spec-ui-namespace.js) 0.20KB 0.19KB
types (system-fields.js) 3.33KB 1.54KB
types (theme.js) 6.28KB 2.87KB
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

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.

finding(react): a non-object props is object-spread into indexed React props — props: "text" reaches the element as 0, 1, 2, …

2 participants