@ai-matrx/design-system 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,63 @@
 # Changelog
 
+## 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
+  Next.js consumers classify the bundled Radix/React primitives correctly.
+- Added a packed-tarball assertion for that boundary.
+
 ## 0.1.0 — 2026-08-22
 
 - Added Button, Badge, Label, Separator, and `cn` as the first shared semantic UI foundation.

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: