base-paint 0.3.13 → 0.3.15

package/dist/components/popover-menu/style.js

@@ -0,0 +1,92 @@
+/** popover-menu · **样式段**（本件唯一的样式来源）。
+ *
+ *  纪律与同族两件同一套：皮肤只经 `skinVar()` 读／scope 在 `.<prefix>page-ui` 之下／
+ *  **一条 `box-shadow` 都不写**（零阴影皮肤下浮面照样立得住：**粗边 ＋ 外圈晕 ＋ 顶层**）。
+ *
+ *  定位两道（票面钉死的降级路）：
+ *   · **@supports (anchor-name: --a) 之内**：CSS 锚定定位——`position-area: bottom span-left`
+ *     （贴右档）／`bottom span-right`（贴左档），`position-try-fallbacks: flip-block, flip-inline`
+ *     在贴不下时翻到上方／另一侧；
+ *   · **之外**：退回普通定位元素（`position: fixed; inset: auto` ＋ 触发键旁那点边距），
+ *     打开时由运行时按触发键的矩形算 `left`／`top`（这一点写在 `runtime.ts` 的行为契约里）。
+ *  两条能力查询串与运行时**读同一份常量**（`MENU_ANCHOR_QUERY`／`MENU_AREA_QUERY`）：
+ *  CSS 与脚本对「这个引擎支不支持」必须说同一件事。
+ */
+import { skinVar } from '../skin/index.js';
+import { MENU_ANCHOR_QUERY, MENU_AREA_QUERY, MENU_EDGE_PX, MENU_GAP_PX, MENU_MAX_HEIGHT_PX, MENU_MIN_HEIGHT_PX, MENU_OFFSET_PX, MENU_WIDTH_PX, menuClass, menuSlot, } from './attrs.js';
+/** 本组件的样式段。 */
+export function popoverMenuCss(input) {
+    const p = input !== undefined && input !== null && typeof input.prefix === 'string' && input.prefix !== ''
+        ? input.prefix : 'ilife-';
+    const root = '.' + p + 'page-ui';
+    const c = menuClass(p);
+    const slot = (name) => '.' + menuSlot(name, p);
+    const edge = 'color-mix(in srgb, ' + skinVar('ink') + ' 30%, ' + skinVar('line') + ')';
+    const halo = 'color-mix(in srgb, ' + skinVar('ink') + ' 9%, transparent)';
+    const min = String(MENU_MIN_HEIGHT_PX) + 'px';
+    const gap = String(MENU_GAP_PX) + 'px';
+    const side = String(MENU_EDGE_PX) + 'px';
+    const offset = String(MENU_OFFSET_PX) + 'px';
+    const panel = root + ' ' + slot('panel');
+    return [
+        '/* popover-menu（浮出菜单 · 形态 A 贴着按钮）：popover ＋ role=menu；零 box-shadow。 */',
+        '/* 层次：粗边 ＋ 外圈晕 ＋ 顶层（`popover` 的顶层是浏览器给的，不靠任何投影）。 */',
+        root + ' ' + '.' + c + '{position:relative;display:inline-flex}',
+        root + ' ' + slot('trigger') + '{display:inline-flex;align-items:center;gap:6px;box-sizing:border-box;',
+        '  min-height:' + min + ';padding:0 14px;border:2px solid ' + edge + ';',
+        '  border-radius:' + skinVar('radius-sm') + ';background:' + skinVar('surface') + ';',
+        '  color:' + skinVar('accent-text') + ';font:600 ' + skinVar('fs-sm') + '/1.15 ' + skinVar('font') + ';',
+        '  cursor:pointer;overflow-wrap:anywhere}',
+        root + ' ' + slot('trigger') + '[aria-expanded="true"]{background:' + skinVar('surface-2') + ';',
+        '  border-color:' + skinVar('accent') + ';color:' + skinVar('ink') + '}',
+        root + ' ' + slot('trigger') + ':active{transform:scale(.98);transition:transform 60ms linear}',
+        root + ' ' + slot('trigger') + ':focus-visible{outline:2px solid ' + skinVar('accent') + ';outline-offset:2px}',
+        /* 面板：**降级路**（普通定位元素）；@supports 之内那一段再把它换成锚定定位。 */
+        panel + '{box-sizing:border-box;position:fixed;inset:auto;margin:' + offset + ' 0 0;padding:6px;',
+        '  width:min(' + MENU_WIDTH_PX + 'px, calc(100% - ' + side + ' - ' + side + '));',
+        '  max-height:' + MENU_MAX_HEIGHT_PX + 'px;overflow:auto;',
+        '  background:' + skinVar('surface') + ';color:' + skinVar('ink') + ';',
+        '  border:2px solid ' + edge + ';border-radius:' + skinVar('radius-sm') + ';',
+        '  outline:3px solid ' + halo + ';',
+        '  font:400 ' + skinVar('fs-sm') + '/1.35 ' + skinVar('font') + '}',
+        panel + ':not(:popover-open){display:none}',
+        /* 锚定定位（**只在支持锚定 API 的引擎里**生效；两条能力查询与运行时同一份常量）。 */
+        '@supports (' + MENU_ANCHOR_QUERY + '){',
+        '  @supports (' + MENU_AREA_QUERY + '){',
+        '    ' + panel + '.is-end:popover-open{position-area:bottom span-left;',
+        '      position-try-fallbacks:flip-block,flip-inline}',
+        '    ' + panel + '.is-start:popover-open{position-area:bottom span-right;',
+        '      position-try-fallbacks:flip-block,flip-inline}',
+        '  }',
+        '}',
+        /* 项：一行一枚真按钮；相邻两枚留 8px 缝（命中区不粘在一起）。 */
+        root + ' ' + slot('panel') + ' ' + slot('item') + '{display:flex;align-items:center;gap:10px;width:100%;',
+        '  box-sizing:border-box;min-height:' + min + ';padding:0 10px;margin-top:' + gap + ';',
+        '  border:0;border-radius:' + skinVar('radius-sm') + ';background:none;color:' + skinVar('ink') + ';',
+        '  text-align:left;font:400 ' + skinVar('fs-sm') + '/1.35 ' + skinVar('font') + ';cursor:pointer}',
+        root + ' ' + slot('panel') + ' ' + slot('item') + ':first-of-type{margin-top:0}',
+        root + ' ' + slot('item') + ':active{transform:scale(.98);transition:transform 60ms linear}',
+        root + ' ' + slot('item') + ':focus-visible{outline:2px solid ' + skinVar('accent') + ';outline-offset:-2px}',
+        root + ' ' + slot('item') + '.is-danger{color:' + skinVar('danger') + '}',
+        root + ' ' + slot('item') + '[aria-checked="true"] ' + slot('key') + '{font-weight:700}',
+        root + ' ' + slot('group') + '{padding:' + gap + ' 10px 3px;color:' + skinVar('ink-2') + ';',
+        '  font-size:' + skinVar('fs-xs') + ';font-weight:700}',
+        root + ' ' + slot('sep') + '{height:1px;margin:' + gap + ' 6px;background:' + skinVar('line') + '}',
+        root + ' ' + slot('key') + '{flex:1 1 auto;min-width:0;overflow-wrap:anywhere}',
+        root + ' ' + slot('note') + '{display:block;color:' + skinVar('ink-2') + ';font-size:' + skinVar('fs-xs') + ';',
+        '  margin-top:1px}',
+        root + ' ' + slot('shortcut') + '{flex:0 0 auto;padding:1px 6px;border:1px solid ' + skinVar('line') + ';',
+        '  border-radius:' + skinVar('radius-sm') + ';background:' + skinVar('surface-2') + ';',
+        '  color:' + skinVar('ink-2') + ';font-family:' + skinVar('font-num') + ';font-size:' + skinVar('fs-xs') + '}',
+        root + ' ' + slot('tick') + '{flex:0 0 auto;width:16px;color:' + skinVar('accent-text') + ';font-weight:700}',
+        root + ' ' + slot('panel') + ' ' + slot('item') + '[disabled]{cursor:not-allowed;color:' + skinVar('ink-2') + '}',
+        '@media (hover:hover) and (pointer:fine){',
+        '  ' + root + ' ' + slot('trigger') + ':hover{border-color:' + skinVar('accent') + '}',
+        '  ' + root + ' ' + slot('item') + ':hover{background:' + skinVar('surface-2') + '}',
+        '  ' + root + ' ' + slot('item') + '.is-danger:hover{background:' + skinVar('danger-soft') + '}',
+        '}',
+        '@media (prefers-reduced-motion: reduce){',
+        '  ' + root + ' ' + slot('trigger') + ':active,' + root + ' ' + slot('item') + ':active{transform:none;transition:none}',
+        '}',
+    ].join('\n');
+}

package/dist/components/popover-menu/style.js.map

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

package/dist/components/progress-list/attrs.d.ts

@@ -0,0 +1,77 @@
+/** progress-list · **标记契约**（渲染与调用方共用的唯一事实：类名／形态闭集／状态闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-11-加量池.mjs`，2026-09 用户裁定）
+ *  里的**形态 A「四行清单」**：一页上三四个目标各自走到哪儿。每行给齐
+ *  「目标名（＋状态字）／当前 / 目标（＋单位）／条／一句还差多少」。
+ *
+ *  与既有两件的分工：`metric-grid`（读数格）只列读数、不带目标；`scale-bar`（刻度条）只是一条条
+ *  —— 本件是「目标名 ＋ 当前/目标 ＋ 条 ＋ 还差多少」**整行**，且一页可以有多行。
+ *
+ *  形态键写在 `PROGRESS_LIST_FORMS`（闭集）：本件只有一格，但键必须存在——
+ *  「形态是骨架，不是地址」，日后加第二形态是在闭集里加一格，不是新开一件。
+ *  闭集外的值一律 `badInput`（不静默降级：降级会让调用方以为自己拿到了另一种骨架）。
+ */
+/** 本件的类名根：全部槽位类名都是 `<前缀>block-progress-list-<槽名>`。 */
+export declare const PROGRESS_LIST_CLASS = "ilife-block-progress-list";
+/** 槽位闭集（标记契约的一部分：`render.ts` 与判据都用这里的名字拼类名，不各抄一份字面量）。 */
+export declare const PROGRESS_LIST_SLOTS: readonly ["heading", "list", "row", "top", "label", "state", "meta", "value", "goal", "unit", "track", "fill", "remain", "note"];
+export type ProgressListSlot = (typeof PROGRESS_LIST_SLOTS)[number];
+/** 槽类的类名（唯一拼法：别处不许再写 `block-progress-list-` ＋ 槽名）。 */
+export declare function progressListSlot(slot: ProgressListSlot, prefix?: string): string;
+/** 形态闭集：本件只落地了形态 A「四行清单」。 */
+export declare const PROGRESS_LIST_FORMS: readonly ["rows"];
+export type ProgressListForm = (typeof PROGRESS_LIST_FORMS)[number];
+/** 状态闭集（**机器键**）：每一行必落其中一档，`render` 只认闭集内的值。
+ *  它是「色不是唯一信息」那条地板的落点：每档都自己带一句**状态字**（见 `PROGRESS_LIST_STATE_WORDS`）。 */
+export declare const PROGRESS_LIST_STATES: readonly ["blank", "on-track", "done", "over"];
+export type ProgressListState = (typeof PROGRESS_LIST_STATES)[number];
+/** 状态字（状态闭集 → 屏上那句话；唯一出处，判据从这里取，不抄字面量）。 */
+export declare const PROGRESS_LIST_STATE_WORDS: Readonly<Record<ProgressListState, string>>;
+/** 语气闭集（只改**视觉**档，不改语义）：`none` ＝ 不上语气色（走强调色）。 */
+export declare const PROGRESS_LIST_TONES: readonly ["none", "ok", "warn", "danger"];
+export type ProgressListTone = (typeof PROGRESS_LIST_TONES)[number];
+/** 缺值的写法：**缺值写成 `—`，不许写 0、不许留空**（全仓同一条地板）。 */
+export declare const PROGRESS_LIST_MISSING = "\u2014";
+/** 「还差」那句的左端词：句子的形状住这里，`model.ts` 只按它拼。 */
+export declare const PROGRESS_LIST_REMAIN_WORD = "\u8FD8\u5DEE";
+/** 刚好走到目标的写法（与「已超」区分：一个是到点，一个是过点）。 */
+export declare const PROGRESS_LIST_EXACT_WORD = "\u521A\u597D\u8FBE\u6807";
+/** 过目标时的左端词。 */
+export declare const PROGRESS_LIST_OVER_WORD = "\u5DF2\u8D85";
+/** 一行（一个目标）。数字是**机器值**（要算比例），屏上的字由本件按 `formatNumber` 一律排出来。 */
+export interface ProgressListRow {
+    /** 目标名（如「热量」「饮水」）。**非空**；长了换行，不许 `…` 截断。 */
+    readonly label: string;
+    /** 当前值。`null` ＝ **未记录**（屏上写 `—`，条不出 `aria-valuenow`，与「0」区分）；空串不是缺值，是错。 */
+    readonly current: number | null;
+    /** 目标值。**有限数且 > 0**（分母为 0 算不出比例，一律 `badInput`）。 */
+    readonly goal: number;
+    /** 单位（`卡`／`毫升`／`分钟`／`千克`）：跟在目标值后，也接在「还差多少」那句尾上。 */
+    readonly unit?: string;
+    /** 当前值的显示字（千分位之类）；不给＝本件按机器值排（`1,189`）。 */
+    readonly display?: string;
+    /** 目标值的显示字；不给＝按机器值排。 */
+    readonly goalDisplay?: string;
+    /** 「还差多少」整句（如「还差 611 卡」）；不给＝本件按状态算。 */
+    readonly remainText?: string;
+    /** 状态字（覆盖闭集算出来的那句，如「落后 1 天」）；**给了它，`tone` 才有承担语义的第二样**。 */
+    readonly state?: string;
+    /** 语气档（只改条的色，不改语义）；不给＝按状态取缺省档。 */
+    readonly tone?: ProgressListTone;
+}
+/** 四行清单的入参。`rows` 必填——没有行的「进度清单」是空容器。 */
+export interface ProgressListInput {
+    /** 目标行（一页通常三到四条）。空数组 ⇒ 只出 `emptyLine`（给了的话）。 */
+    readonly rows: readonly ProgressListRow[];
+    /** 小标题（如「今天四个目标」）。 */
+    readonly heading?: string;
+    /** 口径行：这批目标怎么算的。串＝一句话；数组＝分段。 */
+    readonly note?: string | readonly string[];
+    /** 一行都没有时出的人话（「这个账本还没定目标」）；不给＝一个字都不出。 */
+    readonly emptyLine?: string;
+    /** 形态键（闭集，缺省 `rows`）。 */
+    readonly form?: ProgressListForm;
+    /** 附加类名（空格分隔；逐个过类名正则）。 */
+    readonly extraClass?: string;
+}
+//# sourceMappingURL=attrs.d.ts.map

package/dist/components/progress-list/attrs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.d.ts","sourceRoot":"","sources":["../../../src/components/progress-list/attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,sDAAsD;AACtD,eAAO,MAAM,mBAAmB,8BAA8B,CAAC;AAE/D,yDAAyD;AACzD,eAAO,MAAM,mBAAmB,kIA6BtB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,SAAW,GAAG,MAAM,CAElF;AAED,6BAA6B;AAC7B,eAAO,MAAM,mBAAmB,mBAAoB,CAAC;AACrD,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE;yEACyE;AACzE,eAAO,MAAM,oBAAoB,gDAAiD,CAAC;AACnF,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,2CAA2C;AAC3C,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAKhF,CAAC;AAEH,iDAAiD;AACjD,eAAO,MAAM,mBAAmB,2CAA4C,CAAC;AAC7E,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,8CAA8C;AAC9C,eAAO,MAAM,qBAAqB,WAAM,CAAC;AAEzC,2CAA2C;AAC3C,eAAO,MAAM,yBAAyB,iBAAO,CAAC;AAC9C,sCAAsC;AACtC,eAAO,MAAM,wBAAwB,6BAAS,CAAC;AAC/C,gBAAgB;AAChB,eAAO,MAAM,uBAAuB,iBAAO,CAAC;AAE5C,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,wBAAwB;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,uCAAuC;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;CAClC;AAED,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAC;IAC1C,sBAAsB;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAC3C,yCAAyC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,yBAAyB;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACjC,0BAA0B;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B"}

package/dist/components/progress-list/attrs.js

@@ -0,0 +1,72 @@
+/** progress-list · **标记契约**（渲染与调用方共用的唯一事实：类名／形态闭集／状态闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-11-加量池.mjs`，2026-09 用户裁定）
+ *  里的**形态 A「四行清单」**：一页上三四个目标各自走到哪儿。每行给齐
+ *  「目标名（＋状态字）／当前 / 目标（＋单位）／条／一句还差多少」。
+ *
+ *  与既有两件的分工：`metric-grid`（读数格）只列读数、不带目标；`scale-bar`（刻度条）只是一条条
+ *  —— 本件是「目标名 ＋ 当前/目标 ＋ 条 ＋ 还差多少」**整行**，且一页可以有多行。
+ *
+ *  形态键写在 `PROGRESS_LIST_FORMS`（闭集）：本件只有一格，但键必须存在——
+ *  「形态是骨架，不是地址」，日后加第二形态是在闭集里加一格，不是新开一件。
+ *  闭集外的值一律 `badInput`（不静默降级：降级会让调用方以为自己拿到了另一种骨架）。
+ */
+/** 本件的类名根：全部槽位类名都是 `<前缀>block-progress-list-<槽名>`。 */
+export const PROGRESS_LIST_CLASS = 'ilife-block-progress-list';
+/** 槽位闭集（标记契约的一部分：`render.ts` 与判据都用这里的名字拼类名，不各抄一份字面量）。 */
+export const PROGRESS_LIST_SLOTS = [
+    /** 小标题（如「今天四个目标」）；不给＝不出这一行。 */
+    'heading',
+    /** 四行清单的容器。 */
+    'list',
+    /** 一行（一个目标）；带 `is-<状态>` 与 `data-ilife-progress-state` 两样状态标记。 */
+    'row',
+    /** 行首那一排：目标名 ＋ 状态字。 */
+    'top',
+    /** 目标名（非关键长名，允许换行）。 */
+    'label',
+    /** 状态字（**色之外的第二样**：未记录／进行中／已达标／已超）；调用方可用 `state` 覆盖成自己的话。 */
+    'state',
+    /** 当前 / 目标 那一排。 */
+    'meta',
+    /** 当前值（大字档，等宽数字）。 */
+    'value',
+    /** 目标值（`/ 1,800`，不加单位）。 */
+    'goal',
+    /** 单位（跟在目标值后，比值小一号）。 */
+    'unit',
+    /** 进度条轨（`role="progressbar"`；缺值时**不出** `aria-valuenow`）。 */
+    'track',
+    /** 进度条填充（宽度落内联 `style`，比例由本件算）。 */
+    'fill',
+    /** 「还差多少」那句（已达标写「刚好达标」，超了写「已超 …」，缺值不出这一行）。 */
+    'remain',
+    /** 口径行：这批目标怎么算的（弱文字，可很长、必须能换行）。 */
+    'note',
+];
+/** 槽类的类名（唯一拼法：别处不许再写 `block-progress-list-` ＋ 槽名）。 */
+export function progressListSlot(slot, prefix = 'ilife-') {
+    return prefix + 'block-progress-list-' + slot;
+}
+/** 形态闭集：本件只落地了形态 A「四行清单」。 */
+export const PROGRESS_LIST_FORMS = ['rows'];
+/** 状态闭集（**机器键**）：每一行必落其中一档，`render` 只认闭集内的值。
+ *  它是「色不是唯一信息」那条地板的落点：每档都自己带一句**状态字**（见 `PROGRESS_LIST_STATE_WORDS`）。 */
+export const PROGRESS_LIST_STATES = ['blank', 'on-track', 'done', 'over'];
+/** 状态字（状态闭集 → 屏上那句话；唯一出处，判据从这里取，不抄字面量）。 */
+export const PROGRESS_LIST_STATE_WORDS = Object.freeze({
+    blank: '未记录',
+    'on-track': '进行中',
+    done: '已达标',
+    over: '已超',
+});
+/** 语气闭集（只改**视觉**档，不改语义）：`none` ＝ 不上语气色（走强调色）。 */
+export const PROGRESS_LIST_TONES = ['none', 'ok', 'warn', 'danger'];
+/** 缺值的写法：**缺值写成 `—`，不许写 0、不许留空**（全仓同一条地板）。 */
+export const PROGRESS_LIST_MISSING = '—';
+/** 「还差」那句的左端词：句子的形状住这里，`model.ts` 只按它拼。 */
+export const PROGRESS_LIST_REMAIN_WORD = '还差';
+/** 刚好走到目标的写法（与「已超」区分：一个是到点，一个是过点）。 */
+export const PROGRESS_LIST_EXACT_WORD = '刚好达标';
+/** 过目标时的左端词。 */
+export const PROGRESS_LIST_OVER_WORD = '已超';

package/dist/components/progress-list/attrs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.js","sourceRoot":"","sources":["../../../src/components/progress-list/attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,sDAAsD;AACtD,MAAM,CAAC,MAAM,mBAAmB,GAAG,2BAA2B,CAAC;AAE/D,yDAAyD;AACzD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,+BAA+B;IAC/B,SAAS;IACT,eAAe;IACf,MAAM;IACN,iEAAiE;IACjE,KAAK;IACL,uBAAuB;IACvB,KAAK;IACL,uBAAuB;IACvB,OAAO;IACP,6DAA6D;IAC7D,OAAO;IACP,mBAAmB;IACnB,MAAM;IACN,qBAAqB;IACrB,OAAO;IACP,2BAA2B;IAC3B,MAAM;IACN,wBAAwB;IACxB,MAAM;IACN,4DAA4D;IAC5D,OAAO;IACP,mCAAmC;IACnC,MAAM;IACN,8CAA8C;IAC9C,QAAQ;IACR,mCAAmC;IACnC,MAAM;CACE,CAAC;AAGX,sDAAsD;AACtD,MAAM,UAAU,gBAAgB,CAAC,IAAsB,EAAE,MAAM,GAAG,QAAQ;IACxE,OAAO,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAAC;AAChD,CAAC;AAED,6BAA6B;AAC7B,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAM,CAAU,CAAC;AAGrD;yEACyE;AACzE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;AAGnF,2CAA2C;AAC3C,MAAM,CAAC,MAAM,yBAAyB,GAAgD,MAAM,CAAC,MAAM,CAAC;IAClG,KAAK,EAAE,KAAK;IACZ,UAAU,EAAE,KAAK;IACjB,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,IAAI;CACX,CAAC,CAAC;AAEH,iDAAiD;AACjD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;AAG7E,8CAA8C;AAC9C,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC,2CAA2C;AAC3C,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC;AAC9C,sCAAsC;AACtC,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAC/C,gBAAgB;AAChB,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC"}

package/dist/components/progress-list/index.d.ts

@@ -0,0 +1,16 @@
+/** progress-list · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  六个运行名：`renderProgressList(input)`（产标记，零 DOM）／`progressListCss()`（样式段）／
+ *  形态闭集 `PROGRESS_LIST_FORMS`（本件只落地形态 A「四行清单」）／状态闭集 `PROGRESS_LIST_STATES`
+ *  与状态字表 `PROGRESS_LIST_STATE_WORDS`／类名根 `PROGRESS_LIST_CLASS`／
+ *  两个几何事实（`PROGRESS_LIST_TRACK_HEIGHT_PX`／`PROGRESS_LIST_NARROW_PX`）。
+ *  另出 `formatProgressNumber`（本件排数字的那条唯一算法）与四个类型名（入参面）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ */
+export { PROGRESS_LIST_CLASS, PROGRESS_LIST_FORMS, PROGRESS_LIST_MISSING, PROGRESS_LIST_STATES, PROGRESS_LIST_STATE_WORDS, PROGRESS_LIST_TONES, } from './attrs.js';
+export type { ProgressListForm, ProgressListInput, ProgressListRow, ProgressListState, ProgressListTone, } from './attrs.js';
+export { formatProgressNumber } from './model.js';
+export { renderProgressList } from './render.js';
+export { PROGRESS_LIST_NARROW_PX, PROGRESS_LIST_TRACK_HEIGHT_PX, progressListCss } from './style.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/progress-list/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/progress-list/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/progress-list/index.js

@@ -0,0 +1,14 @@
+/** progress-list · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  六个运行名：`renderProgressList(input)`（产标记，零 DOM）／`progressListCss()`（样式段）／
+ *  形态闭集 `PROGRESS_LIST_FORMS`（本件只落地形态 A「四行清单」）／状态闭集 `PROGRESS_LIST_STATES`
+ *  与状态字表 `PROGRESS_LIST_STATE_WORDS`／类名根 `PROGRESS_LIST_CLASS`／
+ *  两个几何事实（`PROGRESS_LIST_TRACK_HEIGHT_PX`／`PROGRESS_LIST_NARROW_PX`）。
+ *  另出 `formatProgressNumber`（本件排数字的那条唯一算法）与四个类型名（入参面）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ */
+export { PROGRESS_LIST_CLASS, PROGRESS_LIST_FORMS, PROGRESS_LIST_MISSING, PROGRESS_LIST_STATES, PROGRESS_LIST_STATE_WORDS, PROGRESS_LIST_TONES, } from './attrs.js';
+export { formatProgressNumber } from './model.js';
+export { renderProgressList } from './render.js';
+export { PROGRESS_LIST_NARROW_PX, PROGRESS_LIST_TRACK_HEIGHT_PX, progressListCss } from './style.js';

package/dist/components/progress-list/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/progress-list/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAQpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/progress-list/model.d.ts

@@ -0,0 +1,34 @@
+import { type ProgressListForm, type ProgressListState, type ProgressListTone } from './attrs.js';
+/** 归一化后的一行：每个字段都已校验，算得出来的（比例／状态字／还差多少）已经算好。 */
+export interface ProgressListRowModel {
+    readonly label: string;
+    readonly valueText: string;
+    readonly goalText: string;
+    readonly unit?: string;
+    readonly state: ProgressListState;
+    readonly stateWord: string;
+    readonly tone: ProgressListTone;
+    /** 条填充的宽度百分比（**已夹在 0..100**）；未记录时是 0。 */
+    readonly fillPct: number;
+    /** 真实进度百分比（**不夹**，可以 > 100；未记录时不出）。 */
+    readonly pct: number | null;
+    /** 「还差多少」那句；未记录时 `undefined`（没有数就没什么可差的）。 */
+    readonly remain?: string;
+    /** `aria-valuetext` 那句（屏幕阅读器读的「当前 / 目标 单位」）。 */
+    readonly ariaText: string;
+}
+/** 归一化后的入参。 */
+export interface ProgressListModel {
+    readonly form: ProgressListForm;
+    readonly heading?: string;
+    readonly rows: readonly ProgressListRowModel[];
+    readonly note: readonly string[];
+    readonly emptyLine?: string;
+    readonly extraClass?: string;
+}
+/** 机器数 → 屏上的字：最多两位小数、去掉尾随 0、千分位。
+ *  `1,189`／`68.4`／`66`／`−2.4`（负号用 ASCII `-`：数字串只做展示，不做运算输入）。 */
+export declare function formatProgressNumber(value: number): string;
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `ProgressListModel`，不再自己碰 `any`。 */
+export declare function normalizeProgressList(input: unknown): ProgressListModel;
+//# sourceMappingURL=model.d.ts.map

package/dist/components/progress-list/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/components/progress-list/model.ts"],"names":[],"mappings":"AASA,OAAO,EAQL,KAAK,gBAAgB,EAErB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AAEpB,+CAA+C;AAC/C,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uCAAuC;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,eAAe;AACf,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAcD;gEACgE;AAChE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK1D;AA+ED,yEAAyE;AACzE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAqBvE"}

package/dist/components/progress-list/model.js

@@ -0,0 +1,132 @@
+/** progress-list · **入参归一化与校验**（把 `any` 与说不出的 `unknown` 挡在门外，产出内部类型）。
+ *
+ *  三条口径：
+ *   1. **非法入参一律 `badInput()`**（抛 `BlocksError`）——不静默降级、不「尽量猜」；
+ *   2. **缺值与空串是两件事**：`current: null` ＝ 未记录（写成 `—`）；给非有限数 ＝ 错；
+ *   3. **算得出来的都不许调用方再给**：「还差多少」那句、条的比例、状态字三样都是本件算的
+ *      （不给才轮到调用方覆盖），免得同一个事实在调用点与本件各写一遍。
+ */
+import { assertPlainObject, badInput, optExtraClass, optText, reqText } from '../shared/validate.js';
+import { PROGRESS_LIST_EXACT_WORD, PROGRESS_LIST_FORMS, PROGRESS_LIST_MISSING, PROGRESS_LIST_OVER_WORD, PROGRESS_LIST_REMAIN_WORD, PROGRESS_LIST_STATE_WORDS, PROGRESS_LIST_TONES, } from './attrs.js';
+/** 千分位（自算、不依赖 locale：同一入参在任何机器上排一样，判据才断得准）。 */
+function groupThousands(s) {
+    const dot = s.indexOf('.');
+    const int = dot < 0 ? s : s.slice(0, dot);
+    const frac = dot < 0 ? '' : s.slice(dot);
+    const sign = int.startsWith('-') ? '-' : '';
+    const digits = sign === '' ? int : int.slice(1);
+    const parts = [];
+    for (let i = digits.length; i > 0; i -= 3)
+        parts.unshift(digits.slice(Math.max(0, i - 3), i));
+    return sign + parts.join(',') + frac;
+}
+/** 机器数 → 屏上的字：最多两位小数、去掉尾随 0、千分位。
+ *  `1,189`／`68.4`／`66`／`−2.4`（负号用 ASCII `-`：数字串只做展示，不做运算输入）。 */
+export function formatProgressNumber(value) {
+    if (!Number.isFinite(value))
+        badInput('progress-list: 要排的数字必须是有限数');
+    const abs = Math.abs(value);
+    const fixed = (Math.round(abs * 100) / 100).toFixed(2).replace(/0+$/, '').replace(/\.$/, '');
+    return (value < 0 ? '-' : '') + groupThousands(fixed);
+}
+/** 有限数（必填）。 */
+function reqNum(value, field) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        badInput(field + ' 必须是有限数字');
+    return value;
+}
+/** 有限数或 `null`（`null` ＝ 未记录）。 */
+function optNumOrNull(value, field) {
+    if (value === null)
+        return null;
+    if (value === undefined)
+        badInput(field + ' 必填（未记录请显式给 null）');
+    return reqNum(value, field);
+}
+/** 一行：校验 ＋ 算比例、状态、状态字、还差多少。 */
+function rowModel(value, index) {
+    assertPlainObject(value, 'progress-list: input.rows[' + index + ']');
+    const raw = value;
+    const label = reqText(raw.label, 'progress-list: input.rows[' + index + '].label');
+    const goal = reqNum(raw.goal, 'progress-list: input.rows[' + index + '].goal');
+    if (goal <= 0)
+        badInput('progress-list: input.rows[' + index + '].goal 必须 > 0（分母为 0 算不出比例）');
+    const current = optNumOrNull(raw.current, 'progress-list: input.rows[' + index + '].current');
+    const unit = optText(raw.unit, 'progress-list: input.rows[' + index + '].unit');
+    let state;
+    if (current === null)
+        state = 'blank';
+    else if (current > goal)
+        state = 'over';
+    else if (current >= goal)
+        state = 'done';
+    else
+        state = 'on-track';
+    const stateWord = optText(raw.state, 'progress-list: input.rows[' + index + '].state')
+        ?? PROGRESS_LIST_STATE_WORDS[state];
+    const toneGiven = raw.tone;
+    if (toneGiven !== undefined && !PROGRESS_LIST_TONES.includes(toneGiven)) {
+        badInput('progress-list: input.rows[' + index + '].tone 必须是 ' + PROGRESS_LIST_TONES.join('／') + ' 之一');
+    }
+    const tone = toneGiven !== undefined
+        ? toneGiven
+        : (state === 'done' ? 'ok' : (state === 'over' ? 'warn' : 'none'));
+    const pct = current === null ? null : Math.round((current / goal) * 1000) / 10;
+    const fillPct = pct === null ? 0 : Math.min(100, Math.max(0, pct));
+    const valueText = current === null
+        ? PROGRESS_LIST_MISSING
+        : (optText(raw.display, 'progress-list: input.rows[' + index + '].display') ?? formatProgressNumber(current));
+    const goalText = optText(raw.goalDisplay, 'progress-list: input.rows[' + index + '].goalDisplay')
+        ?? formatProgressNumber(goal);
+    const unitTail = unit === undefined ? '' : ' ' + unit;
+    const ariaText = valueText + ' / ' + goalText + unitTail;
+    let remain = optText(raw.remainText, 'progress-list: input.rows[' + index + '].remainText');
+    if (remain === undefined && current !== null) {
+        if (state === 'done')
+            remain = PROGRESS_LIST_EXACT_WORD;
+        else if (state === 'over')
+            remain = PROGRESS_LIST_OVER_WORD + ' ' + formatProgressNumber(current - goal) + unitTail;
+        else
+            remain = PROGRESS_LIST_REMAIN_WORD + ' ' + formatProgressNumber(goal - current) + unitTail;
+    }
+    return { label, valueText, goalText, unit, state, stateWord, tone, fillPct, pct, remain, ariaText };
+}
+/** 串或串数组 → 段数组（与 `page-head` 同口径：`''` 与 `[]` 都按「不出这一行」处理）。 */
+function textList(value, field) {
+    if (value === undefined)
+        return [];
+    if (typeof value === 'string') {
+        const one = optText(value, field);
+        return one === undefined ? [] : [one];
+    }
+    if (!Array.isArray(value))
+        badInput(field + ' 必须是字符串，或字符串数组（逐段一枚）');
+    const out = [];
+    for (let i = 0; i < value.length; i += 1) {
+        const one = optText(value[i], field + '[' + i + ']');
+        if (one !== undefined)
+            out.push(one);
+    }
+    return out;
+}
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `ProgressListModel`，不再自己碰 `any`。 */
+export function normalizeProgressList(input) {
+    assertPlainObject(input, 'renderProgressList: input');
+    const raw = input;
+    const form = raw.form === undefined ? PROGRESS_LIST_FORMS[0] : raw.form;
+    if (!PROGRESS_LIST_FORMS.includes(form)) {
+        badInput('progress-list: input.form 必须是 ' + PROGRESS_LIST_FORMS.join('／') + ' 之一（本件只落地形态 A「四行清单」）');
+    }
+    const rowsGiven = raw.rows;
+    if (!Array.isArray(rowsGiven))
+        badInput('progress-list: input.rows 必须是数组');
+    const rows = rowsGiven.map((r, i) => rowModel(r, i));
+    return {
+        form: form,
+        heading: optText(raw.heading, 'progress-list: input.heading'),
+        rows,
+        note: textList(raw.note, 'progress-list: input.note'),
+        emptyLine: optText(raw.emptyLine, 'progress-list: input.emptyLine'),
+        extraClass: optExtraClass(raw.extraClass, 'progress-list: input.extraClass'),
+    };
+}

package/dist/components/progress-list/model.js.map

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

package/dist/components/progress-list/render.d.ts

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

package/dist/components/progress-list/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/components/progress-list/render.ts"],"names":[],"mappings":"AA+EA,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMzD"}

package/dist/components/progress-list/render.js

@@ -0,0 +1,84 @@
+/** progress-list · **渲染**（纯函数产 HTML；本件只有形态 A「四行清单」一种骨架）。
+ *
+ *  —— 形态 A：四行清单 ——
+ *
+ *  每行四段，**自上而下不抢宽度**：目标名＋状态字 ／ 当前 / 目标＋单位 ／ 条 ／ 还差多少。
+ *  它替掉的两种错法：
+ *   · 把「当前/目标」塞进条里当标签 —— 条一窄（窄容器）字就被压没；
+ *   · 只给一条进度条、不给状态字 —— 色一换（墨黑强调的皮肤）「到没到」就读不出来。
+ *
+ *  三条硬口径（判据断的就是它们）：
+ *   · **条的比例由本件算**（`current / goal`，夹在 0..100），调用方不传宽度；
+ *   · **状态字必出**（未记录／进行中／已达标／已超 或调用方给的），色不是唯一信息；
+ *   · **缺值写成 `—`**，且缺值那行**不出** `aria-valuenow`（没有数就不该报一个数）。
+ */
+import { esc } from '../shared/escape.js';
+import { PROGRESS_LIST_CLASS, progressListSlot } from './attrs.js';
+import { normalizeProgressList } from './model.js';
+/** 状态 → 行上的类（`is-blank`／`is-on-track`／`is-done`／`is-over`）。 */
+function stateClass(state) {
+    return 'is-' + state;
+}
+/** 一行：名＋状态字 ／ 值＋目标 ／ 条 ／ 还差多少。 */
+function rowHtml(row) {
+    const parts = ['<li class="' + progressListSlot('row') + ' ' + stateClass(row.state)
+            + (row.tone === 'none' ? '' : ' is-' + row.tone) + '" data-ilife-progress-state="' + esc(row.state) + '">'];
+    parts.push('<p class="' + progressListSlot('top') + '">');
+    parts.push('<span class="' + progressListSlot('label') + '">' + esc(row.label) + '</span>');
+    parts.push('<span class="' + progressListSlot('state') + '">' + esc(row.stateWord) + '</span>');
+    parts.push('</p>');
+    parts.push('<p class="' + progressListSlot('meta') + '">');
+    parts.push('<b class="' + progressListSlot('value') + '">' + esc(row.valueText) + '</b>');
+    parts.push('<span class="' + progressListSlot('goal') + '">/ ' + esc(row.goalText) + '</span>');
+    if (row.unit !== undefined) {
+        parts.push('<span class="' + progressListSlot('unit') + '">' + esc(row.unit) + '</span>');
+    }
+    parts.push('</p>');
+    /* 条：`role="progressbar"` ＋ 名 ＋ 值文本。**未记录那行不给 `aria-valuenow`**——报了就是撒谎。 */
+    parts.push('<div class="' + progressListSlot('track') + '" role="progressbar" aria-valuemin="0" aria-valuemax="100"'
+        + (row.pct === null ? '' : ' aria-valuenow="' + esc(String(row.pct)) + '"')
+        + ' aria-label="' + esc(row.label) + '" aria-valuetext="' + esc(row.ariaText) + '">');
+    parts.push('<i class="' + progressListSlot('fill') + '" style="width: ' + esc(String(row.fillPct)) + '%"></i>');
+    parts.push('</div>');
+    if (row.remain !== undefined) {
+        parts.push('<p class="' + progressListSlot('remain') + '">' + esc(row.remain) + '</p>');
+    }
+    parts.push('</li>');
+    return parts.join('');
+}
+/** 形态 A 的骨架。**行序即入参序**（调用方按重要程度排）。 */
+function renderRows(m) {
+    const parts = [];
+    if (m.heading !== undefined) {
+        parts.push('<p class="' + progressListSlot('heading') + '">' + esc(m.heading) + '</p>');
+    }
+    if (m.rows.length === 0) {
+        /* 没有行就没有「清单」：给了 `emptyLine` 就出那句人话，没给就一个字都不出（不留空壳）。 */
+        if (m.emptyLine !== undefined) {
+            parts.push('<p class="' + progressListSlot('note') + '">' + esc(m.emptyLine) + '</p>');
+        }
+        return parts.join('');
+    }
+    parts.push('<ul class="' + progressListSlot('list') + '">');
+    for (const row of m.rows)
+        parts.push(rowHtml(row));
+    parts.push('</ul>');
+    if (m.note.length > 0) {
+        const spans = m.note.map((s) => '<span>' + esc(s) + '</span>').join('');
+        parts.push('<p class="' + progressListSlot('note') + '">' + spans + '</p>');
+    }
+    return parts.join('');
+}
+/** 形态 → 骨架（本件只有一格；分派写在这里，加第二形态就是加一支）。 */
+const SKELETONS = {
+    rows: renderRows,
+};
+/** 渲染多目标进度（纯函数：同样的入参恒产同样的字节；转义只经 `shared/escape.ts`）。 */
+export function renderProgressList(input) {
+    const m = normalizeProgressList(input);
+    const body = SKELETONS[m.form](m);
+    if (body === '')
+        return '';
+    const extra = m.extraClass === undefined ? '' : ' ' + m.extraClass;
+    return '<div class="' + PROGRESS_LIST_CLASS + ' is-' + m.form + extra + '">' + body + '</div>';
+}

package/dist/components/progress-list/render.js.map

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

package/dist/components/progress-list/style.d.ts

@@ -0,0 +1,10 @@
+/** 条高（px）：一个数，样式里只写它一处——判据从源码读这个数来对账。 */
+export declare const PROGRESS_LIST_TRACK_HEIGHT_PX = 8;
+/** 窄容器阈值（px）：目标名与状态字改走「上下两行」，长目标名不再被状态字挤窄。
+ *  **这是本件自己的宽度**（`@container` 判的），不是视口宽度。 */
+export declare const PROGRESS_LIST_NARROW_PX = 360;
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export declare function progressListCss(input?: {
+    readonly prefix?: string;
+}): string;
+//# sourceMappingURL=style.d.ts.map