base-paint 0.3.14 → 0.3.16

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

@@ -0,0 +1,13 @@
+/** progress-ring · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  六件出口：`renderProgressRing(input)`（产标记，零 DOM）／`progressRingCss()`（样式段）／
+ *  `PROGRESS_RING_FORMS`（形态闭集）／`PROGRESS_RING_CLASS` 与 `progressRingSlot()`（标记契约）／
+ *  `PROGRESS_RING_ARC_LEN`（半环弧长真值，调用方要跟弧长对齐时读它）／`PROGRESS_RING_MISSING`（缺值写法）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ */
+export { renderProgressRing } from './render.js';
+export type { ProgressRingForm, ProgressRingInput, ProgressRingRow, ProgressRingSlot } from './attrs.js';
+export { PROGRESS_RING_ARC_LEN, PROGRESS_RING_CLASS, PROGRESS_RING_FORMS, PROGRESS_RING_MISSING, PROGRESS_RING_RADIUS_PX, PROGRESS_RING_SLOTS, PROGRESS_RING_STROKE_PX, progressRingSlot, } from './attrs.js';
+export { PROGRESS_RING_MAX_DIAMETER_PX, PROGRESS_RING_VALUE_PX, progressRingCss } from './style.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/progress-ring/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACzG,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,12 @@
+/** progress-ring · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  六件出口：`renderProgressRing(input)`（产标记，零 DOM）／`progressRingCss()`（样式段）／
+ *  `PROGRESS_RING_FORMS`（形态闭集）／`PROGRESS_RING_CLASS` 与 `progressRingSlot()`（标记契约）／
+ *  `PROGRESS_RING_ARC_LEN`（半环弧长真值，调用方要跟弧长对齐时读它）／`PROGRESS_RING_MISSING`（缺值写法）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ */
+export { renderProgressRing } from './render.js';
+export { PROGRESS_RING_ARC_LEN, PROGRESS_RING_CLASS, PROGRESS_RING_FORMS, PROGRESS_RING_MISSING, PROGRESS_RING_RADIUS_PX, PROGRESS_RING_SLOTS, PROGRESS_RING_STROKE_PX, progressRingSlot, } from './attrs.js';
+export { PROGRESS_RING_MAX_DIAMETER_PX, PROGRESS_RING_VALUE_PX, progressRingCss } from './style.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/progress-ring/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,32 @@
+import { type ProgressRingForm, type ProgressRingRow } from './attrs.js';
+/** 内部类型：每个字段都已校验、已归一、已算好（`render.ts` 只负责拼标记）。 */
+export interface ProgressRingModel {
+    readonly form: ProgressRingForm;
+    readonly title: string;
+    /** 卡头右端那句（时间窗／期数）；不给＝不出。 */
+    readonly stamp?: string;
+    readonly over: boolean;
+    /** 已完成量（原值，供 `aria-label` 与脚注用）。 */
+    readonly value: number;
+    /** 目标量（原值）。 */
+    readonly goal: number;
+    /** 值／目标，落在 `[0, 1]`（超目标画满，与 `scale-bar` 的「满格」同一条口径）。 */
+    readonly ratio: number;
+    /** 已完成的百分数（一位小数，整数不写 `.0`）。 */
+    readonly pctText: string;
+    /** 填充弧的弧长（px，两位小数）；空格 ＝ `PROGRESS_RING_ARC_LEN`。 */
+    readonly dash: number;
+    /** 已完成量与目标量的显示串（千分位空格分隔）。 */
+    readonly valueText: string;
+    readonly goalText: string;
+    readonly unit?: string;
+    readonly rows: readonly ProgressRingRow[];
+    /** 脚注那句人话（超目标时是超目标那句）。 */
+    readonly note: string;
+    /** 无障碍名（写给读屏的那一句：标题 ＋ 百分数 ＋ 值／目标）。 */
+    readonly ariaLabel: string;
+    readonly extraClass?: string;
+}
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `ProgressRingModel`，不再自己碰 `any`。 */
+export declare function normalizeProgressRing(input: unknown): ProgressRingModel;
+//# sourceMappingURL=model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/components/progress-ring/model.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,YAAY,CAAC;AAEpB,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,eAAe;IACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+BAA+B;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAC;IAC1C,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAmDD,yEAAyE;AACzE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAsDvE"}

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

@@ -0,0 +1,114 @@
+/** progress-ring · **入参归一化与校验**（把 `any` 与说不出的 `unknown` 挡在门外，产出内部类型）。
+ *
+ *  三条口径：
+ *   1. **非法入参一律 `badInput()`**（抛 `BlocksError`）——不静默降级、不「尽量猜」：
+ *      猜出来的分母会在页面上长成另一个比例，而调用方以为拿到了本件。
+ *   2. **弧长与读数同一份真值**：`ratio` 只算一次，`stroke-dasharray` 的弧长与那句
+ *      「已完成 75%」都从它出——两处各算一次迟早走散（判据断的就是这条等式）。
+ *   3. 归一化只做「形状」与「算数」：**千分位由本件做**（这是排版），单位口径归调用方。
+ */
+import { assertPlainObject, badInput, optExtraClass, optText, reqText } from '../shared/validate.js';
+import { PROGRESS_RING_ARC_LEN, PROGRESS_RING_FORMS, } from './attrs.js';
+/** 必须是有限数（本件唯一的数值校验；第二处要用时提为 `shared/` 件）。 */
+function reqFinite(value, field) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        badInput(field + ' 必须是有限数');
+    }
+    return value;
+}
+/** 千分位：每三位插一个空格（与原型墙同款；读数一律 `tabular-nums`，空格不参与对位）。 */
+function group(s) {
+    const neg = s.startsWith('-');
+    const body = neg ? s.slice(1) : s;
+    let out = '';
+    for (let i = 0; i < body.length; i += 1) {
+        if (i > 0 && (body.length - i) % 3 === 0)
+            out += ' ';
+        out += body[i];
+    }
+    return (neg ? '-' : '') + out;
+}
+/** 数量 → 给人看的串：整数走千分位；小数最多两位（末尾的 0 去掉）。 */
+function fmtQty(n) {
+    if (Number.isInteger(n))
+        return group(String(n));
+    const rounded = Math.round(n * 100) / 100;
+    const s = String(rounded);
+    const dot = s.indexOf('.');
+    return group(s.slice(0, dot)) + s.slice(dot);
+}
+/** 百分数 → 一位小数；整数不写 `.0`（读数上屏的字面量只有这一处）。 */
+function fmtPct(ratio) {
+    const p = Math.round(ratio * 1000) / 10;
+    return String(Number.isInteger(p) ? p : p.toFixed(1));
+}
+/** 右侧读数列：逐行校验（行必须是对象，名字与值都必须是非空串——缺值写 `—`）。 */
+function optRows(value) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value))
+        badInput('progress-ring: input.rows 必须是数组（逐行一枚）');
+    return value.map((item, i) => {
+        assertPlainObject(item, 'progress-ring: input.rows[' + i + ']');
+        const r = item;
+        return {
+            label: reqText(r.label, 'progress-ring: input.rows[' + i + '].label'),
+            value: reqText(r.value, 'progress-ring: input.rows[' + i + '].value'),
+        };
+    });
+}
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `ProgressRingModel`，不再自己碰 `any`。 */
+export function normalizeProgressRing(input) {
+    assertPlainObject(input, 'renderProgressRing: input');
+    const raw = input;
+    const form = raw.form === undefined ? PROGRESS_RING_FORMS[0] : raw.form;
+    if (!PROGRESS_RING_FORMS.includes(form)) {
+        badInput('progress-ring: input.form 必须是 ' + PROGRESS_RING_FORMS.join('／')
+            + ' 之一（本件只落地形态 A「半环 ＋ 环下大字 ＋ 右侧读数」）');
+    }
+    const value = reqFinite(raw.value, 'progress-ring: input.value');
+    if (value < 0)
+        badInput('progress-ring: input.value 不得为负（没做的事不算已完成）');
+    const goal = reqFinite(raw.goal, 'progress-ring: input.goal');
+    if (goal <= 0)
+        badInput('progress-ring: input.goal 必须大于 0（它就是分母与弧长标尺）');
+    const unit = optText(raw.unit, 'progress-ring: input.unit');
+    const ratio = value <= 0 ? 0 : Math.min(1, value / goal);
+    const over = value > goal;
+    const pctText = fmtPct(value / goal);
+    const unitText = unit === undefined ? '' : ' ' + unit;
+    const valueText = fmtQty(value);
+    const goalText = fmtQty(goal);
+    let note = optText(raw.note, 'progress-ring: input.note');
+    if (over) {
+        const overNote = optText(raw.overNote, 'progress-ring: input.overNote');
+        const overPct = fmtPct(value / goal - 1);
+        note = overNote ?? ('已超出目标 ' + overPct + '%（多 ' + fmtQty(value - goal) + unitText + '）。');
+    }
+    else if (note === undefined) {
+        note = value === goal
+            ? ('正好用满目标（' + goalText + unitText + '）。')
+            : ('已用 ' + pctText + '%，还剩 ' + fmtQty(goal - value) + unitText + '。');
+    }
+    return {
+        form: form,
+        title: reqText(raw.title, 'progress-ring: input.title'),
+        stamp: optText(raw.stamp, 'progress-ring: input.stamp'),
+        over,
+        value,
+        goal,
+        ratio,
+        pctText,
+        /* 弧长与读数同一份真值：`dash / PROGRESS_RING_ARC_LEN` 就是那句百分数。 */
+        dash: Math.round(ratio * PROGRESS_RING_ARC_LEN * 100) / 100,
+        valueText,
+        goalText,
+        unit,
+        rows: optRows(raw.rows),
+        note,
+        ariaLabel: '已完成 ' + pctText + '%：'
+            + valueText + unitText + ' / ' + goalText + unitText + (over ? '（超目标）' : ''),
+        extraClass: optExtraClass(raw.extraClass, 'progress-ring: input.extraClass'),
+    };
+}
+//# sourceMappingURL=model.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/components/progress-ring/render.ts"],"names":[],"mappings":"AAiGA,uDAAuD;AACvD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKzD"}

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

@@ -0,0 +1,92 @@
+/** progress-ring · **渲染**（纯函数产 HTML；本件只有形态 A「半环 ＋ 环下大字 ＋ 右侧读数」一种骨架）。
+ *
+ *  —— 形态 A：半环 ＋ 环下大字 ＋ 右侧读数 ——
+ *
+ *  左边一格是**内联 SVG 画的半环**（180°）＋ 环下那行大字（值 ＋ 单位 ＋ 分母 ＋ 百分数），
+ *  右边一列是「还能吃多少／还差多少／照此收尾」这类读数。它替掉的三种错法：
+ *   · 只报一个百分数 —— 读者看不出「还差多少」；
+ *   · 环心用 SVG `<text>` 写字 —— 字号随 SVG 一起缩放，窄容器里读数先糊；
+ *     （本件的大字是 **HTML 叠在环下**，与别的读数同一套字号阶梯）
+ *   · 超目标时把弧画到底就不管了（颜色不变、也不说超了多少）。
+ *
+ *  三条硬口径（判据断的就是它们）：
+ *   · 弧长与读数**同一份真值**：`stroke-dasharray` 的实线长 ÷ `PROGRESS_RING_ARC_LEN`
+ *     ＝ 那句百分数；超目标时弧**画满**（形状不变、只换色，与同族 `scale-bar` 的「满格」同一条口径）；
+ *   · 超目标**不是错**：`value > goal` 合法，出 `is-over` ＋ 换色 ＋ 一句人话（调用方不给就本件算）；
+ *   · 标记里不写分隔符与缺省占位：段间由列距与发丝线承担；缺值由调用方写成 `—`。
+ */
+import { esc } from '../shared/escape.js';
+import { PROGRESS_RING_ARC_LEN, PROGRESS_RING_CLASS, PROGRESS_RING_RADIUS_PX, PROGRESS_RING_STROKE_PX, progressRingSlot, } from './attrs.js';
+import { normalizeProgressRing } from './model.js';
+/** SVG 画布（px）：宽 ＝ 2r ＋ 两侧描边余量；高 ＝ 圆心 y ＋ 半描边 ＋ 一点余量。
+ *  圆心 (90, 90)、半径 70、描边 16 ⇒ 弧顶 90 − 70 = 20，描边外沿 12 ⇒ 全在画布内。 */
+const CX = 90;
+const CY = 90;
+const VIEW_BOX = '0 0 ' + String(2 * CX) + ' ' + String(CY + PROGRESS_RING_STROKE_PX / 2 + 4);
+/** 半环的路径（M 左端点 → A 半径 半径 0 0 1 右端点）。两个端点与半径都从常量算，不抄字面量。 */
+const ARC_PATH = 'M' + String(CX - PROGRESS_RING_RADIUS_PX) + ' ' + String(CY)
+    + 'A' + String(PROGRESS_RING_RADIUS_PX) + ' ' + String(PROGRESS_RING_RADIUS_PX) + ' 0 0 1 '
+    + String(CX + PROGRESS_RING_RADIUS_PX) + ' ' + String(CY);
+/** 环：一条底轨 ＋ 一条填充弧。**`stroke-dasharray` 的两个数就是「画出来多少／整条多长」**。 */
+function gaugeHtml(m) {
+    const dash = String(m.dash) + ' ' + String(PROGRESS_RING_ARC_LEN);
+    const parts = [];
+    parts.push('<div class="' + progressRingSlot('gauge') + '">');
+    parts.push('<svg class="' + progressRingSlot('svg') + '" viewBox="' + VIEW_BOX + '" role="img" aria-label="'
+        + esc(m.title + m.ariaLabel) + '">');
+    parts.push('<path class="' + progressRingSlot('trk') + '" d="' + ARC_PATH + '" fill="none" stroke-width="'
+        + String(PROGRESS_RING_STROKE_PX) + '" stroke-linecap="butt"/>');
+    parts.push('<path class="' + progressRingSlot('fil') + '" d="' + ARC_PATH + '" fill="none" stroke-width="'
+        + String(PROGRESS_RING_STROKE_PX) + '" stroke-linecap="butt" stroke-dasharray="' + dash + '"/>');
+    parts.push('</svg>');
+    parts.push('<p class="' + progressRingSlot('hero') + '">');
+    parts.push('<b class="' + progressRingSlot('value') + '">' + esc(m.valueText) + '</b>');
+    if (m.unit !== undefined) {
+        parts.push('<span class="' + progressRingSlot('unit') + '">' + esc(m.unit) + '</span>');
+    }
+    parts.push('<span class="' + progressRingSlot('denom') + '">／'
+        + esc(m.goalText + (m.unit === undefined ? '' : ' ' + m.unit)) + '</span>');
+    parts.push('<span class="' + progressRingSlot('pct') + '">' + esc(m.pctText + '%') + '</span>');
+    parts.push('</p>');
+    parts.push('</div>');
+    return parts.join('');
+}
+/** 右侧读数：逐行「名字 ｜ 值」，值永不换行、永不截断（它是读者要看的那一个数）。 */
+function rowsHtml(m) {
+    if (m.rows.length === 0)
+        return '';
+    const parts = ['<div class="' + progressRingSlot('kvs') + '">'];
+    for (const row of m.rows) {
+        parts.push('<div class="' + progressRingSlot('kv') + '">');
+        parts.push('<span class="' + progressRingSlot('kv-label') + '">' + esc(row.label) + '</span>');
+        parts.push('<b class="' + progressRingSlot('kv-value') + '">' + esc(row.value) + '</b>');
+        parts.push('</div>');
+    }
+    parts.push('</div>');
+    return parts.join('');
+}
+/** 形态 A 的骨架：卡头 → （环 ＋ 右侧读数）→ 脚注那句人话。 */
+function renderArc(m) {
+    const parts = [];
+    parts.push('<div class="' + progressRingSlot('hd') + '">');
+    parts.push('<h4 class="' + progressRingSlot('title') + '">' + esc(m.title) + '</h4>');
+    if (m.stamp !== undefined) {
+        parts.push('<span class="' + progressRingSlot('stamp') + '">' + esc(m.stamp) + '</span>');
+    }
+    parts.push('</div>');
+    parts.push('<div class="' + progressRingSlot('split') + '">' + gaugeHtml(m) + rowsHtml(m) + '</div>');
+    parts.push('<p class="' + progressRingSlot('note') + '">' + esc(m.note) + '</p>');
+    return parts.join('');
+}
+/** 形态 → 骨架（本件只有一格；分派写在这里，加第二形态就是加一支）。 */
+const SKELETONS = {
+    arc: renderArc,
+};
+/** 渲染进度环（纯函数：同样的入参恒产同样的字节；转义只经 `shared/escape.ts`）。 */
+export function renderProgressRing(input) {
+    const m = normalizeProgressRing(input);
+    const extra = m.extraClass === undefined ? '' : ' ' + m.extraClass;
+    return '<div class="' + PROGRESS_RING_CLASS + ' is-' + m.form + (m.over ? ' is-over' : '') + extra + '">'
+        + SKELETONS[m.form](m) + '</div>';
+}
+//# sourceMappingURL=render.js.map

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

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

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

@@ -0,0 +1,9 @@
+/** 环下大字的字号（px）：两档之间只差这一处——窄容器不让大字把版面顶宽。 */
+export declare const PROGRESS_RING_VALUE_PX = 44;
+/** 环的最大直径（px）：容器再宽也不让环长成一块空地（读数是主角、环是标尺）。 */
+export declare const PROGRESS_RING_MAX_DIAMETER_PX = 280;
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export declare function progressRingCss(input?: {
+    readonly prefix?: string;
+}): string;
+//# sourceMappingURL=style.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../../src/components/progress-ring/style.ts"],"names":[],"mappings":"AAkBA,2CAA2C;AAC3C,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAMzC,6CAA6C;AAC7C,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAEjD,4BAA4B;AAC5B,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CA8M5E"}

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

@@ -0,0 +1,231 @@
+/** progress-ring · **样式段**（本件唯一的样式来源）。
+ *
+ *  纪律（与本节其余件同一份）：
+ *   · 只经 `skinVar()` 读皮肤 —— 组件里**不写** `var(--ilife-…)`（兜底链只许住在 `skin/contract.ts`）；
+ *   · 全部规则 scope 在 `.<prefix>page-ui` 之下（不开本配方页零命中）；不写 `:root`／`!important`、不新增 token 名；
+ *   · **宽度只许容器判**：布局靠 `@container` ＋ 内在尺寸 ＋ `flex-wrap`；本件不写任何 `@media`（视口宽 ≠ 组件宽）。
+ *
+ *  几何契约（判据钉住）：
+ *   · 半环是内联 SVG、宽度 100% 自适应，**根不留横向滚动**（`min-width:0` ＋ `max-width` 撑底）；
+ *   · 环下大字是 **HTML**，与右侧读数是同一套字号阶梯 ⇒ 窄容器里不会随 SVG 一起糊掉；
+ *   · 数据色一律**算出来**：底轨 ＝ 主文字往卡面混，填充 ＝ 强调色，超目标 ＝ 危险色（三档都是 token）。
+ */
+import { skinVar } from '../skin/contract.js';
+import { progressRingSlot } from './attrs.js';
+/** 换行（仓库口径：不写字面换行转义）。 */
+const LF = String.fromCharCode(10);
+/** 环下大字的字号（px）：两档之间只差这一处——窄容器不让大字把版面顶宽。 */
+export const PROGRESS_RING_VALUE_PX = 44;
+const NARROW_VALUE_PX = 36;
+/** 窄容器阈值（px）：大字与小环一起收一档。**这是本件自己的宽度**（`@container` 判的），不是视口宽度。 */
+const NARROW_PX = 420;
+/** 环的最大直径（px）：容器再宽也不让环长成一块空地（读数是主角、环是标尺）。 */
+export const PROGRESS_RING_MAX_DIAMETER_PX = 280;
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export function progressRingCss(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-ring';
+    const s = (slot) => root + ' .' + progressRingSlot(slot, p);
+    /* 槽类名（**不带 scope**）：只用在**已经落进本件某条选择器内部**的位置（前缀由外层那条选择器给）。
+       拿 `s()` 去拼后代／兄弟选择器会拼出 `.page-ui .a .page-ui .b` —— 第二条 `.page-ui` 永远匹配不到，
+       规则「看着在、其实不生效」（2026-09 样张页上抓到过一次：超目标态那三处换色全没生效）。 */
+    const c = (slot) => '.' + progressRingSlot(slot, p);
+    return [
+        '/* progress-ring（进度环 · 形态 A「半环 ＋ 环下大字 ＋ 右侧读数」）：一块「已完成／目标」的环。',
+        '   环是内联 SVG（弧长按 2πr 的一半算），大字是 HTML ⇒ 窄容器里读数不随 SVG 一起缩放。 */',
+        box + ' {',
+        /* 宽度判据的落点：本件是**自己的容器**——嵌进侧栏／面板／卡片时照样按自己的宽度折行。 */
+        '  container-type: inline-size;',
+        /* 宿主页不保证是 `border-box`（真页面默认 content-box）：本件带边框／内距的位子
+           在那种页里会比容器宽出边框那几像素 ⇒ 在本件**自己的子树里**把 `box-sizing` 钉成 `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: 3px 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.35;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        s('stamp') + ' {',
+        '  flex: none;',
+        '  margin-left: auto;',
+        '  color: ' + skinVar('ink-3') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  font-weight: 600;',
+        '  font-variant-numeric: tabular-nums;',
+        '  white-space: nowrap;',
+        '}',
+        /* 环与右侧读数：一排两格，`flex-wrap` 让它在窄容器里自己叠起来（不判视口宽度）。 */
+        s('split') + ' {',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  align-items: center;',
+        '  gap: 12px 20px;',
+        '  min-width: 0;',
+        '}',
+        s('gauge') + ' {',
+        '  flex: 1 1 220px;',
+        '  min-width: 0;',
+        '}',
+        /* 环：宽度跟着容器走，但长不过 `PROGRESS_RING_MAX_DIAMETER_PX`（环是标尺、不是主角）。 */
+        s('svg') + ' {',
+        '  display: block;',
+        '  width: 100%;',
+        '  max-width: ' + String(PROGRESS_RING_MAX_DIAMETER_PX) + 'px;',
+        '  height: auto;',
+        '  margin: 0 auto;',
+        '  overflow: visible;',
+        '}',
+        '/* 底轨：主文字往卡面混一档（不是硬编码灰），换皮自动跟着走。 */',
+        s('trk') + ' {',
+        '  stroke: color-mix(in srgb, ' + skinVar('ink') + ' 13%, ' + skinVar('surface') + ');',
+        '}',
+        '/* 填充弧：强调色是**非文本**档，正好用在这里；超目标换危险色（形状不变：弧画满）。 */',
+        s('fil') + ' {',
+        '  stroke: ' + skinVar('accent') + ';',
+        '}',
+        box + '.is-over ' + c('fil') + ' {',
+        '  stroke: ' + skinVar('danger') + ';',
+        '}',
+        /* 环下大字：值（大字）／单位／分母另起一行／百分数一枚胶囊——四枚都在同一行里换行，不压字。 */
+        s('hero') + ' {',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  align-items: baseline;',
+        '  justify-content: center;',
+        '  gap: 2px 8px;',
+        '  margin: 8px 0 0;',
+        '  min-width: 0;',
+        '}',
+        s('value') + ' {',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font-num') + ';',
+        '  font-size: ' + String(PROGRESS_RING_VALUE_PX) + 'px;',
+        '  font-weight: 700;',
+        '  line-height: 1.05;',
+        '  letter-spacing: -.02em;',
+        '  font-variant-numeric: tabular-nums;',
+        '  white-space: nowrap;',
+        '}',
+        s('unit') + ' {',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-size: ' + skinVar('fs-sm') + ';',
+        '  font-weight: 600;',
+        '}',
+        '/* 分母占满一整行（`flex-basis:100%`）：它再长也只把自己这行撑开，不把大字挤窄。 */',
+        s('denom') + ' {',
+        '  flex: 1 0 100%;',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-family: ' + skinVar('font-num') + ';',
+        '  font-size: ' + skinVar('fs-sm') + ';',
+        '  font-variant-numeric: tabular-nums;',
+        '  text-align: center;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* 百分数：那条弧的读数。**数字永不换行、永不截断**（它是本件的第二识别特征）。 */',
+        s('pct') + ' {',
+        '  flex: none;',
+        '  padding: 1px 8px;',
+        '  border-radius: ' + skinVar('radius-pill') + ';',
+        '  background: ' + skinVar('accent-soft') + ';',
+        '  color: ' + skinVar('accent-text') + ';',
+        '  font-family: ' + skinVar('font-num') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  font-weight: 700;',
+        '  font-variant-numeric: tabular-nums;',
+        '  white-space: nowrap;',
+        '}',
+        box + '.is-over ' + c('pct') + ' {',
+        '  background: ' + skinVar('danger-soft') + ';',
+        '  color: ' + skinVar('danger') + ';',
+        '}',
+        /* 右侧读数：宽容器多列、窄容器一列；名字可换行，值永不换行、永不截断。 */
+        s('kvs') + ' {',
+        '  flex: 2 1 260px;',
+        '  display: grid;',
+        '  grid-template-columns: repeat(auto-fit, minmax(min(190px, 100%), 1fr));',
+        '  gap: 0 20px;',
+        '  min-width: 0;',
+        '}',
+        s('kv') + ' {',
+        '  display: flex;',
+        '  align-items: baseline;',
+        '  gap: 10px;',
+        '  min-width: 0;',
+        '  padding: 8px 0;',
+        '  border-top: 1px solid ' + skinVar('line') + ';',
+        '  font-size: ' + skinVar('fs-sm') + ';',
+        '}',
+        s('kv-label') + ' {',
+        '  flex: 1 1 auto;',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  overflow-wrap: anywhere;',
+        '}',
+        s('kv-value') + ' {',
+        '  flex: none;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font-num') + ';',
+        '  font-weight: 700;',
+        '  font-variant-numeric: tabular-nums;',
+        '  white-space: nowrap;',
+        '}',
+        /* 脚注那句人话：**超目标时换色**（不只换色——同一句话里带差额与百分比，字也在说话）。 */
+        s('note') + ' {',
+        '  margin: 0;',
+        '  padding-top: 10px;',
+        '  border-top: 1px solid ' + skinVar('line') + ';',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-size: ' + skinVar('fs-sm') + ';',
+        '  line-height: 1.6;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        box + '.is-over ' + c('note') + ' {',
+        '  color: ' + skinVar('danger') + ';',
+        '  font-weight: 600;',
+        '}',
+        '/* 本件自身不带可点元素。这一条是**地板**：调用方把环包成链接时，焦点必须看得见。 */',
+        box + ' :focus-visible {',
+        '  outline: 2px solid ' + skinVar('accent') + ';',
+        '  outline-offset: 2px;',
+        '}',
+        '/* 窄容器（<' + String(NARROW_PX) + 'px）：大字与环各收一档——环占满整行、读数跟着缩，',
+        '   免得环下大字把自己撑出容器。判的是**本件自己的宽度**（本件会被嵌进侧栏／面板／卡片）。 */',
+        '@container (max-width: ' + String(NARROW_PX) + 'px) {',
+        '  ' + s('value') + ' {',
+        '    font-size: ' + String(NARROW_VALUE_PX) + 'px;',
+        '  }',
+        '  ' + s('svg') + ' {',
+        '    max-width: 220px;',
+        '  }',
+        '  ' + s('kvs') + ' {',
+        '    grid-template-columns: minmax(0, 1fr);',
+        '  }',
+        '}',
+    ].join(LF);
+}
+//# sourceMappingURL=style.js.map

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

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

package/dist/components/punch-strip/index.d.ts

@@ -0,0 +1,12 @@
+/** punch-strip · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  四件出口：`renderPunchStrip(input)`（产标记，零 DOM）／`punchStripCss()`（样式段）／
+ *  两个常量（`PUNCH_STRIP_MAX_CELLS`／`PUNCH_STRIP_EMPTY_MARK`）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ *  样式由本族汇总入口 `sheetCss()` 一并挂上（与另四件同一条口径）。
+ */
+export { PUNCH_STRIP_EMPTY_MARK, PUNCH_STRIP_MAX_CELLS, renderPunchStrip } from './render.js';
+export type { PunchCellInput, PunchStripInput } from './render.js';
+export { PUNCH_STRIP_BOX_HEIGHT_PX, PUNCH_STRIP_BOX_RADIUS_PX, punchStripCss } from './style.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/punch-strip/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/punch-strip/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC9F,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/punch-strip/index.js

@@ -0,0 +1,11 @@
+/** punch-strip · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  四件出口：`renderPunchStrip(input)`（产标记，零 DOM）／`punchStripCss()`（样式段）／
+ *  两个常量（`PUNCH_STRIP_MAX_CELLS`／`PUNCH_STRIP_EMPTY_MARK`）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ *  样式由本族汇总入口 `sheetCss()` 一并挂上（与另四件同一条口径）。
+ */
+export { PUNCH_STRIP_EMPTY_MARK, PUNCH_STRIP_MAX_CELLS, renderPunchStrip } from './render.js';
+export { PUNCH_STRIP_BOX_HEIGHT_PX, PUNCH_STRIP_BOX_RADIUS_PX, punchStripCss } from './style.js';
+//# sourceMappingURL=index.js.map

package/dist/components/punch-strip/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/punch-strip/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE9F,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}