@fragment-build/ui 3.3.0 → 4.0.1

package/index.css

@@ -1,7 +1,12 @@
-@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.
@@ -20,39 +25,64 @@
 
 @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;
   }
 
-  .input-group, .search-field__group, .number-field__group{
-    @apply border border-border shadow-none h-auto;
+  /*
+   * Text that has to fit, in any language. Single-line controls keep one line and end in an
+   * ellipsis when a translation is longer than the room it has: HeroUI breaks a Select's value
+   * onto a second line instead ("Alle / Oberflächen"), which grows the trigger out of its row.
+   * The trigger may shrink, so the ellipsis — not an overflow — is what absorbs the difference.
+   */
+  .select__trigger {
+    @apply min-w-0 items-center;
+  }
 
-    .input-group__input, .search-field__input, .number-field__input {
-      @apply px-6 py-4;
-    }
+  .select__value {
+    @apply min-w-0 truncate;
+    overflow-wrap: normal;
   }
 
+  .chip {
+    @apply max-w-full whitespace-nowrap;
+  }
+
+  /* The thumb keeps HeroUI's accent ring: transparent, only a white knob was left, invisible on a white card. */
   .slider {
-    .slider__thumb {
-      @apply bg-transparent;
-    }
     &[data-orientation="horizontal"] {
       .slider__track {
         @apply h-1;
@@ -65,33 +95,38 @@
     }
   }
 
-  .select__indicator {
-    @apply right-4;
+  .select__popover {
+    @apply rounded-xl;
   }
 
-  .select__trigger:has(.select__indicator) {
-    @apply pr-10;
+  /*
+   * HeroUI sets a modal's body in the muted colour, which suits a one-line confirmation and greys
+   * out every heading and label in a dialog that holds a form. Body copy is ink here; a dialog that
+   * only says something mutes its own message. The heading gets the weight of a page section.
+   */
+  .modal__body {
+    @apply text-foreground;
   }
 
-  .select__popover {
-    @apply rounded-xl;
+  .modal__heading {
+    @apply text-lg font-semibold;
   }
 
   .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;
         }
       }
 
@@ -101,7 +136,7 @@
     }
 
     .tabs__tab {
-      @apply h-10 px-6 text-xs text-nowrap;
+      @apply h-8 px-4 text-sm text-nowrap;
     }
 
     .tabs__list {
@@ -110,25 +145,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);
   }
 }
 
@@ -139,10 +238,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,

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.3.0",
+  "version": "4.0.1",
   "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/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;
   }
 }

package/src/fragments/save-bar/save-bar.css

@@ -0,0 +1,28 @@
+@layer components {
+  /* Sticky inside the form rather than fixed to the viewport, so it never needs to know how wide the rail is. */
+  /* Takes no room while hidden, so a clean form ends where its last field does. */
+  .fragment-save-bar {
+    @apply pointer-events-none sticky bottom-20 z-30 flex h-0 justify-center overflow-visible md:bottom-6;
+    @apply translate-y-4 opacity-0 transition-[opacity,translate] duration-200 motion-reduce:transition-none;
+  }
+
+  .fragment-save-bar--visible {
+    @apply pointer-events-auto mt-6 h-auto translate-y-0 opacity-100;
+  }
+
+  .fragment-save-bar__bar {
+    @apply flex w-full max-w-2xl items-center justify-between gap-4 rounded-2xl border border-border bg-overlay py-2 pr-2 pl-4
+           text-sm shadow-lg;
+  }
+
+  .fragment-save-bar__message {
+    @apply flex items-center gap-2 font-medium text-foreground;
+    & svg {
+      @apply shrink-0 text-warning;
+    }
+  }
+
+  .fragment-save-bar__actions {
+    @apply flex shrink-0 items-center gap-1;
+  }
+}

package/src/fragments/shell/shell.css

@@ -7,16 +7,20 @@
     @apply flex-col;
   }
 
+  /*
+   * The content column is capped at a width a table or a two-column dashboard still reads well at.
+   * Past ~1600px the eye travels too far between a label and its value, and a wide monitor is
+   * better spent on margin than on stretching every card.
+   */
   .fragment-shell__main {
-    @apply flex-1 min-w-0 mx-auto;
+    @apply flex-1 min-w-0 mx-auto w-full;
 
     .fragment-shell--horizontal & {
-      @apply px-8 lg:px-12 xl:px-20 py-14 max-w-[2100px];
+      @apply px-4 sm:px-6 lg:px-10 pt-6 pb-24 md:pt-8 md:pb-12 max-w-[1600px];
     }
 
     .fragment-shell--vertical & {
-      @apply px-8 py-6 max-w-[2100px] w-full;
+      @apply px-4 sm:px-6 lg:px-10 py-6 max-w-[1600px];
     }
-
   }
 }