@jirawatpyk/aura-react 5.33.0 → 5.35.0

package/dist/server/index.cjs

@@ -39,8 +39,11 @@ __export(server_exports, {
   Icon: () => Icon,
   PageHeader: () => PageHeader,
   STRINGS: () => STRINGS,
+  Sparkline: () => Sparkline,
   Stat: () => ServerStat,
   StatusPill: () => ServerStatusPill,
+  StatusTile: () => ServerStatusTile,
+  TileGrid: () => TileGrid,
   brandScale: () => scale,
   breakpoints: () => breakpoints,
   buttonClass: () => buttonClass,
@@ -329,11 +332,16 @@ var th = {
   pageN: function(p) {
     return "\u0E2B\u0E19\u0E49\u0E32 " + p;
   },
-  progressReserved: function(v, r, max) {
-    return "\u0E43\u0E0A\u0E49\u0E41\u0E25\u0E49\u0E27 " + n(v) + " \u0E08\u0E32\u0E01 " + n(max) + " \u0E08\u0E2D\u0E07\u0E44\u0E27\u0E49 " + n(r);
+  progressReserved: function(v, r2, max) {
+    return "\u0E43\u0E0A\u0E49\u0E41\u0E25\u0E49\u0E27 " + n(v) + " \u0E08\u0E32\u0E01 " + n(max) + " \u0E08\u0E2D\u0E07\u0E44\u0E27\u0E49 " + n(r2);
   },
   breadcrumbMore: "\u0E41\u0E2A\u0E14\u0E07\u0E40\u0E2A\u0E49\u0E19\u0E17\u0E32\u0E07\u0E17\u0E31\u0E49\u0E07\u0E2B\u0E21\u0E14",
   stepError: "\u0E21\u0E35\u0E02\u0E49\u0E2D\u0E1C\u0E34\u0E14\u0E1E\u0E25\u0E32\u0E14",
+  statusDown: "\u0E25\u0E48\u0E21",
+  statusProblem: "\u0E21\u0E35\u0E1B\u0E31\u0E0D\u0E2B\u0E32",
+  statusMaintenance: "\u0E1B\u0E34\u0E14\u0E1B\u0E23\u0E31\u0E1A\u0E1B\u0E23\u0E38\u0E07",
+  statusOk: "\u0E1B\u0E01\u0E15\u0E34",
+  statusUnknown: "\u0E22\u0E31\u0E07\u0E44\u0E21\u0E48\u0E21\u0E35\u0E02\u0E49\u0E2D\u0E21\u0E39\u0E25",
   accepts: function(list, max) {
     return [list, max && "\u0E44\u0E21\u0E48\u0E40\u0E01\u0E34\u0E19 " + max + " \u0E15\u0E48\u0E2D\u0E44\u0E1F\u0E25\u0E4C"].filter(Boolean).join(" \xB7 ");
   }
@@ -460,11 +468,16 @@ var sv = {
   pageN: function(p) {
     return "Sida " + p;
   },
-  progressReserved: function(v, r, max) {
-    return nsv(v) + " av " + nsv(max) + " anv\xE4nda, " + nsv(r) + " reserverade";
+  progressReserved: function(v, r2, max) {
+    return nsv(v) + " av " + nsv(max) + " anv\xE4nda, " + nsv(r2) + " reserverade";
   },
   breadcrumbMore: "Visa hela s\xF6kv\xE4gen",
   stepError: "har fel",
+  statusDown: "Nere",
+  statusProblem: "Problem",
+  statusMaintenance: "Underh\xE5ll",
+  statusOk: "OK",
+  statusUnknown: "Ingen data",
   accepts: function(list, max) {
     return [list, max && "h\xF6gst " + max + " per fil"].filter(Boolean).join(", ");
   }
@@ -592,11 +605,16 @@ var STRINGS = {
     pageN: function(p) {
       return "Page " + p;
     },
-    progressReserved: function(v, r, max) {
-      return n2(v) + " of " + n2(max) + " used, " + n2(r) + " reserved";
+    progressReserved: function(v, r2, max) {
+      return n2(v) + " of " + n2(max) + " used, " + n2(r2) + " reserved";
     },
     breadcrumbMore: "Show the full path",
     stepError: "has errors",
+    statusDown: "Down",
+    statusProblem: "Problem",
+    statusMaintenance: "Maintenance",
+    statusOk: "OK",
+    statusUnknown: "No data",
     accepts: function(list, max) {
       return [list, max && "up to " + max + " each"].filter(Boolean).join(", ");
     }
@@ -607,14 +625,14 @@ var STRINGS = {
 
 // src/theme.ts
 function hexToRgb(hex) {
-  let h5 = String(hex).trim().replace("#", "");
-  if (h5.length === 3)
-    h5 = h5.split("").map(function(c) {
+  let h6 = String(hex).trim().replace("#", "");
+  if (h6.length === 3)
+    h6 = h6.split("").map(function(c) {
       return c + c;
     }).join("");
-  if (!/^[0-9a-f]{6}$/i.test(h5)) throw new Error('createTheme: "' + hex + '" is not a #rgb or #rrggbb colour');
+  if (!/^[0-9a-f]{6}$/i.test(h6)) throw new Error('createTheme: "' + hex + '" is not a #rgb or #rrggbb colour');
   return [0, 2, 4].map(function(i) {
-    return parseInt(h5.slice(i, i + 2), 16) / 255;
+    return parseInt(h6.slice(i, i + 2), 16) / 255;
   });
 }
 function rgbToHex(rgb) {
@@ -630,10 +648,10 @@ function delin(c) {
   return c <= 31308e-7 ? 12.92 * c : 1.055 * Math.pow(c, 1 / 2.4) - 0.055;
 }
 function rgbToOklch(rgb) {
-  const r = lin(rgb[0]), g = lin(rgb[1]), b = lin(rgb[2]);
-  const l = Math.cbrt(0.4122214708 * r + 0.5363325363 * g + 0.0514459929 * b);
-  const m = Math.cbrt(0.2119034982 * r + 0.6806995451 * g + 0.1073969566 * b);
-  const s = Math.cbrt(0.0883024619 * r + 0.2817188376 * g + 0.6299787005 * b);
+  const r2 = lin(rgb[0]), g = lin(rgb[1]), b = lin(rgb[2]);
+  const l = Math.cbrt(0.4122214708 * r2 + 0.5363325363 * g + 0.0514459929 * b);
+  const m = Math.cbrt(0.2119034982 * r2 + 0.6806995451 * g + 0.1073969566 * b);
+  const s = Math.cbrt(0.0883024619 * r2 + 0.2817188376 * g + 0.6299787005 * b);
   const L = 0.2104542553 * l + 0.793617785 * m - 0.0040720468 * s;
   const A = 1.9779984951 * l - 2.428592205 * m + 0.4505937099 * s;
   const B = 0.0259040371 * l + 0.7827717662 * m - 0.808675766 * s;
@@ -793,13 +811,13 @@ function createTheme(opts) {
   D["card-shadow-creative"] = "8px 8px 0px " + shadowDark;
   const checks = [];
   function check(theme, fg, bg, target, fgHex, bgHex) {
-    const r = contrast(fgHex, bgHex);
+    const r2 = contrast(fgHex, bgHex);
     checks.push({
       theme,
       pair: fg + " on " + bg,
-      ratio: Math.round(r * 100) / 100,
+      ratio: Math.round(r2 * 100) / 100,
       target,
-      pass: r >= target - 5e-3
+      pass: r2 >= target - 5e-3
     });
   }
   [
@@ -919,6 +937,18 @@ function colorSchemeScript(options) {
 
 // src/breakpoints.ts
 var breakpoints = { sm: 640, md: 768, lg: 1024, xl: 1280 };
+var ORDER = ["base", "sm", "md", "lg", "xl"];
+function respVars(prefix, value, map2) {
+  const style = {};
+  if (value == null) return style;
+  if (typeof value !== "object") value = { base: value };
+  let byBp = value, cur;
+  ORDER.forEach(function(k) {
+    if (byBp[k] !== void 0) cur = map2 ? map2(byBp[k]) : byBp[k];
+    if (cur !== void 0) style["--" + prefix + "-" + k] = cur;
+  });
+  return style;
+}
 
 // src/display.tsx
 var React3 = __toESM(require("react"), 1);
@@ -982,9 +1012,9 @@ function iconSvg(shapes, props, ref) {
       ...a11y
     },
     shapes.map(function(s, i) {
-      const attrs = { key: i };
-      for (const k in s[1]) attrs[k === "stroke-width" ? "strokeWidth" : k] = s[1][k];
-      return h(s[0], attrs);
+      const attrs2 = { key: i };
+      for (const k in s[1]) attrs2[k === "stroke-width" ? "strokeWidth" : k] = s[1][k];
+      return h(s[0], attrs2);
     })
   );
 }
@@ -1116,6 +1146,14 @@ var IconTrendingDown = /* @__PURE__ */ defineIcon("trending-down", [
   ["path", { d: "M16 17h6v-6" }],
   ["path", { d: "m22 17-8.5-8.5-5 5L2 7" }]
 ]);
+var IconWrench = /* @__PURE__ */ defineIcon("wrench", [
+  [
+    "path",
+    {
+      d: "M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.106-3.105c.32-.322.863-.22.983.218a6 6 0 0 1-8.259 7.057l-7.91 7.91a1 1 0 0 1-2.999-3l7.91-7.91a6 6 0 0 1 7.057-8.259c.438.12.54.662.219.984z"
+    }
+  ]
+]);
 
 // src/display.tsx
 var h2 = React3.createElement;
@@ -1356,14 +1394,14 @@ function ServerAvatar(props) {
 var React4 = __toESM(require("react"), 1);
 var h3 = React4.createElement;
 var Container = React4.forwardRef(function Container2(props, ref) {
-  const attrs = {};
+  const attrs2 = {};
   Object.keys(props).forEach(function(k) {
     if (k === "id" || k === "lang" || k === "dir" || /^(aria|data)-/.test(k))
-      attrs[k] = props[k];
+      attrs2[k] = props[k];
   });
   return h3(
     props.as || "div",
-    Object.assign(attrs, {
+    Object.assign(attrs2, {
       ref,
       className: cx(
         "aura-container",
@@ -1381,15 +1419,15 @@ var Container = React4.forwardRef(function Container2(props, ref) {
 var React5 = __toESM(require("react"), 1);
 var h4 = React5.createElement;
 var PageHeader = React5.forwardRef(function PageHeader2(props, ref) {
-  const attrs = {};
+  const attrs2 = {};
   Object.keys(props).forEach(function(k) {
     if (k === "id" || k === "lang" || k === "dir" || k === "role" || /^(aria|data)-/.test(k))
-      attrs[k] = props[k];
+      attrs2[k] = props[k];
   });
   const level = props.headingLevel || 1;
   return h4(
     "div",
-    Object.assign(attrs, { ref, className: cx("aura-page-header", props.className), style: props.style }),
+    Object.assign(attrs2, { ref, className: cx("aura-page-header", props.className), style: props.style }),
     h4(
       "div",
       { className: "aura-page-header__text" },
@@ -1401,3 +1439,212 @@ var PageHeader = React5.forwardRef(function PageHeader2(props, ref) {
     props.actions != null && props.actions !== false ? h4("div", { className: "aura-page-header__actions" }, props.actions) : null
   );
 });
+
+// src/tiles.tsx
+var React6 = __toESM(require("react"), 1);
+var h5 = React6.createElement;
+var STATUS_ICON = {
+  down: IconCircleAlert,
+  problem: IconTriangleAlert,
+  maintenance: IconWrench,
+  ok: IconCircleCheck,
+  unknown: IconCircleDotDashed
+};
+var STATUS_TONE = {
+  down: "danger",
+  problem: "warning",
+  maintenance: "accent",
+  ok: "default",
+  unknown: "default"
+};
+var STATUS_WORD = {
+  down: "statusDown",
+  problem: "statusProblem",
+  maintenance: "statusMaintenance",
+  ok: "statusOk",
+  unknown: "statusUnknown"
+};
+function statusWord(status, t) {
+  return String(t[STATUS_WORD[status]] || STATUS_WORD[status]);
+}
+function attrs(props) {
+  const out = {};
+  Object.keys(props).forEach(function(k) {
+    if (k === "id" || k === "style" || k === "lang" || k === "dir" || /^(aria|data)-/.test(k))
+      out[k] = props[k];
+  });
+  return out;
+}
+var comma = h5("span", { className: "aura-status-tile__sep" }, ",");
+function statusTileElement(props, ref, Link, t, titleRef) {
+  const status = STATUS_ICON[props.status] ? props.status : "unknown";
+  if (status !== props.status)
+    devWarnOnce(
+      "status-tile-status-" + String(props.status),
+      'StatusTile status="' + String(props.status) + '" is not down, problem, maintenance, ok or unknown: it shows as unknown ("No data"). Map your value first.'
+    );
+  const valueTone = props.valueTone || STATUS_TONE[status];
+  const word = props.statusLabel || statusWord(status, t);
+  const markers = (props.markers || []).filter(Boolean);
+  const has = function(v) {
+    return v != null && v !== false && v !== "";
+  };
+  const hasValue = has(props.value), hasMeta = has(props.meta);
+  const Tag = props.href ? Link : "div";
+  return h5(
+    Tag,
+    Object.assign(attrs(props), {
+      ref,
+      href: props.href,
+      className: cx("aura-status-tile", "aura-status-tile--" + status, props.href && "is-interactive", props.className)
+    }),
+    h5(
+      "span",
+      { className: "aura-status-tile__head" },
+      h5(Icon, { name: h5(STATUS_ICON[status]), size: 16, className: "aura-status-tile__icon" }),
+      h5("span", { className: "aura-status-tile__title", ref: titleRef }, props.title, comma),
+      h5("span", { className: "aura-sr-only" }, word + (hasValue || hasMeta || markers.length ? "," : "")),
+      hasValue ? h5(
+        "span",
+        { className: cx("aura-status-tile__value", "is-" + valueTone) },
+        props.value,
+        hasMeta || markers.length ? comma : null
+      ) : null
+    ),
+    hasMeta || markers.length ? h5(
+      "span",
+      { className: "aura-status-tile__foot" },
+      hasMeta ? h5("span", { className: "aura-status-tile__meta" }, props.meta, markers.length ? comma : null) : null,
+      markers.length ? h5(
+        "span",
+        { className: "aura-status-tile__markers" },
+        markers.map(function(m, i) {
+          return h5(
+            "span",
+            {
+              key: i,
+              className: cx("aura-status-tile__marker", "is-" + (m.tone || "neutral")),
+              "data-aura-tip": m.label
+            },
+            h5(Icon, { name: m.icon, size: 14 }),
+            h5("span", { className: "aura-sr-only" }, m.label + (i < markers.length - 1 ? "," : ""))
+          );
+        })
+      ) : null
+    ) : null
+  );
+}
+function ServerStatusTile(props) {
+  return statusTileElement(props, void 0, props.linkComponent || "a", STRINGS.en);
+}
+var TileGrid = React6.forwardRef(function TileGrid2(props, ref) {
+  const style = Object.assign(
+    {},
+    respVars("aura-grid-cols", props.columns == null ? { base: 2, md: 3 } : props.columns),
+    props.style
+  );
+  return h5(
+    "ul",
+    Object.assign(attrs(props), {
+      ref,
+      role: "list",
+      className: cx("aura-grid-layout", "aura-tile-grid", props.className),
+      style
+    }),
+    /* toArray drops null and booleans and keys each element; a Fragment's children are items too. */
+    flat(props.children).map(function(c, i) {
+      return h5("li", { key: React6.isValidElement(c) && c.key != null ? c.key : i }, c);
+    })
+  );
+});
+function flat(children) {
+  const out = [];
+  React6.Children.toArray(children).forEach(function(c) {
+    if (React6.isValidElement(c) && c.type === React6.Fragment)
+      flat(c.props.children).forEach(function(x) {
+        out.push(React6.isValidElement(x) ? React6.cloneElement(x, { key: String(c.key) + "/" + String(x.key) }) : x);
+      });
+    else if (c !== "") out.push(c);
+  });
+  return out;
+}
+var SIZES2 = { sm: [80, 24], md: [120, 32] };
+var PAD = 2;
+function r(n3) {
+  return Math.round(n3 * 100) / 100;
+}
+function num(v) {
+  return typeof v === "number" && isFinite(v) ? v : null;
+}
+var Sparkline = React6.forwardRef(function Sparkline2(props, ref) {
+  const wh = SIZES2[props.size || "sm"] || SIZES2.sm;
+  const W = wh[0], H = wh[1];
+  const data = (props.data || []).map(num);
+  const n3 = data.length;
+  const vals = data.filter(function(v) {
+    return v != null;
+  });
+  let lo = num(props.min), hi = num(props.max);
+  if (lo == null) lo = vals.length ? Math.min.apply(null, vals) : 0;
+  if (hi == null) hi = vals.length ? Math.max.apply(null, vals) : 0;
+  if (lo > hi) {
+    const s = lo;
+    lo = hi;
+    hi = s;
+  }
+  const step = n3 > 1 ? (W - 2 * PAD) / (n3 - 1) : 0;
+  const x = function(i) {
+    return n3 > 1 ? PAD + i * step : W / 2;
+  };
+  const y = function(v) {
+    if (hi === lo) return H / 2;
+    const k = Math.max(0, Math.min(1, (v - lo) / (hi - lo)));
+    return H - PAD - k * (H - 2 * PAD);
+  };
+  let d = "";
+  const dots = [];
+  data.forEach(function(v, i) {
+    if (v == null) return;
+    const prev = i > 0 && data[i - 1] != null, next = i < n3 - 1 && data[i + 1] != null;
+    if (!prev && !next) dots.push(h5("circle", { key: "d" + i, cx: r(x(i)), cy: r(y(v)), r: 1.5 }));
+    else d += (prev ? "L" : "M") + r(x(i)) + " " + r(y(v));
+  });
+  const mode = props.failures || "none";
+  const fails = [];
+  if (mode !== "none" && props.failed)
+    data.forEach(function(_v, i) {
+      if (!props.failed[i]) return;
+      if (mode === "band") {
+        const w = Math.max(2, step || W), left = Math.max(0, x(i) - w / 2), right = Math.min(W, x(i) + w / 2);
+        fails.push(h5("rect", { key: "f" + i, x: r(left), y: 0, width: r(right - left), height: H }));
+      } else
+        fails.push(
+          h5("rect", {
+            key: "f" + i,
+            x: r(Math.max(0, Math.min(W - 1.5, x(i) - 0.75))),
+            y: H - 6,
+            width: 1.5,
+            height: 6
+          })
+        );
+    });
+  const named = !!props.label;
+  return h5(
+    "svg",
+    Object.assign(attrs(props), {
+      ref,
+      className: cx("aura-sparkline", "is-" + (props.tone || "neutral"), props.className),
+      width: W,
+      height: H,
+      viewBox: "0 0 " + W + " " + H,
+      role: named ? "img" : void 0,
+      "aria-label": named ? props.label : void 0,
+      "aria-hidden": named ? void 0 : true,
+      focusable: "false"
+    }),
+    fails.length && mode === "band" ? h5("g", { className: "aura-sparkline__band" }, fails) : null,
+    d ? h5("path", { className: "aura-sparkline__line", d }) : null,
+    dots.length ? h5("g", { className: "aura-sparkline__dots" }, dots) : null,
+    fails.length && mode === "ticks" ? h5("g", { className: "aura-sparkline__ticks" }, fails) : null
+  );
+});

package/dist/server/index.d.cts

@@ -112,6 +112,8 @@ export interface DateDisplayOptions {
 export type DataAttributes = {
 	[key: `data-${string}`]: string | number | boolean | undefined;
 };
+export type Breakpoint = "base" | "sm" | "md" | "lg" | "xl";
+export type Responsive<T> = T | Partial<Record<Breakpoint, T>>;
 export interface StatChange {
 	/** Shown as written, e.g. "+12%" or "−3". */
 	value: React$1.ReactNode;
@@ -199,6 +201,71 @@ export interface Theme {
 	/** CSS overriding the tokens. No selector: the whole page. A selector (".tenant-acme") scopes it. Load after aura.css. */
 	css(selector?: string): string;
 }
+/** A monitored thing's state on a StatusTile. */
+export type StatusTileStatus = "down" | "problem" | "maintenance" | "ok" | "unknown";
+/** A colour for a tile's value or a marker: `danger`, `warning`, `accent` (violet), `neutral` (grey) or `default`
+ * (the text colour). */
+export type TileTone = "danger" | "warning" | "accent" | "neutral" | "default";
+/** A small icon at the end of a StatusTile's second line ("SSL expires soon", "Muted"). */
+export interface StatusTileMarker {
+	icon: IconInput;
+	/** What it means. Read with the tile's name and shown as a tip on hover (a mouse only: on a phone, say it on the
+	 * detail page too). */
+	label: string;
+	/** Default `neutral`. */
+	tone?: TileTone | undefined;
+}
+export interface StatusTileProps extends Pick<React$1.HTMLAttributes<HTMLElement>, "id" | "style" | "lang" | "dir">, React$1.AriaAttributes, DataAttributes {
+	/** down (red), problem (amber), maintenance (violet), ok (grey) or unknown (5.35: no data yet — a dashed circle on
+	 * the plain surface). Each has its own icon too, so colour is never the only sign. */
+	status: StatusTileStatus;
+	/** The name. Wraps to two lines at most, then ends with "…"; a cut name shows in full in a tip on hover. */
+	title: React$1.ReactNode;
+	/** Top right, tabular figures: "12m", "99.98%", "240 ms". */
+	value?: React$1.ReactNode | undefined;
+	/** The value's colour. Default: the status's (down → danger, problem → warning, maintenance → accent, ok and
+	 * unknown → default). */
+	valueTone?: TileTone | undefined;
+	/** A short second line: "since 09:41", "3 of 4 checks". */
+	meta?: React$1.ReactNode | undefined;
+	/** Small icons at the end of the second line, each with a label. */
+	markers?: ReadonlyArray<StatusTileMarker> | undefined;
+	/** Makes the whole tile a link. Its name is everything the tile says, in reading order. */
+	href?: string | undefined;
+	/** Your router's link (e.g. `next/link`); defaults to AuraProvider's `linkComponent`, then `<a>`. */
+	linkComponent?: React$1.ElementType | undefined;
+	/** The status word read out after the title. Default: the locale's (Down, Problem, Maintenance, OK, No data). */
+	statusLabel?: string | undefined;
+	className?: string | undefined;
+}
+export interface TileGridProps extends Pick<React$1.HTMLAttributes<HTMLElement>, "id" | "style" | "lang" | "dir">, React$1.AriaAttributes, DataAttributes {
+	/** Equal columns, responsive like Grid. Default `{ base: 2, md: 3 }` (two on phones, three from 768px). */
+	columns?: Responsive<number> | undefined;
+	/** Each child (and each child of a Fragment) becomes one list item; the grid is a `ul` with an 8px gap. */
+	children?: React$1.ReactNode;
+	className?: string | undefined;
+}
+export interface SparklineProps extends Pick<React$1.SVGAttributes<SVGSVGElement>, "id" | "style">, DataAttributes {
+	/** The values, oldest first. `null` (or a value that isn't a finite number) is no point: the line breaks there. */
+	data: ReadonlyArray<number | null | undefined>;
+	/** Which points failed, by the same index as `data`. Shown only when `failures` isn't `none`. */
+	failed?: ReadonlyArray<boolean | null | undefined> | undefined;
+	/** How failed points show: `none` (default), `band` (a red band behind the point) or `ticks` (a red tick at the
+	 * foot). */
+	failures?: "none" | "band" | "ticks" | undefined;
+	/** The line's colour. Default `neutral`. */
+	tone?: "neutral" | "accent" | "danger" | "warning" | "positive" | undefined;
+	/** `sm` 80×24 (default), `md` 120×32. */
+	size?: "sm" | "md" | undefined;
+	/** The scale's ends; default the data's own lowest and highest. Give tiles the same ones to compare them. Values
+	 * beyond them are drawn at the edge. */
+	min?: number | undefined;
+	max?: number | undefined;
+	/** What the line says, for screen readers ("Response time, last 24 h: 180–420 ms, 2 failures"). Without it the
+	 * sparkline is decoration and hidden from them. */
+	label?: string | undefined;
+	className?: string | undefined;
+}
 /** Options for formatDate: locale/calendar plus a preset or any Intl.DateTimeFormat options. */
 export type FormatDateOptions = DateDisplayOptions & {
 	format?: "short" | "long" | "numeric" | Intl.DateTimeFormatOptions | undefined;
@@ -309,6 +376,13 @@ export interface AuraStrings {
 	breadcrumbMore: string;
 	/** A Stepper step with `status: 'error'` (5.18). */
 	stepError: string;
+	/** StatusTile's status words (5.34). */
+	statusDown: string;
+	statusProblem: string;
+	statusMaintenance: string;
+	statusOk: string;
+	/** StatusTile `unknown` (5.35). */
+	statusUnknown: string;
 }
 /** Built-in strings by locale. th and sv also ship as packs (`@jirawatpyk/aura-react/locales/th`, `/sv`, 5.9); in 6.0
  * only en stays built in and a Thai or Swedish app passes its pack to AuraProvider `strings`. */
@@ -430,6 +504,9 @@ export interface PageHeaderProps extends Pick<React$1.HTMLAttributes<HTMLElement
 	style?: React$1.CSSProperties | undefined;
 }
 export declare const PageHeader: React$1.ForwardRefExoticComponent<PageHeaderProps & React$1.RefAttributes<HTMLDivElement>>;
+declare function ServerStatusTile(props: StatusTileProps): React$1.ReactElement;
+export declare const TileGrid: React$1.ForwardRefExoticComponent<TileGridProps & React$1.RefAttributes<HTMLUListElement>>;
+export declare const Sparkline: React$1.ForwardRefExoticComponent<SparklineProps & React$1.RefAttributes<SVGSVGElement>>;
 
 export {
 	ServerAlert as Alert,
@@ -439,6 +516,7 @@ export {
 	ServerEmptyState as EmptyState,
 	ServerStat as Stat,
 	ServerStatusPill as StatusPill,
+	ServerStatusTile as StatusTile,
 	scale as brandScale,
 	toneFor as statusTone,
 };

package/dist/server/index.d.ts

@@ -112,6 +112,8 @@ export interface DateDisplayOptions {
 export type DataAttributes = {
 	[key: `data-${string}`]: string | number | boolean | undefined;
 };
+export type Breakpoint = "base" | "sm" | "md" | "lg" | "xl";
+export type Responsive<T> = T | Partial<Record<Breakpoint, T>>;
 export interface StatChange {
 	/** Shown as written, e.g. "+12%" or "−3". */
 	value: React$1.ReactNode;
@@ -199,6 +201,71 @@ export interface Theme {
 	/** CSS overriding the tokens. No selector: the whole page. A selector (".tenant-acme") scopes it. Load after aura.css. */
 	css(selector?: string): string;
 }
+/** A monitored thing's state on a StatusTile. */
+export type StatusTileStatus = "down" | "problem" | "maintenance" | "ok" | "unknown";
+/** A colour for a tile's value or a marker: `danger`, `warning`, `accent` (violet), `neutral` (grey) or `default`
+ * (the text colour). */
+export type TileTone = "danger" | "warning" | "accent" | "neutral" | "default";
+/** A small icon at the end of a StatusTile's second line ("SSL expires soon", "Muted"). */
+export interface StatusTileMarker {
+	icon: IconInput;
+	/** What it means. Read with the tile's name and shown as a tip on hover (a mouse only: on a phone, say it on the
+	 * detail page too). */
+	label: string;
+	/** Default `neutral`. */
+	tone?: TileTone | undefined;
+}
+export interface StatusTileProps extends Pick<React$1.HTMLAttributes<HTMLElement>, "id" | "style" | "lang" | "dir">, React$1.AriaAttributes, DataAttributes {
+	/** down (red), problem (amber), maintenance (violet), ok (grey) or unknown (5.35: no data yet — a dashed circle on
+	 * the plain surface). Each has its own icon too, so colour is never the only sign. */
+	status: StatusTileStatus;
+	/** The name. Wraps to two lines at most, then ends with "…"; a cut name shows in full in a tip on hover. */
+	title: React$1.ReactNode;
+	/** Top right, tabular figures: "12m", "99.98%", "240 ms". */
+	value?: React$1.ReactNode | undefined;
+	/** The value's colour. Default: the status's (down → danger, problem → warning, maintenance → accent, ok and
+	 * unknown → default). */
+	valueTone?: TileTone | undefined;
+	/** A short second line: "since 09:41", "3 of 4 checks". */
+	meta?: React$1.ReactNode | undefined;
+	/** Small icons at the end of the second line, each with a label. */
+	markers?: ReadonlyArray<StatusTileMarker> | undefined;
+	/** Makes the whole tile a link. Its name is everything the tile says, in reading order. */
+	href?: string | undefined;
+	/** Your router's link (e.g. `next/link`); defaults to AuraProvider's `linkComponent`, then `<a>`. */
+	linkComponent?: React$1.ElementType | undefined;
+	/** The status word read out after the title. Default: the locale's (Down, Problem, Maintenance, OK, No data). */
+	statusLabel?: string | undefined;
+	className?: string | undefined;
+}
+export interface TileGridProps extends Pick<React$1.HTMLAttributes<HTMLElement>, "id" | "style" | "lang" | "dir">, React$1.AriaAttributes, DataAttributes {
+	/** Equal columns, responsive like Grid. Default `{ base: 2, md: 3 }` (two on phones, three from 768px). */
+	columns?: Responsive<number> | undefined;
+	/** Each child (and each child of a Fragment) becomes one list item; the grid is a `ul` with an 8px gap. */
+	children?: React$1.ReactNode;
+	className?: string | undefined;
+}
+export interface SparklineProps extends Pick<React$1.SVGAttributes<SVGSVGElement>, "id" | "style">, DataAttributes {
+	/** The values, oldest first. `null` (or a value that isn't a finite number) is no point: the line breaks there. */
+	data: ReadonlyArray<number | null | undefined>;
+	/** Which points failed, by the same index as `data`. Shown only when `failures` isn't `none`. */
+	failed?: ReadonlyArray<boolean | null | undefined> | undefined;
+	/** How failed points show: `none` (default), `band` (a red band behind the point) or `ticks` (a red tick at the
+	 * foot). */
+	failures?: "none" | "band" | "ticks" | undefined;
+	/** The line's colour. Default `neutral`. */
+	tone?: "neutral" | "accent" | "danger" | "warning" | "positive" | undefined;
+	/** `sm` 80×24 (default), `md` 120×32. */
+	size?: "sm" | "md" | undefined;
+	/** The scale's ends; default the data's own lowest and highest. Give tiles the same ones to compare them. Values
+	 * beyond them are drawn at the edge. */
+	min?: number | undefined;
+	max?: number | undefined;
+	/** What the line says, for screen readers ("Response time, last 24 h: 180–420 ms, 2 failures"). Without it the
+	 * sparkline is decoration and hidden from them. */
+	label?: string | undefined;
+	className?: string | undefined;
+}
 /** Options for formatDate: locale/calendar plus a preset or any Intl.DateTimeFormat options. */
 export type FormatDateOptions = DateDisplayOptions & {
 	format?: "short" | "long" | "numeric" | Intl.DateTimeFormatOptions | undefined;
@@ -309,6 +376,13 @@ export interface AuraStrings {
 	breadcrumbMore: string;
 	/** A Stepper step with `status: 'error'` (5.18). */
 	stepError: string;
+	/** StatusTile's status words (5.34). */
+	statusDown: string;
+	statusProblem: string;
+	statusMaintenance: string;
+	statusOk: string;
+	/** StatusTile `unknown` (5.35). */
+	statusUnknown: string;
 }
 /** Built-in strings by locale. th and sv also ship as packs (`@jirawatpyk/aura-react/locales/th`, `/sv`, 5.9); in 6.0
  * only en stays built in and a Thai or Swedish app passes its pack to AuraProvider `strings`. */
@@ -430,6 +504,9 @@ export interface PageHeaderProps extends Pick<React$1.HTMLAttributes<HTMLElement
 	style?: React$1.CSSProperties | undefined;
 }
 export declare const PageHeader: React$1.ForwardRefExoticComponent<PageHeaderProps & React$1.RefAttributes<HTMLDivElement>>;
+declare function ServerStatusTile(props: StatusTileProps): React$1.ReactElement;
+export declare const TileGrid: React$1.ForwardRefExoticComponent<TileGridProps & React$1.RefAttributes<HTMLUListElement>>;
+export declare const Sparkline: React$1.ForwardRefExoticComponent<SparklineProps & React$1.RefAttributes<SVGSVGElement>>;
 
 export {
 	ServerAlert as Alert,
@@ -439,6 +516,7 @@ export {
 	ServerEmptyState as EmptyState,
 	ServerStat as Stat,
 	ServerStatusPill as StatusPill,
+	ServerStatusTile as StatusTile,
 	scale as brandScale,
 	toneFor as statusTone,
 };