base-paint 0.3.13 → 0.3.15

package/dist/components/spread-dist/render.js

@@ -0,0 +1,108 @@
+/** spread-dist · **渲染**（纯函数产 HTML；两档各一支骨架：逐日范围柱／分位尺）。
+ *
+ *  —— 两档 ——
+ *   · `range`  每天都摊成一根从最低到最高的竖条，中间的粗块是中位数，横轴是日子，纵轴是同一个读数；
+ *   · `quantile` 结论一句话在上，下面一档一格写着「分位名 ＋ 说明句 ＋ 那个数」，正中那一档是中位。
+ *  它替掉的两种错法：
+ *   · 只给一个平均值 —— 离群点被抹平，读不出「中间那批落在哪」；
+ *   · 用一张条形图硬扛分布 —— 一根柱只表示一个数，那是「几个值的对比」，不是一批读数的形状。
+ *
+ *  四条硬口径（判据断的就是它们）：
+ *   · **算数不在这里**：轴域、刻度文字与刻度位置、每根条与每个中位块的百分比、卡头那句统计、
+ *     口径句与无障碍名都在 `forms.ts` 算好；这一支只把**算出来的百分比**写进行内样式
+ *     （一条记录一个数），静态规则一律住 `style.ts`；
+ *   · **刻度与轴域是同一份真值**：每枚纵轴刻度的 `top` 与每根柱的 `bottom`／`height` 出自同一个
+ *     `upPct()` —— 读者按刻度读一根柱，读到的是这根柱真正的数；
+ *   · **色不是唯一信息**：范围条是淡洗的**面**、中位块是实底的**条**（深浅两档形）＋ 图例给字；
+ *     分位尺那边正中那一档有**选中面**（软底＋主色字＋主色描边）＋ 它自己那枚档名；
+ *   · **本件不带可点元素、不带脚本**：没有 `runtime.ts`；调用方把某一天包成入口时，
+ *     件里那条 `:focus-visible` 地板保证焦点看得见（见 `README.md`）。
+ */
+import { esc } from '../shared/escape.js';
+import { SPREAD_DIST_CLASS, spreadDistSlot } from './attrs.js';
+import { normalizeSpreadDist } from './model.js';
+/** 卡头：标题 ＋ 口径那枚 ＋ **从数据算出来**的那句统计。 */
+function headHtml(m) {
+    const parts = ['<div class="' + spreadDistSlot('hd') + '">'];
+    parts.push('<h4 class="' + spreadDistSlot('title') + '">' + esc(m.title) + '</h4>');
+    if (m.stamp !== undefined) {
+        parts.push('<span class="' + spreadDistSlot('stamp') + '">' + esc(m.stamp) + '</span>');
+    }
+    parts.push('<span class="' + spreadDistSlot('tail') + '">' + esc(m.tail) + '</span>');
+    parts.push('</div>');
+    return parts.join('');
+}
+/** 图例：每一项是「形 ＋ 字」——形由 `is-*` 给，字说清那是什么（形不是唯一信息）。 */
+function legendHtml(m) {
+    if (m.legend.length === 0)
+        return '';
+    return '<ul class="' + spreadDistSlot('legend') + '">'
+        + m.legend.map((one) => '<li class="' + spreadDistSlot('legend-item') + '">'
+            + '<i class="' + spreadDistSlot('legend-mark') + ' is-' + one.kind + '" aria-hidden="true"></i>'
+            + esc(one.text) + '</li>').join('')
+        + '</ul>';
+}
+/** 脚注一句人话（不给就用本形态的口径句）。 */
+function noteHtml(m) {
+    return '<p class="' + spreadDistSlot('note') + '">' + esc(m.note) + '</p>';
+}
+/** 形态 `range`：坐标框（纵轴刻度列 ‖ 逐日柱区）＋ 横轴日子行 → 图例 → 脚注。 */
+function renderRange(m) {
+    const parts = [headHtml(m)];
+    parts.push('<div class="' + spreadDistSlot('plotbox') + '">');
+    /* 纵轴刻度列：每枚**绝对定位在它自己那个值的位置上**（`top` 是算出来的百分比，与柱子同一个映射），
+       故刻度文字与柱子读数永远对得上；只有最高那一枚带单位。 */
+    parts.push('<div class="' + spreadDistSlot('yticks') + '" aria-hidden="true">'
+        + m.yTicks.map((t) => '<span class="' + spreadDistSlot('ytick') + '" style="top: '
+            + String(t.topPct) + '%">' + esc(t.text) + '</span>').join('')
+        + '</div>');
+    parts.push('<div class="' + spreadDistSlot('days') + '" role="img" aria-label="' + esc(m.ariaLabel) + '">');
+    for (const day of m.days) {
+        parts.push('<span class="' + spreadDistSlot('day') + '" title="' + esc(day.title) + '">');
+        parts.push('<i class="' + spreadDistSlot('day-range') + '" aria-hidden="true" style="bottom: '
+            + String(day.bottomPct) + '%; height: ' + String(day.heightPct) + '%"></i>');
+        if (day.medianPct !== null) {
+            parts.push('<i class="' + spreadDistSlot('day-median') + '" aria-hidden="true" style="bottom: '
+                + String(day.medianPct) + '%"></i>');
+        }
+        parts.push('</span>');
+    }
+    parts.push('</div>');
+    parts.push('<div class="' + spreadDistSlot('xax') + '" aria-hidden="true">'
+        + m.xLabels.map((t) => '<span class="' + spreadDistSlot('xlabel') + '">' + esc(t) + '</span>').join('')
+        + '</div>');
+    parts.push('</div>');
+    parts.push(legendHtml(m));
+    parts.push(noteHtml(m));
+    return parts.join('');
+}
+/** 形态 `quantile`：**结论一句话在上、读数在下**（先给答案，再给读数）→ 脚注。 */
+function renderQuantile(m) {
+    const parts = [headHtml(m)];
+    parts.push('<p class="' + spreadDistSlot('lead') + '">' + esc(m.lead) + '</p>');
+    parts.push('<div class="' + spreadDistSlot('stops') + '" role="img" aria-label="' + esc(m.ariaLabel) + '">');
+    for (const stop of m.stops) {
+        parts.push('<div class="' + spreadDistSlot('stop') + (stop.median ? ' is-median' : '') + '">');
+        parts.push('<span class="' + spreadDistSlot('stop-name') + '">' + esc(stop.name) + '</span>');
+        if (stop.label !== '') {
+            parts.push('<span class="' + spreadDistSlot('stop-label') + '">' + esc(stop.label) + '</span>');
+        }
+        parts.push('<b class="' + spreadDistSlot('stop-value') + '">' + esc(stop.valueText) + '</b>');
+        parts.push('</div>');
+    }
+    parts.push('</div>');
+    parts.push(noteHtml(m));
+    return parts.join('');
+}
+/** 形态 → 骨架（分派写在这里，加第三形态就是加一支）。 */
+const SKELETONS = {
+    range: renderRange,
+    quantile: renderQuantile,
+};
+/** 渲染分布与分位（纯函数：同样的入参恒产同样的字节；转义只经 `shared/escape.ts`）。 */
+export function renderSpreadDist(input) {
+    const m = normalizeSpreadDist(input);
+    const extra = m.extraClass === undefined ? '' : ' ' + m.extraClass;
+    return '<div class="' + SPREAD_DIST_CLASS + ' is-' + m.form + extra + '">'
+        + SKELETONS[m.form](m) + '</div>';
+}

package/dist/components/spread-dist/render.js.map

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

package/dist/components/spread-dist/scale.d.ts

@@ -0,0 +1,35 @@
+/** 两位小数（所有出出去的百分比都过它：行内样式里不许出现 0.30000000000000004）。 */
+export declare const round2: (v: number) => number;
+/** 读数里的数字（`title`／无障碍名用：最多两位小数，末尾的零去掉）。 */
+export declare function plainText(v: number): string;
+/** 单位那一段（进了可见文本，故与读数同一处拼）：**没有单位就什么都不加**。 */
+export declare const unitPart: (unit: string | undefined) => string;
+/** 轴域：好看的上下界 ＋ 间隔 ＋ 间隔的小数位 ＋ 刻度枚数。 */
+export interface Axis {
+    readonly lo: number;
+    readonly hi: number;
+    readonly step: number;
+    readonly decimals: number;
+    /** 刻度枚数：**由 `lo`／`hi`／`step` 反算出来**，不是一个独立的输入。 */
+    readonly ticks: number;
+}
+/** 把数据区间撑成一段好看的轴域。
+ *
+ *  **轴顶＝`ceil(最大值/步长)×步长`、轴底＝`floor(最小值/步长)×步长`，枚数由这两头反算**
+ *  —— 刻度文字、刻度位置与柱子坐标**都从这一个 `Axis` 出**，三者不可能走散
+ *  （camel 先例 `scatter-fit/scale.ts` 的审查教训：轴域与刻度一旦解耦，读者按刻度读出来的值会系统性偏小）。
+ *
+ *  两个边界：
+ *   · **全部读数同一个值**（`min === max`）：撑开半档出来（不然除零；也不许静默画成一条贴轴的线）；
+ *   · 步长小数位有限（至多 6 位）：撑开后若两头量化成同一个数，把上界抬一个步长。 */
+export declare function niceAxis(min: number, max: number, target?: number): Axis;
+/** 一段轴域上的刻度值（从下往上：第 0 枚＝轴底）。 */
+export declare function tickValues(axis: Axis): number[];
+/** 刻度文字（**从大往小**：纵轴口径）；只有最高那一枚带单位。 */
+export declare function tickTexts(axis: Axis, unit: string | undefined): string[];
+/** **唯一的坐标映射**：数据 → 从下往上的百分比（0…100）。
+ *
+ *  逐日柱区里每根范围条的 `bottom`／`height`、每个中位块的 `bottom`、每枚纵轴刻度的 `top`
+ *  都只经这一支 —— 刻度与柱子是同一份真值，读者按刻度读出来的值就是柱子的位置。 */
+export declare function upPct(value: number, axis: Axis): number;
+//# sourceMappingURL=scale.d.ts.map

package/dist/components/spread-dist/scale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scale.d.ts","sourceRoot":"","sources":["../../../src/components/spread-dist/scale.ts"],"names":[],"mappings":"AAwBA,wDAAwD;AACxD,eAAO,MAAM,MAAM,GAAI,GAAG,MAAM,KAAG,MAA8B,CAAC;AA0BlE,2CAA2C;AAC3C,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK3C;AAED,6CAA6C;AAC7C,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,GAAG,SAAS,KAAG,MAAgD,CAAC;AAIrG,sCAAsC;AACtC,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAmBD;;;;;;;;iDAQiD;AACjD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAA+B,GAAG,IAAI,CAehG;AAED,gCAAgC;AAChC,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CAI/C;AAED,sCAAsC;AACtC,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAGxE;AAID;;;+CAG+C;AAC/C,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAIvD"}

package/dist/components/spread-dist/scale.js

@@ -0,0 +1,124 @@
+/** spread-dist · **数字与坐标**（本件第三份源码件：`forms.ts` 的两个骨架都用它，它谁都不用）。
+ *
+ *  为什么有这一件：校验 ＋ 装配 ＋ 算数挤在一件里会超本包告警线 350（`packages/base-render/AGENTS.md`）。
+ *  切口按「算数面／装配面／入参面」分（先例 `scatter-fit/scale.ts`）：
+ *   · 本件：纯算数与格式化（轴域、刻度文字与刻度位置、坐标映射、数字写法）；
+ *   · `forms.ts`：已校验的入参 → 两个骨架的模型（调本件）；
+ *   · `model.ts`：入参校验与归一化入口。
+ *
+ *  三条口径：
+ *   1. **坐标只有一处算**：`upPct()` 是本件唯一的坐标映射（数据 → 从下往上的百分比）。
+ *      逐日柱区里**每根范围条的 `bottom`／`height`、每个中位块的 `bottom`、每一枚纵轴刻度的 `top`**
+ *      全都从它出；刻度**文字**也从同一个轴域出 —— 两处各写一套必然走散
+ *      （先例：轴域 0…6000 而刻度铺到 8,000，读者按刻度读出来的值系统性偏小）。
+ *   2. **不做轴内距**：数据直接落在轴上（轴底刻度＝底轴、轴顶刻度＝轴顶）。
+ *      柱是矩形，压到轴上不会像散点的圆那样出框 ⇒ 不需要内距，读者按刻度量一根柱**量得准**。
+ *   3. 本件不认形态、不碰标记：输入是数，输出还是数（或数拼成的字形）。
+ *
+ *  兄弟件那边同一段轴域算法各有一份（本仓契约：件与件只经对方 `index.ts` 互相引用，本批工艺又只许
+ *  **新建**文件、不许改 `scatter-fit`）——收口时若要合并，落点是共用位 `shared/axis.ts`。
+ */
+import { SPREAD_DIST_AXIS_TICKS } from './attrs.js';
+/* ── 小工具（数字 → 字；本件不引格式化库） ─────────────────────────── */
+/** 两位小数（所有出出去的百分比都过它：行内样式里不许出现 0.30000000000000004）。 */
+export const round2 = (v) => Number(v.toFixed(2));
+/** 夹到 `[0, 1]`（坐标永远不越轴域：喂进来的数在轴域外时也只是贴边，不画到框外）。 */
+const at01 = (t) => (t < 0 ? 0 : (t > 1 ? 1 : t));
+/** 三位分组（`1200` → `1,200`；负号留在最前）。 */
+function groupInt(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;
+}
+/** 定点位数上的数字（刻度用：位数由间隔定，同一根轴上位数一致）。
+ *  **量级大到 `toFixed` 只给指数写法时原样返回**（`1e+21`）——三位分组插进指数里会写成 `1e,+21`。 */
+function numText(v, decimals) {
+    const s = v.toFixed(decimals);
+    if (s.includes('e') || s.includes('E'))
+        return s;
+    const dot = s.indexOf('.');
+    return dot < 0 ? groupInt(s) : groupInt(s.slice(0, dot)) + s.slice(dot);
+}
+/** 读数里的数字（`title`／无障碍名用：最多两位小数，末尾的零去掉）。 */
+export function plainText(v) {
+    const s = String(Number(v.toFixed(2)));
+    if (s.includes('e') || s.includes('E'))
+        return s;
+    const dot = s.indexOf('.');
+    return dot < 0 ? groupInt(s) : groupInt(s.slice(0, dot)) + s.slice(dot);
+}
+/** 单位那一段（进了可见文本，故与读数同一处拼）：**没有单位就什么都不加**。 */
+export const unitPart = (unit) => (unit === undefined ? '' : ' ' + unit);
+/** 一步「好看」的间隔：1／2／2.5／5／10 × 10^k。 */
+function niceStep(raw) {
+    if (!Number.isFinite(raw) || raw <= 0)
+        return 1;
+    const mag = Math.pow(10, Math.floor(Math.log10(raw)));
+    for (const m of [1, 2, 2.5, 5])
+        if (raw <= m * mag * (1 + 1e-9))
+            return m * mag;
+    return 10 * mag;
+}
+/** 间隔要几位小数才写得准（2.5 → 1 位；0.25 → 2 位）。 */
+function stepDecimals(step) {
+    for (let d = 0; d <= 6; d += 1) {
+        const scaled = step * Math.pow(10, d);
+        if (Math.abs(scaled - Math.round(scaled)) < 1e-6)
+            return d;
+    }
+    return 6;
+}
+/** 把数据区间撑成一段好看的轴域。
+ *
+ *  **轴顶＝`ceil(最大值/步长)×步长`、轴底＝`floor(最小值/步长)×步长`，枚数由这两头反算**
+ *  —— 刻度文字、刻度位置与柱子坐标**都从这一个 `Axis` 出**，三者不可能走散
+ *  （camel 先例 `scatter-fit/scale.ts` 的审查教训：轴域与刻度一旦解耦，读者按刻度读出来的值会系统性偏小）。
+ *
+ *  两个边界：
+ *   · **全部读数同一个值**（`min === max`）：撑开半档出来（不然除零；也不许静默画成一条贴轴的线）；
+ *   · 步长小数位有限（至多 6 位）：撑开后若两头量化成同一个数，把上界抬一个步长。 */
+export function niceAxis(min, max, target = SPREAD_DIST_AXIS_TICKS) {
+    let lo = min;
+    let hi = max;
+    if (!(hi > lo)) {
+        const pad = Math.abs(lo) > 0 ? Math.abs(lo) * 0.5 : 1;
+        lo -= pad;
+        hi += pad;
+    }
+    const step = niceStep((hi - lo) / (target - 1));
+    const decimals = stepDecimals(step);
+    const loNice = Number((Math.floor(lo / step + 1e-9) * step).toFixed(decimals));
+    let hiNice = Number((Math.ceil(hi / step - 1e-9) * step).toFixed(decimals));
+    if (!(hiNice > loNice))
+        hiNice = Number((loNice + step).toFixed(decimals));
+    const ticks = Math.max(2, Math.round((hiNice - loNice) / step) + 1);
+    return { lo: loNice, hi: hiNice, step, decimals, ticks };
+}
+/** 一段轴域上的刻度值（从下往上：第 0 枚＝轴底）。 */
+export function tickValues(axis) {
+    const out = [];
+    for (let i = 0; i < axis.ticks; i += 1)
+        out.push(Number((axis.lo + axis.step * i).toFixed(axis.decimals)));
+    return out;
+}
+/** 刻度文字（**从大往小**：纵轴口径）；只有最高那一枚带单位。 */
+export function tickTexts(axis, unit) {
+    const values = tickValues(axis).reverse();
+    return values.map((v, i) => numText(v, axis.decimals) + (i === 0 ? unitPart(unit) : ''));
+}
+/* ── 坐标映射（本件唯一的映射） ───────────────────────────────────── */
+/** **唯一的坐标映射**：数据 → 从下往上的百分比（0…100）。
+ *
+ *  逐日柱区里每根范围条的 `bottom`／`height`、每个中位块的 `bottom`、每枚纵轴刻度的 `top`
+ *  都只经这一支 —— 刻度与柱子是同一份真值，读者按刻度读出来的值就是柱子的位置。 */
+export function upPct(value, axis) {
+    const raw = (value - axis.lo) / (axis.hi - axis.lo);
+    const t = Number.isFinite(raw) ? raw : (value >= axis.hi ? 1 : 0);
+    return round2(at01(t) * 100);
+}

package/dist/components/spread-dist/scale.js.map

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

package/dist/components/spread-dist/style.d.ts

@@ -0,0 +1,8 @@
+/** 逐日柱区高度（px）：宽容器一档、窄容器一档。两份取值都在本文件里，判据读这里。 */
+export declare const SPREAD_DIST_DAYS_PX = 150;
+export declare const SPREAD_DIST_NARROW_DAYS_PX = 128;
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export declare function spreadDistCss(input?: {
+    readonly prefix?: string;
+}): string;
+//# sourceMappingURL=style.d.ts.map

package/dist/components/spread-dist/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../../src/components/spread-dist/style.ts"],"names":[],"mappings":"AAsBA,+CAA+C;AAC/C,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAM9C,4BAA4B;AAC5B,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CA0T1E"}