@lerianstudio/sindarian-ui 2.0.0-beta.24 → 2.0.0-beta.26

package/dist/esm/domain/money-math.js

@@ -1,98 +1 @@
-/**
- * money-math — exact integer-minor-unit arithmetic for the double-entry third rail.
- *
- * INTERNAL to the domain layer: nothing here is re-exported from
- * `src/domain/index.ts`, so `toMinor`/`Amount`/`sumMinor` are NOT part of
- * `@lerianstudio/sindarian-ui`'s public API. The consumers that need exact money
- * arithmetic reach it through the components that own it (`moneyDiff`,
- * `MoneyText`, `DelinquencyAging`).
- *
- * Amounts parse to integer minor units (BigInt) at a fixed scale; sums never
- * round-trip through IEEE-754. Pass amounts as canonical decimal STRINGS for
- * lossless math — numbers are converted via toFixed, which is float-bounded
- * (fine for display-scale magnitudes, exact for strings).
- */
-import { isValidDigitCount } from './format.js';
-// Round half-away-from-zero on the first dropped fraction digit.
-function roundsUp(fraction, scale) {
-    return fraction.length > scale && fraction.charCodeAt(scale) - 48 >= 5;
-}
-/** Normalize to a canonical signed decimal: trim, unicode-minus, accounting parens. */
-function canonical(raw) {
-    let s = raw.trim().replace(/−/g, '-');
-    if (/^\(.*\)$/.test(s))
-        s = '-' + s.slice(1, -1).trim(); // (1.23) -> -1.23
-    return s;
-}
-/**
- * Amount -> integer minor units at `scale`, or null if unparseable.
- *
- * `scale` is validated before it reaches `toFixed`/`repeat`: an out-of-range
- * scale (a caller passing `minorDigits: -1`) would throw a RangeError mid-render
- * rather than degrade. It is the single choke point every money path in this
- * layer routes through (`sumMinor`, `moneyDiff`, `delinquencyRate`,
- * `sumBucketTotals`), so guarding it here guards all of them.
- */
-export function toMinor(value, scale) {
-    if (!isValidDigitCount(scale))
-        return null;
-    if (value === null || value === undefined || value === '')
-        return null;
-    let s = typeof value === 'number'
-        ? Number.isFinite(value)
-            ? value.toFixed(scale)
-            : ''
-        : canonical(value);
-    if (s === '' || s === '-' || s === '.' || !/^-?\d*(\.\d*)?$/.test(s))
-        return null;
-    const neg = s.startsWith('-');
-    if (neg)
-        s = s.slice(1);
-    const [intPart = '', fracPart = ''] = s.split('.');
-    // DELIBERATE DIVERGENCE from sindarian-x@0.15.0: the legacy regex admits a
-    // digitless token ('-.', and '.' once the sign is stripped) and coerced it to
-    // an exact 0n. A fabricated exact zero is the worst possible answer in
-    // reconciliation — it reads as a perfect tie and hides the bad input — so a
-    // digitless amount is now indeterminate (null), like every other garbage
-    // token. This mirrors the guard the legacy `rateFraction` already had.
-    if (intPart === '' && fracPart === '')
-        return null;
-    const frac = (fracPart + '0'.repeat(scale)).slice(0, scale);
-    let minor = BigInt((intPart || '0') + frac);
-    if (roundsUp(fracPart, scale))
-        minor += 1n;
-    return neg ? -minor : minor;
-}
-/** Sum amounts to minor units; null if ANY operand is unparseable (indeterminate). */
-export function sumMinor(values, scale) {
-    let total = 0n;
-    for (const v of values) {
-        const m = toMinor(v, scale);
-        if (m === null)
-            return null;
-        total += m;
-    }
-    return total;
-}
-/** Currency's minor-unit digit count via CLDR (BRL/USD->2, JPY->0, BHD->3), or fallback. */
-export function minorDigitsOf(currency, fallback = 2) {
-    try {
-        const opts = new Intl.NumberFormat('en', {
-            style: 'currency',
-            currency,
-            currencyDisplay: 'code'
-        }).resolvedOptions();
-        return opts.maximumFractionDigits ?? fallback;
-    }
-    catch {
-        return fallback;
-    }
-}
-/** Minor units -> canonical decimal string (lossless), for handing to MoneyText. */
-export function minorToDecimal(minor, scale) {
-    const neg = minor < 0n;
-    const abs = (neg ? -minor : minor).toString().padStart(scale + 1, '0');
-    const intPart = abs.slice(0, abs.length - scale) || '0';
-    const fracPart = scale > 0 ? '.' + abs.slice(abs.length - scale) : '';
-    return (neg ? '-' : '') + intPart + fracPart;
-}
+import{isValidDigitCount as s}from"./format.js";function f(n,t){return n.length>t&&n.charCodeAt(t)-48>=5}function l(n){let t=n.trim().replace(/−/g,"-");if(/^\(.*\)$/.test(t))t="-"+t.slice(1,-1).trim();return t}export function toMinor(n,t){if(!s(t))return null;if(n===null||n===void 0||n==="")return null;let r=typeof n==="number"?Number.isFinite(n)?n.toFixed(t):"":l(n);if(r===""||r==="-"||r==="."||!/^-?\d*(\.\d*)?$/.test(r))return null;const i=r.startsWith("-");if(i)r=r.slice(1);const[o="",e=""]=r.split(".");if(o===""&&e==="")return null;const c=(e+"0".repeat(t)).slice(0,t);let u=BigInt((o||"0")+c);if(f(e,t))u+=1n;return i?-u:u}export function sumMinor(n,t){let r=0n;for(const i of n){const o=toMinor(i,t);if(o===null)return null;r+=o}return r}export function minorDigitsOf(n,t=2){try{const r=new Intl.NumberFormat("en",{style:"currency",currency:n,currencyDisplay:"code"}).resolvedOptions();return r.maximumFractionDigits??t}catch{return t}}export function minorToDecimal(n,t){const r=n<0n;const i=(r?-n:n).toString().padStart(t+1,"0");const o=i.slice(0,i.length-t)||"0";const e=t>0?"."+i.slice(i.length-t):"";return(r?"-":"")+o+e}

package/dist/esm/domain/money-text/index.js

@@ -1,118 +1 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/**
- * MoneyText renders a monetary amount with optional ISO currency code,
- * tabular figures so columns line up. The amount is formatted losslessly: when
- * passed as a string, `Intl.NumberFormat.format()` (ES2020+) parses it as an
- * arbitrary-precision value and rounds to `fractionDigits` without ever
- * round-tripping through an IEEE-754 double — so 16+ significant-digit tokens
- * keep every digit. Pass the raw decimal string (not a pre-coerced Number) to
- * preserve that guarantee.
- *
- * The currency code is shown as a suffix rather than a symbol so mixed-currency
- * ledgers stay unambiguous. Negative amounts get the error sign color;
- * null/undefined/empty render the muted no-value placeholder.
- *
- * SIGN COLOR IS NOT THE CREDIT ROLE. The sign ink marks a negative/alarm
- * amount; `--credit` is the accounting reading of a credit amount. They are two
- * roles, and a consumer layers the credit role on top (matcher's fork passes
- * `signColor={false}` with `tone="credit"` precisely so the two never fight).
- * Collapsing the sign color into `text-credit` would erase that distinction.
- *
- * THE SIGN INK IS THE `system-error` H1A INK, not `--destructive`. A signed
- * amount is TEXT, so it answers to WCAG AA on whatever surface holds it, and
- * `--destructive` is a FILL family (buttons, badges, tinted chips) whose dark
- * value reads 3.80:1 as ink on `--card`, an axe finding on a live console.
- * `--system-error-h1a` is the error INK of the same family and reads 8.28:1
- * light / 7.12:1 dark on that surface. `__tests__/tokens-contract.test.ts`
- * re-measures whichever token this line applies, so the pairing is measured
- * rather than trusted.
- */
-import { cn } from '../../lib/utils.js';
-import { NO_VALUE, isValidDigitCount, safeLocale } from '../format.js';
-/**
- * Normalize a raw amount into a string the Intl formatter accepts while
- * preserving precision: trim, convert the unicode minus U+2212 to ASCII '-',
- * and rewrite accounting parens `(123.45)` → `-123.45`. Returns null when the
- * input is empty after trimming (→ NO_VALUE upstream).
- *
- * Internal: exported for its unit tests, never from `src/domain/index.ts`.
- */
-export function normalizeAmount(amount) {
-    let s = String(amount).trim();
-    if (s === '')
-        return null;
-    s = s.replace(/−/g, '-');
-    const parens = s.match(/^\((.*)\)$/);
-    if (parens)
-        s = `-${parens[1].trim()}`;
-    return s;
-}
-/**
- * Pure money formatting: normalize the amount, format it via Intl (preserving
- * precision through the ES2020 string overload), and derive sign + finiteness
- * from the formatted parts — so color and glyph can never disagree. Returns
- * null for empty, non-finite, or unparseable input (→ NO_VALUE upstream).
- *
- * Internal: exported for its unit tests, never from `src/domain/index.ts`.
- */
-export function formatMoneyParts(amount, fractionDigits, locale) {
-    // Reject non-finite numeric inputs (NaN / ±Infinity) before they reach Intl,
-    // which would otherwise render literal "NaN" / "∞".
-    if (typeof amount === 'number' && !Number.isFinite(amount))
-        return null;
-    // A caller-supplied digit count reaches Intl directly; an out-of-range one
-    // would throw a RangeError and blank the amount instead of degrading to
-    // NO_VALUE.
-    if (!isValidDigitCount(fractionDigits))
-        return null;
-    const normalized = normalizeAmount(amount);
-    if (normalized === null)
-        return null;
-    // DELIBERATE DIVERGENCE from sindarian-x@0.15.0: an exact zero written with a
-    // sign ('-0', '-0.00', '(0)') formatted as "-0.00" and reported negative:true,
-    // which painted a zero balance in the destructive sign color. Zero is neither
-    // positive nor negative — a signed-zero ledger cell is a rendering artifact of
-    // the input notation, never a fact about the money. The sign is dropped for an
-    // EXACT zero only; '-0.004' still rounds to "-0.00" and stays negative,
-    // because that one really is below zero.
-    const exactZero = /\d/.test(normalized) && /^-?0*(\.0*)?$/.test(normalized);
-    const forFormat = exactZero ? normalized.replace(/^-/, '') : normalized;
-    // A malformed tag would throw a RangeError out of this constructor and take
-    // the whole amount down; degrade to the runtime locale instead.
-    const formatter = new Intl.NumberFormat(safeLocale(locale), {
-        minimumFractionDigits: fractionDigits,
-        maximumFractionDigits: fractionDigits,
-        signDisplay: 'auto'
-    });
-    // The bundled lib types only model a `number | bigint` overload; the ES2020
-    // string overload (which preserves precision) is unmodelled, so the
-    // normalized amount is cast at the boundary.
-    //
-    // RUNTIME FLOOR: this relies on a V8 with exact decimal-STRING Intl support
-    // (Node >= 20, evergreen browsers) — the whole point is that a 20-digit amount
-    // never round-trips through an IEEE-754 double. There is deliberately NO
-    // Number-coercion fallback for older runtimes: that fallback would silently
-    // reintroduce the precision loss this function exists to prevent.
-    const parts = formatter.formatToParts(forFormat);
-    // Intl emits a literal "nan"/"∞" part for non-finite values; treat those as
-    // no-value rather than rendering them.
-    if (parts.some((p) => p.type === 'nan' || p.type === 'infinity'))
-        return null;
-    return {
-        formatted: parts.map((p) => p.value).join(''),
-        negative: parts.some((p) => p.type === 'minusSign')
-    };
-}
-export function MoneyText({ amount, currency, fractionDigits = 2, hideCurrency = false, signColor = true, locale, className }) {
-    const noValue = (_jsx("span", { className: cn('text-muted-foreground tabular-nums', className), children: NO_VALUE }));
-    if (amount === null || amount === undefined || amount === '')
-        return noValue;
-    // Sign and finiteness are derived from the formatted parts, not a raw string
-    // prefix — so color and glyph can never disagree, and "-0" / "(0)" are
-    // treated as the non-negative zero Intl renders.
-    const result = formatMoneyParts(amount, fractionDigits, locale);
-    if (result === null)
-        return noValue;
-    const { formatted, negative } = result;
-    return (_jsxs("span", { className: cn('tabular-nums', signColor && negative && 'text-system-error-h1a', className), children: [formatted, !hideCurrency && currency ? (_jsx("span", { className: "text-muted-foreground ml-1 text-xs", children: currency })) : null] }));
-}
+import{jsx as u,jsxs as p}from"react/jsx-runtime";import{cn as m}from"../../lib/utils.js";import{NO_VALUE as x,isValidDigitCount as d,safeLocale as g}from"../format.js";export function normalizeAmount(e){let t=String(e).trim();if(t==="")return null;t=t.replace(/−/g,"-");const s=t.match(/^\((.*)\)$/);if(s)t=`-${s[1].trim()}`;return t}export function formatMoneyParts(e,t,s){if(typeof e==="number"&&!Number.isFinite(e))return null;if(!d(t))return null;const r=normalizeAmount(e);if(r===null)return null;const a=/\d/.test(r)&&/^-?0*(\.0*)?$/.test(r);const l=a?r.replace(/^-/,""):r;const i=new Intl.NumberFormat(g(s),{minimumFractionDigits:t,maximumFractionDigits:t,signDisplay:"auto"});const o=i.formatToParts(l);if(o.some(n=>n.type==="nan"||n.type==="infinity"))return null;return{formatted:o.map(n=>n.value).join(""),negative:o.some(n=>n.type==="minusSign")}}export function MoneyText({amount:e,currency:t,fractionDigits:s=2,hideCurrency:r=false,signColor:a=true,locale:l,className:i}){const o=u("span",{className:m("text-muted-foreground tabular-nums",i),children:x});if(e===null||e===void 0||e==="")return o;const n=formatMoneyParts(e,s,l);if(n===null)return o;const{formatted:f,negative:c}=n;return p("span",{className:m("tabular-nums",a&&c&&"text-system-error-h1a",i),children:[f,!r&&t?u("span",{className:"text-muted-foreground ml-1 text-xs",children:t}):null]})}

package/dist/esm/domain/section-label/index.js

@@ -1,14 +1 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { SECTION_LABEL_CLASS } from '../../lib/typography.js';
-import { cn } from '../../lib/utils.js';
-/** The entry-section head treatment: a hairline double rule under the label.
- *  `border-border`, NOT the register head's ink — this is the quieter of the two
- *  head rules. Pinned here because ~20 call sites were restating it. */
-const RULED_CLASS = 'border-b-[3px] border-double border-border pb-2';
-export function SectionLabel({ children, className, as: Tag = 'h2', ruled = false, ...rest }) {
-    // The remaining element props reach the rendered tag, so a panel can point
-    // `aria-labelledby` at this heading via `id`, and tests can hang a `data-*`
-    // hook off it. Without the spread there was no way to reference the heading
-    // from its own container.
-    return (_jsx(Tag, { ...rest, "data-variant": ruled ? 'ruled' : undefined, className: cn(SECTION_LABEL_CLASS, ruled && RULED_CLASS, className), children: children }));
-}
+import{jsx as t}from"react/jsx-runtime";import{SECTION_LABEL_CLASS as d}from"../../lib/typography.js";import{cn as b}from"../../lib/utils.js";const i="border-b-[3px] border-double border-border pb-2";export function SectionLabel({children:o,className:e,as:a="h2",ruled:r=false,...n}){return t(a,{...n,"data-variant":r?"ruled":void 0,className:b(d,r&&i,e),children:o})}

package/dist/esm/domain/status-rail/index.js

@@ -1,71 +1 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-/**
- * StatusRail — Row 0 of every console screen. A thin, full-width recessed strip
- * that reads "the terminal is live": a dot-separated mono tape on the recessed
- * page surface (`bg-body-surface`), with optional right-pinned count chips.
- *
- *   <StatusRail
- *     lead={contextName}
- *     items={[
- *       { value: '90d' },
- *       { label: 'Updated', value: '12:04 UTC' },
- *       { value: <><LivePulse /> Live</> }
- *     ]}
- *     chips={[
- *       { label: 'Open', value: '12' },
- *       { label: 'Pending overdue', value: '3', alarm: true }
- *     ]}
- *   />
- *
- * The first token (`lead`) is `text-foreground font-medium`. Tape items are
- * dot-separated; an item with a `label` renders the label inline before its
- * value, in the rail's own `font-medium`. Chips pin right via `ml-auto`;
- * `alarm` escalates a chip to destructive.
- *
- * Labels carry weight only: the rail root already supplies size, family and
- * ink (`font-mono text-xs text-muted-foreground`), so re-stating
- * LABEL_VOICE_CLASS here would import a `text-sm` that fights the tape.
- */
-import { TriangleAlert } from 'lucide-react';
-import { cn } from '../../lib/utils.js';
-export function StatusRail({ lead, items = [], chips = [], className }) {
-    // ONE test, used by both the lead span and the first item's separator. Two
-    // separate tests (`lead !== undefined && lead !== null` vs `lead != null`)
-    // agreed on null/undefined and diverged on a ReactNode that RENDERS NOTHING,
-    // which produced an empty lead span while the first item still got its
-    // leading dot — the rail opened with a stray `·`. React renders BOTH booleans
-    // as nothing, so `true` is as empty as `false`; the typeof check covers the
-    // pair rather than naming one of them.
-    const hasLead = lead != null && lead !== '' && typeof lead !== 'boolean';
-    return (_jsxs("div", { className: cn(
-        // Recessed instrument strip: the page surface inside a hairline border
-        // whose top edge runs one step darker — light-from-above recession
-        // without any inner shadow.
-        'border-border border-t-foreground/10 bg-body-surface text-muted-foreground flex flex-wrap items-center gap-x-3 gap-y-1.5 rounded-lg border px-4 py-2 font-mono text-xs tabular-nums', className), children: [hasLead ? (_jsx("span", { className: "text-foreground font-medium", children: lead })) : null, items.map((item, i) => (_jsx(RailFragment, { hasLead: hasLead || i > 0, children: item.label != null ? (_jsxs("span", { className: "flex items-center gap-1.5", children: [_jsx("span", { className: "font-medium", children: item.label }), item.value] })) : (_jsx("span", { className: "flex items-center gap-1.5", children: item.value })) }, item.id ?? i))), chips.length ? (_jsx("span", { className: "ml-auto flex flex-wrap items-center gap-x-3 gap-y-1.5", children: chips.map((chip, i) => (_jsxs("span", { className: "inline-flex items-center gap-1.5", children: [_jsx("span", { className: "font-medium", children: chip.label }), _jsxs("span", { className: cn(
-                            // Tiny mono token: raised a hair off the sunken tape by the
-                            // card surface + whisper shadow.
-                            'inline-flex items-center gap-1 rounded-sm border px-1.5 py-0.5 shadow-sm', chip.alarm
-                                ? 'border-destructive/40 bg-destructive/10 text-system-error-h1a'
-                                : 'border-border bg-card text-foreground'), children: [chip.alarm ? (_jsxs(_Fragment, { children: [_jsx(TriangleAlert, { "aria-hidden": true, className: "size-3" }), _jsx("span", { className: "sr-only", children: "(alarme)" })] })) : null, chip.value] })] }, chip.id ?? i))) })) : null] }));
-}
-/** A tape item preceded by a separator dot when it is not the first token. */
-function RailFragment({ children, hasLead }) {
-    return (_jsxs(_Fragment, { children: [hasLead ? _jsx(Dot, {}) : null, children] }));
-}
-/** Decorative dot separator — muted, so the tape reads as punctuated, not broken. */
-export function Dot() {
-    return (_jsx("span", { "aria-hidden": true, className: "text-muted-foreground/50", children: "\u00B7" }));
-}
-/**
- * The live auto-refresh pulse: a success dot with a reduced-motion-gated ping
- * ring. Place it inside a tape item value, e.g. `<><LivePulse /> Live</>`.
- *
- * The ring rides Tailwind's built-in `ping` keyframe under the `motion-safe:`
- * variant (`@media (prefers-reduced-motion: no-preference)`), so a
- * reduced-motion reader sees only the static dot — same gating as the
- * hand-rolled `status-rail-pulse` keyframe it replaces, with no stylesheet of
- * its own.
- */
-export function LivePulse() {
-    return (_jsxs("span", { className: "relative flex size-2", "aria-hidden": true, children: [_jsx("span", { className: "bg-system-success/60 absolute inline-flex size-2 rounded-full motion-safe:animate-ping" }), _jsx("span", { className: "bg-system-success relative inline-flex size-2 rounded-full" })] }));
-}
+import{jsx as e,jsxs as r,Fragment as o}from"react/jsx-runtime";import{TriangleAlert as u}from"lucide-react";import{cn as i}from"../../lib/utils.js";export function StatusRail({lead:n,items:l=[],chips:t=[],className:m}){const d=n!=null&&n!==""&&typeof n!=="boolean";return r("div",{className:i("border-border border-t-foreground/10 bg-body-surface text-muted-foreground flex flex-wrap items-center gap-x-3 gap-y-1.5 rounded-lg border px-4 py-2 font-mono text-xs tabular-nums",m),children:[d?e("span",{className:"text-foreground font-medium",children:n}):null,l.map((a,s)=>e(c,{hasLead:d||s>0,children:a.label!=null?r("span",{className:"flex items-center gap-1.5",children:[e("span",{className:"font-medium",children:a.label}),a.value]}):e("span",{className:"flex items-center gap-1.5",children:a.value})},a.id??s)),t.length?e("span",{className:"ml-auto flex flex-wrap items-center gap-x-3 gap-y-1.5",children:t.map((a,s)=>r("span",{className:"inline-flex items-center gap-1.5",children:[e("span",{className:"font-medium",children:a.label}),r("span",{className:i("inline-flex items-center gap-1 rounded-sm border px-1.5 py-0.5 shadow-sm",a.alarm?"border-destructive/40 bg-destructive/10 text-system-error-h1a":"border-border bg-card text-foreground"),children:[a.alarm?r(o,{children:[e(u,{"aria-hidden":true,className:"size-3"}),e("span",{className:"sr-only",children:"(alarme)"})]}):null,a.value]})]},a.id??s))}):null]})}function c({children:n,hasLead:l}){return r(o,{children:[l?e(Dot,{}):null,n]})}export function Dot(){return e("span",{"aria-hidden":true,className:"text-muted-foreground/50",children:"\xB7"})}export function LivePulse(){return r("span",{className:"relative flex size-2","aria-hidden":true,children:[e("span",{className:"bg-system-success/60 absolute inline-flex size-2 rounded-full motion-safe:animate-ping"}),e("span",{className:"bg-system-success relative inline-flex size-2 rounded-full"})]})}

package/dist/esm/domain/threshold-gauge/index.js

@@ -1,157 +1 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/**
- * ThresholdGauge — where a value sits across ordered, NAMED bands.
- *
- * A metric is rarely interesting in isolation; what matters is which band it has
- * crossed. A credit utilization of 95% is a breach; a liquidity coverage ratio
- * of 95% may be perfectly calm. So a gauge that paints a smooth red→green
- * gradient is lying by implication — it suggests a continuum where the business
- * has hard thresholds. This atom STATES the thresholds: it resolves the current
- * band (low / warn / breach), names it with a glyph + an sr-only word + a tint,
- * and marks the band edges on the bar so the reader sees the line the value
- * crossed, not a vibe.
- *
- *   <ThresholdGauge value={0.92} max={1} warn={0.8} breach={0.9} format="percent"
- *     direction="higher-is-worse" label="Utilização do limite" />   // breach
- *   <ThresholdGauge value={1.18} max={2} warn={1} breach={0.9} format="ratio"
- *     direction="lower-is-worse" label="Índice de cobertura" />      // low (calm)
- *
- * DIRECTION is mandatory because the same numbers mean opposite things:
- *  - higher-is-worse: the value climbs INTO danger (warn < breach). Utilization,
- *    concentration, error rate.
- *  - lower-is-worse: the value FALLS into danger (breach < warn). Coverage,
- *    liquidity, capital adequacy.
- *
- * INVARIANT (strict edges by DEFAULT): a band escalation requires the value to
- * be STRICTLY beyond the edge. A value sitting exactly ON a threshold belongs to
- * the calmer band, not the louder one — `gaugeBand` encodes this so an on-edge
- * utilization of exactly the breach line still reads as warn, never a surprise
- * breach. A consumer whose own enforcement is INCLUSIVE (a quota blocking at
- * `used >= limit`) opts out with `edges="inclusive"`, which escalates ON the
- * edge in both directions.
- *
- * The current band is the load-bearing signal and it never rides on color alone
- * (WCAG 1.4.1): a glyph leads, an sr-only word names it, the tint only
- * reinforces. The numeric position reads via a mono `Figure`, never inferred
- * from the bar geometry — and a consumer forced to clamp `value` to keep
- * `aria-valuenow` in range can still print the true figure via `displayValue`.
- *
- * Pure display: server-safe, no directive.
- */
-import { OctagonX, ShieldCheck, TriangleAlert } from 'lucide-react';
-import { LABEL_VOICE_CLASS } from '../../lib/typography.js';
-import { cn } from '../../lib/utils.js';
-import { Figure } from '../figure/index.js';
-import { formatCount, formatPercent, NO_VALUE } from '../format.js';
-import { MoneyText } from '../money-text/index.js';
-/** Band → glyph + tint + accessible word. The glyph and sr-only word are the
- *  load-bearing cue; the tint only reinforces, so the band survives grayscale
- *  and color-vision deficiency. The words are pt-BR defaults — a consumer in
- *  another locale overrides them via the `bandLabels` prop. */
-const BAND = {
-    low: {
-        Icon: ShieldCheck,
-        tint: 'text-system-success-h1a',
-        word: 'Dentro do limite'
-    },
-    warn: {
-        Icon: TriangleAlert,
-        tint: 'text-system-alert-h1a',
-        word: 'Próximo do limite'
-    },
-    breach: {
-        Icon: OctagonX,
-        tint: 'text-system-error-h1a',
-        word: 'Limite ultrapassado'
-    }
-};
-/** Track fill tint per band, and the reason it is a SEPARATE map from the
- *  tint above: these are the fill tokens, and a fill answers to no text floor.
- *  The tint above is painted on the band glyph AND on the `Figure`, so it has
- *  to be the ink family. Light `--system-alert` is #EAB308, about 1.9:1 on
- *  white, and `--system-success` about 3.3:1 — both were readable only as a
- *  bar wash, never as the number the reader is here to read. */
-const BAND_FILL = {
-    low: 'bg-system-success',
-    warn: 'bg-system-alert',
-    breach: 'bg-destructive'
-};
-/**
- * Resolve which band a value occupies. Pure — the testable heart of the atom.
- *
- * STRICT edges by default: a value exactly ON a threshold stays in the CALMER
- * band; escalation needs the value strictly past.
- *
- *  - higher-is-worse: `value > breach` → breach; `value > warn` → warn; else low.
- *  - lower-is-worse:  `value < breach` → breach; `value < warn` → warn; else low.
- *
- * `thresholds.edges = 'inclusive'` opts into `>=` / `<=` instead, for a consumer
- * whose enforcement is inclusive. Omitted or 'strict' → the behaviour above.
- *
- * Non-finite input degrades to 'low' rather than throwing — a missing reading is
- * not, by itself, an alarm.
- */
-export function gaugeBand(value, thresholds, direction) {
-    if (!Number.isFinite(value))
-        return 'low';
-    const { warn, breach, edges = 'strict' } = thresholds;
-    const beyond = direction === 'higher-is-worse'
-        ? (edge) => (edges === 'inclusive' ? value >= edge : value > edge)
-        : (edge) => (edges === 'inclusive' ? value <= edge : value < edge);
-    if (beyond(breach))
-        return 'breach';
-    if (beyond(warn))
-        return 'warn';
-    return 'low';
-}
-/**
- * An empty or whitespace-only string is not a name. `??` only skips null and
- * undefined, so `ariaLabel=""` or `bandLabels={{ breach: '' }}` won the fallback
- * chain and produced an EMPTY accessible name — worse than the missing one it
- * was meant to fix, because `aria-label=""` also suppresses the element's other
- * naming routes. Normalizing to undefined lets the chain fall through properly.
- */
-function nonEmpty(value) {
-    return value != null && value.trim() !== '' ? value : undefined;
-}
-/** Clamp a value into [min, max] then normalize to a 0..1 fraction of the
- *  track. A zero-width track (max <= min) collapses to 0 rather than dividing by
- *  zero. */
-function trackFraction(value, min, max) {
-    if (!Number.isFinite(value) || max <= min)
-        return 0;
-    const clamped = Math.max(min, Math.min(max, value));
-    return (clamped - min) / (max - min);
-}
-/** Format the value for the mono readout per `format`. Money routes through
- *  MoneyText (never a hand-rolled string); the rest through the format helpers. */
-function readout(value, format, currency, locale) {
-    if (!Number.isFinite(value))
-        return NO_VALUE;
-    if (format === 'money') {
-        return (_jsx(MoneyText, { amount: value, currency: currency, signColor: false, locale: locale }));
-    }
-    if (format === 'percent')
-        return formatPercent(value, { unit: 'percent', locale });
-    if (format === 'ratio')
-        return formatPercent(value, { unit: 'ratio', locale });
-    return formatCount(value, locale);
-}
-export function ThresholdGauge({ value, displayValue, min = 0, max, warn, breach, edges, direction, format = 'percent', currency, locale, label, ariaLabel, bandLabels, className }) {
-    const band = gaugeBand(value, { warn, breach, edges }, direction);
-    const { Icon, tint } = BAND[band];
-    // The sr-only word is the band's only non-chromatic cue, so it is also the
-    // string a trilingual consumer has to translate. pt-BR default, override wins.
-    // Every rung of the naming chain is normalized: an empty override must fall
-    // through to the next source rather than win with a blank string.
-    const word = nonEmpty(bandLabels?.[band]) ?? BAND[band].word;
-    const caption = nonEmpty(label);
-    // A `role="meter"` with no accessible name is announced as a naked number.
-    // The band word is always present and always meaningful, so the meter is named
-    // even when a consumer renders the gauge without a visible caption.
-    const meterName = nonEmpty(ariaLabel) ?? caption ?? word;
-    const valuePct = trackFraction(value, min, max) * 100;
-    const warnPct = trackFraction(warn, min, max) * 100;
-    const breachPct = trackFraction(breach, min, max) * 100;
-    return (_jsxs("div", { className: cn('flex flex-col gap-2', className), children: [_jsxs("div", { className: "flex items-baseline justify-between gap-3", children: [caption != null ? (_jsx("span", { className: LABEL_VOICE_CLASS, children: caption })) : (_jsx("span", {})), _jsxs("span", { className: cn('inline-flex items-center gap-1.5', tint), children: [_jsx(Icon, { "aria-hidden": true, className: "size-4 shrink-0" }), _jsxs("span", { className: "sr-only", children: [word, ": "] }), _jsx(Figure, { size: "row", className: tint, children: readout(displayValue ?? value, format, currency, locale) })] })] }), _jsxs("div", { role: "meter", "aria-valuenow": Number.isFinite(value) ? value : undefined, "aria-valuemin": min, "aria-valuemax": max, "aria-label": meterName, className: "border-border bg-muted relative h-2 w-full overflow-hidden rounded-full border", children: [_jsx("div", { "aria-hidden": true, className: cn('absolute inset-y-0 left-0 rounded-full', BAND_FILL[band]), style: { width: `${valuePct}%` } }), _jsx("span", { "aria-hidden": true, className: "bg-system-alert absolute inset-y-0 w-px", style: { left: `${warnPct}%` } }), _jsx("span", { "aria-hidden": true, className: "bg-destructive absolute inset-y-0 w-px", style: { left: `${breachPct}%` } })] })] }));
-}
+import{jsx as s,jsxs as a}from"react/jsx-runtime";import{OctagonX as E,ShieldCheck as k,TriangleAlert as D}from"lucide-react";import{LABEL_VOICE_CLASS as M}from"../../lib/typography.js";import{cn as m}from"../../lib/utils.js";import{Figure as O}from"../figure/index.js";import{formatCount as S,formatPercent as w,NO_VALUE as T}from"../format.js";import{MoneyText as $}from"../money-text/index.js";const y={low:{Icon:k,tint:"text-system-success-h1a",word:"Dentro do limite"},warn:{Icon:D,tint:"text-system-alert-h1a",word:"Pr\xF3ximo do limite"},breach:{Icon:E,tint:"text-system-error-h1a",word:"Limite ultrapassado"}};const z={low:"bg-system-success",warn:"bg-system-alert",breach:"bg-destructive"};export function gaugeBand(e,r,n){if(!Number.isFinite(e))return"low";const{warn:t,breach:c,edges:o="strict"}=r;const l=n==="higher-is-worse"?i=>o==="inclusive"?e>=i:e>i:i=>o==="inclusive"?e<=i:e<i;if(l(c))return"breach";if(l(t))return"warn";return"low"}function f(e){return e!=null&&e.trim()!==""?e:void 0}function h(e,r,n){if(!Number.isFinite(e)||n<=r)return 0;const t=Math.max(r,Math.min(n,e));return(t-r)/(n-r)}function V(e,r,n,t){if(!Number.isFinite(e))return T;if(r==="money"){return s($,{amount:e,currency:n,signColor:false,locale:t})}if(r==="percent")return w(e,{unit:"percent",locale:t});if(r==="ratio")return w(e,{unit:"ratio",locale:t});return S(e,t)}export function ThresholdGauge({value:e,displayValue:r,min:n=0,max:t,warn:c,breach:o,edges:l,direction:i,format:N="percent",currency:g,locale:x,label:F,ariaLabel:L,bandLabels:A,className:I}){const d=gaugeBand(e,{warn:c,breach:o,edges:l},i);const{Icon:_,tint:p}=y[d];const b=f(A?.[d])??y[d].word;const u=f(F);const j=f(L)??u??b;const C=h(e,n,t)*100;const P=h(c,n,t)*100;const B=h(o,n,t)*100;return a("div",{className:m("flex flex-col gap-2",I),children:[a("div",{className:"flex items-baseline justify-between gap-3",children:[u!=null?s("span",{className:M,children:u}):s("span",{}),a("span",{className:m("inline-flex items-center gap-1.5",p),children:[s(_,{"aria-hidden":true,className:"size-4 shrink-0"}),a("span",{className:"sr-only",children:[b,": "]}),s(O,{size:"row",className:p,children:V(r??e,N,g,x)})]})]}),a("div",{role:"meter","aria-valuenow":Number.isFinite(e)?e:void 0,"aria-valuemin":n,"aria-valuemax":t,"aria-label":j,className:"border-border bg-muted relative h-2 w-full overflow-hidden rounded-full border",children:[s("div",{"aria-hidden":true,className:m("absolute inset-y-0 left-0 rounded-full",z[d]),style:{width:`${C}%`}}),s("span",{"aria-hidden":true,className:"bg-system-alert absolute inset-y-0 w-px",style:{left:`${P}%`}}),s("span",{"aria-hidden":true,className:"bg-destructive absolute inset-y-0 w-px",style:{left:`${B}%`}})]})]})}

package/dist/esm/enterprise/alert-banner/index.js

@@ -1,21 +1 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { cn } from '../../lib/utils.js';
-/** Container tint + border per tone. The title color is applied separately so
- *  the body copy stays high-contrast foreground. */
-const TONE_CONTAINER = {
-    destructive: 'border-system-error-border bg-system-error-surface',
-    warning: 'border-system-alert-border bg-system-alert-surface',
-    info: 'border-system-info-border bg-system-info-surface',
-    success: 'border-system-success-border bg-system-success-surface',
-    neutral: 'border-border bg-muted/50'
-};
-const TONE_TITLE = {
-    destructive: 'text-system-error-text',
-    warning: 'text-system-alert-text',
-    info: 'text-system-info-text',
-    success: 'text-system-success-text',
-    neutral: 'text-foreground'
-};
-export function AlertBanner({ tone = 'neutral', title, children, detail, icon, className, ...props }) {
-    return (_jsxs("div", { ...props, role: "alert", "data-tone": tone, className: cn('flex gap-3 rounded-md border px-4 py-3', TONE_CONTAINER[tone], className), children: [icon != null ? (_jsx("span", { className: cn('mt-0.5 shrink-0', TONE_TITLE[tone]), "aria-hidden": true, children: icon })) : null, _jsxs("div", { className: "min-w-0 flex-1 space-y-1", children: [title != null ? (_jsx("p", { className: cn('text-sm font-medium', TONE_TITLE[tone]), children: title })) : null, children != null ? (_jsx("div", { className: "text-foreground text-xs leading-relaxed", children: children })) : null, detail != null ? (_jsx("pre", { className: "text-muted-foreground overflow-x-auto font-mono text-xs break-words whitespace-pre-wrap", children: detail })) : null] })] }));
-}
+import{jsx as r,jsxs as l}from"react/jsx-runtime";import{cn as s}from"../../lib/utils.js";const m={destructive:"border-system-error-border bg-system-error-surface",warning:"border-system-alert-border bg-system-alert-surface",info:"border-system-info-border bg-system-info-surface",success:"border-system-success-border bg-system-success-surface",neutral:"border-border bg-muted/50"};const d={destructive:"text-system-error-text",warning:"text-system-alert-text",info:"text-system-info-text",success:"text-system-success-text",neutral:"text-foreground"};export function AlertBanner({tone:e="neutral",title:t,children:n,detail:a,icon:o,className:u,...c}){return l("div",{...c,role:"alert","data-tone":e,className:s("flex gap-3 rounded-md border px-4 py-3",m[e],u),children:[o!=null?r("span",{className:s("mt-0.5 shrink-0",d[e]),"aria-hidden":true,children:o}):null,l("div",{className:"min-w-0 flex-1 space-y-1",children:[t!=null?r("p",{className:s("text-sm font-medium",d[e]),children:t}):null,n!=null?r("div",{className:"text-foreground text-xs leading-relaxed",children:n}):null,a!=null?r("pre",{className:"text-muted-foreground overflow-x-auto font-mono text-xs break-words whitespace-pre-wrap",children:a}):null]})]})}

package/dist/esm/enterprise/app-shell/index.js

@@ -1,51 +1 @@
-'use client';
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/**
- * AppShell — the console frame: a sidebar rail, an optional sticky header row,
- * and a centered, scrollable content column. This is the whole screen, not a
- * fragment, so it deliberately OWNS the SidebarProvider — the consumer drops a
- * sindarian-ui sidebar (`SidebarRoot` + its parts) into `sidebar` and a
- * `SidebarExpandButton` into `header`, and the collapse behavior comes free,
- * no extra wrapper required.
- *
- * Landmark contract (the a11y-correct frame):
- *   SidebarProvider
- *     div (the shell ROW — carries `className`)
- *       a.sr-only (skip link, if labelled)    // FIRST focusable in the document,
- *                                             //   targets <main> — bypasses the nav
- *       {sidebar}
- *       div[data-slot=sidebar-inset]          // the inset COLUMN — a plain div
- *         header (banner, if given)           // SIBLING of <main>, not nested
- *         main#<id> tabIndex=-1               // the ONE main: skip-linkable + ref-able
- *           div (centered content container) → {children}
- *
- * The skip link is the FIRST child inside the shell row — before the sidebar —
- * so a keyboard user's very first Tab lands on it and Enter jumps past the
- * entire nav to the content <main>. That is the whole point of WCAG 2.4.1
- * "Bypass Blocks": a skip link placed AFTER the nav would be reached only after
- * tabbing through every nav item, defeating its purpose. The inset column is a
- * <div>, not a <main>, so AppShell can own the single inner <main> for the
- * content. The page header passed via `header` becomes a top-level banner
- * SIBLING of <main> (one banner); a PageHeader rendered inside `children` lands
- * inside <main> and is content, not a top-level landmark.
- *
- * Client by construction: it calls React.useId() to wire the skip link to the
- * content <main>, and forwards a ref to that <main> so a consumer can focus it
- * on route change — both are client concerns, hence the "use client" directive.
- */
-import * as React from 'react';
-import { SidebarProvider } from '../../components/ui/sidebar/index.js';
-import { cn } from '../../lib/utils.js';
-export const AppShell = React.forwardRef(function AppShell({ sidebar, header, headerLabel, children, className, contentClassName, skipToContentLabel }, ref) {
-    // The content <main> id — wires the skip link to its target and gives the
-    // <main> a stable, focusable anchor. Internal: no consumer-facing id prop.
-    const mainId = React.useId();
-    // sindarian-ui's SidebarProvider is context-only (it renders no DOM and
-    // takes no className), so the shell owns the flex row itself and `className`
-    // lands on it — the same element the legacy provider's className reached.
-    return (_jsx(SidebarProvider, { children: _jsxs("div", { className: cn('flex h-svh w-full overflow-hidden', className), children: [skipToContentLabel ? (_jsx("a", { href: `#${mainId}`, className: "focus:bg-background focus:text-foreground sr-only focus:not-sr-only focus:absolute focus:z-50 focus:m-2 focus:rounded focus:px-3 focus:py-2 focus:shadow", children: skipToContentLabel })) : null, sidebar, _jsxs("div", { "data-slot": "sidebar-inset", className: "bg-background relative flex w-full min-w-0 flex-1 flex-col", children: [header ? (_jsx("header", { "aria-label": headerLabel, className: "border-border bg-background sticky top-0 z-10 flex items-center gap-3 border-b px-6 py-3", children: header })) : null, _jsx("main", { id: mainId, ref: ref, tabIndex: -1, 
-                            // min-h-0 lets this flex child shrink below its content height —
-                            // without it `flex-1` keeps min-height:auto and nothing scrolls.
-                            className: "min-h-0 flex-1 overflow-y-auto outline-none", children: _jsx("div", { className: cn('mx-auto w-full max-w-7xl px-6 py-8 lg:px-8', contentClassName), children: children }) })] })] }) }));
-});
-AppShell.displayName = 'AppShell';
+"use client";import{jsx as e,jsxs as s}from"react/jsx-runtime";import*as a from"react";import{SidebarProvider as m}from"../../components/ui/sidebar/index.js";import{cn as c}from"../../lib/utils.js";export const AppShell=a.forwardRef(function p({sidebar:n,header:l,headerLabel:d,children:f,className:i,contentClassName:u,skipToContentLabel:o},t){const r=a.useId();return e(m,{children:s("div",{className:c("flex h-svh w-full overflow-hidden",i),children:[o?e("a",{href:`#${r}`,className:"focus:bg-background focus:text-foreground sr-only focus:not-sr-only focus:absolute focus:z-50 focus:m-2 focus:rounded focus:px-3 focus:py-2 focus:shadow",children:o}):null,n,s("div",{"data-slot":"sidebar-inset",className:"bg-background relative flex w-full min-w-0 flex-1 flex-col",children:[l?e("header",{"aria-label":d,className:"border-border bg-background sticky top-0 z-10 flex items-center gap-3 border-b px-6 py-3",children:l}):null,e("main",{id:r,ref:t,tabIndex:-1,className:"min-h-0 flex-1 overflow-y-auto outline-none",children:e("div",{className:c("mx-auto w-full max-w-7xl px-6 py-8 lg:px-8",u),children:f})})]})]})})});AppShell.displayName="AppShell";

package/dist/esm/enterprise/cursor-pager/index.js

@@ -1,23 +1 @@
-'use client';
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/**
- * CursorPager drives the cursor-pagination envelope
- *   { items, hasMore, nextCursor, prevCursor, limit }
- * shared by the console's cursor-paged list endpoints (do not use it on
- * offset-based endpoints).
- *
- * It is controlled: the parent owns the active cursor (the value it passes to
- * the list hook) and reacts to `onCursorChange`. Pass the page envelope's
- * `hasMore`, `nextCursor`, `prevCursor`. "Previous" is enabled when the page
- * reports a `prevCursor`; "Next" when `hasMore` and a `nextCursor` exist.
- *
- * `onCursorChange(undefined)` requests the first page (no cursor).
- */
-import { ChevronLeft, ChevronRight } from 'lucide-react';
-import { Button } from '../../components/ui/button/index.js';
-import { cn } from '../../lib/utils.js';
-export function CursorPager({ hasMore, nextCursor, prevCursor, onCursorChange, disabled = false, summary, previousLabel = 'Previous', nextLabel = 'Next', className }) {
-    const canPrev = !disabled && !!prevCursor;
-    const canNext = !disabled && !!hasMore && !!nextCursor;
-    return (_jsxs("div", { className: cn('flex items-center justify-between gap-4 pt-3', className), children: [_jsx("p", { className: "text-muted-foreground text-xs", children: summary ?? '' }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Button, { type: "button", variant: "outline", size: "small", icon: _jsx(ChevronLeft, { "aria-hidden": true }), iconPlacement: "start", disabled: !canPrev, onClick: () => onCursorChange(prevCursor ?? undefined), children: previousLabel }), _jsx(Button, { type: "button", variant: "outline", size: "small", icon: _jsx(ChevronRight, { "aria-hidden": true }), iconPlacement: "end", disabled: !canNext, onClick: () => onCursorChange(nextCursor ?? undefined), children: nextLabel })] })] }));
-}
+"use client";import{jsx as e,jsxs as r}from"react/jsx-runtime";import{ChevronLeft as x,ChevronRight as p}from"lucide-react";import{Button as s}from"../../components/ui/button/index.js";import{cn as h}from"../../lib/utils.js";export function CursorPager({hasMore:c,nextCursor:t,prevCursor:n,onCursorChange:i,disabled:a=false,summary:o,previousLabel:l="Previous",nextLabel:d="Next",className:m}){const u=!a&&!!n;const f=!a&&!!c&&!!t;return r("div",{className:h("flex items-center justify-between gap-4 pt-3",m),children:[e("p",{className:"text-muted-foreground text-xs",children:o??""}),r("div",{className:"flex items-center gap-2",children:[e(s,{type:"button",variant:"outline",size:"small",icon:e(x,{"aria-hidden":true}),iconPlacement:"start",disabled:!u,onClick:()=>i(n??void 0),children:l}),e(s,{type:"button",variant:"outline",size:"small",icon:e(p,{"aria-hidden":true}),iconPlacement:"end",disabled:!f,onClick:()=>i(t??void 0),children:d})]})]})}