@rookcom/monarch-react 0.0.0-stage → 0.3.0

package/dist/components/data-display/relative-time/relative-time.d.ts

@@ -0,0 +1,66 @@
+import { type HTMLAttributes } from 'react';
+/** Anything `new Date()` accepts: a Date, epoch milliseconds or an ISO 8601 string. */
+export type DateInput = Date | number | string;
+export interface FormatRelativeTimeOptions {
+    /** The reference time. Default: the current time. */
+    now?: DateInput;
+    /** BCP 47 locale, e.g. `en-GB`. Default: the runtime locale. */
+    locale?: string;
+    /** `auto` writes "yesterday" and "now"; `always` writes "1 day ago". Default `auto`. */
+    numeric?: 'auto' | 'always';
+    /** Unit length: "3 minutes ago" (`long`), "3 min. ago" (`short`), "3m ago" (`narrow`). Default `long`. */
+    format?: 'long' | 'short' | 'narrow';
+}
+/**
+ * Picks the largest unit that keeps the value below its rollover, after
+ * rounding, so 59.6 minutes reads "1 hour ago" and not "60 minutes ago".
+ */
+export declare function relativeTimeParts(date: DateInput, now?: DateInput): {
+    value: number;
+    unit: Intl.RelativeTimeFormatUnit;
+};
+/** Formats a date relative to `now` with `Intl.RelativeTimeFormat` ("3 hours ago", "in 2 days"). */
+export declare function formatRelativeTime(date: DateInput, options?: FormatRelativeTimeOptions): string;
+export interface RelativeTimeProps extends Omit<HTMLAttributes<HTMLTimeElement>, 'children' | 'dateTime'> {
+    /** The moment to describe. A Date, epoch milliseconds or an ISO 8601 string. */
+    date: DateInput;
+    /**
+     * The reference time. Pass it from the server (and the same value on the
+     * client) for byte-identical server rendering; without it the text is
+     * computed from the clock and corrected right after hydration.
+     */
+    now?: DateInput;
+    /** BCP 47 locale for both the relative and the absolute text. Default: the runtime locale. */
+    locale?: string;
+    /** IANA time zone for the absolute text, e.g. `Europe/London`. Default: the viewer's zone. */
+    timeZone?: string;
+    /** `auto` writes "yesterday" and "now"; `always` writes "1 day ago". Default `auto`. */
+    numeric?: 'auto' | 'always';
+    /** Unit length: `long` "3 minutes ago", `short` "3 min. ago", `narrow` "3m ago". Default `long`. */
+    format?: 'long' | 'short' | 'narrow';
+    /** `Intl.DateTimeFormat` options for the absolute time. Default `{ dateStyle: 'medium', timeStyle: 'short' }`. */
+    absoluteFormat?: Intl.DateTimeFormatOptions;
+    /**
+     * Show the absolute date instead of relative text once the moment is more
+     * than this many milliseconds away, e.g. `7 * 86_400_000` for "a week".
+     */
+    absoluteAfter?: number;
+    /**
+     * Re-render as time passes: `true` picks an interval from the age (5 s for
+     * the first minute, then 30 s, 5 min and 1 h); a number is a fixed interval
+     * in milliseconds. Default `false`.
+     */
+    live?: boolean | number;
+    /**
+     * Show the absolute time in a tooltip on hover and keyboard focus. Makes the
+     * timestamp a tab stop. Default `true`; set `false` in dense lists where
+     * the absolute time is shown elsewhere.
+     */
+    tooltip?: boolean;
+}
+/**
+ * A `<time datetime>` with localised relative text ("3 hours ago") and the
+ * absolute time on hover and focus.
+ */
+export declare const RelativeTime: import("react").ForwardRefExoticComponent<RelativeTimeProps & import("react").RefAttributes<HTMLTimeElement>>;
+//# sourceMappingURL=relative-time.d.ts.map

package/dist/components/data-display/relative-time/relative-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relative-time.d.ts","sourceRoot":"","sources":["../../../../src/components/data-display/relative-time/relative-time.tsx"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,cAAc,EAEpB,MAAM,OAAO,CAAC;AAGf,uFAAuF;AACvF,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAE/C,MAAM,WAAW,yBAAyB;IACxC,qDAAqD;IACrD,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC5B,0GAA0G;IAC1G,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;CACtC;AAiBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,SAAS,EACf,GAAG,GAAE,SAAsB,GAC1B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC,sBAAsB,CAAA;CAAE,CAOtD;AAED,oGAAoG;AACpG,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,yBAA8B,GACtC,MAAM,CAIR;AAsBD,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAC7C,cAAc,CAAC,eAAe,CAAC,EAC/B,UAAU,GAAG,UAAU,CACxB;IACC,gFAAgF;IAChF,IAAI,EAAE,SAAS,CAAC;IAChB;;;;OAIG;IACH,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,8FAA8F;IAC9F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC5B,oGAAoG;IACpG,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrC,kHAAkH;IAClH,cAAc,CAAC,EAAE,IAAI,CAAC,qBAAqB,CAAC;IAC5C;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,+GAkGvB,CAAC"}

package/dist/components/data-display/relative-time/relative-time.js

@@ -0,0 +1,102 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef, useEffect, useId, useState, useSyncExternalStore, } from 'react';
+import { cx } from '../../../internal/cx.js';
+const UNITS = [
+    // unit, seconds per unit, switch to the next unit at this many of this one
+    ['second', 1, 60],
+    ['minute', 60, 60],
+    ['hour', 3600, 24],
+    ['day', 86400, 7],
+    ['week', 604800, 4.345],
+    ['month', 2629800, 12],
+    ['year', 31557600, Infinity],
+];
+function toDate(input) {
+    return input instanceof Date ? input : new Date(input);
+}
+/**
+ * Picks the largest unit that keeps the value below its rollover, after
+ * rounding, so 59.6 minutes reads "1 hour ago" and not "60 minutes ago".
+ */
+export function relativeTimeParts(date, now = Date.now()) {
+    const seconds = (toDate(date).getTime() - toDate(now).getTime()) / 1000;
+    for (const [unit, size, rollover] of UNITS) {
+        const value = Math.round(seconds / size);
+        if (Math.abs(value) < rollover)
+            return { value: value === 0 ? 0 : value, unit };
+    }
+    return { value: Math.round(seconds / 31557600), unit: 'year' };
+}
+/** Formats a date relative to `now` with `Intl.RelativeTimeFormat` ("3 hours ago", "in 2 days"). */
+export function formatRelativeTime(date, options = {}) {
+    const { now = Date.now(), locale, numeric = 'auto', format = 'long' } = options;
+    const { value, unit } = relativeTimeParts(date, now);
+    return new Intl.RelativeTimeFormat(locale, { numeric, style: format }).format(value, unit);
+}
+/** How often to re-render a live timestamp: often while it is fresh, rarely once it is old. */
+function tickFor(date, now) {
+    const age = Math.abs(now - date.getTime());
+    if (age < 60_000)
+        return 5_000;
+    if (age < 3_600_000)
+        return 30_000;
+    if (age < 86_400_000)
+        return 300_000;
+    return 3_600_000;
+}
+const noopSubscribe = () => () => { };
+/** False on the server and during hydration, true afterwards and on client-only mounts. */
+function useHydrated() {
+    return useSyncExternalStore(noopSubscribe, () => true, () => false);
+}
+const DEFAULT_ABSOLUTE = { dateStyle: 'medium', timeStyle: 'short' };
+/**
+ * A `<time datetime>` with localised relative text ("3 hours ago") and the
+ * absolute time on hover and focus.
+ */
+export const RelativeTime = forwardRef(function RelativeTime({ date, now: nowProp, locale, timeZone, numeric = 'auto', format = 'long', absoluteFormat = DEFAULT_ABSOLUTE, absoluteAfter, live = false, tooltip = true, className, onKeyDown, onBlur, ...rest }, ref) {
+    const tipId = useId();
+    const injected = nowProp === undefined ? undefined : toDate(nowProp).getTime();
+    // The clock is read once for the first render, so server and client agree
+    // when `now` is injected; otherwise the effect below corrects it after mount.
+    const [clock, setClock] = useState(() => injected ?? Date.now());
+    const [dismissed, setDismissed] = useState(false);
+    const hydrated = useHydrated();
+    const now = injected ?? clock;
+    const when = toDate(date);
+    const valid = !Number.isNaN(when.getTime());
+    useEffect(() => {
+        if (injected === undefined)
+            setClock(Date.now());
+    }, [injected, hydrated]);
+    useEffect(() => {
+        if (!live || injected !== undefined || !valid)
+            return;
+        const delay = typeof live === 'number' ? live : tickFor(when, Date.now());
+        const timer = setTimeout(() => setClock(Date.now()), delay);
+        return () => clearTimeout(timer);
+        // Re-arms after every tick because `clock` changes.
+    }, [live, injected, valid, when.getTime(), clock]); // eslint-disable-line react-hooks/exhaustive-deps
+    if (!valid) {
+        return (_jsx("time", { ref: ref, ...rest, className: cx('mn-relative-time', className), "data-invalid": "", children: "\u2014" }));
+    }
+    const absolute = new Intl.DateTimeFormat(locale, {
+        ...absoluteFormat,
+        ...(timeZone ? { timeZone } : {}),
+    }).format(when);
+    const useAbsolute = absoluteAfter !== undefined && Math.abs(now - when.getTime()) > absoluteAfter;
+    const text = useAbsolute
+        ? absolute
+        : formatRelativeTime(when, { now, numeric, format, ...(locale ? { locale } : {}) });
+    const showTip = tooltip && !useAbsolute;
+    return (_jsxs("span", { className: cx('mn-relative-time', className), "data-dismissed": dismissed || undefined, children: [_jsx("time", { ref: ref, ...rest, className: "mn-relative-time__text", dateTime: when.toISOString(), tabIndex: showTip ? 0 : rest.tabIndex, "aria-describedby": showTip ? tipId : rest['aria-describedby'], suppressHydrationWarning: true, onKeyDown: (event) => {
+                    if (event.key === 'Escape' && showTip)
+                        setDismissed(true);
+                    onKeyDown?.(event);
+                }, onBlur: (event) => {
+                    setDismissed(false);
+                    onBlur?.(event);
+                }, onPointerLeave: () => setDismissed(false), children: text }), showTip ? (_jsx("span", { id: tipId, role: "tooltip", className: "mn-relative-time__tip", suppressHydrationWarning: true, children: absolute })) : null] }, hydrated ? 'client' : 'server'));
+});
+//# sourceMappingURL=relative-time.js.map

package/dist/components/data-display/relative-time/relative-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relative-time.js","sourceRoot":"","sources":["../../../../src/components/data-display/relative-time/relative-time.tsx"],"names":[],"mappings":"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"}

package/dist/components/data-display/stat-card/index.d.ts

@@ -0,0 +1,2 @@
+export * from './stat-card.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/data-display/stat-card/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/data-display/stat-card/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/components/data-display/stat-card/index.js

@@ -0,0 +1,2 @@
+export * from './stat-card.js';
+//# sourceMappingURL=index.js.map

package/dist/components/data-display/stat-card/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/data-display/stat-card/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/components/data-display/stat-card/stat-card.d.ts

@@ -0,0 +1,19 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+export interface StatCardProps extends HTMLAttributes<HTMLDivElement> {
+    label: ReactNode;
+    /** Formatted value, e.g. "₹12.4L" or "143". */
+    value: ReactNode;
+    /** Change versus the previous period, e.g. "+12%". */
+    delta?: ReactNode;
+    /** Direction of the change; `up` is success unless `deltaTone` says otherwise. */
+    deltaDirection?: 'up' | 'down' | 'flat';
+    /** Override the colour of the delta, e.g. `danger` when up is bad (churn). */
+    deltaTone?: 'success' | 'danger' | 'neutral';
+    /** Period label, e.g. "vs last 30 days". */
+    caption?: ReactNode;
+    /** Sparkline or icon slot. */
+    visual?: ReactNode;
+}
+/** Single KPI for dashboards (Dots pipelines, Pulse). */
+export declare function StatCard({ label, value, delta, deltaDirection, deltaTone, caption, visual, className, ...rest }: StatCardProps): import("react").JSX.Element;
+//# sourceMappingURL=stat-card.d.ts.map

package/dist/components/data-display/stat-card/stat-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stat-card.d.ts","sourceRoot":"","sources":["../../../../src/components/data-display/stat-card/stat-card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvD,MAAM,WAAW,aAAc,SAAQ,cAAc,CAAC,cAAc,CAAC;IACnE,KAAK,EAAE,SAAS,CAAC;IACjB,+CAA+C;IAC/C,KAAK,EAAE,SAAS,CAAC;IACjB,sDAAsD;IACtD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,kFAAkF;IAClF,cAAc,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IACxC,8EAA8E;IAC9E,SAAS,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC7C,4CAA4C;IAC5C,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,yDAAyD;AACzD,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,KAAK,EACL,KAAK,EACL,cAAuB,EACvB,SAAS,EACT,OAAO,EACP,MAAM,EACN,SAAS,EACT,GAAG,IAAI,EACR,EAAE,aAAa,+BAiCf"}

package/dist/components/data-display/stat-card/stat-card.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cx } from '../../../internal/cx.js';
+import { VisuallyHidden } from '../../layout/visually-hidden/index.js';
+/** Single KPI for dashboards (Dots pipelines, Pulse). */
+export function StatCard({ label, value, delta, deltaDirection = 'flat', deltaTone, caption, visual, className, ...rest }) {
+    const tone = deltaTone ??
+        (deltaDirection === 'up' ? 'success' : deltaDirection === 'down' ? 'danger' : 'neutral');
+    const srDirection = deltaDirection === 'up' ? 'increase' : deltaDirection === 'down' ? 'decrease' : 'no change';
+    return (_jsxs("div", { ...rest, className: cx('mn-stat', className), children: [_jsxs("div", { className: "mn-stat__body", children: [_jsx("p", { className: "mn-stat__label", children: label }), _jsx("p", { className: "mn-stat__value", children: value }), delta !== undefined || caption ? (_jsxs("p", { className: "mn-stat__footer", children: [delta !== undefined ? (_jsxs("span", { className: "mn-stat__delta", "data-tone": tone, "data-direction": deltaDirection, children: [_jsx("span", { "aria-hidden": true, children: deltaDirection === 'up' ? '↑' : deltaDirection === 'down' ? '↓' : '→' }), _jsxs(VisuallyHidden, { children: [srDirection, " "] }), delta] })) : null, caption ? _jsx("span", { className: "mn-stat__caption", children: caption }) : null] })) : null] }), visual ? (_jsx("div", { className: "mn-stat__visual", "aria-hidden": true, children: visual })) : null] }));
+}
+//# sourceMappingURL=stat-card.js.map

package/dist/components/data-display/stat-card/stat-card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stat-card.js","sourceRoot":"","sources":["../../../../src/components/data-display/stat-card/stat-card.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,EAAE,EAAE,MAAM,yBAAyB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAkBvE,yDAAyD;AACzD,MAAM,UAAU,QAAQ,CAAC,EACvB,KAAK,EACL,KAAK,EACL,KAAK,EACL,cAAc,GAAG,MAAM,EACvB,SAAS,EACT,OAAO,EACP,MAAM,EACN,SAAS,EACT,GAAG,IAAI,EACO;IACd,MAAM,IAAI,GACR,SAAS;QACT,CAAC,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC3F,MAAM,WAAW,GACf,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC;IAC9F,OAAO,CACL,kBAAS,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,aAChD,eAAK,SAAS,EAAC,eAAe,aAC5B,YAAG,SAAS,EAAC,gBAAgB,YAAE,KAAK,GAAK,EACzC,YAAG,SAAS,EAAC,gBAAgB,YAAE,KAAK,GAAK,EACxC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,CAAC,CAChC,aAAG,SAAS,EAAC,iBAAiB,aAC3B,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CACrB,gBAAM,SAAS,EAAC,gBAAgB,eAAY,IAAI,oBAAkB,cAAc,aAC9E,8CACG,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GACjE,EACP,MAAC,cAAc,eAAE,WAAW,SAAmB,EAC9C,KAAK,IACD,CACR,CAAC,CAAC,CAAC,IAAI,EACP,OAAO,CAAC,CAAC,CAAC,eAAM,SAAS,EAAC,kBAAkB,YAAE,OAAO,GAAQ,CAAC,CAAC,CAAC,IAAI,IACnE,CACL,CAAC,CAAC,CAAC,IAAI,IACJ,EACL,MAAM,CAAC,CAAC,CAAC,CACR,cAAK,SAAS,EAAC,iBAAiB,iCAC7B,MAAM,GACH,CACP,CAAC,CAAC,CAAC,IAAI,IACJ,CACP,CAAC;AACJ,CAAC"}

package/dist/components/data-display/status-badge/index.d.ts

@@ -0,0 +1,2 @@
+export * from './status-badge.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/data-display/status-badge/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/data-display/status-badge/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/components/data-display/status-badge/index.js

@@ -0,0 +1,2 @@
+export * from './status-badge.js';
+//# sourceMappingURL=index.js.map

package/dist/components/data-display/status-badge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/data-display/status-badge/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/components/data-display/status-badge/status-badge.d.ts

@@ -0,0 +1,169 @@
+import { type HTMLAttributes, type ReactNode } from 'react';
+/** The semantic tones a status maps to. They are Monarch intent tokens, so every theme works. */
+export type StatusTone = 'neutral' | 'accent' | 'info' | 'success' | 'warning' | 'danger';
+export interface StatusDefinition {
+    /** Human label shown in the badge ("Partial outage"), never the raw enum. */
+    label: string;
+    tone: StatusTone;
+    /**
+     * Decorative icon. A distinct shape per status means colour is never the
+     * only signal. `null` for none.
+     */
+    icon?: ReactNode;
+    /**
+     * Custom colour as `#rrggbb` (for example a workspace-defined ticket
+     * status). Used for the dot, icon and border only; the text stays a theme
+     * token. Adjusted per theme until it reaches 3:1 against the surface
+     * (WCAG 1.4.11); see `checkStatusColor`.
+     */
+    color?: string;
+    /** One line explaining the status, for a tooltip or legend the product renders. */
+    description?: string;
+}
+export type StatusRegistry<K extends string = string> = Readonly<Record<K, StatusDefinition>>;
+/** The statuses Monarch ships. Service health first, then the generic set. */
+export declare const builtInStatuses: {
+    readonly operational: {
+        readonly label: "Operational";
+        readonly tone: "success";
+        readonly icon: import("react").JSX.Element;
+    };
+    readonly degraded: {
+        readonly label: "Degraded";
+        readonly tone: "warning";
+        readonly icon: import("react").JSX.Element;
+    };
+    readonly partial: {
+        readonly label: "Partial outage";
+        readonly tone: "warning";
+        readonly icon: import("react").JSX.Element;
+    };
+    readonly down: {
+        readonly label: "Down";
+        readonly tone: "danger";
+        readonly icon: import("react").JSX.Element;
+    };
+    readonly maintenance: {
+        readonly label: "Maintenance";
+        readonly tone: "info";
+        readonly icon: import("react").JSX.Element;
+    };
+    readonly unknown: {
+        readonly label: "Unknown";
+        readonly tone: "neutral";
+        readonly icon: import("react").JSX.Element;
+    };
+    readonly success: {
+        readonly label: "Success";
+        readonly tone: "success";
+        readonly icon: import("react").JSX.Element;
+    };
+    readonly warning: {
+        readonly label: "Warning";
+        readonly tone: "warning";
+        readonly icon: import("react").JSX.Element;
+    };
+    readonly danger: {
+        readonly label: "Error";
+        readonly tone: "danger";
+        readonly icon: import("react").JSX.Element;
+    };
+    readonly info: {
+        readonly label: "Info";
+        readonly tone: "info";
+        readonly icon: import("react").JSX.Element;
+    };
+    readonly neutral: {
+        readonly label: "Neutral";
+        readonly tone: "neutral";
+        readonly icon: import("react").JSX.Element;
+    };
+};
+export type BuiltInStatus = keyof typeof builtInStatuses;
+/** Result of the contrast guard for a custom colour. */
+export interface StatusColorCheck {
+    /** The colour as given. */
+    input: string;
+    /** Colour for light and more-contrast light themes. */
+    light: string;
+    /** Colour for dark and more-contrast dark themes. */
+    dark: string;
+    /** Text colour for a solid fill of `light` (4.5:1 or more). */
+    onLight: string;
+    /** Text colour for a solid fill of `dark` (4.5:1 or more). */
+    onDark: string;
+    /** True when the input had to be darkened or lightened for at least one theme. */
+    adjusted: boolean;
+    /** Contrast of the input against each theme's surface. */
+    ratios: {
+        light: number;
+        dark: number;
+        'hc-light': number;
+        'hc-dark': number;
+    };
+}
+/**
+ * The contrast guard. Measures `#rrggbb` against the surface of every Monarch
+ * theme and, where it is below the theme's non-text target (3:1, or more in
+ * the more-contrast themes), moves its lightness until it passes. Hue and
+ * saturation are kept, so a workspace's colour stays recognisable. Returns
+ * `null` for anything that is not `#rrggbb`.
+ */
+export declare function checkStatusColor(color: string): StatusColorCheck | null;
+/**
+ * Defines a product's own statuses, typed by key. Custom colours are checked
+ * up front: an invalid one throws here, in development, instead of rendering
+ * an unreadable badge.
+ *
+ *   const ticketStatuses = defineStatuses({
+ *     open: { label: 'Open', tone: 'info' },
+ *     waiting: { label: 'Waiting on customer', tone: 'warning', icon: <Clock /> },
+ *   });
+ */
+export declare function defineStatuses<K extends string>(definitions: Record<K, StatusDefinition>): StatusRegistry<K>;
+/** With `{ extend: true }` the result also contains the built-in statuses. */
+export declare function defineStatuses<K extends string>(definitions: Record<K, StatusDefinition>, options: {
+    extend: true;
+}): StatusRegistry<K | BuiltInStatus>;
+export interface StatusRegistryProviderProps {
+    /** Statuses added to (and overriding) the built-in set for everything inside. */
+    statuses: StatusRegistry;
+    children: ReactNode;
+}
+/** Makes a product's statuses available to every StatusBadge below it. Nested providers add up. */
+export declare function StatusRegistryProvider({ statuses, children }: StatusRegistryProviderProps): import("react").JSX.Element;
+/** "pending_delete" → "Pending delete". Used for statuses that are not in the registry. */
+export declare function formatStatusLabel(status: string): string;
+/**
+ * Looks up a status: the `statuses` argument first, then the nearest
+ * StatusRegistryProvider, then the built-in set. Unknown values resolve to
+ * the neutral "unknown" look with a readable label, never a raw enum.
+ */
+export declare function resolveStatus(status: string | null | undefined, ...registries: (StatusRegistry | null | undefined)[]): StatusDefinition & {
+    known: boolean;
+};
+export interface StatusBadgeProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'color'> {
+    /** The status key: a built-in one or one from `statuses` / a StatusRegistryProvider. */
+    status: BuiltInStatus | (string & {}) | null | undefined;
+    /** Statuses for this badge only, checked before the provider and the built-in set. */
+    statuses?: StatusRegistry;
+    /** Overrides the registry label, for example with a translated string. */
+    label?: ReactNode;
+    /**
+     * `subtle` (default) tinted pill; `outline` for dense tables; `solid` for a
+     * single prominent status; `dot` for a quiet coloured dot plus text.
+     */
+    variant?: 'subtle' | 'outline' | 'solid' | 'dot';
+    size?: 'sm' | 'md';
+    /** Replaces the registry icon. `false` hides it (the text still carries the meaning). */
+    icon?: ReactNode | false;
+    /** Overrides the registry colour (`#rrggbb`), passed through the contrast guard. */
+    color?: string;
+}
+/**
+ * A status shown as text plus a tone and a distinct icon or dot, so colour is
+ * never the only signal. Statuses come from a typed registry that products
+ * extend with `defineStatuses` and `StatusRegistryProvider`.
+ */
+export declare const StatusBadge: import("react").ForwardRefExoticComponent<StatusBadgeProps & import("react").RefAttributes<HTMLSpanElement>>;
+//# sourceMappingURL=status-badge.d.ts.map

package/dist/components/data-display/status-badge/status-badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-badge.d.ts","sourceRoot":"","sources":["../../../../src/components/data-display/status-badge/status-badge.tsx"],"names":[],"mappings":"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"}

package/dist/components/data-display/status-badge/status-badge.js

@@ -0,0 +1,139 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { createContext, forwardRef, useContext, useMemo, } from 'react';
+import { bestForeground, contrast, ensureContrast, fromHex, themes, toHex, } from '@rookcom/monarch-tokens';
+import { cx } from '../../../internal/cx.js';
+import { DotGlyph, ErrorGlyph, HelpGlyph, InfoGlyph, PartialGlyph, SuccessGlyph, WarningGlyph, WrenchGlyph, } from '../../../internal/icons.js';
+/** The statuses Monarch ships. Service health first, then the generic set. */
+export const builtInStatuses = {
+    operational: { label: 'Operational', tone: 'success', icon: _jsx(SuccessGlyph, {}) },
+    degraded: { label: 'Degraded', tone: 'warning', icon: _jsx(WarningGlyph, {}) },
+    partial: { label: 'Partial outage', tone: 'warning', icon: _jsx(PartialGlyph, {}) },
+    down: { label: 'Down', tone: 'danger', icon: _jsx(ErrorGlyph, {}) },
+    maintenance: { label: 'Maintenance', tone: 'info', icon: _jsx(WrenchGlyph, {}) },
+    unknown: { label: 'Unknown', tone: 'neutral', icon: _jsx(HelpGlyph, {}) },
+    success: { label: 'Success', tone: 'success', icon: _jsx(SuccessGlyph, {}) },
+    warning: { label: 'Warning', tone: 'warning', icon: _jsx(WarningGlyph, {}) },
+    danger: { label: 'Error', tone: 'danger', icon: _jsx(ErrorGlyph, {}) },
+    info: { label: 'Info', tone: 'info', icon: _jsx(InfoGlyph, {}) },
+    neutral: { label: 'Neutral', tone: 'neutral', icon: _jsx(DotGlyph, {}) },
+};
+const HEX = /^#[0-9a-f]{6}$/i;
+const TEXT_CANDIDATES = [
+    themes.light.neutrals['text-default'],
+    themes.light.neutrals['text-inverse'],
+];
+const BLACK_WHITE = [fromHex('#000000'), fromHex('#ffffff')];
+/** Dark or light text, whichever reads better on `hex`; always 4.5:1 or more. */
+function readableOn(hex) {
+    const bg = fromHex(hex);
+    const best = bestForeground(bg, TEXT_CANDIDATES);
+    return toHex(best.ratio >= 4.5 ? best.color : bestForeground(bg, BLACK_WHITE).color);
+}
+const guardCache = new Map();
+/**
+ * The contrast guard. Measures `#rrggbb` against the surface of every Monarch
+ * theme and, where it is below the theme's non-text target (3:1, or more in
+ * the more-contrast themes), moves its lightness until it passes. Hue and
+ * saturation are kept, so a workspace's colour stays recognisable. Returns
+ * `null` for anything that is not `#rrggbb`.
+ */
+export function checkStatusColor(color) {
+    const cached = guardCache.get(color);
+    if (cached !== undefined)
+        return cached;
+    let result = null;
+    if (HEX.test(color)) {
+        const c = fromHex(color);
+        const surface = (id) => themes[id].neutrals['bg-surface'];
+        const ratios = {
+            light: contrast(c, surface('light')),
+            dark: contrast(c, surface('dark')),
+            'hc-light': contrast(c, surface('hc-light')),
+            'hc-dark': contrast(c, surface('hc-dark')),
+        };
+        const fit = (ids, dir) => {
+            const target = Math.max(...ids.map((id) => themes[id].targets.ui));
+            const against = ids.map(surface);
+            if (against.every((bg) => contrast(c, bg) >= target))
+                return { hex: color.toLowerCase(), moved: false };
+            return { hex: toHex(ensureContrast(c, against, target, dir)), moved: true };
+        };
+        const light = fit(['light', 'hc-light'], 'darken');
+        const dark = fit(['dark', 'hc-dark'], 'lighten');
+        result = {
+            input: color,
+            light: light.hex,
+            dark: dark.hex,
+            onLight: readableOn(light.hex),
+            onDark: readableOn(dark.hex),
+            adjusted: light.moved || dark.moved,
+            ratios,
+        };
+    }
+    guardCache.set(color, result);
+    return result;
+}
+export function defineStatuses(definitions, options = {}) {
+    for (const [key, def] of Object.entries(definitions)) {
+        if (def.color !== undefined && checkStatusColor(def.color) === null) {
+            throw new Error(`defineStatuses: "${key}" has colour "${def.color}"; use #rrggbb.`);
+        }
+    }
+    return options.extend ? { ...builtInStatuses, ...definitions } : { ...definitions };
+}
+const StatusRegistryContext = createContext(null);
+/** Makes a product's statuses available to every StatusBadge below it. Nested providers add up. */
+export function StatusRegistryProvider({ statuses, children }) {
+    const parent = useContext(StatusRegistryContext);
+    const value = useMemo(() => ({ ...(parent ?? {}), ...statuses }), [parent, statuses]);
+    return _jsx(StatusRegistryContext.Provider, { value: value, children: children });
+}
+/** "pending_delete" → "Pending delete". Used for statuses that are not in the registry. */
+export function formatStatusLabel(status) {
+    const words = status.replace(/[_-]+/g, ' ').trim().toLowerCase();
+    return words ? words.charAt(0).toUpperCase() + words.slice(1) : 'Unknown';
+}
+/**
+ * Looks up a status: the `statuses` argument first, then the nearest
+ * StatusRegistryProvider, then the built-in set. Unknown values resolve to
+ * the neutral "unknown" look with a readable label, never a raw enum.
+ */
+export function resolveStatus(status, ...registries) {
+    const key = status ?? 'unknown';
+    for (const registry of [...registries, builtInStatuses]) {
+        const def = registry && Object.prototype.hasOwnProperty.call(registry, key) ? registry[key] : undefined;
+        if (def)
+            return { ...def, known: true };
+    }
+    return {
+        ...builtInStatuses.unknown,
+        label: status ? formatStatusLabel(status) : 'Unknown',
+        known: false,
+    };
+}
+/**
+ * A status shown as text plus a tone and a distinct icon or dot, so colour is
+ * never the only signal. Statuses come from a typed registry that products
+ * extend with `defineStatuses` and `StatusRegistryProvider`.
+ */
+export const StatusBadge = forwardRef(function StatusBadge({ status, statuses, label, variant = 'subtle', size = 'md', icon, color, className, style, children, ...rest }, ref) {
+    const provided = useContext(StatusRegistryContext);
+    const def = resolveStatus(status, statuses, provided);
+    const custom = checkStatusColor(color ?? def.color ?? '');
+    // The dot variant shows a dot instead of the icon, unless an icon is passed explicitly.
+    const explicitIcon = icon !== undefined && icon !== false;
+    const shownIcon = icon === false ? null : explicitIcon ? icon : variant === 'dot' ? null : def.icon;
+    // A custom colour must be visible somewhere: without an icon it gets a dot.
+    const showDot = !explicitIcon && (variant === 'dot' || (custom !== null && !shownIcon));
+    const customStyle = custom
+        ? {
+            '--mn-status-light': custom.light,
+            '--mn-status-dark': custom.dark,
+            '--mn-status-on-light': custom.onLight,
+            '--mn-status-on-dark': custom.onDark,
+        }
+        : undefined;
+    return (_jsxs("span", { ref: ref, ...rest, className: cx('mn-status-badge', className), style: customStyle ? { ...customStyle, ...style } : style, "data-status": status ?? 'unknown', "data-tone": def.tone, "data-variant": variant, "data-size": size, "data-custom-color": custom ? '' : undefined, "data-known": def.known ? undefined : 'false', children: [showDot ? _jsx("span", { className: "mn-status-badge__dot", "aria-hidden": true }) : null, shownIcon ? (_jsx("span", { className: "mn-status-badge__icon", "aria-hidden": true, children: shownIcon })) : null, _jsx("span", { className: "mn-status-badge__label", children: label ?? children ?? def.label })] }));
+});
+//# sourceMappingURL=status-badge.js.map

package/dist/components/data-display/status-badge/status-badge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-badge.js","sourceRoot":"","sources":["../../../../src/components/data-display/status-badge/status-badge.tsx"],"names":[],"mappings":"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"}