skill-bill 0.1.0 → 0.2.1

package/dist/analysis/scene-yoy.js

@@ -0,0 +1,95 @@
+/** 场景件：**看同比**（`kind = 'yoy'`，命令 `bill.analysis.compare`）——本件只是差异声明与取值，
+ *  块位序列住 `./template-compare.ts`（族＝对比＋变更）。
+ *
+ *  老侧对应件：`scripts/analysis/cli.py` 的 `cmd_yoy`（`:465-482`）＋ 模板
+ *  `templates/分析/analysis_view.html` 的 `renderYoy`（`:583-599`）。
+ *
+ *  本件的差异（照老侧那一页逐点对）：
+ *   ① 月份缺省＝**当刻所在月**（老侧 `args.month or date.today().strftime("%Y-%m")` 同义）；
+ *   ② 去年同月＝**年份减一、月份不动**（老侧 `f"{y - 1}-{month[5:]}"`）——不是「上一月」
+ *      （`./agg.js` 的 `prevMonth` 只退一个月，本件不用它算去年同月，只用它算「本月 vs 上月」
+ *      那条不在本件里）；
+ *   ③ 变更句把方向说成 `同比上涨／下降／持平`（老侧 `renderYoy` 那句 `· 同比…`），
+ *      差 > 0.01 记上涨、< −0.01 记下降、否则持平；百分比以去年同月为分母、为 0 时记 0。
+ */
+import { BillPolicyError } from '../fetch/errors.js';
+import { listRange } from '../fetch/index.js';
+import { monthRange } from '../shared/dateRange.js';
+import { compareTwo, kpiOf, thisMonth } from './agg.js';
+import { sideKpisOf } from './cards.js';
+import { money, pctText } from './pageParts.js';
+import { needMonth } from './params.js';
+import { buildCompare } from './views.js';
+/** 参数槽位的空写法（缺省、空串、非字符串一律当「没给」——老侧 `args.month or ...` 同义）。 */
+function slotText(v) {
+    return typeof v === 'string' ? v.trim() : '';
+}
+/** 去年同月：年份减一、月份逐字不动（老侧 `cmd_yoy` 那两行）。 */
+function lastYearMonth(month) {
+    const year = Number(month.slice(0, 4));
+    if (!Number.isFinite(year) || year < 2000) {
+        throw new BillPolicyError('POLICY_BAD_INPUT', '月份年份异常：' + month);
+    }
+    return String(year - 1) + '-' + month.slice(5);
+}
+export const sceneYoy = {
+    id: 'yoy',
+    key: 'bill.analysis.compare',
+    kind: 'yoy',
+    title: '看同比',
+    family: 'compare',
+    values: ({ params, db }) => {
+        const month = slotText(params.month) === '' ? thisMonth() : needMonth(params);
+        const last = lastYearMonth(month);
+        const thisRange = monthRange(month);
+        const lastRange = monthRange(last);
+        const ra = listRange(db, thisRange.start, thisRange.end);
+        const rb = listRange(db, lastRange.start, lastRange.end);
+        const labelA = month + ' 今年';
+        const labelB = last + ' 去年';
+        const cmp = compareTwo(ra, rb, labelA, labelB);
+        const diff = cmp.change.diff;
+        const direction = diff > 0.01 ? 'up' : diff < -0.01 ? 'down' : 'flat';
+        const arrow = direction === 'up' ? '↑' : direction === 'down' ? '↓' : '→';
+        const word = direction === 'up' ? '同比上涨' : direction === 'down' ? '同比下降' : '同比持平';
+        const pct = direction === 'up'
+            ? '+' + pctText(Math.abs(cmp.change.pct))
+            : direction === 'down' ? '-' + pctText(Math.abs(cmp.change.pct)) : pctText(0);
+        const total = ra.length + rb.length;
+        return {
+            title: '看同比',
+            label: labelA + ' 与 ' + labelB,
+            from: lastRange.start,
+            to: thisRange.end,
+            count: total,
+            conclusion: total === 0
+                ? month + ' 与去年同月 ' + last + ' 两段都还没有记录。'
+                : month + ' 支出 ' + money(cmp.a.expense) + ' 元，去年同月 ' + last + ' 支出 ' + money(cmp.b.expense)
+                    + ' 元：' + word + ' ' + money(Math.abs(diff)) + ' 元（' + pct + '）。',
+            caliber: '两段各取自己那一整月，支出按绝对值累计；百分比以去年同月为分母，去年同月支出为 0 时记 0；转账不计入收支。',
+            chips: [labelA, labelB],
+            payload: buildCompare({ labelA, labelB, a: [...ra], b: [...rb] }),
+            kpi: kpiOf([...ra, ...rb]),
+            page: {
+                kpis: [],
+                chips: [],
+                sides: [
+                    { title: labelA, kpis: sideKpisOf(labelA, cmp.a, money) },
+                    { title: labelB, kpis: sideKpisOf(labelB, cmp.b, money) },
+                ],
+                change: {
+                    text: '支出 ' + arrow + ' ' + money(Math.abs(diff)) + ' 元（' + pct + '）· ' + word,
+                    detail: '今年这一侧支出 ' + money(cmp.a.expense) + ' 元，去年同月支出 ' + money(cmp.b.expense) + ' 元；两段各取自己那一整月。',
+                    direction,
+                },
+                barGroups: [],
+                factCards: [],
+                empty: {
+                    text: month + ' 与去年同月 ' + last + ' 都没有记录。',
+                    hint: '先说「记支出」或「记收入」记一笔，回来看这里就有数了。',
+                },
+            },
+        };
+    },
+};
+//# sourceMappingURL=scene-yoy.js.map

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

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

package/dist/analysis/scene.d.ts

@@ -0,0 +1,240 @@
+/** 分析域·**场景契约与落点表**（唯一定义地）。
+ *
+ * 本件回答三件事：
+ *   ① 一件场景件长什么样——`AnalysisScene`（一条唤醒词的落点：id／命令名／老侧 `type`／标题／形态族／取值函数）；
+ *   ② 五个**形态族**各吃什么（`BarsPage`／`ChartsPage`／`TablesPage`／`ComparePage`／`InsightPage`）；
+ *   ③ 一条唤醒词该落哪一件——`ANALYSIS_SCENES` 那张 **25 行落点表** ＋ `sceneFor`。
+ *
+ * **形态族＝页型（第二层）**：分片数由 `packages/skill-bill/docs/t685-按域页型表.md` §2.3 定死
+ * （25 个渲染器逐条归并成 5 族：读数＋条 13／读数＋图 4／读数＋表 3／对比＋变更 4／解读＋多卡 1），
+ * 判据是「内容卡的种类」——即**卡内装配代码**的变化频率，不是卡出几张。
+ *
+ * **块位序列住各族的模板件**（`./template-*.ts`）：本件只声明「这一族吃哪几个槽」，
+ * 槽的出现与否是数据（老侧渲染器本身就有的 ●恒出／○有内容才出），**槽的顺序一律由模板件定**。
+ * 场景件因此只写差异值：取值（走 `./agg.js` 与 `../shared/`）、文案、槽里放什么。
+ *
+ * **老侧对应件**：`scripts/analysis/cli.py`（25 个 `cmd_*` 取数）＋ `templates/分析/analysis_view.html`
+ * （25 个页面级渲染器）。逐族的行号对照见 t685 §2.3 那张表。
+ *
+ * 谁在用（两个调用点，指名）：
+ *   ① `src/analysis/read.ts`——三条读命令的处理体：解析 kind → `sceneFor` 取件 → 取件出页；
+ *   ② `src/analysis/index.ts`——域门把 `ANALYSIS_SCENES` 转出给测试（域内别处不读它）。
+ */
+import type { ChartBlockChartInput, ChartBlockInput, DataTableColumn, DataTableRow, KpiCardInput } from 'base-paint/blocks';
+import type { SerializableEnvelope } from 'base-paint';
+import type { BillDb } from '../fetch/db.js';
+import type { Kpi } from './agg.js';
+/** 本域三条命令名（跨技能契约，冻结不动）。 */
+export type AnalysisKey = 'bill.analysis.overview' | 'bill.analysis.compare' | 'bill.analysis.trend';
+/** 形态族（＝页型第二层；数字与族名照 t685 §2.3 的归并结果）。 */
+export type Family = 'bars' | 'charts' | 'tables' | 'compare' | 'insight';
+/** 一条**条卡里的条**（老侧 `.cat-bar`）：名字 ＋ 数值栏那句话 ＋ 条长比例。
+ *  版式改（#681 偏好 3「信息等价、版式可全新设计」）：老侧条下那行小字（如「最近一笔 …」）
+ *  并进 `text` 那一栏，不再单出一行——事实一个不少，只是换了摆法。 */
+export interface BarRow {
+    readonly label: string;
+    /** 数值栏那句话（如 `312.50 元 · 9 笔 · 28.4%`）；**成句在这里，模板只摆位**。 */
+    readonly text: string;
+    /** 条长：0–100 的有限数（公共层 `renderDistributionRows` 夹取越界值）。 */
+    readonly pct: number;
+}
+/** 一组条卡（老侧一张 `.card` ＋ 里头若干 `.cat-bar`）：标题 ＋ 若干条 ＋ 这一组的空态句。
+ *  标题里的计数（老侧标题右那枚「13 类」）由场景**并进标题文本**——版式件不给第二枚槽位。 */
+export interface BarGroup {
+    readonly title: string;
+    readonly rows: readonly BarRow[];
+    /** 这一组没有内容时出的空态句（老侧 `emptyState({text})`）。 */
+    readonly emptyText: string;
+}
+/** 一行列表卡（老侧 `.records` 里的 `.record`）：`左 ｜ 主文 ｜ 右` 三栏，与公共层 `renderListRows` 同形同数。
+ *  老侧那条「备注第二行」并进 `main`（换行在公共层是转义文本，不另占一栏）。 */
+export interface ListRow {
+    readonly left: string;
+    readonly main: string;
+    readonly right: string;
+    /** 完成态（公共层出删除线＋成功色）：本域只用在「已还清」那类行上。 */
+    readonly done?: boolean;
+}
+/** 一张列表卡：标题 ＋ 行 ＋ 空态句。 */
+export interface ListCard {
+    readonly title: string;
+    readonly rows: readonly ListRow[];
+    readonly emptyText: string;
+}
+/** 一张键值行卡（老侧 `.fact-row` 那一列 `k ／ v`）。 */
+export interface FactCard {
+    /** 卡标题；空串＝不出标题（老侧「区间标注」那张有标题）。 */
+    readonly title: string;
+    readonly rows: readonly {
+        readonly k: string;
+        readonly v: string;
+    }[];
+}
+/** 一张图卡：图 kind ＋ 图数据 ＋ 卡标题。**图一律走公共层**（`renderChartBlock`，零 SVG 副本）。
+ *  `kind` 的类型取自公共层 `ChartBlockInput` 的字段（不另抄一份 kind 字面量：闭集事实只住公共层）。 */
+export interface ChartCard {
+    readonly title: string;
+    readonly kind: ChartBlockInput['kind'];
+    readonly input: ChartBlockChartInput;
+}
+/** 一张小表卡（老侧 `.records` 之外的表格形；走公共层 `renderDataTable`）。 */
+export interface TableCard {
+    readonly title: string;
+    readonly columns: readonly DataTableColumn[];
+    readonly rows: readonly DataTableRow[];
+    readonly caption?: string;
+    /** 无行时出的空态句（老侧 `emptyState({text})`）。 */
+    readonly emptyText: string;
+}
+/** 空态：一句话 ＋ 一句「接下来怎么办」。 */
+export interface EmptySpec {
+    readonly text: string;
+    readonly hint: string;
+}
+/** ① 读数＋条（13 个场景）：读数卡区 → 芯片列 →〔对比双卡＋变更徽标〕→〔图卡〕→ 条卡组 →〔列表卡〕→〔事实卡〕。 */
+export interface BarsPage {
+    readonly kpis: readonly KpiCardInput[];
+    readonly chips: readonly string[];
+    readonly charts: readonly ChartCard[];
+    readonly barGroups: readonly BarGroup[];
+    readonly listCards: readonly ListCard[];
+    readonly factCards: readonly FactCard[];
+    readonly empty: EmptySpec;
+}
+/** ② 读数＋图（4 个场景）：读数卡区／芯片列 → 图卡 → 明细卡（列表或事实行卡）。 */
+export interface ChartsPage {
+    readonly kpis: readonly KpiCardInput[];
+    readonly chips: readonly string[];
+    readonly charts: readonly ChartCard[];
+    readonly listCards: readonly ListCard[];
+    readonly factCards: readonly FactCard[];
+    readonly empty: EmptySpec;
+}
+/** ③ 读数＋表（3 个场景）：读数卡区 →〔芯片列〕→ 小表卡 →〔事实卡〕。 */
+export interface TablesPage {
+    readonly kpis: readonly KpiCardInput[];
+    readonly chips: readonly string[];
+    readonly tables: readonly TableCard[];
+    readonly factCards: readonly FactCard[];
+    readonly empty: EmptySpec;
+}
+/** ④ 对比＋变更（4 个场景）：对比卡（两段出入）→ 变更徽标 →〔差异条卡〕→〔事实卡〕。 */
+export interface ComparePage {
+    readonly kpis: readonly KpiCardInput[];
+    readonly chips: readonly string[];
+    readonly sides: readonly {
+        readonly title: string;
+        readonly kpis: readonly KpiCardInput[];
+    }[];
+    readonly change: {
+        readonly text: string;
+        readonly detail: string;
+        readonly direction: 'up' | 'down' | 'flat';
+    };
+    readonly barGroups: readonly BarGroup[];
+    readonly factCards: readonly FactCard[];
+    readonly empty: EmptySpec;
+}
+/** ⑤ 解读＋多卡（1 个场景）：解读条（由结论句承载）→ 读数卡区 → 事实卡 → 条卡组 → 图卡 → 列表卡。 */
+export interface InsightPage {
+    readonly kpis: readonly KpiCardInput[];
+    readonly factCards: readonly FactCard[];
+    readonly barGroups: readonly BarGroup[];
+    readonly charts: readonly ChartCard[];
+    readonly listCards: readonly ListCard[];
+    readonly empty: EmptySpec;
+}
+/** 五族的取值类型联合（按 `family` 窄化；模板件的入参就是它对应的那一支）。 */
+export type FamilyPage = BarsPage | ChartsPage | TablesPage | ComparePage | InsightPage;
+/** 一次取值的结果里**与族无关**的那一半（页面骨架与载荷都要）：五族模板件的入参都含它。 */
+export interface PageFacts {
+    /** 页标题（唤醒词逐字；`scene.title` 是缺省，个别场景要带期间后缀时在这里改）。 */
+    readonly title: string;
+    /** 期间标签（副标题与来源脚注那一行）。 */
+    readonly label: string;
+    /** 来源脚注的窗口起止（没有时间窗的查法给「不限」）。 */
+    readonly from: string;
+    readonly to: string;
+    /** 本页取到的事实条数（来源脚注「共 N 条」）。 */
+    readonly count: number;
+    /** 页头结论句（一句话说这批数是什么局面）。 */
+    readonly conclusion: string;
+    /** 口径说明行（怎么算的；图表族还要在这里点名没有记录的月）。 */
+    readonly caliber: string;
+    /** 结果胶囊：第二枚起（第一枚恒是唤醒词）。 */
+    readonly chips: readonly string[];
+    /** 出口载荷（envelope `data`）：`bill.analysis.overview` 是 `stat` 形（`metrics` 全 number）、
+     *  另两条是 `analysis` 形（`summary` 非空串）。**形状由 key 定死**，各场景不许自造第三种。 */
+    readonly payload: Record<string, unknown>;
+    /** 本页的收支读数（载荷与页面共用同一份）。 */
+    readonly kpi: Kpi;
+}
+/** 一次取值的结果：与族无关的那一半（`PageFacts`）＋ 这一族的那一份卡（`page`）。
+ *  载荷与页面同源不同形：载荷给机器（形状由 key 定，过 `base-link-core` 的守卫），页面给人。 */
+export type SceneResult<F extends FamilyPage> = PageFacts & {
+    readonly page: F;
+};
+/** 一件场景件跑起来要的现场：本次参数、库句柄、命令名、老侧 `type`。 */
+export interface SceneInput {
+    readonly key: AnalysisKey;
+    readonly kind: string;
+    readonly params: Record<string, unknown>;
+    readonly db: BillDb;
+}
+/** 五族模板件的入参（**同一份**）：本次是谁 ＋ 复制区要的三样取数 ＋ 场景取值的结果。
+ *  族的差别只在模板件里那份**块序**，入参形状全族一致。 */
+export interface DocInput<F extends FamilyPage> {
+    readonly key: AnalysisKey;
+    readonly params: Record<string, unknown>;
+    /** 唤醒词（页头第一枚胶囊；由域声明投影算出）。 */
+    readonly wakeWord: string;
+    /** 本次执行时刻（复制日志第 5 段）。 */
+    readonly actionAt: string;
+    /** 页面内置 envelope（复制区序列化它；形状与本次出口载荷一致）。 */
+    readonly envelope: SerializableEnvelope;
+    readonly result: SceneResult<F>;
+}
+/** 一件场景件：一条唤醒词的落点。`family` 与 `values` 绑在一支里——取值出的形状必须配得上那一族的模板。 */
+export type AnalysisScene = {
+    readonly id: string;
+    readonly key: AnalysisKey;
+    readonly kind: string;
+    readonly title: string;
+    readonly family: 'bars';
+    readonly values: (input: SceneInput) => SceneResult<BarsPage>;
+} | {
+    readonly id: string;
+    readonly key: AnalysisKey;
+    readonly kind: string;
+    readonly title: string;
+    readonly family: 'charts';
+    readonly values: (input: SceneInput) => SceneResult<ChartsPage>;
+} | {
+    readonly id: string;
+    readonly key: AnalysisKey;
+    readonly kind: string;
+    readonly title: string;
+    readonly family: 'tables';
+    readonly values: (input: SceneInput) => SceneResult<TablesPage>;
+} | {
+    readonly id: string;
+    readonly key: AnalysisKey;
+    readonly kind: string;
+    readonly title: string;
+    readonly family: 'compare';
+    readonly values: (input: SceneInput) => SceneResult<ComparePage>;
+} | {
+    readonly id: string;
+    readonly key: AnalysisKey;
+    readonly kind: string;
+    readonly title: string;
+    readonly family: 'insight';
+    readonly values: (input: SceneInput) => SceneResult<InsightPage>;
+};
+/** **25 行落点表**（唯一定义地）：顺序＝域声明 `src/analysis/declaration.ts` 里 `entries` 的书写顺序
+ *  （看月度 → 看年度 → … → 看退款），与老侧 `scenes/analysis.yaml` 的二级组顺序同族。 */
+export declare const ANALYSIS_SCENES: readonly AnalysisScene[];
+/** 取件：按 `命令名 + kind` 认。认不得即抛——**不猜、不兜底**（kind 已在 `./params.js` 拦过一道，
+ *  走到这里还认不得就是落点表与 kind 词表走散了，属代码缺陷）。 */
+export declare function sceneFor(key: AnalysisKey, kind: string): AnalysisScene;
+//# sourceMappingURL=scene.d.ts.map

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

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

package/dist/analysis/scene.js

@@ -0,0 +1,47 @@
+import { BillPolicyError } from '../fetch/errors.js';
+import { sceneAccount } from './scene-account.js';
+import { sceneActivity } from './scene-activity.js';
+import { sceneAnomaly } from './scene-anomaly.js';
+import { sceneCatCompare } from './scene-cat-compare.js';
+import { sceneCatTrend } from './scene-cat-trend.js';
+import { sceneCategory } from './scene-category.js';
+import { sceneDebt } from './scene-debt.js';
+import { sceneDistribution } from './scene-distribution.js';
+import { sceneInsight } from './scene-insight.js';
+import { sceneInstallment } from './scene-installment.js';
+import { sceneLedger } from './scene-ledger.js';
+import { sceneMonthly } from './scene-monthly.js';
+import { sceneOverview } from './scene-overview.js';
+import { scenePeriodCompare } from './scene-period-compare.js';
+import { sceneRangeCompare } from './scene-range-compare.js';
+import { sceneRefund } from './scene-refund.js';
+import { sceneReimburse } from './scene-reimburse.js';
+import { sceneStats } from './scene-stats.js';
+import { sceneStructure } from './scene-structure.js';
+import { sceneTop } from './scene-top.js';
+import { sceneTopFreq } from './scene-top-freq.js';
+import { sceneTrend } from './scene-trend.js';
+import { sceneWeek } from './scene-week.js';
+import { sceneYearly } from './scene-yearly.js';
+import { sceneYoy } from './scene-yoy.js';
+/** **25 行落点表**（唯一定义地）：顺序＝域声明 `src/analysis/declaration.ts` 里 `entries` 的书写顺序
+ *  （看月度 → 看年度 → … → 看退款），与老侧 `scenes/analysis.yaml` 的二级组顺序同族。 */
+export const ANALYSIS_SCENES = [
+    sceneMonthly, sceneYearly, sceneOverview, sceneWeek, sceneCategory, sceneAccount, sceneLedger, sceneStructure, sceneStats,
+    scenePeriodCompare, sceneRangeCompare, sceneYoy, sceneCatCompare,
+    sceneTrend, sceneCatTrend, sceneTop, sceneTopFreq, sceneDistribution, sceneActivity, sceneInsight, sceneAnomaly,
+    sceneDebt, sceneReimburse, sceneInstallment, sceneRefund,
+];
+/** 落点表按 `命令名 + 老侧 type` 建索引：**两个域里同名的 kind 靠命令名分开**
+ *  （`category` 这个 kind 三条命令各有一支：看分类／看分类对比／看分类趋势）。 */
+const BY_KEY_KIND = new Map(ANALYSIS_SCENES.map((s) => [s.key + '|' + s.kind, s]));
+/** 取件：按 `命令名 + kind` 认。认不得即抛——**不猜、不兜底**（kind 已在 `./params.js` 拦过一道，
+ *  走到这里还认不得就是落点表与 kind 词表走散了，属代码缺陷）。 */
+export function sceneFor(key, kind) {
+    const hit = BY_KEY_KIND.get(key + '|' + kind);
+    if (hit === undefined) {
+        throw new BillPolicyError('POLICY_BAD_INPUT', '分析域没有这一支场景：' + key + ' / ' + kind);
+    }
+    return hit;
+}
+//# sourceMappingURL=scene.js.map

package/dist/analysis/scene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.js","sourceRoot":"","sources":["../../src/analysis/scene.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAgM1C;iEACiE;AACjE,MAAM,CAAC,MAAM,eAAe,GAA6B;IACvD,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU;IACzH,kBAAkB,EAAE,iBAAiB,EAAE,QAAQ,EAAE,eAAe;IAChE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY;IAC/G,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW;CACzD,CAAC;AAEF;qDACqD;AACrD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAwB,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAE1G;wCACwC;AACxC,MAAM,UAAU,QAAQ,CAAC,GAAgB,EAAE,IAAY;IACrD,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC;IAC9C,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,aAAa,GAAG,GAAG,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/analysis/template-bars.d.ts

@@ -0,0 +1,3 @@
+import type { BarsPage, DocInput } from './scene.js';
+export declare function barsDoc(input: DocInput<BarsPage>): string;
+//# sourceMappingURL=template-bars.d.ts.map

package/dist/analysis/template-bars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-bars.d.ts","sourceRoot":"","sources":["../../src/analysis/template-bars.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGrD,wBAAgB,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,MAAM,CA4CzD"}

package/dist/analysis/template-bars.js

@@ -0,0 +1,64 @@
+/** 分析域模板之一 · **读数＋条**（`t685-按域页型表.md` §2.3 第一族；13 个场景）。
+ *
+ * **本件是这一族页型的块位序列唯一住所**：块序、每块的出现条件、每块吃的数据都写在这里。
+ *  改一次这一族的版式只动本件一处（另一族的版式改动动不了本族的产物）。
+ *
+ * 盖住的场景（老侧渲染器行号见 t685 §2.3）：看月度／看年度／看总览／看周报／看分类／看账户／看账本／
+ *  看结构／做统计／看活跃／看退款／看大额／看高频。
+ *
+ * **块位序列**（照 #688 §五 5.2 的 ⑦ 结果型可切换页那一列的顺序；● 恒出、○ 有内容才出）：
+ *   页头（眉标 ● ＋ 标题 ● ＋ 状态徽章 ●）→ 结论句 ● → 页内导航 ●
+ *     → 读数行 ○（第 5 行；本族多数页有，看账户／看账本／看结构没有——它们报的是「分组的读数」，见下）
+ *     → 主表／主列表 ○（第 12 行：明细行卡，含筛选条件回显的芯片 ○）
+ *     → 分类聚合／占比条 ●（第 13 行：这一族**必有**这一块——族名里那个「条」就是它）
+ *     → 图表 ○（第 14 行；看分类／看结构两页有环形图）
+ *     → 事实行卡 ○（第 13 行相邻的键值读数，看总览「区间标注」那一格）
+ *     → 空态块 ＋ 引导句 ●（第 23 行；窗口内一条记录也没有时出，见下）
+ *     → 口径说明行 ●（第 24 行）→ 复制区 ●（第 25 行）→ 来源脚注 ●（第 26 行）
+ *
+ * **空态是两档**（照 #688 §三 第 7 条与裁定 4）：每一块（每张条卡、每张列表卡）自带自己的空态句；
+ *  整页**一张卡都没有内容**时另出联合兜底那一格（「近一段时间还没有数据」＋「怎么记第一条」的引导句）——
+ *  这一格在正文之后、口径行之前，页头与来源脚注照旧，整页仍是完整文档。
+ *
+ * 谁在用（一个调用点，指名）：`src/analysis/read.ts`——`family === 'bars'` 那 13 个场景出页时调它。
+ */
+import { barGroupHtml, cardBlock, chartCardHtml, emptyHtml, factCardHtml, kpiGridHtml, listCardHtml, mergedChips } from './cards.js';
+import { NO_WINDOW, SOURCE_READ, analysisDocOf, docTitleOf } from './pageParts.js';
+export function barsDoc(input) {
+    const r = input.result;
+    const p = r.page;
+    const nothing = p.kpis.length === 0 && p.charts.length === 0
+        && p.barGroups.every((g) => g.rows.length === 0) && p.listCards.every((c) => c.rows.length === 0);
+    const blocks = [
+        ...(p.kpis.length === 0 ? [] : [cardBlock(kpiGridHtml(p.kpis), 'sec-kpi', '读数')]),
+        ...(p.chips.length === 0 && r.chips.length === 0 ? [] : [{ html: mergedChips(p.chips, r.chips) }]),
+        ...(p.listCards.length === 0 ? [] : p.listCards.map((c, i) => cardBlock(listCardHtml(c), 'sec-list-' + String(i + 1), c.title))),
+        ...(p.barGroups.length === 0 ? [] : p.barGroups.map((g, i) => cardBlock(barGroupHtml(g), 'sec-bars-' + String(i + 1), g.title))),
+        ...(p.charts.length === 0 ? [] : p.charts.map((c, i) => cardBlock(chartCardHtml(c), 'sec-chart-' + String(i + 1), c.title))),
+        ...(p.factCards.length === 0 ? [] : p.factCards.map((c, i) => cardBlock(factCardHtml(c), 'sec-facts-' + String(i + 1), c.title))),
+        ...(nothing ? [{ html: emptyHtml(p.empty) }] : []),
+    ];
+    return analysisDocOf({
+        key: input.key,
+        params: input.params,
+        wakeWord: input.wakeWord,
+        docTitle: docTitleOf(r.title),
+        subtitle: r.label,
+        shape: input.envelope.shape,
+        wordCaliber: '',
+        status: nothing ? 'empty' : 'ok',
+        statusText: nothing ? '这一段没有记录' : '看完了',
+        next: nothing ? p.empty.hint : '',
+        conclusion: r.conclusion,
+        caliber: r.caliber,
+        blocks,
+        envelope: input.envelope,
+        source: SOURCE_READ,
+        detail: '取到 ' + String(r.count) + ' 条记录',
+        actionAt: input.actionAt,
+        windowStart: r.from === '' ? NO_WINDOW : r.from,
+        windowEnd: r.to === '' ? NO_WINDOW : r.to,
+        count: r.count,
+    });
+}
+//# sourceMappingURL=template-bars.js.map

package/dist/analysis/template-bars.js.map

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

package/dist/analysis/template-charts.d.ts

@@ -0,0 +1,3 @@
+import type { ChartsPage, DocInput } from './scene.js';
+export declare function chartsDoc(input: DocInput<ChartsPage>): string;
+//# sourceMappingURL=template-charts.d.ts.map

package/dist/analysis/template-charts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-charts.d.ts","sourceRoot":"","sources":["../../src/analysis/template-charts.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGvD,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,MAAM,CAyC7D"}

package/dist/analysis/template-charts.js

@@ -0,0 +1,55 @@
+/** 分析域模板之二 · **读数＋图**（`t685-按域页型表.md` §2.3 第二族；4 个场景）。
+ *
+ * **本件是这一族页型的块位序列唯一住所**。盖住的场景：看趋势／看分类趋势／看分布／看异常。
+ *
+ * **块位序列**（照 #688 §五 5.2 的 ⑦ 列顺序）：
+ *   页头 ● → 结论句 ● → 页内导航 ● → 读数行 ○（看异常没有总读数卡，它报的是「环比变化」）→ 芯片列 ○
+ *     → 图表 ●（这一族**必有**图——族名里那个「图」就是它；四图＝双折线／柱／直方／环形）→
+ *     主列表 ○（逐月明细那一类）→ 事实行卡 ○（区间分布明细那一类）→ 空态 ● → 口径说明行 ●
+ *     → 复制区 ● → 来源脚注 ●
+ *
+ * **本族的口径句是硬要求**（#688 §四 裁定 3）：折线／柱图必须带纵轴可读刻度、零值不出柱身、
+ *  点数不足时不画半截线改出说明句、**跨空档用同色虚线并把「哪几个月没有记录」写进图下口径句**——
+ *  这四条的读数由场景在 `caliber` 里给（缺月点名），图本身的刻度与虚线由公共层图表件按 `kind` 出。
+ *
+ * 谁在用（一个调用点，指名）：`src/analysis/read.ts`——`family === 'charts'` 那 4 个场景出页时调它。
+ */
+import { cardBlock, chartCardHtml, emptyHtml, factCardHtml, kpiGridHtml, listCardHtml, mergedChips } from './cards.js';
+import { NO_WINDOW, SOURCE_READ, analysisDocOf, docTitleOf } from './pageParts.js';
+export function chartsDoc(input) {
+    const r = input.result;
+    const p = r.page;
+    const nothing = p.kpis.length === 0 && p.charts.length === 0
+        && p.listCards.every((c) => c.rows.length === 0) && p.factCards.every((c) => c.rows.length === 0);
+    const blocks = [
+        ...(p.kpis.length === 0 ? [] : [cardBlock(kpiGridHtml(p.kpis), 'sec-kpi', '读数')]),
+        ...(p.chips.length === 0 && r.chips.length === 0 ? [] : [{ html: mergedChips(p.chips, r.chips) }]),
+        ...(p.charts.length === 0 ? [] : p.charts.map((c, i) => cardBlock(chartCardHtml(c), 'sec-chart-' + String(i + 1), c.title))),
+        ...(p.listCards.length === 0 ? [] : p.listCards.map((c, i) => cardBlock(listCardHtml(c), 'sec-list-' + String(i + 1), c.title))),
+        ...(p.factCards.length === 0 ? [] : p.factCards.map((c, i) => cardBlock(factCardHtml(c), 'sec-facts-' + String(i + 1), c.title))),
+        ...(nothing ? [{ html: emptyHtml(p.empty) }] : []),
+    ];
+    return analysisDocOf({
+        key: input.key,
+        params: input.params,
+        wakeWord: input.wakeWord,
+        docTitle: docTitleOf(r.title),
+        subtitle: r.label,
+        shape: input.envelope.shape,
+        wordCaliber: '',
+        status: nothing ? 'empty' : 'ok',
+        statusText: nothing ? '这一段没有记录' : '看完了',
+        next: nothing ? p.empty.hint : '',
+        conclusion: r.conclusion,
+        caliber: r.caliber,
+        blocks,
+        envelope: input.envelope,
+        source: SOURCE_READ,
+        detail: '取到 ' + String(r.count) + ' 条记录',
+        actionAt: input.actionAt,
+        windowStart: r.from === '' ? NO_WINDOW : r.from,
+        windowEnd: r.to === '' ? NO_WINDOW : r.to,
+        count: r.count,
+    });
+}
+//# sourceMappingURL=template-charts.js.map

package/dist/analysis/template-charts.js.map

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

package/dist/analysis/template-compare.d.ts

@@ -0,0 +1,3 @@
+import type { ComparePage, DocInput } from './scene.js';
+export declare function compareDoc(input: DocInput<ComparePage>): string;
+//# sourceMappingURL=template-compare.d.ts.map

package/dist/analysis/template-compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-compare.d.ts","sourceRoot":"","sources":["../../src/analysis/template-compare.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGxD,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,MAAM,CAyC/D"}

package/dist/analysis/template-compare.js

@@ -0,0 +1,54 @@
+/** 分析域模板之四 · **对比＋变更**（`t685-按域页型表.md` §2.3 第四族；4 个场景）。
+ *
+ * **本件是这一族页型的块位序列唯一住所**。盖住的场景：看对比／看双区间／看同比／看分类对比。
+ *
+ * **块位序列**（照 #688 §五 5.2 的 ⑦ 列顺序）：
+ *   页头 ● → 结论句 ● → 页内导航 ● → 对比双卡 ●（两段期间各自的读数卡区：笔数／支出／收入／净额）
+ *     → 变更徽标 ●（支出侧差值与百分比；结论条承载那一句，方向由它自己说清）
+ *     → 条卡组 ○（分类差异 TOP：看双区间与看分类对比有）→ 事实行卡 ○（分类差异的逐行读数）
+ *     → 空态 ● → 口径说明行 ● → 复制区 ● → 来源脚注 ●
+ *
+ * 谁在用（一个调用点，指名）：`src/analysis/read.ts`——`family === 'compare'` 那 4 个场景出页时调它。
+ */
+import { barGroupHtml, cardBlock, compareSidesHtml, emptyHtml, factCardHtml, kpiGridHtml, mergedChips } from './cards.js';
+import { NO_WINDOW, SOURCE_READ, analysisDocOf, docTitleOf } from './pageParts.js';
+import { renderCaliberLine, renderConclusionBar } from 'base-paint/blocks';
+export function compareDoc(input) {
+    const r = input.result;
+    const p = r.page;
+    const nothing = p.sides.length === 0 && p.barGroups.every((g) => g.rows.length === 0)
+        && p.factCards.every((c) => c.rows.length === 0);
+    const blocks = [
+        ...(p.kpis.length === 0 ? [] : [cardBlock(kpiGridHtml(p.kpis), 'sec-kpi', '读数')]),
+        ...(p.chips.length === 0 && r.chips.length === 0 ? [] : [{ html: mergedChips(p.chips, r.chips) }]),
+        ...(p.sides.length === 0 ? [] : [cardBlock(compareSidesHtml(p.sides), 'sec-compare', '两段对比')]),
+        ...(p.change.text === '' ? [] : [{ html: renderConclusionBar(p.change.text) }]),
+        ...(p.change.detail === '' ? [] : [{ html: renderCaliberLine(p.change.detail) }]),
+        ...(p.barGroups.length === 0 ? [] : p.barGroups.map((g, i) => cardBlock(barGroupHtml(g), 'sec-bars-' + String(i + 1), g.title))),
+        ...(p.factCards.length === 0 ? [] : p.factCards.map((c, i) => cardBlock(factCardHtml(c), 'sec-facts-' + String(i + 1), c.title))),
+        ...(nothing ? [{ html: emptyHtml(p.empty) }] : []),
+    ];
+    return analysisDocOf({
+        key: input.key,
+        params: input.params,
+        wakeWord: input.wakeWord,
+        docTitle: docTitleOf(r.title),
+        subtitle: r.label,
+        shape: input.envelope.shape,
+        wordCaliber: '',
+        status: nothing ? 'empty' : 'ok',
+        statusText: nothing ? '两段都没有记录' : '看完了',
+        next: nothing ? p.empty.hint : '',
+        conclusion: r.conclusion,
+        caliber: r.caliber,
+        blocks,
+        envelope: input.envelope,
+        source: SOURCE_READ,
+        detail: '取到 ' + String(r.count) + ' 条记录',
+        actionAt: input.actionAt,
+        windowStart: r.from === '' ? NO_WINDOW : r.from,
+        windowEnd: r.to === '' ? NO_WINDOW : r.to,
+        count: r.count,
+    });
+}
+//# sourceMappingURL=template-compare.js.map