skill-bill 0.1.0 → 0.2.1

package/dist/query/list.js

@@ -0,0 +1,247 @@
+/** 通用查询列表页（查询域的**列表装配件**，也是本域页型表里「列表页」那一份的地址）：
+ *  结论句 → 页内导航 → 徽章列 → 读数行 → 主表（零行走空态）→ 分类聚合卡 → 截断明示 →
+ *  口径说明行 → 复制区 → 来源脚注。
+ *
+ * 谁在用（一个能力、四个调用点，指名）：`src/query/read.ts` 的四条读命令各出一页——
+ *   `viewRecordToday`（查今天那一族）／`viewRecordRange`（查区间那一族）／`viewRecordSearch`
+ *   （搜备注那一族）三条走本件；`viewRecordDetail`（查账单详情）走 `./detail.js`。
+ *
+ * **块序在本件只写一份**（本域页型表的第二层）：块清单 `blocks` 既拼正文也派生页内导航，
+ *  锚点与条目不由两处各写一次（见 `../shared/pageSections.js`）。列序同理，只住下面的 `COLUMNS`。
+ *
+ * 三源融合（逐块对照见 `docs/skills/skill-bill/t411-查询域-老模板逐块清单.md`）：
+ *   - **留**：KPI 行（老页 6 处共用一套数：笔数／支出／收入／净额）＋ 明细列表（老页 `recordsList`）＋
+ *     **分类聚合卡**（老页 `categoryBar` 前 8 类 `:261-266`／`:294-299`／`:509-520`：分类名＋金额／
+ *     笔数／占比／均额＋宽度条）＋ 空态（老页 8 处 `emptyState`）＋ 复制数据／日志两条通道（老页动作区）；
+ *   - **舍**：客户端 JS 渲染（老页注入 payload 再当场拼 DOM；新架构在 Node 侧渲染静态页）＋ 自绘样式层
+ *     与 `.records/.record` 版式（改走公共层组件）＋ `CHARTS-HELPERS` 与环形图挂钩（老页只有 breakdown
+ *     用，17 词里没有该路径）＋ 对比卡（老页 `compareCard`，属分析域）＋ 离线提示条与页脚的 `type`
+ *     代码与源脚本路径（老侧机制块；裁定 1 禁止脚本路径上屏）；
+ *   - **改**：语义表格（`renderDataTable`：`table/thead/th/td` ＋ 窄屏每格 `data-label` 行卡化）＝老自绘
+ *     grid 拿不到的可访问性与手机端表现；KPI 走 `renderKpiGrid`；空态用 `renderEmptyBlock`（多一句
+ *     「下一步说什么」）；复制区走三格式菜单；分类聚合的条形版式换公共层 `renderDistributionRows`；
+ *     老页 200 条的显示上限改成「按体积预算截 ＋ 折叠区明示 ＋ 口径行」（老页 `:524` `slice(0,200)`
+ *     ＋ `:533` 一行提示属**优点**——不静默截断——故继承其意图、换实现，理由见 `PAGE_BYTE_BUDGET`）；
+ *   - **不另出**：老侧 `data.filter` 那排筛选条件芯片——筛选条件已由副标题交代（本域既有口径，
+ *     t413／t414 逐条钉着），再出一排就是同一件事说两遍（裁定 6 同口径）。
+ *
+ * 数据表的列（本页**唯一一处**定义；表头文本与每格 `data-label` 同源）：
+ *   时间／分类／金额／账户／账本／备注／编号——「编号」列留着是为了说得出口的下一步：
+ *   用户拿它就能说「查账单详情」（老页没有这一列、也没有 detail 分支；这是新仓补的读链）。
+ */
+import { renderCaliberLine, renderChips, renderConclusionBar, renderDataTable, renderDistributionRows, renderDisclosure, renderEmptyBlock, renderKpiGrid } from 'base-paint/blocks';
+import { copyArea, copyLog } from '../shared/copyArea.js';
+import { DOC_SKILL, DOC_TITLE, DOC_VERSION, sceneKeyOf } from '../shared/pageIdentity.js';
+import { queryPageShell as pageShell } from './pageParts.js';
+import { sourceLine } from '../shared/sourceLine.js';
+import { commandLine } from '../shared/writeParts.js';
+import { estimateBytes } from '../render/html.js';
+import { pageBody, pageNav } from '../shared/pageSections.js';
+/** 数据表的列（**唯一定义地**）：表头文本、列序与对齐档。 */
+const COLUMNS = [
+    { key: 'time', label: '时间' },
+    { key: 'category', label: '分类' },
+    { key: 'amount', label: '金额', align: 'right' },
+    { key: 'account', label: '账户' },
+    { key: 'ledger', label: '账本' },
+    { key: 'note', label: '备注' },
+    { key: 'id', label: '编号' },
+];
+/** 一张表最多画多少条（**上限**，老侧 `query_view.html:524` 的 `slice(0,200)` 同数）。
+ *  真正的约束在 `PAGE_BYTE_BUDGET`：这个数是天花板，实际画多少由体积算出来（见 `queryListDoc`）。 */
+const DISPLAY_LIMIT = 200;
+/** 一整页的**体积预算**（字节）。交付路对写下去的那一串跑 `assertHtmlSize`
+ *  （`../render/html.ts:46`，上限 `BILL_HTML_MAX_BYTES = 262,144`），超了 **exit 5、整页不出**。
+ *
+ *  **口径重拍**，理由是固定条数保不住这条门：① 本页体积由**复制载荷**主导——复制区按 #247 给三种格式，
+ *  同一份数据落三处，实测每条约 1.6 KB；② 一行的体积**随内容长短变**——100 条普通备注 235 KB（过），
+ *  100 条 200 字长备注 **497 KB（撞门）**。故改成按当刻产物的真实字节定条数：
+ *  先按 `min(本窗条数, DISPLAY_LIMIT)` 试画，放不下就用**二分**找「放得下的最大条数」
+ *  （回退按比例猜会多扔两成版面）。于是页大小与查询规模、与单条内容长短**双重解耦**。
+ *  **出口载荷（stdout 那份 `data.items`）仍全量**，机器契约一字不动。 */
+const PAGE_BYTE_BUDGET = 240_000;
+/** 分类聚合卡的类数上限（老侧 `categoryBar` 的 `slice(0,8)` 同数）。 */
+const CATEGORY_LIMIT = 8;
+/** 合计金额的文本（两位小数）。**不是** `src/write/summaryRow.ts` 的 `money2`：那一件是「用户给的
+ *  那一笔金额」的口径（0 与缺省都写「未给」），这里是**合计**——合计为 0 是真实读数（这一天没花钱），
+ *  写成「未给」就是撒谎。两件事，两个定义。 */
+function sumText(n) {
+    return (Number.isFinite(n) ? n : 0).toFixed(2);
+}
+/** KPI 行四格：笔数／支出／收入／净额（口径由 `calcKpi` 算好，本件只摆版式）。 */
+function kpiCards(kpi) {
+    return [
+        { label: '笔数', value: String(kpi.count), detail: '转账不计进收支' },
+        { label: '支出', value: sumText(kpi.expense), detail: '本页支出合计' },
+        { label: '收入', value: sumText(kpi.income), detail: '本页收入合计' },
+        { label: '净额', value: sumText(kpi.net), detail: '收入减支出' },
+    ];
+}
+/** 结论句一行（裁定 2／§五 第 3 行「结论句一行」，⑤ 类恒出）。说的**不是**读数卡那四个数
+ *  （那是同一件事说两遍），而是「这批账主要是什么」这一句人话判定；没有支出时说清只有收入。 */
+function conclusionOf(input) {
+    if (input.rows.length === 0)
+        return '本窗没有记录。';
+    const top = input.categories[0];
+    if (top === undefined)
+        return '本页只有收入，没有支出。';
+    return '主要花在「' + top.label + '」，' + sumText(top.amount) + ' 元，占本页支出 '
+        + String(Math.round(top.pct)) + '%。';
+}
+/** 分类聚合卡的每一行：`名称 ｜ 占比条 ｜ 金额 · 笔数 · 均额`（老页 `categoryBar` 的四件事全在）。
+ *  占比由条长承载；均额＝该分类支出合计 ÷ 笔数。类数上限在本件截（老页 `slice(0,8)` 同数），
+ *  截掉了什么由紧跟其后那行口径说清——不静默截断。 */
+function categoryRows(input) {
+    if (input.categories.length === 0)
+        return [];
+    const shown = input.categories.slice(0, CATEGORY_LIMIT);
+    const hidden = input.categories.length - shown.length;
+    const rows = shown.map((c) => {
+        const parts = [sumText(c.amount) + ' 元', String(c.count) + ' 笔'];
+        if (c.count > 0)
+            parts.push('均 ' + sumText(c.amount / c.count));
+        return { label: c.label, value: parts.join(' · '), pct: c.pct };
+    });
+    const caliber = hidden > 0
+        ? renderCaliberLine('这一页只列支出最多的前 ' + String(CATEGORY_LIMIT) + ' 类，还有 ' + String(hidden) + ' 类没列')
+        : '';
+    return [{
+            nav: { anchor: 'sec-categories', navText: '分类聚合' },
+            heading: '分类聚合',
+            html: renderDistributionRows({ rows }) + caliber,
+        }];
+}
+/** 截断明示（§五 第 21 行，⑤ 类恒出）：表只画了一部分时，跟一个折叠区把「为什么只画这些、
+ *  怎么看到其余的」讲清，再跟一行口径（条数报的是**当刻真画了几条**）。老页「不静默截断」的意图继承。 */
+function truncatedBlocks(hidden, total, shownCount) {
+    if (hidden <= 0)
+        return [];
+    return [{
+            nav: { anchor: 'sec-truncated', navText: '没显示的记录' },
+            heading: '没显示的记录',
+            html: renderDisclosure({
+                title: '还有 ' + String(hidden) + ' 条没显示（这一页画了前 ' + String(shownCount) + ' 条）',
+                contentHtml: renderCaliberLine('要看其余的，把区间收窄再查一次；上面那几格读数与分类聚合不受影响，'
+                    + '它们一直按本窗全部 ' + String(total) + ' 条算'),
+            }) + renderCaliberLine('本页的表与复制区都只带前面 ' + String(shownCount) + ' 条，'
+                + '其余 ' + String(hidden) + ' 条按上面那一块说得出口'),
+        }];
+}
+/** 页面的复制载荷：**画出来的那一窗**（`items` 与表同截，序号一一对应——两者由同一个 `records`
+ *  按同一序号派生）。出口载荷（stdout 那份）仍全量，本件不动它。 */
+function pageEnvelopeOf(input, shownCount) {
+    const data = input.envelope.data;
+    return {
+        ...input.envelope,
+        data: {
+            ...data,
+            items: data.items.slice(0, shownCount),
+            total: data.total,
+        },
+    };
+}
+/** 列表页的口径说明行（裁定 2）。用全角竖线分段：公共层按它拆段、段间分隔交给版式（t154-r3）。 */
+function listCaliber() {
+    return renderCaliberLine('笔数与收支合计按本窗全部记录算，转账不计进收支'
+        + '｜分类聚合的条长＝该分类支出占本页支出合计的比例'
+        + '｜均额＝该分类支出合计 ÷ 该分类笔数');
+}
+/** 通用查询列表页：一整页。块序在本件只写一份（`blocks` 既拼正文也派生导航）。
+ *  **画多少条由体积算，不由死数定**（见 `PAGE_BYTE_BUDGET`）：判的是**真交付的那一串**，
+ *  先试上限，放不下就二分找「放得下的最大条数」。 */
+export function queryListDoc(input) {
+    const ceiling = Math.min(input.rows.length, DISPLAY_LIMIT);
+    if (ceiling === 0)
+        return renderQueryList(input, 0);
+    /** 画 n 条；放得下就把那一串给出来，放不下给 `null`。 */
+    const drawIfFits = (n) => {
+        const html = renderQueryList(input, n);
+        return estimateBytes(html) <= PAGE_BYTE_BUDGET ? html : null;
+    };
+    const atCeiling = drawIfFits(ceiling);
+    if (atCeiling !== null)
+        return atCeiling;
+    // 二分：`lo` 恒可放（1 条），`hi` 恒放不下（上限那一次已经试过了）。
+    let lo = 1;
+    let loHtml = drawIfFits(1);
+    let hi = ceiling;
+    while (hi - lo > 1) {
+        const mid = Math.floor((lo + hi) / 2);
+        const html = drawIfFits(mid);
+        if (html === null)
+            hi = mid;
+        else {
+            lo = mid;
+            loHtml = html;
+        }
+    }
+    // 连 1 条都超预算（正常内容不会；真发生也不静默丢整页——把 1 条那一版交出去，让体积门自己说话）。
+    return loHtml ?? renderQueryList(input, 1);
+}
+/** 一整页拼一次（入参给「画几条」）。体积回退那条循环按不同条数反复调本件。 */
+function renderQueryList(input, shownCount) {
+    const shown = input.rows.slice(0, shownCount);
+    const hidden = input.rows.length - shown.length;
+    const table = input.rows.length === 0
+        ? renderEmptyBlock({ text: input.emptyText, hint: input.emptyHint })
+        : '<div class="bill-query-wide">' + renderDataTable({
+            columns: COLUMNS,
+            rows: shown,
+            caption: hidden > 0 ? '查到的记录（前 ' + String(shownCount) + ' 条）' : '查到的记录',
+            emptyText: input.emptyText,
+        }) + '</div>';
+    const blocks = blocksOf(input, table, hidden, shownCount);
+    const content = renderConclusionBar(conclusionOf(input)) + pageNav(blocks) + pageBody(blocks);
+    return pageShell({
+        docTitle: DOC_TITLE + '·查询',
+        title: input.wakeWord,
+        subtitle: input.window,
+        slot: 'list',
+        page: 'list',
+        shape: input.shape,
+        key: input.key,
+        content,
+    });
+}
+/** 正文块清单（**块序唯一定义地**）：结论句与页内导航之外的八块。导航由本清单派生（见 `../shared/pageSections.js`）。 */
+function blocksOf(input, table, hidden, shownCount) {
+    const pageEnvelope = pageEnvelopeOf(input, shownCount);
+    return [
+        {
+            html: renderChips({ items: input.chips.map((text) => ({ text })) }),
+            nav: { anchor: 'sec-summary', navText: '结果' },
+        },
+        { html: renderKpiGrid(kpiCards(input.kpi)), nav: { anchor: 'sec-kpi', navText: '读数' } },
+        { html: table, nav: { anchor: 'sec-records', navText: '记录' }, heading: '记录' },
+        ...categoryRows(input),
+        ...truncatedBlocks(hidden, input.rows.length, shownCount),
+        { html: listCaliber(), nav: { anchor: 'sec-caliber', navText: '读数口径' } },
+        {
+            html: copyArea({
+                data: { envelope: pageEnvelope, title: input.wakeWord },
+                log: {
+                    envelope: pageEnvelope,
+                    copyLog: copyLog({
+                        command: commandLine(input.key, input.params),
+                        source: input.source,
+                        detail: '查到 ' + String(input.rows.length) + ' 笔',
+                        actionAt: input.actionAt,
+                        version: DOC_VERSION,
+                    }),
+                },
+            }),
+            nav: { anchor: 'sec-copy', navText: '复制' },
+        },
+        { html: sourceLine({ source: input.sourceText, start: input.windowStart, end: input.windowEnd, count: input.rows.length }) },
+    ];
+}
+/** 复制载荷那份 envelope 的取值口径（**唯一定义地**）：技能名／版本由公共标识给、场景名过 `sceneKeyOf`，
+ *  `data` 就是本次命令返回给出口的那一份载荷（同一件事不在页里再拼一遍）。列表与详情各一支——
+ *  形状与载荷必须成对，两支分开就写不出「list 配 detail 载荷」这种错。 */
+export function listEnvelope(key, data) {
+    return { version: DOC_VERSION, skill: DOC_SKILL, shape: 'list', key: sceneKeyOf(key), data };
+}
+export function detailEnvelope(key, data) {
+    return { version: DOC_VERSION, skill: DOC_SKILL, shape: 'detail', key: sceneKeyOf(key), data };
+}
+//# sourceMappingURL=list.js.map

package/dist/query/list.js.map

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

package/dist/query/pageParts.d.ts

@@ -0,0 +1,6 @@
+import type { PageShellInput } from '../shared/pageShell.js';
+/** 查询域各页的眉标。 */
+export declare const QUERY_EYEBROW = "\u8BB0\u8D26\uFF5C\u67E5\u8BE2\u57DF";
+/** 本域两张页型统一走它：补上眉标再转共用位的 `pageShell`；调用点写法 `pageShell({…})` 不变。 */
+export declare function queryPageShell(input: Omit<PageShellInput, 'eyebrow'>): string;
+//# sourceMappingURL=pageParts.d.ts.map

package/dist/query/pageParts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageParts.d.ts","sourceRoot":"","sources":["../../src/query/pageParts.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,gBAAgB;AAChB,eAAO,MAAM,aAAa,yCAAW,CAAC;AAEtC,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG,MAAM,CAE7E"}

package/dist/query/pageParts.js

@@ -0,0 +1,18 @@
+/** 查询域页内共件：**本域眉标** ＋ **两张页型共用的页框**。
+ *
+ * 谁在用（两张页型，指名）：`./list.ts` 的列表页（`queryListDoc`）与 `./detail.ts` 的详情页
+ *  （`queryDetailDoc`）——两页同一套页框（裁定 7「一个形状只许一处定义」）。
+ *
+ * 页内共件的另外两件（**区块锚点包装**与**页内导航**）已搬到共用位 `../shared/pageSections.js`：
+ *  写入域五张模板的回执页也要用同一套（第二个用法 ⇒ 提共用位），本件不再持它们。
+ *
+ * 查询域各页的眉标：**只在本域写一次**（共用位 `shared/pageShell.ts` 不持「域名→取值」表，照守卫③b）。
+ */
+import { pageShell } from '../shared/pageShell.js';
+/** 查询域各页的眉标。 */
+export const QUERY_EYEBROW = '记账｜查询域';
+/** 本域两张页型统一走它：补上眉标再转共用位的 `pageShell`；调用点写法 `pageShell({…})` 不变。 */
+export function queryPageShell(input) {
+    return pageShell({ ...input, eyebrow: QUERY_EYEBROW });
+}
+//# sourceMappingURL=pageParts.js.map

package/dist/query/pageParts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageParts.js","sourceRoot":"","sources":["../../src/query/pageParts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,gBAAgB;AAChB,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,CAAC;AAEtC,mEAAmE;AACnE,MAAM,UAAU,cAAc,CAAC,KAAsC;IACnE,OAAO,SAAS,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;AACzD,CAAC"}

package/dist/query/read.d.ts

@@ -0,0 +1,17 @@
+import type { BillDb } from '../fetch/index.js';
+import type { ViewOut } from '../shared/commandSpec.js';
+/** `bill.record.today`：查今天／查昨天／查某天／查最近（`recent` ＋ `limit` 1~200）／查账单；当日无记录不是故障，照实出零行的页。 */
+export declare function viewRecordToday(params: Record<string, unknown>, db: BillDb): ViewOut;
+/** `bill.record.range`：查周／查月（`range`＋锚点）／查区间（`start`＋`end` 同给，缺一即 exit 2）／
+ *  查分类（三级，无 / 视为 L1）／查账户／查账本（只过滤：KPI 照窗内收支、转账除外，余额无关）。
+ *  区间查不到记录 → 阻断（exit 4），不返一张空表冒充正常。 */
+export declare function viewRecordRange(params: Record<string, unknown>, db: BillDb): ViewOut;
+/** `bill.record.search`：搜备注（`q` 必给）／查标签（`kind:"tag"` ＋ `tag` 必给，精确匹配）／
+ *  查欠款／查待报销／查分期。空查询不返全量：既没 `q` 也没 `kind` → exit 2。 */
+export declare function viewRecordSearch(params: Record<string, unknown>, db: BillDb): ViewOut;
+/** `bill.record.detail`：查账单详情（`id` 必给，#415 专属版式）。取数含软删行（`includeDeleted` 经取数
+ *  公开接口）：真无此号才抛 `BILL_RECORD_NOT_FOUND`（exit 4），已撤销走整页＋已撤销徽，不冒充正常。
+ *  载荷 `item` 照搬迁前形状（`toBillItem` 8 字段）原样保留，另加 `created_at／deleted_at` 两列
+ *  （加法式，旧 8 字段一字不动）；页面字段表 10 列全交代，见 `./detail.js`。 */
+export declare function viewRecordDetail(params: Record<string, unknown>, db: BillDb): ViewOut;
+//# sourceMappingURL=read.d.ts.map

package/dist/query/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/query/read.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,MAAM,EAAW,MAAM,mBAAmB,CAAC;AASzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AA2GxD,2FAA2F;AAC3F,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CA8BpF;AAoCD;;uCAEuC;AACvC,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAkDpF;AAmBD;sDACsD;AACtD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CA8CrF;AAED;;;sDAGsD;AACtD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAsBrF"}

package/dist/query/read.js

@@ -0,0 +1,324 @@
+/** 查询域四条命令的处理体（**从 `src/cli/cmd_read.ts` 归位到这里**）：
+ *  `bill.record.today`（查今天／查昨天／查某天／查最近／查账单）／
+ *  `bill.record.range`（查周／查月／查区间／查分类／查账户／查账本）／
+ *  `bill.record.search`（搜备注／查标签／查欠款／查待报销／查分期）／
+ *  `bill.record.detail`（查账单详情）。一条命令一处，出口 `src/cli/cmd_read.ts` 只查注册表再调本域的门。
+ * **红线（本域既有语义，本次搬迁一字不改，逐条有测试钉着）**：
+ *   - 空查询不返全量：`search` 既没 `q` 也没 `kind` → exit 2；`range` 既没 start/end 也没条件 → exit 2；
+ *   - 坏输入阻断不冒充正常：区间查不到记录 → exit 4（不出一张空表冒充「查过了」）；`detail` 查无此号 → exit 4；
+ *   - `#tag` 精确匹配走取数层的 `listByTag`（本件不重写比对）；时间缺时分由 `../shared/dateRange.js` 补，本件不自己算日期。
+ * 分工：取数走 `../fetch`；口径走 `../shared/`（分类／日期窗口／`id` 槽位／KPI）；分类聚合走 `../analysis/index.js` 门
+ * （域→域只经对方的门）；行投影住 `./items.js`、整页装配走 `./list.js`——本件只做**编排与页面入参装配**。
+ * 查询没有「阻断改出过程型页」那一支：缺参即错误回执，页面只在真取到数（哪怕是零行）时出。
+ * （#689 结构搬迁第三批：`../policy/index.js` 与 `../render/views.js` 已拆散删除，上面这些名字各回新家。）
+ */
+import { DB_FILENAME, BillFetchError, fetchAll, listByTag, listToday, searchKeyword, tagMatch, } from '../fetch/index.js';
+import { BillPolicyError } from '../fetch/errors.js';
+import { validateCategory } from '../shared/category.js';
+import { normalizeDate, resolveQueryDate, resolveRange, yesterdayStr } from '../shared/dateRange.js';
+import { needId } from '../shared/params.js';
+import { projectWakeWord } from '../triggers/wakeTable.js';
+import { calcKpi } from '../shared/kpi.js';
+import { calcCategories } from '../analysis/index.js';
+import { toBillItem } from './items.js';
+import { actionStamp } from '../shared/copyArea.js';
+import { detailEnvelope, listEnvelope, queryListDoc } from './list.js';
+import { queryDetailDoc } from './detail.js';
+/** 本次数据来源（复制日志第 3 段）：库文件名逐字取本包常量，共用件不取本包文件名。 */
+const SOURCE_QUERY = DB_FILENAME + '（查询结果：只读，不改库）';
+/** 来源脚注上屏的那句人话来源（与 `SOURCE_QUERY` 分住两个常量）：复制日志给机器看、可带库文件名；
+ *  上屏的不许带库文件名与脚本路径（`688-融合基准.md` §四 裁定 1；老页脚恒印 `scripts/record_bill.py` 是反面）。 */
+const SOURCE_TEXT_QUERY = '记账库（只读）';
+/** 没有时间窗的查法（条件查、查最近）在来源脚注起止位写的那两个字——留空会读成缺值。 */
+const NO_WINDOW = '不限';
+/** 查分类的占比芯片（老页 `query_view.html:287` 的 `category_pct`）：该分类支出 ÷ 全库支出合计
+ *  （查分类没有时间窗，「同期」＝全部时间）。**本域唯一一处页面侧第二次取数**，故单独成函数记账。 */
+function shareChip(db, records) {
+    const mine = calcKpi([...records]).expense;
+    const all = calcKpi(fetchAll(db)).expense;
+    const pct = all === 0 ? 0 : Math.round((mine / all) * 100);
+    return '占全部支出的 ' + String(pct) + '%';
+}
+/** 一条库行 → 表格行（值一律文本化；金额照库里的符号写两位小数：支出负数、收入正数）。 */
+function tableRow(r) {
+    return {
+        id: String(r.id),
+        time: r.time,
+        category: r.category,
+        amount: r.amount.toFixed(2),
+        account: r.account,
+        ledger: r.ledger,
+        note: r.note,
+    };
+}
+/** 四条命令共用的收口：把「查到什么」装配成出口载荷（envelope `data`）＋ 一整页列表。
+ *  **载荷与页面同源但不同形**：载荷那一份照搬迁前的字段与类型（`items` 走 `toBillItem`，`id`／`amount`
+ *  是数，下游按 id 再查详情走的就是它）；页面那一份是文本化的表格行（`tableRow`）。两者同源同序。
+ *  KPI 只算一次（`calcKpi`）；分类聚合走 `calcCategories`（同一份口径，本件不自己归堆），
+ *  占比＝该分类支出 ÷ 本页支出合计。**页面侧多出的两件事实只在页面用、不进载荷**：
+ *  `extraChips`（结果胶囊里除条数之外的读数，如查分类的占比芯片）与 `windowStart`／`windowEnd`
+ *  （来源脚注的窗口起止）——载荷形状是既有契约，本票加法式不扩。 */
+function listOut(input) {
+    const records = [...input.records];
+    const rows = records.map(tableRow);
+    const kpi = calcKpi(records);
+    const categories = kpi.expense === 0 ? [] : calcCategories(records).map((c) => ({
+        label: c.category,
+        amount: c.total,
+        count: c.count,
+        pct: (c.total / kpi.expense) * 100,
+    }));
+    const data = { items: records.map(toBillItem), total: records.length, ...input.extra, kpi };
+    return {
+        data,
+        html: queryListDoc({
+            key: input.key,
+            params: input.params,
+            shape: 'list',
+            wakeWord: input.wakeWord,
+            window: input.window,
+            chips: ['共 ' + records.length + ' 笔', ...(input.extraChips ?? [])],
+            rows,
+            kpi,
+            categories,
+            emptyText: input.emptyText,
+            emptyHint: input.emptyHint,
+            envelope: listEnvelope(input.key, data),
+            source: SOURCE_QUERY,
+            sourceText: SOURCE_TEXT_QUERY,
+            windowStart: input.windowStart,
+            windowEnd: input.windowEnd,
+            actionAt: actionStamp(),
+        }),
+    };
+}
+/** today 分支的标题：这一页是哪条词由**域声明**算（#721 判据：一条唤醒词的字面量只准住它所属那份
+ *  域声明）。recent 不进本支（上游已分流）。 */
+function todayWakeWord(params) {
+    return projectWakeWord({ key: 'bill.record.today', preset: params });
+}
+/** today 分支的空态四句（**唯一判地**）+ 查某天自指已摘（说「换个日子再查一次」而不是「查某天」）。 */
+function todayEmpty(params) {
+    if (params.date === 'yesterday')
+        return { emptyText: '昨天还没有记录', emptyHint: '要补昨天那笔就说「记支出」。' };
+    if (params.date !== undefined && params.date !== null && params.date !== '')
+        return { emptyText: '这一天没有记录', emptyHint: '要记一笔就说「记支出」。换个日子再查一次。' };
+    return { emptyText: '今天还没有记录', emptyHint: '要记一笔就说「记支出」。' };
+}
+/** `bill.record.today`：查今天／查昨天／查某天／查最近（`recent` ＋ `limit` 1~200）／查账单；当日无记录不是故障，照实出零行的页。 */
+export function viewRecordToday(params, db) {
+    const key = 'bill.record.today';
+    if (params.recent === true) {
+        const limit = params.limit === undefined ? 10 : params.limit;
+        if (!Number.isInteger(limit) || limit < 1 || limit > 200) {
+            throw new BillPolicyError('POLICY_BAD_INPUT', 'recent limit 须为 1~200 的整数：' + String(limit));
+        }
+        const records = fetchAll(db)
+            .sort((a, b) => b.time.localeCompare(a.time) || b.id - a.id)
+            .slice(0, limit);
+        return listOut({
+            key, params, wakeWord: todayWakeWord(params), window: '最近 ' + String(limit) + ' 笔（按时间倒序）', records,
+            extra: { date: 'recent' },
+            emptyText: '库里还没有记录',
+            emptyHint: '要记一笔就说「记支出」。',
+            windowStart: NO_WINDOW,
+            windowEnd: NO_WINDOW,
+        });
+    }
+    const date = params.date === 'yesterday' ? yesterdayStr() : resolveQueryDate(params);
+    const records = listToday(db, date);
+    const empty = todayEmpty(params);
+    return listOut({
+        key, params, wakeWord: todayWakeWord(params), window: date + ' 这一天', records,
+        extra: { date },
+        emptyText: empty.emptyText,
+        emptyHint: empty.emptyHint,
+        windowStart: date,
+        windowEnd: date,
+    });
+}
+/** #413 · 区间查的「今天」锚点（与卡路里 #250 同序，种子日期不写死）：显式 `today` 参数 ＞ 机器时钟（UTC 日）。
+ *  #726：`BILL_TODAY` 那个环境 pin 随「环境变量全部删掉」（#675）一并退役——测试要钉钟就走测试基座的
+ *  钉钟预载件（`test/helpers/config-base.mjs` 的 `freezeClock()`／`freeze-clock.cjs`），不进源码。
+ *  下面两件是查询侧截到锚点的窗口（未来不计），与 `../shared/dateRange.js` 的 `weekRange／monthRange` 各管一摊。 */
+function rangeAnchor(params) {
+    const t = params.today;
+    if (t !== undefined && t !== null && t !== '')
+        return normalizeDate(t, 'today');
+    return new Date().toISOString().slice(0, 10);
+}
+/** #413 · 周一..锚点（UTC，周一为第一天；截到锚点，未来不计，与 #250「本周」同义）。 */
+function weekWindowFrom(anchor) {
+    const t = Date.parse(anchor + 'T12:00:00Z');
+    const back = (new Date(t).getUTCDay() + 6) % 7;
+    const mon = new Date(t - back * 86400000).toISOString().slice(0, 10);
+    return { start: mon, end: anchor };
+}
+/** #413 · 月初..锚点（月初到锚点，未来不计，与 #250「本月」同义）。 */
+function monthWindowFrom(anchor) {
+    return { start: anchor.slice(0, 8) + '01', end: anchor };
+}
+/** #413 · 单条件取值：缺席→undefined；空串／全空格／非串→阻断 exit 2——空值不许悄悄退化成
+ *  无条件全量（取数层 `fetchAll` 遇空串会忽略该条件，G2-2 穿透）。 */
+function condValue(params, field) {
+    const v = params[field];
+    if (v === undefined || v === null)
+        return undefined;
+    if (typeof v !== 'string' || !v.trim()) {
+        throw new BillPolicyError('POLICY_BAD_INPUT', field + ' 不得为空（空查询不返全量）');
+    }
+    return v.trim();
+}
+/** `bill.record.range`：查周／查月（`range`＋锚点）／查区间（`start`＋`end` 同给，缺一即 exit 2）／
+ *  查分类（三级，无 / 视为 L1）／查账户／查账本（只过滤：KPI 照窗内收支、转账除外，余额无关）。
+ *  区间查不到记录 → 阻断（exit 4），不返一张空表冒充正常。 */
+export function viewRecordRange(params, db) {
+    const key = 'bill.record.range';
+    const rawCategory = condValue(params, 'category');
+    const category = rawCategory === undefined ? undefined : validateCategory(rawCategory);
+    const account = condValue(params, 'account');
+    const ledger = condValue(params, 'ledger');
+    const cond = { category, account, ledger };
+    if (params.range === 'week' || params.range === 'month') {
+        const anchor = rangeAnchor(params);
+        const { start, end } = params.range === 'week' ? weekWindowFrom(anchor) : monthWindowFrom(anchor);
+        const records = fetchAll(db, { fromTime: start + ' 00:00:00', toTime: end + ' 23:59:59', ...cond });
+        if (!records.length)
+            throw new BillFetchError('BILL_EMPTY_RANGE', `区间无记录：${start}~${end}（缺失阻断，不返空统计）`);
+        return listOut({
+            key, params, wakeWord: projectWakeWord({ key, preset: params }),
+            window: start + ' ~ ' + end + (params.range === 'week' ? '（本周）' : '（本月）'),
+            records, extra: { start, end },
+            emptyText: '这一段没有记录',
+            emptyHint: '换个起止日期再查一次。',
+            windowStart: start,
+            windowEnd: end,
+        });
+    }
+    if (params.start !== undefined || params.end !== undefined) {
+        const { start, end } = resolveRange(params);
+        const records = fetchAll(db, { fromTime: start + ' 00:00:00', toTime: end + ' 23:59:59', ...cond });
+        if (!records.length)
+            throw new BillFetchError('BILL_EMPTY_RANGE', `区间无记录：${start}~${end}（缺失阻断，不返空统计）`);
+        return listOut({
+            key, params, wakeWord: projectWakeWord({ key, preset: params }), window: start + ' ~ ' + end, records, extra: { start, end },
+            emptyText: '这一段没有记录',
+            emptyHint: '换个起止日期再查一次。',
+            windowStart: start,
+            windowEnd: end,
+        });
+    }
+    if (category !== undefined || account !== undefined || ledger !== undefined) {
+        const records = fetchAll(db, cond);
+        if (!records.length)
+            throw new BillFetchError('BILL_EMPTY_RANGE', '条件无记录（缺失阻断，不返空统计）');
+        const by = category !== undefined ? '分类' : account !== undefined ? '账户' : '账本';
+        const value = String(category ?? account ?? ledger);
+        return listOut({
+            key, params, wakeWord: projectWakeWord({ key, preset: params }), window: by + '＝' + value + '（全部时间）', records,
+            extra: { start: '', end: '' },
+            extraChips: category === undefined ? [] : [shareChip(db, records)],
+            emptyText: '这个条件没有记录',
+            emptyHint: '换个条件，或说「查区间」并给出起止日期。',
+            windowStart: NO_WINDOW,
+            windowEnd: NO_WINDOW,
+        });
+    }
+    throw new BillPolicyError('POLICY_BAD_INPUT', '缺槽位 start/end（或 range=week/month，或 category/account/ledger 条件）');
+}
+/** #414 · 查欠款行判（**唯一判地**）：借贷分类或带 `#未还` 精确，且未带 `#已还` 精确——收回／偿还后
+ *  原记录分类仍是 `借贷/*`（换的只是 tag），不排除就把还清的也算成还欠着。 */
+function isDebtRow(r) {
+    return (r.category.startsWith('借贷/') || tagMatch(r.note, '未还')) && !tagMatch(r.note, '已还');
+}
+/** #414 · 查待报销行判（**唯一判地**）：带 `#待报销` 精确且未带 `#已报销` 精确（到账后消补）。 */
+function isReimburseRow(r) {
+    return tagMatch(r.note, '待报销') && !tagMatch(r.note, '已报销');
+}
+/** #414 · 查分期行判（**唯一判地**）：分期分类或带 `#分期`／`#分期中` 精确（写侧记分期不落 `#tag`，
+ *  分类是主口径，两串并存）。 */
+function isInstallmentRow(r) {
+    return r.category.startsWith('分期/') || tagMatch(r.note, '分期') || tagMatch(r.note, '分期中');
+}
+/** `bill.record.search`：搜备注（`q` 必给）／查标签（`kind:"tag"` ＋ `tag` 必给，精确匹配）／
+ *  查欠款／查待报销／查分期。空查询不返全量：既没 `q` 也没 `kind` → exit 2。 */
+export function viewRecordSearch(params, db) {
+    const key = 'bill.record.search';
+    const kind = params.kind === undefined ? '' : String(params.kind);
+    let records;
+    let window;
+    let label;
+    if (kind === 'tag') {
+        const rawTag = params.tag;
+        if (typeof rawTag !== 'string' || !rawTag.trim()) {
+            throw new BillPolicyError('POLICY_BAD_INPUT', '查标签须给 tag');
+        }
+        const tag = rawTag.trim();
+        records = listByTag(db, tag);
+        label = 'tag:' + tag;
+        window = '标签 ' + tag + '（精确匹配）';
+    }
+    else if (kind === 'debt') {
+        records = fetchAll(db).filter(isDebtRow);
+        label = 'debt';
+        window = '还欠着的那些账';
+    }
+    else if (kind === 'reimburse') {
+        records = fetchAll(db).filter(isReimburseRow);
+        label = 'reimburse';
+        window = '等着报销的那些账';
+    }
+    else if (kind === 'installment') {
+        records = fetchAll(db).filter(isInstallmentRow);
+        label = 'installment';
+        window = '分期还款的那些账';
+    }
+    else {
+        const rawQ = params.q;
+        if (typeof rawQ !== 'string' || !rawQ.trim()) {
+            throw new BillPolicyError('POLICY_BAD_INPUT', '搜备注须给 q');
+        }
+        const q = rawQ.trim();
+        records = searchKeyword(db, q);
+        label = 'search:' + q;
+        window = '备注里有「' + q + '」的记录';
+    }
+    // 这一页是哪条词（查标签／查欠款／查待报销／查分期／搜备注）由**域声明**按同一份入参算，本件不写第二处。
+    const wakeWord = projectWakeWord({ key, preset: params });
+    return listOut({
+        key, params, wakeWord, window, records, extra: { kind: label },
+        emptyText: '没有找到符合条件的记录',
+        emptyHint: '换个关键词试试，也可以看看「查最近」。',
+        windowStart: NO_WINDOW,
+        windowEnd: NO_WINDOW,
+    });
+}
+/** `bill.record.detail`：查账单详情（`id` 必给，#415 专属版式）。取数含软删行（`includeDeleted` 经取数
+ *  公开接口）：真无此号才抛 `BILL_RECORD_NOT_FOUND`（exit 4），已撤销走整页＋已撤销徽，不冒充正常。
+ *  载荷 `item` 照搬迁前形状（`toBillItem` 8 字段）原样保留，另加 `created_at／deleted_at` 两列
+ *  （加法式，旧 8 字段一字不动）；页面字段表 10 列全交代，见 `./detail.js`。 */
+export function viewRecordDetail(params, db) {
+    const key = 'bill.record.detail';
+    const id = needId(params);
+    const row = fetchAll(db, { includeDeleted: true }).find((r) => r.id === id);
+    if (!row)
+        throw new BillFetchError('BILL_RECORD_NOT_FOUND', '无此账单：' + id);
+    const data = { item: { ...toBillItem(row), created_at: row.created_at, deleted_at: row.deleted_at } };
+    const deleted = row.deleted_at !== null && row.deleted_at !== '';
+    return {
+        data,
+        html: queryDetailDoc({
+            key,
+            params,
+            wakeWord: projectWakeWord({ key, preset: params }),
+            window: row.time,
+            chips: deleted ? ['记录编号 ' + row.id, '已撤销'] : ['记录编号 ' + row.id],
+            row,
+            envelope: detailEnvelope(key, data),
+            source: SOURCE_QUERY,
+            sourceText: SOURCE_TEXT_QUERY,
+            actionAt: actionStamp(),
+        }),
+    };
+}
+//# sourceMappingURL=read.js.map