base-paint 0.3.13 → 0.3.15

package/dist/components/range-bar/model.js

@@ -0,0 +1,139 @@
+/** range-bar · **入参归一化与校验**（把 `any` 与说不出的 `unknown` 挡在门外，产出内部类型）。
+ *
+ *  三条口径（与 `page-head/model.ts` 同一份）：
+ *   1. **非法入参一律 `badInput()`**（抛 `BlocksError`）——不静默降级、不「尽量猜」：
+ *      猜出来的骨架会在页面上长成另一种东西，而调用方以为拿到了本件。
+ *   2. **出界不是"顺手指一下"**：区间落在轴外 ⇒ `badInput`（本件不裁剪、也不做跨午夜推断——
+ *      裁剪出来的长度是假的，读者会把它当成真时长）。
+ *   3. 归一化只做「形状」：把起点终点换成轴上的**百分比**（几何），时长字、日期写法归调用方。
+ */
+import { assertPlainObject, badInput, optExtraClass, optText, reqText } from '../shared/validate.js';
+import { RANGE_BAR_DEFAULT_TONE, RANGE_BAR_FORMS, RANGE_BAR_TEXT_MIN_FRACTION, RANGE_BAR_TONES, } from './attrs.js';
+/** 有限数字（区间端点与轴端点都走它）。 */
+function reqNumber(value, field) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        badInput(field + ' 必须是有限数字');
+    return value;
+}
+/** 轴的起止：`min < max`（相等的轴画不出长度）。 */
+function reqDomain(value) {
+    assertPlainObject(value, 'range-bar: input.domain');
+    const raw = value;
+    const min = reqNumber(raw.min, 'range-bar: input.domain.min');
+    const max = reqNumber(raw.max, 'range-bar: input.domain.max');
+    if (!(min < max))
+        badInput('range-bar: input.domain 必须 min < max（轴没有长度就画不出"多久"）');
+    return { min, max };
+}
+/** 深浅档：闭集外的数字／非数字一律拒。 */
+function reqTone(value, field) {
+    if (typeof value !== 'number' || !RANGE_BAR_TONES.includes(value)) {
+        badInput(field + ' 必须是 ' + RANGE_BAR_TONES.join('／') + ' 之一');
+    }
+    return value;
+}
+/** 一条泳道的区间：逐条校验落在轴内，并算出轴上的位置与长度。 */
+function reqIntervals(value, domain, laneField) {
+    if (!Array.isArray(value))
+        badInput(laneField + '.intervals 必须是数组');
+    const span = domain.max - domain.min;
+    const out = [];
+    for (let i = 0; i < value.length; i += 1) {
+        const field = laneField + '.intervals[' + i + ']';
+        const item = value[i];
+        assertPlainObject(item, field);
+        const raw = item;
+        const from = reqNumber(raw.from, field + '.from');
+        const to = reqNumber(raw.to, field + '.to');
+        if (!(from < to))
+            badInput(field + ' 必须 from < to（起止相同就没有长度）');
+        if (from < domain.min || to > domain.max) {
+            badInput(field + ' 落在轴外（[' + String(domain.min) + ', ' + String(domain.max)
+                + ']）：跨午夜／跨月请调用方拆成两段，本件不裁剪');
+        }
+        const left = ((from - domain.min) / span) * 100;
+        const width = ((to - from) / span) * 100;
+        const text = optText(raw.text, field + '.text');
+        out.push({
+            from,
+            to,
+            tone: raw.tone === undefined ? RANGE_BAR_DEFAULT_TONE : reqTone(raw.tone, field + '.tone'),
+            left,
+            width,
+            /* 段太窄就不写时长字（写了必然挤成一团或被裁）；时长另有行尾合计兜底。 */
+            text: text !== undefined && width >= RANGE_BAR_TEXT_MIN_FRACTION * 100 ? text : undefined,
+        });
+    }
+    return out;
+}
+/** 一条泳道：类别名必填、区间逐条校验、行尾合计可选。 */
+function reqLane(value, domain, index) {
+    const field = 'range-bar: input.lanes[' + String(index) + ']';
+    assertPlainObject(value, field);
+    const raw = value;
+    const label = reqText(raw.label, field + '.label');
+    if (raw.intervals === undefined)
+        badInput(field + '.intervals 必填（一条泳道没有区间就不该占一行）');
+    return {
+        label,
+        mark: optText(raw.mark, field + '.mark'),
+        total: optText(raw.total, field + '.total'),
+        intervals: reqIntervals(raw.intervals, domain, field),
+    };
+}
+/** 轴刻度：0 枚＝不出（写法归调用方，本件不猜时间与日期的格式）。 */
+function optAxis(value) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value))
+        badInput('range-bar: input.axis 必须是字符串数组');
+    if (value.length === 1)
+        badInput('range-bar: input.axis 至少 2 枚（一枚刻度指不出范围）');
+    const out = [];
+    for (let i = 0; i < value.length; i += 1)
+        out.push(reqText(value[i], 'range-bar: input.axis[' + i + ']'));
+    return out;
+}
+/** 头部合计位：两枚都要（只有值的合计读不出"这是什么合计"）。 */
+function optSummary(value) {
+    if (value === undefined)
+        return undefined;
+    assertPlainObject(value, 'range-bar: input.summary');
+    const raw = value;
+    return {
+        label: reqText(raw.label, 'range-bar: input.summary.label'),
+        value: reqText(raw.value, 'range-bar: input.summary.value'),
+    };
+}
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `RangeBarModel`，不再自己碰 `any`。 */
+export function normalizeRangeBar(input) {
+    assertPlainObject(input, 'renderRangeBar: input');
+    const raw = input;
+    const form = raw.form === undefined ? RANGE_BAR_FORMS[0] : raw.form;
+    if (!RANGE_BAR_FORMS.includes(form)) {
+        badInput('range-bar: input.form 必须是 ' + RANGE_BAR_FORMS.join('／')
+            + ' 之一（本件只落地形态 A「四类泳道＋行尾合计＋整点刻度」）');
+    }
+    const domain = reqDomain(raw.domain);
+    const lanes = raw.lanes;
+    if (!Array.isArray(lanes))
+        badInput('range-bar: input.lanes 必须是数组');
+    const laneModels = [];
+    for (let i = 0; i < lanes.length; i += 1)
+        laneModels.push(reqLane(lanes[i], domain, i));
+    return {
+        form: form,
+        title: reqText(raw.title, 'range-bar: input.title'),
+        use: optText(raw.use, 'range-bar: input.use'),
+        summary: optSummary(raw.summary),
+        axis: optAxis(raw.axis),
+        lanes: laneModels,
+        note: optText(raw.note, 'range-bar: input.note'),
+        extraClass: optExtraClass(raw.extraClass, 'range-bar: input.extraClass'),
+    };
+}
+/** 轴上的百分比串（**几何是形状事实**：渲染只读它，判据也读它）。 */
+export function rangeBarPercent(value) {
+    const rounded = Math.round(value * 10000) / 10000;
+    return String(rounded) + '%';
+}

package/dist/components/range-bar/model.js.map

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

package/dist/components/range-bar/render.d.ts

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

package/dist/components/range-bar/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/components/range-bar/render.ts"],"names":[],"mappings":"AA2FA,uDAAuD;AACvD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMrD"}

package/dist/components/range-bar/render.js

@@ -0,0 +1,86 @@
+/** range-bar · **渲染**（纯函数产 HTML；本件只有形态 A「四类泳道＋行尾合计＋整点刻度」一种骨架）。
+ *
+ *  —— 形态 A：四类泳道（每类一行）＋行尾合计＋整点刻度 ——
+ *
+ *  一条轴（两端各一条发丝线），**每类一行**：区间在轨道上的**长度就是"多久"**，
+ *  行尾那枚合计是该类的总时长／总天数。段够宽时，段里再写一遍时长字
+ *  （窄段不写：写了必然挤成一团或被裁——**时长永远有行尾合计兜底，语义不丢**）。
+ *
+ *  它替掉的三种错法：
+ *   · 只写开始时间（`09:30 开始工作`）——读不出"多长"；
+ *   · 用柱子画单点——柱子没有长度，长短差被画成高度差；
+ *   · 把区间写成一句「上午工作、下午运动」——起止与时长都要读者自己算。
+ *
+ *  三条硬口径（判据断的就是它们）：
+ *   · **轴刻度与泳道共用一张网格**（`display:contents`）⇒ 刻度两端永远对得上轨道两端；
+ *   · **段内时长字只在段够宽时上屏**（`RANGE_BAR_TEXT_MIN_FRACTION`），时长另有行尾合计；
+ *   · **窄档不横滑**：轨道是份数（`minmax(0,1fr)`），区间是百分比；刻度标签 `flex-wrap` ＋ 8px 列距，
+ *     再窄也只换行、不压字。
+ */
+import { esc } from '../shared/escape.js';
+import { RANGE_BAR_CLASS, rangeBarSlot, } from './attrs.js';
+import { normalizeRangeBar, rangeBarPercent, } from './model.js';
+/** 头部那一排：标题 ＋ 用途 ＋ 合计（合计 `margin-left:auto` 顶到右缘，窄档自己折行）。 */
+function headHtml(m) {
+    const parts = ['<div class="' + rangeBarSlot('hd') + '">'];
+    parts.push('<b class="' + rangeBarSlot('title') + '">' + esc(m.title) + '</b>');
+    if (m.use !== undefined)
+        parts.push('<span class="' + rangeBarSlot('use') + '">' + esc(m.use) + '</span>');
+    if (m.summary !== undefined) {
+        parts.push('<span class="' + rangeBarSlot('sum') + '">'
+            + '<i class="' + rangeBarSlot('sum-label') + '">' + esc(m.summary.label) + '</i>'
+            + '<b class="' + rangeBarSlot('sum-value') + '">' + esc(m.summary.value) + '</b>'
+            + '</span>');
+    }
+    parts.push('</div>');
+    return parts.join('');
+}
+/** 轴刻度：**与泳道同一张网格的第二条轨道**（`grid-column:2` 由样式钉住 ⇒ 两端对得上轨道两端）。 */
+function axisHtml(axis) {
+    const ticks = axis.map((t) => '<i>' + esc(t) + '</i>').join('');
+    return '<div class="' + rangeBarSlot('ax') + '">'
+        + '<span class="' + rangeBarSlot('ax-ticks') + '">' + ticks + '</span></div>';
+}
+/** 一个区间：位置与长度都是百分比；段里的时长字**只在段够宽时**才在归一化期留下。 */
+function intervalHtml(iv) {
+    return '<b class="' + rangeBarSlot('iv') + ' is-l' + String(iv.tone) + '"'
+        + ' style="left:' + rangeBarPercent(iv.left) + ';width:' + rangeBarPercent(iv.width) + '">'
+        + (iv.text === undefined ? '' : '<u class="' + rangeBarSlot('iv-text') + '">' + esc(iv.text) + '</u>')
+        + '</b>';
+}
+/** 一条泳道：类别名（带记号）／轨道（区间）／行尾合计。 */
+function laneHtml(lane) {
+    const key = '<span class="' + rangeBarSlot('key') + '">'
+        + (lane.mark === undefined ? '' : '<i class="' + rangeBarSlot('mark') + '" aria-hidden="true">' + esc(lane.mark) + '</i>')
+        + esc(lane.label) + '</span>';
+    const rail = '<div class="' + rangeBarSlot('rail') + '">' + lane.intervals.map(intervalHtml).join('') + '</div>';
+    const total = lane.total === undefined ? '' : '<span class="' + rangeBarSlot('total') + '">' + esc(lane.total) + '</span>';
+    return '<div class="' + rangeBarSlot('lane') + '">' + key + rail + total + '</div>';
+}
+/** 形态 A 的骨架。0 条泳道＝空串（与"没内容不留空块"同口径）。
+ *  刻度行是**泳道网格的兄弟**（不是子元素）：它自带一副同样的列模板（见 `style.ts` 那段注释）——
+ *  挤进泳道那张网格里会把三个槽推错列（轨道被塞进第一栏 46px）。 */
+function renderLanes(m) {
+    if (m.lanes.length === 0)
+        return '';
+    const parts = [headHtml(m)];
+    if (m.axis.length > 0)
+        parts.push(axisHtml(m.axis));
+    parts.push('<div class="' + rangeBarSlot('lanes') + '">' + m.lanes.map(laneHtml).join('') + '</div>');
+    if (m.note !== undefined)
+        parts.push('<p class="' + rangeBarSlot('note') + '">' + esc(m.note) + '</p>');
+    return parts.join('');
+}
+/** 形态 → 骨架（本件只有一格；分派写在这里，加第二形态就是加一支）。 */
+const SKELETONS = {
+    lanes: renderLanes,
+};
+/** 渲染区间条（纯函数：同样的入参恒产同样的字节；转义只经 `shared/escape.ts`）。 */
+export function renderRangeBar(input) {
+    const m = normalizeRangeBar(input);
+    const body = SKELETONS[m.form](m);
+    if (body === '')
+        return '';
+    const extra = m.extraClass === undefined ? '' : ' ' + m.extraClass;
+    return '<div class="' + RANGE_BAR_CLASS + ' is-' + m.form + extra + '">' + body + '</div>';
+}

package/dist/components/range-bar/render.js.map

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

package/dist/components/range-bar/style.d.ts

@@ -0,0 +1,15 @@
+/** 轨道高（px）：一行的轨道是"坐标系"而不是柱子，所以比按钮矮，但仍要让区间看得见。 */
+export declare const RANGE_BAR_RAIL_HEIGHT_PX = 22;
+/** 左右两栏的宽度（px，宽档）：类别名一栏固定、合计一栏按下限起步（`auto` 会让两行不齐）。 */
+export declare const RANGE_BAR_KEY_COLUMN_PX = 54;
+export declare const RANGE_BAR_TOTAL_COLUMN_PX = 66;
+/** 窄档（`< RANGE_BAR_NARROW_PX`）的两栏宽度（px）：收一档把宽度让给轨道。 */
+export declare const RANGE_BAR_KEY_COLUMN_NARROW_PX = 46;
+export declare const RANGE_BAR_TOTAL_COLUMN_NARROW_PX = 54;
+/** 刻度标签之间的最小列距（px）：**"不压字"的机械保证**（判据量的是两两不重叠）。 */
+export declare const RANGE_BAR_TICK_GAP_PX = 8;
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export declare function rangeBarCss(input?: {
+    readonly prefix?: string;
+}): string;
+//# sourceMappingURL=style.d.ts.map

package/dist/components/range-bar/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../../src/components/range-bar/style.ts"],"names":[],"mappings":"AAwBA,iDAAiD;AACjD,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,uDAAuD;AACvD,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C,uDAAuD;AACvD,eAAO,MAAM,8BAA8B,KAAK,CAAC;AACjD,eAAO,MAAM,gCAAgC,KAAK,CAAC;AAEnD,kDAAkD;AAClD,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAcvC,4BAA4B;AAC5B,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAwNxE"}

package/dist/components/range-bar/style.js

@@ -0,0 +1,210 @@
+/** range-bar · **样式段**（本件唯一的样式来源）。
+ *
+ *  纪律（与本层其余件同一份）：
+ *   · 只经 `skinVar()` 读皮肤 —— 组件里**不写** `var(--ilife-…)`（兜底链只许住在 `skin/contract.ts`）；
+ *   · 全部规则 scope 在 `.<prefix>page-ui` 之下（不开本配方的页零命中）；不写 `:root`／`!important`、不新增 token 名；
+ *   · **宽度只许容器判**：布局靠 `@container` ＋ 内在尺寸 ＋ `flex-wrap`；本件不写任何 `@media`（视口宽 ≠ 组件宽）。
+ *
+ *  几何契约（判据钉住）：
+ *   · **轴刻度与泳道共用同一张网格**（`.lanes` 三轨 ＋ `.ax`／`.lane` 是 `display:contents`）
+ *     ⇒ 左右两栏宽度是**全表统一**的，刻度两端永远对得上轨道两端，不会一宽一窄；
+ *   · 轨道是份数（`minmax(0,1fr)`）、区间是百分比 ⇒ 总宽恒等于容器宽，390 档不横滑；
+ *   · 刻度标签 `flex-wrap` ＋ 8px 列距 ＋ `nowrap` ⇒ 再窄也只是换行，**不压字**（判据量两两不重叠）。
+ */
+import { skinVar } from '../skin/contract.js';
+import { RANGE_BAR_NARROW_PX, RANGE_BAR_TEXT_HIDE_BELOW_PX, rangeBarSlot, } from './attrs.js';
+/** 换行（仓库口径：不写字面换行转义）。 */
+const LF = String.fromCharCode(10);
+/** 轨道高（px）：一行的轨道是"坐标系"而不是柱子，所以比按钮矮，但仍要让区间看得见。 */
+export const RANGE_BAR_RAIL_HEIGHT_PX = 22;
+/** 左右两栏的宽度（px，宽档）：类别名一栏固定、合计一栏按下限起步（`auto` 会让两行不齐）。 */
+export const RANGE_BAR_KEY_COLUMN_PX = 54;
+export const RANGE_BAR_TOTAL_COLUMN_PX = 66;
+/** 窄档（`< RANGE_BAR_NARROW_PX`）的两栏宽度（px）：收一档把宽度让给轨道。 */
+export const RANGE_BAR_KEY_COLUMN_NARROW_PX = 46;
+export const RANGE_BAR_TOTAL_COLUMN_NARROW_PX = 54;
+/** 刻度标签之间的最小列距（px）：**"不压字"的机械保证**（判据量的是两两不重叠）。 */
+export const RANGE_BAR_TICK_GAP_PX = 8;
+/** 深浅阶梯：从强调色与次要面**算出来**的四种深度（不写死颜色 ⇒ 三套皮肤下都成立）。 */
+function ladder() {
+    const accent = skinVar('accent');
+    const soft = skinVar('surface-2');
+    return [
+        'color-mix(in srgb, ' + accent + ' 18%, ' + soft + ')',
+        'color-mix(in srgb, ' + accent + ' 40%, ' + soft + ')',
+        'color-mix(in srgb, ' + accent + ' 62%, ' + soft + ')',
+        skinVar('accent'),
+    ];
+}
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export function rangeBarCss(input) {
+    const p = input !== undefined && input !== null
+        && typeof input.prefix === 'string' && input.prefix !== '' ? input.prefix : 'ilife-';
+    const root = '.' + p + 'page-ui';
+    /* 槽位类的**唯一拼法**：scope（`.ilife-page-ui`）＋ 本件类名 —— 一条独立规则的完整选择器。
+       要把两个槽拼成**后代选择器**时，后半截用 `c()`（`c()` 不带 scope）：两个 `s()` 拼一起会写出
+       `.ilife-page-ui … .ilife-page-ui …`，那条规则永远命中不到。判据断的是"scope 恰好出现一次"。 */
+    const s = (slot) => root + ' .' + rangeBarSlot(slot, p);
+    const c = (slot) => '.' + rangeBarSlot(slot, p);
+    const k = ladder();
+    const out = [
+        '/* range-bar（区间条 · 形态 A「四类泳道＋行尾合计＋整点刻度」）：一条轴上摆起止区间，',
+        '   **长度就是「多久」**；行尾合计是该类的总时长。段够宽时，段里再写一遍时长字。',
+        '   层次不靠阴影与大圆角（小票纸零阴影、大字报刊零圆角）：靠发丝线、字重与深浅阶梯 ⇒ 换皮只换取值。 */',
+        root + ' .' + p + 'block-range-bar {',
+        /* 宽度判据的落点：本件是**自己的容器**——嵌进侧栏／面板／卡片时照样按自己的宽度收栏宽。 */
+        '  container-type: inline-size;',
+        '  display: grid;',
+        '  gap: 6px;',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font') + ';',
+        '  font-size: ' + skinVar('fs-body') + ';',
+        '  line-height: 1.5;',
+        '}',
+        '/* 头部：标题 ＋ 用途 ＋ 合计（合计顶右缘；容器一窄，三件自己折行，谁也不压谁）。 */',
+        s('hd') + ' {',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  align-items: baseline;',
+        '  gap: 4px 10px;',
+        '  min-width: 0;',
+        '}',
+        s('title') + ' {',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font-display') + ';',
+        '  font-size: ' + skinVar('fs-h2') + ';',
+        '  font-weight: 700;',
+        '  line-height: 1.25;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        s('use') + ' {',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  font-weight: 600;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        s('sum') + ' {',
+        '  display: flex;',
+        '  align-items: baseline;',
+        '  gap: 6px;',
+        '  margin-left: auto;',
+        '  min-width: 0;',
+        '}',
+        s('sum-label') + ' {',
+        '  color: ' + skinVar('ink-3') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '}',
+        s('sum-value') + ' {',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font-num') + ';',
+        '  font-size: ' + skinVar('fs-h3') + ';',
+        '  font-weight: 700;',
+        '  font-variant-numeric: tabular-nums;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* **刻度行与泳道用同一副列模板**（`.ax` 与 `.lanes` 各是一张网格，模板逐字相同）',
+        '   ⇒ 轨道宽恒等、刻度两端永远对得上轨道两端。左右两栏是**定宽**（宽档 54／66，窄档 46／54）：',
+        '   定宽才谈得上"两张网格列宽恒等"（`auto` 会按各自内容算，两边就错开了）。',
+        '   第三轨装合计（时长／日期），**换行不截断**：更长就折行，绝不写 `…`。 */',
+        s('ax') + ' {',
+        '  display: grid;',
+        '  grid-template-columns: ' + String(RANGE_BAR_KEY_COLUMN_PX) + 'px minmax(0, 1fr) ' + String(RANGE_BAR_TOTAL_COLUMN_PX) + 'px;',
+        '  gap: 4px ' + String(RANGE_BAR_TICK_GAP_PX) + 'px;',
+        '  align-items: center;',
+        '  min-width: 0;',
+        '}',
+        s('lanes') + ' {',
+        '  display: grid;',
+        '  grid-template-columns: ' + String(RANGE_BAR_KEY_COLUMN_PX) + 'px minmax(0, 1fr) ' + String(RANGE_BAR_TOTAL_COLUMN_PX) + 'px;',
+        '  gap: 4px ' + String(RANGE_BAR_TICK_GAP_PX) + 'px;',
+        '  align-items: center;',
+        '  min-width: 0;',
+        '}',
+        '/* 一条泳道＝**三个槽直接落进上面那张网格**（`display:contents`）。',
+        '   注意：刻度行**不在**这张网格里——它另开一张同样模板的网格。',
+        '   刻度要是也挤进来（`grid-column:2` 占掉第一行第二轨），后续自动放置会把每条泳道',
+        '   的三个槽推错列（轨道被塞进第一栏 46px）——2026-09 判据量"左侧越界 11px"抓到的就是这个。 */',
+        s('lane') + ' {',
+        '  display: contents;',
+        '}',
+        '/* 刻度：一律落在轨道那一栏；`flex-wrap` ＋ 列距 ⇒ 再窄也只是换行，不压字。 */',
+        s('ax-ticks') + ' {',
+        '  grid-column: 2;',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  align-items: center;',
+        '  justify-content: space-between;',
+        '  gap: 2px ' + String(RANGE_BAR_TICK_GAP_PX) + 'px;',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink-3') + ';',
+        '  font-family: ' + skinVar('font-num') + ';',
+        '  font-size: 10px;',
+        '  line-height: 1.4;',
+        '  font-variant-numeric: tabular-nums;',
+        '}',
+        s('ax-ticks') + ' > i {',
+        '  font-style: normal;',
+        '  white-space: nowrap;',
+        '}',
+        '/* 泳道左栏：记号 ＋ 类别名（记号是"不只靠颜色"的第二路，名字长了自己折行）。 */',
+        s('key') + ' {',
+        '  display: flex;',
+        '  align-items: center;',
+        '  gap: 4px;',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  font-weight: 600;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        s('mark') + ' {',
+        '  flex: none;',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-size: 9px;',
+        '  font-style: normal;',
+        '  line-height: 1;',
+        '}',
+        '/* 泳道右栏：合计（时长／日期）。栏是**定宽**的，所以它 `overflow-wrap` 换行**不截断**',
+        '   （6 位时长／7 位金额在 54／66px 里一行放得下；更长的就折行，绝不写 `…`）。 */',
+        s('total') + ' {',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font-num') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  font-weight: 600;',
+        '  font-variant-numeric: tabular-nums;',
+        '  text-align: right;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* 轨道：两端各一条发丝线（读得出"轴从哪到哪"）；区间是百分比定位，恒在轴内。 */',
+        s('rail') + ' {',
+        '  position: relative;',
+        '  min-width: 0;',
+        '  height: ' + String(RANGE_BAR_RAIL_HEIGHT_PX) + 'px;',
+        '  border-left: 1px solid ' + skinVar('line') + ';',
+        '  border-right: 1px solid ' + skinVar('line') + ';',
+        '}',
+        s('iv') + ' {',
+        '  position: absolute;',
+        '  top: 3px;',
+        '  bottom: 3px;',
+        '  box-sizing: border-box;',
+        '  display: flex;',
+        '  align-items: center;',
+        '  justify-content: center;',
+        '  min-width: 1px;',
+        '  border-radius: ' + skinVar('radius-sm') + ';',
+        '  background: ' + k[1] + ';',
+        '  overflow: hidden;',
+        '}',
+    ];
+    for (const tone of [1, 2, 3, 4]) {
+        out.push(s('iv') + '.is-l' + String(tone) + ' { background: ' + k[tone - 1] + '; }');
+    }
+    out.push('/* 段里的时长字：写在**卡面小牌**上（深浅块上的字不赌色阶亮度，换皮也读得清）。', '   段太窄时本字不上屏（归一化期就判掉），时长另有行尾合计兜底。 */', s('iv-text') + ' {', '  text-decoration: none;', '  padding: 2px 4px;', '  border-radius: ' + skinVar('radius-sm') + ';', '  background: ' + skinVar('surface') + ';', '  color: ' + skinVar('ink') + ';', '  font-family: ' + skinVar('font-num') + ';', '  font-size: 10px;', '  font-weight: 600;', '  line-height: 1.2;', '  font-variant-numeric: tabular-nums;', '  white-space: nowrap;', '}', s('note') + ' {', '  margin: 0;', '  min-width: 0;', '  color: ' + skinVar('ink-3') + ';', '  font-size: ' + skinVar('fs-xs') + ';', '  line-height: 1.6;', '  overflow-wrap: anywhere;', '}', '/* 本件自身不带可点元素（拖动改起止是另一形态的活）。这一条是**地板**：', '   调用方若把某段包成链接，焦点必须看得见——不许只写 `outline:none` 而不给替代。 */', root + ' .' + p + 'block-range-bar :focus-visible {', '  outline: 2px solid ' + skinVar('accent') + ';', '  outline-offset: 2px;', '}', '/* 窄容器（<' + String(RANGE_BAR_NARROW_PX) + 'px）：左右两栏各收一档，宽度让给轨道', '   （判的是**本件自己的宽度**：本件会被嵌进侧栏／面板／卡片，视口宽 ≠ 组件宽）。 */', '@container (max-width: ' + String(RANGE_BAR_NARROW_PX) + 'px) {', '  ' + s('ax') + ',', '  ' + s('lanes') + ' {', '    grid-template-columns: ' + String(RANGE_BAR_KEY_COLUMN_NARROW_PX) + 'px minmax(0, 1fr) ' + String(RANGE_BAR_TOTAL_COLUMN_NARROW_PX) + 'px;', '  }', '}', '/* 极窄容器（<' + String(RANGE_BAR_TEXT_HIDE_BELOW_PX) + 'px）：轨道短到放不下时长字一牌', '   ⇒ 段内时长字一律不上屏（**宁可少写一遍，不许压字**；时长仍在行尾合计里）。 */', '@container (max-width: ' + String(RANGE_BAR_TEXT_HIDE_BELOW_PX - 1) + 'px) {', '  ' + s('iv-text') + ' {', '    display: none;', '  }', '}');
+    return out.join(LF);
+}

package/dist/components/range-bar/style.js.map

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

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

@@ -0,0 +1,55 @@
+/** rank-list · **标记契约**（渲染与调用方共用的唯一事实：类名／形态闭集／枚举闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-03-对照与榜单.mjs`，2026-09 用户裁定）
+ *  里的**形态 A「领奖台」**：前三名各占一张卡（第 1 名在中间、大一号），其余名次逐行排在下面；
+ *  **每一行都给条**（条比长度、数字读准值、占比读精确份额）。
+ *
+ *  它替掉的错法：只给名次与数值（读者读不出差多少）；只给条不给数（读者读不出准值）；
+ *  榜首与第 20 名同形同字号（读者一眼看不出谁在榜首）。
+ *
+ *  形态键写在 `RANK_LIST_FORMS`（闭集）：本件只有一格，但键必须存在——
+ *  「形态是骨架，不是地址」，日后加第二形态是在闭集里加一格，不是新开一件。
+ */
+/** 本件的类名根：全部槽位类名都是 `RANK_LIST_CLASS + '-' + 槽名`。 */
+export declare const RANK_LIST_CLASS = "ilife-block-rank-list";
+/** 槽位闭集（`render.ts` 与判据都用这里的名字拼类名，不各抄一份字面量）。 */
+export declare const RANK_LIST_SLOTS: readonly ["podium", "card", "rank", "name", "note", "unit", "value", "share", "list", "row", "mid", "bar", "fill", "caliber"];
+export type RankListSlot = (typeof RANK_LIST_SLOTS)[number];
+/** 槽类的类名（唯一拼法：别处不许再写 `RANK_LIST_CLASS + '-' + …`）。 */
+export declare function rankListSlot(slot: RankListSlot, prefix?: string): string;
+/** 形态闭集：本件只落地了形态 A「领奖台」。 */
+export declare const RANK_LIST_FORMS: readonly ["podium"];
+export type RankListForm = (typeof RANK_LIST_FORMS)[number];
+/** 领奖台的位数：前三名进卡，第 4 名起进逐行区。**改这个数就是改形态**，故住标记契约。 */
+export declare const RANK_LIST_PODIUM_SIZE = 3;
+/** 领奖台上某一张卡的位次类名（**唯一拼法**）。件内的状态名一律带件内语义前缀（`is-place-`），
+ *  **不许用 `is-first`／`is-second` 这类泛名**：泛名会与别的件标记里的同名状态撞上——
+ *  皮肤矩阵的「跨件零交集」按「一件的样式段不许提到另一件标记里的类名」守这一条。 */
+export declare function rankListPlaceClass(rank: number): string;
+/** 口径行左端的标签（与页头／其余件同一条写法）。 */
+export declare const RANK_LIST_CALIBER_LABEL = "\u53E3\u5F84";
+/** 一名：名称 ＋ 值 ＋ 占比（值给数不给串：条长与数字必须同源）。 */
+export interface RankListRow {
+    /** 名称（「超市买菜」／「鸡蛋灌饼」）；长了换行、不许 `…`。 */
+    readonly name: string;
+    /** 名称下的副语（「早餐 · 1 个」）；不给＝不出。 */
+    readonly note?: string;
+    /** 这一名的值（**有限数、≥ 0**）：条长与数字都按它算。 */
+    readonly value: number;
+    /** 占比（0–100 的有限数）：**口径归调用方**——窗内合计可能大于本表之和（例如末尾是「其他 N 笔」聚合行）。 */
+    readonly share: number;
+}
+/** 榜单入参。`rows` 必填且**按名次排好**（第 1 项＝第 1 名）：排名归调用方，本件不排序。 */
+export interface RankListInput {
+    /** 逐名：第 1 项是第 1 名。`[]` ⇒ 空串。 */
+    readonly rows: readonly RankListRow[];
+    /** 单位（`元`／`次`／`卡`）：给了就每格跟一枚 `small`，不给就不出。 */
+    readonly unit?: string;
+    /** 口径行：数怎么算的、占比按什么合计（如「占比按窗内 530.50 元合计」）；不给＝不出这一行。 */
+    readonly caliber?: string;
+    /** 形态键（闭集，缺省 `podium`）。 */
+    readonly form?: RankListForm;
+    /** 附加类名（空格分隔；逐个过类名正则）。 */
+    readonly extraClass?: string;
+}
+//# sourceMappingURL=attrs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.d.ts","sourceRoot":"","sources":["../../../src/components/rank-list/attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,oDAAoD;AACpD,eAAO,MAAM,eAAe,0BAA0B,CAAC;AAEvD,gDAAgD;AAChD,eAAO,MAAM,eAAe,+HA6BlB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,SAAW,GAAG,MAAM,CAE1E;AAED,4BAA4B;AAC5B,eAAO,MAAM,eAAe,qBAAsB,CAAC;AACnD,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,oDAAoD;AACpD,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC;;8CAE8C;AAC9C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,8BAA8B;AAC9B,eAAO,MAAM,uBAAuB,iBAAO,CAAC;AAE5C,wCAAwC;AACxC,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,CAAC;IACtC,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,0BAA0B;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B"}

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

@@ -0,0 +1,61 @@
+/** rank-list · **标记契约**（渲染与调用方共用的唯一事实：类名／形态闭集／枚举闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-03-对照与榜单.mjs`，2026-09 用户裁定）
+ *  里的**形态 A「领奖台」**：前三名各占一张卡（第 1 名在中间、大一号），其余名次逐行排在下面；
+ *  **每一行都给条**（条比长度、数字读准值、占比读精确份额）。
+ *
+ *  它替掉的错法：只给名次与数值（读者读不出差多少）；只给条不给数（读者读不出准值）；
+ *  榜首与第 20 名同形同字号（读者一眼看不出谁在榜首）。
+ *
+ *  形态键写在 `RANK_LIST_FORMS`（闭集）：本件只有一格，但键必须存在——
+ *  「形态是骨架，不是地址」，日后加第二形态是在闭集里加一格，不是新开一件。
+ */
+/** 本件的类名根：全部槽位类名都是 `RANK_LIST_CLASS + '-' + 槽名`。 */
+export const RANK_LIST_CLASS = 'ilife-block-rank-list';
+/** 槽位闭集（`render.ts` 与判据都用这里的名字拼类名，不各抄一份字面量）。 */
+export const RANK_LIST_SLOTS = [
+    /** 领奖台那一区（前三名并排的三张卡）。 */
+    'podium',
+    /** 领奖台上的一张卡（名次／名称／值＋单位／占比／条）。 */
+    'card',
+    /** 名次（领奖台档写「第 N 名」，其余行写序号）。**放行首**：扫读榜单先看名次。 */
+    'rank',
+    /** 名称（榜单的主角：条与值都从它派生）。 */
+    'name',
+    /** 名称下的副语（「早餐 · 1 个」／「3 次 · 晚餐为主」）；不给＝不出这一行。 */
+    'note',
+    /** 值的单位（`元`／`次`／`卡`）：小一号跟在数字后。 */
+    'unit',
+    /** 这一名的读数（含单位）。 */
+    'value',
+    /** 占比（`31.7%`）：份额的精确读法，口径归调用方。 */
+    'share',
+    /** 第 4 名及以后的那一组行。 */
+    'list',
+    /** 第 4 名及以后的一行。 */
+    'row',
+    /** 行里「名称 ＋ 条」合成的那一格（**条在名称下面另起一行**：窄档也不挤名字）。 */
+    'mid',
+    /** 条的外框（全榜共用一条刻度：长度＝这一名的值 ÷ 榜首的值）。 */
+    'bar',
+    /** 条的填充。 */
+    'fill',
+    /** 口径行：这条榜单的数怎么算的、占比按什么合计（弱文字，可很长、必须能换行）。 */
+    'caliber',
+];
+/** 槽类的类名（唯一拼法：别处不许再写 `RANK_LIST_CLASS + '-' + …`）。 */
+export function rankListSlot(slot, prefix = 'ilife-') {
+    return prefix + 'block-rank-list-' + slot;
+}
+/** 形态闭集：本件只落地了形态 A「领奖台」。 */
+export const RANK_LIST_FORMS = ['podium'];
+/** 领奖台的位数：前三名进卡，第 4 名起进逐行区。**改这个数就是改形态**，故住标记契约。 */
+export const RANK_LIST_PODIUM_SIZE = 3;
+/** 领奖台上某一张卡的位次类名（**唯一拼法**）。件内的状态名一律带件内语义前缀（`is-place-`），
+ *  **不许用 `is-first`／`is-second` 这类泛名**：泛名会与别的件标记里的同名状态撞上——
+ *  皮肤矩阵的「跨件零交集」按「一件的样式段不许提到另一件标记里的类名」守这一条。 */
+export function rankListPlaceClass(rank) {
+    return 'is-place-' + String(rank);
+}
+/** 口径行左端的标签（与页头／其余件同一条写法）。 */
+export const RANK_LIST_CALIBER_LABEL = '口径';