@star-ng/ui 0.0.0-stage → 0.1.0

package/styles/_tokens.scss

@@ -0,0 +1,190 @@
+// StarNG design tokens. Every control reads these CSS custom properties; nothing else sets a
+// color, a radius, a shadow or a font. A product changes the look by redefining them:
+//
+//   :root {
+//     --star-primary: #0f766e;
+//     --star-primary-hover: #115e59;
+//     --star-primary-soft: #ccfbf1;
+//   }
+//   [data-theme='dark'] {
+//     --star-primary: #2dd4bf;
+//   }
+//
+// Theme switch: `data-theme="light"` or `data-theme="dark"` on `<html>` (see `@star-ng/ui/theme`).
+// Without the attribute the light values apply.
+
+:root,
+[data-theme='light'] {
+  color-scheme: light;
+
+  // Color roles
+  --star-primary: #4f46e5;
+  --star-primary-hover: #4338ca;
+  --star-primary-soft: #e0e7ff;
+  --star-accent: #0369a1;
+  --star-accent-soft: #e0f2fe;
+  --star-success: #16a34a;
+  --star-success-soft: #dcfce7;
+  --star-warning: #d97706;
+  --star-warning-soft: #fef3c7;
+  --star-danger: #dc2626;
+  --star-danger-hover: #b91c1c;
+  --star-danger-soft: #fef2f2;
+
+  // Surfaces, borders and text
+  --star-surface: #ffffff;
+  --star-surface-muted: #f8fafc;
+  --star-border: #e2e8f0;
+  --star-border-strong: #cbd5e1;
+  --star-text-strong: #0f172a;
+  --star-text: #1e293b;
+  --star-text-muted: #64748b;
+  --star-text-soft: #94a3b8;
+
+  // Shadows
+  --star-shadow-xs: 0 1px 2px rgba(15, 23, 42, 0.04);
+  --star-shadow-sm: 0 1px 3px rgba(15, 23, 42, 0.04), 0 1px 2px rgba(15, 23, 42, 0.02);
+  --star-shadow-md: 0 4px 12px rgba(15, 23, 42, 0.08);
+  --star-shadow-lg: 0 8px 24px -8px rgba(15, 23, 42, 0.1);
+  --star-shadow-xl: 0 12px 32px -8px rgba(15, 23, 42, 0.12);
+  --star-shadow-card: 0 1px 3px rgba(15, 23, 42, 0.06), 0 8px 24px -12px rgba(15, 23, 42, 0.12);
+  --star-shadow-modal: 0 30px 100px -20px rgba(0, 0, 0, 0.25);
+  --star-shadow-float: 0 20px 60px -10px rgba(15, 23, 42, 0.4);
+  // Glow under a primary button. `none` by default; a product can set a colored glow.
+  --star-shadow-glow-primary: none;
+  // Focus rings: `--star-focus-ring` for text controls and buttons,
+  // `--star-focus-ring-primary` for controls that fill with the primary color.
+  --star-focus-ring: 0 0 0 4px rgba(3, 105, 161, 0.18);
+  --star-focus-ring-primary: 0 0 0 4px rgba(79, 70, 229, 0.2);
+
+  // Glass and scrims
+  --star-glass-surface: rgba(255, 255, 255, 0.7);
+  --star-glass-surface-strong: rgba(255, 255, 255, 0.92);
+  --star-glass-border: rgba(255, 255, 255, 0.6);
+  --star-scrim: rgba(15, 23, 42, 0.9);
+  --star-scrim-modal: rgba(15, 23, 42, 0.6);
+  --star-tooltip-surface: #0f172a;
+
+  // Chart series (star-chart, star-meter-group). Fixed order, never cycled. Both themes pass the
+  // categorical checks (lightness, chroma, adjacent-pair color-vision and normal-vision distance).
+  // Some slots are under 3:1 on white, so every chart also offers its data as a table.
+  --star-chart-1: #2a78d6;
+  --star-chart-2: #eb6834;
+  --star-chart-3: #1baf7a;
+  --star-chart-4: #eda100;
+  --star-chart-5: #e87ba4;
+  --star-chart-6: #008300;
+  --star-chart-7: #6250d6;
+  --star-chart-8: #e34948;
+}
+
+[data-theme='dark'] {
+  color-scheme: dark;
+
+  --star-primary: #818cf8;
+  --star-primary-hover: #a5b4fc;
+  --star-primary-soft: #272a57;
+  --star-accent: #38bdf8;
+  --star-accent-soft: #0c2f47;
+  --star-success: #4ade80;
+  --star-success-soft: #0f2e1c;
+  --star-warning: #fbbf24;
+  --star-warning-soft: #3a2a06;
+  --star-danger: #f87171;
+  --star-danger-hover: #fca5a5;
+  --star-danger-soft: #3a1414;
+
+  --star-surface: #0f1216;
+  --star-surface-muted: #191d24;
+  --star-border: #2b3341;
+  --star-border-strong: #3d4a5c;
+  --star-text-strong: #f8fafc;
+  --star-text: #e2e8f0;
+  --star-text-muted: #94a3b8;
+  --star-text-soft: #64748b;
+
+  --star-focus-ring: 0 0 0 4px rgba(56, 189, 248, 0.25);
+  --star-focus-ring-primary: 0 0 0 4px rgba(129, 140, 248, 0.3);
+
+  --star-glass-surface: rgba(255, 255, 255, 0.04);
+  --star-glass-surface-strong: rgba(25, 29, 36, 0.92);
+  --star-glass-border: rgba(255, 255, 255, 0.08);
+  --star-scrim-modal: rgba(0, 0, 0, 0.65);
+
+  --star-chart-1: #3987e5;
+  --star-chart-2: #d95926;
+  --star-chart-3: #199e70;
+  --star-chart-4: #c98500;
+  --star-chart-5: #d55181;
+  --star-chart-6: #008300;
+  --star-chart-7: #9085e9;
+  --star-chart-8: #e66767;
+}
+
+:root {
+  // Spacing
+  --star-space-1: 0.25rem;
+  --star-space-2: 0.5rem;
+  --star-space-3: 0.75rem;
+  --star-space-4: 1rem;
+  --star-space-5: 1.25rem;
+  --star-space-6: 1.5rem;
+  --star-space-7: 1.75rem;
+  --star-space-8: 2rem;
+  --star-space-10: 2.5rem;
+  --star-space-12: 3rem;
+  --star-control-height: 2.75rem;
+
+  // Radius
+  --star-radius-xs: 4px;
+  --star-radius-sm: 6px;
+  --star-radius-md: 8px;
+  --star-radius-lg: 12px;
+  --star-radius-xl: 16px;
+  --star-radius-2xl: 20px;
+  --star-radius-3xl: 24px;
+  --star-radius-4xl: 28px;
+  --star-radius-pill: 9999px;
+
+  // Typography: system font stacks, no font files to load.
+  --star-font-sans:
+    system-ui, -apple-system, 'Segoe UI', Roboto, 'Helvetica Neue', 'Noto Sans', Arial, sans-serif;
+  --star-font-mono:
+    ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', monospace;
+  --star-type-eyebrow: 700 10px/14px var(--star-font-sans);
+  --star-type-label: 600 12px/16px var(--star-font-sans);
+  --star-type-body-sm: 400 12px/18px var(--star-font-sans);
+  --star-type-body: 400 13px/20px var(--star-font-sans);
+  --star-type-body-lg: 400 14px/22px var(--star-font-sans);
+  --star-type-title-sm: 600 16px/22px var(--star-font-sans);
+  --star-type-title: 600 18px/24px var(--star-font-sans);
+  --star-type-title-lg: 700 22px/28px var(--star-font-sans);
+  --star-type-display: 700 28px/34px var(--star-font-sans);
+  --star-type-code: 400 13px/20px var(--star-font-mono);
+
+  // Component typography. A product with a stronger voice can set, for example,
+  // `--star-button-text-transform: uppercase` and `--star-button-letter-spacing: 0.08em`.
+  --star-button-font-weight: 600;
+  --star-button-text-transform: none;
+  --star-button-letter-spacing: normal;
+  --star-button-radius: var(--star-radius-md);
+  --star-label-font-weight: 600;
+  --star-label-text-transform: none;
+  --star-label-letter-spacing: normal;
+  --star-input-radius: var(--star-radius-md);
+  --star-input-font-weight: 400;
+
+  // Backdrop blur
+  --star-blur-xs: 4px;
+  --star-blur-sm: 6px;
+  --star-blur-md: 8px;
+  --star-blur-lg: 10px;
+  --star-blur-xl: 12px;
+  --star-blur-2xl: 16px;
+  --star-blur-3xl: 20px;
+
+  // Motion
+  --star-duration-fast: 0.12s;
+  --star-duration-base: 0.2s;
+  --star-duration-slow: 0.35s;
+}

package/styles/controls/_accordion.scss

@@ -0,0 +1,75 @@
+// Accordion.
+@use '../shared' as *;
+
+// Accordion, panel and fieldset share the collapsing region (grid-template-rows 0fr to 1fr).
+.star-accordion__region {
+  display: grid;
+  grid-template-rows: 1fr;
+  transition: grid-template-rows var(--star-duration-base) $ease;
+
+  &[inert] {
+    grid-template-rows: 0fr;
+  }
+}
+.star-accordion__inner {
+  min-height: 0;
+  overflow: hidden;
+}
+.star-accordion {
+  display: block;
+  overflow: hidden;
+  border: 1px solid var(--star-border);
+  border-radius: var(--star-radius-lg);
+  background: var(--star-surface);
+}
+.star-accordion__panel {
+  display: block;
+
+  & + & {
+    border-top: 1px solid var(--star-border);
+  }
+}
+.star-accordion__heading {
+  margin: 0;
+}
+.star-accordion__header {
+  display: flex;
+  align-items: center;
+  gap: 0.625rem;
+  width: 100%;
+  padding: 1rem 1.25rem;
+  border: 0;
+  background: transparent;
+  color: var(--star-text-strong);
+  font: var(--star-type-title-sm);
+  font-size: 15px;
+  text-align: start;
+  cursor: pointer;
+
+  &:hover:not(:disabled) {
+    background: var(--star-surface-muted);
+  }
+  &:focus-visible {
+    outline: 2px solid var(--star-accent);
+    outline-offset: -2px;
+  }
+  &:disabled {
+    opacity: 0.5;
+    cursor: not-allowed;
+  }
+}
+.star-accordion__title {
+  flex: 1;
+}
+.star-accordion__caret {
+  color: var(--star-text-soft);
+  transition: rotate var(--star-duration-base) $ease;
+
+  [aria-expanded='true'] > & {
+    rotate: 180deg;
+  }
+}
+.star-accordion__body {
+  padding: 0 1.25rem 1.25rem;
+  font: var(--star-type-body-lg);
+}

package/styles/controls/_autocomplete.scss

@@ -0,0 +1,44 @@
+// Autocomplete.
+.star-ac__control {
+  flex-wrap: wrap;
+  gap: 0.375rem;
+  padding-inline-start: 0.75rem;
+
+  &:has(.star-ac__input:focus-visible) {
+    border-color: var(--star-accent);
+    box-shadow: var(--star-focus-ring);
+    background: var(--star-surface);
+  }
+}
+.star-ac__input {
+  flex: 1;
+  min-width: 6rem;
+  padding: 0.625rem 0.25rem;
+  border: 0;
+  background: transparent;
+  font: inherit;
+  font-size: 0.9rem;
+  font-weight: var(--star-input-font-weight);
+  color: var(--star-text-strong);
+  outline: none;
+
+  &:focus-visible {
+    outline: none;
+  }
+  &::placeholder {
+    color: var(--star-text-muted);
+    font-weight: inherit;
+  }
+}
+.star-ac--multi .star-ac__control {
+  padding-block: 0.25rem;
+}
+.star-select--sm .star-ac__input {
+  padding-block: 0.5rem;
+  font-size: 0.8125rem;
+}
+.star-ac__match {
+  background: transparent;
+  color: var(--star-primary);
+  font-weight: 600;
+}

package/styles/controls/_avatar.scss

@@ -0,0 +1,39 @@
+// Avatar.
+.star-avatar {
+  display: inline-grid;
+  flex: none;
+  place-items: center;
+  overflow: hidden;
+  width: 2.5rem;
+  height: 2.5rem;
+  background: var(--star-text-strong);
+  color: var(--star-on-tone);
+  font: 600 0.875rem/1 var(--star-font-sans);
+
+  img {
+    width: 100%;
+    height: 100%;
+    object-fit: cover;
+  }
+}
+.star-avatar--circle {
+  border-radius: 50%;
+}
+.star-avatar--square {
+  border-radius: var(--star-radius-md);
+}
+.star-avatar--sm {
+  width: 2rem;
+  height: 2rem;
+  font-size: 0.75rem;
+}
+.star-avatar--lg {
+  width: 3rem;
+  height: 3rem;
+  font-size: 1rem;
+}
+.star-avatar--xl {
+  width: 4rem;
+  height: 4rem;
+  font-size: 1.25rem;
+}

package/styles/controls/_breadcrumb.scss

@@ -0,0 +1,45 @@
+// Breadcrumb.
+.star-breadcrumb__list {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 0.375rem;
+  margin: 0;
+  padding: 0;
+  list-style: none;
+  font: var(--star-type-body);
+}
+.star-breadcrumb__item {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.375rem;
+  color: var(--star-text-muted);
+}
+.star-breadcrumb__link {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.25rem;
+  border-radius: 4px;
+  color: var(--star-text-muted);
+  font-weight: 600;
+  text-decoration: none;
+
+  &:hover {
+    color: var(--star-primary);
+  }
+  &:focus-visible {
+    outline: 2px solid var(--star-accent);
+    outline-offset: 2px;
+  }
+}
+.star-breadcrumb__current {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.25rem;
+  font-weight: 600;
+  color: var(--star-text-strong);
+}
+.star-breadcrumb__sep {
+  font-size: 0.7rem;
+  color: var(--star-text-soft);
+}

package/styles/controls/_button.scss

@@ -0,0 +1,137 @@
+// Button (StarButton).
+.star-btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.4rem;
+  font-family: inherit;
+  font-weight: var(--star-button-font-weight);
+  text-transform: var(--star-button-text-transform);
+  letter-spacing: var(--star-button-letter-spacing);
+  border-radius: var(--star-button-radius);
+  border: 1px solid transparent;
+  cursor: pointer;
+  white-space: nowrap;
+  transition:
+    background-color var(--star-duration-fast) ease-in-out,
+    color var(--star-duration-fast) ease-in-out,
+    border-color var(--star-duration-fast) ease-in-out,
+    box-shadow var(--star-duration-fast) ease-in-out,
+    transform var(--star-duration-fast) ease-in-out;
+
+  &:disabled,
+  &[aria-disabled='true'] {
+    opacity: 0.55;
+    cursor: not-allowed;
+    pointer-events: none;
+  }
+
+  &:focus-visible {
+    outline: none;
+    box-shadow: var(--star-focus-ring);
+  }
+}
+
+.star-btn--sm {
+  padding: 0.4rem 0.875rem;
+  font-size: 0.75rem;
+}
+.star-btn--md {
+  padding: 0.55rem 1.15rem;
+  font-size: 0.8125rem;
+}
+.star-btn--lg {
+  padding: 0.7rem 1.5rem;
+  font-size: 0.9375rem;
+}
+.star-btn--full {
+  width: 100%;
+}
+
+.star-btn--primary {
+  background: var(--star-primary-fill);
+  color: var(--star-on-tone);
+  box-shadow: var(--star-shadow-glow-primary);
+
+  &:hover {
+    background: var(--star-primary-hover);
+  }
+}
+.star-btn--secondary {
+  background: var(--star-surface);
+  color: var(--star-text-strong);
+  border-color: var(--star-border);
+  box-shadow: var(--star-shadow-xs);
+
+  &:hover {
+    border-color: var(--star-border-strong);
+    box-shadow: var(--star-shadow-md);
+  }
+}
+.star-btn--ghost {
+  background: transparent;
+  color: var(--star-text-strong);
+
+  &:hover {
+    background: var(--star-surface-muted);
+  }
+}
+.star-btn--danger {
+  background: var(--star-danger);
+  color: var(--star-on-tone);
+
+  &:hover {
+    background: var(--star-danger-hover);
+  }
+}
+.star-btn--ghost-danger {
+  background: transparent;
+  color: var(--star-danger);
+
+  &:hover {
+    background: var(--star-danger-soft);
+  }
+}
+.star-btn--success {
+  background: var(--star-success);
+  color: var(--star-on-bright);
+
+  // Lighter on hover: the text is dark, so a lighter fill keeps the contrast.
+  &:hover {
+    background: color-mix(in srgb, var(--star-success) 85%, #fff);
+  }
+}
+.star-btn--warning {
+  background: var(--star-warning);
+  color: var(--star-on-bright);
+
+  &:hover {
+    background: color-mix(in srgb, var(--star-warning) 85%, #fff);
+  }
+}
+.star-btn--icon {
+  width: 2.25rem;
+  height: 2.25rem;
+  padding: 0;
+  letter-spacing: normal;
+  text-transform: none;
+
+  &.star-btn--sm {
+    width: 2rem;
+    height: 2rem;
+  }
+  &.star-btn--lg {
+    width: 2.5rem;
+    height: 2.5rem;
+  }
+}
+
+@keyframes star-spin {
+  to {
+    transform: rotate(360deg);
+  }
+}
+.star-spin {
+  display: inline-block;
+  animation: star-spin 0.8s linear infinite;
+}

package/styles/controls/_card.scss

@@ -0,0 +1,38 @@
+// Card component and the card surface.
+.star-card-cmp {
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+}
+.star-card-cmp__header {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 1rem;
+  padding: 1.25rem 1.5rem 0;
+}
+.star-card-cmp__title {
+  margin: 0;
+  font: var(--star-type-title-sm);
+  color: var(--star-text-strong);
+}
+.star-card-cmp__subtitle {
+  margin: 0.25rem 0 0;
+  font: var(--star-type-body);
+  color: var(--star-text-muted);
+}
+.star-card-cmp__body {
+  flex: 1;
+  padding: 1.25rem 1.5rem;
+}
+.star-card-cmp [starCardFooter] {
+  padding: 1rem 1.5rem;
+  border-top: 1px solid var(--star-border);
+}
+
+.star-card {
+  background: var(--star-surface);
+  border: 1px solid color-mix(in srgb, var(--star-border) 50%, var(--star-surface));
+  border-radius: var(--star-radius-xl);
+  box-shadow: var(--star-shadow-card);
+}