@ai-matrx/design-system 0.13.0 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,67 @@
 # Changelog
 
+## 0.14.0 — 2026-09-10
+
+### `ArchivedDisclosure` — the card-list half of the ONE archive control
+
+0.13.0 shipped `ArchiveFilter` and the platform still had two archive controls,
+because the frontend kept the other one: `components/official/ArchivedDisclosure`,
+the "Archived (N)" one-click reveal proven in Transcript Studio, invented the
+same day in a different repo. Arman's ruling is that the control is the same
+primitive EVERYWHERE (`common-docs/policies/archived-items.md`), so a second
+home for half of it is the defect, not a convenience.
+
+`ArchivedDisclosure` now lives here, ported VERBATIM from that file (including
+its `countLabel` and `keepWhileOpen` additions): a one-click "Archived (N)"
+disclosure, closed by default, rendering archived rows in place underneath —
+or, with `children` omitted, the toggle alone for a host that merges archived
+rows into its own table. `count` is always the true number of archived rows:
+at zero the control renders NOTHING rather than an empty promise, unless
+`keepWhileOpen` marks a surface whose open state IS the archive view (a server
+request), where the way back must never vanish. `countLabel` covers the two
+cases a bare integer cannot tell the truth about: a capped server count
+(`"50+"`) and a count that has not landed (`null` prints no parenthetical).
+
+**Two shapes, one vocabulary.** `ArchiveFilter` for table/browse surfaces whose
+reader takes an archive parameter; `ArchivedDisclosure` for card lists, panels
+and pickers that are not table shaped. Never a third. Both speak the single set
+of words, now exported from one module: `ArchiveFilterValue`,
+`ARCHIVE_FILTER_VALUES`, `DEFAULT_ARCHIVE_FILTER` (`active`),
+`ARCHIVE_FILTER_LABELS`, plus two new exports — `ARCHIVE_LABEL`, the ONE noun
+both controls print (`ARCHIVE_FILTER_LABELS.archived` is derived from it, so
+renaming it renames both by construction), and
+`archiveFilterFromDisclosure(open)`, which says a disclosure's state in the
+tri-state words (`open` → `all`, because a disclosure reveals archived rows
+BESIDE the live ones) for hosts whose toggle is a server request.
+
+Icons stay inlined (C19): lucide `chevron-down` and `archive` joined
+`src/icons.tsx`, so the port renders the same glyphs with no icon dependency.
+
+### Consumer action
+
+**matrx-frontend must delete `components/official/ArchivedDisclosure.tsx`** and
+repoint every importer to `@ai-matrx/design-system` — at the time of writing:
+`features/organizations/components/OrgResourceList.tsx`,
+`features/whatsapp-clone/conversation-list/ConversationListPane.tsx`,
+`features/pdf/scanner/components/desktop/ScannerDesktop.tsx`,
+`features/agents/agent-creators/templates/TemplatesGrid.tsx`,
+`features/canvas/core/SavedCanvasItems.tsx`,
+`features/page-extraction/components/SavedJobsList.tsx`,
+`features/transcript-studio/components/scribe/RecordingCardList.tsx`,
+`features/masterwork/browse/components/MasterworkBrowseCards.tsx`,
+`features/masterwork/home/MasterworkHomePage.tsx`,
+`features/masterwork/components/masterworks/MasterworksPage.tsx`,
+`features/masterwork/components/detail/RulebookDetailPage.tsx`,
+`features/hr/settings/fields/HrFieldsPanel.tsx`,
+`features/pdf-extractor/studio/PdfStudioSidebar.tsx`,
+`features/pdf-extractor/components/PdfExtractorWorkspace.tsx`.
+`lib/entity-list`'s Archived radio renders `<ArchiveFilter>` (its URL and
+preference plumbing is unchanged — only the control component is the package's),
+and `lib/entity-list`'s `ArchivedFilter` type is now an alias of
+`ArchiveFilterValue`. Every other host: a local "Archived (N)" toggle or a
+local tri-state archive segmented control is a twin — delete it and import
+these.
+
 ## 0.13.0 — 2026-09-09
 
 ### `ArchiveFilter` — THE ARCHIVED-ITEMS LAW made a control