Skip to content

fix(sdui): the curated contract lists record:line_items, the tag that actually resolves - #3006

Merged
os-zhuang merged 1 commit into
mainfrom
claude/react-lazy-block-scope-bpvef6
Jul 30, 2026
Merged

fix(sdui): the curated contract lists record:line_items, the tag that actually resolves#3006
os-zhuang merged 1 commit into
mainfrom
claude/react-lazy-block-scope-bpvef6

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Note on scope. The ask was to removeline_items from PUBLIC_BLOCKS, on my report that it was the one curated tag with nothing behind it. That report was wrong, and this PR does the opposite. See below — happy to swap it for the removal if the block genuinely shouldn't be in the contract, but that is now a product question rather than a cleanup.

line_items was never unimplemented

@object-ui/plugin-form registers it — full renderer, label, five declared inputs:

ComponentRegistry.register('line_items',LineItemsPanelRenderer,{namespace: 'record',skipFallback: true,// ← so the bare `line_items` key is deliberately NOT claimedlabel: 'Line Items',inputs: [/* childObject, relationshipField, columns, totalField, amountField */],});

skipFallback: true exists precisely to stop the bare name being claimed. PUBLIC_BLOCKS listed the bare line_items, so the curated entry resolved against a key that by design never exists.

Three things say the bare spelling was a slip, not an intent:

  • its four immediate siblings in the list are record:details, record:highlights, record:related_list, record:path;
  • plugin-form's own comment above the registration reads "Register record:line_items";
  • record:line_items is what app-shell's own test fixtures use.

What it cost

A block that has shipped all along was absent from the public contract, the JSX type surface, the generated sdui.manifest.json, and every kind:'react' page's scope. An author writing <RecordLineItems> got a ReferenceError; one writing <record:line_items> in a kind:'html' page got the tag rejected.

It presented as an aspirational entry, which is exactly how #2979's contract-coverage guard recorded it — EXPECTED_UNIMPLEMENTED = ['line_items']. The guard did its job (it made the gap visible and reviewable); I misread what the gap was.

Verified

MISSING >>> []
LINE_ITEMS >>> { found: true, inputs: 5, label: "Line Items" }

All 36 curated tags now resolve in the console. EXPECTED_UNIMPLEMENTED is now [] and stays asserted, so the next entry that cannot resolve surfaces rather than getting explained away as aspirational.

  • Full suite: 716 files passed | 1 skipped, 8373 tests passed | 24 skipped.
  • lint + type-check for @object-ui/core and @object-ui/console: 38/38 tasks successful.
  • changeset:check: clean. Changeset included.

If you still want it removed

One line in packages/core/src/registry/public-blocks.ts plus moving the tag out of EXPECTED_COVERED in the console guard. Worth deciding on the merits now that it's clear the choice is "should this shipped block be part of the AI-authoring vocabulary", not "should we stop advertising something that doesn't exist".

🤖 Generated with Claude Code

https://claude.ai/code/session_01N4mrr1ihhwnfEHFSWmGoMp


Generated by Claude Code

… actually resolves
PUBLIC_BLOCKS carried `line_items` — the bare tag. @object-ui/plugin-form
registers the block as `record:line_items` with `skipFallback: true`, which
exists precisely so the bare name is NOT claimed, so that key never existed and
the curated entry could never resolve. Its four siblings in the list are all
`record:`-prefixed and plugin-form's own comment says "Register
record:line_items"; the bare spelling was a slip.
The effect was a block that has shipped all along — a full renderer, a label,
five declared inputs — being absent from the public contract, from the JSX type
surface, from the generated manifest, and from every kind:'react' page's scope.
It read as an unimplemented aspirational entry, which is how it was recorded
when #2979 added the contract-coverage guard.
With the tag corrected the contract has no gaps left: all 36 curated tags
resolve in the console, record:line_items among them with its full inputs. The
guard's known-unimplemented list is now empty and stays asserted, so the next
entry that cannot resolve surfaces instead of being explained away.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01N4mrr1ihhwnfEHFSWmGoMp
@vercel

vercelBot commented Jul 30, 2026

Copy link
Copy Markdown

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

1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
objectuiIgnoredIgnoredJul 30, 2026 9:17am

Request Review

@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

MetricValueBudget
Main entry (gzip)27.9 KB350 KB
Entry fileindex-9qCs4DZ1.js
StatusPASS

📦 Bundle Size Report

PackageSizeGzipped
app-shell (index.js)8.20KB2.97KB
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.12KB3.41KB
auth (LoginForm.js)17.86KB5.29KB
auth (PreviewBanner.js)0.90KB0.50KB
auth (RegisterForm.js)6.43KB2.09KB
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.25KB1.01KB
auth (org-roles.js)6.72KB2.85KB
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)18.38KB4.49KB
collaboration (LiveCursors.js)3.17KB1.27KB
collaboration (PresenceAvatars.js)3.65KB1.42KB
collaboration (PresenceProvider.js)2.79KB1.13KB
collaboration (index.js)1.25KB0.53KB
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)454.35KB99.16KB
core (index.js)2.16KB0.78KB
create-plugin (index.js)9.28KB2.98KB
data-objectstack (index.js)134.67KB34.24KB
fields (index.js)221.10KB54.18KB
i18n (LocalizationContext.js)1.76KB0.96KB
i18n (currency.js)1.22KB0.64KB
i18n (i18n.js)4.32KB1.77KB
i18n (index.js)2.46KB0.96KB
i18n (pickLocalized.js)1.70KB0.83KB
i18n (provider.js)5.37KB1.72KB
i18n (useObjectLabel.js)25.17KB5.80KB
i18n (useSafeTranslation.js)3.26KB1.44KB
layout (index.js)38.45KB10.67KB
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)4.42KB1.27KB
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)1.77KB0.77KB
mobile (useTouchTarget.js)1.01KB0.54KB
permissions (MePermissionsProvider.js)6.84KB2.42KB
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)44.90KB12.35KB
plugin-charts (index.js)57.26KB16.24KB
plugin-chatbot (index.js)180.09KB42.72KB
plugin-dashboard (index.js)110.24KB28.47KB
plugin-designer (index.js)210.56KB42.56KB
plugin-detail (index.js)216.52KB53.02KB
plugin-editor (index.js)2.46KB1.10KB
plugin-form (index.js)103.79KB25.15KB
plugin-gantt (index.js)162.26KB39.53KB
plugin-grid (index.js)180.80KB47.40KB
plugin-kanban (index.js)47.82KB13.18KB
plugin-list (index.js)99.43KB23.54KB
plugin-map (index.js)16.80KB5.24KB
plugin-markdown (index.js)13.65KB4.67KB
plugin-report (index.js)40.24KB10.51KB
plugin-timeline (index.js)25.03KB7.11KB
plugin-tree (index.js)8.36KB2.81KB
plugin-view (index.js)85.88KB20.99KB
providers (DataSourceProvider.js)0.75KB0.39KB
providers (MetadataProvider.js)1.37KB0.59KB
providers (ThemeProvider.js)1.55KB0.67KB
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)19.28KB6.38KB
react (data-invalidation.js)5.05KB2.08KB
react (index.js)1.02KB0.55KB
sdui-parser (codegen.js)4.09KB1.74KB
sdui-parser (index.js)3.47KB1.54KB
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 (data-display.js)0.20KB0.18KB
types (data-protocol.js)0.20KB0.19KB
types (data.js)0.20KB0.18KB
types (designer.js)0.77KB0.41KB
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 (index.js)2.00KB0.96KB
types (layout.js)0.20KB0.18KB
types (managed-by.js)0.19KB0.18KB
types (mobile.js)0.20KB0.18KB
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.04KB1.93KB
types (system-fields.js)2.39KB1.17KB
types (theme.js)0.20KB0.18KB
types (ui-action.js)1.08KB0.64KB
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 July 30, 2026 09:50
@os-zhuang
os-zhuang merged commit d10f526 into mainJul 30, 2026
16 checks passed
@os-zhuang
os-zhuang deleted the claude/react-lazy-block-scope-bpvef6 branch July 30, 2026 09:50
os-zhuang added a commit that referenced this pull request Jul 30, 2026
…#3006 (#3013)
The console guard only looked one way: every tag in PUBLIC_BLOCKS must resolve.
That direction cannot tell "not built yet" from "built, but the contract spells
it wrong" — so record:line_items was filed as a known gap for a release while
its renderer shipped, fully configured, in plugin-form.
Two checks close the other direction.
Every shipped record:* block is curated, or listed with a reason. Seven are
deliberately out, each declaring zero inputs — nothing for an author or a model
to configure. A new record:* registration now fails until someone decides which
side it belongs on, so the vocabulary cannot quietly drift from what the
platform can render. A companion assertion pins those seven at zero inputs (and
at being eager registrations, so a lazy stub's "not known yet" cannot make it
vacuous), letting one that grows a configurable surface re-open the decision
instead of inheriting the exclusion.
A curated tag that near-misses a registered block. `line_items` vs
`record:line_items` differ only by namespace; one of the two spellings is
always a typo. The check reports the candidate — "also try record:line_items" —
rather than just "not covered".
Both were verified against the real bug: reverting the tag to `line_items`
fails them with exactly that diagnosis.
Deduping the registry surfaced a second, latent issue — eleven record:* blocks
in plugin-detail are registered as register('record:x', …, {namespace:'record'}),
prefixing an already-prefixed name and yielding doubled record:record:x keys.
It does not reach the contract (getPublicConfigs rewrites type to the curated
tag), so this change only documents it where the deduping happens; the
registrations are left for a separate change.
Claude-Session: https://claude.ai/code/session_01N4mrr1ihhwnfEHFSWmGoMp
Co-authored-by: Claude <noreply@anthropic.com>
os-zhuang added a commit that referenced this pull request Jul 30, 2026
#3023)
Eleven blocks in plugin-detail were registered as
register('record:x', …, { namespace: 'record' }) — an already-prefixed name
handed to a registry that prefixes it again. Each landed at record:record:x,
and the key authors actually resolved, record:x, was the un-namespaced
FALLBACK rather than the intended registration. The registry carried 23 keys
for 12 components.
Nothing failed, which is why it survived: getPublicConfigs() rewrites `type` to
the curated tag, so the doubled name never reached the contract, the manifest,
or the JSX surface. It was visible only when enumerating the registry directly
— which is what #3013's reverse check does.
Registering the bare name is what makes `namespace` correct, and
skipFallback: true is what keeps the fallback from claiming that bare name
globally. Without it these would take over `details`, `path`, `history`,
`alert` … as top-level tags; `alert` is the live case, owned by ui:. Every
block stays reachable exactly as record:<name>, and 23 keys become 12.
record:line_items needed no change — it was the one already registered this
way, which is what made #3006's near-miss possible in the first place.
Two console assertions hold the shape: no key carries a doubled prefix, and no
record:* block owns the bare spelling of its own name. Both were verified
against the old form: restoring one registration fails them with the phantom
key named.
Claude-Session: https://claude.ai/code/session_01N4mrr1ihhwnfEHFSWmGoMp
Co-authored-by: Claude <noreply@anthropic.com>
os-zhuang added a commit that referenced this pull request Jul 30, 2026
…ks, and curate six (#3027)
Seven record:* blocks shipped with renderers that read props but declared no
inputs. That combination is the worst of both: the renderer honours `limit`,
`severity`, `location` …, while every authoring surface — the designer panel,
the AI vocabulary, the generated manifest — reports the block takes no
configuration. #3013 recorded them as deliberately uncurated for exactly that
reason.
The declarations mirror what each renderer actually reads:
record:activity 11 from RecordActivityComponentProps
record:chatter 5 from RecordChatterComponentProps
record:discussion 5 (same renderer, same inputs)
record:alert 8 severity, title, body, visible, icon, action,
dismissible, dismissKey
record:quick_actions 7 actionNames, requiredPermissions, location, align,
inline, variant, size
record:history 3 limit, emptyText, unknownUserText
record:reference_rail 1 hideEmpty
inputs describe what an AUTHOR writes, which is a subset of what the renderer
reads. `entries`, `loading` and resolved `actions` are injected by the host
shell off RecordContext; declaring them would invite a model to hand-write the
data the page is supposed to fetch. `aria` is omitted for the reason it is
omitted on record:details — an accessibility escape hatch, not a layout choice.
`location` takes its enum from the spec's ACTION_LOCATIONS rather than
restating it, per #3019.
Six of the seven join PUBLIC_BLOCKS: configurable and absent from the contract
is the state #3006 was about. The contract goes 36 -> 42 tags, all resolving.
record:chatter stays out — same renderer as record:discussion under a
Salesforce-familiar name, kept for schemas already in the wild. Two spellings
of one block is ambiguity an authoring model cannot resolve, so the vocabulary
carries the spec's name. A test compares the two input lists, so the day they
diverge the exclusion stops being justified and fails.
A companion assertion requires every curated record:* tag to declare inputs. A
curated tag with none reads as "takes no configuration" when the renderer in
fact reads props — the same gap #3006 opened, pointed the other way.
Claude-Session: https://claude.ai/code/session_01N4mrr1ihhwnfEHFSWmGoMp
Co-authored-by: Claude <noreply@anthropic.com>
os-zhuang added a commit that referenced this pull request Jul 30, 2026
…he public contract (#3069)
The AI-authoring vocabulary and the Studio page designer disagreed by thirteen
blocks: PUBLIC_BLOCKS carried one page: tag and one element: tag while the
designer palette — and @objectstack/spec's page schema — offered the whole
families. A block a human can drag in Studio was invisible to a model writing
the same page, which is the #3006 state at 10x the scale.
Fifteen tags join the contract (42 -> 57), every one shipping a renderer with
declared inputs (#3065):
page: tabs, card, accordion, section, footer, sidebar
element: text, number, button, definition-list, repeater
action: button, group, menu, icon
Five stay out, each with its reason recorded and guarded: action:bar
(record:quick_actions covers the record action strip; the spec blesses the
other four), element:image (duplicates the curated `image` — one spelling per
concept), and element:record_picker / element:text_input /
element:metadata_viewer (mirroring the Studio palette's own PALETTE_EXCLUSIONS,
so the two vocabularies stay out for the same reasons rather than by
coincidence).
The console's reverse-coverage guard now sweeps all four semantic namespaces
instead of record: alone — checking only the namespace you just fixed is
exactly how the last 22 doubled keys went unnoticed (#3037). A new prop-less
allowlist (element:divider, page:section, page:footer, page:sidebar) keeps
"declares no inputs" a pinned decision in both directions: those four must
stay at zero, everything else curated must declare a surface.
Verified by mutation: dropping action:menu from the list fails the sweep with
exactly that tag named.
Claude-Session: https://claude.ai/code/session_01N4mrr1ihhwnfEHFSWmGoMp
Co-authored-by: Claude <noreply@anthropic.com>
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.

2 participants

@os-zhuang@claude