@ai-matrx/design-system 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,73 @@
 # Changelog
 
+## 0.11.0 — 2026-09-07
+
+**THE CONFIRM SURFACE MOVES IN.** `ConfirmDialog` and `ConfirmDialogHost` — the
+platform's `window.confirm` replacement — now live here. They came from
+`@ai-matrx/kit`, which is releasing 0.9.0 to delete its copy. Census row 19i,
+decided on the row-20a Tooltip precedent: **one surface, one owner.**
+
+**Why it had to move.** kit's confirm shipped a second, inlined AlertDialog with
+its own hand-copied button class strings, a hardcoded `bg-black/80` scrim, and
+the exact `data-[state=open]:animate-in … zoom-in-95 … slide-in-from-top-[48%]`
+host-plugin utilities 0.10.0's motion sweep just finished removing from this
+package. kit ships NO stylesheet, so that dialog was unanimated and off-theme in
+three of the four consumers — on the one surface in the product that stands
+between a user and a destroyed thing. kit could not import 0.10.0's fix, because
+**this package depends on kit**; importing back is a cycle. And giving kit its own
+sheet would have invented a second required-CSS contract no consumer performs —
+the C26 silent host contract, one layer down. The only correct move was this one.
+
+**What it inherits by being here** — none of it hand-copied, all of it already
+proven by this package's own guards:
+
+- `matrx-motion-overlay` / `matrx-motion-dialog` / `matrx-spin`, whose rules ship
+  in `styles.css` and are asserted present in the packed tarball;
+- `--matrx-overlay-scrim`, a token that answers to the host's theme, instead of
+  `bg-black/80`;
+- `AlertDialog` ruling 3 — clamped to `max-h-[85dvh]`, scrolling inside itself,
+  sticky footer. **This is what makes the platform's consequence-first copy law
+  survivable.** A confirmation that names everything it is about to destroy can be
+  long, and in kit's unclamped copy a long one pushed Cancel and Continue below
+  the fold of a short viewport. An AlertDialog does not dismiss on a backdrop
+  click, so that was a dead end on a destructive action. Fixed by the move, with
+  a guard;
+- `buttonVariants` as the ONE source of button appearance — the destructive
+  confirm button is now literally the package's destructive button, including the
+  44px coarse-pointer target, not a second hand-written copy of its classes;
+- `PortalContainerProvider`, so a confirm opened inside a popped-out window panel
+  renders in THAT window's document without the host passing anything.
+
+**Behavior is the kit port, verbatim.** Every prop, default and interaction is
+unchanged; only the chrome underneath is the package's. The suite came across
+whole and grew a third target: `src/confirm-dialog.test.tsx` proves the
+imperative contract across the package boundary, proves the chrome is the
+package's (a guard that fails the moment `bg-black` or `animate-in` comes back),
+and proves the consequence-first copy contract — the consequence renders in full,
+is the dialog's `aria-describedby` description, is never clamped or truncated,
+and never puts the actions out of reach however long it is.
+
+### Added
+
+- `ConfirmDialog`, `ConfirmDialogProps` — the declarative dialog (use it inline
+  when in-dialog `busy` state during async work is meaningful).
+- `ConfirmDialogHost` — mount ONCE near the root of every provider tree.
+
+### Not added, on purpose
+
+- `confirm()` is **not** re-exported from here. The imperative opener stays in
+  `@ai-matrx/kit/confirm-opener`, where it is pure TS with no React and no radix,
+  so hundreds of static call sites cost nothing. The host and the opener find each
+  other through the opener's `Symbol.for("ai-matrx.kit.confirm-opener-state")`
+  globalThis slot — across packages and across module graphs.
+
+### Consumer action (C28)
+
+Mount `<ConfirmDialogHost />` from **here** and keep calling `confirm()` from
+`@ai-matrx/kit/confirm-opener`. The full repointing diff — host, dialog, and the
+imperative import — is in `@ai-matrx/kit` CHANGELOG § 0.9.0 § Consumer action.
+Take both releases together: design-system >= 0.11.0 with kit >= 0.9.0.
+
 ## 0.10.0 — 2026-09-07
 
 **THE MOTION SWEEP. Ten more primitives were animating with a host plugin this
@@ -378,9 +446,19 @@ Install `@ai-matrx/design-system@0.7.0` (and `@ai-matrx/tap-target@0.2.0`), then
      `alert-dialog.tsx`, `alert.tsx`, `slider.tsx`, `resizable.tsx`,
      `matrx/resizable.tsx`, `radio-group.tsx`, `hover-card.tsx`,
      `toggle-group.tsx`, `toggle.tsx`, `radix-dialog-modal-context.tsx`.
-   - No other consumer repo carries a fork of these — verified by census on
+   - ~~No other consumer repo carries a fork of these — verified by census on
      2026-09-07 across matrx-extend, matrx-games, aidream `apps/dashboard` and
-     `apps/workflow-studio`.
+     `apps/workflow-studio`.~~ 🚨 **WRONG, corrected 2026-09-07.** That census
+     swept FOUR repos and there are FIVE: **matrx-local** (`desktop/`, the
+     Tauri app) carried its own `tooltip.tsx`, `slider.tsx`, `popover.tsx` and
+     `select.tsx` the whole time — plus ten more from the 0.5.0 list below,
+     whose Consumer action omitted it for the same reason. The sentence was
+     repeated verbatim into census row 19, and every later wave that read it
+     kept skipping the repo. matrx-local was adopted on 0.10.0 the same day
+     this was found: all seventeen forks swapped, fourteen files deleted, 131
+     files repointed, 56 twin-register rows added. **The lesson is the
+     sentence, not the repo — a "no other consumer" claim must name the repos
+     it swept, and the list must be checked against the actual consumer set.**
 3. **`matrx/resizable.tsx` callers keep their `size` prop** — it is the same
    eight-step scale, now on the one component. Callers of the plain
    `resizable.tsx` get the identical 2px default (`size="sm"`).
@@ -567,6 +645,11 @@ copy of something this version now ships:
   Bind `Card size="lg"` to keep this app's density (Table defaults to md as of 0.5.1).
 - **aidream/apps/workflow-studio** — `src/components/ui/{dialog,dropdown-menu,scroll-area,switch,tabs,textarea}.tsx`.
   Its ScrollArea viewport hack becomes `viewportClassName="[&>div]:!block [&>div]:min-w-0"`.
+- **matrx-local** — `desktop/src/components/ui/{avatar,card,checkbox,dialog,progress,scroll-area,switch,tabs,textarea}.tsx`.
+  **Added 2026-09-07**: this repo was missing from the list above (see the
+  correction under 0.7.0 Consumer action 2). Adopted on 0.10.0 — `card` and
+  `dialog` keep one-prop binding shims for this app's `lg` density and its
+  glass surface; everything else re-points straight at the package.
 
 Hosts that do not already import the stylesheets must, or the new structural
 rules do nothing:

package/README.md

@@ -5,9 +5,28 @@ The small, semantic UI foundation shared by AI Matrx React applications — prim
 **Controls:** Button, Badge, Label, Separator, the Input family, the Textarea family, Checkbox, Switch, RadioGroup, Slider, Toggle + ToggleGroup, Avatar, Progress.
 **Surfaces:** Card, Table, Tabs, Accordion, Collapsible, ScrollArea, Popover, Tooltip, HoverCard, Sheet, Dialog, AlertDialog, Drawer, BottomSheet + TabbedBottomSheet, Alert, Resizable, Skeleton.
 **Menus:** DropdownMenu, ContextMenu, Command / CommandDialog, Select, CreatablePicker.
-**Composed:** EditableLabel, SegmentedControl, ScoreRing, OverflowToolbar.
+**Composed:** EditableLabel, SegmentedControl, ScoreRing, OverflowToolbar, ConfirmDialog + ConfirmDialogHost.
 **Hooks + utilities:** `useScrollFade`, `useIsMobile`, `usePortalContainer`, `useDialogContainer`, `useDrawerDirection`, `cn`.
 
+**The confirm dialog lives here; the imperative `confirm()` lives in `@ai-matrx/kit`.** Since 0.11.0 / kit 0.9.0 the surface is one implementation, in the package that owns AlertDialog, the motion layer and the overlay scrim token. Mount the host once near your provider root and call `confirm()` from anywhere — they share one registry through a `globalThis` slot:
+
+```tsx
+// app root, once
+import { ConfirmDialogHost } from "@ai-matrx/design-system";
+<ConfirmDialogHost />
+
+// anywhere — a thunk, a util, a click handler
+import { confirm } from "@ai-matrx/kit/confirm-opener";
+if (!(await confirm({
+  title: "Re-run research",
+  description: "This discards the 14 pages you already have (~$50 and 10 minutes) and starts over.",
+  variant: "destructive",
+  confirmLabel: "Discard and re-run",
+}))) return;
+```
+
+Use the declarative `<ConfirmDialog open … busy />` inline instead when the dialog must stay open with a spinner while async work finishes. Name the consequence: a confirmation that says only "Are you sure?" does not satisfy the platform's destructive-and-expensive-actions law.
+
 **The Tooltip lives here, and only here.** `@ai-matrx/tap-target` used to ship its own copy; since design-system 0.7.0 / tap-target 0.2.0 it consumes this one and re-exports nothing.
 
 Where hosts had forked a primitive over DENSITY, density is a prop, not a fork: `Card size="sm|md|lg"`, `Table size="sm|md"`, `Accordion size="sm|md"`, `Switch`/`Avatar`/`Checkbox`/`Slider`/`RadioGroup`/`Toggle` `size`, `ResizableHandle size="xs".."4xl"`. It is declared once on the root and every item reads it from context, so a card cannot mix paddings and a radio group cannot mix control sizes.