@ai-matrx/design-system 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,54 @@
 # Changelog
 
+## 0.3.0 — 2026-08-29
+
+The second C18 growth wave: the three primitive families the associations
+package's W4 faces are blocked on. Verbatim behavior ports from
+matrx-frontend with only coupling seams inverted.
+
+New components (origin file in matrx-frontend):
+
+- `Command`, `CommandInput`, `CommandList`, `CommandItem`, `CommandGroup`,
+  `CommandEmpty`, `CommandSeparator`, `CommandShortcut`, `CommandDialog` —
+  `components/ui/command.tsx`. **`cmdk` is a sanctioned real dependency**
+  (the vaul ↔ BottomSheet precedent): its filtering/scoring/keyboard engine
+  IS the component's product; reimplementing it would twin a maintained
+  library. `CommandDialog` composed the host dialog module — those pieces
+  (modal context, overlay, desktop card / mobile bottom-sheet geometry,
+  close control) are inlined privately with identical behavior; the host's
+  popout-aware portal became the `PortalContainerProvider` seam plus an
+  explicit `container` prop; the host `useIsMobile` matchMedia hook (768px,
+  browser-generic) is inlined privately.
+- `Select`, `SelectGroup`, `SelectValue`, `SelectTrigger`, `SelectContent`,
+  `SelectLabel`, `SelectItem`, `SelectSeparator`, `SelectScrollUpButton`,
+  `SelectScrollDownButton` (+ `selectTriggerVariants`, `SelectTriggerProps`)
+  — `components/ui/select.tsx`, with **`@radix-ui/react-select`** as a real
+  dependency (^2.3.1, the host's installed version). The host's
+  `useNestedPortalContainer` became the `PortalContainerProvider` seam;
+  the explicit `container` prop keeps top priority. The origin's dead
+  `CaretSortIcon` import was not carried along.
+- `CreatablePicker` + `CreatableOption` / `CreatablePickerProps` /
+  `PickerIcon` — `components/ui/creatable-picker.tsx`, the P23 "every
+  picker takes new input" composite, ported complete (create flow,
+  `onCreateRequiresMore`, `createExtra` slot, P11 `lockedNote`/`lockedAction`,
+  the manage door, `footerActions`, `renderSelected`). It composes the
+  package's own Popover + Command; the host `LucideIcon` type became the
+  structural `PickerIcon`. It still never grows a write path of its own —
+  `onCreate` stays the caller's ONE canonical write path.
+
+All icons the originals drew (radix `MagnifyingGlass`/`Check`/`ChevronUp`/
+`ChevronDown`, lucide `check`/`chevrons-up-down`/`external-link`/`lock`/
+`plus`/`x`) are shipped as package-inlined SVGs of the same glyphs (C19 —
+no icon-library dependency, ever).
+
+Tests: +18 (54 total) — cmdk filtering/keyboard-nav/disabled-skip,
+CommandDialog modal + portal seam, Select pointer open/select + keyboard +
+portal seam, CreatablePicker type-ahead/create/empty-add-guard/exact-match/
+requires-more/P11-lock/doors, and SSR renders for all three families. The
+tarball canary imports AND requires the new surface.
+
+New dependencies: `cmdk` (^1.1.1), `@radix-ui/react-select` (^2.3.1).
+
 ## 0.2.0 — 2026-08-29
 
 The associations-W4 growth wave (ruling C18: the faces' chrome comes from