base-paint 0.3.13 → 0.3.15

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

@@ -0,0 +1,131 @@
+/** cash-waterline · **标记契约**（渲染与调用方共用的唯一事实：类名／形态闭集／槽位闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙 `.scratch/ui-组件墙/新件/parts-数据与仪表.mjs` 里 **64 现金水位**的三个形态
+ *  （2026-09 用户逐格打分 A／B／C **全 4 分**——三个形态都被认可，故一并落进同一件）：
+ *   · `waterline` 逐日水位柱（底线 ＋ 告急日点名）：柱高＝当天结束时「预算 − 已花」占预算的百分比；
+ *   · `bullet`    每周子弹图（实际 ＋ 底线刻度）：横条＝本周结束时累计已用掉的比例，竖线＝跌破底线的位置；
+ *   · `flow`      进出水三栏（构成 ＋ 够不够撑到月底）：进／出／余各一栏，判定写成字。
+ *
+ *  它替掉的三种错法（原型那一件的 `p` 逐字）：
+ *   · 只给一个本月结余数字 —— 看不出是哪几天花超了；
+ *   · 用一条满格的进度条冒充时间轴 —— 存量与消耗混成一个数；
+ *   · 把「跌破底线」只染成红色 —— 说不出是哪几天、那天花了多少。
+ *
+ *  与同族件的分工（别拿这一件当它们用）：
+ *   · `invoice-lines`（金额分解）沿的是**科目**（总额一路加减到明细）；水位沿的是**时间**，读的是「存量还在不在底线之上」；
+ *   · `stacked-bar`（构成条）是一条横条里的占比，没有时间轴、也没有阈值线；
+ *   · `progress-list`（多目标进度）是「已达到 ÷ 目标」的两数之比，没有逐日余量形状，也答不出「几号会跌破底线」。
+ *
+ *  形态键写在 `CASH_WATERLINE_FORMS`（闭集）：闭集外的值一律 `badInput`（不静默降级——
+ *  降级会让调用方以为自己拿到了另一种骨架）。
+ */
+/** 本件的类名根：全部槽位类名都是 `CASH_WATERLINE_CLASS + '-' + 槽名`。 */
+export declare const CASH_WATERLINE_CLASS = "ilife-block-cash-waterline";
+/** 槽位闭集（`render.ts`、`style.ts` 与判据都从这里取名字，不各抄一份字面量）。 */
+export declare const CASH_WATERLINE_SLOTS: readonly ["hd", "title", "hd-tail", "head-extra", "stamp", "plot", "thr", "thr-text", "col", "fill", "xax", "xax-cell", "bullet", "brow", "bhd", "bhd-name", "bhd-num", "net", "over", "rail", "rail-fill", "rail-thr", "three", "card", "card-hd", "card-name", "card-count", "card-total", "line", "line-bar", "line-fill", "line-text", "verdict", "verdict-word", "legend", "legend-item", "swatch", "lowlist", "low-title", "low-rows", "low-row", "low-day", "low-spend", "low-pct", "note"];
+export type CashWaterlineSlot = (typeof CASH_WATERLINE_SLOTS)[number];
+/** 槽类的类名（唯一拼法：别处不许再写 `CASH_WATERLINE_CLASS + '-' + …`）。 */
+export declare function cashWaterlineSlot(slot: CashWaterlineSlot, prefix?: string): string;
+/** 形态闭集：`waterline` 逐日水位柱 ／ `bullet` 每周子弹图 ／ `flow` 进出水三栏。 */
+export declare const CASH_WATERLINE_FORMS: readonly ["waterline", "bullet", "flow"];
+export type CashWaterlineForm = (typeof CASH_WATERLINE_FORMS)[number];
+/** 底线的缺省值（占预算的百分比）：**30%**——与原型墙上那一件同值。 */
+export declare const CASH_WATERLINE_DEFAULT_THRESHOLD_PCT = 30;
+/** 逐日水位柱最多几天（一个月）：再多的日子在窄容器里柱子细到看不见，请调用方先归并到周（换形态 `bullet`）。 */
+export declare const CASH_WATERLINE_MAX_DAYS = 31;
+/** 逐格刻度最多几列（＝最多几天）：再多，一格只有几个像素宽——**一个汉字都站不下**
+ *  （31 天在 320 档，格子 5.5px、一个汉字 12px），刻度字必然越格或越出根。
+ *  超过它就改出**一行区间读数**（`09-01 – 09-31` ＋今天那一格），照实说清这一段是哪几天。 */
+export declare const CASH_WATERLINE_MAX_AXIS_COLUMNS = 14;
+/** 横轴逐格刻度最多出几枚（**算出来的**：多了挤在一起＝压字；日期本身在点名那块里一个不少）。
+ *  三条不变量（判据逐长度断）：**① 枚数 ≤ 这个数**（14 天以内逐格刻度的长度全都成立）；
+ *  **② 第一列必出**；**③ 今天必占一枚**（今天落在哪一列都写得出「今天」）。 */
+export declare const CASH_WATERLINE_MAX_AXIS_LABELS = 6;
+/** 横轴刻度字的长度上限（字符）：那一格只有一根柱子那么宽，长标签会折成好几行、压到隔壁的刻度。
+ *  **日期写法都在范围内**（`09-21` 五个字、`2026-09-24` 十个字）；更长的请调用方自己截短（本件不替你猜）。 */
+export declare const CASH_WATERLINE_MAX_LABEL_CHARS = 10;
+/** 子弹图最多几周（一个月最多 6 周，留一点余量）。 */
+export declare const CASH_WATERLINE_MAX_WEEKS = 8;
+/** 进出水三栏每栏最多几行（多余的尾巴请调用方自己并成「其他」）。 */
+export declare const CASH_WATERLINE_MAX_LINES = 8;
+/** 缺值的写法：**写成 `—`，不许写 0、不许留空**（全仓同一条地板）。 */
+export declare const CASH_WATERLINE_MISSING = "\u2014";
+/** 钱的缺省单位（不给 `unit` 时用它）。 */
+export declare const CASH_WATERLINE_DEFAULT_UNIT = "\u5143";
+/** 一根水位柱的高度（百分数）。 */
+export declare const CASH_WATERLINE_HEIGHT_VAR = "--cash-waterline-h";
+/** 一条填充的宽度（百分数）。 */
+export declare const CASH_WATERLINE_WIDTH_VAR = "--cash-waterline-w";
+/** 底线在画布上的位置（从底往上，百分数）。 */
+export declare const CASH_WATERLINE_THRESHOLD_VAR = "--cash-waterline-thr";
+/** 底线换算成「已用掉多少」时在轨道上的位置（从右壁往左，百分数）＝ `100 − 底线`。 */
+export declare const CASH_WATERLINE_USED_THRESHOLD_VAR = "--cash-waterline-used-thr";
+/** 逐日水位柱的一天：**当天结束时**的余量 ＋ 那天花了多少。 */
+export interface CashWaterlineDay {
+    /** 日期（「09-21」）：上屏在**告急日点名**与无障碍名里；**非空**，且**至多 `CASH_WATERLINE_MAX_LABEL_CHARS` 个字符**。 */
+    readonly label: string;
+    /** **轴上那枚刻度字**（缺省＝`label`）：一个月 31 天时给短日期（`15`）才能一行一枚；
+     *  不给而 `label` 又比那一格宽时，刻度字在**自己那一格里折行**（不越格、不压隔壁）。同样至多 10 个字符。 */
+    readonly axisLabel?: string;
+    /** 当天结束时「预算 − 已花」占预算的百分比（0–100 的有限数）。 */
+    readonly pct: number;
+    /** 那天花了多少（**≥ 0** 的有限数；花了负数是不存在的账，一律拒）；不给＝点名行里写 `—`（**不猜**）。 */
+    readonly spend?: number;
+}
+/** 子弹图的一周：进 ／ 出（**净与累计已用由本件算**，调用方不给）。 */
+export interface CashWaterlineWeek {
+    /** 周的名字（「第 1 周」）；**非空**。 */
+    readonly label: string;
+    /** 这一周进的钱（≥0 的有限数）。 */
+    readonly inflow: number;
+    /** 这一周花的钱（≥0 的有限数）。 */
+    readonly outflow: number;
+}
+/** 进出水三栏里的一行（名字 ＋ 金额；金额是**正的量**，方向由它落在「进」栏还是「出」栏定）。 */
+export interface CashWaterlineFlowLine {
+    /** 行名（「工资」「餐饮」）；**非空**。 */
+    readonly name: string;
+    /** 金额（**正**的有限数：> 0；零金额的行不该上屏）。 */
+    readonly amount: number;
+}
+/** 现金水位的入参。三形态各吃自己那份读数——**给了别的形态的读数一律拒**（不静默挑一个）。 */
+export interface CashWaterlineInput {
+    /** 卡头标题（如「本月可用余量 · 逐日」）。 */
+    readonly title: string;
+    /** 卡头右端那句（如「预算 6 000 元」「4 周」）；不给＝不出。 */
+    readonly stamp?: string;
+    /** 形态键（闭集，缺省 `waterline`）。 */
+    readonly form?: CashWaterlineForm;
+    /** 底线（占预算的百分比，0–100）；缺省 `CASH_WATERLINE_DEFAULT_THRESHOLD_PCT`（30）。 */
+    readonly thresholdPct?: number;
+    /** **形态 `waterline` 必填**：逐日读数（1–`CASH_WATERLINE_MAX_DAYS` 天）。 */
+    readonly days?: readonly CashWaterlineDay[];
+    /** **形态 `waterline` 可选**：今天那一格的下标（0 起；不给＝不标今天）。 */
+    readonly todayIndex?: number;
+    /** **形态 `bullet` 必填**：逐周读数（1–`CASH_WATERLINE_MAX_WEEKS` 周）。 */
+    readonly weeks?: readonly CashWaterlineWeek[];
+    /** **形态 `bullet`／`flow` 必填**：总预算（**正**的有限数）——子弹图的满格、进出水三栏占比都按它算；
+     *  形态 `waterline` 也收它（可选）：收下就用来把底线写成钱数（卡头第三格「底线 1 800 元（30%）」）。 */
+    readonly budget?: number;
+    /** **形态 `flow` 必填**：进项明细（1–`CASH_WATERLINE_MAX_LINES` 行）。 */
+    readonly inflow?: readonly CashWaterlineFlowLine[];
+    /** **形态 `flow` 必填**：出项明细（1–`CASH_WATERLINE_MAX_LINES` 行）。 */
+    readonly outflow?: readonly CashWaterlineFlowLine[];
+    /** **形态 `flow` 可选**：进项那一栏的**真笔数**（整数 ≥ 1）。
+     *  不给＝那一格写「N 项」（＝明细行数，照实叫它「项」）——**明细行数不许冒名「笔数」**：
+     *  原型那一格是「38 笔」，而屏上只列得出 5 行明细。 */
+    readonly inflowCount?: number;
+    /** **形态 `flow` 可选**：出项那一栏的真笔数（整数 ≥ 1）；不给＝写「N 项」。 */
+    readonly outflowCount?: number;
+    /** **形态 `flow` 必填**：已经过了几天（整数 ≥ 1）——日均消耗的分母。 */
+    readonly elapsedDays?: number;
+    /** **形态 `flow` 必填**：距这一段还剩几天（整数 ≥ 0）——判定「撑不撑得住」要乘它。 */
+    readonly remainDays?: number;
+    /** 钱的单位（缺省 `元`）：只上屏，不参与算数。 */
+    readonly unit?: string;
+    /** 口径行（这一张图怎么读）；不给＝本件按形态写一句自己的口径。 */
+    readonly note?: string;
+    /** 附加类名（空格分隔；逐个过类名正则）。 */
+    readonly extraClass?: string;
+}
+//# sourceMappingURL=attrs.d.ts.map

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

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

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

@@ -0,0 +1,157 @@
+/** cash-waterline · **标记契约**（渲染与调用方共用的唯一事实：类名／形态闭集／槽位闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙 `.scratch/ui-组件墙/新件/parts-数据与仪表.mjs` 里 **64 现金水位**的三个形态
+ *  （2026-09 用户逐格打分 A／B／C **全 4 分**——三个形态都被认可，故一并落进同一件）：
+ *   · `waterline` 逐日水位柱（底线 ＋ 告急日点名）：柱高＝当天结束时「预算 − 已花」占预算的百分比；
+ *   · `bullet`    每周子弹图（实际 ＋ 底线刻度）：横条＝本周结束时累计已用掉的比例，竖线＝跌破底线的位置；
+ *   · `flow`      进出水三栏（构成 ＋ 够不够撑到月底）：进／出／余各一栏，判定写成字。
+ *
+ *  它替掉的三种错法（原型那一件的 `p` 逐字）：
+ *   · 只给一个本月结余数字 —— 看不出是哪几天花超了；
+ *   · 用一条满格的进度条冒充时间轴 —— 存量与消耗混成一个数；
+ *   · 把「跌破底线」只染成红色 —— 说不出是哪几天、那天花了多少。
+ *
+ *  与同族件的分工（别拿这一件当它们用）：
+ *   · `invoice-lines`（金额分解）沿的是**科目**（总额一路加减到明细）；水位沿的是**时间**，读的是「存量还在不在底线之上」；
+ *   · `stacked-bar`（构成条）是一条横条里的占比，没有时间轴、也没有阈值线；
+ *   · `progress-list`（多目标进度）是「已达到 ÷ 目标」的两数之比，没有逐日余量形状，也答不出「几号会跌破底线」。
+ *
+ *  形态键写在 `CASH_WATERLINE_FORMS`（闭集）：闭集外的值一律 `badInput`（不静默降级——
+ *  降级会让调用方以为自己拿到了另一种骨架）。
+ */
+/** 本件的类名根：全部槽位类名都是 `CASH_WATERLINE_CLASS + '-' + 槽名`。 */
+export const CASH_WATERLINE_CLASS = 'ilife-block-cash-waterline';
+/** 槽位闭集（`render.ts`、`style.ts` 与判据都从这里取名字，不各抄一份字面量）。 */
+export const CASH_WATERLINE_SLOTS = [
+    /** 卡头那一排：标题 ＋ 右端口径。 */
+    'hd',
+    /** 卡头标题（如「本月可用余量 · 逐日」）。 */
+    'title',
+    /** 卡头右端那一组（本件算出来的那句 ＋ 调用方给的那句）。 */
+    'hd-tail',
+    /** 卡头**第三格**：本件按形态算出来的那一句（水位的「底线 1 800 元（30%）」／子弹图的「竖线＝底线 30%」／
+     *  三栏的「还剩 6 天」）。原型那一格就是它——少了它，读者读不出底线是多少钱、还剩几天。 */
+    'head-extra',
+    /** 卡头右端那句（预算／区间／周数），可换行。 */
+    'stamp',
+    /** 形态 `waterline`：逐日水位柱的画布（`role="img"`）。 */
+    'plot',
+    /** 底线那条虚线（绝对定位，**纯装饰**：字在 `thr-text` 里）。 */
+    'thr',
+    /** 底线那一枚标签（**有字**：`底线 30%`）。 */
+    'thr-text',
+    /** 画布里的一格（一天）。 */
+    'col',
+    /** 那一格里的水位柱（**无文字的条**：色走 `accent`，跌破底线走 `danger`）。 */
+    'fill',
+    /** 横轴那一排：**一格一天**（与画布同列数、同间距，刻度逐格对齐）。 */
+    'xax',
+    /** 横轴的一格：有刻度字的那几格写字（今天那一格写「今天」），其余格是空的但**位置照留**。 */
+    'xax-cell',
+    /** 形态 `bullet`：分周子弹图的行容器。 */
+    'bullet',
+    /** 子弹图的一行（一周）。 */
+    'brow',
+    /** 行头那一排：名字 ｜ 进 ｜ 出 ｜ 净 ｜ 越过底线的读数。 */
+    'bhd',
+    /** 行头里的名字（「第 3 周」）。 */
+    'bhd-name',
+    /** 行头里的进／出读数。 */
+    'bhd-num',
+    /** 行头右端的净额（带正负号）。 */
+    'net',
+    /** 越过底线时的读数点名（`已用 136%`）：**条形画到满格，读数里照实写**。 */
+    'over',
+    /** 子弹图的轨道（满宽＝整月预算）。 */
+    'rail',
+    /** 轨道里的填充（本周结束时累计已用掉的比例）。 */
+    'rail-fill',
+    /** 轨道上的底线刻度（竖线，**纯装饰**：位置由 `usedThreshold` 给）。 */
+    'rail-thr',
+    /** 形态 `flow`：进出水三栏。 */
+    'three',
+    /** 三栏里的一栏。 */
+    'card',
+    /** 栏头那一排：栏名 ｜ 笔数或占比 ｜ 合计。 */
+    'card-hd',
+    /** 栏名（进／出／余）。 */
+    'card-name',
+    /** 栏头中间那枚（笔数／占预算）。 */
+    'card-count',
+    /** 栏头右端的合计（大字读数）。 */
+    'card-total',
+    /** 栏里的一行（名字 ＋ 条）。 */
+    'line',
+    /** 一行的轨道。 */
+    'line-bar',
+    /** 轨道里的填充（同行内与该栏合计之比）。 */
+    'line-fill',
+    /** 那一行的读数（名字 ＋ 钱数）。 */
+    'line-text',
+    /** 余栏里那块判定（撑得住／撑不住）。 */
+    'verdict',
+    /** 判定那两个字（**结论写成字**，不只靠颜色）。 */
+    'verdict-word',
+    /** 图例（色块 ｜ 一句话；**数字另在点名那块里**）。 */
+    'legend',
+    /** 图例的一行。 */
+    'legend-item',
+    /** 图例左端那枚色块（纯装饰）。 */
+    'swatch',
+    /** 告急日点名那块（**逐日点名**：日期 ＋ 那天花了多少 ＋ 余量）。 */
+    'lowlist',
+    /** 点名那块的小标题（`跌破底线的日子 · 4 天`）。 */
+    'low-title',
+    /** 点名那块的行容器（`<ul>`）。 */
+    'low-rows',
+    /** 点名的一行。 */
+    'low-row',
+    /** 点名行里的日期。 */
+    'low-day',
+    /** 点名行里的「那天花了多少」。 */
+    'low-spend',
+    /** 点名行里的余量。 */
+    'low-pct',
+    /** 口径行（这一张图怎么读）。 */
+    'note',
+];
+/** 槽类的类名（唯一拼法：别处不许再写 `CASH_WATERLINE_CLASS + '-' + …`）。 */
+export function cashWaterlineSlot(slot, prefix = 'ilife-') {
+    return prefix + 'block-cash-waterline-' + slot;
+}
+/** 形态闭集：`waterline` 逐日水位柱 ／ `bullet` 每周子弹图 ／ `flow` 进出水三栏。 */
+export const CASH_WATERLINE_FORMS = ['waterline', 'bullet', 'flow'];
+/** 底线的缺省值（占预算的百分比）：**30%**——与原型墙上那一件同值。 */
+export const CASH_WATERLINE_DEFAULT_THRESHOLD_PCT = 30;
+/** 逐日水位柱最多几天（一个月）：再多的日子在窄容器里柱子细到看不见，请调用方先归并到周（换形态 `bullet`）。 */
+export const CASH_WATERLINE_MAX_DAYS = 31;
+/** 逐格刻度最多几列（＝最多几天）：再多，一格只有几个像素宽——**一个汉字都站不下**
+ *  （31 天在 320 档，格子 5.5px、一个汉字 12px），刻度字必然越格或越出根。
+ *  超过它就改出**一行区间读数**（`09-01 – 09-31` ＋今天那一格），照实说清这一段是哪几天。 */
+export const CASH_WATERLINE_MAX_AXIS_COLUMNS = 14;
+/** 横轴逐格刻度最多出几枚（**算出来的**：多了挤在一起＝压字；日期本身在点名那块里一个不少）。
+ *  三条不变量（判据逐长度断）：**① 枚数 ≤ 这个数**（14 天以内逐格刻度的长度全都成立）；
+ *  **② 第一列必出**；**③ 今天必占一枚**（今天落在哪一列都写得出「今天」）。 */
+export const CASH_WATERLINE_MAX_AXIS_LABELS = 6;
+/** 横轴刻度字的长度上限（字符）：那一格只有一根柱子那么宽，长标签会折成好几行、压到隔壁的刻度。
+ *  **日期写法都在范围内**（`09-21` 五个字、`2026-09-24` 十个字）；更长的请调用方自己截短（本件不替你猜）。 */
+export const CASH_WATERLINE_MAX_LABEL_CHARS = 10;
+/** 子弹图最多几周（一个月最多 6 周，留一点余量）。 */
+export const CASH_WATERLINE_MAX_WEEKS = 8;
+/** 进出水三栏每栏最多几行（多余的尾巴请调用方自己并成「其他」）。 */
+export const CASH_WATERLINE_MAX_LINES = 8;
+/** 缺值的写法：**写成 `—`，不许写 0、不许留空**（全仓同一条地板）。 */
+export const CASH_WATERLINE_MISSING = '—';
+/** 钱的缺省单位（不给 `unit` 时用它）。 */
+export const CASH_WATERLINE_DEFAULT_UNIT = '元';
+/* ── 行内自定义属性（**本件自己的名字**，不占 `--ilife-*` 那个命名空间） ──────────
+ *  为什么不用 `--ilife-*`：那是皮肤 token 的空间（名单住 `skin/contract.ts`），件里塞私有名
+ *  会在皮肤矩阵判据里读成「名单外的 token」。先例 `photo-compare` 的 `--photo-compare-split`。 */
+/** 一根水位柱的高度（百分数）。 */
+export const CASH_WATERLINE_HEIGHT_VAR = '--cash-waterline-h';
+/** 一条填充的宽度（百分数）。 */
+export const CASH_WATERLINE_WIDTH_VAR = '--cash-waterline-w';
+/** 底线在画布上的位置（从底往上，百分数）。 */
+export const CASH_WATERLINE_THRESHOLD_VAR = '--cash-waterline-thr';
+/** 底线换算成「已用掉多少」时在轨道上的位置（从右壁往左，百分数）＝ `100 − 底线`。 */
+export const CASH_WATERLINE_USED_THRESHOLD_VAR = '--cash-waterline-used-thr';

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

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

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

@@ -0,0 +1,26 @@
+import { type CashWaterlineDay, type CashWaterlineFlowLine, type CashWaterlineWeek } from './attrs.js';
+/** 机器数 → 屏上的字：整数走千分位；小数最多两位（末尾的 0 去掉）；指数记法原样（**不分组**）。 */
+export declare function fmtQty(n: number): string;
+/** 百分数 → 一位小数；整数不写 `.0`；大到走指数记法时原样（不分组、不补小数点）。 */
+export declare function fmtPct(pct: number): string;
+/** 必须是有限数。 */
+export declare function reqFinite(value: unknown, field: string): number;
+/** 有限数且 `> 0`。 */
+export declare function reqPositive(value: unknown, field: string): number;
+/** 有限数且 `≥ 0`（那天花了多少：**负的花费不存在**，静默上屏一句「那天花 −100 元」是在替调用方编账）。 */
+export declare function reqNonNegative(value: unknown, field: string): number;
+/** 整数且落在 `[min, max]` 里。 */
+export declare function reqInt(value: unknown, field: string, min: number, max: number): number;
+/** 可选整数（给了才校验）。 */
+export declare function optInt(value: unknown, field: string, min: number, max: number): number | undefined;
+/** 可选数（给了才校验）。 */
+export declare function optInRange(value: unknown, field: string, min: number, max: number): number | undefined;
+/** **形态与读数对不上就拒**：别的形态的键出现在这一形态里 ⇒ `badInput`。 */
+export declare function forbid(raw: Record<string, unknown>, form: string, keys: readonly string[]): void;
+/** 一天：逐字段校验（**日期非空且够短、余量 0–100、花费 ≥ 0**）。 */
+export declare function reqDays(value: unknown): readonly CashWaterlineDay[];
+/** 一周：`inflow`／`outflow` 都是 ≥0 的有限数（净额与占比由本件算，**调用方不给**）。 */
+export declare function reqWeeks(value: unknown): readonly CashWaterlineWeek[];
+/** 进出水的一行（名字非空、金额 **> 0**：零金额的行看不见，也不该占一行）。 */
+export declare function reqFlowLines(value: unknown, field: string): readonly CashWaterlineFlowLine[];
+//# sourceMappingURL=fields.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../../src/components/cash-waterline/fields.ts"],"names":[],"mappings":"AAWA,OAAO,EAKL,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAC;AA+BpB,0DAA0D;AAC1D,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAQxC;AAED,kDAAkD;AAClD,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK1C;AAID,cAAc;AACd,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK/D;AAWD,kBAAkB;AAClB,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjE;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIpE;AAED,4BAA4B;AAC5B,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAMtF;AAED,mBAAmB;AACnB,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAElG;AAED,kBAAkB;AAClB,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEtG;AAaD,kDAAkD;AAClD,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAOhG;AAID,6CAA6C;AAC7C,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,gBAAgB,EAAE,CAuBnE;AAED,6DAA6D;AAC7D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,iBAAiB,EAAE,CAWrE;AAED,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,qBAAqB,EAAE,CAS5F"}

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

@@ -0,0 +1,174 @@
+/** 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 一起换，本件不替你挑一个）');
+        }
+    }
+}
+/* ── 各形态的读数（形状） ───────────────────────────────────────── */
+/** 一天：逐字段校验（**日期非空且够短、余量 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) + ']';
+        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) + ']';
+        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;
+        return {
+            name: reqText(line.name, field + '[' + String(i) + '].name'),
+            amount: reqPositive(line.amount, field + '[' + String(i) + '].amount'),
+        };
+    });
+}

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":"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"}

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,12 @@
+/** 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';

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"}