base-paint 0.3.14 → 0.3.16

package/dist/components/calendar-month/attrs.d.ts

@@ -0,0 +1,85 @@
+/** calendar-month · **标记契约**（渲染与调用方共用的唯一事实：类名／形态闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-05-时间与分组.mjs`，2026-09 用户裁定）
+ *  里的**形态 A「格内数字＋小计＋底部水量条（带星期表头）」**：一格一天、七列一周，
+ *  格里的深浅与底部那条小柱一起表示**当天的量**；今天靠「墨圈 ＋ 今字」认出来。
+ *
+ *  它替掉的三种错法：
+ *   · 把一个月的读数写成 31 行文字 —— 读者要的是"哪几天多、哪几天少"，句子给不出分布；
+ *   · 只标"哪天有记录"不给量 —— 空/满两态读不出量差（那是 `punch-strip` 的活）；
+ *   · 拿折线画 30~31 个日级读数 —— 格宽被点挤爆，窄档成一条毛刺。
+ *
+ *  形态键写在 `CALENDAR_MONTH_FORMS`（闭集）：本件只有一格，但键必须存在——
+ *  「形态是骨架，不是地址」，日后加第二形态是在闭集里加一格，不是新开一件。
+ *  闭集外的值一律 `badInput`（不静默降级：降级会让调用方以为自己拿到了另一种骨架）。
+ */
+/** 本件的类名根：全部槽位类名都是 `CALENDAR_MONTH_CLASS + '-' + 槽名`。 */
+export declare const CALENDAR_MONTH_CLASS = "ilife-block-calendar-month";
+/** 槽位闭集（标记契约的一部分：`render.ts` 与判据都用这里的名字拼类名，不各抄一份字面量）。 */
+export declare const CALENDAR_MONTH_SLOTS: readonly ["hd", "title", "use", "sum", "sum-label", "sum-value", "wk", "wd", "grid", "c", "d", "today-mark", "v", "bar", "bar-fill", "blank", "lg", "sw", "note"];
+export type CalendarMonthSlot = (typeof CALENDAR_MONTH_SLOTS)[number];
+/** 槽类的类名（唯一拼法：别处不许再写 `CALENDAR_MONTH_CLASS + '-' + …`）。 */
+export declare function calendarMonthSlot(slot: CalendarMonthSlot, prefix?: string): string;
+/** 形态闭集：本件只落地了形态 A「格内数字＋小计＋底部水量条（带星期表头）」。 */
+export declare const CALENDAR_MONTH_FORMS: readonly ["grid"];
+export type CalendarMonthForm = (typeof CALENDAR_MONTH_FORMS)[number];
+/** 缺值的写法：**缺值写成 `—`，不许写 0、不许留空**（全仓同一条地板）。 */
+export declare const CALENDAR_MONTH_MISSING = "\u2014";
+/** 今天那一格上的「今」字（今天是**形＋字**两路可认，色不是唯一信息）。 */
+export declare const CALENDAR_MONTH_TODAY_MARK = "\u4ECA";
+/** 一周七格。 */
+export declare const CALENDAR_MONTH_WEEK_LENGTH = 7;
+/** 一个月最多六行（6 × 7 ＝ 42 格；再多就不是一个月了）。 */
+export declare const CALENDAR_MONTH_MAX_WEEKS = 6;
+/** 缺省星期表头（周一起首列，与原型一致）。 */
+export declare const CALENDAR_MONTH_WEEKDAYS: readonly string[];
+/** 深浅档闭集：0＝没有量（空档），4＝最多。5 档是"格内还能读出字"的上限。 */
+export declare const CALENDAR_MONTH_LEVELS: readonly [0, 1, 2, 3, 4];
+export type CalendarMonthLevel = (typeof CALENDAR_MONTH_LEVELS)[number];
+/** 一格一天。 */
+export interface CalendarMonthDayInput {
+    /** 格里的日期字（如 `14`；「今天」二字带不带由调用方定）。 */
+    readonly day: string;
+    /** 那天的读数（**已是给人看的样子**：取整、千分位、单位归调用方）；**必填**，`null` ＝ 缺值（写 `—`）。 */
+    readonly value: string | null;
+    /** 深浅档（0..4，缺省 `0`）；`value` 为 `null` 时一律按 `0` 处理（没有量就没有深浅）。 */
+    readonly level?: CalendarMonthLevel;
+    /** 今天那一格：套墨圈 ＋ 写「今」字；一个月至多一格。 */
+    readonly today?: boolean;
+}
+/** 头部右端的合计位。 */
+export interface CalendarMonthSummary {
+    /** 标签（如「本月合计」）。 */
+    readonly label: string;
+    /** 值（如 `¥12,345`）。 */
+    readonly value: string;
+}
+/** 深浅图例的一条。 */
+export interface CalendarMonthLegendItem {
+    /** 色块对应的档（0..4）。 */
+    readonly level: CalendarMonthLevel;
+    /** 色块的说明（如「≤¥100」）。 */
+    readonly label: string;
+}
+/** 月历格入参。`title` 与 `cells` 必填——**没有格盘就不走本件**（本件只有形态 A 一种骨架）。 */
+export interface CalendarMonthInput {
+    /** 月份标题（如「2026 年 5 月」）；**不许 `…` 截断**，长了就换行。 */
+    readonly title: string;
+    /** 逐格（**按行排满**：长度必须是 7 的倍数，最多 6 行）；`null` ＝ 月首月尾的空位。 */
+    readonly cells: readonly (CalendarMonthDayInput | null)[];
+    /** 用途说明（如「记账 · 每日支出」）；不给＝不出。 */
+    readonly use?: string;
+    /** 星期表头（七枚）；不给＝周一至周日。 */
+    readonly weekdays?: readonly string[];
+    /** 头部右端的合计位；不给＝不出。 */
+    readonly summary?: CalendarMonthSummary;
+    /** 深浅图例（0..5 条）；不给＝不出。 */
+    readonly legend?: readonly CalendarMonthLegendItem[];
+    /** 脚注（如「今天 14 日 · 3 笔 · ¥92」）；不给＝不出。 */
+    readonly note?: string;
+    /** 形态键（闭集，缺省 `grid`）。 */
+    readonly form?: CalendarMonthForm;
+    /** 附加类名（空格分隔；逐个过类名正则）。 */
+    readonly extraClass?: string;
+}
+//# sourceMappingURL=attrs.d.ts.map

package/dist/components/calendar-month/attrs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.d.ts","sourceRoot":"","sources":["../../../src/components/calendar-month/attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,yDAAyD;AACzD,eAAO,MAAM,oBAAoB,+BAA+B,CAAC;AAEjE,yDAAyD;AACzD,eAAO,MAAM,oBAAoB,mKAuCvB,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,EAAE,MAAM,SAAW,GAAG,MAAM,CAEpF;AAED,6CAA6C;AAC7C,eAAO,MAAM,oBAAoB,mBAAoB,CAAC;AACtD,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,8CAA8C;AAC9C,eAAO,MAAM,sBAAsB,WAAW,CAAC;AAE/C,2CAA2C;AAC3C,eAAO,MAAM,yBAAyB,WAAM,CAAC;AAE7C,YAAY;AACZ,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,uCAAuC;AACvC,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,2BAA2B;AAC3B,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAAwC,CAAC;AAE9F,6CAA6C;AAC7C,eAAO,MAAM,qBAAqB,0BAA2B,CAAC;AAC9D,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,YAAY;AACZ,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;IACpC,iCAAiC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,gBAAgB;AAChB,MAAM,WAAW,oBAAoB;IACnC,mBAAmB;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,eAAe;AACf,MAAM,WAAW,uBAAuB;IACtC,oBAAoB;IACpB,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,uBAAuB;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IACjC,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,qBAAqB,GAAG,IAAI,CAAC,EAAE,CAAC;IAC1D,gCAAgC;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,sBAAsB;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IACxC,0BAA0B;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACrD,wCAAwC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,yBAAyB;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAC;IAClC,0BAA0B;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B"}

package/dist/components/calendar-month/attrs.js

@@ -0,0 +1,77 @@
+/** calendar-month · **标记契约**（渲染与调用方共用的唯一事实：类名／形态闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-05-时间与分组.mjs`，2026-09 用户裁定）
+ *  里的**形态 A「格内数字＋小计＋底部水量条（带星期表头）」**：一格一天、七列一周，
+ *  格里的深浅与底部那条小柱一起表示**当天的量**；今天靠「墨圈 ＋ 今字」认出来。
+ *
+ *  它替掉的三种错法：
+ *   · 把一个月的读数写成 31 行文字 —— 读者要的是"哪几天多、哪几天少"，句子给不出分布；
+ *   · 只标"哪天有记录"不给量 —— 空/满两态读不出量差（那是 `punch-strip` 的活）；
+ *   · 拿折线画 30~31 个日级读数 —— 格宽被点挤爆，窄档成一条毛刺。
+ *
+ *  形态键写在 `CALENDAR_MONTH_FORMS`（闭集）：本件只有一格，但键必须存在——
+ *  「形态是骨架，不是地址」，日后加第二形态是在闭集里加一格，不是新开一件。
+ *  闭集外的值一律 `badInput`（不静默降级：降级会让调用方以为自己拿到了另一种骨架）。
+ */
+/** 本件的类名根：全部槽位类名都是 `CALENDAR_MONTH_CLASS + '-' + 槽名`。 */
+export const CALENDAR_MONTH_CLASS = 'ilife-block-calendar-month';
+/** 槽位闭集（标记契约的一部分：`render.ts` 与判据都用这里的名字拼类名，不各抄一份字面量）。 */
+export const CALENDAR_MONTH_SLOTS = [
+    /** 头部那一排：标题 ＋ 用途 ＋ 合计（窄档自己折行）。 */
+    'hd',
+    /** 月份标题（如「2026 年 5 月」）。 */
+    'title',
+    /** 用途说明（如「记账 · 每日支出」）。 */
+    'use',
+    /** 头部右端的合计位。 */
+    'sum',
+    /** 合计位的标签（如「本月合计」）。 */
+    'sum-label',
+    /** 合计位的值（已经是给人看的样子）。 */
+    'sum-value',
+    /** 星期表头那一排（七格）。 */
+    'wk',
+    /** 星期表头的一格。 */
+    'wd',
+    /** 月历格盘（七列）。 */
+    'grid',
+    /** 一格一天。 */
+    'c',
+    /** 格里的日期字。 */
+    'd',
+    /** 今天那一枚「今」字（与墨圈一起，保证不只靠颜色认今天）。 */
+    'today-mark',
+    /** 格里的当天读数（缺值写 `—`）。 */
+    'v',
+    /** 底部那条小柱（量的深浅与高度一起变）。 */
+    'bar',
+    /** 小柱的填充段（纯装饰，`aria-hidden`）。 */
+    'bar-fill',
+    /** 月首月尾的空位（有格无日）。 */
+    'blank',
+    /** 深浅图例那一排。 */
+    'lg',
+    /** 图例里的色块。 */
+    'sw',
+    /** 脚注（弱文字，可很长、必须能换行）。 */
+    'note',
+];
+/** 槽类的类名（唯一拼法：别处不许再写 `CALENDAR_MONTH_CLASS + '-' + …`）。 */
+export function calendarMonthSlot(slot, prefix = 'ilife-') {
+    return prefix + 'block-calendar-month-' + slot;
+}
+/** 形态闭集：本件只落地了形态 A「格内数字＋小计＋底部水量条（带星期表头）」。 */
+export const CALENDAR_MONTH_FORMS = ['grid'];
+/** 缺值的写法：**缺值写成 `—`，不许写 0、不许留空**（全仓同一条地板）。 */
+export const CALENDAR_MONTH_MISSING = '\u2014';
+/** 今天那一格上的「今」字（今天是**形＋字**两路可认，色不是唯一信息）。 */
+export const CALENDAR_MONTH_TODAY_MARK = '今';
+/** 一周七格。 */
+export const CALENDAR_MONTH_WEEK_LENGTH = 7;
+/** 一个月最多六行（6 × 7 ＝ 42 格；再多就不是一个月了）。 */
+export const CALENDAR_MONTH_MAX_WEEKS = 6;
+/** 缺省星期表头（周一起首列，与原型一致）。 */
+export const CALENDAR_MONTH_WEEKDAYS = ['一', '二', '三', '四', '五', '六', '日'];
+/** 深浅档闭集：0＝没有量（空档），4＝最多。5 档是"格内还能读出字"的上限。 */
+export const CALENDAR_MONTH_LEVELS = [0, 1, 2, 3, 4];
+//# sourceMappingURL=attrs.js.map

package/dist/components/calendar-month/attrs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.js","sourceRoot":"","sources":["../../../src/components/calendar-month/attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,yDAAyD;AACzD,MAAM,CAAC,MAAM,oBAAoB,GAAG,4BAA4B,CAAC;AAEjE,yDAAyD;AACzD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,kCAAkC;IAClC,IAAI;IACJ,2BAA2B;IAC3B,OAAO;IACP,0BAA0B;IAC1B,KAAK;IACL,gBAAgB;IAChB,KAAK;IACL,uBAAuB;IACvB,WAAW;IACX,wBAAwB;IACxB,WAAW;IACX,mBAAmB;IACnB,IAAI;IACJ,eAAe;IACf,IAAI;IACJ,gBAAgB;IAChB,MAAM;IACN,YAAY;IACZ,GAAG;IACH,cAAc;IACd,GAAG;IACH,mCAAmC;IACnC,YAAY;IACZ,wBAAwB;IACxB,GAAG;IACH,0BAA0B;IAC1B,KAAK;IACL,iCAAiC;IACjC,UAAU;IACV,qBAAqB;IACrB,OAAO;IACP,eAAe;IACf,IAAI;IACJ,cAAc;IACd,IAAI;IACJ,yBAAyB;IACzB,MAAM;CACE,CAAC;AAGX,2DAA2D;AAC3D,MAAM,UAAU,iBAAiB,CAAC,IAAuB,EAAE,MAAM,GAAG,QAAQ;IAC1E,OAAO,MAAM,GAAG,uBAAuB,GAAG,IAAI,CAAC;AACjD,CAAC;AAED,6CAA6C;AAC7C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAM,CAAU,CAAC;AAGtD,8CAA8C;AAC9C,MAAM,CAAC,MAAM,sBAAsB,GAAG,QAAQ,CAAC;AAE/C,2CAA2C;AAC3C,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAE7C,YAAY;AACZ,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC;AAE5C,uCAAuC;AACvC,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAE1C,2BAA2B;AAC3B,MAAM,CAAC,MAAM,uBAAuB,GAAsB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAE9F,6CAA6C;AAC7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAU,CAAC"}

package/dist/components/calendar-month/index.d.ts

@@ -0,0 +1,13 @@
+/** calendar-month · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  三件出口：`renderCalendarMonth(input)`（产标记，零 DOM）／`calendarMonthCss()`（样式段）／
+ *  标记契约常量（类名根、槽位闭集、形态闭集、缺值字、五档闭集、格盘口径）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ *  样式由页面按需注入 `calendarMonthCss()`（**加法式**：不挂就零命中，别的页逐字节不变）。
+ */
+export { CALENDAR_MONTH_CLASS, CALENDAR_MONTH_FORMS, CALENDAR_MONTH_LEVELS, CALENDAR_MONTH_MAX_WEEKS, CALENDAR_MONTH_MISSING, CALENDAR_MONTH_SLOTS, CALENDAR_MONTH_TODAY_MARK, CALENDAR_MONTH_WEEKDAYS, CALENDAR_MONTH_WEEK_LENGTH, calendarMonthSlot, } from './attrs.js';
+export type { CalendarMonthDayInput, CalendarMonthForm, CalendarMonthInput, CalendarMonthLegendItem, CalendarMonthLevel, CalendarMonthSlot, CalendarMonthSummary, } from './attrs.js';
+export { renderCalendarMonth } from './render.js';
+export { CALENDAR_MONTH_BAR_HEIGHT_PX, CALENDAR_MONTH_CELL_MIN_HEIGHT_PX, CALENDAR_MONTH_LEVEL_HEIGHTS_PX, CALENDAR_MONTH_NARROW_PX, calendarMonthCss, } from './style.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/calendar-month/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/calendar-month/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,0BAA0B,EAC1B,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EACL,4BAA4B,EAC5B,iCAAiC,EACjC,+BAA+B,EAC/B,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/components/calendar-month/index.js

@@ -0,0 +1,12 @@
+/** calendar-month · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  三件出口：`renderCalendarMonth(input)`（产标记，零 DOM）／`calendarMonthCss()`（样式段）／
+ *  标记契约常量（类名根、槽位闭集、形态闭集、缺值字、五档闭集、格盘口径）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ *  样式由页面按需注入 `calendarMonthCss()`（**加法式**：不挂就零命中，别的页逐字节不变）。
+ */
+export { CALENDAR_MONTH_CLASS, CALENDAR_MONTH_FORMS, CALENDAR_MONTH_LEVELS, CALENDAR_MONTH_MAX_WEEKS, CALENDAR_MONTH_MISSING, CALENDAR_MONTH_SLOTS, CALENDAR_MONTH_TODAY_MARK, CALENDAR_MONTH_WEEKDAYS, CALENDAR_MONTH_WEEK_LENGTH, calendarMonthSlot, } from './attrs.js';
+export { renderCalendarMonth } from './render.js';
+export { CALENDAR_MONTH_BAR_HEIGHT_PX, CALENDAR_MONTH_CELL_MIN_HEIGHT_PX, CALENDAR_MONTH_LEVEL_HEIGHTS_PX, CALENDAR_MONTH_NARROW_PX, calendarMonthCss, } from './style.js';
+//# sourceMappingURL=index.js.map

package/dist/components/calendar-month/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/calendar-month/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,0BAA0B,EAC1B,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAUpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EACL,4BAA4B,EAC5B,iCAAiC,EACjC,+BAA+B,EAC/B,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/components/calendar-month/model.d.ts

@@ -0,0 +1,31 @@
+import { type CalendarMonthForm, type CalendarMonthLevel } from './attrs.js';
+/** 内部类型：每个字段都已校验、已归一（`undefined` 一律换成「不给」或空数组）。 */
+export interface CalendarMonthModel {
+    readonly form: CalendarMonthForm;
+    readonly title: string;
+    readonly use?: string;
+    readonly weekdays: readonly string[];
+    readonly cells: readonly (CalendarMonthDayModel | null)[];
+    readonly summary?: {
+        readonly label: string;
+        readonly value: string;
+    };
+    readonly legend: readonly {
+        readonly level: CalendarMonthLevel;
+        readonly label: string;
+    }[];
+    readonly note?: string;
+    readonly extraClass?: string;
+}
+/** 归一后的一格（`value` 已是**上屏字**：缺值＝`—`）。 */
+export interface CalendarMonthDayModel {
+    readonly day: string;
+    readonly value: string;
+    readonly level: CalendarMonthLevel;
+    /** 这一格是不是"缺值"（`value` 原本是 `null`）——渲染要给它一个更弱的字色。 */
+    readonly missing: boolean;
+    readonly today: boolean;
+}
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `CalendarMonthModel`，不再自己碰 `any`。 */
+export declare function normalizeCalendarMonth(input: unknown): CalendarMonthModel;
+//# sourceMappingURL=model.d.ts.map

package/dist/components/calendar-month/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/components/calendar-month/model.ts"],"names":[],"mappings":"AAcA,OAAO,EAQL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACxB,MAAM,YAAY,CAAC;AAEpB,mDAAmD;AACnD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,qBAAqB,GAAG,IAAI,CAAC,EAAE,CAAC;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3F,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,wCAAwC;AACxC,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAsGD,0EAA0E;AAC1E,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAqBzE"}

package/dist/components/calendar-month/model.js

@@ -0,0 +1,143 @@
+/** calendar-month · **入参归一化与校验**（把 `any` 与说不出的 `unknown` 挡在门外，产出内部类型）。
+ *
+ *  三条口径（与 `page-head/model.ts` 同一份）：
+ *   1. **非法入参一律 `badInput()`**（抛 `BlocksError`）——不静默降级、不「尽量猜」：
+ *      猜出来的骨架会在页面上长成另一种东西，而调用方以为拿到了本件。
+ *   2. **缺值与空串是两件事**：`day.value` 给 `null` ＝ 缺值（写成 `—`）；给空串 ＝ 错。
+ *   3. 归一化只做「形状」：取整、千分位、单位口径**归调用方**——本件只收「已经是给人看的样子」的串。
+ *
+ *  两条本件自己的不变量（在这里成立，判据也在这一层断）：
+ *   · **格盘必须排满**：`cells.length` 是 7 的倍数、最多 6 行 ⇒ 月首月尾的空位由调用方显式给 `null`，
+ *     本件不替你按日期推算星期（那是日历口径，归调用方）；
+ *   · **缺值的格一律 0 档**：深浅表示量，没有量就没有深浅（`value: null` 时 `level` 被压到 0）。
+ */
+import { assertPlainObject, badInput, optExtraClass, optText, reqText } from '../shared/validate.js';
+import { CALENDAR_MONTH_FORMS, CALENDAR_MONTH_LEVELS, CALENDAR_MONTH_MAX_WEEKS, CALENDAR_MONTH_MISSING, CALENDAR_MONTH_WEEK_LENGTH, CALENDAR_MONTH_WEEKDAYS, } from './attrs.js';
+/** 深浅档：闭集外的数字／非数字一律拒。 */
+function reqLevel(value, field) {
+    if (typeof value !== 'number' || !CALENDAR_MONTH_LEVELS.includes(value)) {
+        badInput(field + ' 必须是 ' + CALENDAR_MONTH_LEVELS.join('／') + ' 之一');
+    }
+    return value;
+}
+/** 星期表头：七枚非空串（少一枚就把七列错位，所以长度是硬约束）。 */
+function reqWeekdays(value) {
+    if (value === undefined)
+        return CALENDAR_MONTH_WEEKDAYS;
+    if (!Array.isArray(value))
+        badInput('calendar-month: input.weekdays 必须是字符串数组');
+    if (value.length !== CALENDAR_MONTH_WEEK_LENGTH) {
+        badInput('calendar-month: input.weekdays 必须恰好 ' + CALENDAR_MONTH_WEEK_LENGTH + ' 枚（一周七格）');
+    }
+    const out = [];
+    for (let i = 0; i < value.length; i += 1)
+        out.push(reqText(value[i], 'calendar-month: input.weekdays[' + i + ']'));
+    return out;
+}
+/** 一格一天：日期必填；读数 `null` ＝ 缺值（写成 `—`，并把深浅压到 0 档）。 */
+function reqDay(raw, field) {
+    assertPlainObject(raw, field);
+    const dayInput = raw;
+    const given = dayInput.value;
+    let shown;
+    let missing;
+    if (given === null) {
+        shown = CALENDAR_MONTH_MISSING;
+        missing = true;
+    }
+    else if (given === undefined) {
+        badInput(field + '.value 必填（缺值请**显式**给 null：写成 ' + CALENDAR_MONTH_MISSING + '）');
+    }
+    else if (typeof given !== 'string') {
+        badInput(field + '.value 必须是字符串或 null（缺值）');
+    }
+    else if (given === '') {
+        badInput(field + '.value 不许给空串：缺值请给 null（写成 ' + CALENDAR_MONTH_MISSING + '）');
+    }
+    else {
+        shown = given;
+        missing = false;
+    }
+    const level = dayInput.level === undefined
+        ? 0
+        : reqLevel(dayInput.level, field + '.level');
+    return {
+        day: reqText(dayInput.day, field + '.day'),
+        value: shown,
+        /* 缺值的格一律 0 档：深浅表示量，没有量就没有深浅（不再要一个"缺值的深浅"概念）。 */
+        level: missing ? 0 : level,
+        missing,
+        today: dayInput.today === true,
+    };
+}
+/** 格盘：7 的倍数、最多 6 行（`null` ＝ 空位）。 */
+function reqCells(value) {
+    if (!Array.isArray(value))
+        badInput('calendar-month: input.cells 必须是数组（一周七格、按行排满）');
+    if (value.length === 0)
+        badInput('calendar-month: input.cells 不许是空数组（没有格盘就没有月历）');
+    if (value.length % CALENDAR_MONTH_WEEK_LENGTH !== 0) {
+        badInput('calendar-month: input.cells 的长度必须是 ' + CALENDAR_MONTH_WEEK_LENGTH + ' 的倍数（一周七格；空位请显式给 null）');
+    }
+    if (value.length > CALENDAR_MONTH_WEEK_LENGTH * CALENDAR_MONTH_MAX_WEEKS) {
+        badInput('calendar-month: input.cells 最多 ' + (CALENDAR_MONTH_WEEK_LENGTH * CALENDAR_MONTH_MAX_WEEKS)
+            + ' 格（' + CALENDAR_MONTH_MAX_WEEKS + ' 行）；再多就不是一个月了');
+    }
+    const out = [];
+    for (let i = 0; i < value.length; i += 1) {
+        const cell = value[i];
+        out.push(cell === null || cell === undefined
+            ? null
+            : reqDay(cell, 'calendar-month: input.cells[' + i + ']'));
+    }
+    return out;
+}
+/** 头部合计位：两枚都要（只有值的合计读不出"这是什么合计"）。 */
+function optSummary(value) {
+    if (value === undefined)
+        return undefined;
+    assertPlainObject(value, 'calendar-month: input.summary');
+    const raw = value;
+    return {
+        label: reqText(raw.label, 'calendar-month: input.summary.label'),
+        value: reqText(raw.value, 'calendar-month: input.summary.value'),
+    };
+}
+/** 图例：逐条收档位与说明（不给＝不出图例）。 */
+function optLegend(value) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value))
+        badInput('calendar-month: input.legend 必须是数组');
+    const out = [];
+    for (let i = 0; i < value.length; i += 1) {
+        const field = 'calendar-month: input.legend[' + i + ']';
+        const item = value[i];
+        assertPlainObject(item, field);
+        const raw = item;
+        out.push({ level: reqLevel(raw.level, field + '.level'), label: reqText(raw.label, field + '.label') });
+    }
+    return out;
+}
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `CalendarMonthModel`，不再自己碰 `any`。 */
+export function normalizeCalendarMonth(input) {
+    assertPlainObject(input, 'renderCalendarMonth: input');
+    const raw = input;
+    const form = raw.form === undefined ? CALENDAR_MONTH_FORMS[0] : raw.form;
+    if (!CALENDAR_MONTH_FORMS.includes(form)) {
+        badInput('calendar-month: input.form 必须是 ' + CALENDAR_MONTH_FORMS.join('／')
+            + ' 之一（本件只落地形态 A「格内数字＋小计＋底部水量条」）');
+    }
+    return {
+        form: form,
+        title: reqText(raw.title, 'calendar-month: input.title'),
+        use: optText(raw.use, 'calendar-month: input.use'),
+        weekdays: reqWeekdays(raw.weekdays),
+        cells: reqCells(raw.cells),
+        summary: optSummary(raw.summary),
+        legend: optLegend(raw.legend),
+        note: optText(raw.note, 'calendar-month: input.note'),
+        extraClass: optExtraClass(raw.extraClass, 'calendar-month: input.extraClass'),
+    };
+}
+//# sourceMappingURL=model.js.map

package/dist/components/calendar-month/model.js.map

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

package/dist/components/calendar-month/render.d.ts

@@ -0,0 +1,3 @@
+/** 渲染月历格（纯函数：同样的入参恒产同样的字节；转义只经 `shared/escape.ts`）。 */
+export declare function renderCalendarMonth(input: unknown): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/components/calendar-month/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/components/calendar-month/render.ts"],"names":[],"mappings":"AAoFA,uDAAuD;AACvD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAK1D"}

package/dist/components/calendar-month/render.js

@@ -0,0 +1,85 @@
+/** calendar-month · **渲染**（纯函数产 HTML；本件只有形态 A「格内数字＋小计＋底部水量条」一种骨架）。
+ *
+ *  —— 形态 A：格内数字＋小计＋底部水量条（带星期表头）——
+ *
+ *  七列一周、一格一天：**星期表头**在最上面，每格自上而下是「日期（今天多一枚『今』字）／
+ *  当天读数（缺值写 `—`）／底部一条小柱**。小柱的高度与深浅一起随档位变 ⇒ 一眼扫过去，
+ *  哪几天多、哪几天少是看得出来的；今天的墨圈 ＋「今」字保证**不只靠颜色**认今天。
+ *
+ *  三条硬口径（判据断的就是它们）：
+ *   · **缺值不写 0**：`value: null` ⇒ 格内写 `—`、档位压到 0（0 是"那天花了 0 元"，两者不是一回事）；
+ *   · **格盘排满**：七列 × 行数，空位是显式的空格（`is-blank`，不出边框与底），错位一格会读成另一天；
+ *   · **窄档不横滑**：格宽是份数（`repeat(7, minmax(0,1fr))`），读数换行不截断（不写 `…`）。
+ */
+import { esc } from '../shared/escape.js';
+import { CALENDAR_MONTH_CLASS, CALENDAR_MONTH_TODAY_MARK, calendarMonthSlot, } from './attrs.js';
+import { normalizeCalendarMonth } from './model.js';
+/** 头部那一排：标题 ＋ 用途 ＋ 合计（合计 `margin-left:auto` 顶到右缘，窄档自己折行）。 */
+function headHtml(m) {
+    const parts = ['<div class="' + calendarMonthSlot('hd') + '">'];
+    parts.push('<b class="' + calendarMonthSlot('title') + '">' + esc(m.title) + '</b>');
+    if (m.use !== undefined)
+        parts.push('<span class="' + calendarMonthSlot('use') + '">' + esc(m.use) + '</span>');
+    if (m.summary !== undefined) {
+        parts.push('<span class="' + calendarMonthSlot('sum') + '">'
+            + '<i class="' + calendarMonthSlot('sum-label') + '">' + esc(m.summary.label) + '</i>'
+            + '<b class="' + calendarMonthSlot('sum-value') + '">' + esc(m.summary.value) + '</b>'
+            + '</span>');
+    }
+    parts.push('</div>');
+    return parts.join('');
+}
+/** 星期表头：七枚 `<span>`（周一起首列；表头缺一枚就整列错位，所以长度在归一化期已钉死）。 */
+function weekdaysHtml(m) {
+    const cells = m.weekdays.map((w) => '<span class="' + calendarMonthSlot('wd') + '">' + esc(w) + '</span>').join('');
+    return '<div class="' + calendarMonthSlot('wk') + '">' + cells + '</div>';
+}
+/** 一格一天。空位（月首月尾）是 `is-blank`：只占位，不出边框与底。 */
+function cellHtml(cell) {
+    if (cell === null)
+        return '<div class="' + calendarMonthSlot('c') + ' is-blank" aria-hidden="true"></div>';
+    const cls = [calendarMonthSlot('c'), 'is-l' + String(cell.level)];
+    if (cell.today)
+        cls.push('is-today');
+    if (cell.missing)
+        cls.push('is-missing');
+    return '<div class="' + cls.join(' ') + '">'
+        + '<span class="' + calendarMonthSlot('d') + '">' + esc(cell.day)
+        + (cell.today ? '<em class="' + calendarMonthSlot('today-mark') + '">' + esc(CALENDAR_MONTH_TODAY_MARK) + '</em>' : '')
+        + '</span>'
+        + '<span class="' + calendarMonthSlot('v') + '">' + esc(cell.value) + '</span>'
+        /* 小柱是读数位的**形状重复**（值已经在格内），对读屏器没有信息 ⇒ aria-hidden。 */
+        + '<i class="' + calendarMonthSlot('bar') + '" aria-hidden="true">'
+        + '<u class="' + calendarMonthSlot('bar-fill') + '"></u></i>'
+        + '</div>';
+}
+/** 深浅图例：色块 ＋ 说明（色块 aria-hidden，说明是字）。 */
+function legendHtml(m) {
+    const items = m.legend.map((it) => '<span><i class="' + calendarMonthSlot('sw') + ' is-l' + String(it.level)
+        + '" aria-hidden="true"></i>' + esc(it.label) + '</span>').join('');
+    return '<div class="' + calendarMonthSlot('lg') + '">' + items + '</div>';
+}
+/** 形态 A 的骨架。 */
+function renderGrid(m) {
+    const parts = [];
+    parts.push(headHtml(m));
+    parts.push(weekdaysHtml(m));
+    parts.push('<div class="' + calendarMonthSlot('grid') + '">' + m.cells.map(cellHtml).join('') + '</div>');
+    if (m.legend.length > 0)
+        parts.push(legendHtml(m));
+    if (m.note !== undefined)
+        parts.push('<p class="' + calendarMonthSlot('note') + '">' + esc(m.note) + '</p>');
+    return parts.join('');
+}
+/** 形态 → 骨架（本件只有一格；分派写在这里，加第二形态就是加一支）。 */
+const SKELETONS = {
+    grid: renderGrid,
+};
+/** 渲染月历格（纯函数：同样的入参恒产同样的字节；转义只经 `shared/escape.ts`）。 */
+export function renderCalendarMonth(input) {
+    const m = normalizeCalendarMonth(input);
+    const extra = m.extraClass === undefined ? '' : ' ' + m.extraClass;
+    return '<div class="' + CALENDAR_MONTH_CLASS + ' is-' + m.form + extra + '">'
+        + SKELETONS[m.form](m) + '</div>';
+}
+//# sourceMappingURL=render.js.map

package/dist/components/calendar-month/render.js.map

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

package/dist/components/calendar-month/style.d.ts

@@ -0,0 +1,14 @@
+/** 格盘自高一档（px）：空位与满格同高，换行不会把某一行压扁。 */
+export declare const CALENDAR_MONTH_CELL_MIN_HEIGHT_PX = 52;
+/** 底部小柱所在的槽高（px）：五档里最高的那档正好填满它。 */
+export declare const CALENDAR_MONTH_BAR_HEIGHT_PX = 10;
+/** 五档的柱高（px）：**档位是形状事实**，所以它是导出的常量而不是散在样式里的字面量。 */
+export declare const CALENDAR_MONTH_LEVEL_HEIGHTS_PX: Readonly<Record<number, number>>;
+/** 窄容器阈值（px）：格内字号与内距收一档，好让 7 位读数（如 `¥12,345`）在 390 档也放得下。
+ *  **这是本件自己的宽度**（`@container` 判的），不是视口宽度。 */
+export declare const CALENDAR_MONTH_NARROW_PX = 560;
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export declare function calendarMonthCss(input?: {
+    readonly prefix?: string;
+}): string;
+//# sourceMappingURL=style.d.ts.map

package/dist/components/calendar-month/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../../src/components/calendar-month/style.ts"],"names":[],"mappings":"AAmBA,qCAAqC;AACrC,eAAO,MAAM,iCAAiC,KAAK,CAAC;AAEpD,mCAAmC;AACnC,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C,mDAAmD;AACnD,eAAO,MAAM,+BAA+B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE3E,CAAC;AAEH;6CAC6C;AAC7C,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAc5C,4BAA4B;AAC5B,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAkO7E"}