Skip to content

feat(types)!: retire ComponentInput.inputType as an ADR-0049 tombstone (objectui#5905, ruled option B) - #7639

Merged
os-warren merged 2 commits into
mainfrom
claude/issue-5905-component-input-unread-keys
Sep 4, 2026
Merged

feat(types)!: retire ComponentInput.inputType as an ADR-0049 tombstone (objectui#5905, ruled option B)#7639
os-warren merged 2 commits into
mainfrom
claude/issue-5905-component-input-unread-keys

Conversation

@claude

@claude claude Bot commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

Fixes #5905

Retires ComponentInput.inputType — the fifth and last key the card named — under the maintainer ruling of 2026-08-31 (director seat summon 6, decision batch 14), option B. Quoted verbatim and untranslated, as the ruling was given:

裁定:采选项 B —— inputType 退役补全,与四兄弟同款收口:

  1. 删除 plugin-markdown/src/index.tsx:60inputType: 'textarea' 写入(实测为 no-op:序列化器丢弃、全仓无读者——删之零能力损失);
  2. ComponentInput.inputType墓碑(同 min/max/step/placeholder 的已验证模式:声明保留、类型 never、Zod 镜像具名拒绝带处方——⛔ 不删除,non-strict object 下删除 = 静默剥离);
  3. index.test.ts:51 的钉从「断言写入」改指墓碑(断言拒绝);
  4. 顺手修上一批 changeset 里遗留的「removed」措辞。

The four ruled edits

  1. Deleted the no-op writeinputType: 'textarea' on plugin-markdown's content input.
  2. Tombstoned ComponentInput.inputType?: never on the interface (packages/types/src/base.ts) plus a retirementTombstone() named refusal on the Zod mirror (packages/types/src/zod/base.zod.ts), matching the four siblings member for member.
  3. Flipped three pins, never deleted them — plugin-markdown's index.test.ts (which asserted the write) and the two fork-half controls in component-input-retired-constraint-keys.test.ts, one type-level and one parse-level.
  4. Corrected the stale wording, which had the widest blast radius. See below.

Clause-②: YES — this changes the accept set

Stated plainly for review, because it is the whole point of the label:

  • Before: a document setting ComponentInput.inputType parsed GREEN, and the value was then dropped by the manifest serializer — a silent no-op.
  • After: it parses RED, with code: 'invalid_type', the key named in the issue path, and the migration note as the message.

That is a narrowing of a published type's member surface plus a new Zod refusal arm, so needs:contract-review is on both carriers and this PR stays a draft for the director seat. It is not enqueued.

Deleting the member outright stays the option NOT taken, for the reason the four siblings established and which this repo pins in one run: ComponentInputSchema is a non-strict z.object, so an undeclared key is silently stripped. The tombstone is what converts a write from outside this repository — the half the card could not measure — into a named refusal carrying its own remedy.

Option A, teaching sdui-parser to forward the key, is REFUSED on record: the only thing resembling demand for it was a write that had never taken effect. The neighbouring 2026-08-17 expression-ceiling ruling is untouched and stays deferred, reopen condition unchanged.

Measurement — re-taken on this branch's base, not inherited

The census, with a lit control. A structural scan of every inputs: array region in the repository (the only route to a ComponentInput value) over all tracked TS/TSX/JS sources: 211 regions. inputType scores exactly one authoring site — the plugin-markdown registration — plus one occurrence inside base.ts's own doc prose. The same pass over the same regions scores name 953, type 969, label 966, description 194, enum 119, required 86, binding 4, so the instrument was demonstrably not blind; min / max / step / placeholder score 0, consistent with their landed tombstones.

The other 192 in-repo inputType hits are a different face, excluded one by one rather than by eyeball: FormField.inputType (zod/form.zod.ts:195,566 and the JSON/doc examples that spell type: 'input' inside a fields: array), the text-input renderer's prop, SchemaBuilder.inputType (which writes a node schema, sibling to label and placeholder on the same builder), and the identifier inputTypeArms in sdui-parser. None sits on a ComponentInput.

The publication path, re-confirmed. packages/sdui-parser/src/index.ts forwards exactly six keys per input — name, type, required, enum, binding, description — so an authored inputType could not reach the published sdui.manifest.json even in principle. Deleting the write therefore costs zero capability.

Ablation — and which instrument actually holds the pin

Predictions were written down before the run; observed matched predicted exactly. The mutation restored all three halves (un-tombstoned the interface member and the mirror arm, put the plugin-markdown write back).

Mutation proved on disk before anything was measured: anchored counts for both the injected and the deleted text, plus blob-hash inequality against the HEAD blob for all three files. The types package was rebuilt on the mutation leg and a dist preflight confirmed dist/base.d.ts carried the mutation — necessary because vitest aliases @object-ui/types to source while plugin-markdown's tsconfig.test.json drops paths and resolves through the built declarations. Files stayed well-formed: the build passed and vitest collected 43 tests, so the reds below are failing assertions, not a failure to collect.

Instrument Predicted Observed
vitest — mirror refuses inputType (loop case) RED RED
vitest — inputType now parses RED RED RED
vitest — the five stay in the mirror's shape RED RED
vitest — plugin-markdown no longer authors it RED RED
vitest — the two type-level pins GREEN (erased at runtime) GREEN
tsc — types test program 1 error, TS2578 unused directive component-input-retired-constraint-keys.test.ts(141,7): error TS2578
tsc — plugin-markdown test program 1 error, TS2578 unused directive index.test.ts(81,9): error TS2578

The tombstone pin is held by type-check, not by vitest. A green vitest exit code says nothing about it; that row is in the table precisely so nobody reads it as evidence. The four sibling directives did not error on either leg, which is that leg's own non-vacuity control.

Both pin files were proved to be in their checked programs rather than assumed: tsc -p tsconfig.test.json --noEmit --listFiles lists component-input-retired-constraint-keys.test.ts among 561 program files and plugin-markdown/src/index.test.ts among 1674.

Restore proved two waysgit diff HEAD empty for all three paths, and blob-hash equality against the HEAD blob for each — and the types package was rebuilt on the restore leg as well, with a dist preflight confirming the marker is gone. Without that second rebuild the mutated declarations would have stayed in dist and every later measurement would have been taken against the wrong tree.

The stale wording, which is item 4's real payload

base.ts and zod/base.zod.ts both still said the fork was "recorded on objectui#5905 for a ruling; until then this stays a live, writable key". The 2026-08-31 ruling closed that fork. Anyone who greps the source instead of the comment thread met an open question that no longer existed — which is very close to how this card's previous dispatch went out with the wrong scope. Both now record the ruling.

One file beyond the brief, declared rather than slipped in: packages/types/src/widget.ts carried the same wording — it called inputType "the open fork objectui#5905 reported" and described the five as "ONE live key plus four unwritable ones". This change falsifies that sentence, so it is collateral of this diff rather than an unrelated tidy-up. Its doc block is pinned by __tests__/widget-input-control-vocabulary.test.ts, which requires the block to keep naming all five keys in backticks, to keep options / enum / ComponentInput, and to keep the phrase NOT NOW; the rewrite was checked against the test's own doc-block extraction and that test passes. No fence covers this file.

The old changeset's FROM → TO list said the four were "removed" when they were tombstoned — contradicting its own next paragraph. Corrected.

Fences — checked, not assumed

Verification — all at d3f4cca9, from the repo root

Exit codes captured by redirect, never through a pipe.

  • pnpm exec vitest run packages/types/ packages/plugin-markdown/106 files, 1760 tests passed
  • pnpm exec vitest run on zod-mirror-parity, widget-input-control-vocabulary, component-input-retired-constraint-keys and packages/plugin-markdown/7 files, 67 tests passed
  • pnpm exec turbo run type-check repo-wide — 81 successful, 81 total (the net that matters for a tombstone)
  • pnpm exec turbo run build — 44 successful, 44 total
  • pnpm lint repo-wide — exit 0, 0 errors (warnings are the pre-existing no-explicit-any / react-refresh population; the full scan was run rather than narrowed, so no narrowing needs declaring)
  • node scripts/check-changeset-presence.mjs — exit 0: "6 source file(s) of 2 released package(s) changed, and this change declares 1 changeset(s)"
  • check:control-bytes (6240 files scanned), check:sdui-registration-pins, check:skill-examples, check:published-tsconfig-exclude, check:doc-snippets (452 of 452 blocks judged), check:doc-types, check:readme-exports — all exit 0

Spec note: readings were taken against @objectstack/spec 17.2.0, which is what the lockfile resolves; nothing was bumped. 17.3.0 has shipped but changes nothing on ComponentInput.

Filed as its own card, deliberately out of scope here

objectui#7636 — the published skills/objectui/guides/plugin-development.md documents all five of these keys as writable optionals, and has been wrong about four of them since 2026-08-31, independently of this change. It is left alone deliberately: skills/** is a governed surface here and carries a line-count ratchet, and this dispatch carried no budget for it. The card also records the more interesting half — check:skill-examples judges that fence and stays green, because the snippet re-declares ComponentInput locally instead of importing it, so the gate compiles a private copy and cannot see the drift.


Generated by Claude Code

…NED, not removed

The FROM -> TO list in the objectui#5905 changeset said "removed" for all four
keys, contradicting the paragraph directly below it ("Deleting the members
outright was the option NOT taken") and describing the exact option the
maintainer ruled against: under a non-strict z.object a deleted key is silently
STRIPPED, which trades one silent no-op for another.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KbJQ1y1J12nZxYzFWhP8Q3
The fifth and last key objectui#5905 named, ruled by the maintainer on
2026-08-31 (option B). It was held back from the four-sibling retirement
because its defect was a different one: min/max/step/placeholder were
declared-and-UNREAD, while inputType was declared-and-DROPPED -- the repository
really did author it (plugin-markdown's `content` input) while the manifest
serializer dropped it, so retiring it had to rule on that registration first.

- delete the no-op `inputType: 'textarea'` write in plugin-markdown
- tombstone ComponentInput.inputType: `?: never` on the interface plus a
  retirementTombstone() named refusal on the Zod mirror, matching the four
  siblings exactly
- flip three pins rather than delete them: plugin-markdown's index.test.ts and
  the two fork-half controls in component-input-retired-constraint-keys.test.ts
- correct the stale "the fork is recorded ... until then this stays a live,
  writable key" wording in base.ts, base.zod.ts and widget.ts, which this
  change falsifies

Deleting the member outright stays the option NOT taken: ComponentInputSchema
is a non-strict z.object, so an undeclared key is silently stripped.

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

github-actions Bot commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

✅ Console Performance Budget

Metric Value Budget
Eager closure (gzip, 50 chunks) 3180.3 KB 3191.4 KB
Main entry chunk (gzip) 143.2 KB 350 KB
Entry file index-Dk3qfxHE.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) 15.67KB 5.75KB
app-shell (runtime-config.js) 20.68KB 7.36KB
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) 510.70KB 116.21KB
core (index.js) 6.12KB 2.42KB
create-plugin (index.js) 10.08KB 3.26KB
data-objectstack (index.js) 180.00KB 50.20KB
fields (index.js) 242.40KB 61.26KB
i18n (LocalizationContext.js) 1.76KB 0.96KB
i18n (builtinAggregateLabels.js) 0.86KB 0.49KB
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.65KB 1.47KB
i18n (pickLocalized.js) 7.62KB 3.26KB
i18n (provider.js) 26.89KB 9.04KB
i18n (useDisplayLocale.js) 2.85KB 1.45KB
i18n (useObjectLabel.js) 34.34KB 9.17KB
i18n (useSafeTranslation.js) 5.60KB 2.33KB
layout (index.js) 38.98KB 10.98KB
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) 2.53KB 0.85KB
mobile (useResponsive.js) 0.72KB 0.42KB
mobile (useSpecGesture.js) 4.32KB 1.64KB
mobile (useTouchTarget.js) 1.01KB 0.54KB
permissions (MePermissionsProvider.js) 11.71KB 4.29KB
permissions (PermissionContext.js) 0.31KB 0.25KB
permissions (PermissionGuard.js) 0.89KB 0.45KB
permissions (PermissionProvider.js) 6.24KB 2.16KB
permissions (discardProofCache.js) 1.04KB 0.55KB
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) 4.83KB 2.27KB
plugin-ai (index.js) 15.75KB 3.80KB
plugin-calendar (index.js) 48.09KB 13.34KB
plugin-charts (index.js) 70.92KB 19.75KB
plugin-chatbot (index.js) 196.19KB 46.43KB
plugin-dashboard (index.js) 132.86KB 34.68KB
plugin-designer (index.js) 212.86KB 43.19KB
plugin-detail (index.js) 250.59KB 64.06KB
plugin-editor (index.js) 2.46KB 1.10KB
plugin-form (index.js) 132.87KB 32.66KB
plugin-gantt (index.js) 167.40KB 41.05KB
plugin-grid (index.js) 210.75KB 56.95KB
plugin-kanban (index.js) 52.71KB 14.55KB
plugin-list (index.js) 113.28KB 27.59KB
plugin-map (index.js) 20.55KB 6.80KB
plugin-markdown (index.js) 13.70KB 4.68KB
plugin-report (index.js) 43.57KB 11.96KB
plugin-timeline (index.js) 30.84KB 8.85KB
plugin-tree (index.js) 9.38KB 3.22KB
plugin-view (index.js) 85.24KB 20.94KB
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) 81.07KB 26.86KB
react (data-invalidation.js) 5.05KB 2.08KB
react (index.js) 4.63KB 2.18KB
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 1.00KB
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.74KB 2.25KB
types (layout.js) 0.20KB 0.18KB
types (managed-by.js) 0.19KB 0.18KB
types (mobile.js) 4.58KB 2.23KB
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 (select-option.js) 0.20KB 0.19KB
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) 8.11KB 3.32KB
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

Copy link
Copy Markdown
Collaborator

Landing — contract review PASS at CONTRACT_REVIEW_TIER (card comment 5541469968). Ready, squash auto-merge armed.

Director seat, session session_01LsEjuNMPitCHwEfYftZ1um (os-warren), 13:5xZ.


Generated by Claude Code

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] ComponentInput's inputType/min/max/step/placeholder have no reader — the manifest serializer forwards six keys and none of them

2 participants