@lerianstudio/sindarian-ui 1.2.0 → 1.3.0-beta.1

package/dist/components/ui/toggle-group/index.js

@@ -0,0 +1,87 @@
+'use client';
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToggleGroup = ToggleGroup;
+exports.ToggleGroupItem = ToggleGroupItem;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const React = __importStar(require("react"));
+const ToggleGroupPrimitive = __importStar(require("@radix-ui/react-toggle-group"));
+const class_variance_authority_1 = require("class-variance-authority");
+const utils_1 = require("../../../lib/utils");
+/**
+ * Item styling for the group. Kept local: sindarian-ui has no standalone
+ * `Toggle` primitive and the retirement census does not ask for one, so the
+ * variants live with their only consumer instead of leaking a new export.
+ */
+const toggleVariants = (0, class_variance_authority_1.cva)("hover:bg-muted hover:text-muted-foreground focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 data-[state=on]:bg-accent data-[state=on]:text-accent-foreground dark:aria-invalid:ring-destructive/40 inline-flex items-center justify-center gap-2 rounded-md text-sm font-medium whitespace-nowrap transition-[color,box-shadow] outline-none focus-visible:ring-[3px] disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4", {
+    variants: {
+        variant: {
+            default: 'bg-transparent',
+            outline: 'border-input hover:bg-accent hover:text-accent-foreground border bg-transparent shadow-xs'
+        },
+        size: {
+            default: 'h-9 min-w-9 px-2',
+            sm: 'h-8 min-w-8 px-1.5',
+            lg: 'h-10 min-w-10 px-2.5'
+        }
+    },
+    defaultVariants: {
+        variant: 'default',
+        size: 'default'
+    }
+});
+const ToggleGroupContext = React.createContext({
+    size: 'default',
+    variant: 'default',
+    spacing: 0
+});
+function ToggleGroup({ className, variant, size, spacing = 0, children, style, ...props }) {
+    return ((0, jsx_runtime_1.jsx)(ToggleGroupPrimitive.Root, { "data-slot": "toggle-group", "data-variant": variant, "data-size": size, "data-spacing": spacing, 
+        // Caller style first: `--gap` is ours and must survive, but everything
+        // else the caller passes has to reach the element.
+        style: { ...style, '--gap': spacing }, className: (0, utils_1.cn)(
+        // Legacy carried a `data-[spacing=default]:...:shadow-xs` rule here that
+        // never matched — `data-spacing` is always a number. Removed rather than
+        // activated, so the rendered pixels stay identical to sindarian-x.
+        'group/toggle-group flex w-fit items-center gap-[--spacing(var(--gap))] rounded-md', className), ...props, children: (0, jsx_runtime_1.jsx)(ToggleGroupContext.Provider, { value: { variant, size, spacing }, children: children }) }));
+}
+function ToggleGroupItem({ className, children, variant, size, ...props }) {
+    const context = React.useContext(ToggleGroupContext);
+    return ((0, jsx_runtime_1.jsx)(ToggleGroupPrimitive.Item, { "data-slot": "toggle-group-item", "data-variant": context.variant || variant, "data-size": context.size || size, "data-spacing": context.spacing, className: (0, utils_1.cn)(toggleVariants({
+            variant: context.variant || variant,
+            size: context.size || size
+        }), 'w-auto min-w-0 shrink-0 px-3 focus:z-10 focus-visible:z-10', 'data-[spacing=0]:rounded-none data-[spacing=0]:shadow-none data-[spacing=0]:first:rounded-l-md data-[spacing=0]:last:rounded-r-md data-[spacing=0]:data-[variant=outline]:border-l-0 data-[spacing=0]:data-[variant=outline]:first:border-l', className), ...props, children: children }));
+}

package/dist/domain/blotter/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Blotter + BlotterRow — the mono key/value readout of the console.
+ *
+ * Clean key/value rows separated by hairline borders (`divide-y divide-border`)
+ * — no zebra fills. Each row: an uppercase 11px sans label on the left, a mono
+ * `tabular-nums` value on the right, `hover:bg-body-surface` as the quiet row
+ * affordance (the recessed page surface, one step behind `bg-card`, in both
+ * themes). Escalate the value color (`text-credit`, `text-system-alert`) only
+ * when a metric crosses a threshold.
+ *
+ *   <Blotter>
+ *     <BlotterRow label="Resolved on time" value="128" />
+ *     <BlotterRow label="Pending overdue" value="3" valueClassName="text-credit" />
+ *   </Blotter>
+ *
+ * Renders a `<dl>`; rows are `<div>`s with `<dt>`/`<dd>`.
+ */
+import type { ReactNode } from 'react';
+export type BlotterProps = {
+    children: ReactNode;
+    className?: string;
+};
+export declare function Blotter({ children, className }: BlotterProps): import("react").JSX.Element;
+export type BlotterRowProps = {
+    label: ReactNode;
+    value: ReactNode;
+    /** Threshold-escalation class on the value (e.g. `text-credit`). */
+    valueClassName?: string;
+    className?: string;
+    /**
+     * Stack the label above a full-width value instead of the inline
+     * label-left / value-right layout. Use for long-form prose (reasons,
+     * descriptions, notes) where a justified single line would squish the text.
+     * The value renders as wrapping sans body copy, not the mono tabular figure
+     * used by inline rows.
+     */
+    stacked?: boolean;
+};
+export declare function BlotterRow({ label, value, valueClassName, className, stacked }: BlotterRowProps): import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/blotter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/blotter/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAKtC,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,SAAS,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,wBAAgB,OAAO,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,YAAY,+BAE5D;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,SAAS,CAAA;IAChB,KAAK,EAAE,SAAS,CAAA;IAChB,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,KAAK,EACL,cAAc,EACd,SAAS,EACT,OAAe,EAChB,EAAE,eAAe,+BAwCjB"}

package/dist/domain/blotter/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Blotter = Blotter;
+exports.BlotterRow = BlotterRow;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const typography_1 = require("../../lib/typography");
+const utils_1 = require("../../lib/utils");
+function Blotter({ children, className }) {
+    return (0, jsx_runtime_1.jsx)("dl", { className: (0, utils_1.cn)('divide-border divide-y', className), children: children });
+}
+function BlotterRow({ label, value, valueClassName, className, stacked = false }) {
+    if (stacked) {
+        return ((0, jsx_runtime_1.jsxs)("div", { className: (0, utils_1.cn)('hover:bg-body-surface space-y-1 px-2 py-2 transition-colors duration-150 ease-out', className), children: [(0, jsx_runtime_1.jsx)("dt", { className: typography_1.LABEL_VOICE_CLASS, children: label }), (0, jsx_runtime_1.jsx)("dd", { className: (0, utils_1.cn)('text-foreground text-sm break-words whitespace-pre-wrap', valueClassName), children: value })] }));
+    }
+    return ((0, jsx_runtime_1.jsxs)("div", { className: (0, utils_1.cn)('hover:bg-body-surface flex items-center justify-between gap-3 px-2 py-2 transition-colors duration-150 ease-out', className), children: [(0, jsx_runtime_1.jsx)("dt", { className: typography_1.LABEL_VOICE_CLASS, children: label }), (0, jsx_runtime_1.jsx)("dd", { className: (0, utils_1.cn)('font-mono text-sm font-medium tabular-nums', valueClassName), children: value })] }));
+}

package/dist/domain/delinquency-aging/aging-buckets.d.ts

@@ -0,0 +1,57 @@
+export interface AgingBucket {
+    /** Human label for the band, e.g. "A vencer", "31–60", "90+". */
+    label: string;
+    /** Number of items in the band. A zero is shown explicitly, never omitted. */
+    count: number;
+    /** Money total for the band. Pass a decimal STRING for lossless sums. */
+    total: string | number;
+}
+export type AgingBand = 'current' | 'recent' | 'aging' | 'overdue';
+/**
+ * Overrides for the fixed pt-BR copy. Every field is optional and defaults to
+ * the current value, so a consumer that passes nothing renders exactly as
+ * before. The band words in particular are the ACCESSIBLE severity cue (the
+ * sr-only text a screen reader announces), so a consumer running in another
+ * language needs them translatable, not just the digits `locale` already
+ * covers.
+ */
+export interface AgingBucketsLabels {
+    /** sr-only severity word per band. Merged shallowly over the pt-BR canon. */
+    bands?: Partial<Record<AgingBand, string>>;
+    /** Caption under the count column. Defaults to "Itens". */
+    count?: string;
+    /** Caption under the money column. Defaults to "Total". */
+    total?: string;
+    /** Label of the grand-total row. Defaults to "Total geral". */
+    grandTotal?: string;
+}
+export interface AgingBucketsProps {
+    /** Ordered current → oldest. Order carries meaning; not reordered internally. */
+    buckets: AgingBucket[];
+    /** ISO 4217 currency code, e.g. "BRL". Drives the minor-unit sum scale. */
+    currency?: string;
+    /** BCP 47 locale for grouping/decimal marks. Defaults to the runtime locale. */
+    locale?: string;
+    /** Render a money-math-exact grand total row across all buckets. */
+    showTotal?: boolean;
+    /** Override the fixed pt-BR copy. Omitted fields keep their defaults. */
+    labels?: AgingBucketsLabels;
+    className?: string;
+}
+/**
+ * Resolve a bucket's severity band from its ORDINAL POSITION, not its amount —
+ * the order is the information (older = worse). The first bucket is `current`;
+ * the LAST bucket (the oldest, the 90+ tail) is always `overdue`; the middle
+ * escalates `recent` → `aging` toward the tail. A single-bucket list reads as
+ * `current` (there is no escalation to show). Pure: no React, unit-tested.
+ */
+export declare function bucketBand(index: number, count: number): AgingBand;
+/**
+ * Sum the bucket totals through integer minor units (BigInt) at `scale`, then
+ * render losslessly to a decimal string. Returns null if ANY bucket total is
+ * unparseable (indeterminate) — the caller renders NO_VALUE rather than a wrong
+ * grand total. Pure: the money-math third rail, unit-tested.
+ */
+export declare function sumBucketTotals(buckets: AgingBucket[], scale: number): string | null;
+export declare function AgingBuckets({ buckets, currency, locale, showTotal, labels, className }: AgingBucketsProps): import("react").JSX.Element;
+//# sourceMappingURL=aging-buckets.d.ts.map

package/dist/domain/delinquency-aging/aging-buckets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aging-buckets.d.ts","sourceRoot":"","sources":["../../../src/domain/delinquency-aging/aging-buckets.tsx"],"names":[],"mappings":"AAyCA,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAA;IACb,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAA;IACb,yEAAyE;IACzE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;CACvB;AAED,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAA;AAElE;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,6EAA6E;IAC7E,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAA;IAC1C,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,iFAAiF;IACjF,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oEAAoE;IACpE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,yEAAyE;IACzE,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AA2BD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAMlE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,WAAW,EAAE,EACtB,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI,CAMf;AAED,wBAAgB,YAAY,CAAC,EAC3B,OAAO,EACP,QAAQ,EACR,MAAM,EACN,SAAiB,EACjB,MAAM,EACN,SAAS,EACV,EAAE,iBAAiB,+BAyGnB"}

package/dist/domain/delinquency-aging/aging-buckets.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bucketBand = bucketBand;
+exports.sumBucketTotals = sumBucketTotals;
+exports.AgingBuckets = AgingBuckets;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/**
+ * AgingBuckets — an ordered, exhaustive bucketed distribution (the receivables
+ * aging schedule: current / 1–30 / 31–60 / 61–90 / 90+), each bucket carrying a
+ * count and a money total.
+ *
+ * INTERNAL to `DelinquencyAging`: not re-exported from `src/domain/index.ts`,
+ * because the port census only lists the composite. It lives here as the
+ * distribution half of that composite.
+ *
+ * INVARIANT: the buckets are ordered current → oldest and are exhaustive. The
+ * ORDER carries the information — older money is worse money — so the ordinal
+ * position and its label are the PRIMARY cue; the band glyph + sr-only word are
+ * the accessible reinforcement (WCAG 1.4.1 — the escalation survives grayscale
+ * and color-vision deficiency), and the color tint is reinforcement only, never
+ * the sole carrier of severity. The caller supplies the order; the component
+ * never reorders, because a sorted-by-amount view would destroy the one fact the
+ * widget exists to show.
+ *
+ * THIRD RAIL (money): a zero bucket renders an explicit `0` — a zero in the 90+
+ * bucket is information ("nothing slipped that far"), never an omission. When a
+ * grand total is shown it is summed through `money-math` integer minor units
+ * (BigInt, at the currency's CLDR scale) — never IEEE-754 — and rendered via
+ * `MoneyText`. A single unparseable bucket total poisons the sum to NO_VALUE
+ * rather than silently displaying a wrong number. The SAME currency scale that
+ * drives the sum is also the print scale handed to `MoneyText`, so the digits on
+ * screen are the digits that were summed — the printed total can never be a
+ * re-rounding of the computed one.
+ *
+ * Pure display: no directive, no interactivity, server-safe for RSC.
+ */
+const lucide_react_1 = require("lucide-react");
+const typography_1 = require("../../lib/typography");
+const utils_1 = require("../../lib/utils");
+const figure_1 = require("../figure");
+const format_1 = require("../format");
+const money_math_1 = require("../money-math");
+const money_text_1 = require("../money-text");
+/** Band → glyph + tint + accessible word. The glyph (and the sr-only word) is
+ *  the load-bearing severity cue; the tint only reinforces it, so the
+ *  escalation survives grayscale and color-vision deficiency. */
+const BAND = {
+    current: {
+        Icon: lucide_react_1.CircleDot,
+        tint: 'text-system-success',
+        word: 'Em dia'
+    },
+    recent: {
+        Icon: lucide_react_1.Clock,
+        tint: 'text-muted-foreground',
+        word: 'Vencido recentemente'
+    },
+    aging: {
+        Icon: lucide_react_1.AlertTriangle,
+        tint: 'text-system-alert',
+        word: 'Em atraso'
+    },
+    overdue: { Icon: lucide_react_1.AlertOctagon, tint: 'text-credit', word: 'Vencido' }
+};
+/**
+ * Resolve a bucket's severity band from its ORDINAL POSITION, not its amount —
+ * the order is the information (older = worse). The first bucket is `current`;
+ * the LAST bucket (the oldest, the 90+ tail) is always `overdue`; the middle
+ * escalates `recent` → `aging` toward the tail. A single-bucket list reads as
+ * `current` (there is no escalation to show). Pure: no React, unit-tested.
+ */
+function bucketBand(index, count) {
+    if (count <= 1)
+        return 'current';
+    if (index === 0)
+        return 'current';
+    if (index === count - 1)
+        return 'overdue';
+    // Middle buckets: the second-oldest reads `aging`, the rest `recent`.
+    return index === count - 2 ? 'aging' : 'recent';
+}
+/**
+ * Sum the bucket totals through integer minor units (BigInt) at `scale`, then
+ * render losslessly to a decimal string. Returns null if ANY bucket total is
+ * unparseable (indeterminate) — the caller renders NO_VALUE rather than a wrong
+ * grand total. Pure: the money-math third rail, unit-tested.
+ */
+function sumBucketTotals(buckets, scale) {
+    const total = (0, money_math_1.sumMinor)(buckets.map((b) => b.total), scale);
+    return total === null ? null : (0, money_math_1.minorToDecimal)(total, scale);
+}
+function AgingBuckets({ buckets, currency, locale, showTotal = false, labels, className }) {
+    const countLabel = labels?.count ?? 'Itens';
+    const totalLabel = labels?.total ?? 'Total';
+    const grandTotalLabel = labels?.grandTotal ?? 'Total geral';
+    // THIRD RAIL: one scale for BOTH the arithmetic and the print. `MoneyText`
+    // defaults to 2 fraction digits, so leaving it unset printed JPY (scale 0)
+    // with two decimals the currency does not have, and re-rounded the exact BHD
+    // (scale 3) grand total `1.005` to `1.01` — a printed total that disagreed
+    // with the total that was actually summed.
+    const scale = currency ? (0, money_math_1.minorDigitsOf)(currency) : 2;
+    const grandTotal = showTotal ? sumBucketTotals(buckets, scale) : null;
+    return ((0, jsx_runtime_1.jsxs)("div", { className: (0, utils_1.cn)('flex flex-col', className), children: [(0, jsx_runtime_1.jsx)("ul", { className: "flex flex-col", children: buckets.map((bucket, i) => {
+                    const band = bucketBand(i, buckets.length);
+                    const { Icon, tint, word } = BAND[band];
+                    // Shallow merge: an unlisted band keeps its pt-BR default.
+                    const bandWord = labels?.bands?.[band] ?? word;
+                    return ((0, jsx_runtime_1.jsxs)("li", { className: "border-border flex items-center gap-3 border-b py-2.5 last:border-b-0", children: [(0, jsx_runtime_1.jsx)(Icon, { "aria-hidden": true, className: (0, utils_1.cn)('size-4 shrink-0', tint) }), (0, jsx_runtime_1.jsxs)("span", { className: "sr-only", children: [bandWord, ": "] }), (0, jsx_runtime_1.jsx)("span", { className: (0, utils_1.cn)(typography_1.LABEL_VOICE_CLASS, 'text-foreground min-w-0 flex-1 tracking-normal normal-case'), children: bucket.label }), (0, jsx_runtime_1.jsxs)("span", { className: "flex shrink-0 flex-col items-end leading-none", children: [(0, jsx_runtime_1.jsx)(figure_1.Figure, { size: "row", className: "text-foreground", children: (0, format_1.formatCount)(bucket.count, locale) }), (0, jsx_runtime_1.jsx)("span", { className: (0, utils_1.cn)(typography_1.LABEL_VOICE_CLASS, 'mt-1'), children: countLabel })] }), (0, jsx_runtime_1.jsxs)("span", { className: "flex w-32 shrink-0 flex-col items-end leading-none sm:w-40", children: [(0, jsx_runtime_1.jsx)(figure_1.Figure, { size: "row", className: (0, utils_1.cn)(band === 'overdue' && 'text-credit'), children: (0, jsx_runtime_1.jsx)(money_text_1.MoneyText, { amount: bucket.total, currency: currency, fractionDigits: scale, locale: locale, signColor: false }) }), (0, jsx_runtime_1.jsx)("span", { className: (0, utils_1.cn)(typography_1.LABEL_VOICE_CLASS, 'mt-1'), children: totalLabel })] })] }, `${bucket.label}-${i}`));
+                }) }), showTotal ? ((0, jsx_runtime_1.jsxs)("div", { className: "border-border flex items-center gap-3 border-t-2 pt-2.5", children: [(0, jsx_runtime_1.jsx)("span", { "aria-hidden": true, className: "size-4 shrink-0" }), (0, jsx_runtime_1.jsx)("span", { className: (0, utils_1.cn)(typography_1.LABEL_VOICE_CLASS, 'text-foreground min-w-0 flex-1'), children: grandTotalLabel }), (0, jsx_runtime_1.jsx)("span", { className: "w-32 shrink-0 text-right sm:w-40", children: grandTotal === null ? ((0, jsx_runtime_1.jsx)(figure_1.Figure, { size: "row", className: "text-muted-foreground", children: format_1.NO_VALUE })) : ((0, jsx_runtime_1.jsx)(figure_1.Figure, { size: "row", className: "text-foreground font-semibold", children: (0, jsx_runtime_1.jsx)(money_text_1.MoneyText, { amount: grandTotal, currency: currency, fractionDigits: scale, locale: locale, signColor: false }) })) })] })) : null] }));
+}

package/dist/domain/delinquency-aging/index.d.ts

@@ -0,0 +1,71 @@
+import type { GaugeBand } from '../threshold-gauge';
+import type { AgingBucket, AgingBucketsLabels } from './aging-buckets';
+export type { AgingBand, AgingBucketsLabels } from './aging-buckets';
+/** A bucket in the aging schedule, plus the flag that marks it past due. The
+ *  `overdue` flag is what the rate's NUMERATOR sums — the caller declares which
+ *  bands count as delinquent (typically every band after "current"). */
+export interface DelinquencyBucket extends AgingBucket {
+    /** Whether this band counts toward the overdue (past-due) numerator. */
+    overdue?: boolean;
+}
+/** The delinquency rate resolved from EXACT integer minor-unit totals. `rate`
+ *  is null for a zero/empty/indeterminate portfolio — never NaN. */
+export interface DelinquencyRate {
+    /** overdueMinor / totalMinor as a 0..1 ratio; null when undefined. */
+    rate: number | null;
+    /** Σ(overdue bucket totals) in minor units; null if any total is unparseable. */
+    overdueMinor: bigint | null;
+    /** Σ(all bucket totals) in minor units; null if any total is unparseable. */
+    totalMinor: bigint | null;
+    /** True when the RATE cannot be determined: a bucket total that could not be
+     *  parsed, or a negative bucket total (parseable, but not a share of a
+     *  portfolio). The sums may still be present in the negative case. */
+    indeterminate: boolean;
+}
+/**
+ * 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 declare function delinquencyRate(buckets: DelinquencyBucket[], scale: number): DelinquencyRate;
+export interface DelinquencyAgingProps {
+    /** Ordered current → oldest. Order carries meaning; not reordered internally.
+     *  Each band's `overdue` flag selects it into the rate numerator. */
+    buckets: DelinquencyBucket[];
+    /** ISO 4217 currency code, e.g. "BRL". Drives the minor-unit rate scale. */
+    currency?: string;
+    /** BCP 47 locale for the percent decimal mark and the bucket figures. */
+    locale?: string;
+    /** Quiet caption above the rate readout. Defaults to "Inadimplência". */
+    rateLabel?: string;
+    /** sr-only rate band word per band ("Saudável" / "Elevada" / "Em estresse").
+     *  Merged shallowly; an unlisted band keeps its pt-BR default. This is the
+     *  ACCESSIBLE band cue, so it has to be translatable — `locale` only reaches
+     *  the digits. */
+    rateBandLabels?: Partial<Record<GaugeBand, string>>;
+    /** Readout when the portfolio is empty. Defaults to "sem carteira". */
+    emptyLabel?: string;
+    /** Readout when the rate cannot be determined. Defaults to "indeterminada". */
+    indeterminateLabel?: string;
+    /** Override the fixed pt-BR copy of the distribution below (band words, the
+     *  count/money captions, the grand-total row). Omitted fields keep their
+     *  defaults. */
+    bucketLabels?: AgingBucketsLabels;
+    /** Warn edge for the rate band (0..1 ratio). Crossing it strictly → elevated.
+     *  Compared against the EXACT minor-unit ratio, with a resolution floor of
+     *  1e-18: a magnitude finer than that is treated as 1e-18, and a non-finite
+     *  value is treated as no threshold at all. */
+    warn?: number;
+    /** Breach edge for the rate band (0..1 ratio). Crossing it strictly → distressed.
+     *  Same 1e-18 resolution floor and non-finite handling as `warn`. */
+    breach?: number;
+    /** Render the money-math-exact grand total row under the distribution. */
+    showTotal?: boolean;
+    className?: string;
+}
+export declare function DelinquencyAging({ buckets, currency, locale, rateLabel, rateBandLabels, emptyLabel, indeterminateLabel, bucketLabels, warn, breach, showTotal, className }: DelinquencyAgingProps): import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/delinquency-aging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/delinquency-aging/index.tsx"],"names":[],"mappings":"AAoDA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAKtE,YAAY,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAOpE;;wEAEwE;AACxE,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;oEACoE;AACpE,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,iFAAiF;IACjF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,6EAA6E;IAC7E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB;;0EAEsE;IACtE,aAAa,EAAE,OAAO,CAAA;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,iBAAiB,EAAE,EAC5B,KAAK,EAAE,MAAM,GACZ,eAAe,CAuDjB;AAoFD,MAAM,WAAW,qBAAqB;IACpC;yEACqE;IACrE,OAAO,EAAE,iBAAiB,EAAE,CAAA;IAC5B,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;sBAGkB;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAA;IACnD,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+EAA+E;IAC/E,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B;;oBAEgB;IAChB,YAAY,CAAC,EAAE,kBAAkB,CAAA;IACjC;;;mDAG+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;yEACqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0EAA0E;IAC1E,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,OAAO,EACP,QAAQ,EACR,MAAM,EACN,SAA2B,EAC3B,cAAc,EACd,UAA2B,EAC3B,kBAAoC,EACpC,YAAY,EACZ,IAAW,EACX,MAAY,EACZ,SAAiB,EACjB,SAAS,EACV,EAAE,qBAAqB,+BAyEvB"}

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

@@ -0,0 +1,213 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.delinquencyRate = delinquencyRate;
+exports.DelinquencyAging = DelinquencyAging;
+const jsx_runtime_1 = require("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.
+ */
+const lucide_react_1 = require("lucide-react");
+const typography_1 = require("../../lib/typography");
+const utils_1 = require("../../lib/utils");
+const figure_1 = require("../figure");
+const format_1 = require("../format");
+const money_math_1 = require("../money-math");
+const section_label_1 = require("../section-label");
+const aging_buckets_1 = require("./aging-buckets");
+/** 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`.
+ */
+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) => (0, money_math_1.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. */
+const RATE_BAND = {
+    low: { Icon: lucide_react_1.ShieldCheck, tint: 'text-system-success', word: 'Saudável' },
+    warn: { Icon: lucide_react_1.TriangleAlert, tint: 'text-system-alert', word: 'Elevada' },
+    breach: { Icon: lucide_react_1.AlertOctagon, tint: 'text-credit', word: 'Em estresse' }
+};
+function DelinquencyAging({ buckets, currency, locale, rateLabel = 'Inadimplência', rateBandLabels, emptyLabel = 'sem carteira', indeterminateLabel = 'indeterminada', bucketLabels, warn = 0.05, breach = 0.1, showTotal = false, 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 ? (0, money_math_1.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, tint, word } = RATE_BAND[band];
+    // Shallow merge: an unlisted band keeps its pt-BR default.
+    const bandWord = rateBandLabels?.[band] ?? word;
+    const distressed = band === 'breach';
+    return ((0, jsx_runtime_1.jsxs)("div", { className: (0, utils_1.cn)('flex flex-col gap-4', className), children: [(0, jsx_runtime_1.jsxs)("header", { className: "flex items-baseline justify-between gap-3", children: [(0, jsx_runtime_1.jsx)(section_label_1.SectionLabel, { as: "span", children: rateLabel }), hasRate ? ((0, jsx_runtime_1.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: (0, utils_1.cn)('inline-flex items-center gap-1.5', tint), children: [(0, jsx_runtime_1.jsx)(Icon, { "aria-hidden": true, className: "size-4 shrink-0" }), (0, jsx_runtime_1.jsxs)("span", { className: "sr-only", children: [bandWord, ": "] }), (0, jsx_runtime_1.jsx)(figure_1.Figure, { size: "row", className: tint, children: (0, format_1.formatPercent)(rate, { unit: 'ratio', locale }) })] })) : ((0, jsx_runtime_1.jsxs)("span", { className: "text-muted-foreground inline-flex items-center gap-1.5", children: [(0, jsx_runtime_1.jsx)("span", { className: (0, utils_1.cn)(typography_1.LABEL_VOICE_CLASS, 'tracking-normal normal-case'), children: indeterminate ? indeterminateLabel : emptyLabel }), (0, jsx_runtime_1.jsx)(figure_1.Figure, { size: "row", className: "text-muted-foreground", children: format_1.NO_VALUE })] }))] }), (0, jsx_runtime_1.jsx)(aging_buckets_1.AgingBuckets, { buckets: buckets, currency: currency, locale: locale, showTotal: showTotal, labels: bucketLabels })] }));
+}