This repository was archived by the owner on Nov 4, 2026. It is now read-only.
Repository navigation
Commit ca5d671
docs(types): the content-channel tombstones state the BaseSchema premise in the tense it is true (objectui#9933) (#10417)
Fixes #9933
Clause-②: no
`Clause-②: no` — JSDoc text only: every input's accept/reject verdict is
byte-identical before and after, and no published declaration, member or
export changes.
Implemented by the `os-dev` dispatched from `domain:ui` seat 2, session
`https://claude.ai/code/session_014mXUNuFomfj24w7s1pZzhN`
(`mode:subagent`). Base `a707197`, head `f30b2c8`.
## What changed
JSDoc comment text only, in
`packages/types/src/{ai,complex,data-display,disclosure,feedback,form,layout,navigation,objectql,overlay,reports,views}.ts`,
plus `.changeset/9933-stale-baseschema-premise-docblocks.md`
(`'@object-ui/types': patch`). Every changed diff line in the 12 source
files is a JSDoc continuation line (non-comment changed lines: 0), so no
declaration, member, type or export moves.
The stale premise came in two shapes. Each shape is byte-identical
across its sites. Each was rewritten by an exact-match replacement that
refused to write unless the per-file match count equalled the census
count:
| shape | sites | members | docblock header |
|---|---|---|---|
| A — "`body` and `children` are inherited-and-optional from {@link
BaseSchema}, whose own docblock admits …" | 137 | 67 `body?: never`, 70
`children?: never` | REFUSED BY NAME (objectui#9256) — reads NEITHER
content channel |
| B — "`body` is inherited-and-optional from {@link BaseSchema}, whose
own docblock admits …", with a line break between "whose own" and
"docblock admits" | 9 | `body?: never` on `box`, `span`, `container`,
`flex`, `stack`, `grid`, `scroll-area` (layout.ts), `form`, `toggle`
(form.ts) | REFUSED BY NAME (objectui#8284) — reads `children` |
Shape A now reads:
> Before objectui#9256 tombstoned them here, `body` and `children` were
both inherited-and-optional from {@link BaseSchema} — so authoring
either here type-checked, parsed green through `.passthrough()`, and
rendered NOTHING: no error, no warning, no element. objectui#6771 has
since retired `body` on `BaseSchema` itself; `BaseSchema` still declares
`children`, so this node's own tombstone is what refuses it here.
`SchemaRenderer` strips both keys out of the props bag it spreads, so
neither reaches the component by another route either.
Shape B now reads:
> Before objectui#8284 tombstoned it here, `body` was
inherited-and-optional from {@link BaseSchema} — so authoring it here
type-checked, parsed green through `.passthrough()`, and rendered an
EMPTY element with no error and no warning. Per component, the channel a
renderer does not read is now tombstoned on both published faces
(maintainer ruling, summon #17 decision batch #2, 2026-09-07), and
objectui#6771 has since retired `body` on `BaseSchema` itself.
Why this wording:
- Each statement stays inline on its own member. This follows the
reasoning of the objectui#9930 ruling C: no central block to cite, and
no extra jump for a declarations reader.
- The historical tail stays, written as history.
- The quote of `BaseSchema`'s former docblock is dropped rather than
moved into the past tense. `BaseSchema.children`'s own docblock already
records it ("This docblock used to read …").
- Each present-tense clause was checked on the base:
- `BaseSchema.body?: never` carries `@deprecated Retired spelling of
children`.
- `BaseSchema.children` is still declared as `SchemaNode |
SchemaNode[]`.
- `SchemaRenderer`'s metadata destructuring still strips `children` and
`body` before it spreads the props.
- All 137 shape-A headers name objectui#9256, and all 9 shape-B headers
name objectui#8284.
- Those tombstones predate PR objectui#9895 (objectui#6771), merged
2026-09-19T00:59Z, because the card counted them on that PR's head.
## Measurements — base `a707197` vs head `f30b2c8`
| instrument | pathspec | base | head |
|---|---|---|---|
| the card's line-bound `git grep -c "whose own docblock admits"` |
`packages/types/src` | 137 hits, 12 files | 0 (exit 1) |
| comment-joined "whose own docblock admits" (command 1) |
`packages/types/src` | 146 | 0 |
| comment-joined present tense "(are or is) inherited-and-optional from
{@link BaseSchema}" (command 1) | `packages/types/src` | 146 | 0 |
| comment-joined "whose own docblock admits" (command 2) | whole tree |
146 | 0 |
| comment-joined quote "some components use `children` instead of"
(command 2) | whole tree | 149 | 3, all out of surface, see Acceptance
notes |
| firing control `git grep -c "REFUSED BY NAME"` | `packages/types/src`
| 158 hits, 18 files | 158 hits, 18 files |
| absent-token control `qqzz_absent_token_9999` | `packages/types/src` |
0 | 0 |
| new text "has since retired `body` on `BaseSchema` itself;" / "…
itself." (command 1) | `packages/types/src` | 0 / 0 | 137 / 9 |
| the same new text in emitted `packages/types/dist/*.d.ts` after the
build | `dist` | — | 137 / 9 |
1 parent ff14e29 commit ca5d671
13 files changed
Lines changed: 1170 additions & 876 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
201 | 201 | | |
202 | 202 | | |
203 | 203 | | |
204 | | - | |
205 | | - | |
206 | | - | |
207 | | - | |
208 | | - | |
209 | | - | |
| 204 | + | |
| 205 | + | |
| 206 | + | |
| 207 | + | |
| 208 | + | |
| 209 | + | |
| 210 | + | |
| 211 | + | |
210 | 212 | | |
211 | 213 | | |
212 | 214 | | |
| |||
225 | 227 | | |
226 | 228 | | |
227 | 229 | | |
228 | | - | |
229 | | - | |
230 | | - | |
231 | | - | |
232 | | - | |
233 | | - | |
| 230 | + | |
| 231 | + | |
| 232 | + | |
| 233 | + | |
| 234 | + | |
| 235 | + | |
| 236 | + | |
| 237 | + | |
234 | 238 | | |
235 | 239 | | |
236 | 240 | | |
| |||
384 | 388 | | |
385 | 389 | | |
386 | 390 | | |
387 | | - | |
388 | | - | |
389 | | - | |
390 | | - | |
391 | | - | |
392 | | - | |
| 391 | + | |
| 392 | + | |
| 393 | + | |
| 394 | + | |
| 395 | + | |
| 396 | + | |
| 397 | + | |
| 398 | + | |
393 | 399 | | |
394 | 400 | | |
395 | 401 | | |
| |||
408 | 414 | | |
409 | 415 | | |
410 | 416 | | |
411 | | - | |
412 | | - | |
413 | | - | |
414 | | - | |
415 | | - | |
416 | | - | |
| 417 | + | |
| 418 | + | |
| 419 | + | |
| 420 | + | |
| 421 | + | |
| 422 | + | |
| 423 | + | |
| 424 | + | |
417 | 425 | | |
418 | 426 | | |
419 | 427 | | |
| |||
549 | 557 | | |
550 | 558 | | |
551 | 559 | | |
552 | | - | |
553 | | - | |
554 | | - | |
555 | | - | |
556 | | - | |
557 | | - | |
| 560 | + | |
| 561 | + | |
| 562 | + | |
| 563 | + | |
| 564 | + | |
| 565 | + | |
| 566 | + | |
| 567 | + | |
558 | 568 | | |
559 | 569 | | |
560 | 570 | | |
| |||
573 | 583 | | |
574 | 584 | | |
575 | 585 | | |
576 | | - | |
577 | | - | |
578 | | - | |
579 | | - | |
580 | | - | |
581 | | - | |
| 586 | + | |
| 587 | + | |
| 588 | + | |
| 589 | + | |
| 590 | + | |
| 591 | + | |
| 592 | + | |
| 593 | + | |
582 | 594 | | |
583 | 595 | | |
584 | 596 | | |
| |||
0 commit comments