@vamos-ui/react 0.0.0-stage → 0.3.0

package/dist/format/core.js

@@ -0,0 +1,357 @@
+/**
+ * @vamos-ui/react/format — React-free formatting core. Works in server components, route
+ * handlers and the browser. Every formatter goes through cached `Intl.*` instances.
+ *
+ * Value rules (X11): a date-only value is a `"YYYY-MM-DD"` string (formatted as a calendar
+ * date, never shifted by a time zone); money is a decimal string (`"1250.50"`) or a number;
+ * the time zone is always explicit (default `"UTC"`, so server and client agree).
+ */
+const cache = new Map();
+function cached(kind, locale, options, make) {
+    const key = `${kind}|${locale}|${options ? JSON.stringify(options) : ""}`;
+    let v = cache.get(key);
+    if (!v)
+        cache.set(key, (v = make()));
+    return v;
+}
+export const numberFormat = (locale, o) => cached("n", locale, o, () => new Intl.NumberFormat(locale, o));
+export const dateTimeFormat = (locale, o) => cached("d", locale, o, () => new Intl.DateTimeFormat(locale, o));
+const relativeFormat = (locale, o) => cached("r", locale, o, () => new Intl.RelativeTimeFormat(locale, o));
+const listFormat = (locale, o) => cached("l", locale, o, () => new Intl.ListFormat(locale, o));
+const DATE_ONLY = /^(\d{4})-(\d{2})-(\d{2})$/;
+const TIME_ONLY = /^(\d{1,2}):(\d{2})(?::(\d{2}))?$/;
+/** `true` for `"YYYY-MM-DD"` strings. */
+export const isDateOnly = (v) => typeof v === "string" && DATE_ONLY.test(v);
+/** Date-only string → a `Date` at UTC midnight (format it with `timeZone: "UTC"`). */
+function dateOnlyToUTC(s) {
+    const [, y, m, d] = DATE_ONLY.exec(s);
+    return new Date(Date.UTC(Number(y), Number(m) - 1, Number(d)));
+}
+/** Normalises a date input. Returns the Date and whether it is a calendar date (no time zone). */
+function toDate(v) {
+    if (v instanceof Date)
+        return { date: v, calendar: false };
+    if (typeof v === "number")
+        return { date: new Date(v), calendar: false };
+    if (DATE_ONLY.test(v))
+        return { date: dateOnlyToUTC(v), calendar: true };
+    const t = TIME_ONLY.exec(v);
+    if (t)
+        return { date: new Date(Date.UTC(1970, 0, 1, Number(t[1]), Number(t[2]), Number(t[3] ?? 0))), calendar: true };
+    return { date: new Date(v), calendar: false };
+}
+const PRESETS = {
+    short: { dateStyle: "short" },
+    medium: { dateStyle: "medium" },
+    long: { dateStyle: "long" },
+    full: { dateStyle: "full" },
+    datetime: { dateStyle: "medium", timeStyle: "short" },
+    "datetime-short": { dateStyle: "short", timeStyle: "short" },
+    "datetime-seconds": { dateStyle: "medium", timeStyle: "medium" },
+    "month-year": { month: "long", year: "numeric" },
+    weekday: { weekday: "long" },
+};
+/** Fraction digits a currency uses (USD/TRY 2, JPY 0, KWD 3). */
+export function currencyDigits(currency) {
+    return numberFormat("en", { style: "currency", currency }).resolvedOptions().maximumFractionDigits ?? 2;
+}
+const RELATIVE_STEPS = [
+    ["second", 60],
+    ["minute", 60],
+    ["hour", 24],
+    ["day", 7],
+    ["week", 4.34524],
+    ["month", 12],
+    ["year", Infinity],
+];
+/**
+ * Creates a formatter bound to a locale, a default currency and a time zone.
+ *
+ * ```ts
+ * const f = createFormatter("tr-TR", { currency: "TRY", timeZone: "Europe/Istanbul" });
+ * f.currency("1250.50"); // "₺1.250,50"
+ * f.date("2026-11-08");  // "8 Kas 2026"
+ * ```
+ */
+export function createFormatter(locale = "en-US", options = {}) {
+    const currencyCode = options.currency ?? "USD";
+    const timeZone = options.timeZone ?? "UTC";
+    const lang = locale.split(/[-_]/)[0].toLowerCase();
+    const dateOptions = (o, fallback) => typeof o === "string" ? PRESETS[o] : (o ?? PRESETS[fallback]);
+    const formatDate = (value, o) => {
+        const { date, calendar } = toDate(value);
+        if (Number.isNaN(date.getTime()))
+            return "";
+        return dateTimeFormat(locale, { timeZone: calendar ? "UTC" : timeZone, ...o }).format(date);
+    };
+    const f = {
+        locale,
+        currencyCode,
+        timeZone,
+        number: (value, o) => numberFormat(locale, o).format(value),
+        currency(value, cur, o) {
+            const opts = typeof cur === "string" ? { ...o, currency: cur } : { ...cur, ...o };
+            const { display, currency = currencyCode, ...rest } = opts;
+            return numberFormat(locale, { style: "currency", currency, currencyDisplay: display, ...rest }).format(value);
+        },
+        percent: (value, o) => numberFormat(locale, { style: "percent", maximumFractionDigits: 1, ...o }).format(value),
+        compact: (value, o) => numberFormat(locale, { notation: "compact", maximumFractionDigits: 1, ...o }).format(value),
+        bytes(value, o = {}) {
+            const base = o.binary ? 1024 : 1000;
+            const units = ["byte", "kilobyte", "megabyte", "gigabyte", "terabyte", "petabyte"];
+            let i = 0;
+            let n = Math.abs(value);
+            while (n >= base && i < units.length - 1) {
+                n /= base;
+                i++;
+            }
+            return numberFormat(locale, {
+                style: "unit",
+                unit: units[i],
+                unitDisplay: o.unitDisplay ?? "short",
+                maximumFractionDigits: i === 0 ? 0 : (o.maximumFractionDigits ?? 1),
+            }).format(Math.sign(value) * n || 0);
+        },
+        duration(value, o = {}) {
+            const toSeconds = { ms: 0.001, s: 1, min: 60, h: 3600 }[o.unit ?? "s"];
+            let rest = Math.round(Math.abs(value) * toSeconds);
+            const style = o.style ?? (lang === "en" ? "narrow" : "short");
+            const maxParts = o.maxParts ?? 2;
+            const order = [
+                ["day", 86400, "d"],
+                ["hour", 3600, "h"],
+                ["minute", 60, "min"],
+                ["second", 1, "s"],
+            ];
+            const smallestIdx = order.findIndex((u) => u[2] === (o.smallest ?? "s"));
+            const parts = [];
+            order.forEach(([unit, size], idx) => {
+                if (idx > smallestIdx || parts.length >= maxParts)
+                    return;
+                const n = idx === smallestIdx ? Math.round(rest / size) : Math.floor(rest / size);
+                rest -= n * size;
+                if (n > 0 || (idx === smallestIdx && parts.length === 0))
+                    parts.push(numberFormat(locale, { style: "unit", unit, unitDisplay: style }).format(n));
+            });
+            const text = parts.join(" ");
+            return value < 0 ? `-${text}` : text;
+        },
+        date: (value, o) => formatDate(value, dateOptions(o, "medium")),
+        dateTime: (value, o) => formatDate(value, o ?? PRESETS.datetime),
+        dateRange(start, end, o) {
+            const a = toDate(start);
+            const b = toDate(end);
+            if (Number.isNaN(a.date.getTime()) || Number.isNaN(b.date.getTime()))
+                return "";
+            const calendar = a.calendar && b.calendar;
+            const fmt = dateTimeFormat(locale, { timeZone: calendar ? "UTC" : timeZone, ...dateOptions(o, "medium") });
+            // ICU versions disagree on the spaces around the dash (Node: thin U+2009, Chrome: plain),
+            // which made every server-rendered range a hydration mismatch. Plain spaces everywhere.
+            return fmt.formatRange(a.date, b.date).replace(/[\u2009\u202f]/g, " ");
+        },
+        time: (value, o) => formatDate(value, o ?? { timeStyle: "short" }),
+        relative(value, unitOrOptions, maybe) {
+            if (typeof value === "number" && typeof unitOrOptions === "string") {
+                return relativeFormat(locale, { numeric: maybe?.numeric ?? "auto", style: maybe?.style }).format(value, unitOrOptions);
+            }
+            const o = unitOrOptions ?? {};
+            const target = toDate(value).date.getTime();
+            const now = o.now === undefined ? Date.now() : toDate(o.now).date.getTime();
+            if (Number.isNaN(target))
+                return "";
+            let delta = (target - now) / 1000;
+            const rtf = relativeFormat(locale, { numeric: o.numeric ?? "auto", style: o.style });
+            for (const [unit, step] of RELATIVE_STEPS) {
+                if (Math.abs(delta) < step)
+                    return rtf.format(Math.round(delta), unit);
+                delta /= step;
+            }
+            return rtf.format(Math.round(delta), "year");
+        },
+        list: (items, o) => listFormat(locale, { type: "conjunction", ...o }).format(items),
+        count: (value, max = 99) => (value > max ? `${numberFormat(locale).format(max)}+` : numberFormat(locale).format(value)),
+    };
+    return f;
+}
+/* ------------------------------------------------------------------ */
+/* Parsing                                                             */
+/* ------------------------------------------------------------------ */
+/** Decimal and group separators of a locale: en-US `{ decimal: ".", group: "," }`, tr-TR `{ decimal: ",", group: "." }`. */
+export function numberSeparators(locale = "en-US") {
+    const parts = numberFormat(locale).formatToParts(11111.1);
+    return {
+        decimal: parts.find((p) => p.type === "decimal")?.value ?? ".",
+        group: parts.find((p) => p.type === "group")?.value ?? ",",
+    };
+}
+const NATIVE_DIGITS = [
+    [0x0660, 0x0669], // Arabic-Indic
+    [0x06f0, 0x06f9], // Extended Arabic-Indic (Persian)
+    [0x0966, 0x096f], // Devanagari
+];
+function latinDigits(s) {
+    return s.replace(/[\u0660-\u0669\u06f0-\u06f9\u0966-\u096f]/g, (ch) => {
+        const c = ch.charCodeAt(0);
+        const range = NATIVE_DIGITS.find(([a, b]) => c >= a && c <= b);
+        return String(c - range[0]);
+    });
+}
+/**
+ * Parses user input into a normalised decimal string (`"-1250.5"`), or `null` when it isn't a number.
+ * Strict about the locale's separators, lenient about what people actually type:
+ *
+ * ```ts
+ * parseDecimal("1.250,50", "tr-TR"); // "1250.50"
+ * parseDecimal("₺1.250", "tr-TR");   // "1250"
+ * parseDecimal("12,5", "tr-TR");     // "12.5"
+ * parseDecimal("1250.75", "tr-TR");  // "1250.75" (single non-locale separator not followed by 3 digits → decimal)
+ * parseDecimal("(42.00)", "en-US");  // "-42.00" (accounting negative)
+ * ```
+ */
+export function parseDecimal(input, locale = "en-US") {
+    const { decimal, group } = numberSeparators(locale);
+    let s = latinDigits(String(input)).trim();
+    if (!s)
+        return null;
+    let negative = false;
+    if (/^\(.*\)$/.test(s)) {
+        negative = true;
+        s = s.slice(1, -1);
+    }
+    s = s.replace(/[\s\u00a0\u202f']/g, "");
+    // Drop currency symbols / codes / percent signs around the number (keep the sign).
+    s = s.replace(/^[^\d.,\-\u2212]+|[^\d.,\-\u2212]+$/g, "");
+    if (/^[-\u2212]|[-\u2212]$/.test(s)) {
+        negative = true;
+        s = s.replace(/^[-\u2212]|[-\u2212]$/g, "").replace(/^[^\d.,]+|[^\d.,]+$/g, "");
+    }
+    if (!s || /[^\d.,]/.test(s))
+        return null;
+    let int;
+    let frac = "";
+    const groupChar = group === "\u00a0" || group === "\u202f" || group === "’" ? "" : group;
+    if (s.includes(decimal)) {
+        const pieces = s.split(decimal);
+        if (pieces.length !== 2)
+            return null;
+        int = groupChar ? pieces[0].split(groupChar).join("") : pieces[0];
+        frac = pieces[1];
+        if (/[.,]/.test(int) || /[.,]/.test(frac))
+            return null;
+    }
+    else {
+        const other = decimal === "." ? "," : ".";
+        const sep = groupChar && s.includes(groupChar) ? groupChar : s.includes(other) ? other : "";
+        if (!sep)
+            int = s;
+        else {
+            const pieces = s.split(sep);
+            const grouped = pieces.length > 1 && pieces.slice(1).every((p) => p.length === 3) && pieces[0].length > 0 && pieces[0].length <= 3;
+            if (grouped)
+                int = pieces.join("");
+            else if (pieces.length === 2) {
+                int = pieces[0];
+                frac = pieces[1];
+            }
+            else
+                return null;
+        }
+    }
+    if (!/^\d*$/.test(int) || !/^\d*$/.test(frac) || (!int && !frac))
+        return null;
+    int = int.replace(/^0+(?=\d)/, "") || "0";
+    const out = frac ? `${int}.${frac}` : int;
+    return negative && /[1-9]/.test(out) ? `-${out}` : out;
+}
+/**
+ * `parseNumber(locale)` returns a parser: `parseNumber("tr-TR")("1.250,5")` → `1250.5`.
+ * Prefer `parseDecimal` for money (no float).
+ */
+export function parseNumber(locale = "en-US") {
+    return (input) => {
+        const d = parseDecimal(input, locale);
+        return d === null ? null : Number(d);
+    };
+}
+/* ------------------------------------------------------------------ */
+/* Decimal strings (money) — exact arithmetic via bigint minor units   */
+/* ------------------------------------------------------------------ */
+const DECIMAL = /^-?\d+(\.\d+)?$/;
+/** `true` for canonical decimal strings: `"12"`, `"-0.5"`, `"1250.50"`. */
+export const isDecimalString = (v) => typeof v === "string" && DECIMAL.test(v);
+/** Decimal string → integer minor units at `scale` (`"12.345"`, 2 → `1235n` with half-up). */
+export function toMinorUnits(value, scale = 2, rounding = "half-up") {
+    const s = typeof value === "number" ? value.toFixed(Math.min(20, scale + 2)) : value.trim();
+    if (!DECIMAL.test(s))
+        throw new RangeError(`Not a decimal string: "${value}"`);
+    const neg = s.startsWith("-");
+    const [i, f = ""] = (neg ? s.slice(1) : s).split(".");
+    const kept = BigInt((i ?? "0") + f.slice(0, scale).padEnd(scale, "0"));
+    const dropped = f.slice(scale);
+    let n = kept;
+    if (dropped && /[1-9]/.test(dropped)) {
+        const first = Number(dropped[0]);
+        const exactHalf = first === 5 && !/[1-9]/.test(dropped.slice(1));
+        const roundAway = rounding === "up" ||
+            (rounding === "half-up" && first >= 5) ||
+            (rounding === "half-even" && (first > 5 || (exactHalf ? kept % 2n === 1n : first >= 5)));
+        if (roundAway)
+            n += 1n;
+    }
+    return neg ? -n : n;
+}
+/** Integer minor units → decimal string with exactly `scale` digits (`1235n`, 2 → `"12.35"`). */
+export function fromMinorUnits(minor, scale = 2) {
+    const neg = minor < 0n;
+    const digits = (neg ? -minor : minor).toString().padStart(scale + 1, "0");
+    const out = scale ? `${digits.slice(0, -scale)}.${digits.slice(-scale)}` : digits;
+    return neg ? `-${out}` : out;
+}
+/** Round a decimal string to `scale` digits: `roundDecimal("2.345", 2)` → `"2.35"`. */
+export const roundDecimal = (value, scale = 2, rounding = "half-up") => fromMinorUnits(toMinorUnits(value, scale, rounding), scale);
+/** Exact sum of decimal strings at `scale` digits. */
+export const addDecimal = (values, scale = 2) => fromMinorUnits(values.reduce((acc, v) => acc + toMinorUnits(v, scale), 0n), scale);
+/** `a - b` at `scale` digits. */
+export const subtractDecimal = (a, b, scale = 2) => fromMinorUnits(toMinorUnits(a, scale) - toMinorUnits(b, scale), scale);
+/**
+ * `value × factor`, rounded to `scale` (quantity × unit price, VAT rate…). `factor` may be a decimal string.
+ *
+ * ```ts
+ * multiplyDecimal("19.99", "3");    // "59.97"
+ * multiplyDecimal("1250.00", "0.20"); // "250.00"
+ * ```
+ */
+export function multiplyDecimal(value, factor, scale = 2, rounding = "half-up") {
+    const f = typeof factor === "number" ? String(factor) : factor;
+    const fScale = (f.split(".")[1] ?? "").length;
+    const vScale = (value.split(".")[1] ?? "").length;
+    const product = toMinorUnits(value, vScale) * toMinorUnits(f, fScale);
+    return roundDecimal(fromMinorUnits(product, vScale + fScale), scale, rounding);
+}
+/** -1, 0 or 1. */
+export function compareDecimal(a, b) {
+    const scale = Math.max((a.split(".")[1] ?? "").length, (b.split(".")[1] ?? "").length);
+    const d = toMinorUnits(a, scale) - toMinorUnits(b, scale);
+    return d === 0n ? 0 : d < 0n ? -1 : 1;
+}
+/* ------------------------------------------------------------------ */
+/* Misc                                                                */
+/* ------------------------------------------------------------------ */
+/** Estimated reading time in whole minutes (min 1) for text or a word count. Default 220 wpm. */
+export function readingMinutes(textOrWords, wordsPerMinute = 220) {
+    const n = typeof textOrWords === "number" ? textOrWords : (textOrWords.trim().match(/\S+/g)?.length ?? 0);
+    return Math.max(1, Math.round(n / wordsPerMinute));
+}
+/** Local calendar date → `"YYYY-MM-DD"` (never `toISOString()`, which shifts the day at UTC+3). */
+export function toISODate(d) {
+    const p = (n) => String(n).padStart(2, "0");
+    return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())}`;
+}
+/** `"YYYY-MM-DD"` → a local-midnight `Date` (for date pickers). Returns `null` for invalid input. */
+export function fromISODate(s) {
+    const m = DATE_ONLY.exec(s);
+    if (!m)
+        return null;
+    const d = new Date(Number(m[1]), Number(m[2]) - 1, Number(m[3]));
+    return d.getMonth() === Number(m[2]) - 1 ? d : null;
+}

package/dist/format/index.d.ts

@@ -0,0 +1,4 @@
+export { createFormatter, numberFormat, dateTimeFormat, currencyDigits, isDateOnly, numberSeparators, parseDecimal, parseNumber, isDecimalString, toMinorUnits, fromMinorUnits, roundDecimal, addDecimal, subtractDecimal, multiplyDecimal, compareDecimal, readingMinutes, toISODate, fromISODate, type Formatter, type FormatterOptions, type DateInput, type NumericInput, type DatePreset, type DurationStyle, type DurationOptions, type BytesOptions, type CurrencyOptions, type RelativeOptions, type RoundingMode, } from "./core.js";
+export { formatMessage } from "../lib/message-format.js";
+export { slugify, type SlugifyOptions } from "../lib/text.js";
+export { useFormat } from "./use-format.js";

package/dist/format/index.js

@@ -0,0 +1,5 @@
+// Public API of @vamos-ui/react/format — React-free core (works in RSC) + the client `useFormat` hook.
+export { createFormatter, numberFormat, dateTimeFormat, currencyDigits, isDateOnly, numberSeparators, parseDecimal, parseNumber, isDecimalString, toMinorUnits, fromMinorUnits, roundDecimal, addDecimal, subtractDecimal, multiplyDecimal, compareDecimal, readingMinutes, toISODate, fromISODate, } from "./core.js";
+export { formatMessage } from "../lib/message-format.js";
+export { slugify } from "../lib/text.js";
+export { useFormat } from "./use-format.js";

package/dist/format/use-format.d.ts

@@ -0,0 +1 @@
+export { useFormat, useLocale } from "../lib/locale.js";

package/dist/format/use-format.js

@@ -0,0 +1,3 @@
+"use client";
+// Client hook on top of the React-free core: reads locale, currency and time zone from LocaleProvider.
+export { useFormat, useLocale } from "../lib/locale.js";

package/dist/index.d.ts

@@ -0,0 +1,91 @@
+export * from "./lib/public.js";
+export * from "./components/accordion.js";
+export * from "./components/activity-timeline.js";
+export * from "./components/address-field.js";
+export * from "./components/alert-dialog.js";
+export * from "./components/alert.js";
+export * from "./components/app-shell.js";
+export * from "./components/attachment-list.js";
+export * from "./components/audit-log.js";
+export * from "./components/avatar.js";
+export * from "./components/backup-codes.js";
+export * from "./components/badge.js";
+export * from "./components/breadcrumb.js";
+export * from "./components/button-group.js";
+export * from "./components/button.js";
+export * from "./components/calendar.js";
+export * from "./components/card.js";
+export * from "./components/carousel.js";
+export * from "./components/checkbox.js";
+export * from "./components/color-picker.js";
+export * from "./components/combobox.js";
+export * from "./components/command.js";
+export * from "./components/comment-thread.js";
+export * from "./components/context-menu.js";
+export * from "./components/currency-input.js";
+export * from "./components/date-picker.js";
+export * from "./components/date-range-picker.js";
+export * from "./components/description-list.js";
+export * from "./components/dialog.js";
+export * from "./components/dropdown-menu.js";
+export * from "./components/editor-layout.js";
+export * from "./components/empty-state.js";
+export * from "./components/entity-card.js";
+export * from "./components/file-upload.js";
+export * from "./components/formatted-input.js";
+export * from "./components/hierarchy-chart.js";
+export * from "./components/hover-card.js";
+export * from "./components/iban-input.js";
+export * from "./components/id-input.js";
+export * from "./components/image.js";
+export * from "./components/input-otp.js";
+export * from "./components/input.js";
+export * from "./components/item.js";
+export * from "./components/kbd.js";
+export * from "./components/list-layout.js";
+export * from "./components/native-select.js";
+export * from "./components/navigation-menu.js";
+export * from "./components/notification-center.js";
+export * from "./components/page-header.js";
+export * from "./components/pagination.js";
+export * from "./components/phone-input.js";
+export * from "./components/pin-map.js";
+export * from "./components/popover.js";
+export * from "./components/progress.js";
+export * from "./components/qr-code.js";
+export * from "./components/radio-group.js";
+export * from "./components/record-detail-layout.js";
+export * from "./components/record-picker.js";
+export * from "./components/resizable.js";
+export * from "./components/scroll-area.js";
+export * from "./components/select.js";
+export * from "./components/separator.js";
+export * from "./components/settings-layout.js";
+export * from "./components/sheet.js";
+export * from "./components/sidebar.js";
+export * from "./components/signature-pad.js";
+export * from "./components/skeleton.js";
+export * from "./components/sla-timer.js";
+export * from "./components/slider.js";
+export * from "./components/slug-input.js";
+export * from "./components/sparkline.js";
+export * from "./components/spinner.js";
+export * from "./components/stat.js";
+export * from "./components/status-picker.js";
+export * from "./components/stepper.js";
+export * from "./components/switch.js";
+export * from "./components/table.js";
+export * from "./components/tabs.js";
+export * from "./components/tag-input.js";
+export * from "./components/task-list.js";
+export * from "./components/time-picker.js";
+export * from "./components/toast.js";
+export * from "./components/toggle.js";
+export * from "./components/tooltip.js";
+export * from "./components/top-bar.js";
+export * from "./components/tour.js";
+export * from "./components/tree-select.js";
+export * from "./components/tree-view.js";
+export * from "./components/typography.js";
+export * from "./components/user-picker.js";
+export * from "./components/version-history.js";

package/dist/index.js

@@ -0,0 +1,92 @@
+// AUTO-GENERATED by scripts/gen.mjs — do not edit by hand.
+export * from "./lib/public.js";
+export * from "./components/accordion.js";
+export * from "./components/activity-timeline.js";
+export * from "./components/address-field.js";
+export * from "./components/alert-dialog.js";
+export * from "./components/alert.js";
+export * from "./components/app-shell.js";
+export * from "./components/attachment-list.js";
+export * from "./components/audit-log.js";
+export * from "./components/avatar.js";
+export * from "./components/backup-codes.js";
+export * from "./components/badge.js";
+export * from "./components/breadcrumb.js";
+export * from "./components/button-group.js";
+export * from "./components/button.js";
+export * from "./components/calendar.js";
+export * from "./components/card.js";
+export * from "./components/carousel.js";
+export * from "./components/checkbox.js";
+export * from "./components/color-picker.js";
+export * from "./components/combobox.js";
+export * from "./components/command.js";
+export * from "./components/comment-thread.js";
+export * from "./components/context-menu.js";
+export * from "./components/currency-input.js";
+export * from "./components/date-picker.js";
+export * from "./components/date-range-picker.js";
+export * from "./components/description-list.js";
+export * from "./components/dialog.js";
+export * from "./components/dropdown-menu.js";
+export * from "./components/editor-layout.js";
+export * from "./components/empty-state.js";
+export * from "./components/entity-card.js";
+export * from "./components/file-upload.js";
+export * from "./components/formatted-input.js";
+export * from "./components/hierarchy-chart.js";
+export * from "./components/hover-card.js";
+export * from "./components/iban-input.js";
+export * from "./components/id-input.js";
+export * from "./components/image.js";
+export * from "./components/input-otp.js";
+export * from "./components/input.js";
+export * from "./components/item.js";
+export * from "./components/kbd.js";
+export * from "./components/list-layout.js";
+export * from "./components/native-select.js";
+export * from "./components/navigation-menu.js";
+export * from "./components/notification-center.js";
+export * from "./components/page-header.js";
+export * from "./components/pagination.js";
+export * from "./components/phone-input.js";
+export * from "./components/pin-map.js";
+export * from "./components/popover.js";
+export * from "./components/progress.js";
+export * from "./components/qr-code.js";
+export * from "./components/radio-group.js";
+export * from "./components/record-detail-layout.js";
+export * from "./components/record-picker.js";
+export * from "./components/resizable.js";
+export * from "./components/scroll-area.js";
+export * from "./components/select.js";
+export * from "./components/separator.js";
+export * from "./components/settings-layout.js";
+export * from "./components/sheet.js";
+export * from "./components/sidebar.js";
+export * from "./components/signature-pad.js";
+export * from "./components/skeleton.js";
+export * from "./components/sla-timer.js";
+export * from "./components/slider.js";
+export * from "./components/slug-input.js";
+export * from "./components/sparkline.js";
+export * from "./components/spinner.js";
+export * from "./components/stat.js";
+export * from "./components/status-picker.js";
+export * from "./components/stepper.js";
+export * from "./components/switch.js";
+export * from "./components/table.js";
+export * from "./components/tabs.js";
+export * from "./components/tag-input.js";
+export * from "./components/task-list.js";
+export * from "./components/time-picker.js";
+export * from "./components/toast.js";
+export * from "./components/toggle.js";
+export * from "./components/tooltip.js";
+export * from "./components/top-bar.js";
+export * from "./components/tour.js";
+export * from "./components/tree-select.js";
+export * from "./components/tree-view.js";
+export * from "./components/typography.js";
+export * from "./components/user-picker.js";
+export * from "./components/version-history.js";

package/dist/lib/cn.d.ts

@@ -0,0 +1,3 @@
+import { type ClassValue } from "clsx";
+/** Merge class names; on Tailwind conflicts the last one wins. */
+export declare function cn(...inputs: ClassValue[]): string;

package/dist/lib/cn.js

@@ -0,0 +1,16 @@
+import { clsx } from "clsx";
+import { extendTailwindMerge } from "tailwind-merge";
+const twMerge = extendTailwindMerge({
+    extend: {
+        classGroups: {
+            // Theme type scale (styles.css @theme --text-*): without these, `text-display-m text-fg`
+            // reads as two colours and the size is dropped.
+            "font-size": [{ text: ["2xs", "display-2xl", "display-xl", "display-l", "display-m", "h3", "lead", "body", "small", "eyebrow"] }],
+            rounded: [{ rounded: ["ui", "ui-sm", "ui-lg"] }],
+        },
+    },
+});
+/** Merge class names; on Tailwind conflicts the last one wins. */
+export function cn(...inputs) {
+    return twMerge(clsx(inputs));
+}

package/dist/lib/color.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Colour helpers for Color picker (and anything that shows user-defined colours):
+ * parse hex / rgb() / oklch() strings, convert hex ↔ OKLCH, and compute WCAG contrast.
+ * React-free (works in server components).
+ *
+ * Values in the kit's public APIs are always hex: `"#rrggbb"` or `"#rrggbbaa"`.
+ */
+/** Red, green, blue in 0–255, alpha in 0–1. */
+export interface RGBA {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+/** OKLCH: lightness 0–1, chroma ≥ 0 (≈ 0–0.4 in sRGB), hue in degrees, alpha 0–1. */
+export interface OKLCH {
+    l: number;
+    c: number;
+    h: number;
+    a: number;
+}
+export type ColorFormat = "hex" | "rgb" | "oklch";
+/** Parses `#rgb`, `#rgba`, `#rrggbb`, `#rrggbbaa` (the `#` is optional). */
+export declare function hexToRgba(input: string): RGBA | null;
+/** `"#rrggbb"`, or `"#rrggbbaa"` when `withAlpha` (default: only when alpha < 1). Lowercase. */
+export declare function rgbaToHex(c: RGBA, withAlpha?: boolean): string;
+/**
+ * Parses any colour string the picker accepts: hex (with or without `#`), `rgb()`/`rgba()`
+ * (comma or space syntax) and `oklch()`. Returns `null` for anything else.
+ *
+ * ```ts
+ * parseColor("c6f432");                   // { r: 198, g: 244, b: 50, a: 1 }
+ * parseColor("oklch(89% 0.21 122 / 50%)"); // …a: 0.5
+ * ```
+ */
+export declare function parseColor(input: string): RGBA | null;
+/** Normalises any accepted colour string to lowercase hex, or `null` if it can't be parsed. */
+export declare function toHex(input: string, withAlpha?: boolean): string | null;
+/** sRGB → OKLCH. */
+export declare function rgbaToOklch({ r, g, b, a }: RGBA): OKLCH;
+/** OKLCH → sRGB, clipped to the sRGB gamut. */
+export declare function oklchToRgba({ l, c, h, a }: OKLCH): RGBA;
+/**
+ * Formats a hex value for display / editing.
+ *
+ * ```ts
+ * formatColor("#c6f432", "rgb");   // "rgb(198 244 50)"
+ * formatColor("#c6f432", "oklch"); // "oklch(91.5% 0.205 125.3)"
+ * ```
+ */
+export declare function formatColor(hex: string, format?: ColorFormat): string;
+/** WCAG 2 relative luminance (0 = black, 1 = white). Alpha is ignored. */
+export declare function relativeLuminance({ r, g, b }: RGBA): number;
+/** Composites a translucent colour over an opaque background. */
+export declare function blend(fg: RGBA, bg: RGBA): RGBA;
+/**
+ * WCAG 2 contrast ratio between two colours (1–21), or `null` if either can't be parsed.
+ * A translucent colour is composited over the other one first.
+ */
+export declare function contrastRatio(a: string, b: string): number | null;
+/** WCAG 2 rating for a contrast ratio: AAA ≥ 7, AA ≥ 4.5, AA large text ≥ 3. */
+export declare function contrastLevel(ratio: number): "AAA" | "AA" | "AA-large" | "fail";
+/** Black or white — whichever reads better on `background`. */
+export declare function readableOn(background: string): "#000000" | "#ffffff";