@ai-matrx/design-system 0.5.1 → 0.6.0

package/CHANGELOG.md

@@ -1,10 +1,69 @@
 # Changelog
 
-## 0.5.1
+## 0.6.0 — 2026-09-07
+
+**THE BUTTON SCALE.** matrx-frontend carried a 127-line CVA button fork
+(`components/ui/ButtonMine.tsx`, 17 call sites) alongside the package `Button`.
+It existed for one reason: the package scale stopped at `sm`/`lg`, so a dense
+toolbar had nowhere to go. Per C22 the gap moves into the package rather than
+being papered over in a host shim, and the fork is deleted in the same session.
+
+- **`Button` gains six size rungs** — `xs`, `md`, `xl`, `2xl`, `3xl`, and
+  `roundIcon` (a circular icon box) — completing one scale from `xs` to `3xl`
+  beside the existing `icon` / `icon-sm`. `md` is a deliberate alias of
+  `default`; the fork's middle rung was spelled that way at its call sites.
+- **`Button` gains two variants** — `primary` (an explicit spelling of
+  `default`, identical by construction, because ~17 sites say it) and
+  `success`, the affirmative twin of `destructive`, painted from the
+  `--success` / `--success-foreground` token pair the theme already shipped.
+- **`src/button.test.tsx` makes the scale a contract**: every rung resolves,
+  every rung is distinct (except the declared `md` alias), heights ascend, and
+  NO variant reaches a raw palette colour. Proven failing-then-passing by
+  deleting the `xs` rung. A missing rung is how the fork came back the first
+  time.
+
+Two names the fork spelled differently now resolve to the package's geometry,
+and the ~17 adopted sites move with them: `sm` is `h-8` (the fork's was `h-7`)
+and `icon` is `h-9 w-9` (the fork's was `h-10 w-10`). This is the convergence,
+not a regression — the fork also painted hardcoded `blue-600`/`gray-700`
+palettes, so those sites now follow the host's own tokens in light and dark.
+
+Not carried: the fork's `m` / `l` legacy size aliases (no call site used
+either) and its runtime `isValidOption` variant/size validation, which guarded
+against values TypeScript already refuses.
 
-Automatic changed-only republish (docs/metadata drift since the last tag — see
-`git diff npm/design-system/v0.5.0..npm/design-system/v0.5.1 -- apps/shared/design-system`).
-No source changes intended and no consumer action required.
+### Consumer action (C28)
+
+None required — every existing `variant`/`size` value keeps its meaning. If
+your repo has its own button fork with extra sizes, it can now be deleted:
+adopt `@ai-matrx/design-system`'s `Button` and re-point the call sites.
+
+## 0.5.2 — 2026-09-07
+
+Two real source corrections, found by adopting 0.5.0 in the first two consumers
+before any of them shipped it.
+
+(0.5.1 is an automatic changed-only republish tag the release automation cut
+between these two commits; it carries 0.5.0's source with no source change. Go
+straight to 0.5.2.)
+
+- **`useIsMobile` no longer crashes where `matchMedia` is absent.** Older jsdom
+  setups and some embedded webviews do not provide it, and `Dialog` reads the
+  hook — so adopting 0.5.0 took down 38 of workflow-studio's tests over a
+  breakpoint. The width read still gives a correct first answer; only live
+  resize tracking is lost, which is exactly what is unavailable. A primitive
+  must never cost a host its whole suite (or its screen) for an optional
+  capability.
+- **`Checkbox` and `Table` now default to `md`** — the stock 16px control and
+  `p-3` cells, which every host except matrx-frontend already used. The 0.5.0
+  defaults would have made three consumers bind a size just to stand still.
+  matrx-frontend is dense on purpose and binds `sm` in its own shim.
+
+### Consumer action (C28)
+
+None beyond installing 0.5.2 (0.5.1 was an automatic republish tag cut between these two commits; it carries the 0.5.0 source). If you pinned `Checkbox size="sm"` or
+`Table size="sm"` to match 0.5.0's defaults, drop it unless you actually want
+the dense variant.
 
 ## 0.5.0 — 2026-09-07
 
@@ -100,7 +159,7 @@ copy of something this version now ships:
 - **matrx-frontend** — `components/ui/{avatar,card,checkbox,collapsible,dialog,dropdown-menu,progress,scroll-area,switch,table,tabs,textarea}.tsx`
   and `components/ui/context-menu/context-menu.tsx`. High-fanout files become
   re-export shims that bind this repo's historical variant (`Card size="sm"`,
-  `Switch size="sm"`, `Table size="sm"`), matching what the 08-30 swap
+  `Switch size="sm"`, `Checkbox size="sm"`, `Table size="sm"`), matching what the 08-30 swap
   established for `button` / `badge` / `label` / `separator`. The
   clipboard/motion variants (`CopyInput`, `FancyInput`, `DeleteInput`,
   `CopyTextarea`, `FancyTextarea`) stay host-owned under the C8 split-out law.
@@ -114,7 +173,7 @@ copy of something this version now ships:
   carrying that app's own visual language; they are DEFERRED, not forgotten —
   see FEATURE.md § Deferred.
 - **aidream/apps/dashboard** — `src/components/ui/{avatar,card,checkbox,context-menu,dialog,dropdown-menu,scroll-area,switch,table,tabs,textarea}.tsx`.
-  Pass `Card size="lg"` and `Table size="md"` to keep this app's density.
+  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"`.
 

package/dist/index.cjs

@@ -536,19 +536,43 @@ var buttonVariants = (0, import_class_variance_authority2.cva)(
     variants: {
       variant: {
         default: "bg-primary text-primary-foreground shadow-sm hover:bg-primary/90",
+        /**
+         * An explicit spelling of `default`, identical by construction. It is
+         * not decoration: matrx-frontend's `ButtonMine` fork carried it, ~17
+         * call sites say `variant="primary"`, and the alternative to keeping
+         * the word was a host shim translating a prop — the massage C22 bans.
+         */
+        primary: "bg-primary text-primary-foreground shadow-sm hover:bg-primary/90",
         destructive: "bg-destructive text-destructive-foreground shadow-sm hover:bg-destructive/90",
+        /** The affirmative twin of `destructive` — confirm, approve, publish. */
+        success: "bg-success text-success-foreground shadow-sm hover:bg-success/90",
         outline: "border border-border bg-card shadow-sm hover:bg-accent hover:text-accent-foreground",
         secondary: "bg-secondary text-secondary-foreground shadow-sm hover:bg-secondary/80",
         ghost: "hover:bg-accent hover:text-accent-foreground",
         link: "text-primary underline-offset-4 hover:underline",
         subtle: "border border-transparent bg-muted/50 text-foreground hover:border-border hover:bg-muted"
       },
+      /**
+       * ONE size scale, xs → 3xl, plus the two icon boxes. The top and bottom
+       * of the scale came in from matrx-frontend's `ButtonMine` fork (2026-09-07):
+       * a dense toolbar needs `xs`, and a marketing/hero call to action needs
+       * `xl`+. A host that has to reach outside this scale forks the button,
+       * which is exactly how `ButtonMine` was born.
+       */
       size: {
-        default: "h-9 px-4 py-2",
+        xs: "h-6 rounded-md px-1 text-xs",
         sm: "h-8 rounded-md px-3 text-xs",
+        default: "h-9 px-4 py-2",
+        /** An explicit spelling of `default` (the fork's middle rung). */
+        md: "h-9 px-4 py-2",
         lg: "h-10 rounded-md px-6",
+        xl: "h-12 px-8 py-3 text-base",
+        "2xl": "h-14 px-10 py-3 text-base",
+        "3xl": "h-16 px-12 py-3 text-base",
         icon: "h-9 w-9",
-        "icon-sm": "h-7 w-7"
+        "icon-sm": "h-7 w-7",
+        /** A circular icon box — an avatar-shaped control, not a square one. */
+        roundIcon: "h-8 w-8 rounded-full p-0"
       }
     },
     defaultVariants: {