skill-bill 0.2.0 → 0.2.1

package/dist/analysis/scene-top-freq.js

@@ -0,0 +1,91 @@
+import { BillPolicyError } from '../fetch/errors.js';
+import { l1Of } from '../shared/category.js';
+import { aggBy, dayOf, filterOf, kpiOf, round1, round2, windowWithRecords } from './agg.js';
+import { money, textOrDash } from './pageParts.js';
+import { buildTrend } from './views.js';
+/** 取前几名的读数：缺省 10；给了就必须是 1~50 的整数，否则阻断（坏输入不冒充正常）。 */
+function limitOf(params) {
+    const raw = params.limit;
+    if (raw === undefined || raw === null || raw === '')
+        return 10;
+    const n = typeof raw === 'string' && raw.trim() !== '' ? Number(raw.trim()) : raw;
+    if (typeof n !== 'number' || !Number.isInteger(n) || n < 1 || n > 50) {
+        throw new BillPolicyError('POLICY_BAD_INPUT', 'limit 须为 1~50 的整数：' + String(raw));
+    }
+    return n;
+}
+/** 每个一级分类最近一笔的时刻（就在传进来的这一批记录里算；分类名空的不立堆）。 */
+function lastTimesOf(records) {
+    const out = new Map();
+    for (const r of records) {
+        const key = l1Of(r.category);
+        if (key === '')
+            continue;
+        const cur = out.get(key);
+        if (cur === undefined || r.time > cur)
+            out.set(key, r.time);
+    }
+    return out;
+}
+export const sceneTopFreq = {
+    id: 'top_freq',
+    key: 'bill.analysis.trend',
+    kind: 'frequent',
+    title: '看高频',
+    family: 'bars',
+    values: ({ params, db }) => {
+        const limit = limitOf(params);
+        const win = windowWithRecords(params, db, { fallback: 'all-time' });
+        const batch = filterOf(win.records, { direction: 'expense' });
+        const buckets = aggBy(batch, (r) => l1Of(r.category), { direction: 'expense' });
+        const lastAt = lastTimesOf(batch);
+        const items = [...buckets]
+            .sort((a, b) => b.count - a.count || b.value - a.value || a.key.localeCompare(b.key))
+            .slice(0, limit);
+        const peak = items.length === 0 ? 0 : Math.max(...items.map((x) => x.count));
+        const head = items[0];
+        const second = items[1];
+        const chip = 'TOP ' + String(limit) + ' · ' + win.label;
+        return {
+            title: '看高频',
+            label: win.label,
+            from: win.from,
+            to: win.to,
+            count: items.length,
+            conclusion: head === undefined
+                ? win.label + '：没有支出记录。'
+                : '按支出笔数排，最多的是「' + head.key + '」' + String(head.count) + ' 笔（合计 '
+                    + money(head.value) + ' 元）'
+                    + (second === undefined
+                        ? '。'
+                        : '；其次是「' + second.key + '」' + String(second.count) + ' 笔。'),
+            caliber: '按一级分类的支出笔数从多到少取前 ' + String(limit) + ' 名（不是按金额；笔数相同处金额大的先出）；'
+                + '金额、单均、最近一笔都按这一批支出记录算；转账与收入都不上这一页。',
+            chips: [chip],
+            payload: buildTrend('freq', [...win.records], { limit }),
+            kpi: kpiOf(win.records),
+            page: {
+                kpis: [],
+                chips: [chip],
+                charts: [],
+                barGroups: [{
+                        title: '高频消费排行（' + String(items.length) + ' 类）',
+                        rows: items.map((x, i) => ({
+                            label: String(i + 1) + '. ' + x.key,
+                            text: String(x.count) + ' 笔 · ' + money(x.value) + ' 元 · 单均 ' + money(round2(x.value / x.count))
+                                + ' · 最近 ' + textOrDash(dayOf(lastAt.get(x.key) ?? '')),
+                            pct: peak === 0 ? 0 : round1((x.count / peak) * 100),
+                        })),
+                        emptyText: '这段时间还没有支出记录',
+                    }],
+                listCards: [],
+                factCards: [],
+                empty: {
+                    text: win.label + ' 还没有支出记录。',
+                    hint: '先说「记支出」记一笔，回来看这里就有数了。',
+                },
+            },
+        };
+    },
+};
+//# sourceMappingURL=scene-top-freq.js.map

package/dist/analysis/scene-top-freq.js.map

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

package/dist/analysis/scene-top.d.ts

@@ -0,0 +1,3 @@
+import type { AnalysisScene } from './scene.js';
+export declare const sceneTop: AnalysisScene;
+//# sourceMappingURL=scene-top.d.ts.map

package/dist/analysis/scene-top.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-top.d.ts","sourceRoot":"","sources":["../../src/analysis/scene-top.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAehD,eAAO,MAAM,QAAQ,EAAE,aAoDtB,CAAC"}

package/dist/analysis/scene-top.js

@@ -0,0 +1,69 @@
+import { BillPolicyError } from '../fetch/errors.js';
+import { dayOf, expenseTop, kpiOf, round1, windowWithRecords } from './agg.js';
+import { money, textOrDash } from './pageParts.js';
+import { buildTrend } from './views.js';
+/** 取前几笔的读数：缺省 10；给了就必须是 1~50 的整数，否则阻断（坏输入不冒充正常）。 */
+function limitOf(params) {
+    const raw = params.limit;
+    if (raw === undefined || raw === null || raw === '')
+        return 10;
+    const n = typeof raw === 'string' && raw.trim() !== '' ? Number(raw.trim()) : raw;
+    if (typeof n !== 'number' || !Number.isInteger(n) || n < 1 || n > 50) {
+        throw new BillPolicyError('POLICY_BAD_INPUT', 'limit 须为 1~50 的整数：' + String(raw));
+    }
+    return n;
+}
+export const sceneTop = {
+    id: 'top',
+    key: 'bill.analysis.trend',
+    kind: 'top',
+    title: '看大额',
+    family: 'bars',
+    values: ({ params, db }) => {
+        const limit = limitOf(params);
+        const win = windowWithRecords(params, db, { fallback: 'all-time' });
+        const items = expenseTop(win.records, limit);
+        const peak = items.length === 0 ? 0 : Math.max(...items.map((r) => Math.abs(r.amount)));
+        const sum = items.reduce((total, r) => total + Math.abs(r.amount), 0);
+        const head = items[0];
+        const chip = 'TOP ' + String(limit) + ' · ' + win.label;
+        return {
+            title: '看大额',
+            label: win.label,
+            from: win.from,
+            to: win.to,
+            count: items.length,
+            conclusion: head === undefined
+                ? win.label + '：没有支出记录。'
+                : '支出最大的 ' + String(items.length) + ' 笔合计 ' + money(sum) + ' 元；最贵的一笔是 '
+                    + textOrDash(dayOf(head.time)) + ' 的「' + textOrDash(head.category) + '」'
+                    + money(Math.abs(head.amount)) + ' 元。',
+            caliber: '支出金额从大到小取前 ' + String(limit) + ' 笔，同额先出时间晚的；条长按最大一笔折算；'
+                + '转账与收入都不上这一页。',
+            chips: [chip],
+            payload: buildTrend('top', [...win.records], { limit }),
+            kpi: kpiOf(win.records),
+            page: {
+                kpis: [],
+                chips: [chip],
+                charts: [],
+                barGroups: [{
+                        title: '大额支出排行（' + String(items.length) + ' 笔）',
+                        rows: items.map((r, i) => ({
+                            label: String(i + 1) + '. ' + textOrDash(r.category),
+                            text: money(Math.abs(r.amount)) + ' 元 · ' + textOrDash(dayOf(r.time)) + ' · ' + textOrDash(r.note),
+                            pct: peak === 0 ? 0 : round1((Math.abs(r.amount) / peak) * 100),
+                        })),
+                        emptyText: '这段时间还没有支出记录',
+                    }],
+                listCards: [],
+                factCards: [],
+                empty: {
+                    text: win.label + ' 还没有支出记录。',
+                    hint: '先说「记支出」记一笔，回来看这里就有数了。',
+                },
+            },
+        };
+    },
+};
+//# sourceMappingURL=scene-top.js.map

package/dist/analysis/scene-top.js.map

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

package/dist/analysis/scene-trend.d.ts

@@ -0,0 +1,3 @@
+import type { AnalysisScene } from './scene.js';
+export declare const sceneTrend: AnalysisScene;
+//# sourceMappingURL=scene-trend.d.ts.map

package/dist/analysis/scene-trend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-trend.d.ts","sourceRoot":"","sources":["../../src/analysis/scene-trend.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,YAAY,CAAC;AAoD3D,eAAO,MAAM,UAAU,EAAE,aAoFxB,CAAC"}

package/dist/analysis/scene-trend.js

@@ -0,0 +1,131 @@
+import { BillPolicyError } from '../fetch/errors.js';
+import { monthRange } from '../shared/dateRange.js';
+import { allRecords, kpiOf, monthOf, monthSeries, round2 } from './agg.js';
+import { MISSING, NO_WINDOW, money, windowLabel } from './pageParts.js';
+import { buildTrend } from './views.js';
+/** 正整数型参数（缺＝缺省值）。老侧 `args.months or 12` 的严格版：形态不对即报参数错，不悄悄退回缺省。 */
+function monthsOf(params, fallback) {
+    const raw = params['months'];
+    if (raw === undefined || raw === null || raw === '')
+        return fallback;
+    const n = typeof raw === 'number' ? raw : Number(String(raw));
+    if (!Number.isFinite(n) || n < 1)
+        throw new BillPolicyError('POLICY_BAD_INPUT', '窗口月数须是正整数');
+    return Math.floor(n);
+}
+/** 窗口内的记录（序列覆盖的那些月；含转账，收支口径由 `kpiOf` 剔）。 */
+function windowRowsOf(rows, series) {
+    const keep = new Set(series.map((p) => p.month));
+    return rows.filter((r) => keep.has(monthOf(r.time)));
+}
+/** 序列里**没有记录**的月份（`count === 0` 即那个月一条记录都没有）。 */
+function gapsOf(series) {
+    return series.filter((p) => p.count === 0).map((p) => p.month);
+}
+/** 折线点：没有记录的月 `value: null`——公共层据此不出点，并按 `gapStyle: 'dashed'` 出同色虚线桥接。 */
+function lineItemsOf(series, pick) {
+    return series.map((p) => ({ label: p.month.slice(2), value: p.count === 0 ? null : pick(p) }));
+}
+/** 折线图卡的数据：两条系列（支出／收入）＋ 纵轴刻度 ＋ 同色虚线跨空档；可用点少于 2 个改出说明句。 */
+function lineInputOf(series, usable, emptyText) {
+    if (usable < 2)
+        return { items: [], options: { emptyText } };
+    const expense = lineItemsOf(series, (p) => p.expense);
+    const income = lineItemsOf(series, (p) => p.income);
+    return {
+        items: expense,
+        options: {
+            series: [{ name: '支出', items: expense }, { name: '收入', items: income }],
+            yTicks: 4,
+            /* 纵轴下界恒 0：金额没有负数，公共层派生的那 6% 下外扩会印出「-732.26 元」这种读不出意思的刻度。 */
+            yMin: 0,
+            legend: true,
+            tooltip: true,
+            labels: 'select',
+            gapStyle: 'dashed',
+            format: money,
+        },
+    };
+}
+export const sceneTrend = {
+    id: 'trend',
+    key: 'bill.analysis.trend',
+    kind: 'trend',
+    title: '看趋势',
+    family: 'charts',
+    values: ({ params, db }) => {
+        /* ① 取数：窗口＝近 N 个月，序列终点＝库里最新一条记录所在的月（不取今天的月）。 */
+        const months = monthsOf(params, 12);
+        const all = allRecords(db);
+        const series = monthSeries(all, months);
+        const rows = windowRowsOf(all, series);
+        const kpi = kpiOf(rows);
+        const gaps = gapsOf(series);
+        const recorded = series.filter((p) => p.count > 0);
+        /* ② 峰值与月均（老侧同式：峰值月取第一个达到峰值的月）。 */
+        const totalExpense = series.reduce((sum, p) => sum + p.expense, 0);
+        const peak = series.reduce((max, p) => (p.expense > max ? p.expense : max), 0);
+        const avg = series.length === 0 ? 0 : round2(totalExpense / series.length);
+        const head = series.find((p) => p.count > 0 && p.expense === peak);
+        const peakMonth = peak > 0 && head !== undefined ? head.month : MISSING;
+        /* ③ 期间标签与来源脚注的窗口起止（月份窗口写成首月起～末月末）。 */
+        const firstMonth = series.length === 0 ? '' : series[0].month;
+        const lastMonth = series.length === 0 ? '' : series[series.length - 1].month;
+        /* ④ 结论句与口径句：口径句点名没有记录的月（裁定 3 第 4 条），点数不足时也在这里说清。 */
+        const conclusion = kpi.count === 0
+            ? '这 ' + String(series.length) + ' 个月还没有记录。'
+            : '这 ' + String(series.length) + ' 个月一共记了 ' + String(kpi.count) + ' 笔：支出 ' + money(kpi.expense)
+                + ' 元、收入 ' + money(kpi.income) + ' 元，平均每月支出 ' + money(avg) + ' 元'
+                + (peak > 0 ? '，最高的是 ' + peakMonth + '（' + money(peak) + ' 元）。' : '；窗口里一笔支出都没有。');
+        const caliber = [
+            '窗口取近 ' + String(months) + ' 个月，终点是库里最新一条记录所在的月（不是今天）',
+            gaps.length === 0
+                ? '这 ' + String(series.length) + ' 个月每个月都有记录'
+                : gaps.join('、') + ' 这 ' + String(gaps.length) + ' 个月没有记录，折线在那里断开、用同色虚线桥接',
+            recorded.length < 2 ? '有记录的月不到 2 个，不画半截线、图卡改出说明句' : '',
+            '支出与收入各一条线，纵轴刻度标在图上',
+            '转账不计入收支',
+        ].filter((s) => s !== '').join('；') + '。';
+        return {
+            title: '看趋势',
+            label: windowLabel(firstMonth, lastMonth),
+            from: firstMonth === '' ? NO_WINDOW : monthRange(firstMonth).start,
+            to: lastMonth === '' ? NO_WINDOW : monthRange(lastMonth).end,
+            count: rows.length,
+            conclusion,
+            caliber,
+            chips: [],
+            payload: buildTrend('trend', [...all], { limit: 12 }),
+            kpi,
+            page: {
+                kpis: [
+                    { label: '峰值月', value: peakMonth },
+                    { label: '峰值支出', value: money(peak), unit: '元' },
+                    { label: '月均支出', value: money(avg), unit: '元' },
+                    { label: '窗口月数', value: String(months), unit: '个月' },
+                ],
+                chips: [],
+                charts: [{
+                        title: '逐月收支走势',
+                        kind: 'line',
+                        input: lineInputOf(series, recorded.length, '有记录的月不到 2 个，画不出折线；下面那张明细按月列了每一笔。'),
+                    }],
+                listCards: [{
+                        title: '逐月明细',
+                        rows: recorded.map((p) => ({
+                            left: p.month,
+                            main: String(p.count) + ' 笔',
+                            right: '支出 ' + money(p.expense) + ' ／ 收入 ' + money(p.income),
+                        })),
+                        emptyText: '这 ' + String(months) + ' 个月一笔都没有记',
+                    }],
+                factCards: [],
+                empty: {
+                    text: '这 ' + String(months) + ' 个月还没有记录。',
+                    hint: '先说「记支出」或「记收入」记一笔，回来看这里就有数了。',
+                },
+            },
+        };
+    },
+};
+//# sourceMappingURL=scene-trend.js.map

package/dist/analysis/scene-trend.js.map

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

package/dist/analysis/scene-week.d.ts

@@ -0,0 +1,3 @@
+import type { AnalysisScene } from './scene.js';
+export declare const sceneWeek: AnalysisScene;
+//# sourceMappingURL=scene-week.d.ts.map

package/dist/analysis/scene-week.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-week.d.ts","sourceRoot":"","sources":["../../src/analysis/scene-week.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA8BhD,eAAO,MAAM,SAAS,EAAE,aAiFvB,CAAC"}

package/dist/analysis/scene-week.js

@@ -0,0 +1,128 @@
+/** 场景件：**看周报**（`kind = 'week'`，命令 `bill.analysis.overview`）——本件只是差异声明与取值，
+ *  块位序列住 `./template-bars.ts`（族＝读数＋条）。
+ *
+ * 老侧对应件：`scripts/analysis/cli.py` 的 `cmd_week`（`:240-267`）
+ *  ＋ 模板 `templates/分析/analysis_view.html` 的 `renderWeek`（`:347-378`）。
+ *
+ * 本件的差异（照老侧那一页逐点对）：
+ *   ① 期间＝参数 `offset` 定的那一周（0＝本周、1＝上周，缺即本周；非「零或正整数」即如实抛）；
+ *      本周＝`weekRange()`（周一起算）给的起点起 7 天，上一周＝起点再往前 7 天的那一段；
+ *   ② 上周的记录**另取一次**（`windowRecords`），与本周各算各的读数（老侧 `_fetch` 两次同义）；
+ *   ③ 老侧那枚**变更徽标**（`↑ 533.00 元 (1025.0%) · 支出上涨`）本族没有槽位，
+ *      信息**并进结论句**（箭头、金额、百分比、涨跌三个字都在那一句里），事实卡「本周 vs 上周」出八行读数；
+ *   ④ 大额支出只出本周前 5 笔（`expenseTop`），条长按本页最大一笔折算，标签带序号；
+ *   ⑤ 载荷照搬迁前那一支（`./views.js` 的 `buildOverview`），一字不改。
+ */
+import { listRange } from '../fetch/index.js';
+import { weekRange } from '../shared/dateRange.js';
+import { compareTwo, dayOf, expenseTop, kpiOf, round1, windowRecords } from './agg.js';
+import { money, pctText, textOrDash } from './pageParts.js';
+import { BillPolicyError } from '../fetch/errors.js';
+import { buildOverview } from './views.js';
+/** 日期串左移／右移整周（`YYYY-MM-DD`，UTC 口径——周一是几号与本地时区无关）。 */
+function shiftDays(date, days) {
+    const ms = Date.parse(date + 'T00:00:00Z');
+    if (!Number.isFinite(ms))
+        throw new BillPolicyError('POLICY_BAD_INPUT', '日期串认不得：' + date);
+    return new Date(ms + days * 86400000).toISOString().slice(0, 10);
+}
+/** `YYYY-MM-DD` → `MM/DD`（周区间标签用）。 */
+function mmdd(date) { return date.slice(5).replace('-', '/'); }
+/** 一段周区间的标签：`MM/DD~MM/DD 周`（与老侧 `_compare_two` 那两个期间标签同形）。 */
+function weekKey(start, end) { return mmdd(start) + '~' + mmdd(end) + ' 周'; }
+/** 周区间起点：本周起点就是本周一的日期，最准确也最省事。 */
+function anchorStart() { return weekRange().start; }
+/** `offset` 槽：缺＝0（本周）；只认零或正整数，认不得即如实抛。 */
+function readOffset(params) {
+    const raw = params.offset;
+    if (raw === undefined || raw === null || raw === '')
+        return 0;
+    const n = typeof raw === 'number' ? raw : Number(String(raw).trim());
+    if (!Number.isFinite(n) || Math.floor(n) !== n || n < 0) {
+        throw new BillPolicyError('POLICY_BAD_INPUT', 'offset 得是零或正整数：' + JSON.stringify(raw));
+    }
+    return n;
+}
+export const sceneWeek = {
+    id: 'week',
+    key: 'bill.analysis.overview',
+    kind: 'week',
+    title: '看周报',
+    family: 'bars',
+    values: ({ params, db }) => {
+        const offset = readOffset(params);
+        const start = shiftDays(anchorStart(), -7 * offset);
+        const end = shiftDays(start, 6);
+        const lastStart = shiftDays(start, -7);
+        const lastEnd = shiftDays(start, -1);
+        const records = listRange(db, start, end);
+        const lastRecords = windowRecords(db, lastStart, lastEnd);
+        const kpi = kpiOf(records);
+        const label = weekKey(start, end);
+        const lastLabel = weekKey(lastStart, lastEnd);
+        const pair = compareTwo(records, lastRecords, label, lastLabel);
+        const diff = pair.change.diff;
+        const pct = pair.change.pct;
+        const arrow = diff > 0 ? '↑' : diff < 0 ? '↓' : '→';
+        const word = diff > 0 ? '上涨' : diff < 0 ? '下降' : '持平';
+        const top = expenseTop(records, 5);
+        const maxTop = top.length === 0 ? 0 : Math.max(...top.map((r) => Math.abs(r.amount)));
+        const sameCount = kpi.count === lastRecords.length;
+        const changeClause = sameCount && diff === 0
+            ? '支出与上周一样多。'
+            : '支出比上周 ' + arrow + ' ' + money(Math.abs(diff)) + ' 元（' + pctText(Math.abs(pct)) + '），' + word + '。';
+        return {
+            title: '看周报',
+            label,
+            from: start,
+            to: end,
+            count: records.length,
+            conclusion: kpi.count === 0
+                ? label + ' 一笔都没有记；上一周 ' + lastLabel + ' 记了 ' + String(lastRecords.length) + ' 笔。'
+                : label + ' 一共记了 ' + String(kpi.count) + ' 笔：支出 ' + money(kpi.expense) + ' 元、收入 '
+                    + money(kpi.income) + ' 元、净额 ' + money(kpi.net) + ' 元；' + changeClause,
+            caliber: '本周从周一起算七天；条长按本周最大一笔支出折算，只出前 5 笔；转账不计入收支。',
+            chips: [label],
+            payload: buildOverview(label, [...records]),
+            kpi,
+            page: {
+                kpis: [
+                    { label: '本周支出', value: money(kpi.expense), unit: '元' },
+                    { label: '本周收入', value: money(kpi.income), unit: '元' },
+                    { label: '净额', value: money(kpi.net), unit: '元', detail: kpi.net >= 0 ? '收大于支' : '支大于收' },
+                    { label: '笔数', value: String(kpi.count), unit: '笔' },
+                ],
+                chips: [],
+                charts: [],
+                barGroups: [{
+                        title: '本周大额支出 TOP ' + String(top.length),
+                        rows: top.map((r, i) => ({
+                            label: String(i + 1) + '. ' + r.category,
+                            text: money(Math.abs(r.amount)) + ' 元 · ' + dayOf(r.time) + ' · ' + textOrDash(r.note),
+                            pct: maxTop === 0 ? 0 : round1((Math.abs(r.amount) / maxTop) * 100),
+                        })),
+                        emptyText: '本周还没有支出记录',
+                    }],
+                listCards: [],
+                factCards: [{
+                        title: '本周 vs 上周',
+                        rows: [
+                            { k: '本周笔数', v: String(kpi.count) + ' 笔' },
+                            { k: '本周支出', v: money(kpi.expense) + ' 元' },
+                            { k: '本周收入', v: money(kpi.income) + ' 元' },
+                            { k: '本周净额', v: money(kpi.net) + ' 元' },
+                            { k: '上周笔数', v: String(lastRecords.length) + ' 笔' },
+                            { k: '上周支出', v: money(pair.b.expense) + ' 元' },
+                            { k: '上周收入', v: money(pair.b.income) + ' 元' },
+                            { k: '上周净额', v: money(pair.b.net) + ' 元' },
+                        ],
+                    }],
+                empty: {
+                    text: label + ' 这一周还没有记录。',
+                    hint: '先说「记支出」或「记收入」记一笔，回来看这里就有数了。',
+                },
+            },
+        };
+    },
+};
+//# sourceMappingURL=scene-week.js.map

package/dist/analysis/scene-week.js.map

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

package/dist/analysis/scene-yearly.d.ts

@@ -0,0 +1,3 @@
+import type { AnalysisScene } from './scene.js';
+export declare const sceneYearly: AnalysisScene;
+//# sourceMappingURL=scene-yearly.d.ts.map

package/dist/analysis/scene-yearly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-yearly.d.ts","sourceRoot":"","sources":["../../src/analysis/scene-yearly.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAchD,eAAO,MAAM,WAAW,EAAE,aAqEzB,CAAC"}

package/dist/analysis/scene-yearly.js

@@ -0,0 +1,103 @@
+/** 场景件：**看年度**（`kind = 'yearly'`，命令 `bill.analysis.overview`）——本件只是差异声明与取值，
+ *  块位序列住 `./template-bars.ts`（族＝读数＋条）。
+ *
+ * 老侧对应件：`scripts/analysis/cli.py` 的 `cmd_yearly`（`:194-210`）
+ *  ＋ 模板 `templates/分析/analysis_view.html` 的 `renderYearly`（`:306-327`）。
+ *
+ * 本件的差异（照老侧那一页逐点对）：
+ *   ① 期间＝参数给的年份（缺 `year` 即今年，老侧 `args.year or date.today().year` 同条口径；
+ *      数字与数字串都认——参数走命令行 JSON，`"2026"` 与 `2026` 都到得了这里）；
+ *   ② 逐月趋势取 `monthSeries(rows, 12)`：**序列终点＝库里最新一条记录所在的月**（老侧 `_month_series`
+ *      就这口径，本件不改成从今天起算），12 条不论有没有记录都出一条（空月读数是 0 笔）；
+ *   ③ 大额分类**按一级分类归堆**（老侧 `_agg_expense_by(..., lambda r: _l1(r.category), top_n=8)`），
+ *      只出前 8 类；条长按**本页最大一类**折算（老侧 `Math.max(...cats…)` 的分母是截过前 8 名的那一份）；
+ *   ④ 逐月条卡与分类条卡的空态句各出一句（老侧两张卡各自的 `emptyState({text})`）；
+ *   ⑤ 载荷照搬迁前那一支（`./views.js` 的 `buildOverview`），一字不改。
+ */
+import { listRange } from '../fetch/index.js';
+import { BillPolicyError } from '../fetch/errors.js';
+import { aggByL1, kpiOf, monthSeries, round1, yearRange } from './agg.js';
+import { money, pctText } from './pageParts.js';
+import { buildOverview } from './views.js';
+/** 年份槽：缺＝今年；数字与数字串都认，认不得即如实抛。 */
+function readYear(params) {
+    const raw = params.year;
+    if (raw === undefined || raw === null || raw === '')
+        return new Date().getFullYear();
+    const n = typeof raw === 'number' ? raw : Number(String(raw).trim());
+    if (!Number.isFinite(n) || Math.floor(n) !== n || n < 1000 || n > 9999) {
+        throw new BillPolicyError('POLICY_BAD_INPUT', 'year 得是四位年份：' + JSON.stringify(raw));
+    }
+    return n;
+}
+export const sceneYearly = {
+    id: 'yearly',
+    key: 'bill.analysis.overview',
+    kind: 'yearly',
+    title: '看年度',
+    family: 'bars',
+    values: ({ params, db }) => {
+        const year = readYear(params);
+        const { start, end } = yearRange(year);
+        const records = listRange(db, start, end);
+        const kpi = kpiOf(records);
+        const monthly = monthSeries(records, 12);
+        const cats = aggByL1(records, { topN: 8 });
+        const maxMonth = monthly.length === 0 ? 0 : Math.max(...monthly.map((m) => m.expense));
+        const maxCat = cats.length === 0 ? 0 : Math.max(...cats.map((c) => c.value));
+        const label = String(year);
+        return {
+            title: '看年度',
+            label,
+            from: start,
+            to: end,
+            count: records.length,
+            conclusion: kpi.count === 0
+                ? label + ' 这一年一笔都没有记。'
+                : label + ' 年一共记了 ' + String(kpi.count) + ' 笔：支出 ' + money(kpi.expense) + ' 元、收入 '
+                    + money(kpi.income) + ' 元、净额 ' + money(kpi.net) + ' 元。',
+            caliber: '逐月趋势的条长按全年支出最多的那个月折算，没有记录的月照实出 0 笔；大额分类只出前 8 名，'
+                + '按一级分类归堆、占比按全年支出合计算；转账不计入收支。',
+            chips: [label + ' 年'],
+            payload: buildOverview(label, [...records]),
+            kpi,
+            page: {
+                kpis: [
+                    { label: '全年支出', value: money(kpi.expense), unit: '元' },
+                    { label: '全年收入', value: money(kpi.income), unit: '元' },
+                    { label: '净额', value: money(kpi.net), unit: '元', detail: kpi.net >= 0 ? '收大于支' : '支大于收' },
+                    { label: '笔数', value: String(kpi.count), unit: '笔' },
+                ],
+                chips: [],
+                charts: [],
+                barGroups: [
+                    {
+                        title: '逐月趋势（' + String(monthly.length) + ' 个月）',
+                        rows: monthly.map((m) => ({
+                            label: m.month,
+                            text: money(m.expense) + ' 元 · ' + String(m.count) + ' 笔',
+                            pct: maxMonth === 0 ? 0 : round1((m.expense / maxMonth) * 100),
+                        })),
+                        emptyText: '这一年还没有可对比的月度数据',
+                    },
+                    {
+                        title: '大额分类 TOP',
+                        rows: cats.map((c) => ({
+                            label: c.key,
+                            text: money(c.value) + ' 元 · ' + pctText(c.pct) + ' · ' + String(c.count) + ' 笔',
+                            pct: maxCat === 0 ? 0 : round1((c.value / maxCat) * 100),
+                        })),
+                        emptyText: '这一年还没有支出记录',
+                    },
+                ],
+                listCards: [],
+                factCards: [],
+                empty: {
+                    text: label + ' 年这段时间还没有记录。',
+                    hint: '先说「记支出」或「记收入」记一笔，回来看这里就有数了。',
+                },
+            },
+        };
+    },
+};
+//# sourceMappingURL=scene-yearly.js.map

package/dist/analysis/scene-yearly.js.map

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

package/dist/analysis/scene-yoy.d.ts

@@ -0,0 +1,3 @@
+import type { AnalysisScene } from './scene.js';
+export declare const sceneYoy: AnalysisScene;
+//# sourceMappingURL=scene-yoy.d.ts.map

package/dist/analysis/scene-yoy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-yoy.d.ts","sourceRoot":"","sources":["../../src/analysis/scene-yoy.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAiBhD,eAAO,MAAM,QAAQ,EAAE,aA2DtB,CAAC"}