base-paint 0.3.13 → 0.3.15

package/dist/components/goal-stairs/style.js

@@ -0,0 +1,321 @@
+/** goal-stairs · **样式段**（本件唯一的样式来源）。
+ *
+ *  纪律（与本层其余件同一份）：
+ *   · 只经 `skinVar()` 读皮肤 —— 组件里**不写** `var(--ilife-…)`（兜底链只许住在 `skin/contract.ts`）；
+ *   · 全部规则 scope 在 `.<prefix>page-ui` 之下、**每条里作用域恰一次**（拼后代／兄弟选择器时只用不带 scope 的裸槽类）；
+ *     不写 `:root`／`!important`、不新增 token 名；
+ *   · **宽度只许容器判**：布局靠 `@container` ＋ 内在尺寸 ＋ `flex-wrap`；本件不写任何 `@media`
+ *     （视口宽 ≠ 组件宽；本件也没有 `transition`／`animation`，故没有什么会卡在半路）。
+ *
+ *  强制的四处口径（判据钉住）：
+ *   · **状态靠形 ＋ 字 ＋ 色三样**：窗口带左侧 2px 侧标（形）＋ 带色（色）＋ 行头的状态字（字）；
+ *     过期那一段另在行头写「来不及 ✕」（字）。**没有一处拿正文墨色当"面"**；
+ *     说清三笔账：**带是无文字的条**（`aria-hidden`，`textContent` 是空的）、**字在行头**，
+ *     字底下没有本件画的底（`.state` 的背景是透明的 ⇒ 它压的是宿主页的底）——判据按「字真压的底」断，
+ *     带子那一层只断「形 ＋ 色」，不冒充文字底；
+ *   · **标签四向都不出轨道**：最晚动手日那枚标签**在流里**（网格项 ＋ 百分比外边距），
+ *     标记落在轴的右半边时改贴右缘长（`is-right`），长日期自己换行、轨道跟着长——
+ *     **不截断、不外溢、上下也不顶出**（绝对定位＋定高轨道时两行日期会上下各顶出 5.8px，实测过）；
+ *   · **今天那根竖线不越界**：位置用 `clamp()` 夹在轨道内 2px（`left: 100%` 时那根 2px 的线
+ *     会顶出轨道右缘，390 档实测过）；上下各让出 2px 是有意的（游标要在带子上看得见）；
+ *   · **几何只用本件自己的自定义属性**（`--goal-stairs-start`／`-end`／`-now`，名字住 `attrs.ts`）——
+ *     先例 `photo-compare` 的 `--photo-compare-split`，不占 `--ilife-*` 那个皮肤命名空间。
+ */
+import { skinVar } from '../skin/contract.js';
+import { GOAL_STAIRS_END_VAR, GOAL_STAIRS_NOW_VAR, GOAL_STAIRS_START_VAR, goalStairsSlot, } from './attrs.js';
+/** 换行（仓库口径：不写字面换行转义）。 */
+const LF = String.fromCharCode(10);
+/** 轨道**最矮**多高（px）：这一段占了多久靠它有一个看得见的盒。
+ *  是地板不是定高——「最晚」那枚标签在流里，日期换行时轨道跟着长（定高会把两行的标签顶出轨道）。 */
+export const GOAL_STAIRS_TRACK_PX = 30;
+/** 今天的竖线与窗口带的侧标同宽（px）：两根竖线一样粗，读者不会把「当前」读成别的意思。 */
+export const GOAL_STAIRS_MARK_PX = 2;
+/** 宽档行头那一列的宽（px）：段名与窗口句在这一列里自己折行，轨道占右边整条。 */
+export const GOAL_STAIRS_HEAD_COLUMN_PX = 200;
+/** 宽档阈值（px）：**容器宽**过了它，行头与轨道并排；不到就上下两行。
+ *  判的是本件自己的宽度（`@container`），不是视口宽度——本件会被嵌进侧栏／面板／卡片里。 */
+export const GOAL_STAIRS_WIDE_PX = 620;
+/** 窄档的上界（px）＝宽档阈值 − 1：`@container` 那一支判的是它。
+ *
+ *  为什么写窄档这一支、而不是写「宽档那一支」：本层既有件一律**缺省＝宽档 ＋ `@container (max-width:)`
+ *  换窄档**（先例 `scatter-fit` 的 460／`cash-waterline` 的 620）。两条渲染结果逐像素等价，
+ *  但性质不同：缺省那一份是**完整的一份版式**，容器查询只是把窄档换上去——反过来写的话，
+ *  凡是没有容器查询生效的环境（老页面、被别的容器捕捉、打印）就只剩「窄档那一支」。 */
+export const GOAL_STAIRS_NARROW_MAX_PX = GOAL_STAIRS_WIDE_PX - 1;
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export function goalStairsCss(input) {
+    const p = input !== undefined && input !== null
+        && typeof input.prefix === 'string' && input.prefix !== '' ? input.prefix : 'ilife-';
+    const root = '.' + p + 'page-ui';
+    const box = root + ' .' + p + 'block-goal-stairs';
+    /* 槽类名（**不带 scope**）：只用在已经落进本件某条选择器内部的位置（前缀由外层那条选择器给）。
+       拿带 scope 的完整选择器去拼后代选择器，会拼出 `.page-ui .a .page-ui .b` —— 第二条 `.page-ui`
+       永远匹配不到，规则「看着在、其实不生效」。 */
+    const c = (slot) => '.' + goalStairsSlot(slot, p);
+    /** 带 scope 的完整选择器（一条规则打头用）。 */
+    const s = (slot) => root + ' ' + c(slot);
+    return [
+        '/* goal-stairs（目标阶梯 · 形态 C「倒推日程：每段最晚何时动手」）：一段一行，',
+        '   行头说这一段是什么与最晚哪天动手，轨道把这一段在整段日程上占了哪一截画出来。',
+        '   层次不靠阴影与大圆角（小票纸零阴影、大字报刊零圆角）：靠发丝线、侧标与字重 ⇒ 换皮只换取值。 */',
+        box + ' {',
+        /* 宽度判据的落点：本件是**自己的容器**——嵌进侧栏／面板／卡片时照样按自己的宽度折行。 */
+        '  container-type: inline-size;',
+        /* 宿主页不保证是 `border-box`：本件有「百分比定位 ＋ 2px 侧标」的轨道，
+           在默认 content-box 下自己会算宽，故在**自己的子树里**钉成 border-box。 */
+        '  box-sizing: border-box;',
+        '  display: grid;',
+        '  gap: 10px;',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font') + ';',
+        '  font-size: ' + skinVar('fs-body') + ';',
+        '  line-height: 1.5;',
+        '}',
+        box + ' * {',
+        '  box-sizing: border-box;',
+        '}',
+        /* ── 卡头 ───────────────────────────────────────────────────────── */
+        s('hd') + ' {',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  align-items: baseline;',
+        '  gap: 4px 10px;',
+        '  min-width: 0;',
+        '}',
+        s('title') + ' {',
+        '  margin: 0;',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font-display') + ';',
+        '  font-size: ' + skinVar('fs-h3') + ';',
+        '  font-weight: 700;',
+        '  line-height: 1.3;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* 段数那枚：**算出来的**（调用方给不出错的段数）。字是件里自己的短词，故可以 `nowrap`。 */',
+        s('count') + ' {',
+        '  flex: none;',
+        '  padding: 2px 8px;',
+        '  border: 1px solid ' + skinVar('line') + ';',
+        '  border-radius: ' + skinVar('radius-pill') + ';',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  font-weight: 700;',
+        '  letter-spacing: .04em;',
+        '  white-space: nowrap;',
+        '}',
+        '/* 右端那句（`竖线＝今天 09-24`）**分两枚**：前两枚字固定不折，日期自己是调用方的串，',
+        '   长了就在自己那段里换行——不截断、也不把前面那句挤散。 */',
+        s('tail') + ' {',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  align-items: baseline;',
+        '  gap: 4px;',
+        '  margin-left: auto;',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  font-weight: 600;',
+        '}',
+        s('tail-lead') + ' {',
+        '  flex: none;',
+        '  white-space: nowrap;',
+        '}',
+        s('tail-day') + ' {',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font-num') + ';',
+        '  font-variant-numeric: tabular-nums;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        /* ── 逐段那张表 ─────────────────────────────────────────────────── */
+        s('rows') + ' {',
+        '  display: grid;',
+        '  gap: 0;',
+        '  margin: 0;',
+        '  padding: 0;',
+        '  min-width: 0;',
+        '  list-style: none;',
+        '}',
+        '/* 缺省＝宽档：行头那一列（`GOAL_STAIRS_HEAD_COLUMN_PX`）与轨道并排，一段一行读得下更多段。',
+        '   窄容器（本件自己的宽度 ≤ `GOAL_STAIRS_WIDE_PX − 1`）换成上下两行，见文件末的 `@container`。',
+        '   判的是**本件自己的宽度**：本件会被嵌进侧栏／面板／卡片，视口宽 ≠ 组件宽。 */',
+        s('row') + ' {',
+        '  display: grid;',
+        '  grid-template-columns: ' + String(GOAL_STAIRS_HEAD_COLUMN_PX) + 'px minmax(0, 1fr);',
+        '  gap: 6px 12px;',
+        '  align-items: center;',
+        '  padding: 12px 0;',
+        '  min-width: 0;',
+        '}',
+        '/* 行与行之间一条发丝线（零阴影下靠它分家）。 */',
+        s('row') + ' + ' + c('row') + ' {',
+        '  border-top: 1px solid ' + skinVar('line') + ';',
+        '}',
+        s('head') + ' {',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  align-items: baseline;',
+        '  gap: 6px 12px;',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-size: ' + skinVar('fs-sm') + ';',
+        '  font-weight: 600;',
+        '}',
+        s('name') + ' {',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-size: ' + skinVar('fs-body') + ';',
+        '  font-weight: 700;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        s('window') + ' {',
+        '  min-width: 0;',
+        '  font-family: ' + skinVar('font-num') + ';',
+        '  font-variant-numeric: tabular-nums;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* 过期点名：窗口整段落在今天左边、这一段又没达成时才出这一枚（字，不只靠颜色）。 */',
+        s('late') + ' {',
+        '  flex: none;',
+        '  color: ' + skinVar('danger') + ';',
+        '  font-size: ' + skinVar('fs-sm') + ';',
+        '  font-weight: 700;',
+        '  white-space: nowrap;',
+        '}',
+        '/* 状态字顶到右缘（`margin-left: auto`）：段名再长也压不到它——压窄就自己折到下一行。 */',
+        s('state') + ' {',
+        '  flex: none;',
+        '  margin-left: auto;',
+        '  font-size: ' + skinVar('fs-sm') + ';',
+        '  font-weight: 700;',
+        '  white-space: nowrap;',
+        '}',
+        '/* 三档状态色都是**文字**用的档（`accent-text` 是强调色的文本档）：',
+        '   色只是三样里的第三样，字（已达成 ✓／进行中 ▶／还没开始 ○）与侧标才是主路径。 */',
+        s('state') + '.is-done {',
+        '  color: ' + skinVar('ok') + ';',
+        '}',
+        s('state') + '.is-now {',
+        '  color: ' + skinVar('accent-text') + ';',
+        '}',
+        s('state') + '.is-plan {',
+        '  color: ' + skinVar('ink-2') + ';',
+        '}',
+        /* ── 轨道 ───────────────────────────────────────────────────────── */
+        '/* 轨道：`min-height` 不是 `height`——那枚「最晚」标签是**在流里**的（见下一条），',
+        '   日期一长它自己换行，轨道跟着长；写死高度就会把换行的标签顶出轨道上下两端。',
+        '   轨道本身是 grid ＋ `align-content: center`：标签单行时与缺省高一样居中。 */',
+        s('track') + ' {',
+        '  position: relative;',
+        '  display: grid;',
+        '  align-content: center;',
+        '  min-height: ' + String(GOAL_STAIRS_TRACK_PX) + 'px;',
+        '  min-width: 0;',
+        '  border: 1px solid ' + skinVar('line') + ';',
+        '  border-radius: ' + skinVar('radius-sm') + ';',
+        '}',
+        '/* 窗口带（**无文字的条**，且是 `aria-hidden`：这一段在整段日程上占了哪一截，字形全在行头）。',
+        '   左右两端都用百分比夹在轨道里，故任何入参下都不会比轨道宽。',
+        '   **侧标画成 `inset` 投影、不画成边框**：边框会把盒宽顶到「两边框之和」那 2px 的下限——',
+        '   窗口只有 0.01% 宽时那 2px 会把右端顶出轨道（320／390／620／1280 实测各 +0.59…0.95px，',
+        '   件根当场 `scrollWidth = clientWidth + 1`）。投影不占盒。 */',
+        s('band') + ' {',
+        '  position: absolute;',
+        '  top: 0;',
+        '  bottom: 0;',
+        '  left: var(' + GOAL_STAIRS_START_VAR + ');',
+        '  right: calc(100% - var(' + GOAL_STAIRS_END_VAR + '));',
+        '  border-radius: ' + skinVar('radius-sm') + ';',
+        '  background: none;',
+        '  box-shadow: none;',
+        '}',
+        '/* 还没开始的段：次要面（`surface-2` 的定义就是软底块），不带侧标——它是缺省档，不是被点名的那一档。 */',
+        s('band') + '.is-plan {',
+        '  background: ' + skinVar('surface-2') + ';',
+        '}',
+        '/* 进行中：强调色的淡洗 ＋ 2px 强调侧标（形）。 */',
+        s('band') + '.is-now {',
+        '  background: color-mix(in srgb, ' + skinVar('accent') + ' 16%, ' + skinVar('surface') + ');',
+        '  box-shadow: inset ' + String(GOAL_STAIRS_MARK_PX) + 'px 0 0 ' + skinVar('accent') + ';',
+        '}',
+        '/* 已达成：语义档走 `ok`（达标），不借强调色。 */',
+        s('band') + '.is-done {',
+        '  background: color-mix(in srgb, ' + skinVar('ok') + ' 16%, ' + skinVar('surface') + ');',
+        '  box-shadow: inset ' + String(GOAL_STAIRS_MARK_PX) + 'px 0 0 ' + skinVar('ok') + ';',
+        '}',
+        '/* 过期且未达成：语义档走 `danger`（写在这一条最后，压过 `is-now`／`is-plan`）。 */',
+        s('band') + '.is-late {',
+        '  background: color-mix(in srgb, ' + skinVar('danger') + ' 16%, ' + skinVar('surface') + ');',
+        '  box-shadow: inset ' + String(GOAL_STAIRS_MARK_PX) + 'px 0 0 ' + skinVar('danger') + ';',
+        '}',
+        '/* 今天那根竖线（**纯装饰**：今天是哪天由卡头的字说）。位置夹在轨道内：标记落在 0% 或 100% 时',
+        '   也留得下这 ' + String(GOAL_STAIRS_MARK_PX) + 'px，不顶出轨道右缘。',
+        '   上下各让出 2px 是**有意的**（游标要在带子与轨道边上都看得见；带子只与轨道同高）。 */',
+        s('today') + ' {',
+        '  position: absolute;',
+        '  top: -2px;',
+        '  bottom: -2px;',
+        '  width: ' + String(GOAL_STAIRS_MARK_PX) + 'px;',
+        '  left: clamp(0px, calc(var(' + GOAL_STAIRS_NOW_VAR + ') - 1px), calc(100% - '
+            + String(GOAL_STAIRS_MARK_PX) + 'px));',
+        '  background: ' + skinVar('accent') + ';',
+        '  border-radius: ' + skinVar('radius-pill') + ';',
+        '}',
+        '/* 最晚动手日那枚标签（**有字，真读**）：**在流里**的网格项，位置靠百分比外边距（外边距的百分比',
+        '   按轨道宽算），不是绝对定位——绝对定位＋定高轨道，两行的日期就会上下顶出轨道各 5.8px；',
+        '   在流里则轨道跟着长（`min-height` 只是地板），上下左右四向都不越界。',
+        '   标记落在轴的左半边：从标记往右长（`margin-left`）；右半边（`.is-right`）：贴右缘往左长。',
+        '   日期太长时它自己换行（`overflow-wrap: anywhere`）：**不截断、不外溢**。',
+        '   `z-index` 是为了压在窗口带上面（带子是定位元素，在流里的内容默认被它盖住）。 */',
+        s('due') + ' {',
+        '  position: relative;',
+        '  z-index: 1;',
+        '  justify-self: start;',
+        '  margin-left: calc(var(' + GOAL_STAIRS_START_VAR + ') + 4px);',
+        '  padding: 0 6px;',
+        '  border-radius: ' + skinVar('radius-sm') + ';',
+        '  background: ' + skinVar('surface') + ';',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font-num') + ';',
+        '  font-size: ' + skinVar('fs-sm') + ';',
+        '  font-weight: 700;',
+        '  line-height: 1.6;',
+        '  font-variant-numeric: tabular-nums;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        s('track') + '.is-right > ' + c('due') + ' {',
+        '  justify-self: end;',
+        '  margin-left: 0;',
+        '  margin-right: calc(100% - var(' + GOAL_STAIRS_START_VAR + ') + 4px);',
+        '}',
+        /* ── 口径行 ─────────────────────────────────────────────────────── */
+        s('note') + ' {',
+        '  margin: 0;',
+        '  padding-top: 8px;',
+        '  border-top: 1px solid ' + skinVar('line') + ';',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  line-height: 1.7;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* 本件自身不带可点元素。这一条是**地板**：调用方若把段名或口径行包成链接，',
+        '   焦点必须看得见——不许只写 `outline:none` 而不给替代。 */',
+        box + ' :focus-visible {',
+        '  outline: 2px solid ' + skinVar('accent') + ';',
+        '  outline-offset: 2px;',
+        '}',
+        '/* 窄档（本件自己的宽度 ≤ `GOAL_STAIRS_NARROW_MAX_PX`＝宽档阈值 − 1）：行头在上、轨道在下。',
+        '   写 `max-width` 不写 `min-width` 是**本层既有的写法**（先例 `scatter-fit`／`cash-waterline`）：',
+        '   缺省那一份是宽档，容器查询只负责把窄档那一支换上去；这样件在任何没挂容器查询的环境里',
+        '   也照样是完整的一份版式，不会只剩「窄档那一支」。 */',
+        '@container (max-width: ' + String(GOAL_STAIRS_NARROW_MAX_PX) + 'px) {',
+        '  ' + s('row') + ' {',
+        '    grid-template-columns: minmax(0, 1fr);',
+        '    gap: 6px;',
+        '  }',
+        '}',
+    ].join(LF);
+}

package/dist/components/goal-stairs/style.js.map

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

package/dist/components/heat-grid/attrs.d.ts

@@ -0,0 +1,72 @@
+/** heat-grid · **标记契约**（渲染与调用方共用的唯一事实：类名／形态闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-04-形状与比例.mjs`，2026-09 用户裁定）
+ *  里的**形态 A「行时段 × 列星期 ＋ 峰值符号」**——每一格是一个（行 × 列）的读数，
+ *  格子的深浅表示量的大小，**带一档色键**（深浅不是唯一信息：色键给数字区间、峰值格带 ▲、
+ *  右侧读数给数字）。
+ *
+ *  形态键写在 `HEAT_GRID_FORMS`（闭集）：本件只有一格，但键必须存在——
+ *  「形态是骨架，不是地址」，日后加第二形态是在闭集里加一格，不是新开一件。
+ *  闭集外的值一律 `badInput`（不静默降级：降级会让调用方以为自己拿到了另一种骨架）。
+ */
+/** 本件的类名根：全部槽位类名都是 `HEAT_GRID_CLASS + '-' + 槽名`。 */
+export declare const HEAT_GRID_CLASS = "ilife-block-heat-grid";
+/** 槽位闭集（标记契约的一部分：`render.ts`、`style.ts` 与判据都用这里的名字拼类名，不各抄一份字面量）。 */
+export declare const HEAT_GRID_SLOTS: readonly ["hd", "title", "stamp", "gridbox", "grid", "corner", "col-head", "row-label", "cell", "peak-mark", "rank", "rank-item", "rank-label", "rank-value", "rank-sub", "key", "key-end", "key-item", "swatch", "note"];
+export type HeatGridSlot = (typeof HEAT_GRID_SLOTS)[number];
+/** 槽类的类名（唯一拼法：别处不许再写 `HEAT_GRID_CLASS + '-' + …`）。 */
+export declare function heatGridSlot(slot: HeatGridSlot, prefix?: string): string;
+/** 形态闭集：本件只落地了形态 A「行时段 × 列星期」。 */
+export declare const HEAT_GRID_FORMS: readonly ["matrix"];
+export type HeatGridForm = (typeof HEAT_GRID_FORMS)[number];
+/** 列维度永远是**一周七天**（「列星期」是这一件的形状，不是配置项）。 */
+export declare const HEAT_GRID_COLUMNS = 7;
+/** 缺省列头（周一…周日）。 */
+export declare const HEAT_GRID_WEEKDAYS: readonly ["周一", "周二", "周三", "周四", "周五", "周六", "周日"];
+/** 色阶档数：`is-l0`…`is-l4`（5 档）。 */
+export declare const HEAT_GRID_LEVEL_COUNT = 5;
+/** 缺省分档（**上界闭区间**）：0 ⇒ `l0`；1–2 ⇒ `l1`；3–4 ⇒ `l2`；5–6 ⇒ `l3`；7 以上 ⇒ `l4`。
+ *  色键上那几段数字区间就是从这里算出来的 —— 色键与实际着色**同一份真值**。 */
+export declare const HEAT_GRID_LEVEL_STOPS: readonly [2, 4, 6];
+/** 峰值格里那枚符号（纯装饰的第二次提醒：颜色／深浅之外还有形）。 */
+export declare const HEAT_GRID_PEAK_MARK = "\u25B2";
+/** 缺值的写法：**缺值写成 `—`，不许写 0、不许留空**（全仓同一条地板）。 */
+export declare const HEAT_GRID_MISSING = "\u2014";
+/** 一行：行标签 ＋ 恰好七个数（一周七天，顺序与 `weekdays` 对齐）。 */
+export interface HeatGridRow {
+    /** 行标签（如「00–04」「第 1 周」）；**永不换行、永不截断**。 */
+    readonly label: string;
+    /** 这一行七格的读数（与 `weekdays` 逐列对齐）；必须都是 ≥ 0 的有限数。 */
+    readonly values: readonly number[];
+}
+/** 右侧读数的一行：名字 ＋ 值（已经是给人看的样子的串）＋ 可选脚注。 */
+export interface HeatGridFact {
+    readonly label: string;
+    readonly value: string;
+    /** 这一格怎么算的（弱文字，可换行）；不给＝不出。 */
+    readonly sub?: string;
+}
+/** 热力格入参。`title`／`rows` 必填——**没有二维就没有热力格**（一行量级走 `scale-bar`）。 */
+export interface HeatGridInput {
+    /** 卡头标题（如「作息 · 一周」）。 */
+    readonly title: string;
+    /** 卡头右端那句（如「3 月 9–15 日」「单位：条」）；不给＝不出。 */
+    readonly stamp?: string;
+    /** 读数单位（`条`／`千卡`／`次`）：色键的数字区间要用它；不给＝区间只有数字。 */
+    readonly unit?: string;
+    /** 各行（至少一行、至多 12 行；每行恰好 7 个数）。 */
+    readonly rows: readonly HeatGridRow[];
+    /** 列头（**恰好七枚**，顺序对齐周一…周日）；不给＝缺省「周一…周日」。 */
+    readonly weekdays?: readonly string[];
+    /** 分档上界（**恰好三个**、严格递增的非负整数）：改它就把色键的区间一起改了。 */
+    readonly levelStops?: readonly number[];
+    /** 右侧读数（合计／峰值／最忙那一格）；不给＝不出那一列。 */
+    readonly facts?: readonly HeatGridFact[];
+    /** 脚注一句人话；不给＝不出。 */
+    readonly note?: string;
+    /** 形态键（闭集，缺省 `matrix`）。 */
+    readonly form?: HeatGridForm;
+    /** 附加类名（空格分隔；逐个过类名正则）。 */
+    readonly extraClass?: string;
+}
+//# sourceMappingURL=attrs.d.ts.map

package/dist/components/heat-grid/attrs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.d.ts","sourceRoot":"","sources":["../../../src/components/heat-grid/attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,oDAAoD;AACpD,eAAO,MAAM,eAAe,0BAA0B,CAAC;AAEvD,oEAAoE;AACpE,eAAO,MAAM,eAAe,2NAyClB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,SAAW,GAAG,MAAM,CAE1E;AAED,kCAAkC;AAClC,eAAO,MAAM,eAAe,qBAAsB,CAAC;AACnD,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,0CAA0C;AAC1C,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,mBAAmB;AACnB,eAAO,MAAM,kBAAkB,qDAAsD,CAAC;AAEtF,iCAAiC;AACjC,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC;+CAC+C;AAC/C,eAAO,MAAM,qBAAqB,oBAAqB,CAAC;AAExD,sCAAsC;AACtC,eAAO,MAAM,mBAAmB,WAAM,CAAC;AAEvC,8CAA8C;AAC9C,eAAO,MAAM,iBAAiB,WAAM,CAAC;AAErC,8CAA8C;AAC9C,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,yCAAyC;AACzC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,CAAC;IACtC,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,kCAAkC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,oBAAoB;IACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,0BAA0B;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B"}

package/dist/components/heat-grid/attrs.js

@@ -0,0 +1,75 @@
+/** heat-grid · **标记契约**（渲染与调用方共用的唯一事实：类名／形态闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-04-形状与比例.mjs`，2026-09 用户裁定）
+ *  里的**形态 A「行时段 × 列星期 ＋ 峰值符号」**——每一格是一个（行 × 列）的读数，
+ *  格子的深浅表示量的大小，**带一档色键**（深浅不是唯一信息：色键给数字区间、峰值格带 ▲、
+ *  右侧读数给数字）。
+ *
+ *  形态键写在 `HEAT_GRID_FORMS`（闭集）：本件只有一格，但键必须存在——
+ *  「形态是骨架，不是地址」，日后加第二形态是在闭集里加一格，不是新开一件。
+ *  闭集外的值一律 `badInput`（不静默降级：降级会让调用方以为自己拿到了另一种骨架）。
+ */
+/** 本件的类名根：全部槽位类名都是 `HEAT_GRID_CLASS + '-' + 槽名`。 */
+export const HEAT_GRID_CLASS = 'ilife-block-heat-grid';
+/** 槽位闭集（标记契约的一部分：`render.ts`、`style.ts` 与判据都用这里的名字拼类名，不各抄一份字面量）。 */
+export const HEAT_GRID_SLOTS = [
+    /** 卡头那一排：标题 ＋ 右侧口径。 */
+    'hd',
+    /** 卡头标题（如「作息 · 一周」）。 */
+    'title',
+    /** 卡头右端那句（时间窗／单位），可换行。 */
+    'stamp',
+    /** 网格与右侧读数并成的那一排（容器窄时自己折行）。 */
+    'gridbox',
+    /** 二维网格本身（`role="img"`，行 × 列）。 */
+    'grid',
+    /** 左上角那格（列头之前的位置，空着）。 */
+    'corner',
+    /** 列头（星期）。 */
+    'col-head',
+    /** 行标签（时段／周次／月份）——**永不换行、永不截断**（它是这一行的坐标）。 */
+    'row-label',
+    /** 一格（深浅由 `is-l0`…`is-l4` 给）。 */
+    'cell',
+    /** 峰值格里那枚符号（▲）：深浅之外的第二条信息。 */
+    'peak-mark',
+    /** 右侧读数（数字：合计／峰值／最忙那一格）。 */
+    'rank',
+    /** 右侧读数的一行。 */
+    'rank-item',
+    /** 读数行的名字（可换行）。 */
+    'rank-label',
+    /** 读数行的值（数字，永不换行、永不截断）。 */
+    'rank-value',
+    /** 读数行的脚注（那一格怎么算的）。 */
+    'rank-sub',
+    /** 色键（**必带**：深浅不能是唯一信息）。 */
+    'key',
+    /** 色键两端那两个字（少／多）。 */
+    'key-end',
+    /** 色键的一项（色块 ＋ 数字区间）。 */
+    'key-item',
+    /** 色键里的色块（纯装饰：区间文字就在右边）。 */
+    'swatch',
+    /** 脚注一句人话。 */
+    'note',
+];
+/** 槽类的类名（唯一拼法：别处不许再写 `HEAT_GRID_CLASS + '-' + …`）。 */
+export function heatGridSlot(slot, prefix = 'ilife-') {
+    return prefix + 'block-heat-grid-' + slot;
+}
+/** 形态闭集：本件只落地了形态 A「行时段 × 列星期」。 */
+export const HEAT_GRID_FORMS = ['matrix'];
+/** 列维度永远是**一周七天**（「列星期」是这一件的形状，不是配置项）。 */
+export const HEAT_GRID_COLUMNS = 7;
+/** 缺省列头（周一…周日）。 */
+export const HEAT_GRID_WEEKDAYS = ['周一', '周二', '周三', '周四', '周五', '周六', '周日'];
+/** 色阶档数：`is-l0`…`is-l4`（5 档）。 */
+export const HEAT_GRID_LEVEL_COUNT = 5;
+/** 缺省分档（**上界闭区间**）：0 ⇒ `l0`；1–2 ⇒ `l1`；3–4 ⇒ `l2`；5–6 ⇒ `l3`；7 以上 ⇒ `l4`。
+ *  色键上那几段数字区间就是从这里算出来的 —— 色键与实际着色**同一份真值**。 */
+export const HEAT_GRID_LEVEL_STOPS = [2, 4, 6];
+/** 峰值格里那枚符号（纯装饰的第二次提醒：颜色／深浅之外还有形）。 */
+export const HEAT_GRID_PEAK_MARK = '▲';
+/** 缺值的写法：**缺值写成 `—`，不许写 0、不许留空**（全仓同一条地板）。 */
+export const HEAT_GRID_MISSING = '—';

package/dist/components/heat-grid/attrs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.js","sourceRoot":"","sources":["../../../src/components/heat-grid/attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,oDAAoD;AACpD,MAAM,CAAC,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAEvD,oEAAoE;AACpE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,uBAAuB;IACvB,IAAI;IACJ,wBAAwB;IACxB,OAAO;IACP,0BAA0B;IAC1B,OAAO;IACP,+BAA+B;IAC/B,SAAS;IACT,kCAAkC;IAClC,MAAM;IACN,yBAAyB;IACzB,QAAQ;IACR,cAAc;IACd,UAAU;IACV,8CAA8C;IAC9C,WAAW;IACX,iCAAiC;IACjC,MAAM;IACN,8BAA8B;IAC9B,WAAW;IACX,4BAA4B;IAC5B,MAAM;IACN,eAAe;IACf,WAAW;IACX,mBAAmB;IACnB,YAAY;IACZ,2BAA2B;IAC3B,YAAY;IACZ,uBAAuB;IACvB,UAAU;IACV,4BAA4B;IAC5B,KAAK;IACL,qBAAqB;IACrB,SAAS;IACT,wBAAwB;IACxB,UAAU;IACV,4BAA4B;IAC5B,QAAQ;IACR,cAAc;IACd,MAAM;CACE,CAAC;AAGX,sDAAsD;AACtD,MAAM,UAAU,YAAY,CAAC,IAAkB,EAAE,MAAM,GAAG,QAAQ;IAChE,OAAO,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAAC;AAC5C,CAAC;AAED,kCAAkC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAQ,CAAU,CAAC;AAGnD,0CAA0C;AAC1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAEnC,mBAAmB;AACnB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAEtF,iCAAiC;AACjC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEvC;+CAC+C;AAC/C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAU,CAAC;AAExD,sCAAsC;AACtC,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEvC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC"}

package/dist/components/heat-grid/index.d.ts

@@ -0,0 +1,15 @@
+/** heat-grid · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  六件出口：`renderHeatGrid(input)`（产标记，零 DOM）／`heatGridCss()`（样式段）／
+ *  `heatGridLevel(value, stops)`（**唯一的着色函数**：值 → 色档，色键与格子共用它）／
+ *  `HEAT_GRID_FORMS`（形态闭集）／`HEAT_GRID_CLASS` 与 `heatGridSlot()`（标记契约）／
+ *  `HEAT_GRID_LEVEL_STOPS`（缺省分档上界 —— 色键上那几段数字区间就从它算出来）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ */
+export { renderHeatGrid } from './render.js';
+export type { HeatGridFact, HeatGridForm, HeatGridInput, HeatGridRow, HeatGridSlot } from './attrs.js';
+export { HEAT_GRID_CLASS, HEAT_GRID_COLUMNS, HEAT_GRID_FORMS, HEAT_GRID_LEVEL_COUNT, HEAT_GRID_LEVEL_STOPS, HEAT_GRID_MISSING, HEAT_GRID_PEAK_MARK, HEAT_GRID_SLOTS, HEAT_GRID_WEEKDAYS, heatGridSlot, } from './attrs.js';
+export { HEAT_GRID_ROW_PX, heatGridCss } from './style.js';
+export { heatGridLevel } from './model.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/heat-grid/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/heat-grid/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACvG,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/heat-grid/index.js

@@ -0,0 +1,13 @@
+/** heat-grid · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  六件出口：`renderHeatGrid(input)`（产标记，零 DOM）／`heatGridCss()`（样式段）／
+ *  `heatGridLevel(value, stops)`（**唯一的着色函数**：值 → 色档，色键与格子共用它）／
+ *  `HEAT_GRID_FORMS`（形态闭集）／`HEAT_GRID_CLASS` 与 `heatGridSlot()`（标记契约）／
+ *  `HEAT_GRID_LEVEL_STOPS`（缺省分档上界 —— 色键上那几段数字区间就从它算出来）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ */
+export { renderHeatGrid } from './render.js';
+export { HEAT_GRID_CLASS, HEAT_GRID_COLUMNS, HEAT_GRID_FORMS, HEAT_GRID_LEVEL_COUNT, HEAT_GRID_LEVEL_STOPS, HEAT_GRID_MISSING, HEAT_GRID_PEAK_MARK, HEAT_GRID_SLOTS, HEAT_GRID_WEEKDAYS, heatGridSlot, } from './attrs.js';
+export { HEAT_GRID_ROW_PX, heatGridCss } from './style.js';
+export { heatGridLevel } from './model.js';

package/dist/components/heat-grid/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/heat-grid/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/heat-grid/model.d.ts

@@ -0,0 +1,41 @@
+import { type HeatGridFact, type HeatGridForm } from './attrs.js';
+/** 一格：值 ＋ 色档 ＋ 是不是峰值。 */
+export interface HeatGridCellModel {
+    readonly value: number;
+    /** 色档 0…4（＝ `is-l<n>` 的 n）。 */
+    readonly level: number;
+    readonly peak: boolean;
+}
+/** 一行：行标签 ＋ 七格。 */
+export interface HeatGridRowModel {
+    readonly label: string;
+    readonly cells: readonly HeatGridCellModel[];
+}
+/** 色键的一项：色档 ＋ 它的数字区间（**色键就是从这里出的，不许另一处再写一套区间**）。 */
+export interface HeatGridKeyItemModel {
+    readonly level: number;
+    readonly text: string;
+}
+/** 内部类型：每个字段都已校验、已归一、已算好（`render.ts` 只负责拼标记）。 */
+export interface HeatGridModel {
+    readonly form: HeatGridForm;
+    readonly title: string;
+    readonly stamp?: string;
+    readonly unit?: string;
+    readonly weekdays: readonly string[];
+    readonly rows: readonly HeatGridRowModel[];
+    readonly keyItems: readonly HeatGridKeyItemModel[];
+    readonly facts: readonly HeatGridFact[];
+    readonly note?: string;
+    /** 峰值（全网格最大值，0 表示"没有峰值"——全零不点峰值符号）。 */
+    readonly max: number;
+    /** 无障碍名（写给读屏的那一句：标题 ＋ 合计 ＋ 峰值那一格）。 */
+    readonly ariaLabel: string;
+    readonly extraClass?: string;
+}
+/** **本件唯一的着色函数**：值 → 色档 0…4（上界闭区间；`stops` 是三个递增上界）。
+ *  色键上那几段区间与格子的深浅都由它决定 ⇒ 读者按色键数格子一定数得对。 */
+export declare function heatGridLevel(value: number, stops?: readonly number[]): number;
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `HeatGridModel`，不再自己碰 `any`。 */
+export declare function normalizeHeatGrid(input: unknown): HeatGridModel;
+//# sourceMappingURL=model.d.ts.map

package/dist/components/heat-grid/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/components/heat-grid/model.ts"],"names":[],"mappings":"AAWA,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,YAAY,EAElB,MAAM,YAAY,CAAC;AAEpB,yBAAyB;AACzB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,mBAAmB;AACnB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC9C;AAED,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;2CAC2C;AAC3C,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,SAAS,MAAM,EAA0B,GAAG,MAAM,CAMrG;AAmFD,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CA0E/D"}