@ai-matrx/design-system 0.5.2 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # Changelog
 
+## 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.
+
+### 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
@@ -121,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.

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: {