@fragment-build/ui 3.2.3 → 4.0.0

package/fragments/widget/widget.css

@@ -1,18 +1,59 @@
 @layer components {
   .fragment-widget {
-    @apply px-7 py-5 gap-5;
+    @apply p-5 gap-4 min-w-0;
   }
 
   .fragment-widget__header {
-    @apply p-0;
+    @apply p-0 flex flex-row items-start gap-3;
+  }
+
+  .fragment-widget__header-start {
+    @apply shrink-0;
+  }
+
+  .fragment-widget__heading {
+    @apply min-w-0 flex-1;
+  }
+
+  .fragment-widget__title {
+    @apply text-sm font-semibold;
+  }
+
+  .fragment-widget__description {
+    @apply mt-0.5 text-xs text-muted;
   }
 
   .fragment-widget__header-end {
-    @apply ml-auto;
+    @apply ml-auto flex items-center gap-2 shrink-0;
   }
 
   .fragment-widget__content {
-    @apply p-0 overflow-visible;
+    @apply p-0 overflow-visible min-w-0;
+  }
+
+  .fragment-widget__footer {
+    @apply -mx-5 -mb-5 mt-auto px-5 py-3 border-t border-separator text-xs text-muted;
+  }
+
+  .fragment-widget--padding-sm {
+    @apply p-4 gap-3;
+
+    .fragment-widget__footer {
+      @apply -mx-4 -mb-4 px-4;
+    }
+  }
+
+  /* Edge-to-edge content: the header keeps its inset, the body does not. */
+  .fragment-widget--flush {
+    @apply p-0 gap-0;
+
+    .fragment-widget__header {
+      @apply px-5 pt-5 pb-4;
+    }
+
+    .fragment-widget__footer {
+      @apply mx-0 mb-0;
+    }
   }
 
   .fragment-widget--sm {
@@ -26,4 +67,8 @@
   .fragment-widget--lg {
     @apply col-span-1 lg:col-span-2 2xl:col-span-3;
   }
+
+  .fragment-widget--full {
+    @apply col-span-full;
+  }
 }

package/index.css

@@ -1,37 +1,65 @@
-@theme {
-  --text-xs: 13px;
-  --text-sm: 15px;
+/*
+ * Type scale.
+ *
+ * Tailwind's own steps (12 / 14 / 16). Fragment used to pin `text-xs` to 13px and `text-sm` to
+ * 15px, which made every HeroUI control one step larger than the component library was drawn for
+ * and pushed dashboards towards a consumer-app density. Body copy is set to `text-sm` below, which
+ * is the size HeroUI's fields, list boxes and tables already use, so running text and controls now
+ * share one size.
+ */
+
+/*
+ * Fragment surface roles.
+ *
+ * `inline` so the utilities compile to `var(--sidebar)` / `var(--navbar)` and are
+ * therefore resolved on the element, not frozen at `:root`. Each falls back to the
+ * page role, so a theme that never declares them renders exactly as before.
+ */
+@theme inline {
+  --color-sidebar: var(--sidebar, var(--background));
+  --color-sidebar-foreground: var(--sidebar-foreground, var(--foreground));
+
+  --color-navbar: var(--navbar, var(--background));
+  --color-navbar-foreground: var(--navbar-foreground, var(--foreground));
 }
 
 @layer base {
   body {
-    @apply bg-background text-foreground;
+    @apply bg-background text-foreground text-sm antialiased;
   }
 
+  /*
+   * Page title, section, card. A dashboard has many more card titles than page titles, so the
+   * steps are tight and the weight carries the hierarchy rather than the size.
+   */
   h1 {
-    @apply text-3xl font-semibold;
+    @apply text-2xl font-semibold tracking-tight;
   }
 
   h2 {
-    @apply text-2xl font-semibold;
+    @apply text-lg font-semibold tracking-tight;
   }
 
   h3 {
-    @apply text-xl font-semibold;
+    @apply text-base font-semibold;
+  }
+
+  h4 {
+    @apply text-sm font-semibold;
   }
 }
 
 @layer components {
+  /*
+   * Fields keep HeroUI's own height and padding. They get a hairline border instead of the
+   * default shadow, so a form reads as a set of crisp boxes on a flat surface.
+   */
   .input, .textarea, .select__trigger {
-    @apply border border-border px-6 py-4 shadow-none;
+    @apply border border-border shadow-none;
   }
 
-  .input-group, .search-field__group, .number-field__group{
-    @apply border border-border shadow-none h-auto;
-
-    .input-group__input, .search-field__input, .number-field__input {
-      @apply px-6 py-4;
-    }
+  .input-group, .search-field__group, .number-field__group {
+    @apply border border-border shadow-none;
   }
 
   .slider {
@@ -50,14 +78,6 @@
     }
   }
 
-  .select__indicator {
-    @apply right-4;
-  }
-
-  .select__trigger:has(.select__indicator) {
-    @apply pr-10;
-  }
-
   .select__popover {
     @apply rounded-xl;
   }
@@ -65,18 +85,18 @@
   .tabs {
     &:not(.tabs--secondary) {
       .tabs__list {
-        @apply bg-surface p-0;
-        
-        border-radius: calc(var(--radius-3xl) + 0.25rem);
+        @apply bg-default p-1;
+
+        border-radius: calc(var(--radius-xl) + 0.25rem);
       }
 
       .tabs__indicator {
-        @apply shadow-none bg-surface-tertiary;
+        @apply bg-surface shadow-sm;
       }
 
       .tabs__tab {
         &[data-selected="true"] {
-          @apply text-surface-tertiary-foreground;
+          @apply text-surface-foreground;
         }
       }
 
@@ -86,7 +106,7 @@
     }
 
     .tabs__tab {
-      @apply h-10 px-6 text-xs text-nowrap;
+      @apply h-8 px-4 text-sm text-nowrap;
     }
 
     .tabs__list {
@@ -95,25 +115,89 @@
       }
     }
 
+    /* Underline tabs size to their label, so a short list sits left instead of spreading out. */
     &.tabs--secondary {
+      .tabs__list[data-orientation="horizontal"] {
+        @apply gap-6;
+      }
+
       .tabs__tab {
-        @apply h-12 px-10;
+        @apply h-11 w-auto min-w-0 px-0.5 gap-2;
+        & svg {
+          @apply size-4;
+        }
+
+        /*
+         * A static underline for tab lists that render no <Tabs.Indicator>. The animated indicator
+         * slides from the previous tab with an inline translate, and when the selection is decided
+         * during hydration (a tab read from the URL) its first frame can stick, leaving the line
+         * under the wrong tab.
+         */
+        &[data-selected="true"]:not(:has(.tabs__indicator))::after {
+          content: '';
+          @apply absolute inset-x-0 bottom-0 h-0.5 bg-accent;
+        }
       }
     }
   }
 
-  .card {
-    @apply border border-border shadow-none;
-  }
+  /*
+   * The primary table as one flat card: a hairline frame, a header band and row dividers, instead
+   * of HeroUI's grey frame with a white card inset in it — which on a tinted page reads as a box
+   * in a box. Rows get a visible hover, since the default (`surface` at 40%) vanishes on white.
+   */
+  .table-root--primary {
+    @apply border border-border bg-surface p-0;
+
+    border-radius: var(--radius-3xl);
+    box-shadow: var(--fragment-card-shadow, none);
 
-  .button {
-    &.button--md:not(.button--icon-only) {
-      @apply h-12 px-6;
+    .table__column {
+      @apply py-2.5 whitespace-nowrap;
 
-      @media (width >= 48rem) {
-        @apply h-12 px-6;
+      &::after {
+        content: none;
       }
     }
+
+    .table__header {
+      @apply border-b border-separator;
+    }
+
+    .table__body tr td {
+      border-radius: 0 !important;
+    }
+
+    .table__cell {
+      @apply border-b border-separator;
+    }
+
+    .table__body tr:last-child .table__cell {
+      @apply border-b-0;
+    }
+
+    .table__row {
+      @media (hover: hover) {
+        &:hover .table__cell,
+        &[data-hovered="true"] .table__cell {
+          @apply bg-surface-secondary;
+        }
+      }
+    }
+
+    .table__footer {
+      @apply border-t border-separator;
+    }
+  }
+
+  /*
+   * Cards sit apart from the page by a hairline and an optional, very soft lift. The lift is a
+   * token so a theme on a white page (where the border is all there is) can turn it off.
+   */
+  .card {
+    @apply border border-border;
+
+    box-shadow: var(--fragment-card-shadow, none);
   }
 }
 
@@ -124,10 +208,15 @@
 @import "./fragments/widget/widget.css";
 @import "./components/grid/grid.css";
 @import "./components/multi-switch/multi-switch.css";
+@import "./components/segmented-control/segmented-control.css";
 @import "./components/code/code.css";
 @import "./components/code-snippet/code-snippet.css";
 @import "./fragments/form/form.css";
 @import "./fragments/form/form-section.css";
+@import "./fragments/form/form-card.css";
+@import "./fragments/save-bar/save-bar.css";
+@import "./fragments/stat/stat-card.css";
+@import "./fragments/empty-state/empty-state.css";
 
 .light,
 .default,
@@ -137,6 +226,12 @@
   --background: #fff;
   --border: rgba(0, 0, 0, 0.07);
   --surface-secondary: rgba(0, 0, 0, 0.02);
+
+  /* Fragment surfaces: default to the page surface */
+  --sidebar: var(--background);
+  --sidebar-foreground: var(--foreground);
+  --navbar: var(--background);
+  --navbar-foreground: var(--foreground);
 }
 
 .dark,
@@ -146,6 +241,12 @@
   --foreground: var(--snow);
   --border: rgba(255, 255, 255, 0.07);
   --surface-secondary: rgba(255, 255, 255, 0.02);
+
+  /* Fragment surfaces: default to the page surface */
+  --sidebar: var(--background);
+  --sidebar-foreground: var(--foreground);
+  --navbar: var(--background);
+  --navbar-foreground: var(--foreground);
 }
 
 /* @import "./theme.example.css"; */

package/index.d.ts

@@ -4,10 +4,15 @@ export { CodeSnippet, type CodeSnippetProps } from './components/code-snippet/Co
 export { Grid, type GridProps } from './components/grid/Grid';
 export { MultiSwitch, type MultiSwitchProps } from './components/multi-switch/MultiSwitch';
 export { ThemeSwitch, type ThemeSwitchProps } from './components/theme-switch/ThemeSwitch';
+export { SegmentedControl, type SegmentedControlProps, type SegmentedControlOption, } from './components/segmented-control/SegmentedControl';
 export { Form, type FormProps } from './fragments/form/Form';
 export { FormSection, type FormSectionProps } from './fragments/form/FormSection';
+export { FormCard, type FormCardProps } from './fragments/form/FormCard';
+export { SaveBar, type SaveBarProps } from './fragments/save-bar/SaveBar';
 export { PageHeader, type PageHeaderProps } from './fragments/page/PageHeader';
 export { Navbar, type NavbarProps } from './fragments/navbar/Navbar';
 export { Shell, type ShellProps } from './fragments/shell/Shell';
 export { Sidebar, type SidebarProps } from './fragments/sidebar/Sidebar';
 export { Widget, type WidgetProps } from './fragments/widget/Widget';
+export { StatCard, type StatCardProps, type StatCardDelta } from './fragments/stat/StatCard';
+export { EmptyState, type EmptyStateProps } from './fragments/empty-state/EmptyState';

package/index.js

@@ -6,11 +6,16 @@ export { CodeSnippet } from './components/code-snippet/CodeSnippet';
 export { Grid } from './components/grid/Grid';
 export { MultiSwitch } from './components/multi-switch/MultiSwitch';
 export { ThemeSwitch } from './components/theme-switch/ThemeSwitch';
+export { SegmentedControl, } from './components/segmented-control/SegmentedControl';
 export { Form } from './fragments/form/Form';
 export { FormSection } from './fragments/form/FormSection';
+export { FormCard } from './fragments/form/FormCard';
+export { SaveBar } from './fragments/save-bar/SaveBar';
 export { PageHeader } from './fragments/page/PageHeader';
 export { Navbar } from './fragments/navbar/Navbar';
 export { Shell } from './fragments/shell/Shell';
 export { Sidebar } from './fragments/sidebar/Sidebar';
 export { Widget } from './fragments/widget/Widget';
+export { StatCard } from './fragments/stat/StatCard';
+export { EmptyState } from './fragments/empty-state/EmptyState';
 //# sourceMappingURL=index.js.map

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,sBAAsB;AACtB,OAAO,EAAE,IAAI,EAAkB,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAyB,MAAM,uCAAuC,CAAC;AAC3F,OAAO,EAAE,IAAI,EAAkB,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAyB,MAAM,uCAAuC,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAyB,MAAO,uCAAuC,CAAC;AAE5F,OAAO,EAAE,IAAI,EAAkB,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAyB,MAAM,8BAA8B,CAAC;AAClF,OAAO,EAAE,UAAU,EAAwB,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,MAAM,EAAoB,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,KAAK,EAAmB,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,OAAO,EAAqB,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,MAAM,EAAoB,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,sBAAsB;AACtB,OAAO,EAAE,IAAI,EAAkB,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAyB,MAAM,uCAAuC,CAAC;AAC3F,OAAO,EAAE,IAAI,EAAkB,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAyB,MAAM,uCAAuC,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAyB,MAAO,uCAAuC,CAAC;AAC5F,OAAO,EACL,gBAAgB,GACjB,MAAM,iDAAiD,CAAC;AAEzD,OAAO,EAAE,IAAI,EAAkB,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAyB,MAAM,8BAA8B,CAAC;AAClF,OAAO,EAAE,QAAQ,EAAsB,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,OAAO,EAAqB,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAwB,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,MAAM,EAAoB,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,KAAK,EAAmB,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,OAAO,EAAqB,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,MAAM,EAAoB,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,QAAQ,EAA0C,MAAM,2BAA2B,CAAC;AAC7F,OAAO,EAAE,UAAU,EAAwB,MAAM,oCAAoC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fragment-build/ui",
-  "version": "3.2.3",
+  "version": "4.0.0",
   "type": "module",
   "engines": {
     "node": ">=22"

package/src/components/code-snippet/code-snippet.css

@@ -11,3 +11,21 @@
     @apply text-muted;
   }
 }
+
+@layer components {
+  .fragment-code-snippet--block {
+    @apply overflow-hidden rounded-xl border border-border bg-surface-secondary;
+  }
+
+  .fragment-code-snippet__header {
+    @apply flex items-center justify-between gap-2 border-b border-border py-1 pr-1 pl-4;
+  }
+
+  .fragment-code-snippet__title {
+    @apply text-xs font-medium text-muted;
+  }
+
+  .fragment-code-snippet__block-code {
+    @apply overflow-x-auto px-4 py-3 font-mono text-xs leading-relaxed text-foreground;
+  }
+}

package/src/components/segmented-control/segmented-control.css

@@ -0,0 +1,41 @@
+@layer components {
+  .fragment-segmented-control {
+    @apply inline-flex items-center gap-0.5 rounded-[var(--field-radius)] bg-default p-0.5;
+  }
+
+  .fragment-segmented-control--full-width {
+    @apply flex w-full;
+
+    .fragment-segmented-control__item {
+      @apply flex-1;
+    }
+  }
+
+  .fragment-segmented-control__item.toggle-button {
+    @apply h-8 rounded-[calc(var(--field-radius)-0.125rem)] px-3 text-sm font-medium text-muted md:h-8;
+
+    --toggle-button-bg: transparent;
+    --toggle-button-bg-hover: transparent;
+    --toggle-button-bg-pressed: transparent;
+    --toggle-button-bg-selected: var(--surface);
+    --toggle-button-bg-selected-hover: var(--surface);
+    --toggle-button-bg-selected-pressed: var(--surface);
+    --toggle-button-fg-selected: var(--surface-foreground, var(--foreground));
+
+    &:hover, &[data-hovered="true"] {
+      @apply text-foreground;
+    }
+
+    &[data-selected="true"] {
+      @apply shadow-sm text-foreground;
+    }
+
+    & svg {
+      @apply size-4;
+    }
+  }
+
+  .fragment-segmented-control--sm .fragment-segmented-control__item.toggle-button {
+    @apply h-7 px-2.5 text-xs md:h-7;
+  }
+}

package/src/fragments/empty-state/empty-state.css

@@ -0,0 +1,39 @@
+@layer components {
+  .fragment-empty-state {
+    @apply flex flex-col items-center justify-center text-center px-6 py-12;
+  }
+
+  .fragment-empty-state--sm {
+    @apply py-8;
+
+    .fragment-empty-state__icon {
+      @apply size-9 mb-3;
+      & svg {
+        @apply size-[18px];
+      }
+    }
+  }
+
+  .fragment-empty-state--bordered {
+    @apply rounded-2xl border border-dashed border-border bg-surface;
+  }
+
+  .fragment-empty-state__icon {
+    @apply mb-4 flex size-11 items-center justify-center rounded-xl bg-default text-muted;
+    & svg {
+      @apply size-5;
+    }
+  }
+
+  .fragment-empty-state__title {
+    @apply text-sm font-semibold text-foreground;
+  }
+
+  .fragment-empty-state__description {
+    @apply mt-1 max-w-sm text-sm text-muted text-balance;
+  }
+
+  .fragment-empty-state__actions {
+    @apply mt-5 flex flex-wrap items-center justify-center gap-2;
+  }
+}

package/src/fragments/form/form-card.css

@@ -0,0 +1,42 @@
+@layer components {
+  .fragment-form-card {
+    @apply p-0 gap-0 overflow-visible;
+  }
+
+  .fragment-form-card__header {
+    @apply flex items-start gap-4 px-6 pt-5;
+  }
+
+  .fragment-form-card__heading {
+    @apply min-w-0 flex-1;
+  }
+
+  .fragment-form-card__title {
+    @apply text-base font-semibold;
+  }
+
+  .fragment-form-card__description {
+    @apply mt-1 text-sm text-muted;
+  }
+
+  .fragment-form-card__header-end {
+    @apply shrink-0 flex items-center gap-2;
+  }
+
+  .fragment-form-card__body {
+    @apply flex flex-col gap-5 px-6 pt-5 pb-6;
+  }
+
+  .fragment-form-card__footer {
+    @apply flex items-center justify-between gap-3 rounded-b-[inherit] border-t border-separator bg-surface-secondary px-6 py-3
+           text-xs text-muted;
+  }
+
+  .fragment-form-card--danger {
+    @apply border-danger/30;
+
+    .fragment-form-card__title {
+      @apply text-danger;
+    }
+  }
+}

package/src/fragments/form/form-section.css

@@ -1,41 +1,53 @@
 @layer components {
   .fragment-form-section__main {
-    @apply flex flex-col;
+    @apply flex flex-col gap-4;
   }
 
   .fragment-form-section__info {
-    @apply flex-1 pb-4;
+    @apply min-w-0;
   }
 
-  .fragment-form-section__content {
-    @apply flex flex-col gap-4 flex-1 min-w-0;
+  .fragment-form-section__title-row {
+    @apply flex items-center gap-2;
+  }
+
+  .fragment-form-section__title {
+    @apply text-sm font-semibold;
   }
 
   .fragment-form-section__description {
-    @apply text-sm text-muted;
+    @apply mt-1 text-sm text-muted;
+  }
+
+  .fragment-form-section__content {
+    @apply flex flex-col gap-5 flex-1 min-w-0;
   }
 
+  /*
+   * Label column and control column. The label column is narrow and fixed so that, down a long
+   * settings page, every control starts on the same vertical line.
+   */
   .fragment-form-section--horizontal {
     .fragment-form-section__main {
-      @apply sm:flex-row;
+      @apply md:flex-row md:gap-10;
     }
     .fragment-form-section__info {
-      @apply sm:max-w-sm sm:pr-4 sm:pb-0;
+      @apply md:w-72 md:shrink-0;
     }
     .fragment-form-section__content {
-      @apply sm:items-end sm:justify-center sm:max-w-sm;
+      @apply md:max-w-xl;
     }
   }
 
   .fragment-form-section--vertical {
     .fragment-form-section__content {
-      @apply sm:max-w-3xl;
+      @apply md:max-w-3xl;
     }
   }
 
   .fragment-form-section--full-width {
     .fragment-form-section__content {
-      @apply sm:max-w-full;
+      @apply md:max-w-full;
     }
   }
 }

package/src/fragments/form/form.css

@@ -1,5 +1,5 @@
 @layer components {
   .fragment-form__separator {
-    @apply my-6;
+    @apply my-7;
   }
 }

package/src/fragments/navbar/navbar.css

@@ -1,6 +1,6 @@
 @layer components {
   .fragment-navbar__topbar {
-    @apply flex gap-6 items-center px-8 py-5;
+    @apply flex gap-6 items-center px-8 py-5 bg-navbar text-navbar-foreground;
   }
 
   .fragment-navbar__tabs {
@@ -12,7 +12,7 @@
   }
 
   .fragment-navbar__bottom-nav {
-    @apply fixed md:hidden z-50 bottom-0 bg-background flex w-full gap-2 px-2 py-1 border-t border-border;
+    @apply fixed md:hidden z-50 bottom-0 bg-navbar text-navbar-foreground flex w-full gap-2 px-2 py-1 border-t border-border;
     & > *,
     & > * > * {
       @apply h-12 flex-1;

package/src/fragments/page/page-header.css

@@ -1,13 +1,33 @@
 @layer components {
   .fragment-page-header {
-    @apply flex gap-4 justify-between sm:items-end mb-8 flex-col sm:flex-row;
+    @apply flex flex-col gap-5 mb-8;
+  }
+
+  .fragment-page-header--with-footer {
+    @apply mb-6;
+  }
+
+  .fragment-page-header__row {
+    @apply flex gap-4 justify-between flex-col sm:flex-row sm:items-end;
+  }
+
+  .fragment-page-header__heading {
+    @apply min-w-0;
+  }
+
+  .fragment-page-header__eyebrow {
+    @apply mb-1.5 flex items-center gap-1.5 text-xs font-medium text-muted;
   }
 
   .fragment-page-header__description {
-    @apply mt-2 text-muted;
+    @apply mt-1 max-w-2xl text-sm text-muted;
   }
 
   .fragment-page-header__actions {
-    @apply flex gap-4;
+    @apply flex flex-wrap gap-2 items-center shrink-0;
+  }
+
+  .fragment-page-header__footer {
+    @apply min-w-0;
   }
 }