skill-bill 0.1.0 → 0.2.1

package/dist/query/declaration.js

@@ -0,0 +1,251 @@
+export const QUERY_DECLARATION = {
+    id: 'query',
+    label: '查询',
+    icon: '🔍',
+    order: 2,
+    entries: [
+        {
+            phrase: '查今天',
+            key: 'bill.record.today',
+            scenes: [
+                {
+                    id: 'query_today',
+                    title: '查今天收支',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我看今天的收支(唤醒词:查今天):\n',
+                    types: ['查看'],
+                },
+            ],
+        },
+        {
+            phrase: '查昨天',
+            key: 'bill.record.today',
+            preset: { date: 'yesterday' },
+            scenes: [
+                {
+                    id: 'query_yesterday',
+                    title: '查昨天收支',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我看昨天的收支(唤醒词:查昨天):\n',
+                    types: ['查看'],
+                },
+            ],
+        },
+        {
+            phrase: '查某天',
+            key: 'bill.record.today',
+            needs: ['date'],
+            scenes: [
+                {
+                    id: 'query_date',
+                    title: '查某一天的账',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我查某天的账(唤醒词:查某天):\n\n  日  期: ____ (如:5月1号 / 上周五 / 2026-05-01)\n',
+                    types: ['查看'],
+                },
+            ],
+        },
+        {
+            phrase: '查最近',
+            key: 'bill.record.today',
+            preset: { recent: true },
+            scenes: [
+                {
+                    id: 'query_recent',
+                    title: '查最近记录',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我看最近的记录(唤醒词:查最近):\n\n  条  数: ____ (选填,默认 10)\n  排  序: ____ (选填,如:金额从大到小)\n  近几天: ____ (选填,如:近7天 / 近30天;与条数二选一)\n',
+                    types: ['查看'],
+                },
+            ],
+        },
+        {
+            phrase: '查账单',
+            key: 'bill.record.today',
+            scenes: [
+                {
+                    id: 'query_bills',
+                    title: '查账单',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我查账单(唤醒词:查账单):\n\n  日  期: ____ (选填,默认今天;可写「昨天」或「2026-09-06」)\n',
+                    types: ['查看'],
+                },
+            ],
+        },
+        {
+            phrase: '查周',
+            key: 'bill.record.range',
+            preset: { range: 'week' },
+            scenes: [
+                {
+                    id: 'query_week',
+                    title: '查某周的账',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我查某周的账(唤醒词:查周):\n\n  周: ____ (如:本周 / 上周 / 5月第2周 / 2026-05-11那一周)\n',
+                    types: ['查看'],
+                },
+            ],
+        },
+        {
+            phrase: '查月',
+            key: 'bill.record.range',
+            preset: { range: 'month' },
+            scenes: [
+                {
+                    id: 'query_month',
+                    title: '查某个月的账',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我查某个月的账(唤醒词:查月):\n\n  月: ____ (如:本月 / 上月 / 3月 / 2026-03)\n',
+                    types: ['查看'],
+                },
+            ],
+        },
+        {
+            phrase: '查区间',
+            key: 'bill.record.range',
+            needs: ['start', 'end'],
+            scenes: [
+                {
+                    id: 'query_range',
+                    title: '查任意时间段',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我查某段时间的账(唤醒词:查区间):\n\n  开始日期: ____ (如:5月1号 / 2026-05-01)\n  结束日期: ____ (如:5月10号 / 2026-05-10;某年填 12月31日)\n',
+                    types: ['查看'],
+                },
+            ],
+        },
+        {
+            phrase: '查分类',
+            key: 'bill.record.range',
+            needs: ['category'],
+            scenes: [
+                {
+                    id: 'query_category',
+                    title: '查某分类的账',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我查某分类的账(唤醒词:查分类):\n\n  分  类: ____ (如:餐饮 / 出行 / 奶茶)\n  时  间: ____ (选填,如:本月 / 5月 / 5月1到10号)\n  账  户: ____ (选填,如:支付宝)\n  账  本: ____ (选填)\n  收  支: ____ (选填,支出/收入/全部,默认全部)\n',
+                    types: ['查看'],
+                },
+            ],
+        },
+        {
+            phrase: '查账户',
+            key: 'bill.record.range',
+            needs: ['account'],
+            scenes: [
+                {
+                    id: 'query_account',
+                    title: '查某账户流水',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我查某账户的流水(唤醒词:查账户):\n\n  账  户: ____ (如:支付宝 / 微信 / 招行)\n  时  间: ____ (选填,如:本月 / 上月)\n',
+                    types: ['查看'],
+                },
+            ],
+        },
+        {
+            phrase: '查账本',
+            key: 'bill.record.range',
+            needs: ['ledger'],
+            scenes: [
+                {
+                    id: 'query_ledger',
+                    title: '查某账本的记录',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我查某账本的记录(唤醒词:查账本):\n\n  账  本: ____ (如:生活 / 旅行 / 借贷)\n  时  间: ____ (选填)\n',
+                    types: ['查看'],
+                },
+            ],
+        },
+        {
+            phrase: '搜备注',
+            key: 'bill.record.search',
+            needs: ['q'],
+            scenes: [
+                {
+                    id: 'query_search',
+                    title: '搜索备注关键词',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我搜备注关键词(唤醒词:搜备注):\n\n  关键词: ____\n',
+                    types: ['查看'],
+                },
+            ],
+        },
+        {
+            phrase: '查标签',
+            key: 'bill.record.search',
+            preset: { kind: 'tag' },
+            needs: ['tag'],
+            scenes: [
+                {
+                    id: 'query_tag',
+                    title: '查标签(#tag 聚合)',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我查标签(唤醒词:查标签):\n\n  标  签: ____ (如:#旅行 / #待报销)\n',
+                    types: ['查看'],
+                },
+            ],
+        },
+        {
+            phrase: '查欠款',
+            key: 'bill.record.search',
+            preset: { kind: 'debt' },
+            scenes: [
+                {
+                    id: 'query_debt',
+                    title: '查未还欠款(借贷状态)',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我查欠款(唤醒词:查欠款):\n\n  对  象: ____ (选填,如:小明;不填查全部)\n',
+                    types: ['查看'],
+                },
+            ],
+        },
+        {
+            phrase: '查待报销',
+            key: 'bill.record.search',
+            preset: { kind: 'reimburse' },
+            scenes: [
+                {
+                    id: 'query_pending_reimburse',
+                    title: '查待报销',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我查待报销(唤醒词:查待报销):\n',
+                    types: ['查看'],
+                },
+            ],
+        },
+        {
+            phrase: '查分期',
+            key: 'bill.record.search',
+            preset: { kind: 'installment' },
+            scenes: [
+                {
+                    id: 'query_installment',
+                    title: '查进行中的分期',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我查分期(唤醒词:查分期):\n\n  名  目: ____ (选填,如:手机;不填查全部)\n',
+                    types: ['查看'],
+                },
+            ],
+        },
+        {
+            phrase: '查账单详情',
+            key: 'bill.record.detail',
+            needs: ['id'],
+            scenes: [
+                {
+                    id: 'query_bill_detail',
+                    title: '查账单详情',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我查一条账单的详情(唤醒词:查账单详情):\n\n  记录 id: ____ (从「查账单」或「查今天」的列表里取)\n',
+                    types: ['查看'],
+                },
+            ],
+        },
+    ],
+    subgroups: [
+        { id: 'query_1', label: '按时间', scenes: ['query_today', 'query_yesterday', 'query_date', 'query_recent', 'query_week', 'query_month', 'query_range', 'query_bills', 'query_bill_detail'] },
+        { id: 'query_2', label: '按条件', scenes: ['query_category', 'query_search', 'query_tag', 'query_account', 'query_ledger'] },
+        { id: 'query_3', label: '按状态', scenes: ['query_debt', 'query_pending_reimburse', 'query_installment'] },
+    ],
+};
+//# sourceMappingURL=declaration.js.map

package/dist/query/declaration.js.map

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

package/dist/query/detail.d.ts

@@ -0,0 +1,28 @@
+import type { SerializableEnvelope } from 'base-paint';
+import type { BillRow } from '../fetch/index.js';
+/** 详情页的入参：这一页是谁（命令名／唤醒词／窗口）＋ 查到哪一条 ＋ 复制日志与来源脚注的取数。 */
+export interface QueryDetailInput {
+    /** 对外命令名（`bill.record.detail`），页标记与复制日志的调用链都读它。 */
+    readonly key: string;
+    /** 本次参数（复制日志那行命令原文照它拼，可照抄重跑）。 */
+    readonly params: Record<string, unknown>;
+    /** 页标题＝用户说的那条唤醒词（本页恒为 `查账单详情`）。 */
+    readonly wakeWord: string;
+    /** 副标题：这条记录的时刻。编号与已撤销态不在这里——它们各是一枚胶囊（行内 `·` 不许进版式位）。 */
+    readonly window: string;
+    /** 结果胶囊：首枚恒为 `记录编号 <id>`；已撤销再加一枚 `已撤销`（状态卡已有徽，胶囊只说事实）。 */
+    readonly chips: readonly string[];
+    /** 查到的那一条（含软删列，调用方已按 `includeDeleted` 取到）。 */
+    readonly row: BillRow;
+    /** 复制载荷：**本次查询的 envelope 本身**（`detailEnvelope`，复制区直接序列化它）。 */
+    readonly envelope: SerializableEnvelope;
+    /** 本次数据来源（复制日志第 3 段）。 */
+    readonly source: string;
+    /** 来源脚注上屏的人话来源（**不许带脚本路径与库文件名**，裁定 1）。 */
+    readonly sourceText: string;
+    /** 本次执行时刻（复制日志第 5 段）。 */
+    readonly actionAt: string;
+}
+/** 查询详情页：一整页（页头 ＋ 八块正文）。 */
+export declare function queryDetailDoc(input: QueryDetailInput): string;
+//# sourceMappingURL=detail.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detail.d.ts","sourceRoot":"","sources":["../../src/query/detail.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AASvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,sDAAsD;AACtD,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,8CAA8C;IAC9C,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,yBAAyB;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yBAAyB;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AA+ED,4BAA4B;AAC5B,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CA0C9D"}

package/dist/query/detail.js

@@ -0,0 +1,143 @@
+/** 查询域详情页装配件（#415 专属版式，也是本域页型表里「详情页」那一份的地址）：
+ *  结论句 → 页内导航 → 徽章列 → 读数卡（金额＋状态）→ 字段表（10 行全，窄屏替键值列表）→
+ *  口径说明行 → 复制区 → 来源脚注。
+ *
+ * 谁在用（一个调用点，指名）：`src/query/read.ts` 的 `viewRecordDetail`（查账单详情）——
+ *   today／range／search 三支仍走 `./list.js` 的 `queryListDoc`，本件不动它们。
+ *
+ * **块序在本件只写一份**：块清单 `blocks` 既拼正文也派生页内导航（见 `../shared/pageSections.js`）。
+ *
+ * 三源融合（老 `templates/query_view.html` 无 detail 分支，注入 `type=detail` 落未知类型错误回执——
+ *   `t411-查询域-老模板逐块清单.md §1`；这是新仓补的读链）：
+ *   - **留**：复制数据／日志两条通道（老页动作区）＋ 页头三件套；
+ *   - **舍**：KPI 四格（单条笔数恒 1 是废话，支出／收入／净额三格对单条互斥其二为零）＋
+ *     七列表格（币种／创建时间／软删态三列无处可放）；
+ *   - **改**：金额卡＋状态卡（两格）＋ 字段明细（10 行，币种与两时间列首次可见）——
+ *     桌面端是字段／值两列竖表，移动端是同一数据源派生的键值列表（t403-P2：窄屏行卡化会逐行
+ *     重复表头标签，键值列表每行即「字段名＋值」，两套显隐见 `../shared/docPage.js` 的 KV_CSS）。
+ *
+ * 页型归属（`docs/skills/skill-bill/688-融合基准.md` §5.1）：本页属**⑥ 结果型汇总／进度／状态页**
+ *   （「读数卡 ＋ 进度条或状态判定」——本页是那支**状态判定**）。该类的第 13 行「分类聚合／占比条」
+ *   与第 15 行「进度条」在单条记录页**无内容可画**，本件不出，理由与读数记在该域差异表里（不写成对上）。
+ */
+import { renderCaliberLine, renderChips, renderConclusionBar, renderDataTable, renderKpiGrid } from 'base-paint/blocks';
+import { escapeHtml } from 'base-paint';
+import { copyArea, copyLog } from '../shared/copyArea.js';
+import { DOC_TITLE, DOC_VERSION } from '../shared/pageIdentity.js';
+import { queryPageShell as pageShell } from './pageParts.js';
+import { sourceLine } from '../shared/sourceLine.js';
+import { commandLine } from '../shared/writeParts.js';
+import { pageBody, pageNav } from '../shared/pageSections.js';
+/** 字段表的列（**唯一定义地**）：字段／值两列，表头文本与每格 `data-label` 同源。表题叫「字段明细」：
+ *  H1 已是「查账单详情」，caption 再叫「账单详情」就是同一句话说两遍。 */
+const DETAIL_COLUMNS = [
+    { key: 'field', label: '字段' },
+    { key: 'value', label: '值' },
+];
+/** 空值占位（字段行永不缺席，无值即此符，空行不算交代）。 */
+const EMPTY_CELL = '—';
+/** 文本或占位（空串／全空格即占位，前后空格不进页）。 */
+function textOrDash(v) {
+    return v.trim() === '' ? EMPTY_CELL : v;
+}
+/** 金额卡＋状态卡（两格）：单条 KPI 四格语义弱（笔数恒 1），本页只留金额与状态。
+ *  金额文案与载荷数值逐字一致（两位小数，符号照库）；状态徽正常 `ok`／已撤销 `danger`。
+ *  正常态不写 detail：值「正常」＋ ok 徽已是两遍，第三遍「记录有效」是同一件事说三遍；
+ *  已撤销才写 detail（撤销时间是新增事实）。 */
+function detailCards(row, deleted) {
+    const amount = row.amount.toFixed(2);
+    return [
+        {
+            label: '金额',
+            value: amount,
+            detail: row.amount < 0 ? '支出' : row.amount > 0 ? '收入' : '零金额',
+        },
+        {
+            label: '状态',
+            value: deleted ? '已撤销' : '正常',
+            status: deleted ? 'danger' : 'ok',
+            statusText: deleted ? '已撤销' : '正常',
+            ...(deleted ? { detail: '撤销时间 ' + String(row.deleted_at) } : {}),
+        },
+    ];
+}
+/** 字段表十行（库行 10 列全交代）：编号／时间／分类／金额／账户／账本／币种／备注／创建时间／删除时间。
+ *  金额两位小数与载荷同字；币种缺省也是读数（默认人民币）；删除时间无值即占位（无后缀即正常）。 */
+function detailRows(row, deleted) {
+    return [
+        { field: '编号', value: String(row.id) },
+        { field: '时间', value: row.time },
+        { field: '分类', value: row.category },
+        { field: '金额', value: row.amount.toFixed(2) },
+        { field: '账户', value: textOrDash(row.account) },
+        { field: '账本', value: textOrDash(row.ledger) },
+        { field: '币种', value: row.currency !== '' ? row.currency : EMPTY_CELL },
+        { field: '备注', value: textOrDash(row.note) },
+        { field: '创建时间', value: row.created_at !== '' ? row.created_at : EMPTY_CELL },
+        { field: '删除时间', value: deleted ? String(row.deleted_at) : EMPTY_CELL },
+    ];
+}
+/** 移动端键值列表（与字段表**同一数据源派生、只转形状**：字段名与值只在 `detailRows` 定义一处，
+ *  本件不重写第二份）。桌面端藏、窄屏替表格（显隐见 `../shared/docPage.js` 的 KV_CSS，每端恰出一套）；
+ *  转义与表格单元格同口径（公共层 `base-paint` 的 `escapeHtml`，与 `renderDataTable` 的单元格同为五字符）。 */
+function kvList(rows) {
+    return '<dl class="ilife-query-kv-list">' + rows.map((r) => '<div><dt>' + escapeHtml(String(r.field)) + '</dt><dd>' + escapeHtml(String(r.value)) + '</dd></div>').join('') + '</dl>';
+}
+/** 结论句一行（§五 第 3 行，⑥ 类恒出）：说的**不是**金额卡那个数（那是同一件事说两遍），
+ *  而是「这一条现在能不能用」这一句判定——已撤销的那一条最要紧的就是这句话。 */
+function conclusionOf(deleted) {
+    if (deleted)
+        return '这一条已经撤销，不再计进任何读数。';
+    return '这一条有效，正着记在账上。';
+}
+/** 详情页的口径说明行（裁定 2）。全角竖线分段，段间分隔交给版式（t154-r3），不拿标点当版式。 */
+function detailCaliber() {
+    return renderCaliberLine('字段值照库里存的原文写，空值写 ' + EMPTY_CELL + ' 不写 0'
+        + '｜已撤销的记录仍可按编号查到，删除时间那一行就是撤销时刻'
+        + '｜窄屏把字段表换成键值列表，两份内容同源');
+}
+/** 查询详情页：一整页（页头 ＋ 八块正文）。 */
+export function queryDetailDoc(input) {
+    const deleted = input.row.deleted_at !== null && input.row.deleted_at !== '';
+    const rows = detailRows(input.row, deleted);
+    const blocks = [
+        { html: renderChips({ items: input.chips.map((text) => ({ text })) }), nav: { anchor: 'sec-summary', navText: '结果' } },
+        { html: renderKpiGrid(detailCards(input.row, deleted)), nav: { anchor: 'sec-kpi', navText: '读数' } },
+        {
+            html: '<div class="ilife-query-kv-table">'
+                + renderDataTable({ columns: DETAIL_COLUMNS, rows, caption: '字段明细' }) + '</div>'
+                + kvList(rows),
+            nav: { anchor: 'sec-fields', navText: '字段' },
+        },
+        { html: detailCaliber(), nav: { anchor: 'sec-caliber', navText: '读数口径' } },
+        {
+            html: copyArea({
+                data: { envelope: input.envelope, title: input.wakeWord },
+                log: {
+                    envelope: input.envelope,
+                    copyLog: copyLog({
+                        command: commandLine(input.key, input.params),
+                        source: input.source,
+                        detail: '详情 1 笔 · 记录编号 ' + input.row.id + (deleted ? ' · 已撤销' : ' · 正常'),
+                        actionAt: input.actionAt,
+                        version: DOC_VERSION,
+                    }),
+                },
+            }),
+            nav: { anchor: 'sec-copy', navText: '复制' },
+        },
+        { html: sourceLine({ source: input.sourceText, start: input.row.time, end: input.row.time, count: 1 }) },
+    ];
+    const content = renderConclusionBar(conclusionOf(deleted)) + pageNav(blocks) + pageBody(blocks);
+    return pageShell({
+        docTitle: DOC_TITLE + '·查询',
+        title: input.wakeWord,
+        subtitle: input.window,
+        slot: 'list',
+        page: 'list',
+        shape: 'detail',
+        key: input.key,
+        content,
+    });
+}
+//# sourceMappingURL=detail.js.map

package/dist/query/detail.js.map

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

package/dist/query/index.d.ts

@@ -0,0 +1,19 @@
+/** 记账查询域对外的门：命令声明 ＋ 一个读入口。对外两件（铁律五「不多于五个」）：
+ *   ① `QUERY_COMMANDS`——命令声明（权威源在 `commands.ts`，这里只是转出）；
+ *   ② `runQueryRead(key, params, db)`——读命令入口（**非本域命令即抛，不猜、不静默兜底**）。
+ *
+ * #691 起**收窄一件**：原先还转出 `toBillItem`／`BillItem`（载荷行投影），理由是当时第 3 个出现点是
+ *  `src/cli/cmd_read.ts` 的 account.query 分支（按 #683 §3.9 暂住本域，等分析域真要用时再上浮共用位）。
+ *  账户域那两条命令搬进 `src/account/` 之后，本域之外**已无消费方**（查询域自己的 `read.ts` 直接引
+ *  `./items.js`）⇒ 门跟着收窄，不再转出那两件；件本身仍住 `./items.js`（查询域自用）。
+ *
+ * 域内其他件（处理体 `read.ts`／列表装配件 `list.ts`／详情装配件 `detail.ts`／行投影 `items.ts`）
+ *  **不出这个目录**，故不在这里转出。
+ * 形状照 `../write/index.ts`（同一包内三域同形）：那边的第二参是饼干库句柄 `BillDb`，这里同。
+ */
+import type { BillDb } from '../fetch/db.js';
+import type { ViewOut } from '../shared/commandSpec.js';
+export { QUERY_COMMANDS } from './commands.js';
+/** 读命令入口：命中即走它的处理函数；命令名不属记账查询域即抛——**不猜**。 */
+export declare function runQueryRead(key: string, params: Record<string, unknown>, db: BillDb): ViewOut;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAGxD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAI/C,6CAA6C;AAC7C,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAI9F"}

package/dist/query/index.js

@@ -0,0 +1,12 @@
+import { BillPolicyError } from '../fetch/errors.js';
+import { QUERY_COMMANDS } from './commands.js';
+export { QUERY_COMMANDS } from './commands.js';
+const BY_KEY = new Map(QUERY_COMMANDS.map((c) => [c.key, c]));
+/** 读命令入口：命中即走它的处理函数；命令名不属记账查询域即抛——**不猜**。 */
+export function runQueryRead(key, params, db) {
+    const spec = BY_KEY.get(key);
+    if (!spec)
+        throw new BillPolicyError('POLICY_BAD_INPUT', '不是记账查询域的命令：' + key);
+    return spec.run(params, db);
+}
+//# sourceMappingURL=index.js.map

package/dist/query/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9D,6CAA6C;AAC7C,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,MAA+B,EAAE,EAAU;IACnF,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,aAAa,GAAG,GAAG,CAAC,CAAC;IAC9E,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC9B,CAAC"}

package/dist/query/items.d.ts

@@ -0,0 +1,22 @@
+/** 查询域·载荷行投影（#689 结构搬迁第三批：从 `src/render/views.ts` 拆来，**暂住查询域**）。
+ *  一件事实：库行（`BillRow`，10 列）→ 载荷行（`BillItem`，8 字段）——载荷形状是既有契约，字段与序一字不动。
+ *
+ *  出现点实测三个：`./read.ts` 两处（列表载荷 `items`、详情载荷 `item`）＋ `src/cli/cmd_read.ts` 的
+ *  account.query 分支（账户最近三笔）。没有第二个**域**在用它 ⇒ 按归属律 1 暂住查询域
+ *  （#683 §3.9 的处置）；分析域真要用明细行时按归属律 2 上浮共用位。
+ *
+ *  谁在用（指名）：`src/query/read.ts`（`toBillItem`／`BillItem` 类型）·
+ *    `src/cli/cmd_read.ts`（外壳，经 `./index.js` 门取）。 */
+import type { BillRow } from '../fetch/db.js';
+export interface BillItem {
+    id: number;
+    category: string;
+    time: string;
+    amount: number;
+    account: string;
+    ledger: string;
+    currency: string;
+    note: string;
+}
+export declare function toBillItem(r: BillRow): BillItem;
+//# sourceMappingURL=items.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"items.d.ts","sourceRoot":"","sources":["../../src/query/items.ts"],"names":[],"mappings":"AAAA;;;;;;;;qDAQqD;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAC3D,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;CACjE;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,QAAQ,CAK/C"}

package/dist/query/items.js

@@ -0,0 +1,7 @@
+export function toBillItem(r) {
+    return {
+        id: r.id, category: r.category, time: r.time, amount: r.amount,
+        account: r.account, ledger: r.ledger, currency: r.currency, note: r.note,
+    };
+}
+//# sourceMappingURL=items.js.map

package/dist/query/items.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"items.js","sourceRoot":"","sources":["../../src/query/items.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,UAAU,CAAC,CAAU;IACnC,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM;QAC9D,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI;KACzE,CAAC;AACJ,CAAC"}

package/dist/query/list.d.ts

@@ -0,0 +1,100 @@
+import type { SerializableEnvelope } from 'base-paint';
+/** 数据表的一行（值一律是已文本化的字符串：表格不吃对象，也不做二次格式化）。
+ *  写成 `type` 别名而不是 `interface`：公共层的表格与复制载荷收 `Record<string, unknown>`，
+ *  别名形态自带隐式索引签名、能直接过，interface 会被「缺索引签名」挡住。 */
+export type QueryTableRow = {
+    readonly id: string;
+    readonly time: string;
+    readonly category: string;
+    readonly amount: string;
+    readonly account: string;
+    readonly ledger: string;
+    readonly note: string;
+};
+/** KPI 行四格的事实（口径来自 `../shared/kpi.js` 的 `calcKpi`，本件只排版、不重算）。 */
+export type QueryKpi = {
+    readonly count: number;
+    readonly expense: number;
+    readonly income: number;
+    readonly net: number;
+};
+/** 分类聚合卡的一行（＝老页 `categoryBar` 的一个分类；本件只排版、不聚合）。
+ *  `pct`＝该分类支出占本页支出合计的比例（0–100，越界由公共层夹取）。 */
+export type QueryCategoryRow = {
+    readonly label: string;
+    readonly amount: number;
+    readonly count: number;
+    readonly pct: number;
+};
+/** 列表页的出口载荷（＝envelope `data`）：`items`／`total` 是表里形状的要求，其余是本域给页面看的窗口事实。
+ *  `items` 是**搬迁前那一份行**（`./items.js` 的 `toBillItem` 形状：`id`／`amount` 是数，
+ *  下游拿它回查详情），与页面表格行（`QueryTableRow`，文本化）是两件事——一份给机器、一份给人。
+ *  **显示上限只截页面那一份**：`items` 照老侧语义仍是本窗全量（老侧 `slice(0,200)` 也只截显示）。 */
+export type QueryListData = {
+    items: unknown[];
+    total: number;
+    kpi: QueryKpi;
+    /** 单日查（查今天那一族）：这一页查的是哪一天；`recent` 那支写 `'recent'`（与搬迁前同值）。 */
+    date?: string;
+    /** 区间查（查区间那一族）：起止日；单条件那支两支都写空串（与搬迁前同值）。 */
+    start?: string;
+    end?: string;
+    /** 条件查（搜备注那一族）：`search:<词>`／`tag:<标签>`／`debt`／`reimburse`／`installment`（与搬迁前同值）。 */
+    kind?: string;
+};
+/** 详情页的出口载荷（＝envelope `data`）：`item` 是搬迁前那一份（`toBillItem` 的形状）。 */
+export type QueryDetailData = {
+    item: Record<string, unknown>;
+};
+/** 列表页的入参：这一页是谁（命令名／唤醒词／窗口）＋ 查到什么（行与 KPI 与分类聚合）
+ *  ＋ 空态说什么 ＋ 复制日志与来源脚注的取数。 */
+export interface QueryListInput {
+    /** 对外命令名（`bill.record.today`），页标记与复制日志的调用链都读它。 */
+    readonly key: string;
+    /** 本次参数（复制日志那行命令原文照它拼，可照抄重跑）。 */
+    readonly params: Record<string, unknown>;
+    /** 本次 envelope 的形状（`list`／`detail`，页标记 `data-shape` 取它，是契约）。 */
+    readonly shape: string;
+    /** 页标题＝用户说的那条唤醒词（能判出来的那几条按参数判，判不出的按本命令的代表词）。 */
+    readonly wakeWord: string;
+    /** 这一页查的是哪一段（副标题）：日期／区间／条件说明。笔数不在这里——它有自己的胶囊行。 */
+    readonly window: string;
+    /** 结果胶囊（副标题之下、KPI 之上）：如 `共 8 笔`。行内 `·` 不许进版式位（t407 用户语言整改同口径），
+     *  有几个事实就出几枚胶囊，不用一行串拼起来。
+     *  **筛选条件不在这里**：它住副标题（`window`）——那是本域既有口径，t413／t414 逐条钉着
+     *  （「窗口说清条件＋全部时间」「窗口说清关键词」…）；同一件事在页上写两遍是裁定 6 同款毛病，
+     *  故老侧那排 `data.filter` 芯片**不另出**，只把老侧「占比芯片」那一枚（`category_pct`）补进本行。 */
+    readonly chips: readonly string[];
+    /** 数据表的行**全量**（已文本化）。显示上限由本件截（老侧 `slice(0,200)` 同数），
+     *  KPI 与分类聚合按同一份全量算——截的是表，不是读数。 */
+    readonly rows: readonly QueryTableRow[];
+    readonly kpi: QueryKpi;
+    /** 分类聚合卡的行（**全量**：已按支出降序）；空数组＝这一页没有支出，不出这一块。
+     *  显示上限（前 8 类）由本件截，类数与老页 `categoryBar` 的 `slice(0,8)` 同。 */
+    readonly categories: readonly QueryCategoryRow[];
+    /** 零行时那句话。 */
+    readonly emptyText: string;
+    /** 零行时那句引导（说清下一步该说什么词）。 */
+    readonly emptyHint: string;
+    /** 复制载荷：**本次查询的 envelope 本身**（`skill`／`shape`／`key`／`data`），复制区直接序列化它。 */
+    readonly envelope: SerializableEnvelope;
+    /** 本次数据来源（复制日志第 3 段）。 */
+    readonly source: string;
+    /** 来源脚注上屏的人话来源（**不许带脚本路径与库文件名**，裁定 1）。 */
+    readonly sourceText: string;
+    /** 来源脚注的窗口起止（日期或「不限」）。 */
+    readonly windowStart: string;
+    readonly windowEnd: string;
+    /** 本次执行时刻（复制日志第 5 段）。 */
+    readonly actionAt: string;
+}
+/** 通用查询列表页：一整页。块序在本件只写一份（`blocks` 既拼正文也派生导航）。
+ *  **画多少条由体积算，不由死数定**（见 `PAGE_BYTE_BUDGET`）：判的是**真交付的那一串**，
+ *  先试上限，放不下就二分找「放得下的最大条数」。 */
+export declare function queryListDoc(input: QueryListInput): string;
+/** 复制载荷那份 envelope 的取值口径（**唯一定义地**）：技能名／版本由公共标识给、场景名过 `sceneKeyOf`，
+ *  `data` 就是本次命令返回给出口的那一份载荷（同一件事不在页里再拼一遍）。列表与详情各一支——
+ *  形状与载荷必须成对，两支分开就写不出「list 配 detail 载荷」这种错。 */
+export declare function listEnvelope(key: string, data: QueryListData): SerializableEnvelope;
+export declare function detailEnvelope(key: string, data: QueryDetailData): SerializableEnvelope;
+//# sourceMappingURL=list.d.ts.map

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

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