Skip to content

feat(record): declare inputs for the seven configurable record:* blocks, and curate six - #3027

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

feat(record): declare inputs for the seven configurable record:* blocks, and curate six#3027
os-zhuang merged 1 commit into
mainfrom
claude/react-lazy-block-scope-bpvef6

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

The seven blocks #3013 parked as "no declared inputs" turned out to read props all along — the declarations were simply missing. That combination is the worst of both: the renderer honours limit, severity, location …, while every authoring surface (designer panel, AI vocabulary, generated manifest) reports the block takes no configuration.

What each renderer actually reads

Derived from the renderers and from @object-ui/types, not invented:

block inputs source
record:activity 11 RecordActivityComponentProps
record:chatter / record:discussion 5 RecordChatterComponentProps
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

What was deliberately left out

inputs describe what an author writes, which is a strict subset of what the renderer reads:

  • entries, loading, resolved actions — 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 — omitted for the same reason it is omitted on record:details: an accessibility escape hatch, not a layout choice.
  • className — styling pass-through, not declared on any sibling.

location takes its enum from the spec's ACTION_LOCATIONS rather than restating the seven values, per #3019.

Six get curated, one does not

Configurable and absent from the contract is precisely the state #3006 was about, so six join PUBLIC_BLOCKS. The contract goes 36 → 42, all resolving:

record:details 4 · record:highlights 2 · record:related_list 9 · record:path 2
record:line_items 5 · record:activity 11 · record:discussion 5 · record:history 3
record:quick_actions 7 · record:reference_rail 1 · record:alert 8

record:chatter stays out. It is the 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 has no way to resolve, so the vocabulary carries the spec's name.

That exclusion is now falsifiable rather than asserted: a test compares the two input lists, so the day they diverge, chatter is its own block being kept out of the vocabulary — the exact state this file exists to catch — and it fails.

New guard, pointing the other way

Every curated record:* tag must declare inputs. A curated tag with none reads as "this block takes no configuration" when the renderer in fact reads props — the same gap #3006 opened, mirrored. Curation and a configuration surface travel together.

The old keeps the deliberately-uncurated blocks unconfigurable assertion is gone with the reason it encoded.

Full suite 733 passed | 1 skipped, lint 0 errors, type-check 40/40, changeset included.

🤖 Generated with Claude Code

https://claude.ai/code/session_01N4mrr1ihhwnfEHFSWmGoMp


Generated by Claude Code

…ks, and curate six

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.

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

vercel Bot commented Jul 30, 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 Jul 30, 2026 11:29am

Request Review

@github-actions

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

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

📦 Bundle Size Report

Package Size Gzipped
app-shell (index.js) 8.20KB 2.97KB
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.12KB 3.41KB
auth (LoginForm.js) 17.86KB 5.29KB
auth (PreviewBanner.js) 0.90KB 0.50KB
auth (RegisterForm.js) 6.43KB 2.09KB
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.25KB 1.01KB
auth (org-roles.js) 6.72KB 2.85KB
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) 18.38KB 4.49KB
collaboration (LiveCursors.js) 3.17KB 1.27KB
collaboration (PresenceAvatars.js) 3.65KB 1.42KB
collaboration (PresenceProvider.js) 2.79KB 1.13KB
collaboration (index.js) 1.25KB 0.53KB
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) 458.27KB 100.20KB
core (index.js) 2.16KB 0.78KB
create-plugin (index.js) 9.28KB 2.98KB
data-objectstack (index.js) 134.67KB 34.24KB
fields (index.js) 222.07KB 54.35KB
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.46KB 0.96KB
i18n (pickLocalized.js) 1.70KB 0.83KB
i18n (provider.js) 5.37KB 1.72KB
i18n (useObjectLabel.js) 25.17KB 5.80KB
i18n (useSafeTranslation.js) 3.26KB 1.44KB
layout (index.js) 38.45KB 10.67KB
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.05KB 1.53KB
mobile (useTouchTarget.js) 1.01KB 0.54KB
permissions (MePermissionsProvider.js) 6.84KB 2.42KB
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) 44.90KB 12.35KB
plugin-charts (index.js) 60.52KB 17.11KB
plugin-chatbot (index.js) 180.09KB 42.72KB
plugin-dashboard (index.js) 111.59KB 28.74KB
plugin-designer (index.js) 210.56KB 42.56KB
plugin-detail (index.js) 221.50KB 54.15KB
plugin-editor (index.js) 2.46KB 1.10KB
plugin-form (index.js) 104.83KB 25.30KB
plugin-gantt (index.js) 162.26KB 39.53KB
plugin-grid (index.js) 180.86KB 47.45KB
plugin-kanban (index.js) 47.82KB 13.18KB
plugin-list (index.js) 102.39KB 24.18KB
plugin-map (index.js) 16.80KB 5.24KB
plugin-markdown (index.js) 13.65KB 4.67KB
plugin-report (index.js) 40.32KB 10.53KB
plugin-timeline (index.js) 25.75KB 7.32KB
plugin-tree (index.js) 8.36KB 2.81KB
plugin-view (index.js) 85.91KB 20.99KB
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) 19.28KB 6.38KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 1.02KB 0.55KB
sdui-parser (codegen.js) 4.09KB 1.74KB
sdui-parser (index.js) 3.47KB 1.54KB
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) 0.77KB 0.41KB
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 (index.js) 2.00KB 0.96KB
types (layout.js) 0.20KB 0.18KB
types (managed-by.js) 0.19KB 0.18KB
types (mobile.js) 0.20KB 0.18KB
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.04KB 1.93KB
types (system-fields.js) 2.39KB 1.17KB
types (theme.js) 0.20KB 0.18KB
types (ui-action.js) 1.08KB 0.64KB
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

@os-zhuang
os-zhuang marked this pull request as ready for review July 30, 2026 11:36
@os-zhuang
os-zhuang merged commit 390c071 into main Jul 30, 2026
16 checks passed
@os-zhuang
os-zhuang deleted the claude/react-lazy-block-scope-bpvef6 branch July 30, 2026 11:36
os-zhuang added a commit that referenced this pull request Jul 30, 2026
…element:* blocks (#3065)

Same gap #3027 closed for record:*, in the two namespaces next door: renderers
that read real props while every authoring surface reported "takes no
configuration". Declarations mirror what each renderer reads —

  page:tabs                items, tabStyle (line/card/pill), position (top/left)
  page:card                title, bordered, body (slot), footer (slot)
  page:accordion           items, allowMultiple, variant (flush/card)
  element:text             content, variant, align
  element:number           object, aggregate, field, filter, format, prefix, suffix
  element:button           label, action (inline ActionDef), variant, size, icon,
                           iconPosition, disabled
  element:definition-list  items, columns, inline
  element:repeater         object, titleField, fields, filter, sort, limit,
                           emptyText, divided

page:section, page:footer and page:sidebar stay at zero inputs on purpose:
their renderers render children/body and nothing else — like element:divider,
they are genuinely prop-less containers, and inventing inputs for them would be
the opposite falsehood.

aria and className stay undeclared throughout, per the convention on
record:details: escape hatches and styling pass-throughs, not authoring
choices. element:button's registration also documents the split against
action:button — inline ActionDef vs a declared action referenced by name — so
the two stop reading as duplicates.

Declaration only; no renderer behavior changes. Curation (which of these join
PUBLIC_BLOCKS) is a separate change.


Claude-Session: https://claude.ai/code/session_01N4mrr1ihhwnfEHFSWmGoMp

Co-authored-by: Claude <noreply@anthropic.com>
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.

2 participants