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

package/dist/esm/domain/delinquency-aging/index.js

@@ -1,218 +1 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/**
- * DelinquencyAging — a loan/receivable delinquency surface: the ordered overdue
- * aging distribution PLUS the headline delinquency rate (the share of portfolio
- * value that is past due).
- *
- *   <DelinquencyAging
- *     currency="BRL"
- *     locale="pt-BR"
- *     warn={0.05}
- *     breach={0.1}
- *     buckets={[
- *       { label: 'A vencer', count: 312, total: '1840500.00', overdue: false },
- *       { label: '1–30',     count: 84,  total: '402300.00',  overdue: true },
- *       { label: '31–60',    count: 21,  total: '118900.00',  overdue: true },
- *       { label: '61–90',    count: 9,   total: '54200.00',   overdue: true },
- *       { label: '90+',      count: 4,   total: '38100.00',   overdue: true }
- *     ]}
- *   />
- *
- * The distribution is delegated whole to `AgingBuckets`: it owns the ordered
- * current → 90+ schedule, the per-bucket count/total, the ordinal band cue, and
- * the money-math-exact grand total. This composite adds only the one fact aging
- * alone does not state — the delinquency RATE.
- *
- * THIRD RAIL (money): the rate is overdueTotal / portfolioTotal, and BOTH totals
- * are summed in integer minor units (BigInt, at the currency's CLDR scale) via
- * `money-math` — never an IEEE-754 sum of decimals (0.1 + 0.2 ≠ 0.3 in float, a
- * silent basis-point error on a portfolio). The single floating-point operation
- * is the FINAL division of two already-exact integers, which is the correct,
- * lossless-enough place for it (a ratio is not money). A zero portfolio yields a
- * null rate — an explicit empty readout, never a NaN. A single unparseable
- * bucket total poisons the rate to indeterminate rather than reporting a wrong
- * share.
- *
- * NON-COLOR CUE (WCAG 1.4.1): the rate band (healthy / elevated / distressed) is
- * resolved through the gauge's strict-edge `gaugeBand` (higher-is-worse: more
- * overdue is worse) and named with a glyph + an sr-only word + a tint — the tint
- * is reinforcement only, so the band survives grayscale and color-vision
- * deficiency. A distressed rate reads loud (credit-red, role='alert').
- *
- * Pure display: no directive, no interactivity, server-safe for RSC.
- */
-import { AlertOctagon, 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 { formatPercent, NO_VALUE } from '../format.js';
-import { minorDigitsOf, toMinor } from '../money-math.js';
-import { SectionLabel } from '../section-label/index.js';
-import { AgingBuckets } from './aging-buckets.js';
-/** Fixed-point scale for the rate division: 1e12 keeps twelve decimal places of
- *  a 0..1 ratio, and both it and any in-range scaled quotient stay well inside
- *  the exact-integer range of a double (2^53), so the conversion is lossless. */
-const RATE_PRECISION = 1000000000000n;
-/**
- * THIRD RAIL: the delinquency rate = overdue total / portfolio total, with both
- * totals summed through integer minor units (BigInt) at `scale`. The only float
- * operation is the final division of two EXACT integers — never a float sum of
- * decimals. A zero portfolio gives a null rate (explicit empty, no NaN); an
- * unparseable total poisons everything to indeterminate. Pure: unit-tested.
- *
- * Internal: exported for its unit tests, never from `src/domain/index.ts`.
- */
-export function delinquencyRate(buckets, scale) {
-    // Parse each bucket exactly once: the sums and the per-bucket SIGN check both
-    // come off the same pass, so the two can never disagree about the same input.
-    const parsed = buckets.map((b) => toMinor(b.total, scale));
-    if (parsed.some((m) => m === null)) {
-        return {
-            rate: null,
-            overdueMinor: null,
-            totalMinor: null,
-            indeterminate: true
-        };
-    }
-    let totalMinor = 0n;
-    let overdueMinor = 0n;
-    let hasNegativeBucket = false;
-    parsed.forEach((m, i) => {
-        const minor = m;
-        if (minor < 0n)
-            hasNegativeBucket = true;
-        totalMinor += minor;
-        if (buckets[i].overdue)
-            overdueMinor += minor;
-    });
-    // A NEGATIVE bucket total is parseable but not interpretable as a share of a
-    // portfolio: overdue/total stops being bounded by 0..1 the moment a component
-    // is negative (a -50 current band against a 100 overdue band yields "200%
-    // delinquent"), and it can also cancel the denominator toward zero. A credit
-    // adjustment is real data, but it is not aging data, so the honest answer is
-    // that the RATE cannot be determined — the sums stay, since they are still
-    // correct, and the readout takes the no-value path. Legacy divided anyway and
-    // printed the out-of-range percentage.
-    if (hasNegativeBucket) {
-        return { rate: null, overdueMinor, totalMinor, indeterminate: true };
-    }
-    // A zero portfolio has no rate to report — null, never overdueMinor/0 (NaN).
-    if (totalMinor === 0n) {
-        return { rate: null, overdueMinor, totalMinor, indeterminate: false };
-    }
-    // The division is done as a BOUNDED BigInt ratio first, then converted once.
-    // Converting the two totals to Number separately overflowed on a large
-    // portfolio: past ~1.8e308 each side becomes Infinity and Infinity/Infinity is
-    // NaN — a portfolio big enough to matter reported no rate at all. Scaling the
-    // numerator by RATE_PRECISION keeps the quotient the size of a ratio (not the
-    // size of the money), so the single Number() sees a value it can hold exactly.
-    const scaled = (overdueMinor * RATE_PRECISION) / totalMinor;
-    const rate = Number(scaled) / Number(RATE_PRECISION);
-    // A ratio that still cannot be represented is no rate at all — the readout
-    // shows the no-value placeholder rather than a NaN/Infinity artifact.
-    if (!Number.isFinite(rate)) {
-        return { rate: null, overdueMinor, totalMinor, indeterminate: false };
-    }
-    return { rate, overdueMinor, totalMinor, indeterminate: false };
-}
-/** Fixed-point scale for comparing the ratio against a float threshold as exact
- *  integers. 1e18 is well past the ~1e-16 relative precision a double carries,
- *  so the comparison is exact to the limit of the threshold value itself. */
-const THRESHOLD_SCALE = 10n ** 18n;
-/**
- * THIRD RAIL: `overdue / total > threshold`, decided on EXACT integers.
- *
- * The float `rate` is a TRUNCATED view of the ratio — RATE_PRECISION drops every
- * digit past 1e-12 — so a rate a hair ABOVE a threshold rounds down onto it, and
- * the strict-edge rule then reads it as the calmer band. 500000000001 /
- * 10000000000000 is 0.0500000000001, genuinely past a 0.05 warn edge, and
- * truncates to exactly 0.05, which reported "Saudável" on a portfolio that had
- * crossed into "Elevada". Cross-multiplying keeps the comparison in integers,
- * where no digit is dropped.
- */
-function ratioExceeds(overdue, total, threshold) {
-    // A non-finite threshold is no threshold: nothing can be past it.
-    if (!Number.isFinite(threshold))
-        return false;
-    // Scaling overflows to ±Infinity for a threshold that is finite but huge —
-    // 1e300 is enough, MAX_VALUE certainly — and `BigInt(Infinity)` throws a
-    // RangeError, mid-render, taking the surface down. Both overflow directions
-    // have an EXACT answer, so this degrades to the right result rather than a
-    // merely safe one: an overflowed positive threshold is one no 0..1 ratio could
-    // ever reach (not exceeded), an overflowed negative one sits below every ratio
-    // (always exceeded).
-    const scaled = Math.round(threshold * Number(THRESHOLD_SCALE));
-    if (!Number.isFinite(scaled))
-        return scaled < 0;
-    let scaledInt = BigInt(scaled);
-    // A threshold FINER than one unit of the scale rounds to zero, and a zero
-    // threshold means "anything above zero is past it" — the exact opposite of what
-    // a tiny positive threshold asks for. 4e-19 scaled to 0, so a ratio of 1e-19
-    // was reported as exceeding it. Clamp to one unit instead, keeping the sign, so
-    // a sub-scale threshold behaves as the finest one this comparison supports.
-    //
-    // ponytail: the floor is 1e-18 (THRESHOLD_SCALE), so a threshold between 0 and
-    // 1e-18 is treated as 1e-18 and a ratio in that sliver reads calmer than the
-    // literal number asks. Immaterial for a delinquency ratio — a portfolio would
-    // need ~1e18 currency units for one minor unit to land there — and the honest
-    // alternative is exact rational threshold conversion, which buys nothing real.
-    // An EXACT zero is left alone: every positive ratio does exceed it.
-    if (scaledInt === 0n && threshold !== 0) {
-        scaledInt = threshold < 0 ? -1n : 1n;
-    }
-    return overdue * THRESHOLD_SCALE > scaledInt * total;
-}
-/**
- * The rate band, resolved from the exact minor-unit ratio. Mirrors `gaugeBand`'s
- * higher-is-worse STRICT-edge canon (a ratio exactly ON a threshold stays in the
- * calmer band) rather than calling it: `gaugeBand` takes a float, and handing it
- * the truncated rate is precisely the defect above.
- */
-function exactBand(overdue, total, warn, breach) {
-    if (ratioExceeds(overdue, total, breach))
-        return 'breach';
-    if (ratioExceeds(overdue, total, warn))
-        return 'warn';
-    return 'low';
-}
-/** 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. Mirrors the gauge's three-band canon, renamed
- *  to the delinquency vocabulary.
- *
- *  The tint is an INK token (`-h1a`), because it is painted on the `Figure`
- *  below as well as on the glyph. The bare fill tokens read 1.78:1
- *  (`--system-alert`) and 3.35:1 (`--system-success`) on every light surface in
- *  the kit — the alert one under even the 3:1 floor a glyph answers to. */
-const RATE_BAND = {
-    low: { Icon: ShieldCheck, tint: 'text-system-success-h1a', word: 'Saudável' },
-    warn: { Icon: TriangleAlert, tint: 'text-system-alert-h1a', word: 'Elevada' },
-    breach: { Icon: AlertOctagon, tint: 'text-credit', word: 'Em estresse' }
-};
-export function DelinquencyAging({ buckets, currency, locale, rateLabel = 'Inadimplência', rateBandLabels, emptyLabel = 'sem carteira', indeterminateLabel = 'indeterminada', bucketLabels, warn = 0.05, breach = 0.1, showTotal = false, healthyTone = 'success', className }) {
-    // THIRD RAIL: the rate scale and the two totals come from money-math, never
-    // float. The division below is of two exact BigInt-derived integers.
-    const scale = currency ? minorDigitsOf(currency) : 2;
-    const { rate, overdueMinor, totalMinor, indeterminate } = delinquencyRate(buckets, scale);
-    // The band is only meaningful when there is a rate; an empty/indeterminate
-    // portfolio has no band to name (rendered as the explicit no-value readout).
-    const hasRate = rate !== null;
-    // higher-is-worse: more value past due is worse. The band comes off the EXACT
-    // minor-unit ratio, never `rate` — that float is truncated at 1e-12 and is for
-    // DISPLAY only (one decimal place, where the truncation cannot show).
-    const band = hasRate && overdueMinor !== null && totalMinor !== null
-        ? exactBand(overdueMinor, totalMinor, warn, breach)
-        : 'low';
-    const { Icon, word } = RATE_BAND[band];
-    // `ink` retones ONLY the healthy band; `warn`/`breach` keep their alarm tints.
-    const tint = healthyTone === 'ink' && band === 'low'
-        ? 'text-foreground'
-        : RATE_BAND[band].tint;
-    // Shallow merge: an unlisted band keeps its pt-BR default.
-    const bandWord = rateBandLabels?.[band] ?? word;
-    const distressed = band === 'breach';
-    return (_jsxs("div", { className: cn('flex flex-col gap-4', className), children: [_jsxs("header", { className: "flex items-baseline justify-between gap-3", children: [_jsx(SectionLabel, { as: "span", children: rateLabel }), hasRate ? (_jsxs("span", { 
-                        // A distressed rate is a credit alarm: announced the moment it
-                        // crosses the band, so assistive tech does not lean on the tint.
-                        role: distressed ? 'alert' : undefined, 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: [bandWord, ": "] }), _jsx(Figure, { size: "row", className: tint, children: formatPercent(rate, { unit: 'ratio', locale }) })] })) : (_jsxs("span", { className: "text-muted-foreground inline-flex items-center gap-1.5", children: [_jsx("span", { className: LABEL_VOICE_CLASS, children: indeterminate ? indeterminateLabel : emptyLabel }), _jsx(Figure, { size: "row", className: "text-muted-foreground", children: NO_VALUE })] }))] }), _jsx(AgingBuckets, { buckets: buckets, currency: currency, locale: locale, showTotal: showTotal, labels: bucketLabels, healthyTone: healthyTone })] }));
-}
+import{jsx as s,jsxs as c}from"react/jsx-runtime";import{AlertOctagon as y,ShieldCheck as C,TriangleAlert as T}from"lucide-react";import{LABEL_VOICE_CLASS as k}from"../../lib/typography.js";import{cn as w}from"../../lib/utils.js";import{Figure as E}from"../figure/index.js";import{formatPercent as D,NO_VALUE as F}from"../format.js";import{minorDigitsOf as z,toMinor as q}from"../money-math.js";import{SectionLabel as H}from"../section-label/index.js";import{AgingBuckets as P}from"./aging-buckets.js";const A=1000000000000n;export function delinquencyRate(r,i){const n=r.map(a=>q(a.total,i));if(n.some(a=>a===null)){return{rate:null,overdueMinor:null,totalMinor:null,indeterminate:true}}let e=0n;let t=0n;let m=false;n.forEach((a,f)=>{const o=a;if(o<0n)m=true;e+=o;if(r[f].overdue)t+=o});if(m){return{rate:null,overdueMinor:t,totalMinor:e,indeterminate:true}}if(e===0n){return{rate:null,overdueMinor:t,totalMinor:e,indeterminate:false}}const d=t*A/e;const u=Number(d)/Number(A);if(!Number.isFinite(u)){return{rate:null,overdueMinor:t,totalMinor:e,indeterminate:false}}return{rate:u,overdueMinor:t,totalMinor:e,indeterminate:false}}const I=10n**18n;function M(r,i,n){if(!Number.isFinite(n))return false;const e=Math.round(n*Number(I));if(!Number.isFinite(e))return e<0;let t=BigInt(e);if(t===0n&&n!==0){t=n<0?-1n:1n}return r*I>t*i}function V(r,i,n,e){if(M(r,i,e))return"breach";if(M(r,i,n))return"warn";return"low"}const S={low:{Icon:C,tint:"text-system-success-h1a",word:"Saud\xE1vel"},warn:{Icon:T,tint:"text-system-alert-h1a",word:"Elevada"},breach:{Icon:y,tint:"text-credit",word:"Em estresse"}};export function DelinquencyAging({buckets:r,currency:i,locale:n,rateLabel:e="Inadimpl\xEAncia",rateBandLabels:t,emptyLabel:m="sem carteira",indeterminateLabel:d="indeterminada",bucketLabels:u,warn:a=.05,breach:f=.1,showTotal:o=false,healthyTone:p="success",className:_}){const v=i?z(i):2;const{rate:x,overdueMinor:N,totalMinor:h,indeterminate:L}=delinquencyRate(r,v);const g=x!==null;const l=g&&N!==null&&h!==null?V(N,h,a,f):"low";const{Icon:B,word:O}=S[l];const b=p==="ink"&&l==="low"?"text-foreground":S[l].tint;const R=t?.[l]??O;const j=l==="breach";return c("div",{className:w("flex flex-col gap-4",_),children:[c("header",{className:"flex items-baseline justify-between gap-3",children:[s(H,{as:"span",children:e}),g?c("span",{role:j?"alert":void 0,className:w("inline-flex items-center gap-1.5",b),children:[s(B,{"aria-hidden":true,className:"size-4 shrink-0"}),c("span",{className:"sr-only",children:[R,": "]}),s(E,{size:"row",className:b,children:D(x,{unit:"ratio",locale:n})})]}):c("span",{className:"text-muted-foreground inline-flex items-center gap-1.5",children:[s("span",{className:k,children:L?d:m}),s(E,{size:"row",className:"text-muted-foreground",children:F})]})]}),s(P,{buckets:r,currency:i,locale:n,showTotal:o,labels:u,healthyTone:p})]})}

package/dist/esm/domain/figure/index.js

@@ -1,15 +1 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { cn } from '../../lib/utils.js';
-/** Canonical class strings per figure size. The `tabular-nums` invariant lives
- *  here so it can never be forgotten at a call site. */
-export const FIGURE_CLASS = {
-    hero: 'text-4xl font-semibold tracking-tight tabular-nums lg:text-5xl',
-    'money-hero': 'text-2xl font-semibold tracking-tight tabular-nums lg:text-3xl',
-    panel: 'text-3xl font-semibold tracking-tight tabular-nums',
-    count: 'text-2xl font-semibold tracking-tight tabular-nums',
-    row: 'text-sm tabular-nums',
-    tick: 'text-xs leading-none tabular-nums'
-};
-export function Figure({ size, children, className, as: Tag = 'span' }) {
-    return _jsx(Tag, { className: cn(FIGURE_CLASS[size], className), children: children });
-}
+import{jsx as r}from"react/jsx-runtime";import{cn as l}from"../../lib/utils.js";export const FIGURE_CLASS={hero:"text-4xl font-semibold tracking-tight tabular-nums lg:text-5xl","money-hero":"text-2xl font-semibold tracking-tight tabular-nums lg:text-3xl",panel:"text-3xl font-semibold tracking-tight tabular-nums",count:"text-2xl font-semibold tracking-tight tabular-nums",row:"text-sm tabular-nums",tick:"text-xs leading-none tabular-nums"};export function Figure({size:t,children:n,className:e,as:a="span"}){return r(a,{className:l(FIGURE_CLASS[t],e),children:n})}

package/dist/esm/domain/format.js

@@ -1,128 +1 @@
-/**
- * Ledger-kit formatting helpers. Pure functions, no React. `MoneyText` owns
- * monetary formatting; these cover percent, integer counts, and humanized
- * durations (e.g. an average resolution time arriving as milliseconds).
- */
-/** No-value placeholder. A middle dot reads as "empty" without an em dash, and
- * stays narrow enough not to disturb tabular alignment. */
-export const NO_VALUE = '·';
-/**
- * Whether a digit count is one `Intl.NumberFormat` (and `Number#toFixed`, and
- * `String#repeat`) will actually accept: a finite integer in 0..100. Anything
- * else — a negative, a fraction, NaN, Infinity — makes those constructors throw
- * a RangeError, which on a money surface means a blank screen instead of a
- * number. Every caller turns an invalid count into the no-value path instead.
- *
- * Internal: shared by `format`, `money-text` and `money-math` so the three
- * cannot drift on what "valid" means. Never exported from `src/domain/index.ts`.
- */
-export function isValidDigitCount(digits) {
-    return Number.isInteger(digits) && digits >= 0 && digits <= 100;
-}
-/**
- * A locale tag `Intl` will accept, or `undefined` — which every `Intl`
- * constructor reads as "the runtime locale", the documented default for every
- * `locale` prop in this layer.
- *
- * A structurally invalid tag makes EVERY `Intl` constructor throw a RangeError:
- * `''`, `'en_US'` (underscore for hyphen — the commonest mistake, and what a
- * POSIX `LANG` value looks like), a truncated tag out of a stored user
- * preference. Unguarded, that RangeError escapes during render, so one bad
- * preference string takes down the whole money surface instead of printing a
- * number with the wrong decimal mark. `Intl.getCanonicalLocales` rejects exactly
- * the tags the formatters reject, so it is the predicate rather than a
- * hand-rolled BCP 47 regex.
- *
- * The locale is the least important input to a figure — the DIGITS are the
- * point — so an unusable tag degrades to the runtime locale and the number still
- * renders.
- *
- * Internal: shared by `format`, `money-text` and `number-input` so they cannot
- * drift. Never exported from `src/domain/index.ts`.
- */
-export function safeLocale(locale) {
-    if (locale === undefined)
-        return undefined;
-    try {
-        Intl.getCanonicalLocales(locale);
-        return locale;
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * Format a rate as a percent string. `unit` is explicit, never inferred from
- * magnitude: 'ratio' (default) treats `value` as 0..1 and scales ×100;
- * 'percent' treats `value` as already 0..100.
- *
- * Uses Intl style:'percent' for correct rounding and a locale-aware decimal
- * mark. Intl multiplies its input by 100, so we always feed it the RATIO —
- * a 'percent' input is divided by 100 first.
- */
-export function formatPercent(value, options = {}) {
-    if (value === null || value === undefined || !Number.isFinite(value))
-        return NO_VALUE;
-    const { digits = 1, unit = 'ratio', locale } = options;
-    // A caller-supplied digit count reaches Intl directly; an out-of-range one
-    // would throw a RangeError and take the whole surface down with it.
-    if (!isValidDigitCount(digits))
-        return NO_VALUE;
-    const ratio = unit === 'percent' ? value / 100 : value;
-    return new Intl.NumberFormat(safeLocale(locale), {
-        style: 'percent',
-        minimumFractionDigits: digits,
-        maximumFractionDigits: digits
-    }).format(ratio);
-}
-/**
- * Normalize a rate to the 0..100 range for chart geometry. `unit` is explicit:
- * 'ratio' (default) scales a 0..1 input ×100; 'percent' is already 0..100.
- */
-export function toPercentValue(value, unit = 'ratio') {
-    if (value === null || value === undefined || !Number.isFinite(value))
-        return 0;
-    const pct = unit === 'percent' ? value : value * 100;
-    return Math.max(0, Math.min(100, pct));
-}
-/** Thousands-grouped integer count. `locale` defaults to the runtime locale. */
-export function formatCount(value, locale) {
-    if (value === null || value === undefined || !Number.isFinite(value))
-        return NO_VALUE;
-    return new Intl.NumberFormat(safeLocale(locale), {
-        maximumFractionDigits: 0
-    }).format(value);
-}
-/**
- * Humanize a millisecond duration into the largest two sensible units.
- * 0ms → "0s". Sub-minute → seconds. Otherwise the two most-significant
- * CONTIGUOUS d/h/m units from the largest non-zero unit down — so "2d 0h 5m"
- * renders as "2d 0h", not the misleading "2d 5m".
- *
- * Note: the d/h/m/s suffixes are English; localizing them is deferred.
- */
-export function humanizeDurationMs(ms) {
-    if (ms == null || !Number.isFinite(ms) || ms < 0)
-        return NO_VALUE;
-    if (ms === 0)
-        return '0s';
-    const totalSeconds = Math.round(ms / 1000);
-    if (totalSeconds < 60)
-        return `${totalSeconds}s`;
-    const days = Math.floor(totalSeconds / 86400);
-    const hours = Math.floor((totalSeconds % 86400) / 3600);
-    const minutes = Math.floor((totalSeconds % 3600) / 60);
-    // Two contiguous units starting at the largest non-zero unit, in order.
-    const units = [
-        [days, 'd'],
-        [hours, 'h'],
-        [minutes, 'm']
-    ];
-    const start = units.findIndex(([n]) => n > 0);
-    if (start === -1)
-        return `${minutes}m`;
-    return units
-        .slice(start, start + 2)
-        .map(([n, suffix]) => `${n}${suffix}`)
-        .join(' ');
-}
+export const NO_VALUE="\xB7";export function isValidDigitCount(t){return Number.isInteger(t)&&t>=0&&t<=100}export function safeLocale(t){if(t===void 0)return void 0;try{Intl.getCanonicalLocales(t);return t}catch{return void 0}}export function formatPercent(t,n={}){if(t===null||t===void 0||!Number.isFinite(t))return NO_VALUE;const{digits:r=1,unit:o="ratio",locale:i}=n;if(!isValidDigitCount(r))return NO_VALUE;const e=o==="percent"?t/100:t;return new Intl.NumberFormat(safeLocale(i),{style:"percent",minimumFractionDigits:r,maximumFractionDigits:r}).format(e)}export function toPercentValue(t,n="ratio"){if(t===null||t===void 0||!Number.isFinite(t))return 0;const r=n==="percent"?t:t*100;return Math.max(0,Math.min(100,r))}export function formatCount(t,n){if(t===null||t===void 0||!Number.isFinite(t))return NO_VALUE;return new Intl.NumberFormat(safeLocale(n),{maximumFractionDigits:0}).format(t)}export function humanizeDurationMs(t){if(t==null||!Number.isFinite(t)||t<0)return NO_VALUE;if(t===0)return"0s";const n=Math.round(t/1e3);if(n<60)return`${n}s`;const r=Math.floor(n/86400);const o=Math.floor(n%86400/3600);const i=Math.floor(n%3600/60);const e=[[r,"d"],[o,"h"],[i,"m"]];const u=e.findIndex(([c])=>c>0);if(u===-1)return`${i}m`;return e.slice(u,u+2).map(([c,f])=>`${c}${f}`).join(" ")}

package/dist/esm/domain/index.js

@@ -1,19 +1 @@
-// Owned by lane domain — see docs/plans/2026-08-26-sindarian-x-retirement/
-//
-// The finance domain grammar absorbed from @lerianstudio/sindarian-x@0.15.0.
-// Exports are NAMED (never `export *`) on purpose: the port census freezes the
-// public surface to exactly the symbols the four migrating apps import, and the
-// money-math internals (`toMinor`, `Amount`, `sumMinor`, `formatMoneyParts`,
-// `maskKeyId`, `AgingBuckets`, …) stay module-private so they never become an
-// API this package has to keep.
-export { NO_VALUE, formatCount, formatPercent, humanizeDurationMs, toPercentValue } from './format.js';
-export { moneyDiff } from './money-diff.js';
-export { MoneyText } from './money-text/index.js';
-export { FIGURE_CLASS, Figure } from './figure/index.js';
-export { SectionLabel } from './section-label/index.js';
-export { Blotter, BlotterRow } from './blotter/index.js';
-export { LedgerPanel, LedgerSheet } from './ledger-sheet/index.js';
-export { KeyId } from './key-id/index.js';
-export { Dot, LivePulse, StatusRail } from './status-rail/index.js';
-export { ThresholdGauge, gaugeBand } from './threshold-gauge/index.js';
-export { DelinquencyAging } from './delinquency-aging/index.js';
+export{NO_VALUE,formatCount,formatPercent,humanizeDurationMs,toPercentValue}from"./format.js";export{moneyDiff}from"./money-diff.js";export{MoneyText}from"./money-text/index.js";export{FIGURE_CLASS,Figure}from"./figure/index.js";export{SectionLabel}from"./section-label/index.js";export{Blotter,BlotterRow}from"./blotter/index.js";export{LedgerPanel,LedgerSheet}from"./ledger-sheet/index.js";export{KeyId}from"./key-id/index.js";export{Dot,LivePulse,StatusRail}from"./status-rail/index.js";export{ThresholdGauge,gaugeBand}from"./threshold-gauge/index.js";export{DelinquencyAging}from"./delinquency-aging/index.js";

package/dist/esm/domain/key-id/index.js

@@ -1,169 +1 @@
-'use client';
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/**
- * KeyId — a masked, copyable, traceable identifier for Brazilian rails: a Pix
- * key (CPF / CNPJ / email / phone / EVP-random), an End-to-End id (E2E), an
- * idempotency key, or a generic id.
- *
- * Two jobs at once. PII keys (CPF/CNPJ/email/phone) are masked by default so a
- * shared screen or a screenshot doesn't leak a person's document or contact —
- * the middle of a document is revealed, the identifying head/tail is dotted.
- * Long-but-not-secret ids (EVP/E2E/idempotency/generic) are merely truncated in
- * the MIDDLE so the head and tail — the parts an operator eyeballs against a
- * log — stay legible.
- *
- *   <KeyId value="529.982.247-25" kind="pix-cpf" label="Payer" copyable />
- *   <KeyId value="E32074158202406211200abc123def456" kind="e2e" copyable />
- *
- * The copy button always lifts the RAW, unmasked value to the clipboard — the
- * mask is a display concern, never a data one. The masked render and the copy
- * affordance are what make this a client component.
- */
-import { Check, Copy } from 'lucide-react';
-import { useState } from 'react';
-import { LABEL_VOICE_CLASS } from '../../lib/typography.js';
-import { cn } from '../../lib/utils.js';
-/** The dot used to redact a character. A bullet, not an asterisk: it reads as
- *  "hidden" without looking like a password field's shouting. */
-const DOT = '•';
-/** Kinds that carry PII and are masked by default. The id-shaped kinds are long
- *  but not secret, so they default to revealed (just truncated). */
-const PII_KINDS = new Set([
-    'pix-cpf',
-    'pix-cnpj',
-    'pix-email',
-    'pix-phone'
-]);
-/** Whether a kind masks by default (PII) — used when `mask` is not supplied.
- *  Internal: exported for its unit tests, never from `src/domain/index.ts`. */
-export function masksByDefault(kind) {
-    return PII_KINDS.has(kind);
-}
-/** Keep only the digits — Brazilian documents arrive punctuated or bare. */
-function digitsOf(value) {
-    return value.replace(/\D/g, '');
-}
-/**
- * Truncate the MIDDLE of a long value, keeping a head and tail so an operator
- * can eyeball it against a log. Short values are returned whole.
- */
-function truncateMiddle(value, head = 6, tail = 4) {
-    if (value.length <= head + tail + 1)
-        return value;
-    return `${value.slice(0, head)}…${value.slice(-tail)}`;
-}
-/**
- * The fallback for a PII value that is MALFORMED for its kind. It must not be
- * `truncateMiddle`: a short malformed value (a CPF missing a digit, a hand-typed
- * document, a name-shaped email that failed the `@` check) is returned WHOLE by
- * truncation, so the "masked" render leaks the very PII the mask exists to hide.
- * A fixed-width dot run reveals nothing — not the content, not even the length.
- *
- * DELIBERATE DIVERGENCE from sindarian-x@0.15.0, which truncated instead. It
- * costs the operator the ability to eyeball a malformed document against a log;
- * that is the correct trade, because the alternative is a screenshot with a real
- * CPF in it. An operator who needs the value passes `mask={false}` explicitly.
- */
-function redactPii() {
-    return DOT.repeat(6);
-}
-/** Mask all but the central block of a digit string, then re-punctuate it. */
-function maskCpf(value) {
-    const d = digitsOf(value);
-    if (d.length !== 11)
-        return redactPii();
-    // Reveal the middle two blocks (456.789), dot the leading block and check digits.
-    return `${DOT.repeat(3)}.${d.slice(3, 6)}.${d.slice(6, 9)}-${DOT.repeat(2)}`;
-}
-function maskCnpj(value) {
-    const d = digitsOf(value);
-    if (d.length !== 14)
-        return redactPii();
-    // Reveal the central registration blocks, dot the head and the check digits.
-    return `${DOT.repeat(2)}.${d.slice(2, 5)}.${d.slice(5, 8)}/${d.slice(8, 12)}-${DOT.repeat(2)}`;
-}
-function maskEmail(value) {
-    const at = value.indexOf('@');
-    if (at <= 0 || at === value.length - 1)
-        return redactPii();
-    // EXACTLY one '@', or it is not an address and the domain half cannot be
-    // trusted to be a domain. `a@private@domain.test` split on the FIRST '@' and
-    // published `private@domain.test` verbatim as the "domain" — the local part of
-    // a second address, revealed in a view whose whole purpose is to hide it.
-    // Malformed PII redacts, exactly like a wrong-length CPF.
-    if (value.indexOf('@', at + 1) !== -1)
-        return redactPii();
-    const first = value.slice(0, 1);
-    const domain = value.slice(at + 1);
-    return `${first}${DOT.repeat(3)}@${domain}`;
-}
-function maskPhone(value) {
-    const d = digitsOf(value);
-    // Expect a BR mobile in E.164-ish form: 55 + 2-digit area + 9 subscriber digits.
-    if (d.length !== 13 || !d.startsWith('55'))
-        return redactPii();
-    const area = d.slice(2, 4);
-    const last2 = d.slice(-2);
-    // Keep country + area, reveal the last two, dot the rest of the subscriber run.
-    return `+55 (${area}) ${DOT.repeat(5)}-${DOT.repeat(2)}${last2}`;
-}
-/**
- * Mask a key for display. PII kinds get a structured mask that reveals a
- * non-identifying middle and dots the rest; a value MALFORMED for its kind is
- * redacted outright (see `redactPii`) rather than truncated, so a mask can never
- * fall through to the raw secret. Id-shaped kinds are always middle-truncated
- * (long, not secret). The copy path never uses this — it always sends the raw
- * value.
- *
- * Internal: exported for its unit tests, never from `src/domain/index.ts`.
- */
-export function maskKeyId(value, kind) {
-    switch (kind) {
-        case 'pix-cpf':
-            return maskCpf(value);
-        case 'pix-cnpj':
-            return maskCnpj(value);
-        case 'pix-email':
-            return maskEmail(value);
-        case 'pix-phone':
-            return maskPhone(value);
-        default:
-            return truncateMiddle(value);
-    }
-}
-export function KeyId({ value, kind = 'generic', label, mask, copyable = false, className }) {
-    const masked = mask ?? masksByDefault(kind);
-    const display = masked ? maskKeyId(value, kind) : truncateMiddle(value);
-    return (_jsxs("span", { className: cn('inline-flex min-w-0 items-center gap-2', className), children: [label ? (_jsx("span", { className: cn(LABEL_VOICE_CLASS, 'shrink-0 text-xs'), children: label })) : null, _jsx("span", { className: "text-foreground truncate font-mono text-xs tabular-nums", 
-                // The raw value as a tooltip only when nothing is hidden — never leak a
-                // masked PII value through the title attribute.
-                title: masked ? undefined : value, children: display }), copyable ? _jsx(CopyValue, { value: value }) : null] }));
-}
-/** The copy affordance: lifts the RAW value to the clipboard and flips to a
- *  check for a beat. The transient confirmation is announced for assistive tech;
- *  the icon is paired with a text aria-label so the state isn't color-only. */
-function CopyValue({ value }) {
-    const [copied, setCopied] = useState(false);
-    const copy = () => {
-        // ponytail: best-effort clipboard write — no toast, no error surface. The
-        // ceiling is silent failure in an insecure context (clipboard unavailable);
-        // upgrade path is to lift a result up via an onCopy callback when a caller
-        // needs to react.
-        //
-        // The rejection handler is NOT optional: `writeText` rejects on a denied
-        // permission or a non-secure context, and an unhandled rejection in a render
-        // tree is a console error at best and a crashed handler at worst. On failure
-        // the button simply does not flip to the copied state, so the operator sees
-        // that nothing was copied rather than a false confirmation.
-        void navigator.clipboard
-            ?.writeText(value)
-            .then(() => {
-            setCopied(true);
-            setTimeout(() => setCopied(false), 1500);
-        })
-            .catch(() => {
-            setCopied(false);
-        });
-    };
-    return (_jsx("button", { type: "button", onClick: copy, "aria-label": copied ? 'Copiado para a área de transferência' : 'Copiar valor', className: "text-muted-foreground hover:text-foreground focus:ring-ring inline-flex size-5 shrink-0 items-center justify-center rounded-sm transition-colors duration-150 ease-out focus:ring-2 focus:outline-none", children: copied ? (_jsx(Check, { "aria-hidden": true, className: "text-system-success-h1a size-3" })) : (_jsx(Copy, { "aria-hidden": true, className: "size-3" })) }));
-}
+"use client";import{jsx as i,jsxs as m}from"react/jsx-runtime";import{Check as x,Copy as h}from"lucide-react";import{useState as $}from"react";import{LABEL_VOICE_CLASS as g}from"../../lib/typography.js";import{cn as u}from"../../lib/utils.js";const r="\u2022";const C=new Set(["pix-cpf","pix-cnpj","pix-email","pix-phone"]);export function masksByDefault(e){return C.has(e)}function o(e){return e.replace(/\D/g,"")}function p(e,t=6,n=4){if(e.length<=t+n+1)return e;return`${e.slice(0,t)}\u2026${e.slice(-n)}`}function c(){return r.repeat(6)}function k(e){const t=o(e);if(t.length!==11)return c();return`${r.repeat(3)}.${t.slice(3,6)}.${t.slice(6,9)}-${r.repeat(2)}`}function y(e){const t=o(e);if(t.length!==14)return c();return`${r.repeat(2)}.${t.slice(2,5)}.${t.slice(5,8)}/${t.slice(8,12)}-${r.repeat(2)}`}function j(e){const t=e.indexOf("@");if(t<=0||t===e.length-1)return c();if(e.indexOf("@",t+1)!==-1)return c();const n=e.slice(0,1);const s=e.slice(t+1);return`${n}${r.repeat(3)}@${s}`}function N(e){const t=o(e);if(t.length!==13||!t.startsWith("55"))return c();const n=t.slice(2,4);const s=t.slice(-2);return`+55 (${n}) ${r.repeat(5)}-${r.repeat(2)}${s}`}export function maskKeyId(e,t){switch(t){case"pix-cpf":return k(e);case"pix-cnpj":return y(e);case"pix-email":return j(e);case"pix-phone":return N(e);default:return p(e)}}export function KeyId({value:e,kind:t="generic",label:n,mask:s,copyable:f=false,className:l}){const a=s??masksByDefault(t);const d=a?maskKeyId(e,t):p(e);return m("span",{className:u("inline-flex min-w-0 items-center gap-2",l),children:[n?i("span",{className:u(g,"shrink-0 text-xs"),children:n}):null,i("span",{className:"text-foreground truncate font-mono text-xs tabular-nums",title:a?void 0:e,children:d}),f?i(I,{value:e}):null]})}function I({value:e}){const[t,n]=$(false);const s=()=>{void navigator.clipboard?.writeText(e).then(()=>{n(true);setTimeout(()=>n(false),1500)}).catch(()=>{n(false)})};return i("button",{type:"button",onClick:s,"aria-label":t?"Copiado para a \xE1rea de transfer\xEAncia":"Copiar valor",className:"text-muted-foreground hover:text-foreground focus:ring-ring inline-flex size-5 shrink-0 items-center justify-center rounded-sm transition-colors duration-150 ease-out focus:ring-2 focus:outline-none",children:t?i(x,{"aria-hidden":true,className:"text-system-success-h1a size-3"}):i(h,{"aria-hidden":true,className:"size-3"})})}

package/dist/esm/domain/ledger-sheet/index.js

@@ -1,24 +1 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { cn } from '../../lib/utils.js';
-/** Tailwind needs literal class names to survive purge; map cols → class. */
-const COLS_CLASS = {
-    1: 'lg:grid-cols-1',
-    2: 'lg:grid-cols-2',
-    3: 'lg:grid-cols-3',
-    4: 'lg:grid-cols-4'
-};
-export function LedgerSheet({ children, cols = 1, className }) {
-    return (_jsx("div", { className: cn('border-border bg-border grid grid-cols-1 gap-px overflow-hidden rounded-lg border', COLS_CLASS[cols] ?? COLS_CLASS[1], className), children: children }));
-}
-/**
- * One cell of a ledger sheet. Flush — no own border or shadow — with `bg-card`,
- * internal `p-5` padding and `flex h-full flex-col gap-4` so panels stretch to
- * equal height. Start each panel with a `<SectionLabel>` as its heading.
- *
- * Remaining props land on the rendered element, so a composed panel can carry
- * its own `data-*` hooks (StatCard's `data-tone`, for one) without wrapping the
- * cell in an extra div that would break the hairline seams.
- */
-export function LedgerPanel({ children, className, as: Tag = 'section', ...rest }) {
-    return (_jsx(Tag, { className: cn('bg-card flex h-full flex-col gap-4 p-5', className), ...rest, children: children }));
-}
+import{jsx as l}from"react/jsx-runtime";import{cn as d}from"../../lib/utils.js";const g={1:"lg:grid-cols-1",2:"lg:grid-cols-2",3:"lg:grid-cols-3",4:"lg:grid-cols-4"};export function LedgerSheet({children:r,cols:e=1,className:o}){return l("div",{className:d("border-border bg-border grid grid-cols-1 gap-px overflow-hidden rounded-lg border",g[e]??g[1],o),children:r})}export function LedgerPanel({children:r,className:e,as:o="section",...c}){return l(o,{className:d("bg-card flex h-full flex-col gap-4 p-5",e),...c,children:r})}

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

@@ -1,45 +1 @@
-/**
- * moneyDiff — the signed difference between two reconciliation sides, computed
- * on integer minor units and never on floats.
- *
- * THIRD RAIL (money): `left − right` runs through `toMinor` on both operands →
- * BigInt subtraction → `minorToDecimal`, and the tolerance breach test compares
- * MAGNITUDES in minor units. A float subtraction of two decimals would drift by
- * a cent at reconciliation scale, which is the difference between a matched and
- * an unmatched pair.
- *
- * A null `decimal` means an unparseable operand — surfaced, never coerced to
- * zero, so a caller renders the no-value placeholder rather than a fabricated
- * tie.
- */
-import { minorDigitsOf, minorToDecimal, toMinor } from './money-math.js';
-export function moneyDiff(money) {
-    const scale = money.minorDigits ?? minorDigitsOf(money.currency);
-    const l = toMinor(money.left, scale);
-    const r = toMinor(money.right, scale);
-    if (l === null || r === null)
-        return { decimal: null, breach: false };
-    const diff = l - r;
-    // A tolerance that was SUPPLIED but does not parse ('', 'oops', '-.') is not
-    // the same thing as no tolerance at all. Degrading to the no-tolerance rule
-    // made every nonzero difference a breach, so one typo in a tolerance field
-    // turned a reconciled book into a screen of false breaches — the loudest
-    // possible wrong answer. A supplied-invalid tolerance is INDETERMINATE,
-    // exactly like an unparseable operand: no number, no verdict.
-    const supplied = money.tolerance != null;
-    const rawTol = supplied ? toMinor(money.tolerance, scale) : null;
-    if (supplied && rawTol === null)
-        return { decimal: null, breach: false };
-    // A tolerance is a BAND WIDTH, so only its magnitude is meaningful. Taken
-    // signed, a negative tolerance made `|diff| > tol` true for every value
-    // including an exact tie (0n > -5n), flagging perfectly reconciled pairs as
-    // breaches. Normalizing to the magnitude means `-0.05` and `0.05` describe the
-    // same band, which is the only reading of a negative tolerance that is not a
-    // silent false alarm.
-    const tol = rawTol === null ? null : rawTol < 0n ? -rawTol : rawTol;
-    const abs = diff < 0n ? -diff : diff;
-    // A breach is a magnitude STRICTLY beyond the band; no tolerance → no band, so
-    // any nonzero difference is itself the breach.
-    const breach = tol === null ? diff !== 0n : abs > tol;
-    return { decimal: minorToDecimal(diff, scale), breach };
-}
+import{minorDigitsOf as f,minorToDecimal as d,toMinor as c}from"./money-math.js";export function moneyDiff(l){const t=l.minorDigits??f(l.currency);const i=c(l.left,t);const o=c(l.right,t);if(i===null||o===null)return{decimal:null,breach:false};const n=i-o;const e=l.tolerance!=null;const r=e?c(l.tolerance,t):null;if(e&&r===null)return{decimal:null,breach:false};const s=r===null?null:r<0n?-r:r;const u=n<0n?-n:n;const a=s===null?n!==0n:u>s;return{decimal:d(n,t),breach:a}}