@keenmate/pure-admin-core 2.7.0 → 2.8.0

package/src/scss/core-components/_kpi-sparkline-list.scss

@@ -0,0 +1,223 @@
+/* ========================================
+   KPI · Sparkline list
+   Each KPI is one row: label · sparkline · value · Δ%. Built for vertical
+   scanning rather than per-tile depth — no view-mode toggle, no status
+   pills. Container queries collapse 4-col → 2-row → 3-row as the card
+   narrows.
+
+   Row template uses local SCSS variables for the four column widths
+   (`$spark-col-label`, `$spark-col-chart`, `$spark-col-value`,
+   `$spark-col-delta`) so all responsive overrides reference the same
+   widths — change one and every breakpoint follows. The `--no-delta`
+   modifier drops the rightmost column; the other three are load-bearing
+   (a sparkline list without label, chart, or value is a different
+   design).
+   ======================================== */
+@use '../variables' as *;
+
+/* Per-column track widths — referenced from every template selector. */
+$spark-col-label: minmax(14rem, 28%);
+$spark-col-chart: minmax(10rem, 1fr);
+$spark-col-value: minmax(8rem, 18%);
+$spark-col-delta: minmax(7rem, 12%);
+
+/* Card is a query container so rows react to *card* width, not viewport. */
+.pa-kpi-spark-list {
+  container-type: inline-size;
+}
+.pa-kpi-spark-list__body { padding: 0; }
+
+/* ----- Row: wide 4-column grid (label · chart · value · delta) ---------- */
+.pa-kpi-spark-row {
+  display: grid;
+  grid-template-columns:
+    $spark-col-label
+    $spark-col-chart
+    $spark-col-value
+    $spark-col-delta;
+  align-items: center;
+  gap: 1.6rem;
+  padding: 1.4rem 2rem;
+  border-bottom: 1px solid var(--pa-border-color);
+
+  &:last-child { border-bottom: 0; }
+}
+
+/* Modifier: --no-delta — drops the rightmost column. label · chart ·
+   value only. Useful when the chart's slope already conveys direction
+   and the delta would be redundant. Hides the delta element and shrinks
+   the row template to 3 columns. */
+.pa-kpi-spark-list--no-delta .pa-kpi-spark-row {
+  grid-template-columns:
+    $spark-col-label
+    $spark-col-chart
+    $spark-col-value;
+}
+.pa-kpi-spark-list--no-delta .pa-kpi-spark-row__delta { display: none; }
+
+/* Mid-narrow card (1×3 page-grid + 45% column): stack to 2 rows.
+   Label/value/delta on top, full-width chart below. Default order is
+   value-above-chart; use .pa-kpi-spark-list--chart-first to flip. */
+@container (max-width: 640px) {
+  .pa-kpi-spark-row {
+    grid-template-columns: minmax(0, 1fr) auto auto;
+    grid-template-rows: auto auto;
+    grid-template-areas:
+      "label value delta"
+      "chart chart chart";
+    column-gap: 1.2rem;
+    row-gap: 0.4rem;
+    align-items: baseline;
+    padding: 1.2rem 1.6rem;
+  }
+  .pa-kpi-spark-row__label  { grid-area: label; align-self: center; font-size: 1.25rem; }
+  .pa-kpi-spark-row__value  { grid-area: value; }
+  .pa-kpi-spark-row__delta  { grid-area: delta; font-size: 1.25rem; }
+  .pa-kpi-spark-row__chart  { grid-area: chart; }
+  .pa-kpi-spark-row__num    { font-size: 2rem; }
+
+  /* --chart-first: rotates the canonical L→R order 90°. Label on top,
+     chart in the middle, value+delta side-by-side at the bottom. */
+  .pa-kpi-spark-list--chart-first .pa-kpi-spark-row {
+    grid-template-columns: 1fr auto;
+    grid-template-rows: auto auto auto;
+    grid-template-areas:
+      "label  label"
+      "chart  chart"
+      "value  delta";
+    row-gap: 0.5rem;
+    column-gap: 1rem;
+    padding: 1.2rem 1.6rem;
+  }
+  .pa-kpi-spark-list--chart-first .pa-kpi-spark-row__label { align-self: start; }
+  .pa-kpi-spark-list--chart-first .pa-kpi-spark-row__value { text-align: start; align-self: baseline; }
+  .pa-kpi-spark-list--chart-first .pa-kpi-spark-row__delta { align-self: baseline; }
+
+  /* --no-delta at mid-narrow: 2-row layout, top row is label+value only. */
+  .pa-kpi-spark-list--no-delta .pa-kpi-spark-row {
+    grid-template-columns: minmax(0, 1fr) auto;
+    grid-template-areas:
+      "label value"
+      "chart chart";
+  }
+
+  /* --no-delta + --chart-first: 3-row single-column stack. */
+  .pa-kpi-spark-list--no-delta.pa-kpi-spark-list--chart-first .pa-kpi-spark-row {
+    grid-template-columns: 1fr;
+    grid-template-areas:
+      "label"
+      "chart"
+      "value";
+  }
+}
+
+/* Very narrow card (~280–360px, 25% page-grid stress test): force the
+   chart-first 3-row layout regardless of modifier. */
+@container (max-width: 360px) {
+  .pa-kpi-spark-row {
+    grid-template-columns: 1fr auto;
+    grid-template-rows: auto auto auto;
+    grid-template-areas:
+      "label  label"
+      "chart  chart"
+      "value  delta";
+    row-gap: 0.5rem;
+    column-gap: 1rem;
+    padding: 1.2rem 1.4rem;
+  }
+  .pa-kpi-spark-row__label  { grid-area: label; align-self: start; }
+  .pa-kpi-spark-row__chart  { grid-area: chart; }
+  .pa-kpi-spark-row__value  { grid-area: value; text-align: start; align-self: baseline; }
+  .pa-kpi-spark-row__delta  { grid-area: delta; align-self: baseline; }
+
+  /* --no-delta at very-narrow: 3-row single-column stack (no delta cell). */
+  .pa-kpi-spark-list--no-delta .pa-kpi-spark-row {
+    grid-template-columns: 1fr;
+    grid-template-areas:
+      "label"
+      "chart"
+      "value";
+  }
+}
+
+/* ----- Cell typography -------------------------------------------------- */
+.pa-kpi-spark-row__label {
+  font-family: var(--base-font-family-mono);
+  font-size: 1.4rem;
+  font-weight: 700;
+  letter-spacing: 0.1em;
+  text-transform: uppercase;
+  color: color-mix(in srgb, var(--pa-text-color-1) 60%, transparent);
+}
+
+/* Sparkline cell — line + filled area + trailing dot (the dot is rendered
+   as a CSS span by the JS init pass; see kpi-showcases.js). */
+.pa-kpi-spark-row__chart {
+  position: relative;     /* anchor for .pa-kpi-spark-dot */
+
+  svg {
+    display: block;
+    width: 100%;
+    height: var(--pa-chart-trendline-height);
+    overflow: visible;
+  }
+
+  polyline {
+    fill: none;
+    stroke: currentColor;
+    stroke-width: var(--pa-chart-trendline-stroke);
+    stroke-linecap: round;
+    stroke-linejoin: round;
+  }
+
+  polygon {
+    fill: currentColor;
+    fill-opacity: 0.18;    /* same hue as line, soft area shading */
+    stroke: none;
+  }
+}
+
+/* Sentiment-coloured sparkline. Color is set on the chart wrapper so
+   currentColor resolves for both the SVG content (line/area) and the
+   dot inside the wrapper. */
+.pa-kpi-spark-row {
+  &--up-strong   .pa-kpi-spark-row__chart { color: var(--pa-very-positive); }
+  &--up          .pa-kpi-spark-row__chart { color: var(--pa-positive); }
+  &--flat        .pa-kpi-spark-row__chart { color: var(--pa-neutral); }
+  &--down        .pa-kpi-spark-row__chart { color: var(--pa-negative); }
+  &--down-strong .pa-kpi-spark-row__chart { color: var(--pa-very-negative); }
+}
+
+/* ----- Value (focal white number + muted unit) ------------------------- */
+.pa-kpi-spark-row__value {
+  font-family: var(--base-font-family-mono);
+  text-align: end;
+  line-height: 1;
+}
+.pa-kpi-spark-row__num {
+  font-size: 2.6rem;
+  font-weight: 700;
+  letter-spacing: -0.02em;
+  color: var(--pa-text-color-1);
+}
+.pa-kpi-spark-row__unit {
+  font-size: 1.3rem;
+  font-weight: 500;
+  color: var(--pa-text-secondary);
+  margin-left: 0.2rem;
+}
+
+/* ----- Delta (sentiment-coloured) -------------------------------------- */
+.pa-kpi-spark-row__delta {
+  font-family: var(--base-font-family-mono);
+  font-size: 1.4rem;
+  font-weight: 600;
+  text-align: end;
+  font-variant-numeric: tabular-nums;
+
+  &--very-positive { color: var(--pa-very-positive); }
+  &--positive      { color: var(--pa-positive); }
+  &--neutral       { color: var(--pa-neutral); }
+  &--negative      { color: var(--pa-negative); }
+  &--very-negative { color: var(--pa-very-negative); }
+}

package/src/scss/core-components/_kpi-terminal.scss

@@ -0,0 +1,236 @@
+/* ========================================
+   KPI · Terminal grid
+   Bloomberg-style dense panel: mono numbers, status pills, inline SVG
+   sparklines, ▲▼ deltas, optional segmented tab strip for swapping
+   the body content (different tile sets / grids per tab).
+   Shared chrome (header, live, footer, detail popover, spark-dot) is in
+   _kpi-base.scss.
+   ======================================== */
+@use '../variables' as *;
+
+/* ----- Tab strip (segmented button group) ------------------------------
+   Generalised tabs — each `.pa-kpi-terminal__tab` carries a `data-tab`
+   slug that matches a `.pa-kpi-terminal__pane[data-tab="…"]` in the body.
+   JS toggles `.is-active` on the clicked tab + matching pane; tabs and
+   panes are otherwise independent so each pane can hold a completely
+   different grid (different tile count, different grid modifier). */
+.pa-kpi-terminal__controls {
+  display: inline-flex;
+  align-items: center;
+  gap: 1.6rem;
+}
+.pa-kpi-terminal__tabs {
+  display: inline-flex;
+  border: 1px solid var(--pa-border-color);
+  border-radius: 0.4rem;
+  overflow: hidden;
+}
+.pa-kpi-terminal__tab {
+  background: transparent;
+  border: 0;
+  color: var(--pa-text-color-2);
+  padding: 0.4rem 1.1rem;
+  font-family: var(--base-font-family-mono);
+  font-size: 1.1rem;
+  font-weight: 600;
+  letter-spacing: 0.06em;
+  cursor: pointer;
+  transition: background-color 0.1s ease-out, color 0.1s ease-out;
+
+  &:hover {
+    color: var(--pa-text-color-1);
+  }
+
+  &.is-active {
+    background: var(--pa-text-color-1);
+    color: var(--pa-card-bg);
+  }
+}
+
+/* ----- Pane visibility ------------------------------------------------- */
+.pa-kpi-terminal__pane {
+  display: none;
+
+  &.is-active { display: block; }
+}
+
+/* ----- Grid + tile borders ----------------------------------------------
+   Hairline 1px borders between tiles, no gap. Last-row/last-column
+   borders suppressed via :nth-last-child / :nth-child selectors. */
+.pa-kpi-terminal__body {
+  padding: 0;
+}
+.pa-kpi-terminal__grid {
+  display: grid;
+  grid-template-columns: repeat(2, 1fr);
+
+  .pa-kpi-tile {
+    border-bottom: 1px solid var(--pa-border-color);
+    border-right: 1px solid var(--pa-border-color);
+  }
+}
+.pa-kpi-terminal__grid--2col {
+  .pa-kpi-tile:nth-child(2n)        { border-right: 0; }
+  .pa-kpi-tile:nth-last-child(-n+2) { border-bottom: 0; }
+}
+
+/* ----- Tile (per-KPI panel) --------------------------------------------- */
+.pa-kpi-tile {
+  position: relative;
+  padding: 1.4rem 1.8rem 1.6rem;
+  min-height: 16rem;
+  display: flex;
+  flex-direction: column;
+
+  /* Standalone modifier: tile lives directly inside a .pa-col-* (no
+     neighbour cells in a parent grid) — gets a full border + card bg so
+     it doesn't look orphaned. */
+  &--standalone {
+    background: var(--pa-card-bg);
+    border: 1px solid var(--pa-border-color);
+    margin-bottom: 1.2rem;
+
+    &:last-child { margin-bottom: 0; }
+  }
+}
+
+/* ----- Tile head: ID · period + status pill ----------------------------- */
+.pa-kpi-tile__head {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  font-family: var(--base-font-family-mono);
+  font-size: 1.3rem;
+  letter-spacing: 0.04em;
+  margin-bottom: 0.3rem;
+}
+.pa-kpi-tile__id {
+  color: var(--pa-text-tertiary);
+  font-weight: 600;
+}
+.pa-kpi-tile__status {
+  font-family: var(--base-font-family-mono);
+  font-size: 1.2rem;
+  font-weight: 700;
+  letter-spacing: 0.08em;
+  padding: 0.3rem 0.9rem;
+  line-height: 1.3;
+
+  &--warn {
+    background: var(--pa-warning-bg);
+    color: var(--pa-btn-warning-text);
+  }
+
+  /* GOOD is the "default" state — text-only, no chrome */
+  &--good {
+    background: transparent;
+    color: var(--pa-text-color-1);
+    padding: 0.2rem 0;
+  }
+
+  &--neutral {
+    background: color-mix(in srgb, var(--pa-text-color-2) 25%, transparent);
+    color: var(--pa-text-color-1);
+  }
+}
+
+/* ----- Label ------------------------------------------------------------ */
+.pa-kpi-tile__label {
+  font-family: var(--base-font-family-mono);
+  font-size: 1.4rem;
+  font-weight: 700;
+  letter-spacing: 0.1em;
+  text-transform: uppercase;
+  color: var(--pa-text-strong);
+  margin-bottom: 0.8rem;
+}
+
+/* ----- Big value -------------------------------------------------------
+   One value per tile — sentiment colour set via `--very-positive` /
+   `--positive` / `--neutral` / `--negative` / `--very-negative` modifier
+   on the value element. */
+.pa-kpi-tile__values {
+  margin-bottom: 0.4rem;
+}
+.pa-kpi-tile__value {
+  display: inline-flex;
+  align-items: baseline;
+  gap: 0.3rem;
+  font-family: var(--base-font-family-mono);
+  line-height: 1;
+
+  &--very-positive .pa-kpi-tile__num { color: var(--pa-very-positive); }
+  &--positive      .pa-kpi-tile__num { color: var(--pa-positive); }
+  &--neutral       .pa-kpi-tile__num { color: var(--pa-neutral); }
+  &--negative      .pa-kpi-tile__num { color: var(--pa-negative); }
+  &--very-negative .pa-kpi-tile__num { color: var(--pa-very-negative); }
+}
+
+.pa-kpi-tile__num {
+  font-size: 3.8rem;
+  font-weight: 700;
+  letter-spacing: -0.02em;
+  color: var(--pa-text-color-1);
+}
+.pa-kpi-tile__unit {
+  font-size: 1.6rem;
+  font-weight: 500;
+  color: var(--pa-text-secondary);
+}
+
+/* ----- Previous-value + delta row -------------------------------------- */
+.pa-kpi-tile__prev {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  font-family: var(--base-font-family-mono);
+  font-size: 1.3rem;
+  margin-top: auto;     /* push to bottom of flex column */
+  margin-bottom: 0.4rem;
+  color: var(--pa-text-tertiary);
+}
+.pa-kpi-tile__delta {
+  &--very-positive { color: var(--pa-very-positive); }
+  &--positive      { color: var(--pa-positive); }
+  &--neutral       { color: var(--pa-neutral); }
+  &--negative      { color: var(--pa-negative); }
+  &--very-negative { color: var(--pa-very-negative); }
+}
+
+/* ----- Sparkline -------------------------------------------------------- */
+.pa-kpi-tile__spark {
+  display: block;
+  width: 100%;
+  height: var(--pa-chart-trendline-height);
+  overflow: visible;
+
+  polyline {
+    fill: none;
+    stroke: currentColor;
+    stroke-width: var(--pa-chart-trendline-stroke);
+    stroke-linecap: round;
+    stroke-linejoin: round;
+  }
+}
+/* Sentiment-coloured sparkline. Class names use up/down wording but pick
+   colours from the sentiment-of-the-change axis, not line shape — so an
+   error-rate metric whose line is falling but the change is good uses
+   --up. See showcase docs for the rationale. Colour is set on both the
+   SVG and the JS-inserted .pa-kpi-spark-wrap so currentColor resolves
+   for the SVG content (line) and the HTML dot (inside the wrap). */
+.pa-kpi-tile {
+  &--up-strong   .pa-kpi-tile__spark,
+  &--up-strong   .pa-kpi-spark-wrap { color: var(--pa-very-positive); }
+
+  &--up          .pa-kpi-tile__spark,
+  &--up          .pa-kpi-spark-wrap { color: var(--pa-positive); }
+
+  &--flat        .pa-kpi-tile__spark,
+  &--flat        .pa-kpi-spark-wrap { color: var(--pa-neutral); }
+
+  &--down        .pa-kpi-tile__spark,
+  &--down        .pa-kpi-spark-wrap { color: var(--pa-negative); }
+
+  &--down-strong .pa-kpi-tile__spark,
+  &--down-strong .pa-kpi-spark-wrap { color: var(--pa-very-negative); }
+}

package/src/scss/main.scss

@@ -5,3 +5,14 @@
 
 // Core framework (includes variables and all core-components)
 @use 'core' as *;
+
+// CSS variable defaults at :root. Themes don't go through main.scss — they
+// @import core + base-css-variables and emit their own values — so this only
+// affects the unthemed bundle (dist/css/main.css) and the FOUC window before
+// a theme stylesheet resolves.
+@use 'base-css-variables' as bcv;
+:root {
+  @include bcv.output-base-css-variables;
+  @include bcv.output-pa-css-variables;
+  @include bcv.output-pa-alert-variables-light;
+}