base-paint 0.3.13 → 0.3.15

package/dist/components/index.js

@@ -0,0 +1,171 @@
+/** base-render/components · 组件层（可演进的组合层，**不属冻结签名面**）。
+ *
+ * 这一层怎么组织（本文件是它的目录说明，也是它唯一的"总入口"）：
+ *
+ * ```
+ * src/components/
+ *   index.ts              ← 组件层总出口（**每新增一个组件只在这里加一行**，别改别处）
+ *   README.md             ← 这一层自己的规矩（组件怎么写、怎么加、怎么测）
+ *   shared/               ← 组件之间共用的小件（转义／入参校验；**不**放组件本身）
+ *     escape.ts
+ *     validate.ts
+ *   <组件名>/              ← 一个组件一个目录，目录内自足
+ *     index.ts            ← 该组件对外的唯一出口
+ *     attrs.ts            ← 标记契约：类名／`data-*` 属性／事件名／闭集（渲染与运行时共用这一份事实）
+ *     render.ts           ← 渲染（纯函数产 HTML 字符串）
+ *     style.ts            ← 样式段（该组件唯一的样式来源）
+ *     runtime.ts          ← 运行时（**产出 JS 文本**；DOM 只允许出现在产出文本里）
+ *     README.md           ← 这个组件怎么用（给别的 AI 看的说明书）
+ * ```
+ *
+ * 为什么按目录分家（而不是都堆进 `blocks.ts`）：公共层由多个席位并行改，
+ * 一个组件一个目录 ⇒ 新增组件只碰"自己目录 ＋ 本文件一行"，不会跟别人的改动在同一段代码里打结。
+ *
+ * 与既有两族的关系：
+ *  - `src/blocks.ts`（12 区块）与 `src/controls.ts`（控件与运行时）是**冻结面**（进 `SPEC_FROZEN_SURFACE`、
+ *    根出口逐名绑死）；本层**不进**冻结面、**不从根导出**，走子路径 `base-paint/blocks` 薄转出
+ *    （见 `src/blocks.ts` 末尾那一行）。要动冻结面签名的组件不属本层。
+ *  - 本层可以用 `src/spec/**`（只读冻结常量）与 `src/components/shared/**`；
+ *    **不得**反向被 `controls.ts` 依赖，也不得新增 `CSS_VAR_TOKENS`（样式只读冻结 token）。
+ */
+export * from './editable-value/index.js';
+/** 单据族（纸面 ＋ 主数字头 ＋ 刻度条 ＋ 账目行 ＋ 明细行 ＋ 打孔格带）：一族六件，样式由 `sheetCss()` 汇总。
+ *  出处＝原型 `.scratch/diet-ui-proto/v2-小票.html`／`v2-大字.html`（用户认可的两套设计语言），
+ *  抽取记录见 `docs/base/base-render/单据族组件.md`。**只加行、不重排**（并行席位的约定）。 */
+export * from './sheet-frame/index.js';
+export * from './summary-head/index.js';
+export * from './scale-bar/index.js';
+export * from './ledger-rows/index.js';
+export * from './entry-rows/index.js';
+export * from './punch-strip/index.js';
+/** 皮肤层（三套语言＝三份取值表；组件只读 token 名，走 `skinVar()`）：见 `skin/contract.ts` 与
+ *  `docs/base/base-render/公共组件契约.md`。**只加行、不重排**（并行席位的约定）。 */
+export * from './skin/index.js';
+/** 以下按名册（`.scratch/ui-组件墙/落地名册.md`）的族次转入 43 个新建组件；**只加行、不重排**。
+ *  形态（A／B／C）取自用户在组件墙上的打分记录：一件只落用户认可的那个形态。
+ *  行内只写「中文名／形态」，详细用法看各目录自己的 `README.md`。 */
+/* 纸面与页头 */
+export * from './page-head/index.js';
+export * from './section-head/index.js';
+/* 读数 */
+export * from './key-value-list/index.js';
+export * from './stat-inline/index.js';
+/* 对照与榜单 */
+export * from './compare-columns/index.js';
+export * from './rank-list/index.js';
+/* 形状与比例 */
+export * from './progress-ring/index.js';
+export * from './stacked-bar/index.js';
+export * from './heat-grid/index.js';
+export * from './scatter-fit/index.js';
+/* 时间与分组 */
+export * from './calendar-month/index.js';
+export * from './range-bar/index.js';
+export * from './sub-list/index.js';
+export * from './hour-band/index.js';
+/* 状态与台账 */
+export * from './status-row/index.js';
+export * from './task-list/index.js';
+export * from './streak-badge/index.js';
+export * from './due-row/index.js';
+export * from './step-flow/index.js';
+export * from './timer-card/index.js';
+/* 搜索与筛选 */
+export * from './search-field/index.js';
+export * from './filter-chips/index.js';
+export * from './sort-toggle/index.js';
+export * from './result-row/index.js';
+export * from './window-picker/index.js';
+/* 表与输入 */
+export * from './number-stepper/index.js';
+export * from './slider-row/index.js';
+export * from './switch-row/index.js';
+export * from './date-range/index.js';
+/* 选择与打分 */
+export * from './radio-cards/index.js';
+export * from './multi-checks/index.js';
+export * from './rating-row/index.js';
+/* 动作与反馈 */
+export * from './confirm-strip/index.js';
+export * from './skeleton/index.js';
+export * from './toast-card/index.js';
+/* 容器与浮层 */
+export * from './dialog/index.js';
+export * from './drawer-sheet/index.js';
+export * from './popover-menu/index.js';
+export * from './tooltip/index.js';
+/* 加量池 */
+export * from './progress-list/index.js';
+export * from './sync-status/index.js';
+export * from './photo-grid/index.js';
+export * from './photo-compare/index.js';
+export * from './note-block/index.js';
+export * from './invoice-lines/index.js';
+/* 数据与仪表（原型墙 `.scratch/ui-组件墙/新件/parts-数据与仪表.mjs` 那一批）的第一件：`cash-waterline`
+   —— 64 现金水位，形态 A 逐日水位柱／B 每周子弹图／C 进出水三栏；用户在墙上给这三个形态逐格 4 分，
+   故一并落进同一件。**只加行、不重排**（并行席位的约定）。
+   注：这里**不写「族」字**——按本层的对账口径（`test/组件清单.test.mjs` 第 ④ 组），有族注记就得有族汇总
+   入口；同批第二件落地后，再由先成立的那件立 `*Css()` 汇总（照 `sheetCss()` 先例）。 */
+export * from './cash-waterline/index.js';
+/* 数据与仪表（同一批）的第二件：`gantt-timeline` —— 61 甘特时间线，形态 C「资源泳道（灶位）× 关键路径带」；
+   用户在墙上给这一档逐格 4/4/4，故只落这一档（A／B 两档还在原型里返工）。
+   注：这里**不写「族」字**（同前一件的口径），也**不加汇总入口**——同批两件各自的样式段各管各的。
+   **只加行、不重排**（并行席位的约定）。 */
+export * from './gantt-timeline/index.js';
+/* 数据与仪表（同一批）的第三件：`small-multiples` —— 68 小倍数面板，形态 C「期间并排迷你柱阵 ＋ 均值线」；
+   用户在墙上给这一档 4 分（A 档面积 sparkline 网格／B 档对齐基线多线未全过，不落）。
+   注：这里**不写「族」字**，也**不加汇总入口**（同前两件的口径）。
+   **只加行、不重排**（并行席位的约定）。 */
+export * from './small-multiples/index.js';
+/* 数据与仪表（同一批）的第四件：`goal-stairs` —— 66 目标阶梯，形态 C「倒推日程（每段最晚何时动手）」；
+   用户在墙上给这一档逐格 4/4/4（A 分段台阶／B 里程碑轴两档未全过，不落）。
+   注：这里**不写汇总注记**，也**不加汇总入口**（同前几件的口径）。
+   **只加行、不重排**（并行席位的约定）。 */
+export * from './goal-stairs/index.js';
+/* 数据与仪表（同一批）的第五件：`spread-dist` —— 65 分布与分位，形态 **B「逐日范围柱（中位＋区间，时间轴）」
+   与 C「分位尺（P10/P25/P50/P75/P90 各是多少）」两档**；用户在墙上给这两档逐格 4/4/4
+   （A 档箱线只拿到 3/3/3，不落）。形态键住 `SPREAD_DIST_FORMS`（`range`／`quantile`，英文键）。
+   注：这里**不写「族」字**，也**不加汇总入口**（同前几件的口径）。
+   **只加行、不重排**（并行席位的约定）。 */
+export * from './spread-dist/index.js';
+/* 数据与仪表（同一批）的第六件：`flow-ribbon` —— 67 流向带，**A／B／C 三档全落**：
+   `sankey` 桑基带（左来源／右用途，带宽＝金额，两侧同一把尺子）／`matrix` 交叉矩阵（行＝来源、列＝用途）／
+   `rails` 两条构成轨＋中间汇合读数。用户在墙上给这三档逐格 4 分（A／C 本轮 4/4/4、B 上一轮 4/4/4）。
+   形态键住 `FLOW_RIBBON_FORMS`（英文键，**不许用 A／B／C**）。
+   注：这里**不写「族」字**，也**不加汇总入口**（同前几件的口径）。
+   **只加行、不重排**（并行席位的约定）。 */
+export * from './flow-ribbon/index.js';
+/* 数据与仪表（同一批）的第七件：`radar-profile` —— 62 多维画像雷达（工单表里写作「雷达画像」），
+   **A／B／C 三档全落**：`polygon` 多边形雷达（本期／上期两条轮廓）／`wedge` 极区扇图（半径＝得分，达标环）／
+   `rail` 展平成轴表（基准带＋我的位置）。用户在墙上给这三档逐格 4/4/4，故三档一并落进同一件。
+   形态键住 `RADAR_PROFILE_FORMS`（英文键，**不许用 A／B／C**）。
+   注：这里**不写「族」字**，也**不加汇总入口**（同前几件的口径：件拆出的 `style-forms.ts` 只由本件的
+   `radarProfileCss()` 汇总，不是族汇总）。
+   **只加行、不重排**（并行席位的约定）。 */
+export * from './radar-profile/index.js';
+/* 交互与流程（原型墙 `.scratch/ui-组件墙/新件/parts-交互与流程.mjs` 那一批）的第一件：`bulk-bar`
+   —— 82 批量操作条，形态 A「选中后浮出来的操作条（底部）」；用户在墙上给这一档 4 分。
+   注：这里**不写汇总入口那一行**——按本层的对账口径（`test/组件清单.test.mjs` 第 ④ 组），
+   写了汇总注记就得有一个 `*Css()` 汇总入口；同批第二件落地后，再由先成立的那件立汇总（照 `sheetCss()` 先例）。
+   **只加行、不重排**（并行席位的约定）。 */
+export * from './bulk-bar/index.js';
+/* 交互与流程（同一批）的第二件：`wizard-shell` —— 84 分步录入壳，形态 B「一问一屏（大字问题 ＋ 一条细进度）」；
+   用户在墙上给这一档 4/4/4（A 档「两栏：左步骤／右表单」未全过，不落）。
+   注：这里**不写「族」字**，也**不加汇总入口**（同前几件的口径，同族第二件之后再由先成立的那件立汇总）。
+   **只加行、不重排**（并行席位的约定）。 */
+export * from './wizard-shell/index.js';
+/* 交互与流程（同一批）的第三件：`command-palette` —— 81 命令面板，形态 A「单栏分组结果（动作在前／页面在后）」；
+   用户在墙上给这一档逐格 4/4/4（B 档「两栏：先选技能，再看它的页面与动作」未全过，不落）。
+   这一件落地的是**触屏优先**的那一版：入口＝页头一枚看得见的按钮、整行可点＝执行或打开、零键帽。
+   注：这里**不写「族」字**，也**不加汇总入口**（同前几件的口径，同族第二件之后再由先成立的那件立汇总）。
+   **只加行、不重排**（并行席位的约定）。 */
+export * from './command-palette/index.js';
+/* 交互与流程（同一批）的第四件：`undo-timeline` —— 85 改动时间线，**A／B 两档都落**：
+   `track` 一条轨（谁的改动、动了什么读数、能不能撤）／`impact` 一次改动的回滚单（影响面清单，
+   勾哪几项就撤哪几项）。用户在墙上给这两档逐格 4/4/4；形态键住 `UNDO_TIMELINE_FORMS`
+   （英文键，**不许用 A／B 当键**），三态住 `UNDO_TIMELINE_STATES`（`undoable`／`undone`／`locked`）。
+   零键盘通路：撤销、恢复、开合、勾选、取消全是看得见、点得到的按钮。
+   注：这里**不写「族」字**，也**不加汇总入口**（同前几件的口径）。
+   **只加行、不重排**（并行席位的约定）。 */
+export * from './undo-timeline/index.js';
+//# sourceMappingURL=index.js.map

package/dist/components/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,cAAc,2BAA2B,CAAC;AAC1C;;mEAEmE;AACnE,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC;8DAC8D;AAC9D,cAAc,iBAAiB,CAAC;AAChC;;4CAE4C;AAC5C,WAAW;AACX,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,QAAQ;AACR,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,WAAW;AACX,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,WAAW;AACX,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,WAAW;AACX,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,WAAW;AACX,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,WAAW;AACX,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,UAAU;AACV,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,WAAW;AACX,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,WAAW;AACX,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,WAAW;AACX,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,SAAS;AACT,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC;;;;2DAI2D;AAC3D,cAAc,2BAA2B,CAAC;AAC1C;;;2BAG2B;AAC3B,cAAc,2BAA2B,CAAC;AAC1C;;;2BAG2B;AAC3B,cAAc,4BAA4B,CAAC;AAC3C;;;2BAG2B;AAC3B,cAAc,wBAAwB,CAAC;AACvC;;;;2BAI2B;AAC3B,cAAc,wBAAwB,CAAC;AACvC;;;;;2BAK2B;AAC3B,cAAc,wBAAwB,CAAC;AACvC;;;;;;2BAM2B;AAC3B,cAAc,0BAA0B,CAAC;AACzC;;;;2BAI2B;AAC3B,cAAc,qBAAqB,CAAC;AACpC;;;2BAG2B;AAC3B,cAAc,yBAAyB,CAAC;AACxC;;;;2BAI2B;AAC3B,cAAc,4BAA4B,CAAC;AAC3C;;;;;;2BAM2B;AAC3B,cAAc,0BAA0B,CAAC"}

package/dist/components/invoice-lines/attrs.d.ts

@@ -0,0 +1,77 @@
+/** invoice-lines · **标记契约**（渲染与调用方共用的唯一事实：类名／形态闭集／行类闭集／入参类型）。
+ *
+ *  这一件是**重做件**（原型墙 3/3/3，`.scratch/ui-组件墙/重做设计口径.md` §6）：原型读起来像一摞普通账目行，
+ *  每行只有一个金额、说不出「为什么」。重做两件事：
+ *   ① **每行读得出「为什么」**：减项与加项**必带原因**（「满 2000 减 200」「平台红包」），说不出原因的行一律拒；
+ *   ② **从原价到实付是一条链**：缩进逐级 ＋ 底下一条重线收口，最后一行实付**加粗放大**，
+ *      均摊写进实付那一行的**副语**（不另开一块）。
+ *  另一形态给**纯 CSS 瀑布条**：条长从原价走到实付，「省了多少」在形状上看得见。
+ *
+ *  与账目行的分工：`ledger-rows`／`entry-rows` 是**平铺读数**（一列标签对一列值）；
+ *  本件讲的是**一笔钱怎么拆的**（一条减法链 ＋ 一个收口），两件不做同一件事。
+ */
+/** 本件的类名根。 */
+export declare const INVOICE_LINES_CLASS = "ilife-block-invoice-lines";
+/** 槽位闭集。 */
+export declare const INVOICE_LINES_SLOTS: readonly ["list", "line", "label", "amount", "why", "share", "bar", "seg", "foot", "legend", "legend-row", "legend-swatch", "legend-label", "legend-amount", "note"];
+export type InvoiceLinesSlot = (typeof INVOICE_LINES_SLOTS)[number];
+/** 槽类的类名（唯一拼法）。 */
+export declare function invoiceLinesSlot(slot: InvoiceLinesSlot, prefix?: string): string;
+/** 形态闭集：`chain`（逐行分解 ＋ 收口）与 `waterfall`（纯 CSS 瀑布条）。 */
+export declare const INVOICE_LINES_FORMS: readonly ["chain", "waterfall"];
+export type InvoiceLinesForm = (typeof INVOICE_LINES_FORMS)[number];
+/** 行类闭集（**第一行必须是 `base`**；`base` 只能出现在第一行）。 */
+export declare const INVOICE_LINE_KINDS: readonly ["base", "cut", "add"];
+export type InvoiceLineKind = (typeof INVOICE_LINE_KINDS)[number];
+/** 行类 → 金额前那个记号（`base` 不带记号：原价就是那一笔钱本身）。 */
+export declare const INVOICE_LINES_KIND_MARKS: Readonly<Record<InvoiceLineKind, string>>;
+/** 减项／加项那行左端的两枚标签：**每行读得出「为什么」**就靠它们把原因点出来。 */
+export declare const INVOICE_LINES_WHY_CUT = "\u4E3A\u4EC0\u4E48\u51CF";
+export declare const INVOICE_LINES_WHY_ADD = "\u4E3A\u4EC0\u4E48\u52A0";
+/** 缺省的钱符号与实付行的名字。 */
+export declare const INVOICE_LINES_SYMBOL = "\u00A5";
+export declare const INVOICE_LINES_TOTAL_LABEL = "\u5B9E\u4ED8";
+/** 金额的小数位（钱按两位排：`168.00`）。 */
+export declare const INVOICE_LINES_DECIMALS = 2;
+/** 实付那一行的字号倍数（**加粗放大**：收口那一行是全件的读数）。 */
+export declare const INVOICE_LINES_TOTAL_SCALE = 1.6;
+/** 瀑布条里：段窄到什么程度就不再往段里写字（**金额仍然在图例里逐行出**，一个字都不丢）。 */
+export declare const INVOICE_LINES_SEGMENT_MIN_PCT = 12;
+/** 均摊那句的左端词（「均摊 2 人，每人 ¥67.00」）。 */
+export declare const INVOICE_LINES_SHARE_WORD = "\u5747\u644A";
+/** 一笔钱里的一行。`amount` 是**正的量**（符号由 `kind` 定：减项前面挂 `−`）。 */
+export interface InvoiceLine {
+    /** 这一行是什么（「原价 · 超市买菜」「店铺满减」「拆单运费」）。**非空**。 */
+    readonly label: string;
+    /** 金额（**正的量**，有限数且 > 0）。 */
+    readonly amount: number;
+    /** 行类（闭集）：`base` 原价（只许第一行）／`cut` 减项／`add` 加项。 */
+    readonly kind: InvoiceLineKind;
+    /** **为什么**：减项与加项**必填**（「满 100 减 12，已达标」「拆成两单发，第二单没到免运费门槛」）。 */
+    readonly why?: string;
+}
+/** 均摊（写进实付那一行的副语里，不另开一块）。 */
+export interface InvoiceShare {
+    /** 几个人（整数 ≥ 2）。 */
+    readonly people: number;
+    /** 除不尽时那句补充；不给＝本件按「除不尽」算一句。 */
+    readonly note?: string;
+}
+/** 金额分解的入参。`lines` 必填且**第一行必须是原价**（没有原价就没有「拆」这件事）。 */
+export interface InvoiceLinesInput {
+    /** 分行（第一行 `kind: 'base'`，其余 `cut`／`add`）。 */
+    readonly lines: readonly InvoiceLine[];
+    /** 钱符号（缺省 `¥`）。 */
+    readonly symbol?: string;
+    /** 实付那一行的名字（缺省「实付」）。 */
+    readonly totalLabel?: string;
+    /** 均摊到几人（写进实付行的副语）。 */
+    readonly share?: InvoiceShare;
+    /** 口径行（这一笔怎么拆的）。串＝一句话；数组＝分段。 */
+    readonly note?: string | readonly string[];
+    /** 形态键（闭集，缺省 `chain`）：`chain` 逐行分解 ／ `waterfall` 瀑布条。 */
+    readonly form?: InvoiceLinesForm;
+    /** 附加类名（空格分隔；逐个过类名正则）。 */
+    readonly extraClass?: string;
+}
+//# sourceMappingURL=attrs.d.ts.map

package/dist/components/invoice-lines/attrs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.d.ts","sourceRoot":"","sources":["../../../src/components/invoice-lines/attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc;AACd,eAAO,MAAM,mBAAmB,8BAA8B,CAAC;AAE/D,YAAY;AACZ,eAAO,MAAM,mBAAmB,sKA+BtB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,mBAAmB;AACnB,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,SAAW,GAAG,MAAM,CAElF;AAED,uDAAuD;AACvD,eAAO,MAAM,mBAAmB,iCAAkC,CAAC;AACnE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,+CAA+C;AAC/C,eAAO,MAAM,kBAAkB,iCAAkC,CAAC;AAClE,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,4CAA4C;AAC5C,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAI7E,CAAC;AAEH,+CAA+C;AAC/C,eAAO,MAAM,qBAAqB,6BAAS,CAAC;AAC5C,eAAO,MAAM,qBAAqB,6BAAS,CAAC;AAE5C,qBAAqB;AACrB,eAAO,MAAM,oBAAoB,WAAM,CAAC;AACxC,eAAO,MAAM,yBAAyB,iBAAO,CAAC;AAE9C,8BAA8B;AAC9B,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,wCAAwC;AACxC,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,oDAAoD;AACpD,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD,oCAAoC;AACpC,eAAO,MAAM,wBAAwB,iBAAO,CAAC;AAE7C,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,+DAA+D;IAC/D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,6BAA6B;AAC7B,MAAM,WAAW,YAAY;IAC3B,mBAAmB;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IACvC,mBAAmB;IACnB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,wBAAwB;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,uBAAuB;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,gCAAgC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAC3C,yDAAyD;IACzD,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACjC,0BAA0B;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B"}

package/dist/components/invoice-lines/attrs.js

@@ -0,0 +1,75 @@
+/** invoice-lines · **标记契约**（渲染与调用方共用的唯一事实：类名／形态闭集／行类闭集／入参类型）。
+ *
+ *  这一件是**重做件**（原型墙 3/3/3，`.scratch/ui-组件墙/重做设计口径.md` §6）：原型读起来像一摞普通账目行，
+ *  每行只有一个金额、说不出「为什么」。重做两件事：
+ *   ① **每行读得出「为什么」**：减项与加项**必带原因**（「满 2000 减 200」「平台红包」），说不出原因的行一律拒；
+ *   ② **从原价到实付是一条链**：缩进逐级 ＋ 底下一条重线收口，最后一行实付**加粗放大**，
+ *      均摊写进实付那一行的**副语**（不另开一块）。
+ *  另一形态给**纯 CSS 瀑布条**：条长从原价走到实付，「省了多少」在形状上看得见。
+ *
+ *  与账目行的分工：`ledger-rows`／`entry-rows` 是**平铺读数**（一列标签对一列值）；
+ *  本件讲的是**一笔钱怎么拆的**（一条减法链 ＋ 一个收口），两件不做同一件事。
+ */
+/** 本件的类名根。 */
+export const INVOICE_LINES_CLASS = 'ilife-block-invoice-lines';
+/** 槽位闭集。 */
+export const INVOICE_LINES_SLOTS = [
+    /** 链的容器（`<ol>`：原价 → 各减项／加项 → 实付，顺序就是入参顺序）。 */
+    'list',
+    /** 一行（`is-base`／`is-cut`／`is-add`／`is-total`）。 */
+    'line',
+    /** 行左端的名字（「原价 · 超市买菜」「店铺满减」）。 */
+    'label',
+    /** 行右端的金额（带符号与千分位：`−¥12.00`）。 */
+    'amount',
+    /** 这一行的「为什么」（减项／加项**必出**；左端一枚标签说清是「为什么减」还是「为什么加」）。 */
+    'why',
+    /** 实付那一行的副语（均摊 ／ 合几折）。 */
+    'share',
+    /** 瀑布条（纯 CSS：段宽与金额等比）。 */
+    'bar',
+    /** 条里的一段。 */
+    'seg',
+    /** 条下面那行口径（条长以什么为满分）。 */
+    'foot',
+    /** 图例（条下逐行对上：原价 ／ 各减项 ／ 实付）。 */
+    'legend',
+    /** 图例里的一行。 */
+    'legend-row',
+    /** 图例里的一行。 */
+    'legend-swatch',
+    /** 图例行左端的色块（纯装饰：图例本身也带金额）。 */
+    'legend-label',
+    /** 图例行右端的金额。 */
+    'legend-amount',
+    /** 口径行。 */
+    'note',
+];
+/** 槽类的类名（唯一拼法）。 */
+export function invoiceLinesSlot(slot, prefix = 'ilife-') {
+    return prefix + 'block-invoice-lines-' + slot;
+}
+/** 形态闭集：`chain`（逐行分解 ＋ 收口）与 `waterfall`（纯 CSS 瀑布条）。 */
+export const INVOICE_LINES_FORMS = ['chain', 'waterfall'];
+/** 行类闭集（**第一行必须是 `base`**；`base` 只能出现在第一行）。 */
+export const INVOICE_LINE_KINDS = ['base', 'cut', 'add'];
+/** 行类 → 金额前那个记号（`base` 不带记号：原价就是那一笔钱本身）。 */
+export const INVOICE_LINES_KIND_MARKS = Object.freeze({
+    base: '',
+    cut: '−',
+    add: '＋',
+});
+/** 减项／加项那行左端的两枚标签：**每行读得出「为什么」**就靠它们把原因点出来。 */
+export const INVOICE_LINES_WHY_CUT = '为什么减';
+export const INVOICE_LINES_WHY_ADD = '为什么加';
+/** 缺省的钱符号与实付行的名字。 */
+export const INVOICE_LINES_SYMBOL = '¥';
+export const INVOICE_LINES_TOTAL_LABEL = '实付';
+/** 金额的小数位（钱按两位排：`168.00`）。 */
+export const INVOICE_LINES_DECIMALS = 2;
+/** 实付那一行的字号倍数（**加粗放大**：收口那一行是全件的读数）。 */
+export const INVOICE_LINES_TOTAL_SCALE = 1.6;
+/** 瀑布条里：段窄到什么程度就不再往段里写字（**金额仍然在图例里逐行出**，一个字都不丢）。 */
+export const INVOICE_LINES_SEGMENT_MIN_PCT = 12;
+/** 均摊那句的左端词（「均摊 2 人，每人 ¥67.00」）。 */
+export const INVOICE_LINES_SHARE_WORD = '均摊';

package/dist/components/invoice-lines/attrs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.js","sourceRoot":"","sources":["../../../src/components/invoice-lines/attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc;AACd,MAAM,CAAC,MAAM,mBAAmB,GAAG,2BAA2B,CAAC;AAE/D,YAAY;AACZ,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,8CAA8C;IAC9C,MAAM;IACN,kDAAkD;IAClD,MAAM;IACN,iCAAiC;IACjC,OAAO;IACP,iCAAiC;IACjC,QAAQ;IACR,sDAAsD;IACtD,KAAK;IACL,0BAA0B;IAC1B,OAAO;IACP,0BAA0B;IAC1B,KAAK;IACL,aAAa;IACb,KAAK;IACL,yBAAyB;IACzB,MAAM;IACN,gCAAgC;IAChC,QAAQ;IACR,cAAc;IACd,YAAY;IACZ,cAAc;IACd,eAAe;IACf,8BAA8B;IAC9B,cAAc;IACd,gBAAgB;IAChB,eAAe;IACf,WAAW;IACX,MAAM;CACE,CAAC;AAGX,mBAAmB;AACnB,MAAM,UAAU,gBAAgB,CAAC,IAAsB,EAAE,MAAM,GAAG,QAAQ;IACxE,OAAO,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAAC;AAChD,CAAC;AAED,uDAAuD;AACvD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,WAAW,CAAU,CAAC;AAGnE,+CAA+C;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAGlE,4CAA4C;AAC5C,MAAM,CAAC,MAAM,wBAAwB,GAA8C,MAAM,CAAC,MAAM,CAAC;IAC/F,IAAI,EAAE,EAAE;IACR,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,GAAG;CACT,CAAC,CAAC;AAEH,+CAA+C;AAC/C,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAC5C,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAE5C,qBAAqB;AACrB,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AACxC,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC;AAE9C,8BAA8B;AAC9B,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAExC,wCAAwC;AACxC,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAE7C,oDAAoD;AACpD,MAAM,CAAC,MAAM,6BAA6B,GAAG,EAAE,CAAC;AAEhD,oCAAoC;AACpC,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC"}

package/dist/components/invoice-lines/index.d.ts

@@ -0,0 +1,15 @@
+/** invoice-lines · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  五个运行名：`renderInvoiceLines(input)`（产标记，零 DOM）／`invoiceLinesCss()`（样式段）／
+ *  形态闭集 `INVOICE_LINES_FORMS`（`chain` 逐行分解 ／ `waterfall` 瀑布条）／
+ *  行类闭集 `INVOICE_LINE_KINDS` 与记号表 `INVOICE_LINES_KIND_MARKS`／类名根 `INVOICE_LINES_CLASS`。
+ *  另出四条几何／口径事实、排钱的唯一算法 `formatInvoiceAmount` 与四个类型名（入参面）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ */
+export { INVOICE_LINES_CLASS, INVOICE_LINES_DECIMALS, INVOICE_LINES_FORMS, INVOICE_LINES_KIND_MARKS, INVOICE_LINES_SEGMENT_MIN_PCT, INVOICE_LINES_SHARE_WORD, INVOICE_LINES_SYMBOL, INVOICE_LINES_TOTAL_LABEL, INVOICE_LINES_TOTAL_SCALE, INVOICE_LINES_WHY_ADD, INVOICE_LINES_WHY_CUT, INVOICE_LINE_KINDS, } from './attrs.js';
+export type { InvoiceLine, InvoiceLineKind, InvoiceLinesForm, InvoiceLinesInput, InvoiceShare } from './attrs.js';
+export { formatInvoiceAmount } from './model.js';
+export { renderInvoiceLines } from './render.js';
+export { INVOICE_LINES_INDENT_PX, INVOICE_LINES_LEGEND_MAX_PX, INVOICE_LINES_RULE_PX, invoiceLinesCss, } from './style.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/invoice-lines/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/invoice-lines/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,6BAA6B,EAC7B,wBAAwB,EACxB,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAClH,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,qBAAqB,EACrB,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/components/invoice-lines/index.js

@@ -0,0 +1,13 @@
+/** invoice-lines · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  五个运行名：`renderInvoiceLines(input)`（产标记，零 DOM）／`invoiceLinesCss()`（样式段）／
+ *  形态闭集 `INVOICE_LINES_FORMS`（`chain` 逐行分解 ／ `waterfall` 瀑布条）／
+ *  行类闭集 `INVOICE_LINE_KINDS` 与记号表 `INVOICE_LINES_KIND_MARKS`／类名根 `INVOICE_LINES_CLASS`。
+ *  另出四条几何／口径事实、排钱的唯一算法 `formatInvoiceAmount` 与四个类型名（入参面）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ */
+export { INVOICE_LINES_CLASS, INVOICE_LINES_DECIMALS, INVOICE_LINES_FORMS, INVOICE_LINES_KIND_MARKS, INVOICE_LINES_SEGMENT_MIN_PCT, INVOICE_LINES_SHARE_WORD, INVOICE_LINES_SYMBOL, INVOICE_LINES_TOTAL_LABEL, INVOICE_LINES_TOTAL_SCALE, INVOICE_LINES_WHY_ADD, INVOICE_LINES_WHY_CUT, INVOICE_LINE_KINDS, } from './attrs.js';
+export { formatInvoiceAmount } from './model.js';
+export { renderInvoiceLines } from './render.js';
+export { INVOICE_LINES_INDENT_PX, INVOICE_LINES_LEGEND_MAX_PX, INVOICE_LINES_RULE_PX, invoiceLinesCss, } from './style.js';

package/dist/components/invoice-lines/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/invoice-lines/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,6BAA6B,EAC7B,wBAAwB,EACxB,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,qBAAqB,EACrB,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/components/invoice-lines/model.d.ts

@@ -0,0 +1,58 @@
+import { type InvoiceLineKind, type InvoiceLinesForm } from './attrs.js';
+/** 归一化后的一行。 */
+export interface InvoiceLineModel {
+    readonly label: string;
+    readonly kind: InvoiceLineKind;
+    /** 正的量（原样留着：算总账用它）。 */
+    readonly amount: number;
+    /** 屏上那个金额（含符号与千分位：`−¥12.00`）。 */
+    readonly amountText: string;
+    readonly why?: string;
+}
+/** 瀑布条里的一段（段宽与金额等比）。 */
+export interface InvoiceSegmentModel {
+    readonly kind: 'total' | 'cut';
+    readonly label: string;
+    readonly amountText: string;
+    /** 段宽（百分比，**两位小数**；这一段的金额 ÷ 条长满分）。 */
+    readonly pct: number;
+    /** 段够不够宽到能写字（不够就不写——金额仍然在图例里逐行出）。 */
+    readonly wide: boolean;
+}
+/** 归一化后的入参。 */
+export interface InvoiceLinesModel {
+    readonly form: InvoiceLinesForm;
+    readonly lines: readonly InvoiceLineModel[];
+    /** 原价（第一行）。 */
+    readonly base: number;
+    readonly baseText: string;
+    /** 减项合计（正数）。 */
+    readonly cuts: number;
+    /** 加项合计（正数）。 */
+    readonly adds: number;
+    /** 实付 ＝ 原价 − 减项合计 ＋ 加项合计。 */
+    readonly total: number;
+    readonly totalText: string;
+    readonly totalLabel: string;
+    readonly symbol: string;
+    /** 实付行副语前半句（「比原价少 ¥34.00」／「比原价多 ¥8.00」／「与原价相同」）。 */
+    readonly deltaText: string;
+    /** 实付行副语里的折扣句（「合 8.04 折」）；没有减项时 `undefined`。 */
+    readonly discountText?: string;
+    /** 均摊那句（「均摊 2 人，每人 ¥67.00」）；没给 `share` 时 `undefined`。 */
+    readonly shareText?: string;
+    /** 均摊除不尽时那句补充。 */
+    readonly shareNote?: string;
+    /** 瀑布条的段（实付 ＋ 各减项，按行序）。 */
+    readonly segments: readonly InvoiceSegmentModel[];
+    /** 瀑布条的满分（原价 ＋ 加项合计）：段宽的分母。 */
+    readonly span: number;
+    readonly spanText: string;
+    readonly note: readonly string[];
+    readonly extraClass?: string;
+}
+/** 金额 → 屏上的字（钱按两位小数：`1,093.25`）。 */
+export declare function formatInvoiceAmount(value: number): string;
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `InvoiceLinesModel`。 */
+export declare function normalizeInvoiceLines(input: unknown): InvoiceLinesModel;
+//# sourceMappingURL=model.d.ts.map

package/dist/components/invoice-lines/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/components/invoice-lines/model.ts"],"names":[],"mappings":"AASA,OAAO,EAUL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EAEtB,MAAM,YAAY,CAAC;AAEpB,eAAe;AACf,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,uBAAuB;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAwB;AACxB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,eAAe;AACf,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC5C,eAAe;IACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gBAAgB;IAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gBAAgB;IAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gDAAgD;IAChD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB;IAClB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,2BAA2B;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAClD,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAcD,oCAAoC;AACpC,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGzD;AAoDD,6DAA6D;AAC7D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAiGvE"}

package/dist/components/invoice-lines/model.js

@@ -0,0 +1,180 @@
+/** invoice-lines · **入参归一化与校验**（把 `any` 与说不出的 `unknown` 挡在门外，产出内部类型）。
+ *
+ *  三条口径：
+ *   1. **非法入参一律 `badInput()`**（抛 `BlocksError`）——不静默降级；
+ *   2. **说不出「为什么」的减项／加项一律拒**：这一件重做就是为了让每行读得出原因；
+ *   3. **算得出来的都不许调用方再给**：实付金额、比原价少了多少、合几折、均摊每人多少、
+ *      瀑布条的段宽，全部本件算——同一个数两处算，偏差无处可查。
+ */
+import { assertPlainObject, badInput, optExtraClass, optText, reqText } from '../shared/validate.js';
+import { INVOICE_LINES_DECIMALS, INVOICE_LINES_FORMS, INVOICE_LINES_KIND_MARKS, INVOICE_LINES_SEGMENT_MIN_PCT, INVOICE_LINES_SHARE_WORD, INVOICE_LINES_SYMBOL, INVOICE_LINES_TOTAL_LABEL, INVOICE_LINE_KINDS, } from './attrs.js';
+/** 千分位（自算、不依赖 locale：同一入参在任何机器上排一样，判据才断得准）。 */
+function groupThousands(s) {
+    const dot = s.indexOf('.');
+    const int = dot < 0 ? s : s.slice(0, dot);
+    const frac = dot < 0 ? '' : s.slice(dot);
+    const sign = int.startsWith('-') ? '-' : '';
+    const digits = sign === '' ? int : int.slice(1);
+    const parts = [];
+    for (let i = digits.length; i > 0; i -= 3)
+        parts.unshift(digits.slice(Math.max(0, i - 3), i));
+    return sign + parts.join(',') + frac;
+}
+/** 金额 → 屏上的字（钱按两位小数：`1,093.25`）。 */
+export function formatInvoiceAmount(value) {
+    if (!Number.isFinite(value))
+        badInput('invoice-lines: 要排的金额必须是有限数');
+    return groupThousands((Math.round(Math.abs(value) * 100) / 100).toFixed(INVOICE_LINES_DECIMALS));
+}
+/** 有限数（必填）。 */
+function reqNum(value, field) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        badInput(field + ' 必须是有限数字');
+    return value;
+}
+/** 一行：校验 ＋ 排金额（`money` 是**已经带上钱符号**的那条排法，本件只造一份）。 */
+function lineModel(value, index, money) {
+    const field = 'invoice-lines: input.lines[' + index + ']';
+    assertPlainObject(value, field);
+    const raw = value;
+    const kindGiven = raw.kind;
+    if (!INVOICE_LINE_KINDS.includes(kindGiven)) {
+        badInput(field + '.kind 必须是 ' + INVOICE_LINE_KINDS.join('／') + ' 之一');
+    }
+    const kind = kindGiven;
+    if (index === 0 && kind !== 'base')
+        badInput(field + '：第一行必须是 kind: "base" 的原价（没有原价就没有「拆」这件事）');
+    if (index > 0 && kind === 'base')
+        badInput(field + '：原价只许出现在第一行');
+    const amount = reqNum(raw.amount, field + '.amount');
+    if (amount <= 0)
+        badInput(field + '.amount 必须是**正的量**（符号由 kind 定：减项前面挂 −）');
+    const why = optText(raw.why, field + '.why');
+    if (kind !== 'base' && why === undefined) {
+        badInput(field + '.why 必填（' + (kind === 'cut' ? '减项' : '加项')
+            + '说不出「为什么」，这一行就只剩一个金额——正是本件要替掉的那种读法）');
+    }
+    return {
+        label: reqText(raw.label, field + '.label'),
+        kind,
+        amount,
+        amountText: INVOICE_LINES_KIND_MARKS[kind] + money(amount),
+        why,
+    };
+}
+/** 串或串数组 → 段数组（与 `page-head` 同口径）。 */
+function textList(value, field) {
+    if (value === undefined)
+        return [];
+    if (typeof value === 'string') {
+        const one = optText(value, field);
+        return one === undefined ? [] : [one];
+    }
+    if (!Array.isArray(value))
+        badInput(field + ' 必须是字符串，或字符串数组（逐段一枚）');
+    const out = [];
+    for (let i = 0; i < value.length; i += 1) {
+        const one = optText(value[i], field + '[' + i + ']');
+        if (one !== undefined)
+            out.push(one);
+    }
+    return out;
+}
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `InvoiceLinesModel`。 */
+export function normalizeInvoiceLines(input) {
+    assertPlainObject(input, 'renderInvoiceLines: input');
+    const raw = input;
+    const form = raw.form === undefined ? INVOICE_LINES_FORMS[0] : raw.form;
+    if (!INVOICE_LINES_FORMS.includes(form)) {
+        badInput('invoice-lines: input.form 必须是 ' + INVOICE_LINES_FORMS.join('／') + ' 之一');
+    }
+    const given = raw.lines;
+    if (!Array.isArray(given))
+        badInput('invoice-lines: input.lines 必须是数组');
+    if (given.length < 2) {
+        badInput('invoice-lines: input.lines 至少要两行（只有原价＝没得拆；只有一行减项＝没有原价可比）');
+    }
+    /* 钱符号先定下来：**每一行的金额都带它**（只有实付带符号、减项不带，读者会以为减项不是钱）。 */
+    const symbol = optText(raw.symbol, 'invoice-lines: input.symbol') ?? INVOICE_LINES_SYMBOL;
+    const totalLabel = optText(raw.totalLabel, 'invoice-lines: input.totalLabel') ?? INVOICE_LINES_TOTAL_LABEL;
+    const money = (n) => symbol + formatInvoiceAmount(n);
+    const lines = given.map((l, i) => lineModel(l, i, money));
+    const baseLine = lines[0];
+    const base = baseLine.amount;
+    let cuts = 0;
+    let adds = 0;
+    for (const line of lines) {
+        if (line.kind === 'cut')
+            cuts += line.amount;
+        else if (line.kind === 'add')
+            adds += line.amount;
+    }
+    cuts = Math.round(cuts * 100) / 100;
+    adds = Math.round(adds * 100) / 100;
+    const total = Math.round((base - cuts + adds) * 100) / 100;
+    if (total < 0)
+        badInput('invoice-lines: 减项合计超过了原价（实付成了负数：' + money(total) + '）——先核对这几行的金额');
+    const diff = Math.round((base - total) * 100) / 100;
+    const deltaText = diff > 0 ? '比原价少 ' + money(diff)
+        : (diff < 0 ? '比原价多 ' + money(-diff) : '与原价相同');
+    /* 折扣：**折**是按十成算的（实付 ÷ 原价 × 10），不是百分数 —— 134／168 ＝ 8.0 折。 */
+    const discountText = diff > 0 && base > 0
+        ? '合 ' + (Math.round((total / base) * 100) / 10).toFixed(1) + ' 折'
+        : undefined;
+    /* 均摊：写进实付那一行的副语。除不尽时**说清差的那几分钱去哪了**，不四舍五入糊过去。 */
+    let shareText;
+    let shareNote;
+    const shareGiven = raw.share;
+    if (shareGiven !== undefined) {
+        assertPlainObject(shareGiven, 'invoice-lines: input.share');
+        const share = shareGiven;
+        const people = reqNum(share.people, 'invoice-lines: input.share.people');
+        if (!Number.isInteger(people) || people < 2)
+            badInput('invoice-lines: input.share.people 必须是 >= 2 的整数');
+        const each = Math.round((total / people) * 100) / 100;
+        shareText = INVOICE_LINES_SHARE_WORD + ' ' + String(people) + ' 人，每人 ' + money(each);
+        const rest = Math.round((total - each * people) * 100) / 100;
+        shareNote = optText(share.note, 'invoice-lines: input.share.note')
+            ?? (rest === 0 ? undefined
+                : '除不尽：先按每人 ' + money(each) + ' 算，差的 ' + money(rest) + ' 记在付款人头上');
+    }
+    /* 瀑布条：条长满分 ＝ 原价 ＋ 加项合计（减项与实付合起来正好铺满；加项自己抬高了起点）。 */
+    const span = Math.round((base + adds) * 100) / 100;
+    const pctOf = (n) => Math.round((n / span) * 10000) / 100;
+    const segments = [{
+            kind: 'total',
+            label: totalLabel,
+            amountText: money(total),
+            pct: pctOf(total),
+            wide: pctOf(total) >= INVOICE_LINES_SEGMENT_MIN_PCT,
+        }];
+    for (const line of lines) {
+        if (line.kind !== 'cut')
+            continue;
+        const pct = pctOf(line.amount);
+        segments.push({
+            kind: 'cut', label: line.label, amountText: line.amountText, pct, wide: pct >= INVOICE_LINES_SEGMENT_MIN_PCT,
+        });
+    }
+    return {
+        form: form,
+        lines,
+        base,
+        baseText: money(base),
+        cuts,
+        adds,
+        total,
+        totalText: money(total),
+        totalLabel,
+        symbol,
+        deltaText,
+        discountText,
+        shareText,
+        shareNote,
+        segments,
+        span,
+        spanText: money(span),
+        note: textList(raw.note, 'invoice-lines: input.note'),
+        extraClass: optExtraClass(raw.extraClass, 'invoice-lines: input.extraClass'),
+    };
+}