@webstacks/ui 0.4.3 → 0.4.5

package/README.md

@@ -27,17 +27,20 @@ This package includes:
 
 ## Usage
 
-Import components directly from the package:
+### 1. Add the theme to your CSS
 
-```tsx
-import { Button } from "@webstacks/ui";
+In your app's main CSS file (e.g. `index.css`), import Tailwind and the `@webstacks/ui` theme:
 
-function App() {
-  return <Button>Hello world</Button>;
-}
+```css
+@import "tailwindcss";
+@import "@webstacks/ui/theme";
 ```
 
-At the root of your application, wrap your content with the `BaseStyles` component. This injects all design tokens, fonts, color primitives, and base styles:
+This registers all design tokens, fonts, colors, and component classes with Tailwind v4 at build time. No other CSS imports are needed.
+
+### 2. Wrap your app with BaseStyles
+
+At the root of your application, wrap your content with `BaseStyles` to activate the design tokens at runtime:
 
 ```tsx
 import { BaseStyles } from "@webstacks/ui";
@@ -47,6 +50,21 @@ function RootLayout({ children }) {
 }
 ```
 
+### 3. Use components
+
+```tsx
+import { Button, Heading, Section } from "@webstacks/ui";
+
+function App() {
+  return (
+    <Section paddingBlockStart="spacious" paddingBlockEnd="spacious">
+      <Heading as="h1" size="display">Hello world</Heading>
+      <Button>Get Started</Button>
+    </Section>
+  );
+}
+```
+
 ### Color mode
 
 `BaseStyles` accepts a `colorMode` prop to control light/dark theming:
@@ -62,14 +80,6 @@ function RootLayout({ children }) {
 <BaseStyles colorMode="auto">
 ```
 
-### Alternative: manual CSS import
-
-If you prefer not to use `BaseStyles`, you can import the styles directly in your entry point:
-
-```tsx
-import "@webstacks/ui/styles.css";
-```
-
 ## Components
 
 ### Layout

package/dist/index.cjs

@@ -582,37 +582,148 @@ var import_react_slot = require("@radix-ui/react-slot");
 var import_class_variance_authority2 = require("class-variance-authority");
 var import_jsx_runtime4 = require("react/jsx-runtime");
 var buttonVariants = (0, import_class_variance_authority2.cva)(
-  "inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-full text-sm transition-colors focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:size-4 [&_svg]:shrink-0",
+  "inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-full transition-colors cursor-pointer focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:pointer-events-none disabled:cursor-not-allowed [&_svg]:pointer-events-none [&_svg]:size-4 [&_svg]:shrink-0",
   {
     variants: {
-      variant: {
-        default: "bg-primary text-primary-foreground hover:bg-primary/90",
-        destructive: "bg-destructive text-destructive-foreground hover:bg-destructive/90",
-        outline: "border border-input bg-background hover:bg-accent hover:text-accent-foreground",
-        secondary: "bg-secondary text-secondary-foreground hover:bg-secondary/80",
-        ghost: "hover:bg-accent hover:text-accent-foreground",
-        link: "text-primary underline-offset-4 hover:underline"
+      mode: {
+        filled: "",
+        stroke: "bg-transparent border",
+        bleed: "!bg-transparent border-0 !rounded hover:!bg-foreground/5 disabled:opacity-50",
+        link: "disabled:opacity-50"
+      },
+      tone: {
+        primary: "",
+        secondary: "",
+        tertiary: ""
       },
       size: {
-        default: "h-9 px-4 py-2",
-        sm: "h-8 px-3 text-xs",
-        lg: "h-10 px-8",
+        xs: "",
+        sm: "px-4 py-2 text-xs",
+        md: "px-6 py-3 text-sm",
+        lg: "px-8 py-4 text-base",
         icon: "h-9 w-9"
+      },
+      fullWidth: {
+        true: "w-full",
+        false: ""
       }
     },
     defaultVariants: {
-      variant: "default",
-      size: "default"
-    }
+      mode: "filled",
+      tone: "primary",
+      size: "md"
+    },
+    compoundVariants: [
+      /* ── Filled ── */
+      {
+        mode: "filled",
+        tone: "primary",
+        className: "bg-primary text-primary-foreground hover:bg-primary/90 disabled:opacity-50"
+      },
+      {
+        mode: "filled",
+        tone: "secondary",
+        className: "bg-foreground text-background hover:bg-foreground/90 dark:bg-background dark:text-foreground dark:hover:bg-background/90 dark:border dark:border-border disabled:opacity-50"
+      },
+      {
+        mode: "filled",
+        tone: "tertiary",
+        className: "bg-muted text-foreground hover:bg-muted/80 disabled:opacity-50"
+      },
+      /* ── Stroke ── */
+      {
+        mode: "stroke",
+        tone: "primary",
+        className: "border-primary text-primary hover:bg-primary hover:text-primary-foreground disabled:opacity-50"
+      },
+      {
+        mode: "stroke",
+        tone: "secondary",
+        className: "border-border text-foreground hover:bg-primary hover:text-primary-foreground hover:border-primary disabled:opacity-50"
+      },
+      {
+        mode: "stroke",
+        tone: "tertiary",
+        className: "border-border text-foreground hover:bg-accent disabled:opacity-50"
+      },
+      /* ── Bleed ── */
+      {
+        mode: "bleed",
+        tone: "primary",
+        className: "text-foreground"
+      },
+      {
+        mode: "bleed",
+        tone: "secondary",
+        className: "text-foreground"
+      },
+      {
+        mode: "bleed",
+        tone: "tertiary",
+        className: "text-muted-foreground"
+      },
+      /* ── Link ── */
+      {
+        mode: "link",
+        tone: "primary",
+        className: "text-primary underline-offset-4 hover:underline"
+      },
+      {
+        mode: "link",
+        tone: "secondary",
+        className: "text-foreground underline-offset-4 hover:underline"
+      },
+      {
+        mode: "link",
+        tone: "tertiary",
+        className: "text-muted-foreground underline-offset-4 hover:underline"
+      },
+      /* ── Link + Bleed size overrides ── */
+      {
+        mode: "link",
+        size: "xs",
+        className: "text-xs"
+      },
+      {
+        mode: "link",
+        size: "sm",
+        className: "px-0 py-0 text-sm"
+      },
+      {
+        mode: "link",
+        size: "md",
+        className: "px-0 py-0 text-sm"
+      },
+      {
+        mode: "link",
+        size: "lg",
+        className: "px-0 py-0 text-base"
+      },
+      {
+        mode: "bleed",
+        size: "sm",
+        className: "px-2 py-1 text-sm"
+      },
+      {
+        mode: "bleed",
+        size: "md",
+        className: "px-3 py-2 text-sm"
+      },
+      {
+        mode: "bleed",
+        size: "lg",
+        className: "px-3 py-2 text-base"
+      }
+    ]
   }
 );
 var Button = React6.forwardRef(
-  ({ className, variant, size, asChild = false, ...props }, ref) => {
+  ({ className, mode, tone, size, fullWidth, asChild = false, ...props }, ref) => {
     const Comp = asChild ? import_react_slot.Slot : "button";
     return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
       Comp,
       {
-        className: cn(buttonVariants({ variant, size, className })),
+        className: cn(buttonVariants({ mode, tone, size, fullWidth, className })),
         ref,
         ...props
       }
@@ -713,7 +824,7 @@ var AlertDialogCancel = React7.forwardRef(({ className, ...props }, ref) => /* @
   {
     ref,
     className: cn(
-      buttonVariants({ variant: "outline" }),
+      buttonVariants({ mode: "stroke", tone: "secondary" }),
       "mt-2 sm:mt-0",
       className
     ),
@@ -1175,6 +1286,34 @@ var columnMap = {
   11: "grid-cols-11",
   12: "grid-cols-12"
 };
+var mdColumnMap = {
+  1: "md:grid-cols-1",
+  2: "md:grid-cols-2",
+  3: "md:grid-cols-3",
+  4: "md:grid-cols-4",
+  5: "md:grid-cols-5",
+  6: "md:grid-cols-6",
+  7: "md:grid-cols-7",
+  8: "md:grid-cols-8",
+  9: "md:grid-cols-9",
+  10: "md:grid-cols-10",
+  11: "md:grid-cols-11",
+  12: "md:grid-cols-12"
+};
+var lgColumnMap = {
+  1: "lg:grid-cols-1",
+  2: "lg:grid-cols-2",
+  3: "lg:grid-cols-3",
+  4: "lg:grid-cols-4",
+  5: "lg:grid-cols-5",
+  6: "lg:grid-cols-6",
+  7: "lg:grid-cols-7",
+  8: "lg:grid-cols-8",
+  9: "lg:grid-cols-9",
+  10: "lg:grid-cols-10",
+  11: "lg:grid-cols-11",
+  12: "lg:grid-cols-12"
+};
 var Grid = React11.forwardRef(
   ({ as: Comp = "div", className, columns = 12, gap, gapX, gapY, align, justify, ...props }, ref) => {
     let columnClasses;
@@ -1183,8 +1322,8 @@ var Grid = React11.forwardRef(
     } else {
       const classes = [];
       if (columns.narrow) classes.push(columnMap[columns.narrow]);
-      if (columns.regular) classes.push(`md:${columnMap[columns.regular]}`);
-      if (columns.wide) classes.push(`lg:${columnMap[columns.wide]}`);
+      if (columns.regular) classes.push(mdColumnMap[columns.regular]);
+      if (columns.wide) classes.push(lgColumnMap[columns.wide]);
       columnClasses = classes.join(" ");
     }
     return /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
@@ -1249,6 +1388,34 @@ var spanMap = {
   11: "col-span-11",
   12: "col-span-12"
 };
+var mdSpanMap = {
+  1: "md:col-span-1",
+  2: "md:col-span-2",
+  3: "md:col-span-3",
+  4: "md:col-span-4",
+  5: "md:col-span-5",
+  6: "md:col-span-6",
+  7: "md:col-span-7",
+  8: "md:col-span-8",
+  9: "md:col-span-9",
+  10: "md:col-span-10",
+  11: "md:col-span-11",
+  12: "md:col-span-12"
+};
+var lgSpanMap = {
+  1: "lg:col-span-1",
+  2: "lg:col-span-2",
+  3: "lg:col-span-3",
+  4: "lg:col-span-4",
+  5: "lg:col-span-5",
+  6: "lg:col-span-6",
+  7: "lg:col-span-7",
+  8: "lg:col-span-8",
+  9: "lg:col-span-9",
+  10: "lg:col-span-10",
+  11: "lg:col-span-11",
+  12: "lg:col-span-12"
+};
 var GridColumn = React11.forwardRef(
   ({ as: Comp = "div", className, span, start, ...props }, ref) => {
     let spanClasses;
@@ -1257,8 +1424,8 @@ var GridColumn = React11.forwardRef(
     } else if (span) {
       const classes = [];
       if (span.narrow) classes.push(spanMap[span.narrow]);
-      if (span.regular) classes.push(`md:${spanMap[span.regular]}`);
-      if (span.wide) classes.push(`lg:${spanMap[span.wide]}`);
+      if (span.regular) classes.push(mdSpanMap[span.regular]);
+      if (span.wide) classes.push(lgSpanMap[span.wide]);
       spanClasses = classes.join(" ");
     } else {
       spanClasses = "";
@@ -1707,6 +1874,14 @@ var directionMap = {
   horizontal: "flex-row",
   vertical: "flex-col"
 };
+var mdDirectionMap = {
+  horizontal: "md:flex-row",
+  vertical: "md:flex-col"
+};
+var lgDirectionMap = {
+  horizontal: "lg:flex-row",
+  vertical: "lg:flex-col"
+};
 var gapMap = {
   none: "gap-0",
   condensed: "gap-2",
@@ -1714,6 +1889,20 @@ var gapMap = {
   spacious: "gap-6",
   "extra-spacious": "gap-8"
 };
+var mdGapMap = {
+  none: "md:gap-0",
+  condensed: "md:gap-2",
+  normal: "md:gap-4",
+  spacious: "md:gap-6",
+  "extra-spacious": "md:gap-8"
+};
+var lgGapMap = {
+  none: "lg:gap-0",
+  condensed: "lg:gap-2",
+  normal: "lg:gap-4",
+  spacious: "lg:gap-6",
+  "extra-spacious": "lg:gap-8"
+};
 var alignMap = {
   start: "items-start",
   center: "items-center",
@@ -1721,6 +1910,20 @@ var alignMap = {
   stretch: "items-stretch",
   baseline: "items-baseline"
 };
+var mdAlignMap = {
+  start: "md:items-start",
+  center: "md:items-center",
+  end: "md:items-end",
+  stretch: "md:items-stretch",
+  baseline: "md:items-baseline"
+};
+var lgAlignMap = {
+  start: "lg:items-start",
+  center: "lg:items-center",
+  end: "lg:items-end",
+  stretch: "lg:items-stretch",
+  baseline: "lg:items-baseline"
+};
 var justifyMap = {
   start: "justify-start",
   center: "justify-center",
@@ -1729,16 +1932,37 @@ var justifyMap = {
   "space-around": "justify-around",
   "space-evenly": "justify-evenly"
 };
-function resolveResponsive3(value, map) {
+var mdJustifyMap = {
+  start: "md:justify-start",
+  center: "md:justify-center",
+  end: "md:justify-end",
+  "space-between": "md:justify-between",
+  "space-around": "md:justify-around",
+  "space-evenly": "md:justify-evenly"
+};
+var lgJustifyMap = {
+  start: "lg:justify-start",
+  center: "lg:justify-center",
+  end: "lg:justify-end",
+  "space-between": "lg:justify-between",
+  "space-around": "lg:justify-around",
+  "space-evenly": "lg:justify-evenly"
+};
+function resolveResponsive3(value, maps) {
   if (!value) return [];
-  if (typeof value === "string") return [map[value]].filter(Boolean);
+  if (typeof value === "string") return [maps.narrow[value]].filter(Boolean);
   const classes = [];
-  const prefixes = { narrow: "", regular: "md:", wide: "lg:" };
-  for (const [bp, val] of Object.entries(value)) {
-    if (val && map[val]) {
-      const prefix = prefixes[bp] || "";
-      classes.push(`${prefix}${map[val]}`);
-    }
+  if (value.narrow) {
+    const cls = maps.narrow[value.narrow];
+    if (cls) classes.push(cls);
+  }
+  if (value.regular) {
+    const cls = maps.regular[value.regular];
+    if (cls) classes.push(cls);
+  }
+  if (value.wide) {
+    const cls = maps.wide[value.wide];
+    if (cls) classes.push(cls);
   }
   return classes;
 }
@@ -1755,10 +1979,10 @@ var Stack = React15.forwardRef(
     ...props
   }, ref) => {
     const responsiveClasses = [
-      ...resolveResponsive3(direction, directionMap),
-      ...resolveResponsive3(gap, gapMap),
-      ...resolveResponsive3(align, alignMap),
-      ...resolveResponsive3(justify, justifyMap)
+      ...resolveResponsive3(direction, { narrow: directionMap, regular: mdDirectionMap, wide: lgDirectionMap }),
+      ...resolveResponsive3(gap, { narrow: gapMap, regular: mdGapMap, wide: lgGapMap }),
+      ...resolveResponsive3(align, { narrow: alignMap, regular: mdAlignMap, wide: lgAlignMap }),
+      ...resolveResponsive3(justify, { narrow: justifyMap, regular: mdJustifyMap, wide: lgJustifyMap })
     ];
     const isResponsiveDirection = typeof direction === "object";
     const isResponsiveGap = typeof gap === "object";
@@ -1800,7 +2024,8 @@ function Calendar({
   classNames,
   showOutsideDays = true,
   captionLayout = "label",
-  buttonVariant = "ghost",
+  buttonMode = "bleed",
+  buttonTone = "primary",
   formatters,
   components,
   ...props
@@ -1833,12 +2058,12 @@ function Calendar({
           defaultClassNames.nav
         ),
         button_previous: cn(
-          buttonVariants({ variant: buttonVariant }),
+          buttonVariants({ mode: buttonMode, tone: buttonTone }),
           "h-[--cell-size] w-[--cell-size] select-none p-0 aria-disabled:opacity-50",
           defaultClassNames.button_previous
         ),
         button_next: cn(
-          buttonVariants({ variant: buttonVariant }),
+          buttonVariants({ mode: buttonMode, tone: buttonTone }),
           "h-[--cell-size] w-[--cell-size] select-none p-0 aria-disabled:opacity-50",
           defaultClassNames.button_next
         ),
@@ -1955,7 +2180,7 @@ function CalendarDayButton({
     Button,
     {
       ref,
-      variant: "ghost",
+      mode: "bleed",
       size: "icon",
       "data-day": day.date.toLocaleDateString(),
       "data-selected-single": modifiers.selected && !modifiers.range_start && !modifiers.range_end && !modifiers.range_middle,
@@ -2164,13 +2389,14 @@ var CarouselItem = React18.forwardRef(({ className, ...props }, ref) => {
   );
 });
 CarouselItem.displayName = "CarouselItem";
-var CarouselPrevious = React18.forwardRef(({ className, variant = "outline", size = "icon", ...props }, ref) => {
+var CarouselPrevious = React18.forwardRef(({ className, mode = "stroke", tone = "secondary", size = "icon", ...props }, ref) => {
   const { orientation, scrollPrev, canScrollPrev } = useCarousel();
   return /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)(
     Button,
     {
       ref,
-      variant,
+      mode,
+      tone,
       size,
       className: cn(
         "absolute  h-8 w-8 rounded-full",
@@ -2188,13 +2414,14 @@ var CarouselPrevious = React18.forwardRef(({ className, variant = "outline", siz
   );
 });
 CarouselPrevious.displayName = "CarouselPrevious";
-var CarouselNext = React18.forwardRef(({ className, variant = "outline", size = "icon", ...props }, ref) => {
+var CarouselNext = React18.forwardRef(({ className, mode = "stroke", tone = "secondary", size = "icon", ...props }, ref) => {
   const { orientation, scrollNext, canScrollNext } = useCarousel();
   return /* @__PURE__ */ (0, import_jsx_runtime17.jsxs)(
     Button,
     {
       ref,
-      variant,
+      mode,
+      tone,
       size,
       className: cn(
         "absolute h-8 w-8 rounded-full",
@@ -3559,7 +3786,8 @@ var PaginationLink = ({
     "aria-current": isActive ? "page" : void 0,
     className: cn(
       buttonVariants({
-        variant: isActive ? "outline" : "ghost",
+        mode: isActive ? "stroke" : "bleed",
+        tone: "secondary",
         size
       }),
       className
@@ -3575,7 +3803,7 @@ var PaginationPrevious = ({
   PaginationLink,
   {
     "aria-label": "Go to previous page",
-    size: "default",
+    size: "md",
     className: cn("gap-1 pl-2.5", className),
     ...props,
     children: [
@@ -3592,7 +3820,7 @@ var PaginationNext = ({
   PaginationLink,
   {
     "aria-label": "Go to next page",
-    size: "default",
+    size: "md",
     className: cn("gap-1 pr-2.5", className),
     ...props,
     children: [
@@ -4235,7 +4463,7 @@ var SidebarTrigger = React42.forwardRef(({ className, onClick, ...props }, ref)
     {
       ref,
       "data-sidebar": "trigger",
-      variant: "ghost",
+      mode: "bleed",
       size: "icon",
       className: cn("h-7 w-7", className),
       onClick: (event) => {