base-paint 0.3.14 → 0.3.16

package/dist/components/cash-waterline/fields.js

@@ -0,0 +1,215 @@
+/** cash-waterline · **入参小件**（格式化与校验；三个形态共用同一批，故单独一份）。
+ *
+ *  为什么独立成件：`model.ts` 里三形态的归一化已经够长，再叠这批小件就过本包的行数告警线
+ *  （350 行／LF 口径，见 `packages/base-render/AGENTS.md`）。分开之后：
+ *   · **一个规矩只有一处**：「千分位／负号写法」「越界的报错句」「形态与读数对不上就拒」都只在本文件里；
+ *   · **没有环**：本文件只依赖 `attrs.ts` 与 `shared/validate.ts`，`model.ts` 单向依赖它。
+ *
+ *  报错句的口径（别处也会读它）：每句都点名**路径**（`cash-waterline: input.days[2].pct`）与**为什么**——
+ *  调用方按句自证，皮肤矩阵判据也按句补样例（见 `test/皮肤矩阵.test.mjs` 的 `repairOnce`）。
+ */
+import { assertPlainObject, badInput, reqText } from '../shared/validate.js';
+import { CASH_WATERLINE_MAX_DAYS, CASH_WATERLINE_MAX_LABEL_CHARS, CASH_WATERLINE_MAX_LINES, CASH_WATERLINE_MAX_WEEKS, } from './attrs.js';
+/* ── 格式化 ─────────────────────────────────────────────────────── */
+/** 千分位：每三位插一个空格（与 `stacked-bar`／`progress-list` 同款；读数一律 `tabular-nums`）。 */
+function group(s) {
+    const neg = s.startsWith('-');
+    const body = neg ? s.slice(1) : s;
+    let out = '';
+    for (let i = 0; i < body.length; i += 1) {
+        if (i > 0 && (body.length - i) % 3 === 0)
+            out += ' ';
+        out += body[i];
+    }
+    return (neg ? '-' : '') + out;
+}
+/** 负号统一写 U+2212（与原型墙和 `invoice-lines` 的减项同一个字；ASCII `-` 在钱数里太短）。 */
+function minus(s) {
+    return s.startsWith('-') ? '−' + s.slice(1) : s;
+}
+/** 大数（`|n| ≥ 1e21`）会长成指数记法（`1e+21`）：那种串**一个分组都不能插**——
+ *  插进去就成了「1. 797 693 134 862 315 7e+ 308」这种读不出来的东西（2026-09-25 审查席实测抓到）。
+ *  指数记法与 `Number.MAX_VALUE` 一律由这里收口，统一写成 `1.8e+21` 这种干净形状
+ *  （先例：`scatter-fit` 的 `plainText` 同一条口径）。 */
+function plain(n) {
+    const s = String(n);
+    if (!/[eE]/.test(s))
+        return s;
+    return n.toExponential(2).replace(/\.?0+e/, 'e');
+}
+/** 机器数 → 屏上的字：整数走千分位；小数最多两位（末尾的 0 去掉）；指数记法原样（**不分组**）。 */
+export function fmtQty(n) {
+    const p = plain(n);
+    if (/[eE]/.test(p))
+        return p;
+    if (Number.isInteger(n))
+        return minus(group(p));
+    const rounded = Math.round(n * 100) / 100;
+    const s = String(rounded);
+    const dot = s.indexOf('.');
+    return minus(group(s.slice(0, dot)) + s.slice(dot));
+}
+/** 百分数 → 一位小数；整数不写 `.0`；大到走指数记法时原样（不分组、不补小数点）。 */
+export function fmtPct(pct) {
+    const r = Math.round(pct * 10) / 10;
+    const p = plain(r);
+    if (/[eE]/.test(p))
+        return p;
+    return minus(Number.isInteger(r) ? String(r) : r.toFixed(1));
+}
+/* ── 数 ─────────────────────────────────────────────────────────── */
+/** 必须是有限数。 */
+export function reqFinite(value, field) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        badInput(field + ' 必须是有限数');
+    }
+    return value;
+}
+/** 有限数且落在 `[min, max]` 里。 */
+function reqInRange(value, field, min, max) {
+    const n = reqFinite(value, field);
+    if (n < min || n > max) {
+        badInput(field + ' 必须在 ' + String(min) + '–' + String(max) + ' 之间（拿到 ' + String(n) + '）');
+    }
+    return n;
+}
+/** 有限数且 `> 0`。 */
+export function reqPositive(value, field) {
+    const n = reqFinite(value, field);
+    if (n <= 0)
+        badInput(field + ' 必须大于 0');
+    return n;
+}
+/** 有限数且 `≥ 0`（那天花了多少：**负的花费不存在**，静默上屏一句「那天花 −100 元」是在替调用方编账）。 */
+export function reqNonNegative(value, field) {
+    const n = reqFinite(value, field);
+    if (n < 0)
+        badInput(field + ' 必须 ≥ 0（那天不可能花负数）');
+    return n;
+}
+/** 整数且落在 `[min, max]` 里。 */
+export function reqInt(value, field, min, max) {
+    const n = reqFinite(value, field);
+    if (!Number.isInteger(n) || n < min || n > max) {
+        badInput(field + ' 必须是 ' + String(min) + '–' + String(max) + ' 之间的整数（拿到 ' + String(n) + '）');
+    }
+    return n;
+}
+/** 可选整数（给了才校验）。 */
+export function optInt(value, field, min, max) {
+    return value === undefined ? undefined : reqInt(value, field, min, max);
+}
+/** 可选数（给了才校验）。 */
+export function optInRange(value, field, min, max) {
+    return value === undefined ? undefined : reqInRange(value, field, min, max);
+}
+/** 非空数组（件自己的报错点名**至少要几个**，皮肤矩阵判据按这句补样例）。 */
+function reqList(value, field, max, what) {
+    if (!Array.isArray(value) || value.length === 0) {
+        badInput(field + ' 必须是非空数组（' + what + '；至少要 1 个）');
+    }
+    if (value.length > max) {
+        badInput(field + ' 最多 ' + String(max) + ' 个（再多就请调用方先归并）');
+    }
+    return value;
+}
+/** **形态与读数对不上就拒**：别的形态的键出现在这一形态里 ⇒ `badInput`。 */
+export function forbid(raw, form, keys) {
+    for (const key of keys) {
+        if (raw[key] !== undefined) {
+            badInput('cash-waterline: 形态 `' + form + '` 不吃 input.' + key
+                + '（那是别的形态的读数；换形态请把 input.form 一起换，本件不替你挑一个）');
+        }
+    }
+}
+/* ── 键表与「未知键一律拒」 ───────────────────────────────────────
+ *  **键在不在表里**由这一节管（写错键名＝拒）；**形态对不对**仍归上面的 `forbid`（报错句更具体：
+ *  它说得清"那是别的形态的读数"）。两者分工：本节的顶层表收**全部形态的入参面**（`attrs.ts` 的
+ *  `CashWaterlineInput` 逐字段），故形态专属键由 `forbid` 拦、真正的未知键由本节拦。 */
+/** 只许入参表里写着的键：多给一个键（多半是打错名）＝拒，不静默吞掉——写错的键被吞掉时，
+ *  屏上只是静静地少一块，调用方却以为自己设上了。
+ *
+ *  **两条路都要走**（只走 `Object.keys` 会漏掉一半）：
+ *   · `Object.getOwnPropertyNames` —— 自有的**全部**键，含**不可枚举**的（`Object.keys` 看不见它）；
+ *   · `for…in` —— 走**整条原型链**（`Object.create({bogus:1})` 那种继承来的键就是这一路）。
+ *  先例：`kanban-columns/model.ts` 与 `relation-picker/model.ts` 的同名小件。
+ */
+export function assertKeys(raw, allowed, field) {
+    const bad = [];
+    const note = (key) => {
+        if (!allowed.includes(key) && !bad.includes(key))
+            bad.push(key);
+    };
+    for (const key of Object.getOwnPropertyNames(raw))
+        note(key);
+    for (const key in raw)
+        note(key);
+    if (bad.length > 0) {
+        badInput(field + ' 里没有 `' + bad.join('`／`') + '` 这个键（入参表以外的键一律拒：'
+            + '写错的键静默吞掉会让调用方以为自己设上了；继承来的与不可枚举的键同样算）');
+    }
+}
+/** `CashWaterlineInput` 的键（顶层入参表：三形态的入参面合起来，逐字段照 `attrs.ts` 列全）。 */
+export const CASH_WATERLINE_INPUT_KEYS = ['title', 'stamp', 'form', 'thresholdPct', 'days',
+    'todayIndex', 'weeks', 'budget', 'inflow', 'outflow', 'inflowCount', 'outflowCount',
+    'elapsedDays', 'remainDays', 'unit', 'note', 'extraClass'];
+/** `CashWaterlineDay` 的键（一天：`label`／`axisLabel`／`pct`／`spend`）。 */
+export const CASH_WATERLINE_DAY_KEYS = ['label', 'axisLabel', 'pct', 'spend'];
+/** `CashWaterlineWeek` 的键（一周：`label`／`inflow`／`outflow`——**净与累计已用是本件算的**）。 */
+export const CASH_WATERLINE_WEEK_KEYS = ['label', 'inflow', 'outflow'];
+/** `CashWaterlineFlowLine` 的键（进出水的一行：`name`／`amount`）。 */
+export const CASH_WATERLINE_FLOW_LINE_KEYS = ['name', 'amount'];
+/* ── 各形态的读数（形状） ───────────────────────────────────────── */
+/** 一天：逐字段校验（**日期非空且够短、余量 0–100、花费 ≥ 0**）。 */
+export function reqDays(value) {
+    return reqList(value, 'cash-waterline: input.days', CASH_WATERLINE_MAX_DAYS, '逐日读数，一天一条').map((one, i) => {
+        assertPlainObject(one, 'cash-waterline: input.days[' + String(i) + ']');
+        const day = one;
+        const at = 'cash-waterline: input.days[' + String(i) + ']';
+        assertKeys(day, CASH_WATERLINE_DAY_KEYS, at);
+        const label = reqText(day.label, at + '.label');
+        if (label.length > CASH_WATERLINE_MAX_LABEL_CHARS) {
+            badInput(at + '.label 至多 ' + String(CASH_WATERLINE_MAX_LABEL_CHARS)
+                + ' 个字符（点名那块只放得下短日期——请调用方给短日期）');
+        }
+        const axisLabel = day.axisLabel === undefined ? undefined
+            : reqText(day.axisLabel, at + '.axisLabel');
+        if (axisLabel !== undefined && axisLabel.length > CASH_WATERLINE_MAX_LABEL_CHARS) {
+            badInput(at + '.axisLabel 至多 ' + String(CASH_WATERLINE_MAX_LABEL_CHARS)
+                + ' 个字符（那一格只有一根柱子那么宽，长了会在窄档折成好几行）');
+        }
+        return {
+            label,
+            axisLabel,
+            pct: reqInRange(day.pct, at + '.pct', 0, 100),
+            spend: day.spend === undefined ? undefined : reqNonNegative(day.spend, at + '.spend'),
+        };
+    });
+}
+/** 一周：`inflow`／`outflow` 都是 ≥0 的有限数（净额与占比由本件算，**调用方不给**）。 */
+export function reqWeeks(value) {
+    return reqList(value, 'cash-waterline: input.weeks', CASH_WATERLINE_MAX_WEEKS, '逐周读数，一周一条').map((one, i) => {
+        assertPlainObject(one, 'cash-waterline: input.weeks[' + String(i) + ']');
+        const w = one;
+        const at = 'cash-waterline: input.weeks[' + String(i) + ']';
+        assertKeys(w, CASH_WATERLINE_WEEK_KEYS, at);
+        return {
+            label: reqText(w.label, at + '.label'),
+            inflow: reqNonNegative(w.inflow, at + '.inflow'),
+            outflow: reqNonNegative(w.outflow, at + '.outflow'),
+        };
+    });
+}
+/** 进出水的一行（名字非空、金额 **> 0**：零金额的行看不见，也不该占一行）。 */
+export function reqFlowLines(value, field) {
+    return reqList(value, field, CASH_WATERLINE_MAX_LINES, '明细行，一行一条').map((one, i) => {
+        assertPlainObject(one, field + '[' + String(i) + ']');
+        const line = one;
+        assertKeys(line, CASH_WATERLINE_FLOW_LINE_KEYS, field + '[' + String(i) + ']');
+        return {
+            name: reqText(line.name, field + '[' + String(i) + '].name'),
+            amount: reqPositive(line.amount, field + '[' + String(i) + '].amount'),
+        };
+    });
+}
+//# sourceMappingURL=fields.js.map

package/dist/components/cash-waterline/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../../src/components/cash-waterline/fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EACL,uBAAuB,EACvB,8BAA8B,EAC9B,wBAAwB,EACxB,wBAAwB,GAIzB,MAAM,YAAY,CAAC;AAEpB,oEAAoE;AAEpE,4EAA4E;AAC5E,SAAS,KAAK,CAAC,CAAS;IACtB,MAAM,GAAG,GAAG,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,GAAG,IAAI,GAAG,CAAC;QACrD,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;AAChC,CAAC;AAED,oEAAoE;AACpE,SAAS,KAAK,CAAC,CAAS;IACtB,OAAO,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED;;;8CAG8C;AAC9C,SAAS,KAAK,CAAC,CAAS;IACtB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AACnD,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,MAAM,CAAC,CAAS;IAC9B,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACnB,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IAC7B,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IAC1C,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1B,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;IACpC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACnB,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,sEAAsE;AAEtE,cAAc;AACd,MAAM,UAAU,SAAS,CAAC,KAAc,EAAE,KAAa;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,6BAA6B;AAC7B,SAAS,UAAU,CAAC,KAAc,EAAE,KAAa,EAAE,GAAW,EAAE,GAAW;IACzE,MAAM,CAAC,GAAG,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;QACvB,QAAQ,CAAC,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,kBAAkB;AAClB,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,KAAa;IACvD,MAAM,CAAC,GAAG,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI,CAAC;QAAE,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IACxC,OAAO,CAAC,CAAC;AACX,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,KAAa;IAC1D,MAAM,CAAC,GAAG,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG,CAAC;QAAE,QAAQ,CAAC,KAAK,GAAG,mBAAmB,CAAC,CAAC;IACjD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,MAAM,CAAC,KAAc,EAAE,KAAa,EAAE,GAAW,EAAE,GAAW;IAC5E,MAAM,CAAC,GAAG,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;QAC/C,QAAQ,CAAC,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IAC/F,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,mBAAmB;AACnB,MAAM,UAAU,MAAM,CAAC,KAAc,EAAE,KAAa,EAAE,GAAW,EAAE,GAAW;IAC5E,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAC1E,CAAC;AAED,kBAAkB;AAClB,MAAM,UAAU,UAAU,CAAC,KAAc,EAAE,KAAa,EAAE,GAAW,EAAE,GAAW;IAChF,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAC9E,CAAC;AAED,4CAA4C;AAC5C,SAAS,OAAO,CAAC,KAAc,EAAE,KAAa,EAAE,GAAW,EAAE,IAAY;IACvE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,QAAQ,CAAC,KAAK,GAAG,WAAW,GAAG,IAAI,GAAG,WAAW,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QACvB,QAAQ,CAAC,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,KAA2C,CAAC;AACrD,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,MAAM,CAAC,GAA4B,EAAE,IAAY,EAAE,IAAuB;IACxF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3B,QAAQ,CAAC,sBAAsB,GAAG,IAAI,GAAG,aAAa,GAAG,GAAG;kBACxD,2CAA2C,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;+DAG+D;AAE/D;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,OAA0B,EAAE,KAAa;IAC/E,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,CAAC,GAAW,EAAQ,EAAE;QACjC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClE,CAAC,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC;QAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7D,KAAK,MAAM,GAAG,IAAI,GAAG;QAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnB,QAAQ,CAAC,KAAK,GAAG,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,mBAAmB;cAC7D,sCAAsC,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,oEAAoE;AACpE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM;IACxF,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc;IACnF,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAU,CAAC;AAEtE,mEAAmE;AACnE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,CAAU,CAAC;AAEvF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAEhF,0DAA0D;AAC1D,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAU,CAAC;AAEzE,6DAA6D;AAE7D,6CAA6C;AAC7C,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,OAAO,CAAC,KAAK,EAAE,4BAA4B,EAAE,uBAAuB,EAAE,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QACvG,iBAAiB,CAAC,GAAG,EAAE,6BAA6B,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;QACxE,MAAM,GAAG,GAAG,GAA8B,CAAC;QAC3C,MAAM,EAAE,GAAG,6BAA6B,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QAC3D,UAAU,CAAC,GAAG,EAAE,uBAAuB,EAAE,EAAE,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,GAAG,QAAQ,CAAC,CAAC;QAChD,IAAI,KAAK,CAAC,MAAM,GAAG,8BAA8B,EAAE,CAAC;YAClD,QAAQ,CAAC,EAAE,GAAG,YAAY,GAAG,MAAM,CAAC,8BAA8B,CAAC;kBAC/D,6BAA6B,CAAC,CAAC;QACrC,CAAC;QACD,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS;YACvD,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,GAAG,YAAY,CAAC,CAAC;QAC9C,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,8BAA8B,EAAE,CAAC;YACjF,QAAQ,CAAC,EAAE,GAAG,gBAAgB,GAAG,MAAM,CAAC,8BAA8B,CAAC;kBACnE,gCAAgC,CAAC,CAAC;QACxC,CAAC;QACD,OAAO;YACL,KAAK;YACL,SAAS;YACT,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC;YAC7C,KAAK,EAAE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,GAAG,QAAQ,CAAC;SACtF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,CAAC,KAAK,EAAE,6BAA6B,EAAE,wBAAwB,EAAE,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QACzG,iBAAiB,CAAC,GAAG,EAAE,8BAA8B,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;QACzE,MAAM,CAAC,GAAG,GAA8B,CAAC;QACzC,MAAM,EAAE,GAAG,8BAA8B,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QAC5D,UAAU,CAAC,CAAC,EAAE,wBAAwB,EAAE,EAAE,CAAC,CAAC;QAC5C,OAAO;YACL,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,GAAG,QAAQ,CAAC;YACtC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,GAAG,SAAS,CAAC;YAChD,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,GAAG,UAAU,CAAC;SACpD,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,YAAY,CAAC,KAAc,EAAE,KAAa;IACxD,OAAO,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,wBAAwB,EAAE,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QAChF,iBAAiB,CAAC,GAAG,EAAE,KAAK,GAAG,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,GAA8B,CAAC;QAC5C,UAAU,CAAC,IAAI,EAAE,6BAA6B,EAAE,KAAK,GAAG,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;QAC/E,OAAO;YACL,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC;YAC5D,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,GAAG,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC;SACvE,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/components/cash-waterline/index.d.ts

@@ -0,0 +1,14 @@
+/** cash-waterline · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  四件出口：`renderCashWaterline(input)`（产标记，零 DOM）／`cashWaterlineCss()`（样式段）／
+ *  `CASH_WATERLINE_FORMS`（形态闭集：水位柱／子弹图／进出水三栏）／`CASH_WATERLINE_CLASS` 与
+ *  `cashWaterlineSlot()`（标记契约）；另有尺常量（画布高度、底线缺省、两处上限）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ */
+export { renderCashWaterline } from './render.js';
+export type { CashWaterlineDay, CashWaterlineFlowLine, CashWaterlineForm, CashWaterlineInput, CashWaterlineSlot, CashWaterlineWeek, } from './attrs.js';
+export { CASH_WATERLINE_CLASS, CASH_WATERLINE_DEFAULT_THRESHOLD_PCT, CASH_WATERLINE_DEFAULT_UNIT, CASH_WATERLINE_FORMS, CASH_WATERLINE_HEIGHT_VAR, CASH_WATERLINE_MAX_AXIS_COLUMNS, CASH_WATERLINE_MAX_AXIS_LABELS, CASH_WATERLINE_MAX_DAYS, CASH_WATERLINE_MAX_LABEL_CHARS, CASH_WATERLINE_MAX_LINES, CASH_WATERLINE_MAX_WEEKS, CASH_WATERLINE_MISSING, CASH_WATERLINE_SLOTS, CASH_WATERLINE_THRESHOLD_VAR, CASH_WATERLINE_USED_THRESHOLD_VAR, CASH_WATERLINE_WIDTH_VAR, cashWaterlineSlot, } from './attrs.js';
+export { CASH_WATERLINE_NARROW_PLOT_HEIGHT_PX, cashWaterlineCss } from './style.js';
+export { CASH_WATERLINE_PLOT_HEIGHT_PX } from './style-forms.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/cash-waterline/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/cash-waterline/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,oBAAoB,EACpB,oCAAoC,EACpC,2BAA2B,EAC3B,oBAAoB,EACpB,yBAAyB,EACzB,+BAA+B,EAC/B,8BAA8B,EAC9B,uBAAuB,EACvB,8BAA8B,EAC9B,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,4BAA4B,EAC5B,iCAAiC,EACjC,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oCAAoC,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/components/cash-waterline/index.js

@@ -0,0 +1,13 @@
+/** cash-waterline · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  四件出口：`renderCashWaterline(input)`（产标记，零 DOM）／`cashWaterlineCss()`（样式段）／
+ *  `CASH_WATERLINE_FORMS`（形态闭集：水位柱／子弹图／进出水三栏）／`CASH_WATERLINE_CLASS` 与
+ *  `cashWaterlineSlot()`（标记契约）；另有尺常量（画布高度、底线缺省、两处上限）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ */
+export { renderCashWaterline } from './render.js';
+export { CASH_WATERLINE_CLASS, CASH_WATERLINE_DEFAULT_THRESHOLD_PCT, CASH_WATERLINE_DEFAULT_UNIT, CASH_WATERLINE_FORMS, CASH_WATERLINE_HEIGHT_VAR, CASH_WATERLINE_MAX_AXIS_COLUMNS, CASH_WATERLINE_MAX_AXIS_LABELS, CASH_WATERLINE_MAX_DAYS, CASH_WATERLINE_MAX_LABEL_CHARS, CASH_WATERLINE_MAX_LINES, CASH_WATERLINE_MAX_WEEKS, CASH_WATERLINE_MISSING, CASH_WATERLINE_SLOTS, CASH_WATERLINE_THRESHOLD_VAR, CASH_WATERLINE_USED_THRESHOLD_VAR, CASH_WATERLINE_WIDTH_VAR, cashWaterlineSlot, } from './attrs.js';
+export { CASH_WATERLINE_NARROW_PLOT_HEIGHT_PX, cashWaterlineCss } from './style.js';
+export { CASH_WATERLINE_PLOT_HEIGHT_PX } from './style-forms.js';
+//# sourceMappingURL=index.js.map

package/dist/components/cash-waterline/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/cash-waterline/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AASlD,OAAO,EACL,oBAAoB,EACpB,oCAAoC,EACpC,2BAA2B,EAC3B,oBAAoB,EACpB,yBAAyB,EACzB,+BAA+B,EAC/B,8BAA8B,EAC9B,uBAAuB,EACvB,8BAA8B,EAC9B,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,4BAA4B,EAC5B,iCAAiC,EACjC,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oCAAoC,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/components/cash-waterline/model.d.ts

@@ -0,0 +1,117 @@
+/** 横轴的两种出法：`columns`＝一格一天（逐格对齐）／`range`＝一行区间读数（天数多到格子站不下字）。 */
+export type CashWaterlineAxis = {
+    readonly mode: 'columns';
+} | {
+    readonly mode: 'range';
+    readonly rangeText: string;
+    readonly todayText?: string;
+};
+/** 形态 `waterline` 的一天（归一化后：柱高、点名信息、横轴刻度都已定）。 */
+export interface CashWaterlineDayModel {
+    readonly label: string;
+    readonly pct: number;
+    readonly pctText: string;
+    /** 那天花了多少（**缺值写 `—`**，不写 0）。 */
+    readonly spendText: string;
+    /** 跌破底线（**严格小于**底线：正好压在线上不算跌破）。 */
+    readonly low: boolean;
+    readonly today: boolean;
+    /** 横轴上要不要出这一天的字（其余天是空串）——**至多 `CASH_WATERLINE_MAX_AXIS_LABELS` 枚**。 */
+    readonly axis: string;
+}
+/** 告急日点名的一行。 */
+export interface CashWaterlineLowRow {
+    readonly label: string;
+    readonly pctText: string;
+    readonly spendText: string;
+}
+/** 形态 `bullet` 的一周。 */
+export interface CashWaterlineWeekModel {
+    readonly label: string;
+    readonly inflowText: string;
+    readonly outflowText: string;
+    /** 净额（带符号：`+6 760`／`−1 980`）。 */
+    readonly netText: string;
+    /** 本周结束时累计已用掉的比例（%）。 */
+    readonly usedPct: number;
+    readonly usedText: string;
+    /** 越过 100%（**条形画到满格，读数照实写**）。 */
+    readonly over: boolean;
+    /** 余量跌破底线（累计已用 > `100 − 底线`）。 */
+    readonly low: boolean;
+    /** 轨道填充宽度（%，封顶 100）。 */
+    readonly fillPct: number;
+}
+/** 进出水三栏里的一行。 */
+export interface CashWaterlineFlowLineModel {
+    readonly name: string;
+    readonly amountText: string;
+    /** 同行内与所在栏合计之比（%，封顶 100）。 */
+    readonly fillPct: number;
+}
+/** 形态 `flow` 的读数与判定。 */
+export interface CashWaterlineFlowReads {
+    readonly inflow: readonly CashWaterlineFlowLineModel[];
+    readonly outflow: readonly CashWaterlineFlowLineModel[];
+    readonly inCountText: string;
+    readonly outCountText: string;
+    readonly inTotalText: string;
+    readonly outTotalText: string;
+    readonly leftText: string;
+    readonly leftPctText: string;
+    /** 余量占预算（%，可能为负——超支时照实写负数）。 */
+    readonly leftPct: number;
+    readonly leftFillPct: number;
+    readonly avgText: string;
+    readonly needText: string;
+    readonly verdictWord: string;
+    readonly verdictText: string;
+    readonly ok: boolean;
+}
+/** 三形态共有的那几项。 */
+interface CashWaterlineCommon {
+    readonly title: string;
+    readonly stamp?: string;
+    readonly unit: string;
+    readonly note: string;
+    readonly thresholdPct: number;
+    readonly thresholdText: string;
+    /** 总预算写成钱了（给了 `budget` 才有）：卡头第三格「底线 1 800 元」用它。 */
+    readonly budgetText?: string;
+    readonly extraClass?: string;
+}
+export interface CashWaterlineWaterlineModel extends CashWaterlineCommon {
+    readonly form: 'waterline';
+    readonly days: readonly CashWaterlineDayModel[];
+    readonly lowRows: readonly CashWaterlineLowRow[];
+    readonly lowCount: number;
+    readonly legendLow: string;
+    readonly todayIndex?: number;
+    /** 横轴怎么出（逐格刻度／一行区间读数）。 */
+    readonly axis: CashWaterlineAxis;
+    /** 卡头第三格：「底线 1 800 元（30%）」（给了 `budget`）／「底线 30%」。 */
+    readonly headExtra: string;
+    readonly ariaLabel: string;
+}
+export interface CashWaterlineBulletModel extends CashWaterlineCommon {
+    readonly form: 'bullet';
+    readonly weeks: readonly CashWaterlineWeekModel[];
+    readonly usedThresholdPct: number;
+    readonly legendLow: string;
+    /** 卡头第三格：「竖线＝底线 30%」。 */
+    readonly headExtra: string;
+    readonly ariaLabel: string;
+}
+export interface CashWaterlineFlowModel extends CashWaterlineCommon {
+    readonly form: 'flow';
+    readonly flow: CashWaterlineFlowReads;
+    /** 卡头第三格：「还剩 6 天」。 */
+    readonly headExtra: string;
+    readonly ariaLabel: string;
+}
+/** 内部类型：每个字段都已校验、已归一、已算好（`render.ts` 只负责拼标记）。 */
+export type CashWaterlineModel = CashWaterlineWaterlineModel | CashWaterlineBulletModel | CashWaterlineFlowModel;
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `CashWaterlineModel`，不再自己碰 `any`。 */
+export declare function normalizeCashWaterline(input: unknown): CashWaterlineModel;
+export {};
+//# sourceMappingURL=model.d.ts.map

package/dist/components/cash-waterline/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/components/cash-waterline/model.ts"],"names":[],"mappings":"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"}

package/dist/components/cash-waterline/model.js

@@ -0,0 +1,244 @@
+/** cash-waterline · **入参归一化与校验**（把 `any` 与说不出的 `unknown` 挡在门外，产出内部类型）。
+ *
+ *  四条口径：
+ *   1. **非法入参一律 `badInput()`**（抛 `BlocksError`）——不静默降级、不「尽量猜」：
+ *      少一天与给错形态画出来都是"另外一张图"，而调用方以为自己拿到了想要的骨架。
+ *   2. **读数的派生量只算一次**：柱高／条宽／净额／累计已用／占比／判定句全部从同一批输入出，
+ *      渲染期不再自己算（两处各算一次必然走散）。
+ *   3. 归一化只做「形状」与「算数」：**千分位由本件做**（这是排版），聚合与单位口径归调用方。
+ *   4. **形态与读数对不上就拒**：`form` 是 `bullet` 却塞了 `days` ⇒ `badInput`
+ *      （给错读数说明调用方拿错了骨架，静默挑一个只会把错画得更像对的）。
+ */
+import { assertPlainObject, badInput, optExtraClass, optText, reqText } from '../shared/validate.js';
+import { CASH_WATERLINE_DEFAULT_THRESHOLD_PCT, CASH_WATERLINE_DEFAULT_UNIT, CASH_WATERLINE_FORMS, CASH_WATERLINE_MAX_AXIS_COLUMNS, CASH_WATERLINE_MAX_AXIS_LABELS, CASH_WATERLINE_MISSING, } from './attrs.js';
+/* 格式化与校验小件都住在 `fields.ts`（同一批三个形态共用，理由见那份的文件头）。 */
+import { forbid, fmtPct, fmtQty, optInRange, optInt, reqDays, reqFlowLines, reqInt, reqPositive, reqWeeks, assertKeys, CASH_WATERLINE_INPUT_KEYS } from './fields.js';
+/** 横轴上要写字的那几列（**至多 `CASH_WATERLINE_MAX_AXIS_LABELS` 枚**）。
+ *
+ *  三条不变量（判据对所有 1–31 天的长度逐条断）：
+ *   ① **枚数 ≤ 上限**：步长按「首尾已占两枚」算 ⇒ `stride = ceil((n−1) / (上限−1))`，
+ *      中间再密也塞得下（旧算法 `ceil(n / 上限)` 在 n=12/17/18… 这些长度上会出 7 枚，2026-09-25 审查席抓到）；
+ *   ② **首尾必出**（第一列与最后一列是这段读数的两个端点）；
+ *   ③ **今天必占一枚**（月中标今天是常态：今天落在哪一列，哪一列就得写出「今天」——
+ *      旧算法在 todayIndex=5/10 这些不在刻度位上的列上会把「今天」整条吞掉）。 */
+function axisColumns(n, todayIndex) {
+    const stride = Math.max(1, Math.ceil((n - 1) / (CASH_WATERLINE_MAX_AXIS_LABELS - 1)));
+    const picked = [];
+    for (let i = 0; i < n; i += 1) {
+        if (i === 0 || i === n - 1 || i % stride === 0)
+            picked.push(i);
+    }
+    if (todayIndex !== undefined && !picked.includes(todayIndex)) {
+        /* 换掉离今天最近的那一枚「中间位」（首尾不动、枚数不变）——今天一定写得出来，总数也不超上限。 */
+        const middle = picked.filter((i) => i !== 0 && i !== n - 1);
+        let drop = middle[0];
+        for (const i of middle)
+            if (Math.abs(i - todayIndex) < Math.abs(drop - todayIndex))
+                drop = i;
+        picked.splice(picked.indexOf(drop), 1, todayIndex);
+    }
+    return picked.sort((a, b) => a - b);
+}
+/** 逐日水位柱：柱高就是余量，跌破底线的日子逐条点名。 */
+function buildWaterline(raw, common) {
+    forbid(raw, 'waterline', ['weeks', 'inflow', 'outflow', 'elapsedDays', 'remainDays']);
+    const days = reqDays(raw.days);
+    const todayIndex = optInt(raw.todayIndex, 'cash-waterline: input.todayIndex', 0, days.length - 1);
+    const n = days.length;
+    /* 天数多于逐格刻度的上限 ⇒ 改出一行区间读数（见 `CASH_WATERLINE_MAX_AXIS_COLUMNS` 那句）。 */
+    const dense = n > CASH_WATERLINE_MAX_AXIS_COLUMNS;
+    const picked = dense ? [] : axisColumns(n, todayIndex);
+    const built = days.map((day, i) => {
+        const today = todayIndex === i;
+        return {
+            label: day.label,
+            pct: day.pct,
+            pctText: fmtPct(day.pct) + '%',
+            spendText: day.spend === undefined ? CASH_WATERLINE_MISSING : fmtQty(day.spend) + ' ' + common.unit,
+            low: day.pct < common.thresholdPct,
+            today,
+            /* 今天那一格写「今天」；其余刻度位写**轴上那枚字**（`axisLabel`，缺省＝日期；
+               两者都占着自己那一列，**逐格对齐**）。 */
+            axis: today && !dense ? '今天' : (picked.includes(i) ? (day.axisLabel ?? day.label) : ''),
+        };
+    });
+    const lowRows = built.filter((d) => d.low)
+        .map((d) => ({ label: d.label, pctText: d.pctText, spendText: d.spendText }));
+    const lowCount = lowRows.length;
+    /* 图例那句话：**连着跌**才说「X 起 N 天」（不连着的说「共 N 天」——「起 N 天」会骗人）。 */
+    const lowAt = built.map((d, i) => (d.low ? i : -1)).filter((i) => i >= 0);
+    const contiguous = lowAt.every((at, i) => i === 0 || at === lowAt[i - 1] + 1);
+    const legendLow = lowCount === 0 ? '全程在底线之上'
+        : (contiguous ? built[lowAt[0]].label + ' 起 ' + String(lowCount) + ' 天'
+            : '共 ' + String(lowCount) + ' 天');
+    const first = built[0];
+    const last = built[n - 1];
+    return {
+        ...common,
+        form: 'waterline',
+        days: built,
+        lowRows,
+        lowCount,
+        legendLow,
+        todayIndex,
+        axis: dense
+            ? { mode: 'range', rangeText: first.label + ' – ' + last.label,
+                todayText: todayIndex === undefined ? undefined : '今天 ' + built[todayIndex].label }
+            : { mode: 'columns' },
+        headExtra: common.budgetText === undefined
+            ? '底线 ' + common.thresholdText
+            : '底线 ' + common.budgetText + '（' + common.thresholdText + '）',
+        ariaLabel: '逐日水位柱：' + first.label + ' 余量 ' + first.pctText + '，' + last.label + ' 余量 ' + last.pctText
+            + (todayIndex === undefined ? '' : '，今天（' + built[todayIndex].label + '）余量 ' + built[todayIndex].pctText)
+            + '；底线 ' + common.thresholdText + '；'
+            + (lowCount === 0 ? '全程在底线之上' : legendLow + '跌破底线'),
+    };
+}
+/** 每周子弹图：横条＝**累计**已用掉的比例，竖线＝跌破底线的那个位置。 */
+function buildBullet(raw, common) {
+    forbid(raw, 'bullet', ['days', 'todayIndex', 'inflow', 'outflow', 'elapsedDays', 'remainDays']);
+    const weeks = reqWeeks(raw.weeks);
+    const budget = reqPositive(raw.budget, 'cash-waterline: input.budget');
+    let used = 0;
+    const built = weeks.map((week) => {
+        used += week.outflow;
+        const usedPct = Math.round((used / budget) * 1000) / 10;
+        const net = week.inflow - week.outflow;
+        const over = usedPct > 100;
+        return {
+            label: week.label,
+            inflowText: fmtQty(week.inflow),
+            outflowText: fmtQty(week.outflow),
+            /* 净额 0 写「0」（**不带正号**：`+0` 读起来像"有进账"，而它是不进不出）。 */
+            netText: net === 0 ? '0' : (net < 0 ? '−' : '+') + fmtQty(Math.abs(net)),
+            usedPct,
+            usedText: fmtPct(usedPct) + '%',
+            over,
+            /* 余量跌破底线 ⟺ 已用 > `100 − 底线`（等号不算跌破：正好压在线上）。 */
+            low: usedPct + common.thresholdPct > 100,
+            fillPct: Math.min(100, usedPct),
+        };
+    });
+    const firstLow = built.find((w) => w.low);
+    const legendLow = firstLow === undefined ? '全程在底线之上' : firstLow.label + ' 越过底线';
+    return {
+        ...common,
+        form: 'bullet',
+        weeks: built,
+        usedThresholdPct: Math.round((100 - common.thresholdPct) * 10) / 10,
+        legendLow,
+        headExtra: '竖线＝底线 ' + common.thresholdText,
+        ariaLabel: '每周子弹图：' + built.map((w) => w.label + ' 已用 ' + w.usedText).join('、')
+            + '；底线 ' + common.thresholdText + '（换算成已用是 ' + fmtPct(100 - common.thresholdPct) + '%）；' + legendLow,
+    };
+}
+/** 进出水三栏：进／出／余各一栏，**判定写成字**（撑得住／撑不住 ＋ 差多少）。 */
+function buildFlow(raw, common) {
+    forbid(raw, 'flow', ['days', 'todayIndex', 'weeks']);
+    const inflow = reqFlowLines(raw.inflow, 'cash-waterline: input.inflow');
+    const outflow = reqFlowLines(raw.outflow, 'cash-waterline: input.outflow');
+    const budget = reqPositive(raw.budget, 'cash-waterline: input.budget');
+    const elapsedDays = reqInt(raw.elapsedDays, 'cash-waterline: input.elapsedDays', 1, 366);
+    const remainDays = reqInt(raw.remainDays, 'cash-waterline: input.remainDays', 0, 366);
+    const inTotal = inflow.reduce((acc, l) => acc + l.amount, 0);
+    const outTotal = outflow.reduce((acc, l) => acc + l.amount, 0);
+    const left = inTotal - outTotal;
+    const leftPct = Math.round((left / budget) * 1000) / 10;
+    /* 日均按**已花**算（`出 ÷ 已过天数`）：读的是「按这个花法，剩下的天数要花多少」。 */
+    const avg = Math.round(outTotal / elapsedDays);
+    const need = avg * remainDays;
+    const gap = left - need;
+    const ok = gap >= 0;
+    const money = (n) => fmtQty(n) + ' ' + common.unit;
+    const asLines = (list, total) => list.map((l) => ({
+        name: l.name,
+        amountText: money(l.amount),
+        fillPct: total <= 0 ? 0 : Math.min(100, Math.round((l.amount / total) * 1000) / 10),
+    }));
+    const verdictText = '按这 ' + String(elapsedDays) + ' 天的日均 ' + money(avg) + '，剩下 ' + String(remainDays)
+        + ' 天要花 ' + money(need) + '，' + (ok ? '还余 ' + money(gap) + '。' : '还差 ' + money(-gap) + '。');
+    const flow = {
+        inflow: asLines(inflow, inTotal),
+        outflow: asLines(outflow, outTotal),
+        /* 那一格写「笔」还是「项」：**给没给真笔数**由调用方说清——
+           屏上只列得出 N 行明细，把行数写成「N 笔」是拿明细行数冒名交易笔数（原型那格是「38 笔」）。 */
+        inCountText: raw.inflowCount === undefined
+            ? String(inflow.length) + ' 项'
+            : String(reqInt(raw.inflowCount, 'cash-waterline: input.inflowCount', 1, 1000000)) + ' 笔',
+        outCountText: raw.outflowCount === undefined
+            ? String(outflow.length) + ' 项'
+            : String(reqInt(raw.outflowCount, 'cash-waterline: input.outflowCount', 1, 1000000)) + ' 笔',
+        inTotalText: money(inTotal),
+        outTotalText: money(outTotal),
+        leftText: money(left),
+        leftPctText: '占预算 ' + fmtPct(leftPct) + '%',
+        leftPct,
+        leftFillPct: Math.max(0, Math.min(100, leftPct)),
+        avgText: money(avg),
+        needText: money(need),
+        verdictWord: ok ? '✓ 撑得住' : '！ 撑不住',
+        verdictText,
+        ok,
+    };
+    return {
+        ...common,
+        form: 'flow',
+        flow,
+        headExtra: '还剩 ' + String(remainDays) + ' 天',
+        ariaLabel: '进出水三栏：进 ' + flow.inTotalText + '、出 ' + flow.outTotalText + '、余 ' + flow.leftText
+            + '（' + flow.leftPctText + '）；' + flow.verdictWord + '——' + verdictText,
+    };
+}
+/** 形态 → 骨架的归一化（三个 builder 各自校验自己那份读数）。 */
+const BUILDERS = {
+    waterline: buildWaterline,
+    bullet: buildBullet,
+    flow: buildFlow,
+};
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `CashWaterlineModel`，不再自己碰 `any`。 */
+export function normalizeCashWaterline(input) {
+    assertPlainObject(input, 'renderCashWaterline: input');
+    const raw = input;
+    assertKeys(raw, CASH_WATERLINE_INPUT_KEYS, 'renderCashWaterline: input');
+    const form = raw.form === undefined ? CASH_WATERLINE_FORMS[0] : raw.form;
+    if (!CASH_WATERLINE_FORMS.includes(form)) {
+        badInput('cash-waterline: input.form 必须是 ' + CASH_WATERLINE_FORMS.join('／')
+            + ' 之一（水位柱／子弹图／进出水三栏）');
+    }
+    const thresholdPct = raw.thresholdPct === undefined
+        ? CASH_WATERLINE_DEFAULT_THRESHOLD_PCT
+        : optInRange(raw.thresholdPct, 'cash-waterline: input.thresholdPct', 0, 100);
+    const thresholdText = fmtPct(thresholdPct) + '%';
+    const unit = optText(raw.unit, 'cash-waterline: input.unit') ?? CASH_WATERLINE_DEFAULT_UNIT;
+    /* 预算：三者都收——`bullet`／`flow` 用它算占比（必填，由各自的 builder 校验「给了没有」），
+       `waterline` 可选（收下就把底线写成钱数，卡头第三格「底线 1 800 元（30%）」）。 */
+    const budget = raw.budget === undefined ? undefined : reqPositive(raw.budget, 'cash-waterline: input.budget');
+    const common = {
+        title: reqText(raw.title, 'cash-waterline: input.title'),
+        stamp: optText(raw.stamp, 'cash-waterline: input.stamp'),
+        unit,
+        /* 口径行：不给就由本件按形态写一句（口径是这一件的契约，不该让调用方每次抄一遍）。 */
+        note: optText(raw.note, 'cash-waterline: input.note') ?? defaultNote(form, thresholdText),
+        thresholdPct,
+        thresholdText,
+        budgetText: budget === undefined ? undefined : fmtQty(budget) + ' ' + unit,
+        extraClass: optExtraClass(raw.extraClass, 'cash-waterline: input.extraClass'),
+    };
+    return BUILDERS[form](raw, common);
+}
+/** 不给口径行时本件自己写的那一句（**口径是这一件的契约**，不该由调用方每次抄一遍）。
+ *  口径必须与算出来的东西**是同一件事**：三栏那句说的是"拿余去减要花的钱"，不是"相除"（2026-09-25 审查席抓到
+ *  旧文案写着「＝剩余额度 ÷ 近日均消耗」而实现算的是差额——文案照抄了原型的错）。 */
+function defaultNote(form, thresholdText) {
+    if (form === 'waterline') {
+        return '口径：柱高＝当天结束时「预算 − 已花」占预算的百分比；虚线是底线 ' + thresholdText
+            + '；跌破的那几天在下面逐日点名（日期 ＋ 那天花了多少），不是只把柱子染红。';
+    }
+    if (form === 'bullet') {
+        return '口径：横条＝本周结束时累计已用掉的比例（100% 是整段预算），竖线是余量跌破底线 ' + thresholdText
+            + ' 的位置。超过 100% 的部分条形画到满格、读数里照实点名，不缩回 100%。';
+    }
+    return '口径：进／出／余三栏同一口径（含退款冲抵）；「撑不撑得住」＝拿余去减「按近日均消耗（日均）'
+        + '还要花的钱」：够就说还余多少，不够就说还差多少——判定写成字（撑得住／撑不住 ＋ 差多少），不只靠颜色。';
+}
+//# sourceMappingURL=model.js.map