@ponchia/ui 0.4.0 → 0.5.0

package/css/legend.css

@@ -0,0 +1,268 @@
+/* ==========================================================================
+   legend — opt-in data keys for charts, reports, and analytical figures.
+
+   A standalone, portable successor to the report kit's inline chart legend:
+   `.ui-legend` reads the Tier-4 `--chart-*` tokens and pairs with any chart
+   (Bronto's own `.ui-chart` bars, an SVG/canvas figure, or an external chart
+   engine). Not imported by core.css — import it beside css/dataviz.css.
+
+   Bronto paints and positions; it owns no scales, data mapping, or series
+   state. Colour is never the sole channel: a swatch mirrors its chart mark
+   (its colour, plus a `--chart-pattern-*` where the mark uses one) and is
+   always read out by its text label (WCAG 1.4.1). An interactive,
+   series-toggling legend is an optional behavior; the host owns what a
+   toggle hides and announces.
+   ========================================================================== */
+
+.ui-legend {
+  color: var(--text-soft);
+  display: flex;
+  flex-wrap: wrap;
+  font-family: var(--mono);
+  font-size: var(--text-xs);
+  gap: var(--space-2xs) var(--space-md);
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+
+.ui-legend--vertical {
+  flex-direction: column;
+}
+
+.ui-legend--compact {
+  font-size: var(--text-2xs);
+  gap: var(--space-2xs) var(--space-sm);
+}
+
+.ui-legend__title {
+  color: var(--text-dim);
+  font-size: var(--text-2xs);
+  letter-spacing: 0;
+  margin: 0;
+  text-transform: uppercase;
+}
+
+.ui-legend__item {
+  align-items: center;
+  color: inherit;
+  display: inline-flex;
+  gap: 0.45rem;
+}
+
+.ui-legend__label {
+  color: inherit;
+}
+
+.ui-legend__value {
+  color: var(--text-dim);
+  font-variant-numeric: tabular-nums;
+  margin-inline-start: auto;
+}
+
+.ui-legend__caption {
+  color: var(--text-dim);
+  font-size: var(--text-2xs);
+  letter-spacing: 0;
+  text-transform: uppercase;
+}
+
+/* Swatch — same token contract as the chart fill: set `--chart-color` (and,
+   where the mark is patterned, `--chart-pattern`) inline, or use a `--N` index
+   helper for the categorical palette. */
+.ui-legend__swatch {
+  background: var(--chart-color, var(--chart-1, var(--accent)));
+  background-image: var(--chart-pattern, none);
+  background-size: var(--chart-pattern-size, 8px);
+  block-size: 0.8rem;
+  border: 1px solid var(--line-strong);
+  flex: 0 0 auto;
+  inline-size: 0.8rem;
+}
+
+.ui-legend__swatch--circle {
+  border-radius: 50%;
+}
+
+.ui-legend__swatch--line {
+  block-size: 0.2rem;
+  border: 0;
+  inline-size: 1.1rem;
+}
+
+/* Glyph/symbol swatch — fill an `.ui-icon` mask with the series colour. */
+.ui-legend__symbol {
+  block-size: 0.95rem;
+  color: var(--chart-color, var(--accent));
+  flex: 0 0 auto;
+  inline-size: 0.95rem;
+}
+
+/* Categorical index helpers: exactly one per palette series (gated against
+   tokens/charts.js by check-legend). They set only the colour, so a swatch
+   stays a faithful key — add `--chart-pattern` (inline, or from dataviz.css)
+   only where the chart mark itself is patterned. */
+.ui-legend__swatch--1 {
+  --chart-color: var(--chart-1);
+}
+
+.ui-legend__swatch--2 {
+  --chart-color: var(--chart-2);
+}
+
+.ui-legend__swatch--3 {
+  --chart-color: var(--chart-3);
+}
+
+.ui-legend__swatch--4 {
+  --chart-color: var(--chart-4);
+}
+
+.ui-legend__swatch--5 {
+  --chart-color: var(--chart-5);
+}
+
+.ui-legend__swatch--6 {
+  --chart-color: var(--chart-6);
+}
+
+.ui-legend__swatch--7 {
+  --chart-color: var(--chart-7);
+}
+
+.ui-legend__swatch--8 {
+  --chart-color: var(--chart-8);
+}
+
+/* Continuous colour ramp. Author supplies the min/mid/max tick *text*; the
+   track interpolates the sequential ramp in OKLCH (a single perceptual hue,
+   so no banding and no muddy midpoint). `--diverging` swaps in the 7-stop
+   diverging ramp around its neutral centre. */
+.ui-legend--gradient {
+  display: grid;
+  gap: var(--space-2xs);
+}
+
+.ui-legend__track {
+  background: linear-gradient(
+    90deg in oklch,
+    var(--chart-seq-1),
+    var(--chart-seq-2),
+    var(--chart-seq-3),
+    var(--chart-seq-4),
+    var(--chart-seq-5),
+    var(--chart-seq-6)
+  );
+  block-size: 0.7rem;
+  border: 1px solid var(--line);
+}
+
+.ui-legend--diverging .ui-legend__track {
+  background: linear-gradient(
+    90deg in oklch,
+    var(--chart-div-1),
+    var(--chart-div-2),
+    var(--chart-div-3),
+    var(--chart-div-4),
+    var(--chart-div-5),
+    var(--chart-div-6),
+    var(--chart-div-7)
+  );
+}
+
+.ui-legend__ticks {
+  color: var(--text-dim);
+  display: flex;
+  font-size: var(--text-2xs);
+  justify-content: space-between;
+}
+
+.ui-legend__tick {
+  font-variant-numeric: tabular-nums;
+}
+
+/* Threshold / binned key — a `swatch | range-label` grid. Author the swatch
+   and label as direct children (no `__item` wrapper) so the columns align. */
+.ui-legend--threshold {
+  align-items: center;
+  display: grid;
+  gap: 0.35rem var(--space-sm);
+  grid-template-columns: auto 1fr;
+}
+
+/* With-values — align swatch | label | value columns across every row. */
+.ui-legend--with-values {
+  display: grid;
+  gap: 0.35rem var(--space-md);
+  grid-template-columns: auto 1fr auto;
+}
+
+.ui-legend--with-values .ui-legend__item {
+  display: grid;
+  grid-column: 1 / -1;
+  grid-template-columns: subgrid;
+}
+
+.ui-legend--with-values .ui-legend__value {
+  margin-inline-start: 0;
+}
+
+/* Interactive entries are real <button aria-pressed> controls. Bronto styles
+   the control + the inactive state; behaviors/legend.js (optional) flips
+   aria-pressed and emits an event. The host hides the series and announces it. */
+.ui-legend--interactive .ui-legend__item {
+  background: none;
+  border: 0;
+  border-radius: var(--radius-sm);
+  color: inherit;
+  cursor: pointer;
+  font: inherit;
+  padding-block: 0.15rem;
+  padding-inline: 0.3rem;
+  text-align: start;
+}
+
+.ui-legend--interactive .ui-legend__item:focus-visible {
+  outline: 2px solid var(--accent);
+  outline-offset: 2px;
+}
+
+.ui-legend__item.is-inactive,
+.ui-legend__item[aria-pressed='false'] {
+  opacity: 0.45;
+}
+
+.ui-legend__item.is-inactive .ui-legend__label,
+.ui-legend__item[aria-pressed='false'] .ui-legend__label {
+  text-decoration: line-through;
+}
+
+/* Forced colours: keep the real swatch hue (it mirrors the chart mark) behind
+   a system-coloured border so it survives, and drop the opacity dim (it does
+   not read) — the line-through still marks an inactive series. */
+@media (forced-colors: active) {
+  .ui-legend__swatch {
+    border: 1px solid CanvasText;
+    forced-color-adjust: none;
+  }
+
+  /* Keep the ramp's hues instead of collapsing to one system colour (the tick
+     labels still carry the scale either way). */
+  .ui-legend__track {
+    forced-color-adjust: none;
+  }
+
+  .ui-legend__item.is-inactive,
+  .ui-legend__item[aria-pressed='false'] {
+    opacity: 1;
+  }
+}
+
+/* Print: meaning-carrying colour must survive the "economy" default. */
+@media print {
+  .ui-legend__swatch,
+  .ui-legend__track {
+    -webkit-print-color-adjust: exact;
+    print-color-adjust: exact;
+  }
+}

package/css/marks.css

@@ -0,0 +1,144 @@
+/* ==========================================================================
+   marks — opt-in evidence/emphasis marks for running text.
+
+   The prose counterpart to the SVG annotations layer: annotations call out a
+   figure, marks call out a sentence. Sober, report-grade highlights for docs,
+   audits, and generated (LLM) reports — not a hand-drawn Rough-Notation look.
+   Not imported by core.css.
+
+   `.ui-mark` is an inline highlight (put it on a `<mark>`); `.ui-bracket-note`
+   brackets a whole passage. Monochrome by default — the rationed accent is
+   opt-in via `--accent`; status tones are only for status-bearing emphasis.
+   ========================================================================== */
+
+.ui-mark {
+  --mark-color: var(--line-strong);
+
+  background-image: linear-gradient(
+    90deg,
+    color-mix(in srgb, var(--mark-color) 30%, transparent),
+    color-mix(in srgb, var(--mark-color) 30%, transparent)
+  );
+  background-repeat: no-repeat;
+  background-size: 100% 100%;
+  border-radius: 0.12em;
+  box-decoration-break: clone;
+  color: inherit;
+  padding-block: 0.05em;
+  padding-inline: 0.18em;
+}
+
+/* Tones set the mark colour. Default is neutral ink; `--accent` is the
+   rationed accent; status tones only for status-bearing emphasis. */
+.ui-mark--accent {
+  --mark-color: var(--accent);
+}
+
+.ui-mark--success {
+  --mark-color: var(--success);
+}
+
+.ui-mark--warning {
+  --mark-color: var(--warning);
+}
+
+.ui-mark--danger {
+  --mark-color: var(--danger);
+}
+
+.ui-mark--info {
+  --mark-color: var(--info);
+}
+
+.ui-mark--muted {
+  --mark-color: var(--text-dim);
+}
+
+/* Styles change how the mark is drawn (no highlight fill). They wrap across
+   lines natively (text-decoration) or with the cloned box (border). */
+.ui-mark--underline {
+  background: none;
+  padding: 0;
+  text-decoration-color: var(--mark-color);
+  text-decoration-line: underline;
+  text-decoration-thickness: 0.12em;
+  text-underline-offset: 0.18em;
+}
+
+.ui-mark--box {
+  background: none;
+  border: 1px solid var(--mark-color);
+  border-radius: var(--radius-sm);
+}
+
+.ui-mark--strike {
+  background: none;
+  padding: 0;
+  text-decoration-color: var(--mark-color);
+  text-decoration-line: line-through;
+}
+
+/* Draw-on highlight sweep. Only the highlight fill animates, and only when
+   motion is welcome — reduced-motion keeps the resting full highlight. */
+@media (prefers-reduced-motion: no-preference) {
+  .ui-mark--draw {
+    animation: ui-mark-draw 0.6s var(--ease, ease) both;
+  }
+}
+
+@keyframes ui-mark-draw {
+  from {
+    background-size: 0% 100%;
+  }
+
+  to {
+    background-size: 100% 100%;
+  }
+}
+
+/* A passage bracket: a tick down the inline-start with an optional label.
+   The prose analogue of `ui-annotation--bracket`. */
+.ui-bracket-note {
+  --mark-color: var(--line-strong);
+
+  border-inline-start: 2px solid var(--mark-color);
+  display: block;
+  padding-inline-start: var(--space-md);
+}
+
+.ui-bracket-note__label {
+  color: var(--mark-color);
+  display: block;
+  font-family: var(--mono);
+  font-size: var(--text-2xs);
+  letter-spacing: 0;
+  margin-block-end: var(--space-2xs);
+  text-transform: uppercase;
+}
+
+.ui-bracket-note--accent {
+  --mark-color: var(--accent);
+}
+
+.ui-bracket-note--warning {
+  --mark-color: var(--warning);
+}
+
+.ui-bracket-note--danger {
+  --mark-color: var(--danger);
+}
+
+.ui-bracket-note--info {
+  --mark-color: var(--info);
+}
+
+/* Forced colours: only the highlight `background` is dropped, so add an
+   underline to the plain highlight mark to keep it visible. The styled marks
+   already carry a surviving channel — `--underline`/`--strike` use
+   text-decoration and `--box` a border — so they're excluded (otherwise the
+   underline would overwrite `--strike`'s line-through and lose its meaning). */
+@media (forced-colors: active) {
+  .ui-mark:not(.ui-mark--underline, .ui-mark--box, .ui-mark--strike) {
+    text-decoration-line: underline;
+  }
+}

package/css/motion.css

@@ -172,6 +172,15 @@
   }
 }
 
+/* Scroll progress: a bar that fills as the page scrolls. Driven by a
+   scroll() timeline, not time — the base scaleX(0) is the static
+   (unsupported) end state. */
+@keyframes uiScrollGrow {
+  to {
+    transform: scaleX(1);
+  }
+}
+
 /* --- Utilities --- */
 
 .ui-animate-in {
@@ -272,6 +281,85 @@
   margin-inline-start: 0.1em;
 }
 
+/* --- Scroll-driven (progressive enhancement) — the scroll/view timeline
+   IS the engine, no JS. Everything is gated on `@supports
+   (animation-timeline: …)` so engines without it (today, Firefox/Safari)
+   keep the static end state, and on `prefers-reduced-motion: no-preference`
+   (a scroll timeline ignores animation-duration, so the global reduced-motion
+   reset below can't neutralise it — it must be gated here). --- */
+
+/* Reading-progress bar. Fixed hairline that fills with document scroll;
+   unsupported → a static, empty (scaleX(0)) bar. Pair with role="progressbar"
+   if you surface it to AT. */
+.ui-scroll-progress {
+  background: var(--accent);
+  block-size: 3px;
+  inset-block-start: 0;
+  inset-inline: 0;
+  position: fixed;
+  transform: scaleX(0);
+  transform-origin: 0 50%;
+  z-index: var(--z-overlay);
+}
+
+/* RTL: fill from the inline-start (right) edge. */
+[dir='rtl'] .ui-scroll-progress {
+  transform-origin: 100% 50%;
+}
+
+@supports (animation-timeline: scroll()) {
+  @media (prefers-reduced-motion: no-preference) {
+    .ui-scroll-progress {
+      animation: uiScrollGrow linear;
+
+      /* longhand AFTER the shorthand — `animation:` resets the timeline to
+         auto, so this must follow it to take effect. */
+      animation-timeline: scroll(root block);
+    }
+  }
+}
+
+/* Reveal-on-scroll with no JS and no IntersectionObserver: the element
+   rises + fades as it scrolls into view. Unsupported → fully visible
+   (the `uiRise` end state), same graceful default as `.ui-reveal`. */
+@supports (animation-timeline: view()) {
+  @media (prefers-reduced-motion: no-preference) {
+    .ui-scroll-reveal {
+      animation: uiRise linear both;
+      animation-timeline: view();
+      animation-range: entry 0% cover 40%;
+    }
+  }
+}
+
+/* --- View Transitions (progressive enhancement) — `.ui-vt` names an
+   element so it morphs across a same-document `document.startViewTransition()`
+   or a cross-document navigation. Opt into the cross-document kind with a
+   top-level, *unlayered* `@view-transition { navigation: auto; }` in your own
+   CSS (it is document-global, so the framework can't ship or scope it). --- */
+.ui-vt {
+  view-transition-name: var(--ui-vt-name, none);
+}
+
+@media (prefers-reduced-motion: no-preference) {
+  /* On-brand default for the root cross-fade, inert until a transition runs. */
+  ::view-transition-old(root),
+  ::view-transition-new(root) {
+    animation-duration: var(--duration-base);
+    animation-timing-function: var(--ease-standard);
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  /* View transitions do NOT honour reduced-motion automatically and the
+     ::view-transition tree is outside the `*` reset below — kill it here. */
+  ::view-transition-group(*),
+  ::view-transition-old(*),
+  ::view-transition-new(*) {
+    animation: none !important;
+  }
+}
+
 @media (prefers-reduced-motion: reduce) {
   html {
     scroll-behavior: auto;

package/css/overlay.css

@@ -26,11 +26,56 @@
 }
 
 .ui-modal[open] {
-  animation: uiToastIn var(--duration-base) var(--ease-spring) both;
   display: grid;
   grid-template-rows: auto 1fr auto;
 }
 
+/* Enter AND exit, zero JS — `@starting-style` + `transition-behavior:
+   allow-discrete` keep the native <dialog> (and its backdrop) in the top
+   layer while it transitions out on close, so it fades/scales both ways
+   instead of only animating in. Scoped to `dialog.ui-modal` so the
+   controlled `.is-open` (non-<dialog>) path keeps its own entrance.
+   Needs a 2026-era floor (see CONTRIBUTING → Browser floor). */
+dialog.ui-modal {
+  opacity: 0;
+  transform: translateY(6px) scale(0.98);
+  transition:
+    opacity var(--duration-base) var(--ease-spring),
+    transform var(--duration-base) var(--ease-spring),
+    overlay var(--duration-base) allow-discrete,
+    display var(--duration-base) allow-discrete;
+}
+
+dialog.ui-modal[open] {
+  opacity: 1;
+  transform: none;
+}
+
+@starting-style {
+  dialog.ui-modal[open] {
+    opacity: 0;
+    transform: translateY(6px) scale(0.98);
+  }
+}
+
+dialog.ui-modal::backdrop {
+  opacity: 0;
+  transition:
+    opacity var(--duration-base) var(--ease-out),
+    overlay var(--duration-base) allow-discrete,
+    display var(--duration-base) allow-discrete;
+}
+
+dialog.ui-modal[open]::backdrop {
+  opacity: 1;
+}
+
+@starting-style {
+  dialog.ui-modal[open]::backdrop {
+    opacity: 0;
+  }
+}
+
 /* Controlled (non-<dialog>) usage. A portal/React modal that can't be a
    native <dialog> wears the same skin + open layout via `.is-open`.
    Backdrop, top-layer stacking and focus-trapping are then the
@@ -324,4 +369,10 @@
   .ui-modal[open] {
     animation: none;
   }
+
+  /* No enter/exit transition — snap to the open state (no flash). */
+  dialog.ui-modal,
+  dialog.ui-modal::backdrop {
+    transition: none;
+  }
 }

package/css/primitives.css

@@ -649,6 +649,24 @@
   padding: 0.18rem 0.4rem;
 }
 
+/* --- Shortcut hint — one or more .ui-kbd keys as a chord or sequence, with a
+   connective __sep ("+" for a chord, "then" for a sequence). The reusable
+   keyboard-hint primitive (menu items, buttons, tooltips, command lists). --- */
+
+.ui-shortcut {
+  align-items: center;
+  display: inline-flex;
+  gap: 0.25rem;
+  vertical-align: middle;
+  white-space: nowrap;
+}
+
+.ui-shortcut__sep {
+  color: var(--text-dim);
+  font-family: var(--mono);
+  font-size: var(--text-2xs);
+}
+
 /* --- Timeline — vertical event list on a hairline spine. Use an <ol>;
    each <li> is a __item with an optional __time label. aria-current marks
    the live/most-recent event (accent marker). --- */