base-paint 0.3.13 → 0.3.15

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,207 @@
+/** 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);
+}

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,65 @@
+/** 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;

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"}

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,11 @@
+/** 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';

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,113 @@
+/** 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'),
+    };
+}

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"}