@ai-matrx/design-system 0.1.1 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,106 @@
 # 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
+growing this package — never vendored twins) plus the small-package register
+rows that ride design-system (S16–S21). Every component is a verbatim
+behavior port from matrx-frontend with only its coupling seams inverted.
+
+New components (origin file in matrx-frontend):
+
+- `Input`, `EnterInput`, `BasicInput`, `InputWithPrefix` — `components/ui/input.tsx`.
+  The host's `MatrxVariant` became the structural `InputVariant` union. The
+  original file's `CopyInput`/`FancyInput`/`DeleteInput` are deliberately NOT
+  absorbed (C8): they carry a `motion/react` dependency plain-Input consumers
+  must not pay for.
+- `Popover`, `PopoverTrigger`, `PopoverAnchor`, `PopoverContent` —
+  `components/ui/popover.tsx`. The host's `useNestedPortalContainer` hook
+  became the injected `PortalContainerProvider` / `usePortalContainer` seam;
+  the explicit `container` prop keeps top priority.
+- `Sheet` family (+ `sheetVariants`) — `components/ui/sheet.tsx`. The host
+  dialog module's `DialogContentPrimitive` is inlined as a private equivalent;
+  `RadixDialogModalProvider`/`useRadixDialogModal` ported verbatim from
+  `components/ui/radix-dialog-modal-context.tsx`; `treeContainsComponent`
+  stays the one `@ai-matrx/kit/react-tree` implementation (new peer).
+- `Skeleton` — `components/ui/skeleton.tsx`.
+- `EditableLabel` (S16) — `components/official/item/EditableLabel.tsx`, with
+  its prop types carried along instead of the host item-system `types.ts`.
+- `SegmentedControl` (S17) — `components/ui/segmented-control.tsx`.
+- `ScoreRing` + `scoreRingColorClasses` / `scoreAccentBgClasses` /
+  `DEFAULT_SCORE_THRESHOLDS` (S18) — `components/official/ScoreRing.tsx`.
+  The score→color thresholds are the product and port unchanged.
+- `BottomSheet` family + `TabbedBottomSheet` (S19) —
+  `components/official/bottom-sheet/`. `vaul` is a sanctioned real dependency
+  (see FEATURE.md); the host drawer wrappers it needed are inlined privately.
+- `OverflowToolbar` (S20) — `components/official/toolbar/OverflowToolbar.tsx`.
+  `LucideIcon` became the structural `ToolbarIcon`; the host Tooltip and
+  ItemMenu became the injected `renderTooltip` / `renderOverflowMenu` seams.
+- `useScrollFade` (S21) — `components/official/scroll-fade/useScrollFade.ts`.
+
+All icons the originals drew through lucide-react / @radix-ui/react-icons are
+shipped as package-inlined SVGs of the same glyphs (policy C19 — no
+icon-library dependency, ever).
+
+Packaging (2026-08-29 authoring rules):
+
+- Dual ESM + CJS output with matching `.d.ts`/`.d.cts`; the packed-tarball
+  canary now imports AND requires the public surface.
+- The `"use client"` boundary is stamped via the tsup banner (treeshake off so
+  it survives) and asserted on both built entries from the packed tarball.
+
+New dependencies: `@radix-ui/react-dialog`, `@radix-ui/react-popover`,
+`@radix-ui/react-visually-hidden`, `vaul`; new peer: `@ai-matrx/kit` (>=0.5.1).
+
 ## 0.1.1 — 2026-08-22
 
 - Preserved the package-level `"use client"` boundary in the built ESM entry so

package/README.md

@@ -1,6 +1,6 @@
 # @ai-matrx/design-system
 
-The small, semantic UI foundation shared by AI Matrx React applications. Version 0.1 contains the first primitives whose behavior and variants are identical across Vite and Next.js hosts: Button, Badge, Label, Separator, and the `cn` utility.
+The small, semantic UI foundation shared by AI Matrx React applications — primitives whose behavior and variants are identical across Vite and Next.js hosts. Version 0.2 ships Button, Badge, Label, Separator, the Input family, Popover, Sheet, Skeleton, EditableLabel, SegmentedControl, ScoreRing, BottomSheet + TabbedBottomSheet, OverflowToolbar, the `useScrollFade` hook, and the `cn` utility.
 
 ```bash
 pnpm add @ai-matrx/design-system
@@ -13,7 +13,9 @@ import { Badge, Button } from "@ai-matrx/design-system";
 <Badge variant="success">Ready</Badge>
 ```
 
-The package intentionally does not ship product colors. Hosts define the normal Tailwind semantic tokens (`primary`, `background`, `border`, `muted`, `success`, and `warning`), so one component follows each product's theme without forking behavior.
+The package intentionally does not ship product colors. Hosts define the normal Tailwind semantic tokens (`primary`, `background`, `border`, `muted`, `success`, and `warning`), so one component follows each product's theme without forking behavior. A few ported components additionally reference host-owned CSS contracts and degrade gracefully without them: the glass tokens/utilities used by the BottomSheet family, the `.matrx-scroll-fade` styling for `useScrollFade`, and the `shadow-input` utility.
+
+Host-shaped systems are injected, never imported: wrap subtrees in `PortalContainerProvider` to point nested Popover portals at a dialog or popout body, and hand `OverflowToolbar` your menu and tooltip systems through its `renderOverflowMenu` / `renderTooltip` props. `@ai-matrx/kit` (>= 0.5.1) is a peer dependency.
 
 Tailwind CSS v4 ignores `node_modules` by default. Registry consumers must register the package build beside their Tailwind import: