base-paint 0.3.14 → 0.3.16

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

@@ -0,0 +1,133 @@
+/** 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'),
+    };
+}
+//# sourceMappingURL=model.js.map

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,85 @@
+/** 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>';
+}
+//# sourceMappingURL=render.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../../src/components/progress-list/style.ts"],"names":[],"mappings":"AAgBA,yCAAyC;AACzC,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAE/C;6CAC6C;AAC7C,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,4BAA4B;AAC5B,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CA2L5E"}

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

@@ -0,0 +1,208 @@
+/** progress-list · **样式段**（本件唯一的样式来源）。
+ *
+ *  纪律（与本族其余件同一份）：
+ *   · 只经 `skinVar()` 读皮肤 —— 组件里**不写** `var(--ilife-…)`（兜底链只许住在 `skin/contract.ts`）；
+ *   · 全部规则 scope 在 `.<prefix>page-ui` 之下（不开本配方的页零命中）；不写 `:root`／`!important`、不新增 token 名；
+ *   · **宽度只许容器判**：布局靠 `@container` ＋ 内在尺寸 ＋ `flex-wrap`；媒体查询只判设备能力（本件没用到）。
+ *
+ *  几何契约（判据钉住）：条高 ＝ `PROGRESS_LIST_TRACK_HEIGHT_PX`；窄容器阈值 ＝ `PROGRESS_LIST_NARROW_PX`。
+ *  层次不靠阴影、不靠圆角：行与行之间靠**发丝线**，条靠**轨的底色**与**填充的实色** ⇒ 零阴影皮肤下照样读得出。
+ */
+import { skinVar } from '../skin/contract.js';
+import { progressListSlot } from './attrs.js';
+/** 换行（仓库口径：不写字面换行转义）。 */
+const LF = String.fromCharCode(10);
+/** 条高（px）：一个数，样式里只写它一处——判据从源码读这个数来对账。 */
+export const PROGRESS_LIST_TRACK_HEIGHT_PX = 8;
+/** 窄容器阈值（px）：目标名与状态字改走「上下两行」，长目标名不再被状态字挤窄。
+ *  **这是本件自己的宽度**（`@container` 判的），不是视口宽度。 */
+export const PROGRESS_LIST_NARROW_PX = 360;
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export function progressListCss(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-progress-list';
+    /* 两种拼法：`s()` 带 scope（顶层规则用），`slotSel()` 不带（拼接 `.is-ok .…-fill` 这类后代选择器用，
+       拼两遍 scope 会得到一个永不匹配的选择器）。 */
+    const slotSel = (slot) => '.' + progressListSlot(slot, p);
+    const s = (slot) => root + ' ' + slotSel(slot);
+    return [
+        '/* progress-list（多目标进度 · 形态 A「四行清单」）：每行＝目标名＋状态字／当前 / 目标／条／还差多少。',
+        '   层次不靠阴影与大圆角（小票纸零阴影、大字报刊零圆角）：靠发丝线、条轨底色与字重 ⇒ 换皮只换取值。 */',
+        box + ' {',
+        /* 宽度判据的落点：本件是**自己的容器**——嵌进侧栏／面板／卡片时照样按自己的宽度折行。 */
+        '  container-type: inline-size;',
+        '  display: grid;',
+        '  gap: 10px;',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font') + ';',
+        '  font-size: ' + skinVar('fs-body') + ';',
+        '  line-height: 1.5;',
+        '}',
+        s('heading') + ' {',
+        '  margin: 0;',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-size: ' + skinVar('fs-sm') + ';',
+        '  font-weight: 700;',
+        '  letter-spacing: .02em;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* 清单：一行一个目标，行间一条发丝线（零阴影下靠它分家）。 */',
+        s('list') + ' {',
+        '  display: grid;',
+        '  gap: 0;',
+        '  margin: 0;',
+        '  padding: 0;',
+        '  min-width: 0;',
+        '  list-style: none;',
+        '}',
+        s('row') + ' {',
+        '  display: grid;',
+        '  gap: 6px;',
+        '  min-width: 0;',
+        '  padding: 12px 0;',
+        '  border-top: 1px solid ' + skinVar('line') + ';',
+        '}',
+        s('row') + ':first-child {',
+        '  border-top: 0;',
+        '  padding-top: 0;',
+        '}',
+        '/* 行首：目标名 ＋ 状态字（**色不是唯一信息**：这一枚状态字就是第二样）。 */',
+        s('top') + ' {',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  align-items: baseline;',
+        '  gap: 4px 10px;',
+        '  margin: 0;',
+        '  min-width: 0;',
+        '}',
+        s('label') + ' {',
+        '  flex: 1 1 auto;',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-size: ' + skinVar('fs-body') + ';',
+        '  font-weight: 700;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        s('state') + ' {',
+        '  flex: none;',
+        '  margin-left: auto;',
+        '  padding: 1px 6px;',
+        '  border: 1px solid ' + skinVar('line') + ';',
+        '  border-radius: ' + skinVar('radius-sm') + ';',
+        '  background: ' + skinVar('surface-2') + ';',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  font-weight: 700;',
+        '  letter-spacing: .02em;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* 当前 / 目标 ＋ 单位：值走大字档（**等宽数字**，多行读数上下对齐）。 */',
+        s('meta') + ' {',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  align-items: baseline;',
+        '  gap: 4px 8px;',
+        '  margin: 0;',
+        '  min-width: 0;',
+        '}',
+        s('value') + ' {',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font-num') + ';',
+        '  font-size: calc(' + skinVar('fs-body') + ' * 1.35);',
+        '  font-weight: 700;',
+        '  line-height: 1.15;',
+        '  font-variant-numeric: tabular-nums;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        s('goal') + ' {',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-family: ' + skinVar('font-num') + ';',
+        '  font-size: ' + skinVar('fs-sm') + ';',
+        '  font-variant-numeric: tabular-nums;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        s('unit') + ' {',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-size: ' + skinVar('fs-sm') + ';',
+        '  font-weight: 600;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* 条：轨走软底 ＋ 一圈发丝线（**零阴影下的边界**），填充走实色。',
+        '   未记录那行宽度是 0，读者看到的是空轨——这就是"还没记"的形状。 */',
+        s('track') + ' {',
+        '  display: block;',
+        '  min-width: 0;',
+        '  height: ' + String(PROGRESS_LIST_TRACK_HEIGHT_PX) + 'px;',
+        '  box-sizing: border-box;',
+        '  border: 1px solid ' + skinVar('line') + ';',
+        '  border-radius: ' + skinVar('radius-pill') + ';',
+        '  background: ' + skinVar('surface-2') + ';',
+        '  overflow: hidden;',
+        '}',
+        s('fill') + ' {',
+        '  display: block;',
+        '  height: 100%;',
+        '  border-radius: ' + skinVar('radius-pill') + ';',
+        '  background: ' + skinVar('accent') + ';',
+        '}',
+        '/* 语气只改**取值**：达标走 ok、超了走 warn、危险档走 danger（状态字与条的形状都不变）。 */',
+        s('row') + '.is-ok ' + slotSel('fill') + ' { background: ' + skinVar('ok') + '; }',
+        s('row') + '.is-warn ' + slotSel('fill') + ' { background: ' + skinVar('warn') + '; }',
+        s('row') + '.is-danger ' + slotSel('fill') + ' { background: ' + skinVar('danger') + '; }',
+        s('row') + '.is-ok ' + slotSel('state') + ' { color: ' + skinVar('ok') + '; border-color: ' + skinVar('ok') + '; }',
+        s('row') + '.is-warn ' + slotSel('state') + ' { color: ' + skinVar('warn') + '; border-color: ' + skinVar('warn') + '; }',
+        s('row') + '.is-danger ' + slotSel('state') + ' { color: ' + skinVar('danger') + '; border-color: ' + skinVar('danger') + '; }',
+        s('row') + '.is-blank ' + slotSel('value') + ' { color: ' + skinVar('ink-2') + '; }',
+        '/* 「还差多少」那一句：本形态的第四段，永远整行独占，不跟条抢宽度。 */',
+        s('remain') + ' {',
+        '  margin: 0;',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-size: ' + skinVar('fs-sm') + ';',
+        '  font-weight: 600;',
+        '  font-variant-numeric: tabular-nums;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* 口径行：这批目标怎么算的（弱文字档，可很长、必须能换行；段间一条发丝线，标记里不写分隔符）。 */',
+        s('note') + ' {',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  align-items: baseline;',
+        '  gap: 4px 8px;',
+        '  margin: 0;',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink-3') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  line-height: 1.7;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        s('note') + ' > span {',
+        '  padding-left: 8px;',
+        '  border-left: 1px solid ' + skinVar('line') + ';',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* 本件自身不带可点元素。这一条是**地板**：调用方若把行包成链接或按钮，焦点必须看得见。 */',
+        box + ' :focus-visible {',
+        '  outline: 2px solid ' + skinVar('accent') + ';',
+        '  outline-offset: 2px;',
+        '}',
+        '/* 窄容器（<' + String(PROGRESS_LIST_NARROW_PX) + 'px）：目标名与状态字改走上下两行，',
+        '   长目标名不再被那枚状态字挤成一列孤字。判的是**本件自己的宽度**（本件会被嵌进侧栏／面板／卡片，',
+        '   视口宽 ≠ 组件宽，所以这里不写 `@media`）。 */',
+        '@container (max-width: ' + String(PROGRESS_LIST_NARROW_PX) + 'px) {',
+        '  ' + s('top') + ' {',
+        '    display: grid;',
+        '    gap: 2px;',
+        '  }',
+        '  ' + s('state') + ' {',
+        '    margin-left: 0;',
+        '    justify-self: start;',
+        '  }',
+        '}',
+    ].join(LF);
+}
+//# sourceMappingURL=style.js.map

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

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

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

@@ -0,0 +1,59 @@
+/** progress-ring · **标记契约**（渲染与调用方共用的唯一事实：类名／形态闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-04-形状与比例.mjs`，2026-09 用户裁定）
+ *  里的**形态 A「半环（180°）＋ 环下大字 ＋ 右侧读数」**——一块「已完成／目标」的环，
+ *  环下是主读数与分母，右侧一列键值读数（还能吃多少／还差多少／照此收尾）。
+ *
+ *  形态键写在 `PROGRESS_RING_FORMS`（闭集）：本件只有一格，但键必须存在——
+ *  「形态是骨架，不是地址」，日后加第二形态是在闭集里加一格，不是新开一件。
+ *  闭集外的值一律 `badInput`（不静默降级：降级会让调用方以为自己拿到了另一种骨架）。
+ */
+/** 本件的类名根：全部槽位类名都是 `PROGRESS_RING_CLASS + '-' + 槽名`。 */
+export declare const PROGRESS_RING_CLASS = "ilife-block-progress-ring";
+/** 槽位闭集（标记契约的一部分：`render.ts`、`style.ts` 与判据都用这里的名字拼类名，不各抄一份字面量）。 */
+export declare const PROGRESS_RING_SLOTS: readonly ["hd", "title", "stamp", "split", "gauge", "svg", "trk", "fil", "hero", "value", "unit", "denom", "pct", "kvs", "kv", "kv-label", "kv-value", "note"];
+export type ProgressRingSlot = (typeof PROGRESS_RING_SLOTS)[number];
+/** 槽类的类名（唯一拼法：别处不许再写 `PROGRESS_RING_CLASS + '-' + …`）。 */
+export declare function progressRingSlot(slot: ProgressRingSlot, prefix?: string): string;
+/** 形态闭集：本件只落地了形态 A「半环 ＋ 环下大字 ＋ 右侧读数」。 */
+export declare const PROGRESS_RING_FORMS: readonly ["arc"];
+export type ProgressRingForm = (typeof PROGRESS_RING_FORMS)[number];
+/** 缺值的写法：**缺值写成 `—`，不许写 0、不许留空**（全仓同一条地板）。 */
+export declare const PROGRESS_RING_MISSING = "\u2014";
+/** 半环的几何真值（px）：半径 70、描边 16、圆心 (90, 90)，弧从 (20, 90) 到 (160, 90)。
+ *  弧长 ＝ πr（半圆）＝ `PROGRESS_RING_ARC_LEN`；填充弧的 `stroke-dasharray` 由它算出，
+ *  **画出来的弧长与读出来的百分数对得上**（判据断的就是这条等式）。 */
+export declare const PROGRESS_RING_RADIUS_PX = 70;
+export declare const PROGRESS_RING_STROKE_PX = 16;
+export declare const PROGRESS_RING_ARC_LEN: number;
+/** 右侧读数的一行：名字 ＋ 已经是给人看的样子的值（取整与单位口径归调用方）。 */
+export interface ProgressRingRow {
+    /** 名字（如「还能吃」）。 */
+    readonly label: string;
+    /** 值（如「420 千卡」）；缺值写成 `—`（`PROGRESS_RING_MISSING`）。 */
+    readonly value: string;
+}
+/** 进度环入参。`title`／`value`／`goal` 必填——**没有分母的进度不走本件**（那是一条 `scale-bar`）。 */
+export interface ProgressRingInput {
+    /** 卡头标题（如「今日热量预算」）。 */
+    readonly title: string;
+    /** 卡头右端那句（如「3 月 14 日 · 周六」）；不给＝不出。 */
+    readonly stamp?: string;
+    /** 已完成量（与 `goal` 同单位）。必须 ≥ 0；**可以大于 `goal`**（那是「超目标」态，不算错）。 */
+    readonly value: number;
+    /** 目标量（**必须 > 0**，作比例的分母与弧长的标尺）。 */
+    readonly goal: number;
+    /** 单位（`千卡`／`元`／`件`）：跟在读数与分母后面，不参与任何机器口径。 */
+    readonly unit?: string;
+    /** 右侧那列读数（如「还能吃 420 千卡」）；不给＝环独占整排。 */
+    readonly rows?: readonly ProgressRingRow[];
+    /** 脚注那句人话（未超目标时用）。不给＝本件按读数自己算一句。 */
+    readonly note?: string;
+    /** 脚注那句人话（**超目标时**用）。不给＝本件按差额与超出百分比自己算一句。 */
+    readonly overNote?: string;
+    /** 形态键（闭集，缺省 `arc`）。 */
+    readonly form?: ProgressRingForm;
+    /** 附加类名（空格分隔；逐个过类名正则）。 */
+    readonly extraClass?: string;
+}
+//# sourceMappingURL=attrs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.d.ts","sourceRoot":"","sources":["../../../src/components/progress-ring/attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,wDAAwD;AACxD,eAAO,MAAM,mBAAmB,8BAA8B,CAAC;AAE/D,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,gKAqCtB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,SAAW,GAAG,MAAM,CAElF;AAED,yCAAyC;AACzC,eAAO,MAAM,mBAAmB,kBAAmB,CAAC;AACpD,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,8CAA8C;AAC9C,eAAO,MAAM,qBAAqB,WAAM,CAAC;AAEzC;;yCAEyC;AACzC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,qBAAqB,QAA4D,CAAC;AAE/F,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,kBAAkB;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,uBAAuB;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAC3C,oCAAoC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACjC,0BAA0B;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B"}

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

@@ -0,0 +1,66 @@
+/** progress-ring · **标记契约**（渲染与调用方共用的唯一事实：类名／形态闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-04-形状与比例.mjs`，2026-09 用户裁定）
+ *  里的**形态 A「半环（180°）＋ 环下大字 ＋ 右侧读数」**——一块「已完成／目标」的环，
+ *  环下是主读数与分母，右侧一列键值读数（还能吃多少／还差多少／照此收尾）。
+ *
+ *  形态键写在 `PROGRESS_RING_FORMS`（闭集）：本件只有一格，但键必须存在——
+ *  「形态是骨架，不是地址」，日后加第二形态是在闭集里加一格，不是新开一件。
+ *  闭集外的值一律 `badInput`（不静默降级：降级会让调用方以为自己拿到了另一种骨架）。
+ */
+/** 本件的类名根：全部槽位类名都是 `PROGRESS_RING_CLASS + '-' + 槽名`。 */
+export const PROGRESS_RING_CLASS = 'ilife-block-progress-ring';
+/** 槽位闭集（标记契约的一部分：`render.ts`、`style.ts` 与判据都用这里的名字拼类名，不各抄一份字面量）。 */
+export const PROGRESS_RING_SLOTS = [
+    /** 卡头那一排：标题 ＋ 右侧口径。 */
+    'hd',
+    /** 卡头标题（如「今日热量预算」）。 */
+    'title',
+    /** 卡头右端那句（时间窗／期数），可换行。 */
+    'stamp',
+    /** 环与右侧读数并成的那一排（容器窄时自己折行）。 */
+    'split',
+    /** 环那一格：`svg` ＋ `hero` 一起。 */
+    'gauge',
+    /** 内联 SVG 本身。 */
+    'svg',
+    /** 环的底轨（整条 180° 弧）。 */
+    'trk',
+    /** 环的填充弧（`stroke-dasharray` 按弧长真值算）。 */
+    'fil',
+    /** 环下那行主读数（值 ＋ 单位 ＋ 分母）。 */
+    'hero',
+    /** 主读数的值（本件的第二识别特征：它是环下那一行大字）。 */
+    'value',
+    /** 单位（小一号，跟在值后）。 */
+    'unit',
+    /** 分母／目标（如「／1 680 千卡」）。 */
+    'denom',
+    /** 已完成百分数（如「75%」）：**它就是那条弧的读数**——弧长与它同出一份真值。 */
+    'pct',
+    /** 右侧读数列（`auto-fit`：宽容器多列、窄容器一列）。 */
+    'kvs',
+    /** 右侧读数里的一行。 */
+    'kv',
+    /** 读数行的名字（可换行）。 */
+    'kv-label',
+    /** 读数行的值（数字，永不换行、永不截断）。 */
+    'kv-value',
+    /** 脚注：一句人话（超目标时换色，见 `is-over`）。 */
+    'note',
+];
+/** 槽类的类名（唯一拼法：别处不许再写 `PROGRESS_RING_CLASS + '-' + …`）。 */
+export function progressRingSlot(slot, prefix = 'ilife-') {
+    return prefix + 'block-progress-ring-' + slot;
+}
+/** 形态闭集：本件只落地了形态 A「半环 ＋ 环下大字 ＋ 右侧读数」。 */
+export const PROGRESS_RING_FORMS = ['arc'];
+/** 缺值的写法：**缺值写成 `—`，不许写 0、不许留空**（全仓同一条地板）。 */
+export const PROGRESS_RING_MISSING = '—';
+/** 半环的几何真值（px）：半径 70、描边 16、圆心 (90, 90)，弧从 (20, 90) 到 (160, 90)。
+ *  弧长 ＝ πr（半圆）＝ `PROGRESS_RING_ARC_LEN`；填充弧的 `stroke-dasharray` 由它算出，
+ *  **画出来的弧长与读出来的百分数对得上**（判据断的就是这条等式）。 */
+export const PROGRESS_RING_RADIUS_PX = 70;
+export const PROGRESS_RING_STROKE_PX = 16;
+export const PROGRESS_RING_ARC_LEN = Math.round(Math.PI * PROGRESS_RING_RADIUS_PX * 100) / 100;
+//# sourceMappingURL=attrs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.js","sourceRoot":"","sources":["../../../src/components/progress-ring/attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,wDAAwD;AACxD,MAAM,CAAC,MAAM,mBAAmB,GAAG,2BAA2B,CAAC;AAE/D,oEAAoE;AACpE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,uBAAuB;IACvB,IAAI;IACJ,uBAAuB;IACvB,OAAO;IACP,0BAA0B;IAC1B,OAAO;IACP,8BAA8B;IAC9B,OAAO;IACP,8BAA8B;IAC9B,OAAO;IACP,iBAAiB;IACjB,KAAK;IACL,uBAAuB;IACvB,KAAK;IACL,wCAAwC;IACxC,KAAK;IACL,4BAA4B;IAC5B,MAAM;IACN,kCAAkC;IAClC,OAAO;IACP,oBAAoB;IACpB,MAAM;IACN,2BAA2B;IAC3B,OAAO;IACP,gDAAgD;IAChD,KAAK;IACL,qCAAqC;IACrC,KAAK;IACL,gBAAgB;IAChB,IAAI;IACJ,mBAAmB;IACnB,UAAU;IACV,2BAA2B;IAC3B,UAAU;IACV,mCAAmC;IACnC,MAAM;CACE,CAAC;AAGX,0DAA0D;AAC1D,MAAM,UAAU,gBAAgB,CAAC,IAAsB,EAAE,MAAM,GAAG,QAAQ;IACxE,OAAO,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAAC;AAChD,CAAC;AAED,yCAAyC;AACzC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAK,CAAU,CAAC;AAGpD,8CAA8C;AAC9C,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC;;yCAEyC;AACzC,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAC1C,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAC1C,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,uBAAuB,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC"}