base-paint 0.3.14 → 0.3.16

package/dist/components/calendar-month/style.js

@@ -0,0 +1,211 @@
+/** calendar-month · **样式段**（本件唯一的样式来源）。
+ *
+ *  纪律（与本层其余件同一份）：
+ *   · 只经 `skinVar()` 读皮肤 —— 组件里**不写** `var(--ilife-…)`（兜底链只许住在 `skin/contract.ts`）；
+ *   · 全部规则 scope 在 `.<prefix>page-ui` 之下（不开本配方的页零命中）；不写 `:root`／`!important`、不新增 token 名；
+ *   · **宽度只许容器判**：布局靠 `@container` ＋ 内在尺寸；本件不写任何 `@media`（视口宽 ≠ 组件宽）。
+ *
+ *  几何契约（判据钉住）：
+ *   · 格宽是**份数**（`repeat(7, minmax(0,1fr))`）⇒ 七列总宽恒等于容器宽，390 档不横滑；
+ *   · 读数位**换行不截断**（`overflow-wrap:anywhere`，不写 `…`）⇒ 窄档金额不丢字；
+ *   · 五档深浅与柱高**同源**（同一个 `color-mix` 阶梯 ＋ `CALENDAR_MONTH_LEVEL_HEIGHTS_PX`）：
+ *     深浅不写死颜色，三套皮肤下都是同一条"浅 → 深"（强调色换掉也成立）。
+ */
+import { skinVar } from '../skin/contract.js';
+import { calendarMonthSlot } from './attrs.js';
+/** 换行（仓库口径：不写字面换行转义）。 */
+const LF = String.fromCharCode(10);
+/** 格盘自高一档（px）：空位与满格同高，换行不会把某一行压扁。 */
+export const CALENDAR_MONTH_CELL_MIN_HEIGHT_PX = 52;
+/** 底部小柱所在的槽高（px）：五档里最高的那档正好填满它。 */
+export const CALENDAR_MONTH_BAR_HEIGHT_PX = 10;
+/** 五档的柱高（px）：**档位是形状事实**，所以它是导出的常量而不是散在样式里的字面量。 */
+export const CALENDAR_MONTH_LEVEL_HEIGHTS_PX = Object.freeze({
+    0: 0, 1: 3, 2: 5, 3: 7, 4: 10,
+});
+/** 窄容器阈值（px）：格内字号与内距收一档，好让 7 位读数（如 `¥12,345`）在 390 档也放得下。
+ *  **这是本件自己的宽度**（`@container` 判的），不是视口宽度。 */
+export const CALENDAR_MONTH_NARROW_PX = 560;
+/** 深浅阶梯：从强调色与次要面**算出来**的四种深度（不写死颜色 ⇒ 三套皮肤下都成立）。 */
+function ladder() {
+    const accent = skinVar('accent');
+    const soft = skinVar('surface-2');
+    return [
+        'color-mix(in srgb, ' + accent + ' 18%, ' + soft + ')',
+        'color-mix(in srgb, ' + accent + ' 40%, ' + soft + ')',
+        'color-mix(in srgb, ' + accent + ' 62%, ' + soft + ')',
+        skinVar('accent'),
+    ];
+}
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export function calendarMonthCss(input) {
+    const p = input !== undefined && input !== null
+        && typeof input.prefix === 'string' && input.prefix !== '' ? input.prefix : 'ilife-';
+    const root = '.' + p + 'page-ui';
+    /* 槽位类的**唯一拼法**：scope（`.ilife-page-ui`）＋ 本件类名 —— 一条独立规则的完整选择器。
+       要把两个槽拼成**后代选择器**时，后半截用 `c()`（`c()` 不带 scope）：
+       两个 `s()` 拼一起会写出 `.ilife-page-ui … .ilife-page-ui …`，那条规则**永远命中不到**
+       （页里不会有嵌套的 `.ilife-page-ui`）。判据断的是"scope 恰好出现一次"。 */
+    const s = (slot) => root + ' .' + calendarMonthSlot(slot, p);
+    const c = (slot) => '.' + calendarMonthSlot(slot, p);
+    const k = ladder();
+    const out = [
+        '/* calendar-month（月历格 · 形态 A「格内数字＋小计＋底部水量条」）：七列一周、一格一天；',
+        '   日期／读数／底部小柱自上而下；今天＝墨圈＋「今」字（形与字两路，不只靠颜色）。',
+        '   层次不靠阴影与大圆角（小票纸零阴影、大字报刊零圆角）：靠发丝线、字重与深浅阶梯 ⇒ 换皮只换取值。 */',
+        root + ' .' + p + 'block-calendar-month {',
+        /* 宽度判据的落点：本件是**自己的容器**——嵌进侧栏／面板／卡片时照样按自己的宽度收字号。 */
+        '  container-type: inline-size;',
+        '  display: grid;',
+        '  gap: 8px;',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font') + ';',
+        '  font-size: ' + skinVar('fs-body') + ';',
+        '  line-height: 1.5;',
+        '}',
+        '/* 头部：标题 ＋ 用途 ＋ 合计（合计顶右缘；容器一窄，三件自己折行，谁也不压谁）。 */',
+        s('hd') + ' {',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  align-items: baseline;',
+        '  gap: 4px 10px;',
+        '  min-width: 0;',
+        '}',
+        s('title') + ' {',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font-display') + ';',
+        '  font-size: ' + skinVar('fs-h2') + ';',
+        '  font-weight: 700;',
+        '  line-height: 1.25;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        s('use') + ' {',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  font-weight: 600;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        s('sum') + ' {',
+        '  display: flex;',
+        '  align-items: baseline;',
+        '  gap: 6px;',
+        '  margin-left: auto;',
+        '  min-width: 0;',
+        '}',
+        s('sum-label') + ' {',
+        '  color: ' + skinVar('ink-3') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '}',
+        s('sum-value') + ' {',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font-num') + ';',
+        '  font-size: ' + skinVar('fs-h3') + ';',
+        '  font-weight: 700;',
+        '  font-variant-numeric: tabular-nums;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* 星期表头与格盘**同一个七列模板**（同一个 `repeat(7, minmax(0,1fr))` ⇒ 表头永远对得上列）。 */',
+        s('wk') + ',',
+        s('grid') + ' {',
+        '  display: grid;',
+        '  grid-template-columns: repeat(7, minmax(0, 1fr));',
+        '  gap: 3px;',
+        '  min-width: 0;',
+        '}',
+        s('wd') + ' {',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink-3') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  font-weight: 600;',
+        '  text-align: center;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* 一格一天：三行＝日期／读数／小柱（第三行吃剩余高度，柱子贴着格底）。 */',
+        s('c') + ' {',
+        '  box-sizing: border-box;',
+        '  display: grid;',
+        '  grid-template-rows: auto auto 1fr;',
+        '  gap: 2px;',
+        '  min-width: 0;',
+        '  min-height: ' + String(CALENDAR_MONTH_CELL_MIN_HEIGHT_PX) + 'px;',
+        '  padding: 4px 3px;',
+        '  border: 1px solid ' + skinVar('line') + ';',
+        '  border-radius: ' + skinVar('radius-sm') + ';',
+        '  background: ' + skinVar('surface') + ';',
+        '  overflow: hidden;',
+        '}',
+        '/* 空位（月首月尾）：只占位，不出边框与底——读成"这一格不属于本月"。 */',
+        s('c') + '.is-blank {',
+        '  border-color: transparent;',
+        '  background: none;',
+        '}',
+        s('d') + ' {',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-family: ' + skinVar('font-num') + ';',
+        '  font-size: 11px;',
+        '  font-weight: 600;',
+        '  line-height: 1.2;',
+        '  font-variant-numeric: tabular-nums;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* 「今」字：今天是**形（墨圈）＋字**两路可认（色不是唯一信息）。 */',
+        s('today-mark') + ' {',
+        '  margin-left: 3px;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font') + ';',
+        '  font-size: 9px;',
+        '  font-style: normal;',
+        '  font-weight: 700;',
+        '}',
+        '/* 读数位：换行不截断（窄档金额宁可折成两行，也不写 `…` 丢掉位数）。 */',
+        s('v') + ' {',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font-num') + ';',
+        '  font-size: min(10.5px, 2.8cqi);',
+        '  font-weight: 600;',
+        '  line-height: 1.2;',
+        '  font-variant-numeric: tabular-nums;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* 缺值：字走弱档（读得出"这里没有数"），**不写 0**。 */',
+        s('c') + '.is-missing ' + c('v') + ' {',
+        '  color: ' + skinVar('ink-3') + ';',
+        '}',
+        s('bar') + ' {',
+        '  display: flex;',
+        '  align-items: flex-end;',
+        '  align-self: end;',
+        '  height: ' + String(CALENDAR_MONTH_BAR_HEIGHT_PX) + 'px;',
+        '  margin-top: 2px;',
+        '}',
+        s('bar-fill') + ' {',
+        '  display: block;',
+        '  width: 100%;',
+        '  border-radius: ' + skinVar('radius-sm') + ';',
+        '}',
+        '/* 五档柱高（常量与样式同源）：档 0 ＝ 不画柱（没有量就没有深浅）。 */',
+    ];
+    for (const level of [0, 1, 2, 3, 4]) {
+        const paint = level === 0 ? skinVar('line') : k[level - 1];
+        out.push(s('c') + '.is-l' + String(level) + ' ' + c('bar-fill') + ' {');
+        out.push('  height: ' + String(CALENDAR_MONTH_LEVEL_HEIGHTS_PX[level]) + 'px;');
+        out.push('  background: ' + paint + ';');
+        out.push('}');
+    }
+    out.push(
+    /* 今天：墨圈（形）——与「今」字一起，去掉颜色照样认得出。 */
+    s('c') + '.is-today {', '  outline: 2px solid ' + skinVar('ink') + ';', '  outline-offset: -2px;', '}', '/* 图例：色块 ＋ 说明（色块 aria-hidden，说明是字）。 */', s('lg') + ' {', '  display: flex;', '  flex-wrap: wrap;', '  align-items: center;', '  gap: 4px 12px;', '  min-width: 0;', '  color: ' + skinVar('ink-3') + ';', '  font-size: ' + skinVar('fs-xs') + ';', '}', s('lg') + ' > span {', '  display: inline-flex;', '  align-items: center;', '  gap: 4px;', '  min-width: 0;', '  overflow-wrap: anywhere;', '}', s('sw') + ' {', '  flex: none;', '  display: block;', '  width: 12px;', '  height: 12px;', '  border: 1px solid ' + skinVar('line') + ';', '  border-radius: ' + skinVar('radius-sm') + ';', '}');
+    for (const level of [0, 1, 2, 3, 4]) {
+        const paint = level === 0 ? skinVar('surface-2') : k[level - 1];
+        out.push(s('sw') + '.is-l' + String(level) + ' { background: ' + paint + '; }');
+    }
+    out.push(s('note') + ' {', '  margin: 0;', '  min-width: 0;', '  color: ' + skinVar('ink-3') + ';', '  font-size: ' + skinVar('fs-xs') + ';', '  line-height: 1.6;', '  overflow-wrap: anywhere;', '}', '/* 本件自身不带可点元素。这一条是**地板**：调用方若把某格包成链接，焦点必须看得见——', '   不许只写 `outline:none` 而不给替代。 */', root + ' .' + p + 'block-calendar-month :focus-visible {', '  outline: 2px solid ' + skinVar('accent') + ';', '  outline-offset: 2px;', '}', '/* 窄容器（<' + String(CALENDAR_MONTH_NARROW_PX) + 'px）：格内收一档内距与字号，', '   好让 7 位读数在 390 档也站着放得下（判的是**本件自己的宽度**，不用 `@media`）。 */', '@container (max-width: ' + String(CALENDAR_MONTH_NARROW_PX) + 'px) {', '  ' + s('grid') + ',', '  ' + s('wk') + ' {', '    gap: 2px;', '  }', '  ' + s('c') + ' {', '    min-height: 46px;', '    padding: 3px 2px;', '  }', '}');
+    return out.join(LF);
+}
+//# sourceMappingURL=style.js.map

package/dist/components/calendar-month/style.js.map

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

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,158 @@
+/** 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';
+//# sourceMappingURL=attrs.js.map

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,43 @@
+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;
+/** 只许入参表里写着的键：多给一个键（多半是打错名）＝拒，不静默吞掉——写错的键被吞掉时，
+ *  屏上只是静静地少一块，调用方却以为自己设上了。
+ *
+ *  **两条路都要走**（只走 `Object.keys` 会漏掉一半）：
+ *   · `Object.getOwnPropertyNames` —— 自有的**全部**键，含**不可枚举**的（`Object.keys` 看不见它）；
+ *   · `for…in` —— 走**整条原型链**（`Object.create({bogus:1})` 那种继承来的键就是这一路）。
+ *  先例：`kanban-columns/model.ts` 与 `relation-picker/model.ts` 的同名小件。
+ */
+export declare function assertKeys(raw: object, allowed: readonly string[], field: string): void;
+/** `CashWaterlineInput` 的键（顶层入参表：三形态的入参面合起来，逐字段照 `attrs.ts` 列全）。 */
+export declare const CASH_WATERLINE_INPUT_KEYS: readonly ["title", "stamp", "form", "thresholdPct", "days", "todayIndex", "weeks", "budget", "inflow", "outflow", "inflowCount", "outflowCount", "elapsedDays", "remainDays", "unit", "note", "extraClass"];
+/** `CashWaterlineDay` 的键（一天：`label`／`axisLabel`／`pct`／`spend`）。 */
+export declare const CASH_WATERLINE_DAY_KEYS: readonly ["label", "axisLabel", "pct", "spend"];
+/** `CashWaterlineWeek` 的键（一周：`label`／`inflow`／`outflow`——**净与累计已用是本件算的**）。 */
+export declare const CASH_WATERLINE_WEEK_KEYS: readonly ["label", "inflow", "outflow"];
+/** `CashWaterlineFlowLine` 的键（进出水的一行：`name`／`amount`）。 */
+export declare const CASH_WATERLINE_FLOW_LINE_KEYS: readonly ["name", "amount"];
+/** 一天：逐字段校验（**日期非空且够短、余量 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;AAOD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAWvF;AAED,oEAAoE;AACpE,eAAO,MAAM,yBAAyB,6MAE+B,CAAC;AAEtE,mEAAmE;AACnE,eAAO,MAAM,uBAAuB,iDAAkD,CAAC;AAEvF,8EAA8E;AAC9E,eAAO,MAAM,wBAAwB,yCAA0C,CAAC;AAEhF,0DAA0D;AAC1D,eAAO,MAAM,6BAA6B,6BAA8B,CAAC;AAIzE,6CAA6C;AAC7C,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,gBAAgB,EAAE,CAwBnE;AAED,6DAA6D;AAC7D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,iBAAiB,EAAE,CAYrE;AAED,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,qBAAqB,EAAE,CAU5F"}