Repository navigation
finding(types): KanbanCard / KanbanColumn are declared four times in this tree and the published copies disagree (cards vs items, badges vs labels) #6155
Description
Measured on origin/main 228909995 while sweeping #6086 (prose restatements of a declared surface). Filed unassigned, not fixed — out of that card's scope, which owns docs prose, not the declarations underneath it.
The fact
Four declarations of each name coexist:
| file | KanbanColumn members |
KanbanCard notable members |
|---|---|---|
packages/plugin-kanban/src/types.ts:15,49 |
id, title, cards, limit, className |
badges |
packages/plugin-kanban/src/KanbanImpl.tsx:51,81 |
id, title, cards, limit, className |
badges, cardSubtitle, cardFieldCells, coverImage |
packages/plugin-kanban/src/KanbanEnhanced.tsx:36,50 |
id, title, cards, limit, className, collapsed |
badges, coverImage |
packages/types/src/complex.ts:28,58 |
id, title, **items**, color, limit, collapsed |
labels, assignees, dueDate, priority, content, data |
The last row is the divergent one, and both sides are published:
@object-ui/plugin-kanbanre-exports its own copy —packages/plugin-kanban/src/index.ts:111exportsKanbanCard,KanbanColumnfrom./types.@object-ui/typesexports thecomplex.tscopy under the same two names.
So a consumer who writes import type { KanbanColumn } from '@object-ui/types' gets a shape whose rows live under items, and a consumer who imports the same name from @object-ui/plugin-kanban gets one whose rows live under cards. Neither import is wrong; they are different types wearing one name.
Why it is worth recording
It is not only a consumer hazard. It makes the name undecidable for any tool keyed on it. This was measured directly: a name-to-declaration resolver built for the #6086 sweep reported content/docs/plugins/plugin-kanban.mdx's cards and badges rows as contradicted keys, because it resolved KanbanColumn / KanbanCard to the @object-ui/types copy. The page is correct — it documents the plugin's own copy — and the false verdict came entirely from the ambiguity. Any future gate that checks a documented key list against "the declaration of that name" walks into the same wall here, and the failure mode is a confident wrong answer rather than an abstention.
Not decided here
Whether the fix is to collapse onto one declaration, to rename one side, or to leave two deliberately distinct shapes with distinct names, is a design call — the @object-ui/types copy carries object-driven-board fields (assignees, dueDate, priority) the plugin copy does not, so they may not be the same concept at all. Recording the measurement so the choice is made deliberately.
Reproduce
grep -rn "interface KanbanColumn\|interface KanbanCard" packages/*/src --include=*.ts --include=*.tsx
grep -n "KanbanCard, KanbanColumn" packages/plugin-kanban/src/index.ts
Refs: #6086 (where this was measured).
Generated by Claude Code
Activity
claude commentedon Aug 25, 2026
Triage state repair (concentrated round, mechanical):
findingmeans awaiting first grading, and this card is already graded into another pm-state — removing the stalefindinglabel so the ungraded count stays honest. No other change.Generated by Claude Code
os-steve commentedon Aug 25, 2026
Ruling inheritance note (triage): the family decision this card was sequenced behind is now ruled — 2026-08-25 maintainer ruling 甲/A1 on #6172 (verbatim: 「同意」): every exported schema name has exactly one authority; in-package multi-declarations converge to one exported declaration with internal variants renamed or derived; package qualifiers are measured out as a remedy.
KanbanCard/KanbanColumn(this card's four disagreeing declarations) are named members of that ruling. Stayspm:blockedbehind #6172 per the seat's sequencing — the unlock scan returns this card when #6172's Kanban half lands; re-verify the four declaration sites on the merged ref then.Generated by Claude Code
claude commentedon Sep 4, 2026
Blocked-by: #6172
Canonical unblock line added on the #7041 census (objectui#7674); the blocker is as the card states above — no state change.
Generated by Claude Code