@adminiumjs/widgets 0.1.0-rc.1

package/dist/families/domain/SloMonitorCard.js

@@ -0,0 +1,76 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Badge, IconTile, MonoText, ProgressBar } from '@adminium/ui';
+import { Activity } from 'lucide-react';
+import { useMemo } from 'react';
+import { sloMonitorCardConfigSchema, sloMonitorCardDemoData } from './domain-ops-config.js';
+import { OPS_TONE_BG, OPS_TONE_BORDER_S, OPS_TONE_TEXT, UPTIME_HEIGHT, UPTIME_TONE, budgetTone, countField, formatMs, formatPct, labelField, opsRowOf, pctField, uptimeStateOf, } from './domain-ops-lib.js';
+import { OpsEmpty } from './OpsEmpty.js';
+/**
+ * `slo-monitor-card` (annex §13) — a per-service SLA card: status rule, icon
+ * tile, status pill, mono endpoint, current% against target%, the trailing daily
+ * uptime sparkline (height + color by Operational/Degraded/Down), a
+ * threshold-colored error-budget bar, and p95 latency. Evidence: SLA Monitoring.
+ *
+ * DIRECTION (10-i18n-theming.md §5.5) — the sparkline here is NOT a time axis
+ * island. It is a compact trailing-history glyph, ~30 undated bars with no axis,
+ * no labels and no origin to align a gutter to; nothing in it anchors a reader
+ * to "left = older" the way the gantt's dated canvas does. So the whole card
+ * mirrors as one unit: the bar strip is a plain flex row that reverses under
+ * `dir="rtl"`, keeping "newest" at the reading END in both directions — which is
+ * where a reader's eye lands last, and therefore where "now" belongs. The
+ * status rule rides `border-s-*` for the same reason (annex "status left-border"
+ * means the START of the row, not its physical left).
+ *
+ * ORDERING CONTRACT: `history` arrives OLDEST → NEWEST and is rendered in that
+ * order. `flex-row` + `dir="rtl"` does the mirroring; the array is never
+ * reversed in JS, so LTR and RTL consume byte-identical data.
+ */
+export { sloMonitorCardConfigSchema, sloMonitorCardDemoData };
+/** Localized status label falls back to the raw enum (a developer fallback). */
+const STATUS_FALLBACK = {
+    operational: 'Operational',
+    degraded: 'Degraded',
+    down: 'Down',
+    unknown: 'Unknown',
+};
+export function SloMonitorCardView({ monitor, budgetThresholds, windowDays = 30, locale, targetLabel, budgetLabel, latencyLabel, testId, }) {
+    const statusTone = UPTIME_TONE[monitor.status];
+    const budget = budgetTone(monitor.budget, budgetThresholds);
+    // Trailing window: the LAST `windowDays` entries, so a payload carrying 90
+    // days still renders the annex's 30-bar strip without the caller pre-slicing.
+    const history = monitor.history.slice(-Math.max(1, windowDays));
+    // A shortfall against target is the whole point of the card, so the current
+    // figure is toned by whether it MET the target — not by the service's
+    // instantaneous status, which can read green during a month that already
+    // blew its budget.
+    const meetsTarget = monitor.current >= monitor.target;
+    return (_jsxs("div", { "data-widget": "slo-monitor-card", "data-testid": testId, "data-status": monitor.status, className: `flex h-full flex-col gap-3 overflow-auto border-s-4 ${OPS_TONE_BORDER_S[statusTone]} px-4 pb-4`, children: [_jsxs("div", { className: "flex items-start gap-2.5", children: [_jsx(IconTile, { tone: statusTone, size: "sm", icon: _jsx(Activity, {}) }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("p", { className: "truncate text-body-sm font-bold text-fg", children: monitor.name }), monitor.endpoint === undefined ? null : (_jsx(MonoText, { className: "block truncate text-caption text-fg-subtle", children: monitor.endpoint }))] }), _jsx(Badge, { tone: statusTone, dot: true, "data-part": "slo-status", children: STATUS_FALLBACK[monitor.status] })] }), _jsxs("div", { className: "flex items-baseline gap-2", children: [_jsx(MonoText, { "data-part": "slo-current", className: `text-h2 font-bold tabular-nums ${meetsTarget ? OPS_TONE_TEXT.pos : OPS_TONE_TEXT.danger}`, children: formatPct(monitor.current, locale, 2) }), _jsxs("span", { className: "text-caption text-fg-subtle", children: [targetLabel ?? 'Target', " ", _jsx(MonoText, { children: formatPct(monitor.target, locale, 2) })] })] }), _jsx("div", { "aria-hidden": "true", "data-testid": "slo-sparkline", className: "flex h-8 items-end gap-px", children: history.map((state, index) => (_jsx("span", { "data-part": "slo-day", "data-state": state, className: `h-[var(--bar-h)] min-w-px flex-1 rounded-xs ${OPS_TONE_BG[UPTIME_TONE[state]]}`, style: { '--bar-h': `${UPTIME_HEIGHT[state]}%` } }, `${index}-${state}`))) }), _jsxs("div", { className: "flex flex-col gap-1", children: [_jsxs("div", { className: "flex items-center justify-between text-caption", children: [_jsx("span", { className: "text-fg-subtle", children: budgetLabel ?? 'Error budget' }), _jsx(MonoText, { className: `font-bold ${OPS_TONE_TEXT[budget]}`, "data-part": "slo-budget", children: formatPct(monitor.budget, locale) })] }), _jsx(ProgressBar, { value: monitor.budget, tone: budget, size: "sm", animated: false, label: budgetLabel ?? 'Error budget' })] }), monitor.p95 === undefined ? null : (_jsxs("p", { className: "text-caption text-fg-subtle", children: [latencyLabel ?? 'p95 latency', " ", _jsx(MonoText, { className: "font-semibold text-fg", children: formatMs(monitor.p95, locale) })] }))] }));
+}
+/** Project the bound `record` onto the monitor model (config-driven columns). */
+function monitorOf(config, data) {
+    const row = opsRowOf(data);
+    if (row === null)
+        return null;
+    const raw = row[config.historyField];
+    const history = (Array.isArray(raw) ? raw : []).map(uptimeStateOf);
+    return {
+        name: labelField(row, config.nameField, 'Service'),
+        endpoint: row[config.endpointField] === undefined ? undefined : labelField(row, config.endpointField, ''),
+        target: pctField(row, config.targetField, config.target),
+        current: pctField(row, config.currentField, 0),
+        status: uptimeStateOf(row[config.statusField]),
+        budget: pctField(row, config.budgetField, 0),
+        // Latency is milliseconds, NOT a percent — it must not go through
+        // `pctField`, which would clamp a real 240ms p95 down to 100.
+        p95: row[config.p95Field] === undefined ? undefined : countField(row, config.p95Field, 0),
+        history,
+    };
+}
+export function SloMonitorCardWidget({ config, data }) {
+    const monitor = useMemo(() => monitorOf(config, data), [config, data]);
+    if (monitor === null) {
+        return (_jsx(OpsEmpty, { title: config.emptyTitle ?? 'No monitor', body: config.emptyBody ?? 'Bind a monitors table with a status and an availability column.' }));
+    }
+    return (_jsx(SloMonitorCardView, { monitor: monitor, windowDays: config.windowDays, ...(config.budgetThresholds === undefined ? {} : { budgetThresholds: config.budgetThresholds }), ...(config.format?.locale === undefined ? {} : { locale: config.format.locale }), ...(config.targetLabel === undefined ? {} : { targetLabel: config.targetLabel }), ...(config.budgetLabel === undefined ? {} : { budgetLabel: config.budgetLabel }), ...(config.latencyLabel === undefined ? {} : { latencyLabel: config.latencyLabel }), ...(config.testId === undefined ? {} : { testId: config.testId }) }));
+}
+//# sourceMappingURL=SloMonitorCard.js.map

package/dist/families/domain/SloMonitorCard.js.map

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

package/dist/families/domain/UptimeSegmentBar.d.ts

@@ -0,0 +1,42 @@
+import { uptimeSegmentBarConfigSchema, uptimeSegmentBarDemoData } from './domain-ops-config.js';
+import type { UptimeSegmentBarConfig } from './domain-ops-config.js';
+import type { UptimeDay } from './domain-ops-types.js';
+import type { WidgetProps } from '../../registry/types.js';
+/**
+ * `uptime-segment-bar` (annex §13) — the statuspage-style day strip: n flex
+ * segments toned pos/warn/danger with per-day tooltips and a hover scaleY, an
+ * axis reading "{n} days ago / uptime % / Today", and a 30/90-day toggle.
+ * Evidence: Status Page.
+ *
+ * DIRECTION (10-i18n-theming.md §5.5) — this one MIRRORS, and that is a
+ * deliberate call against the gantt's fixed-LTR-island rule, not an oversight.
+ * The island rule exists for a DATED canvas: the gantt has a calendar header and
+ * a label gutter that must align to a time ORIGIN, so flipping it would put day
+ * 0 under a header that says otherwise. A statuspage strip has neither. It has
+ * exactly two anchors — an "N days ago" caption at one end and "Today" at the
+ * other — and both are text that mirrors with the reader. Pinning the strip LTR
+ * while its own captions flipped would put "Today" at the end the newest segment
+ * is NOT at: a caption that lies. So the strip is a plain `flex` row and the
+ * whole thing reverses under `dir="rtl"`, captions and segments together.
+ *
+ * The array itself is never reversed in JS — rows arrive oldest → newest and are
+ * rendered in that order in both directions, so LTR and RTL consume byte-
+ * identical data and only CSS differs.
+ */
+export { uptimeSegmentBarConfigSchema, uptimeSegmentBarDemoData };
+export type { UptimeSegmentBarConfig };
+export interface UptimeSegmentBarViewProps {
+    /** Daily statuses, OLDEST → NEWEST. */
+    days: readonly UptimeDay[];
+    period?: '30' | '90' | undefined;
+    showToggle?: boolean | undefined;
+    stateColors?: Record<string, string> | undefined;
+    locale?: string | undefined;
+    daysAgoLabel?: string | undefined;
+    todayLabel?: string | undefined;
+    uptimeLabel?: string | undefined;
+    testId?: string | undefined;
+}
+export declare function UptimeSegmentBarView({ days, period, showToggle, stateColors, locale, daysAgoLabel, todayLabel, uptimeLabel, testId, }: UptimeSegmentBarViewProps): import("react").JSX.Element;
+export declare function UptimeSegmentBarWidget({ config, data }: WidgetProps<UptimeSegmentBarConfig>): import("react").JSX.Element;
+//# sourceMappingURL=UptimeSegmentBar.d.ts.map

package/dist/families/domain/UptimeSegmentBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UptimeSegmentBar.d.ts","sourceRoot":"","sources":["../../../src/families/domain/UptimeSegmentBar.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAYrE,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,uBAAuB,CAAC;AAGpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,CAAC;AAClE,YAAY,EAAE,sBAAsB,EAAE,CAAC;AAEvC,MAAM,WAAW,yBAAyB;IACxC,uCAAuC;IACvC,IAAI,EAAE,SAAS,SAAS,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC;IACjC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACjD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAeD,wBAAgB,oBAAoB,CAAC,EACnC,IAAI,EACJ,MAAa,EACb,UAAiB,EACjB,WAAW,EACX,MAAM,EACN,YAAY,EACZ,UAAU,EACV,WAAW,EACX,MAAM,GACP,EAAE,yBAAyB,+BAgE3B;AAmBD,wBAAgB,sBAAsB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,WAAW,CAAC,sBAAsB,CAAC,+BAyB3F"}

package/dist/families/domain/UptimeSegmentBar.js

@@ -0,0 +1,81 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { MonoText, SegmentedControl, Tooltip, TooltipProvider } from '@adminium/ui';
+import { useMemo, useState } from 'react';
+import { uptimeSegmentBarConfigSchema, uptimeSegmentBarDemoData } from './domain-ops-config.js';
+import { OPS_TONE_BG, UPTIME_TONE, formatDay, formatPct, instantField, interpolate, opsRowsOf, uptimePct, uptimeStateOf, } from './domain-ops-lib.js';
+import { toneOf } from './domain-lib.js';
+import { OpsEmpty } from './OpsEmpty.js';
+/**
+ * `uptime-segment-bar` (annex §13) — the statuspage-style day strip: n flex
+ * segments toned pos/warn/danger with per-day tooltips and a hover scaleY, an
+ * axis reading "{n} days ago / uptime % / Today", and a 30/90-day toggle.
+ * Evidence: Status Page.
+ *
+ * DIRECTION (10-i18n-theming.md §5.5) — this one MIRRORS, and that is a
+ * deliberate call against the gantt's fixed-LTR-island rule, not an oversight.
+ * The island rule exists for a DATED canvas: the gantt has a calendar header and
+ * a label gutter that must align to a time ORIGIN, so flipping it would put day
+ * 0 under a header that says otherwise. A statuspage strip has neither. It has
+ * exactly two anchors — an "N days ago" caption at one end and "Today" at the
+ * other — and both are text that mirrors with the reader. Pinning the strip LTR
+ * while its own captions flipped would put "Today" at the end the newest segment
+ * is NOT at: a caption that lies. So the strip is a plain `flex` row and the
+ * whole thing reverses under `dir="rtl"`, captions and segments together.
+ *
+ * The array itself is never reversed in JS — rows arrive oldest → newest and are
+ * rendered in that order in both directions, so LTR and RTL consume byte-
+ * identical data and only CSS differs.
+ */
+export { uptimeSegmentBarConfigSchema, uptimeSegmentBarDemoData };
+/** Per-day tone: an explicit `stateColors` override, else the shared uptime map. */
+function dayTone(state, overrides) {
+    const explicit = overrides?.[state];
+    return explicit === undefined ? UPTIME_TONE[state] : toneOf(explicit, UPTIME_TONE[state]);
+}
+const STATUS_FALLBACK = {
+    operational: 'Operational',
+    degraded: 'Degraded',
+    down: 'Down',
+    unknown: 'No data',
+};
+export function UptimeSegmentBarView({ days, period = '90', showToggle = true, stateColors, locale, daysAgoLabel, todayLabel, uptimeLabel, testId, }) {
+    // The toggle is COMPONENT state seeded from config: a stored config pins where
+    // the strip starts, not where it stays (a widget that reset the user's toggle
+    // on every re-render would be unusable).
+    const [window, setWindow] = useState(period);
+    const size = window === '30' ? 30 : 90;
+    const visible = useMemo(() => days.slice(-size), [days, size]);
+    const pct = useMemo(() => uptimePct(visible.map((day) => day.state)), [visible]);
+    return (_jsx(TooltipProvider, { children: _jsxs("div", { "data-widget": "uptime-segment-bar", "data-testid": testId, "data-period": window, className: "flex h-full flex-col justify-center gap-2 px-4 pb-4", children: [!showToggle ? null : (_jsx("div", { className: "flex justify-end", children: _jsx(SegmentedControl, { value: window, onValueChange: setWindow, "data-testid": "uptime-period-toggle", options: [
+                            { value: '30', label: '30d' },
+                            { value: '90', label: '90d' },
+                        ] }) })), _jsx("div", { "aria-hidden": "true", "data-testid": "uptime-strip", className: "flex h-9 items-stretch gap-[2px]", children: visible.map((day) => {
+                        const tone = dayTone(day.state, stateColors);
+                        const label = `${formatDay(day.ms, locale) ?? ''} — ${STATUS_FALLBACK[day.state]}`;
+                        return (_jsx(Tooltip, { content: label, children: _jsx("span", { "data-part": "uptime-segment", "data-state": day.state, className: `min-w-[3px] flex-1 rounded-xs transition-transform duration-150 hover:scale-y-110 ${OPS_TONE_BG[tone]}` }) }, day.ms));
+                    }) }), _jsxs("div", { className: "flex items-center justify-between gap-2 text-caption text-fg-subtle", children: [_jsx("span", { "data-part": "uptime-axis-start", children: interpolate(daysAgoLabel ?? '{days} days ago', { days: size }) }), _jsxs(MonoText, { className: "font-bold text-fg", "data-part": "uptime-pct", children: [formatPct(pct, locale, 2), " ", uptimeLabel ?? 'uptime'] }), _jsx("span", { "data-part": "uptime-axis-end", children: todayLabel ?? 'Today' })] })] }) }));
+}
+/** Project the bound `record-list` onto the day strip (oldest → newest). */
+function daysOf(config, data) {
+    const rows = opsRowsOf(data);
+    const out = [];
+    rows.forEach((row, index) => {
+        const ms = instantField(row, config.dayField);
+        out.push({
+            // A status column with no usable date still renders in payload order — the
+            // strip's meaning is the SEQUENCE, and dropping undated days would silently
+            // shorten the window and inflate the uptime percentage.
+            ms: ms ?? index,
+            state: uptimeStateOf(row[config.statusField]),
+        });
+    });
+    return out;
+}
+export function UptimeSegmentBarWidget({ config, data }) {
+    const days = useMemo(() => daysOf(config, data), [config, data]);
+    if (days.length === 0) {
+        return (_jsx(OpsEmpty, { title: config.emptyTitle ?? 'No uptime history', body: config.emptyBody ?? 'Daily status rows appear here as an uptime strip.' }));
+    }
+    return (_jsx(UptimeSegmentBarView, { days: days, period: config.period, showToggle: config.showToggle, ...(config.stateColors === undefined ? {} : { stateColors: config.stateColors }), ...(config.format?.locale === undefined ? {} : { locale: config.format.locale }), ...(config.daysAgoLabel === undefined ? {} : { daysAgoLabel: config.daysAgoLabel }), ...(config.todayLabel === undefined ? {} : { todayLabel: config.todayLabel }), ...(config.uptimeLabel === undefined ? {} : { uptimeLabel: config.uptimeLabel }), ...(config.testId === undefined ? {} : { testId: config.testId }) }));
+}
+//# sourceMappingURL=UptimeSegmentBar.js.map

package/dist/families/domain/UptimeSegmentBar.js.map

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

package/dist/families/domain/block-lib.d.ts

@@ -0,0 +1,159 @@
+import type { BlockTwoColRow, CategoricalData, DocBlockInstance, DocLineItem, DocRates, DocRecord, DocTotals, DocType, RowData, RowsData } from './block-types.js';
+/**
+ * The 22 `block-*` registry ids, in annex §13 bullet order. `document-canvas`
+ * validates `blockOrder[]` against this set, so a doc row carrying a typo'd or
+ * hostile block id renders nothing rather than resolving an arbitrary widget.
+ */
+export declare const BLOCK_IDS: readonly ["block-totals-summary", "block-line-items", "block-kpi-row", "block-bar-chart", "block-line-chart", "block-two-col-table", "block-tax-breakdown", "block-multi-currency", "block-payment-history", "block-discount-codes", "block-loyalty-banner", "block-recurring-banner", "block-qr-pay", "block-delivery-stepper", "block-signature", "block-terms-checkbox", "block-approval", "block-attachments", "block-late-fees", "block-image-placeholder", "block-contact", "block-highlight-box"];
+export type BlockId = (typeof BLOCK_IDS)[number];
+/** Is this an annex §13 document-block id? */
+export declare function isBlockId(value: unknown): value is BlockId;
+export declare const DOC_TYPES: readonly ["invoice", "report", "email"];
+/**
+ * The blocks each document surface starts with (annex §13 evidence column —
+ * which comp each block is cited from). `document-canvas` falls back to these
+ * when a doc row carries no `blockOrder[]`, which is what makes a freshly
+ * seeded doc render something useful instead of an empty page.
+ */
+export declare const DOC_TYPE_BLOCKS: Readonly<Record<DocType, readonly BlockId[]>>;
+/** Coerce an untrusted value to a `DocType`, defaulting to `invoice`. */
+export declare function docTypeOf(value: unknown, fallback?: DocType): DocType;
+/** Fixed demo anchor for the block vocabulary — 2026-06-01T00:00:00Z. */
+export declare const BLOCK_DEMO_EPOCH: number;
+/** Milliseconds in a whole day. */
+export declare const BLOCK_DAY_MS = 86400000;
+/**
+ * Currency formatting for a money figure (10 §4.4 — the code comes from the
+ * doc/column metadata, never from the viewer's locale).
+ *
+ * `|| 'USD'` rather than `??`: `format.currency: ''` is schema-valid (the shared
+ * config types it as a free string) and `{ style: 'currency', currency: '' }`
+ * throws `RangeError` inside `Intl` — the exact crash the config-fuzz gate
+ * samples for (see qa/zod-sample.ts's `FIELD_POOLS`).
+ */
+export declare function formatBlockMoney(value: number, options?: {
+    locale?: string | undefined;
+    currency?: string | undefined;
+}): string;
+/**
+ * Percent formatting for a FRACTIONAL rate (0.075 → "7.5%").
+ *
+ * The whole-percent test rounds BEFORE the modulo. `rate * 100` is a float:
+ * `0.07 * 100` is `7.000000000000001` and `0.29 * 100` is `28.999999999999996`,
+ * so testing `% 1 === 0` on the raw product answers "no" for two perfectly
+ * ordinary tax rates — and the same tax table would then print `20%` next to
+ * `7.00%`. Scaling to 1e6 keeps four decimal places of a percent (0.0001%),
+ * which is finer than any rate this renders and coarse enough to swallow the
+ * representation error.
+ */
+export declare function formatBlockRate(rate: number, locale?: string | undefined): string;
+/** Plain number formatting (loyalty points, cycle counts). */
+export declare function formatBlockNumber(value: number, locale?: string | undefined): string;
+/** Short date formatting for a doc date field; blank input renders an em dash. */
+export declare function formatBlockDate(value: string | number | undefined, locale?: string | undefined): string;
+/** Byte-size formatting for `block-attachments`' mono size column. */
+export declare function formatBlockSize(bytes: number, locale?: string | undefined): string;
+/**
+ * Mask a payment method for `block-payment-history` — never render a full PAN.
+ * Only the last four digits ever reach the DOM, and they come from the row's own
+ * `last4` field (a masked column), not from a parsed number.
+ */
+export declare function maskMethod(method: string, last4?: string | undefined): string;
+/**
+ * The canvas's live-recomputing totals (annex §13): subtotal from the line
+ * items, discount off the subtotal, tax on the discounted base, total due.
+ *
+ * Every figure is derived here and nowhere else, so `block-totals-summary`,
+ * `block-tax-breakdown` and `block-qr-pay` can never disagree. Non-finite or
+ * negative quantities are coerced to 0 rather than poisoning the arithmetic with
+ * `NaN` — untrusted rows reach this from a live table.
+ */
+export declare function computeTotals(items: readonly DocLineItem[], rates?: DocRates | undefined, currencyFallback?: string): DocTotals;
+/** Round to cents — float money must never render `19.999999999999998`. */
+export declare function round2(value: number): number;
+/**
+ * Project an untrusted `record` payload onto its row. Accepts both the canonical
+ * `{ row }` envelope and a BARE object (what a hand-written manifest or a story
+ * tends to pass), so a block never blanks out over an envelope detail.
+ */
+export declare function rowOf<T>(data: unknown): T | null;
+/** Project an untrusted `record-list` payload onto its rows. */
+export declare function rowsOf(data: unknown): Record<string, unknown>[];
+/** Project an untrusted `categorical` payload onto its label/value items. */
+export declare function categoricalItemsOf(data: unknown): {
+    label: string;
+    value: number;
+}[];
+/** Project untrusted rows onto `DocLineItem`s via the configured field naming. */
+export declare function lineItemsOf(data: unknown, fields: {
+    idField: string;
+    descField: string;
+    qtyField: string;
+    rateField: string;
+}): DocLineItem[];
+/** `block-two-col-table` rows: `rows[][]` coerced to [left, right] string pairs. */
+export declare function twoColRowsOf(data: unknown): BlockTwoColRow[];
+/**
+ * Resolve the canvas's ordered block instances from an untrusted doc row.
+ *
+ * Precedence: the doc's own `blockOrder[]` → the `enabledBlocks` config → the
+ * doc type's default composition. Unknown ids are DROPPED (never rendered as an
+ * arbitrary widget), and `flags[blockId] === false` hides a block — the annex's
+ * "~20 boolean show-flags per doc".
+ */
+export declare function blockOrderOf(doc: DocRecord | null, options: {
+    docType: DocType;
+    enabledBlocks?: readonly string[] | undefined;
+}): DocBlockInstance[];
+/**
+ * Project the canvas's single doc object onto ONE block's own §3 payload.
+ *
+ * The money blocks are DERIVED from the doc's `items` + `rates` rather than read
+ * from storage — that is the annex's "live-recomputing totals", and it is what
+ * guarantees `block-totals-summary`, `block-tax-breakdown` and `block-qr-pay`
+ * can never disagree about the same invoice. Every other block is doc content
+ * with no canonical derivation, so it comes from the `blocks` bag as-is; a block
+ * with no payload gets `null` and renders its own empty copy.
+ *
+ * Pure, so the projection is golden-testable without mounting the canvas.
+ */
+export declare function blockDataOf(blockId: string, doc: DocRecord | null): unknown;
+/**
+ * Move the item at `index` by `delta` positions, returning a NEW list. Out-of-
+ * range moves return the list unchanged, so a "move up" on the first block is a
+ * no-op rather than a wrap-around — the canvas's up/down controls rely on that
+ * to stay predictable at the ends.
+ *
+ * This is deliberately an index algebra rather than a pointer drag: reorder in
+ * the canvas is driven by keyboard-reachable buttons (and the page-builder page
+ * may drive the same callback from a pointer layer), so the ordering logic stays
+ * pure, testable, and identical for both input modes.
+ */
+export declare function moveBlock<T>(list: readonly T[], index: number, delta: number): T[];
+/** The table a `mutate` intent addresses, resolved from the binding descriptor. */
+export interface BlockBindingSource {
+    connectionId: string;
+    table: string;
+}
+/**
+ * Resolve `config.binding` to the `{ connectionId, table }` a mutate intent
+ * needs. The descriptor names the table at `binding.source.name` (+ an optional
+ * `schema` qualifier for Postgres) — NOT `binding.table` (04 §5).
+ *
+ * `null` for an unbound (demo) widget: an edit then has nowhere to go, so the
+ * blocks skip emitting rather than inventing a table name.
+ */
+export declare function blockBindingSourceOf(binding: {
+    connectionId: string;
+    source: {
+        schema?: string | undefined;
+        name: string;
+    };
+} | undefined): BlockBindingSource | null;
+export declare function rowsData<T>(rows: readonly T[]): RowsData<T>;
+export declare function rowData<T>(row: T | null): RowData<T>;
+export declare function categoricalData(items: readonly {
+    label: string;
+    value: number;
+}[]): CategoricalData;
+//# sourceMappingURL=block-lib.d.ts.map

package/dist/families/domain/block-lib.d.ts.map

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