@vaam-apps/ui 0.1.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,8EAA8E;AAC9E,yEAAyE;AACzE,4CAA4C;AAC5C,8EAA8E;AAC9E,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qCAAqC,CAAC;AACpD,8EAA8E;AAC9E,uEAAuE;AACvE,gEAAgE;AAChE,8EAA8E;AAC9E,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yCAAyC,CAAC;AACxD,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,sCAAsC,CAAC;AACrD,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAC9E,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,qCAAqC,CAAC;AACpD,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC;AACvD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oCAAoC,CAAC;AACnD,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,8EAA8E;AAC9E,gEAAgE;AAChE,0EAA0E;AAC1E,YAAY;AACZ,8EAA8E;AAC9E,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAElD,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAC9E,OAAO,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/lib/cn.d.ts

@@ -0,0 +1,11 @@
+import { type ClassValue } from "clsx";
+/**
+ * Merge class names, resolving conflicting utilities so the *last* one
+ * wins — Tailwind's own, this design system's custom scales, and daisyUI's
+ * component modifiers alike.
+ */
+export declare function cn(...inputs: ClassValue[]): string;
+/** The font-size steps this package registers with `tailwind-merge`. Exported
+ * for `theme-tokens.test.ts`, which checks them against `theme.css`. */
+export declare const REGISTERED_FONT_SIZES: readonly string[];
+//# sourceMappingURL=cn.d.ts.map

package/dist/lib/cn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.d.ts","sourceRoot":"","sources":["../../src/lib/cn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,MAAM,CAAC;AA4J7C;;;;GAIG;AACH,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAElD;AAED;wEACwE;AACxE,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAAe,CAAC"}

package/dist/lib/cn.js

@@ -0,0 +1,78 @@
+import { clsx } from "clsx";
+import { extendTailwindMerge } from "tailwind-merge";
+/**
+ * The `--text-*` steps declared in `styles/theme.css`. Kept in sync with
+ * that file by `theme-tokens.test.ts`, which parses the stylesheet rather
+ * than trusting this list.
+ */
+const FONT_SIZES = [
+    "micro",
+    "caption",
+    "body",
+    "prose",
+    "title-sm",
+    "title",
+    "metric",
+    "metric-lg",
+];
+/** daisyUI's radius tiers, which its own components read from. */
+const RADII = ["selector", "field", "box"];
+const DAISY_COLOURS = [
+    "primary",
+    "secondary",
+    "accent",
+    "neutral",
+    "info",
+    "success",
+    "warning",
+    "error",
+];
+const DAISY_SIZES = ["xs", "sm", "md", "lg", "xl"];
+const twMerge = extendTailwindMerge({
+    extend: {
+        theme: {
+            // Registering these as *font sizes* is what stops `text-caption`
+            // being mistaken for a colour and dropped. See point 1 above.
+            text: [...FONT_SIZES],
+            radius: [...RADII],
+        },
+        classGroups: {
+            "daisy-btn-variant": [{ btn: [...DAISY_COLOURS, "ghost", "link"] }],
+            "daisy-btn-style": [{ btn: ["outline", "soft", "dash"] }],
+            "daisy-btn-size": [{ btn: [...DAISY_SIZES, "wide", "block", "square", "circle"] }],
+            "daisy-badge-variant": [{ badge: [...DAISY_COLOURS, "ghost"] }],
+            "daisy-badge-style": [{ badge: ["outline", "soft", "dash"] }],
+            "daisy-badge-size": [{ badge: [...DAISY_SIZES] }],
+            "daisy-alert-variant": [{ alert: ["info", "success", "warning", "error"] }],
+            "daisy-alert-style": [{ alert: ["outline", "soft", "dash"] }],
+            "daisy-input-variant": [{ input: [...DAISY_COLOURS, "ghost"] }],
+            "daisy-select-variant": [{ select: [...DAISY_COLOURS, "ghost"] }],
+            "daisy-select-size": [{ select: [...DAISY_SIZES] }],
+            "daisy-checkbox-variant": [{ checkbox: [...DAISY_COLOURS] }],
+            "daisy-checkbox-size": [{ checkbox: [...DAISY_SIZES] }],
+            "daisy-radio-variant": [{ radio: [...DAISY_COLOURS] }],
+            "daisy-radio-size": [{ radio: [...DAISY_SIZES] }],
+            "daisy-toggle-variant": [{ toggle: [...DAISY_COLOURS] }],
+            "daisy-toggle-size": [{ toggle: [...DAISY_SIZES] }],
+            "daisy-card-size": [{ card: [...DAISY_SIZES] }],
+            "daisy-table-size": [{ table: [...DAISY_SIZES] }],
+            "daisy-tabs-style": [{ tabs: ["box", "border", "lift"] }],
+            "daisy-tabs-size": [{ tabs: [...DAISY_SIZES] }],
+            "daisy-progress-variant": [{ progress: [...DAISY_COLOURS] }],
+            "daisy-loading-type": [{ loading: ["spinner", "dots", "ring", "ball", "bars", "infinity"] }],
+            "daisy-loading-size": [{ loading: [...DAISY_SIZES] }],
+        },
+    },
+});
+/**
+ * Merge class names, resolving conflicting utilities so the *last* one
+ * wins — Tailwind's own, this design system's custom scales, and daisyUI's
+ * component modifiers alike.
+ */
+export function cn(...inputs) {
+    return twMerge(clsx(inputs));
+}
+/** The font-size steps this package registers with `tailwind-merge`. Exported
+ * for `theme-tokens.test.ts`, which checks them against `theme.css`. */
+export const REGISTERED_FONT_SIZES = FONT_SIZES;
+//# sourceMappingURL=cn.js.map

package/dist/lib/cn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.js","sourceRoot":"","sources":["../../src/lib/cn.ts"],"names":[],"mappings":"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"}

package/dist/lib/money.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Money formatting from minor units, without losing precision.
+ *
+ * # Why this exists
+ *
+ * Money is the single most duplicated formatter in every application that
+ * handles it. The sibling payments codebase this package was generalised
+ * for had **four** independent implementations at the time of writing, in
+ * four packages, with four different signatures and three different
+ * hard-coded tables of which currencies have no decimal places — and one
+ * of them divided by a power of ten in floating point, which silently
+ * corrupts any amount past 2^53 minor units. All four also got the
+ * three-decimal currencies wrong, because every hand-written table
+ * remembers `JPY` and `XAF` and forgets `KWD` and `BHD`.
+ *
+ * # Three decisions, each load-bearing
+ *
+ * **Minor units in, never a decimal number.** An amount is an integer
+ * count of the currency's smallest unit — that is how it is stored, how
+ * it is transmitted, and the only representation that cannot be wrong by
+ * a rounding error. `bigint` and a decimal-digit `string` are accepted
+ * alongside `number` so an `i64` from a Rust backend survives the trip;
+ * JSON gives it to you as a string precisely because `number` cannot hold
+ * it.
+ *
+ * **The exponent comes from `Intl`, not from a table here.** `Intl`
+ * already ships the ISO 4217 exponent for every currency, so there is no
+ * list to maintain and no currency this gets wrong. Verified rather than
+ * assumed: `XAF`/`XOF`/`JPY`/`CLP`/`VND` resolve to 0 and `KWD`/`BHD` to
+ * 3, which is exactly the set hand-written tables miss.
+ *
+ * **The scaling is string surgery, never division.** The minor-unit
+ * integer is split into whole and fractional parts by digit position and
+ * handed to `Intl.NumberFormat` as a string, which accepts arbitrary
+ * precision. No value is ever converted to a float, so an amount larger
+ * than `Number.MAX_SAFE_INTEGER` formats exactly.
+ */
+/** An integer count of a currency's smallest unit. */
+export type MinorUnits = number | bigint | string;
+export interface FormatMoneyOptions {
+    /** BCP 47 tag. Defaults to the runtime's own locale.
+     *
+     * Pass one explicitly anywhere the output must be stable — a test, a
+     * server-rendered page whose HTML must match the client's hydration, or
+     * a value a human will compare against a bank statement. */
+    locale?: string | undefined;
+    /** `symbol` → `FCFA 5,000`; `code` → `XAF 5,000`; `none` → `5,000`.
+     *
+     * `code` is the honest default for an operator console: currency
+     * symbols are ambiguous across locales ($ alone names at least a dozen
+     * currencies) and an operator reconciling against a ledger needs the
+     * ISO code. */
+    display?: "symbol" | "code" | "none";
+    /** Force a sign even when positive, e.g. for a ledger delta. */
+    signDisplay?: Intl.NumberFormatOptions["signDisplay"];
+}
+/**
+ * How many decimal places this currency has, per ISO 4217, as `Intl`
+ * knows it. `2` for a currency `Intl` has never heard of — the majority
+ * case, and the same fallback `Intl` itself uses.
+ */
+export declare function currencyExponent(currency: string, locale?: string): number;
+/**
+ * `formatMoney(500000, "XAF")` → `"XAF 500,000"`.
+ * `formatMoney("1250", "USD")` → `"USD 12.50"`.
+ *
+ * @throws if `minorUnits` is not an integer. A non-integer minor-unit
+ * amount is always a bug — usually a caller that already divided — and
+ * silently rounding it here would hide the real error at the point where
+ * it is least visible.
+ */
+export declare function formatMoney(minorUnits: MinorUnits, currency: string, options?: FormatMoneyOptions): string;
+//# sourceMappingURL=money.d.ts.map

package/dist/lib/money.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.d.ts","sourceRoot":"","sources":["../../src/lib/money.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,sDAAsD;AACtD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAElD,MAAM,WAAW,kBAAkB;IACjC;;;;gEAI4D;IAC5D,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;;;;;mBAKe;IACf,OAAO,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACrC,gEAAgE;IAChE,WAAW,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;CACvD;AAkBD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAK1E;AAmBD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CA8CR"}

package/dist/lib/money.js

@@ -0,0 +1,123 @@
+/**
+ * Money formatting from minor units, without losing precision.
+ *
+ * # Why this exists
+ *
+ * Money is the single most duplicated formatter in every application that
+ * handles it. The sibling payments codebase this package was generalised
+ * for had **four** independent implementations at the time of writing, in
+ * four packages, with four different signatures and three different
+ * hard-coded tables of which currencies have no decimal places — and one
+ * of them divided by a power of ten in floating point, which silently
+ * corrupts any amount past 2^53 minor units. All four also got the
+ * three-decimal currencies wrong, because every hand-written table
+ * remembers `JPY` and `XAF` and forgets `KWD` and `BHD`.
+ *
+ * # Three decisions, each load-bearing
+ *
+ * **Minor units in, never a decimal number.** An amount is an integer
+ * count of the currency's smallest unit — that is how it is stored, how
+ * it is transmitted, and the only representation that cannot be wrong by
+ * a rounding error. `bigint` and a decimal-digit `string` are accepted
+ * alongside `number` so an `i64` from a Rust backend survives the trip;
+ * JSON gives it to you as a string precisely because `number` cannot hold
+ * it.
+ *
+ * **The exponent comes from `Intl`, not from a table here.** `Intl`
+ * already ships the ISO 4217 exponent for every currency, so there is no
+ * list to maintain and no currency this gets wrong. Verified rather than
+ * assumed: `XAF`/`XOF`/`JPY`/`CLP`/`VND` resolve to 0 and `KWD`/`BHD` to
+ * 3, which is exactly the set hand-written tables miss.
+ *
+ * **The scaling is string surgery, never division.** The minor-unit
+ * integer is split into whole and fractional parts by digit position and
+ * handed to `Intl.NumberFormat` as a string, which accepts arbitrary
+ * precision. No value is ever converted to a float, so an amount larger
+ * than `Number.MAX_SAFE_INTEGER` formats exactly.
+ */
+const DIGITS_ONLY = /^-?\d+$/;
+/** Cache: constructing an `Intl.NumberFormat` is the expensive part, and a
+ * table renders the same currency once per row. */
+const formatters = new Map();
+function formatter(key, options, locale) {
+    const cacheKey = `${locale ?? ""}|${key}`;
+    let found = formatters.get(cacheKey);
+    if (found === undefined) {
+        found = new Intl.NumberFormat(locale, options);
+        formatters.set(cacheKey, found);
+    }
+    return found;
+}
+/**
+ * How many decimal places this currency has, per ISO 4217, as `Intl`
+ * knows it. `2` for a currency `Intl` has never heard of — the majority
+ * case, and the same fallback `Intl` itself uses.
+ */
+export function currencyExponent(currency, locale) {
+    return (formatter(`exp:${currency}`, { style: "currency", currency }, locale).resolvedOptions()
+        .maximumFractionDigits ?? 2);
+}
+/**
+ * Shifts a minor-unit integer right by `exponent` places, as a string.
+ *
+ * `"500"`, 2 → `"5.00"`; `"5"`, 2 → `"0.05"`; `"-5"`, 2 → `"-0.05"`;
+ * `"5000"`, 0 → `"5000"`.
+ */
+function shiftDecimal(digits, exponent) {
+    const negative = digits.startsWith("-");
+    const abs = negative ? digits.slice(1) : digits;
+    const sign = negative ? "-" : "";
+    if (exponent === 0)
+        return sign + abs;
+    const padded = abs.padStart(exponent + 1, "0");
+    const whole = padded.slice(0, padded.length - exponent);
+    const fraction = padded.slice(padded.length - exponent);
+    return `${sign}${whole}.${fraction}`;
+}
+/**
+ * `formatMoney(500000, "XAF")` → `"XAF 500,000"`.
+ * `formatMoney("1250", "USD")` → `"USD 12.50"`.
+ *
+ * @throws if `minorUnits` is not an integer. A non-integer minor-unit
+ * amount is always a bug — usually a caller that already divided — and
+ * silently rounding it here would hide the real error at the point where
+ * it is least visible.
+ */
+export function formatMoney(minorUnits, currency, options = {}) {
+    const { locale, display = "code", signDisplay } = options;
+    let digits;
+    if (typeof minorUnits === "bigint") {
+        digits = minorUnits.toString();
+    }
+    else if (typeof minorUnits === "number") {
+        if (!Number.isInteger(minorUnits)) {
+            throw new TypeError(`formatMoney expects an integer count of minor units, got ${minorUnits} (${currency}). ` +
+                "Pass 1250 for USD 12.50, not 12.5.");
+        }
+        digits = minorUnits.toFixed(0);
+    }
+    else {
+        const trimmed = minorUnits.trim();
+        if (!DIGITS_ONLY.test(trimmed)) {
+            throw new TypeError(`formatMoney expects an integer count of minor units, got ${JSON.stringify(minorUnits)} (${currency}).`);
+        }
+        digits = trimmed;
+    }
+    const exponent = currencyExponent(currency, locale);
+    const value = shiftDecimal(digits, exponent);
+    const intlOptions = display === "none"
+        ? {
+            style: "decimal",
+            minimumFractionDigits: exponent,
+            maximumFractionDigits: exponent,
+        }
+        : {
+            style: "currency",
+            currency,
+            currencyDisplay: display,
+        };
+    if (signDisplay !== undefined)
+        intlOptions.signDisplay = signDisplay;
+    return formatter(`fmt:${currency}:${display}:${signDisplay ?? ""}:${exponent}`, intlOptions, locale).format(value);
+}
+//# sourceMappingURL=money.js.map

package/dist/lib/money.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.js","sourceRoot":"","sources":["../../src/lib/money.ts"],"names":[],"mappings":"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"}

package/dist/lib/omit-undefined.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Strips every key whose value is explicitly `undefined`, and narrows the
+ * return type to match: `exactOptionalPropertyTypes` (this workspace's own
+ * `tsconfig`) makes `{ disabled?: boolean }` reject a spread whose *type*
+ * is `{ disabled?: boolean | undefined }` even when the value at runtime is
+ * always defined for the keys that matter — every `React.*HTMLAttributes`
+ * type declares its optional fields as `T | undefined` explicitly, but
+ * Headless UI's own prop types (`ListboxProps`, `MenuItemProps`, `LabelProps`,
+ * …) declare theirs as plain `T`. Spreading `...props` from a native-element
+ * prop type onto a Headless UI component hits this every time (found
+ * porting `select.tsx`/`dropdown-menu.tsx`/`label.tsx` off Radix, D3) —
+ * this is the one general fix rather than a one-off cast at each call site.
+ */
+export declare function omitUndefined<T extends Record<string, unknown>>(props: T): {
+    [K in keyof T]: Exclude<T[K], undefined>;
+};
+//# sourceMappingURL=omit-undefined.d.ts.map

package/dist/lib/omit-undefined.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"omit-undefined.d.ts","sourceRoot":"","sources":["../../src/lib/omit-undefined.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7D,KAAK,EAAE,CAAC,GACP;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC;CAAE,CAS9C"}

package/dist/lib/omit-undefined.js

@@ -0,0 +1,24 @@
+/**
+ * Strips every key whose value is explicitly `undefined`, and narrows the
+ * return type to match: `exactOptionalPropertyTypes` (this workspace's own
+ * `tsconfig`) makes `{ disabled?: boolean }` reject a spread whose *type*
+ * is `{ disabled?: boolean | undefined }` even when the value at runtime is
+ * always defined for the keys that matter — every `React.*HTMLAttributes`
+ * type declares its optional fields as `T | undefined` explicitly, but
+ * Headless UI's own prop types (`ListboxProps`, `MenuItemProps`, `LabelProps`,
+ * …) declare theirs as plain `T`. Spreading `...props` from a native-element
+ * prop type onto a Headless UI component hits this every time (found
+ * porting `select.tsx`/`dropdown-menu.tsx`/`label.tsx` off Radix, D3) —
+ * this is the one general fix rather than a one-off cast at each call site.
+ */
+export function omitUndefined(props) {
+    const result = {};
+    for (const key of Object.keys(props)) {
+        const value = props[key];
+        if (value !== undefined) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=omit-undefined.js.map

package/dist/lib/omit-undefined.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"omit-undefined.js","sourceRoot":"","sources":["../../src/lib/omit-undefined.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAQ;IAER,MAAM,MAAM,GAAG,EAAkD,CAAC;IAClE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAgB,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAuC,CAAC;QACxD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "@vaam-apps/ui",
+  "version": "0.1.0",
+  "description": "A dark-first React component library for operator consoles — daisyUI styling, Headless UI behaviour, and a parameterised status-glyph system.",
+  "license": "MIT",
+  "author": "Vaam Apps",
+  "homepage": "https://github.com/vaam-apps/ui#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vaam-apps/ui.git"
+  },
+  "bugs": {
+    "url": "https://github.com/vaam-apps/ui/issues"
+  },
+  "keywords": [
+    "react",
+    "ui",
+    "components",
+    "design-system",
+    "tailwindcss",
+    "daisyui",
+    "headlessui",
+    "dashboard",
+    "admin"
+  ],
+  "type": "module",
+  "sideEffects": [
+    "*.css"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./styles/theme.css": "./src/styles/theme.css",
+    "./package.json": "./package.json"
+  },
+  "types": "./dist/index.d.ts",
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/*.stories.tsx",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "daisyui": "^5",
+    "react": "^18.3.0 || ^19",
+    "react-dom": "^18.3.0 || ^19",
+    "tailwindcss": "^4.1.0"
+  },
+  "dependencies": {
+    "@headlessui/react": "^2.2.10",
+    "@radix-ui/react-dialog": "^1.1.1",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "cmdk": "1.1.1",
+    "lucide-react": "^1.44.0",
+    "react-day-picker": "^10.0.1",
+    "tailwind-merge": "^3.6.0",
+    "vaul": "1.1.2"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.5.13",
+    "@storybook/addon-a11y": "10.6.0",
+    "@storybook/addon-docs": "10.6.0",
+    "@storybook/react-vite": "10.6.0",
+    "@tailwindcss/vite": "^4.3.3",
+    "@types/node": "^26",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "daisyui": "^5.7.36",
+    "react": "^19",
+    "react-dom": "^19",
+    "storybook": "10.6.0",
+    "tailwindcss": "^4.3.3",
+    "typescript": "^7",
+    "vite": "^8",
+    "vitest": "^5"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node scripts/specify-extensions.mjs dist",
+    "build-storybook": "storybook build -o storybook-static",
+    "clean": "rm -rf dist storybook-static",
+    "format": "biome check --write .",
+    "lint": "biome check .",
+    "storybook": "storybook dev -p 6006",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/components/data/code.tsx

@@ -0,0 +1,43 @@
+import type { ReactNode } from "react";
+import { cn } from "../../lib/cn";
+
+/**
+ * Inline monospace emphasis for a literal term — a config key, a role key,
+ * a job kind, a model or field name.
+ *
+ * **Not `IdDisplay`, and the distinction is load-bearing.** `IdDisplay` is
+ * documented as specifically for `cs_cuid()` values: it truncates to seven
+ * characters with no middle ellipsis and offers a copy button, both of
+ * which are correct for an opaque 23-character id and wrong for anything
+ * else. Three separate agents independently checked their own sites
+ * against `schemas/vsms.cstack` and reached the same conclusion — none of
+ * these are `Cuid` (`AppClient.clientId` is a plain bounded `String`,
+ * `Role.key` is `@regex`-constrained, a route predicate is an operator or
+ * prefix, `providerMessageRef` is an *external* provider's id) — so
+ * routing them through `IdDisplay` would truncate values that must be read
+ * in full.
+ *
+ * This exists because `font-mono text-foreground` was the most-repeated
+ * class string left after the R6 factorization (31 occurrences), and
+ * because three route groups had already each created a byte-identical
+ * local `Code` component for it. Those three copies are exactly the
+ * "same shape, different name" duplication that produced two
+ * `ScreenHeader`s and two `MESSAGE_CLASSES` earlier in this effort — the
+ * agents that wrote them flagged the risk themselves and could not fix it,
+ * because a cross-route duplicate is not a route-scoped change.
+ *
+ * Renders a `<span>`, not a `<code>`: several call sites sit inside a
+ * `<dd>` or a sentence where `<code>` would add semantics the content does
+ * not have (a role key in prose is emphasis, not a code sample). A caller
+ * that genuinely wants `<code>` semantics should say so rather than have
+ * this component guess.
+ */
+export function Code({
+  children,
+  className,
+}: {
+  children: ReactNode;
+  className?: string | undefined;
+}) {
+  return <span className={cn("font-mono text-foreground", className)}>{children}</span>;
+}

package/src/components/data/copy-button.tsx

@@ -0,0 +1,97 @@
+"use client";
+
+import { Check, Copy } from "lucide-react";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { cn } from "../../lib/cn";
+
+export interface CopyButtonProps {
+  /** The exact text put on the clipboard. Always the full, unformatted,
+   * machine-readable value — never what is displayed. A truncated id or a
+   * prettily-spaced phone number pasted into a query returns nothing. */
+  value: string;
+  /** Accessible name. Defaults to `Copy ${value}`, which is right for a
+   * short id and wrong for a paragraph — pass something shorter then. */
+  label?: string | undefined;
+  /** Hide until the containing `.group` is hovered or this button is
+   * focused. For dense tables, where a permanently visible icon on every
+   * row is noise. Keyboard users always reach it: focus reveals it. */
+  revealOnGroupHover?: boolean;
+  size?: 12 | 14 | 16;
+  className?: string | undefined;
+}
+
+const CONFIRMATION_MS = 1500;
+
+/**
+ * Copy-to-clipboard affordance: a click, then a checkmark for a moment.
+ *
+ * Extracted because `IdDisplay` and `MsisdnDisplay` each carried their own
+ * byte-identical copy — the same `useState`, the same 1500ms timeout, the
+ * same icon swap, the same class string — and any component that later
+ * wanted the behaviour would have written a third.
+ *
+ * Two things the duplicated versions got wrong, fixed here rather than
+ * copied a third time:
+ *
+ * - **The timeout was never cleared.** Unmounting within the confirmation
+ *   window (a row scrolling out of a virtualised table, a drawer closing)
+ *   left a timer that fired `setCopied` on a dead component. Now cleared
+ *   on unmount, and any in-flight timer is cleared before a new one
+ *   starts, so a double-click cannot end the confirmation early.
+ * - **A rejected `writeText` was unhandled.** `navigator.clipboard` is
+ *   unavailable on an insecure origin and can be refused by permissions
+ *   policy; the bare `await` meant an unhandled rejection and a button
+ *   that silently did nothing. Failure now leaves the icon unchanged,
+ *   which is at least honest, and reports the reason to the console.
+ */
+export function CopyButton({
+  value,
+  label,
+  revealOnGroupHover = false,
+  size = 12,
+  className,
+}: CopyButtonProps) {
+  const [copied, setCopied] = useState(false);
+  const timer = useRef<ReturnType<typeof setTimeout> | null>(null);
+
+  useEffect(
+    () => () => {
+      if (timer.current !== null) clearTimeout(timer.current);
+    },
+    [],
+  );
+
+  const copy = useCallback(() => {
+    void navigator.clipboard.writeText(value).then(
+      () => {
+        setCopied(true);
+        if (timer.current !== null) clearTimeout(timer.current);
+        timer.current = setTimeout(() => setCopied(false), CONFIRMATION_MS);
+      },
+      (error: unknown) => {
+        // Insecure origin, or a permissions policy that forbids it. Leave
+        // the icon alone rather than claim a copy that did not happen.
+        console.error("Clipboard write refused", error);
+      },
+    );
+  }, [value]);
+
+  return (
+    <button
+      type="button"
+      onClick={copy}
+      aria-label={label ?? `Copy ${value}`}
+      className={cn(
+        "shrink-0 text-subtle-foreground transition-opacity hover:text-foreground",
+        revealOnGroupHover && "opacity-0 focus-visible:opacity-100 group-hover:opacity-100",
+        className,
+      )}
+    >
+      {copied ? (
+        <Check size={size} strokeWidth={1.5} className="text-state-success-fg" />
+      ) : (
+        <Copy size={size} strokeWidth={1.5} />
+      )}
+    </button>
+  );
+}