@santi020k/lumen 0.3.0 → 1.0.0

package/styles.css

@@ -26,6 +26,22 @@
   --success: 142 71% 36%;
   --warning: 38 92% 50%;
   --danger: 0 84% 60%;
+  --chart-axis: var(--ink-muted);
+  --chart-diverging-mid: 220 13% 91%;
+  --chart-diverging-negative: 0 84% 60%;
+  --chart-diverging-positive: 221 83% 53%;
+  --chart-grid: var(--line);
+  --chart-sequential-high: 221 83% 40%;
+  --chart-sequential-low: 218 100% 97%;
+  --chart-sequential-mid: 221 83% 67%;
+  --chart-series-1: 221 83% 53%;
+  --chart-series-2: 168 76% 36%;
+  --chart-series-3: 280 72% 56%;
+  --chart-series-4: 25 95% 53%;
+  --chart-series-5: 340 82% 55%;
+  --chart-series-6: 190 82% 42%;
+  --chart-series-7: 52 92% 45%;
+  --chart-series-8: 215 16% 47%;
   --ui-on-danger: 0 0% 0%;
   --ui-radius: 0.625rem;
   --ui-radius-sm: 0.375rem;
@@ -49,7 +65,7 @@
     0 1px 2px hsl(222 47% 11% / 0.08),
     0 12px 32px hsl(222 47% 11% / 0.12),
     0 32px 80px hsl(222 47% 11% / 0.14);
-  --ui-font: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  --ui-font: "Montserrat", "Avenir Next", "Segoe UI", sans-serif;
   --ui-duration-fast: 120ms;
   --ui-duration: 160ms;
   --ui-duration-slow: 300ms;
@@ -75,6 +91,22 @@
   --success: 142 69% 45%;
   --warning: 38 92% 55%;
   --danger: 0 84% 65%;
+  --chart-axis: var(--ink-muted);
+  --chart-diverging-mid: 222 14% 22%;
+  --chart-diverging-negative: 0 84% 65%;
+  --chart-diverging-positive: 199 91% 56%;
+  --chart-grid: var(--line);
+  --chart-sequential-high: 199 91% 66%;
+  --chart-sequential-low: 199 84% 16%;
+  --chart-sequential-mid: 199 72% 42%;
+  --chart-series-1: 199 91% 56%;
+  --chart-series-2: 166 76% 43%;
+  --chart-series-3: 285 82% 72%;
+  --chart-series-4: 31 96% 62%;
+  --chart-series-5: 342 88% 68%;
+  --chart-series-6: 188 86% 54%;
+  --chart-series-7: 52 94% 58%;
+  --chart-series-8: 215 18% 68%;
   --ui-on-danger: var(--canvas);
   --ui-shadow-sm: 0 1px 2px hsl(0 0% 0% / 0.18);
   --ui-shadow-md: 0 12px 32px hsl(0 0% 0% / 0.24);
@@ -243,6 +275,7 @@
   .ui-skeleton,
   .ui-slider,
   .ui-sonner,
+  .ui-sparkline,
   .ui-spinner,
   .ui-switch,
   .ui-table-wrap,
@@ -616,7 +649,47 @@
 }
 
 .ui-card {
-  padding: 1.25rem;
+  --ui-card-gap: 1rem;
+  --ui-card-padding: 1.25rem;
+  --ui-card-section-gap: 0.375rem;
+
+  padding: var(--ui-card-padding);
+}
+
+.ui-card__header {
+  display: grid;
+  gap: var(--ui-card-section-gap);
+}
+
+.ui-card__title {
+  color: hsl(var(--ink));
+  font-size: 1.125rem;
+  font-weight: 700;
+  letter-spacing: -0.015em;
+  line-height: 1.3;
+}
+
+.ui-card__description {
+  color: hsl(var(--ink-muted));
+  font-size: 0.875rem;
+  line-height: 1.55;
+}
+
+.ui-card__content {
+  color: hsl(var(--ink-soft));
+}
+
+.ui-card__footer {
+  align-items: center;
+  display: flex;
+  gap: 0.75rem;
+}
+
+.ui-card > :where(
+  .ui-card__content,
+  .ui-card__footer
+) {
+  margin-block-start: var(--ui-card-gap);
 }
 
 .ui-card--muted {
@@ -639,17 +712,24 @@
 }
 
 .ui-button {
+  --ui-button-font-size: 0.875rem;
+  --ui-button-font-weight: 600;
+  --ui-button-gap: 0.5rem;
+  --ui-button-min-height: 2.5rem;
+  --ui-button-padding: 0.5rem 1rem;
+  --ui-button-radius: var(--ui-radius-sm);
+
   display: inline-flex;
-  min-height: 2.5rem;
+  min-height: var(--ui-button-min-height);
   align-items: center;
   justify-content: center;
-  gap: 0.5rem;
+  gap: var(--ui-button-gap);
   border: 1px solid transparent;
-  border-radius: var(--ui-radius-sm);
-  padding: 0.5rem 1rem;
+  border-radius: var(--ui-button-radius);
+  padding: var(--ui-button-padding);
   cursor: pointer;
-  font-size: 0.875rem;
-  font-weight: 600;
+  font-size: var(--ui-button-font-size);
+  font-weight: var(--ui-button-font-weight);
   line-height: 1.2;
   text-align: center;
   text-decoration: none;
@@ -876,10 +956,13 @@
 }
 
 .ui-link {
+  --ui-link-font-weight: 600;
+  --ui-link-underline-offset: 0.2em;
+
   color: hsl(var(--brand));
-  font-weight: 600;
+  font-weight: var(--ui-link-font-weight);
   text-decoration-thickness: 0.08em;
-  text-underline-offset: 0.2em;
+  text-underline-offset: var(--ui-link-underline-offset);
 }
 
 .ui-link:hover {
@@ -957,21 +1040,20 @@
   min-height: 12rem;
   overflow: hidden;
   border-radius: var(--ui-radius-lg);
-  background-color: hsl(var(--surface-muted));
-  background-image:
-    radial-gradient(circle, hsl(var(--brand) / 0.34) 0 2px, transparent 2.5px),
-    radial-gradient(circle, hsl(var(--accent) / 0.28) 0 1.5px, transparent 2px),
-    radial-gradient(circle, hsl(var(--ink) / 0.14) 0 1px, transparent 1.5px);
-  background-position: 1rem 1rem, 3.5rem 2.5rem, 6rem 4rem;
-  background-size: 7rem 7rem, 9rem 9rem, 5rem 5rem;
-}
-
-.ui-particles[data-ui-particles="low"] {
-  background-size: 11rem 11rem, 14rem 14rem, 9rem 9rem;
+  background: transparent;
 }
 
-.ui-particles[data-ui-particles="high"] {
-  background-size: 4.5rem 4.5rem, 6rem 6rem, 3.5rem 3.5rem;
+.ui-particles__particle {
+  position: absolute;
+  top: var(--ui-particle-top);
+  left: var(--ui-particle-left);
+  width: var(--ui-particle-size);
+  height: var(--ui-particle-size);
+  border-radius: 50%;
+  background: hsl(var(--ui-particle-tone) / 0.25);
+  box-shadow: 0 0 var(--ui-particle-size) hsl(var(--ui-particle-tone) / 0.15);
+  opacity: 0;
+  animation: ui-particle-drift var(--ui-particle-duration) ease-in-out var(--ui-particle-delay) infinite;
 }
 
 .ui-motion-duration-fast {
@@ -1628,6 +1710,16 @@
   transition: width 260ms ease;
 }
 
+.ui-copy-button[data-state="copied"] {
+  border-color: hsl(var(--success));
+  color: hsl(var(--success));
+}
+
+.ui-copy-button[data-state="error"] {
+  border-color: hsl(var(--danger));
+  color: hsl(var(--danger));
+}
+
 .ui-skeleton {
   min-height: 1rem;
   border-radius: var(--ui-radius-sm);
@@ -2102,6 +2194,13 @@
   padding: 0.25rem;
 }
 
+.ui-navigation-menu {
+  --ui-navigation-menu-gap: 0.25rem;
+  --ui-navigation-menu-item-padding: 0.5rem 0.7rem;
+
+  gap: var(--ui-navigation-menu-gap);
+}
+
 .ui-menubar :where(a, button),
 .ui-navigation-menu :where(a, button) {
   border: 0;
@@ -2112,7 +2211,7 @@
   font: inherit;
   font-size: 0.875rem;
   font-weight: 600;
-  padding: 0.5rem 0.7rem;
+  padding: var(--ui-navigation-menu-item-padding);
   text-decoration: none;
 }
 
@@ -2294,6 +2393,9 @@
 }
 
 .ui-code-tabs {
+  --ui-code-tabs-list-padding: 0.375rem;
+  --ui-code-tabs-tab-padding: 0.5rem 0.875rem;
+
   display: block;
   overflow: hidden;
   border: 1px solid hsl(var(--line));
@@ -2309,7 +2411,7 @@
   border-bottom: 1px solid hsl(var(--line));
   border-radius: 0;
   background: hsl(var(--surface));
-  padding: 0.375rem;
+  padding: var(--ui-code-tabs-list-padding);
 }
 
 .ui-code-tabs .ui-code-tabs__tab {
@@ -2321,7 +2423,7 @@
   font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace;
   font-size: 0.8125rem;
   font-weight: 500;
-  padding: 0.5rem 0.875rem;
+  padding: var(--ui-code-tabs-tab-padding);
   transition:
     background-color 150ms ease,
     color 150ms ease;
@@ -2385,6 +2487,8 @@
 
 .ui-table-wrap,
 .ui-data-table {
+  --ui-table-cell-padding: 0.75rem 1rem;
+
   width: 100%;
   overflow-x: auto;
   border: 1px solid hsl(var(--line));
@@ -2404,7 +2508,7 @@
   border-bottom: 1px solid hsl(var(--line));
   color: hsl(var(--ink));
   font-weight: 650;
-  padding: 0.75rem 1rem;
+  padding: var(--ui-table-cell-padding);
   text-align: start;
 }
 
@@ -2425,7 +2529,7 @@
   cursor: pointer;
   font: inherit;
   font-weight: inherit;
-  padding: 0.75rem 1rem;
+  padding: var(--ui-table-cell-padding);
   text-align: inherit;
 }
 
@@ -2467,7 +2571,7 @@
 .ui-data-table td {
   border-bottom: 1px solid hsl(var(--line) / 0.72);
   color: hsl(var(--ink-soft));
-  padding: 0.75rem 1rem;
+  padding: var(--ui-table-cell-padding);
 }
 
 .ui-data-table__selection {
@@ -2572,16 +2676,20 @@
 }
 
 .ui-sidebar {
+  --ui-sidebar-gap: 0.35rem;
+  --ui-sidebar-padding: 0.75rem;
+  --ui-sidebar-width: 18rem;
+
   display: flex;
   min-height: 100%;
-  width: min(18rem, 100%);
+  width: min(var(--ui-sidebar-width), 100%);
   flex-direction: column;
-  gap: 0.35rem;
+  gap: var(--ui-sidebar-gap);
   border: 1px solid hsl(var(--line));
   border-radius: var(--ui-radius-lg);
   background: hsl(var(--surface));
   box-shadow: var(--ui-shadow-sm);
-  padding: 0.75rem;
+  padding: var(--ui-sidebar-padding);
 }
 
 .ui-sidebar a {
@@ -3385,6 +3493,15 @@
   padding: 1rem;
 }
 
+.ui-chart--bare {
+  overflow: visible;
+  border: 0;
+  border-radius: 0;
+  background: transparent;
+  box-shadow: none;
+  padding: 0;
+}
+
 .ui-chart > header {
   display: flex;
   flex-wrap: wrap;
@@ -3393,6 +3510,11 @@
   gap: 0.75rem;
 }
 
+.ui-chart__heading {
+  display: grid;
+  gap: 0.25rem;
+}
+
 .ui-chart h2,
 .ui-chart h3,
 .ui-chart p {
@@ -3413,6 +3535,24 @@
   color: hsl(var(--brand));
 }
 
+.ui-chart__plot {
+  min-width: 0;
+  overflow-x: auto;
+}
+
+.ui-chart__empty {
+  min-height: 10rem;
+  display: grid;
+  margin: 0;
+  color: hsl(var(--ink-muted));
+  place-items: center;
+  text-align: center;
+}
+
+.ui-chart__plot > svg {
+  min-width: 32rem;
+}
+
 .ui-chart svg :where(path, polyline, line) {
   vector-effect: non-scaling-stroke;
   stroke-linecap: round;
@@ -3425,6 +3565,273 @@
   line-height: 1.5;
 }
 
+.ui-chart__legend {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem 1rem;
+  margin: 0;
+  padding: 0;
+  color: hsl(var(--ink-soft));
+  font-size: 0.75rem;
+  list-style: none;
+}
+
+.ui-chart__legend li {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.4rem;
+}
+
+.ui-chart__legend li > span {
+  width: 0.65rem;
+  height: 0.65rem;
+  border: 2px solid var(--ui-chart-color);
+  border-radius: 999px;
+  background: color-mix(in srgb, var(--ui-chart-color) 30%, transparent);
+}
+
+.ui-chart__grid line {
+  stroke: hsl(var(--chart-grid) / 0.72);
+  stroke-width: 1;
+}
+
+.ui-chart__grid text,
+.ui-chart__axis-labels text {
+  fill: hsl(var(--chart-axis));
+  font-size: 0.6875rem;
+}
+
+.ui-chart__grid text {
+  dominant-baseline: middle;
+  text-anchor: end;
+}
+
+.ui-chart__reference {
+  stroke: hsl(var(--ink-muted));
+  stroke-dasharray: 5 5;
+  stroke-width: 1.5;
+}
+
+.ui-chart__data {
+  border-top: 1px solid hsl(var(--line));
+  color: hsl(var(--ink-soft));
+  font-size: 0.8125rem;
+  padding-block-start: 0.75rem;
+}
+
+.ui-chart__data summary {
+  width: fit-content;
+  border-radius: var(--ui-radius-sm);
+  color: hsl(var(--brand));
+  cursor: pointer;
+  font-weight: 700;
+}
+
+.ui-chart__data summary:focus-visible {
+  outline: 2px solid hsl(var(--brand) / 0.72);
+  outline-offset: 0.2rem;
+}
+
+.ui-chart__data > div {
+  overflow-x: auto;
+  margin-block-start: 0.75rem;
+}
+
+.ui-chart__data table {
+  width: 100%;
+  border-collapse: collapse;
+}
+
+.ui-chart__data :where(th, td) {
+  border-bottom: 1px solid hsl(var(--line));
+  padding: 0.5rem;
+  text-align: end;
+  white-space: nowrap;
+}
+
+.ui-chart__data :where(th, td):first-child {
+  text-align: start;
+}
+
+.ui-chart__data th {
+  color: hsl(var(--ink));
+  font-weight: 700;
+}
+
+.ui-chart-tone--series-1 {
+  --ui-chart-color: hsl(var(--chart-series-1));
+}
+
+.ui-chart-tone--series-2 {
+  --ui-chart-color: hsl(var(--chart-series-2));
+}
+
+.ui-chart-tone--series-3 {
+  --ui-chart-color: hsl(var(--chart-series-3));
+}
+
+.ui-chart-tone--series-4 {
+  --ui-chart-color: hsl(var(--chart-series-4));
+}
+
+.ui-chart-tone--series-5 {
+  --ui-chart-color: hsl(var(--chart-series-5));
+}
+
+.ui-chart-tone--series-6 {
+  --ui-chart-color: hsl(var(--chart-series-6));
+}
+
+.ui-chart-tone--series-7 {
+  --ui-chart-color: hsl(var(--chart-series-7));
+}
+
+.ui-chart-tone--series-8 {
+  --ui-chart-color: hsl(var(--chart-series-8));
+}
+
+.ui-chart-tone--brand {
+  --ui-chart-color: hsl(var(--brand));
+}
+
+.ui-chart-tone--accent {
+  --ui-chart-color: hsl(var(--accent));
+}
+
+.ui-chart-tone--success {
+  --ui-chart-color: hsl(var(--success));
+}
+
+.ui-chart-tone--warning {
+  --ui-chart-color: hsl(var(--warning));
+}
+
+.ui-chart-tone--danger {
+  --ui-chart-color: hsl(var(--danger));
+}
+
+.ui-chart-tone--neutral {
+  --ui-chart-color: hsl(var(--ink-muted));
+}
+
+.ui-bar-chart__marks rect {
+  fill: var(--ui-chart-color);
+}
+
+.ui-pie-chart__plot {
+  position: relative;
+  display: grid;
+  overflow: visible;
+  place-items: center;
+}
+
+.ui-pie-chart__plot > svg {
+  z-index: 0;
+  grid-area: 1 / 1;
+  width: min(100%, 20rem);
+  min-width: 0;
+  min-height: 0;
+  aspect-ratio: 1;
+}
+
+.ui-pie-chart__slices path {
+  fill: var(--ui-chart-color);
+  stroke: hsl(var(--surface));
+  stroke-width: 2;
+}
+
+.ui-pie-chart__center {
+  z-index: 1;
+  display: grid;
+  grid-area: 1 / 1;
+  max-width: 7rem;
+  gap: 0.2rem;
+  place-items: center;
+  text-align: center;
+  pointer-events: none;
+}
+
+.ui-pie-chart__center strong {
+  color: hsl(var(--ink));
+  font-size: clamp(1.35rem, 5vw, 2rem);
+  line-height: 1;
+}
+
+.ui-pie-chart__center span {
+  color: hsl(var(--ink-muted));
+  font-size: 0.75rem;
+  line-height: 1.25;
+}
+
+.ui-line-chart__line,
+.ui-sparkline__line {
+  fill: none;
+  stroke: var(--ui-chart-color);
+  stroke-width: 2.5;
+}
+
+.ui-line-chart__area,
+.ui-sparkline__area {
+  fill: color-mix(in srgb, var(--ui-chart-color) 18%, transparent);
+  stroke: none;
+}
+
+.ui-line-chart__point,
+.ui-sparkline__endpoint {
+  fill: hsl(var(--surface));
+  stroke: var(--ui-chart-color);
+  stroke-width: 2;
+}
+
+.ui-line-chart__series.ui-chart-tone--series-2 .ui-line-chart__line {
+  stroke-dasharray: 8 5;
+}
+
+.ui-line-chart__series.ui-chart-tone--series-3 .ui-line-chart__line {
+  stroke-dasharray: 3 4;
+}
+
+.ui-line-chart__series.ui-chart-tone--series-4 .ui-line-chart__line {
+  stroke-dasharray: 10 4 2 4;
+}
+
+.ui-line-chart__series:is(
+  .ui-chart-tone--series-5,
+  .ui-chart-tone--series-6,
+  .ui-chart-tone--series-7,
+  .ui-chart-tone--series-8
+) .ui-line-chart__line {
+  stroke-dasharray: 2 5;
+}
+
+.ui-sparkline {
+  display: inline-flex;
+  width: 8rem;
+  height: 2.5rem;
+  color: hsl(var(--ink));
+}
+
+.ui-sparkline svg {
+  display: block;
+  width: 100%;
+  height: 100%;
+  overflow: visible;
+}
+
+@media (prefers-reduced-motion: no-preference) {
+  .ui-pie-chart__slices path {
+    transition:
+      opacity var(--ui-duration-fast) var(--ui-ease),
+      transform var(--ui-duration-fast) var(--ui-ease);
+    transform-box: fill-box;
+    transform-origin: center;
+  }
+
+  .ui-pie-chart__slices path:hover {
+    transform: scale(1.025);
+  }
+}
+
 .ui-sonner {
   position: fixed;
   z-index: 50;
@@ -3499,10 +3906,12 @@
 }
 
 .ui-theme-toggle {
+  --ui-theme-toggle-size: 2.75rem;
+
   position: relative;
   display: flex;
-  height: 2.75rem;
-  width: 2.75rem;
+  height: var(--ui-theme-toggle-size);
+  width: var(--ui-theme-toggle-size);
   cursor: pointer;
   align-items: center;
   justify-content: center;
@@ -4053,6 +4462,7 @@
 .ui-date-picker-field--glass .ui-date-picker__popover,
 .ui-select-field--glass .ui-select__list,
 .ui-sidebar--glass,
+.ui-stat--glass,
 .ui-table-wrap--glass,
 .ui-tabs--glass,
 .ui-theme-builder--glass,
@@ -4250,6 +4660,7 @@
   .ui-date-picker-field--glass .ui-date-picker__popover,
   .ui-select-field--glass .ui-select__list,
   .ui-sidebar--glass,
+  .ui-stat--glass,
   .ui-table-wrap--glass,
   .ui-tabs--glass,
   .ui-theme-builder--glass,
@@ -4706,10 +5117,10 @@
     opacity: 0;
   }
   10% {
-    opacity: 0.15;
+    opacity: 0.9;
   }
   90% {
-    opacity: 0.1;
+    opacity: 0.7;
   }
   100% {
     transform: translateY(-100vh) translateX(20px);
@@ -4717,17 +5128,62 @@
   }
 }
 
+@media (prefers-reduced-motion: reduce) {
+  .ui-particles__particle {
+    display: none;
+    animation: none;
+  }
+}
+
 .ui-stat {
+  --ui-stat-gap: 0.25rem;
+  --ui-stat-padding: 1rem;
+
   display: flex;
   flex-direction: column;
-  gap: 0.25rem;
-  padding: 1rem;
+  gap: var(--ui-stat-gap);
+  padding: var(--ui-stat-padding);
   background: hsl(var(--surface));
   border: 1px solid hsl(var(--line));
   border-radius: 0.5rem;
 }
-.ui-stat-label {
-  font-size: 0.875rem;
+
+.ui-stat--accent,
+.ui-stat--glass {
+  --ui-stat-gap: 0.5rem;
+  --ui-stat-padding: 1.25rem;
+
+  border-radius: var(--ui-radius-lg);
+}
+
+.ui-stat--bare {
+  --ui-stat-padding: 0;
+
+  background: transparent;
+  border: 0;
+  border-radius: 0;
+}
+
+.ui-stat--accent {
+  border-color: hsl(var(--brand) / 0.2);
+  background: linear-gradient(145deg, hsl(var(--surface)), hsl(var(--brand-soft) / 0.28));
+  box-shadow: var(--ui-shadow-sm);
+}
+
+.ui-stat--accent .ui-stat-value,
+.ui-stat--glass .ui-stat-value {
+  font-size: 2rem;
+  font-weight: 700;
+  line-height: 1.1;
+  letter-spacing: -0.025em;
+}
+
+.ui-stat--accent .ui-stat-value {
+  color: hsl(var(--brand));
+}
+
+.ui-stat-label {
+  font-size: 0.875rem;
   color: hsl(var(--ink-muted));
 }
 .ui-stat-value {
@@ -4736,6 +5192,43 @@
   color: hsl(var(--ink));
 }
 
+.ui-stat-description {
+  color: hsl(var(--ink-soft));
+  font-size: 0.875rem;
+  line-height: 1.5;
+}
+
+.ui-stat-icon {
+  align-items: center;
+  color: hsl(var(--brand));
+  display: inline-flex;
+  justify-content: center;
+}
+
+.ui-stat-trend {
+  align-items: center;
+  display: inline-flex;
+  font-size: 0.8125rem;
+  font-weight: 650;
+  gap: 0.25rem;
+}
+
+.ui-stat-trend--neutral {
+  color: hsl(var(--ink-muted));
+}
+
+.ui-stat-trend--success {
+  color: hsl(var(--success));
+}
+
+.ui-stat-trend--warning {
+  color: hsl(var(--warning));
+}
+
+.ui-stat-trend--danger {
+  color: hsl(var(--danger));
+}
+
 .ui-rating {
   display: flex;
   gap: 0.25rem;
@@ -4890,6 +5383,17 @@
   white-space: nowrap;
 }
 
+.ui-pill--brand {
+  border-color: hsl(var(--brand) / 0.34);
+  background: hsl(var(--brand-soft) / 0.72);
+  color: hsl(var(--brand));
+}
+
+.ui-pill--outline {
+  background: transparent;
+  color: hsl(var(--ink-soft));
+}
+
 .ui-pill__count {
   margin-left: 0.5rem;
   padding-left: 0.5rem;
@@ -4902,6 +5406,7 @@
 
 a.ui-pill {
   cursor: pointer;
+  min-height: 2.75rem;
   text-decoration: none;
 }
 
@@ -4910,6 +5415,47 @@ a.ui-pill:hover {
   color: hsl(var(--brand-solid));
 }
 
+a.ui-pill--brand:hover {
+  border-color: hsl(var(--brand) / 0.6);
+  background: hsl(var(--brand-solid));
+  color: hsl(var(--canvas));
+}
+
+a.ui-pill:focus-visible {
+  outline: 2px solid hsl(var(--brand));
+  outline-offset: 2px;
+}
+
+.ui-scroll-progress {
+  position: fixed;
+  inset: 0 0 auto;
+  z-index: 9999;
+  height: 0.1875rem;
+  overflow: hidden;
+  pointer-events: none;
+  background: hsl(var(--surface-strong) / 0.48);
+}
+
+.ui-scroll-progress--bottom {
+  inset: auto 0 0;
+}
+
+.ui-scroll-progress__bar {
+  display: block;
+  width: 100%;
+  height: 100%;
+  transform: scaleX(0);
+  transform-origin: left;
+  background: hsl(var(--brand-solid));
+  will-change: transform;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .ui-scroll-progress__bar {
+    transition: none;
+  }
+}
+
 /* CoverImage hover lift + bottom gradient overlay */
 .ui-cover-image--hover {
   transition: transform 300ms ease;
@@ -5241,7 +5787,9 @@ a.ui-pill:hover {
   padding: 0;
 }
 .ui-anchor a {
-  display: block;
+  display: flex;
+  align-items: start;
+  gap: 0.5rem;
   padding: 0.25rem 0.75rem;
   margin-left: -2px;
   border-left: 2px solid transparent;
@@ -5249,10 +5797,34 @@ a.ui-pill:hover {
   text-decoration: none;
   font-size: 0.875rem;
 }
+.ui-anchor__content {
+  display: grid;
+  gap: 0.125rem;
+}
+.ui-anchor__index,
+.ui-anchor__description {
+  color: hsl(var(--ink-muted));
+  font-size: var(--ui-text-xs);
+}
+.ui-anchor__index {
+  min-width: 2ch;
+  font-variant-numeric: tabular-nums;
+}
+.ui-anchor a[data-depth="3"] {
+  padding-inline-start: 1.5rem;
+  font-size: 0.8125rem;
+}
+.ui-anchor a[data-depth="4"],
+.ui-anchor a[data-depth="5"],
+.ui-anchor a[data-depth="6"] {
+  padding-inline-start: 2.25rem;
+  font-size: 0.8125rem;
+}
 .ui-anchor a:hover {
   color: hsl(var(--ink));
 }
-.ui-anchor a[data-active="true"] {
+.ui-anchor a[data-active="true"],
+.ui-anchor a[aria-current="location"] {
   color: hsl(var(--brand));
   border-left-color: hsl(var(--brand));
   font-weight: 600;
@@ -5894,3 +6466,347 @@ a.ui-pill:hover {
 .ui-tree-select__option[data-active="true"] {
   background: hsl(var(--surface-muted));
 }
+
+/* ---------------------------------------------------------------------------
+ * Form foundations and layout primitives
+ * ------------------------------------------------------------------------- */
+
+@layer lumen.components {
+  .ui-form {
+    display: grid;
+    gap: 1rem;
+  }
+
+  .ui-form[aria-busy="true"] {
+    cursor: progress;
+  }
+
+  .ui-field-error {
+    margin: 0;
+    color: hsl(var(--danger));
+    font-size: 0.8125rem;
+    line-height: 1.5;
+  }
+
+  .ui-error-summary {
+    display: grid;
+    gap: 0.625rem;
+    padding: 1rem;
+    border: 1px solid hsl(var(--danger) / 0.45);
+    border-inline-start-width: 0.25rem;
+    border-radius: var(--ui-radius);
+    background: hsl(var(--danger) / 0.06);
+    color: hsl(var(--ink));
+  }
+
+  .ui-error-summary:focus-visible {
+    outline: 2px solid hsl(var(--danger));
+    outline-offset: 2px;
+  }
+
+  .ui-error-summary > :where(h2, h3) {
+    margin: 0;
+    font-size: 1rem;
+  }
+
+  .ui-error-summary ul {
+    display: grid;
+    gap: 0.25rem;
+    margin: 0;
+    padding-inline-start: 1.25rem;
+  }
+
+  .ui-error-summary a {
+    color: hsl(var(--danger));
+    font-weight: 650;
+    text-underline-offset: 0.18em;
+  }
+
+  .ui-checkbox-group {
+    display: flex;
+    min-width: 0;
+    gap: 0.75rem;
+    padding: 0;
+    border: 0;
+    margin: 0;
+  }
+
+  .ui-checkbox-group--vertical {
+    flex-direction: column;
+  }
+
+  .ui-checkbox-group--horizontal {
+    flex-flow: row wrap;
+    align-items: center;
+  }
+
+  .ui-checkbox-group > legend {
+    padding: 0;
+    margin-block-end: 0.25rem;
+    color: hsl(var(--ink));
+    font-size: 0.875rem;
+    font-weight: 650;
+  }
+
+  .ui-checkbox-group[aria-invalid="true"],
+  .ui-checkbox-group[data-invalid="true"] {
+    color: hsl(var(--danger));
+  }
+
+  .ui-password-field__control {
+    position: relative;
+    display: grid;
+    align-items: center;
+  }
+
+  .ui-password-field__control > .ui-input {
+    grid-area: 1 / 1;
+    padding-inline-end: 3.25rem;
+  }
+
+  .ui-password-field__control > .ui-button {
+    z-index: 1;
+    grid-area: 1 / 1;
+    justify-self: end;
+    margin-inline-end: 0.25rem;
+  }
+
+  .ui-password-field__control > .ui-button span {
+    font-size: 0.6875rem;
+  }
+
+  .ui-list-box {
+    display: grid;
+    gap: 0.375rem;
+  }
+
+  .ui-list-box__native[data-ui-enhanced],
+  .ui-list-box__native[data-ui-list-box-enhanced="true"] {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    clip-path: inset(50%);
+    white-space: nowrap;
+  }
+
+  .ui-list-box__list {
+    display: grid;
+    max-height: 18rem;
+    overflow: auto;
+    padding: 0.25rem;
+    border: 1px solid hsl(var(--line));
+    border-radius: var(--ui-radius);
+    background: hsl(var(--surface));
+    box-shadow: var(--ui-shadow-sm);
+  }
+
+  .ui-list-box__list:focus-visible {
+    outline: 2px solid hsl(var(--brand));
+    outline-offset: 2px;
+  }
+
+  .ui-list-box__section {
+    padding: 0.5rem 0.625rem 0.25rem;
+    color: hsl(var(--ink-muted));
+    font-size: 0.75rem;
+    font-weight: 700;
+    letter-spacing: 0.04em;
+    text-transform: uppercase;
+  }
+
+  .ui-list-box__empty,
+  .ui-list-box__status {
+    padding: 0.75rem 0.625rem;
+    color: hsl(var(--ink-muted));
+    font-size: 0.875rem;
+  }
+
+  .ui-list-box__option,
+  [data-ui-list-box-option] {
+    padding: 0.5rem 0.625rem;
+    border-radius: var(--ui-radius-sm);
+    color: hsl(var(--ink));
+    cursor: default;
+    font-size: 0.875rem;
+  }
+
+  .ui-list-box__option--active,
+  [data-ui-list-box-option][data-active="true"] {
+    background: hsl(var(--surface-muted));
+  }
+
+  .ui-list-box__option[aria-selected="true"],
+  [data-ui-list-box-option][aria-selected="true"] {
+    background: hsl(var(--brand-soft));
+    color: hsl(var(--brand-solid));
+    font-weight: 650;
+  }
+
+  .ui-list-box__option[aria-disabled="true"],
+  [data-ui-list-box-option][aria-disabled="true"] {
+    opacity: 0.5;
+  }
+
+  .ui-container {
+    width: min(100% - 2rem, var(--ui-container-max, 72rem));
+    margin-inline: auto;
+  }
+
+  .ui-container--sm {
+    --ui-container-max: 40rem;
+  }
+
+  .ui-container--md {
+    --ui-container-max: 56rem;
+  }
+
+  .ui-container--lg {
+    --ui-container-max: 72rem;
+  }
+
+  .ui-container--full {
+    width: 100%;
+    max-width: none;
+  }
+
+  .ui-stack {
+    display: flex;
+    min-width: 0;
+    gap: var(--ui-stack-gap, 1rem);
+  }
+
+  .ui-stack--vertical {
+    flex-direction: column;
+  }
+
+  .ui-stack--horizontal {
+    flex-direction: row;
+  }
+
+  .ui-stack--wrap {
+    flex-wrap: wrap;
+  }
+
+  .ui-stack--gap-none,
+  .ui-grid--gap-none {
+    --ui-stack-gap: 0;
+    --ui-grid-gap: 0;
+  }
+
+  .ui-stack--gap-sm,
+  .ui-grid--gap-sm {
+    --ui-stack-gap: 0.5rem;
+    --ui-grid-gap: 0.5rem;
+  }
+
+  .ui-stack--gap-md,
+  .ui-grid--gap-md {
+    --ui-stack-gap: 1rem;
+    --ui-grid-gap: 1rem;
+  }
+
+  .ui-stack--gap-lg,
+  .ui-grid--gap-lg {
+    --ui-stack-gap: 1.5rem;
+    --ui-grid-gap: 1.5rem;
+  }
+
+  .ui-stack--gap-xl,
+  .ui-grid--gap-xl {
+    --ui-stack-gap: 2rem;
+    --ui-grid-gap: 2rem;
+  }
+
+  .ui-stack--align-start {
+    align-items: flex-start;
+  }
+
+  .ui-stack--align-center {
+    align-items: center;
+  }
+
+  .ui-stack--align-end {
+    align-items: flex-end;
+  }
+
+  .ui-stack--align-stretch {
+    align-items: stretch;
+  }
+
+  .ui-stack--justify-start {
+    justify-content: flex-start;
+  }
+
+  .ui-stack--justify-center {
+    justify-content: center;
+  }
+
+  .ui-stack--justify-end {
+    justify-content: flex-end;
+  }
+
+  .ui-stack--justify-between {
+    justify-content: space-between;
+  }
+
+  .ui-grid {
+    display: grid;
+    min-width: 0;
+    grid-template-columns: repeat(
+      auto-fit,
+      minmax(min(100%, var(--ui-grid-min, 16rem)), 1fr)
+    );
+    gap: var(--ui-grid-gap, 1rem);
+  }
+
+  .ui-grid--columns-1 {
+    grid-template-columns: repeat(1, minmax(0, 1fr));
+  }
+
+  .ui-grid--columns-2 {
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+  }
+
+  .ui-grid--columns-3 {
+    grid-template-columns: repeat(3, minmax(0, 1fr));
+  }
+
+  .ui-grid--columns-4 {
+    grid-template-columns: repeat(4, minmax(0, 1fr));
+  }
+
+  .ui-grid--columns-6 {
+    grid-template-columns: repeat(6, minmax(0, 1fr));
+  }
+
+  .ui-grid--columns-12 {
+    grid-template-columns: repeat(12, minmax(0, 1fr));
+  }
+
+  .ui-visually-hidden {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    padding: 0;
+    border: 0;
+    margin: -1px;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    clip-path: inset(50%);
+    white-space: nowrap;
+  }
+
+  .ui-visually-hidden--focusable:focus,
+  .ui-visually-hidden--focusable:focus-within {
+    position: static;
+    width: auto;
+    height: auto;
+    margin: 0;
+    overflow: visible;
+    clip: auto;
+    clip-path: none;
+    white-space: normal;
+  }
+}