base-paint 0.3.15 → 0.3.16

package/dist/components/portion-gauge/fields.js

@@ -0,0 +1,172 @@
+/** portion-gauge · **入参小件**（形状校验与数字写法；`model.ts` 只管「算什么」，本文件管「收不收」）。
+ *
+ *  为什么独立成件：本件两档（换算三栏／量感条）的行数与量感那一份都要逐字段校验，攒在 `model.ts` 里
+ *  过了本包的行数告警线（350 行／LF 口径，见 `packages/base-render/AGENTS.md`）。分开之后：
+ *   · **一个规矩只有一处**：读数怎么闸、键表怎么列、数怎么写，都只在本文件里；
+ *   · **没有环**：本文件只依赖 `attrs.ts` 与 `shared/validate.ts`，`model.ts` 单向依赖它。
+ *
+ *  报错句的口径（别处也会读它）：每句都点名**路径**（`portion-gauge: input.rows[2].grams`）与**为什么**。
+ */
+import { assertDenseArray, assertPlainObject, badInput, optText, reqText } from '../shared/validate.js';
+import { PORTION_GAUGE_MAX_ROWS, PORTION_GAUGE_MIN_ROWS, } from './attrs.js';
+/** 必填文本：非空串**且不是全空白**（全空白的标题会在屏上留一块空白，那是“看得到的错”）。 */
+export function reqRealText(value, field) {
+    const text = reqText(value, field);
+    if (text.trim() === '')
+        badInput(field + ' 必须是真正的文本（全空白不算）');
+    return text;
+}
+/** 可选文本：空串＝未给（与全层 `optText` 同口径）；**全空白＝拒**（那会在屏上留一块空白）。 */
+export function optRealText(value, field) {
+    const text = optText(value, field);
+    if (text !== undefined && text.trim() === '')
+        badInput(field + ' 必须是真正的文本（全空白不算）');
+    return text;
+}
+/** 可加性的量级上界（`Number.MAX_VALUE ÷ 2`）。**判据是「相加会不会溢出」，不是「好不好读」**：
+ *  `|a| + |b| > Number.MAX_VALUE` 那一刻就是双精度的 `Infinity`，屏上写出 `1e+308` 这种读不出来的东西
+ *  （本件实测：`grams = 1e308` 原样渲成 `1e+308 g`）。故 `1e21`／`1e-7`（十进制写法与指数写法的分界那一档）**照旧合法**。 */
+const PORTION_GAUGE_MAGNITUDE_MAX = Number.MAX_VALUE / 2;
+/** 读数的量级闸（上界住 `PORTION_GAUGE_MAGNITUDE_MAX`，那一档的数是**有限的**：`Number.isFinite(1e308)` 为真）。 */
+function reqMagnitude(n, field) {
+    if (Math.abs(n) > PORTION_GAUGE_MAGNITUDE_MAX) {
+        badInput(field + ' 的量级太大：两笔同量级的读数相加就溢出成 `Infinity`'
+            + '（图上会写出 `1e+308` 这类读不出来的数；读数至多到 `Number.MAX_VALUE ÷ 2` 那一档）');
+    }
+    return n;
+}
+/** 只许入参表里写着的键：多给一个键（多半是打错名）＝拒，不静默吞掉（先例：`relation-picker`／
+ *  `kanban-columns` 的同名小件）。**两条都会被查到**（只走 `Object.keys` 会漏一半）：
+ *   · `Object.getOwnPropertyNames` —— 自有的**全部**键，含**不可枚举**的；
+ *   · `for…in` —— 走**整条原型链**（`Object.create({ zzUnknown: 1 })` 那种继承来的键就是这一路）。 */
+export function assertKeys(raw, allowed, field) {
+    const bad = [];
+    const note = (key) => {
+        if (!allowed.includes(key) && !bad.includes(key))
+            bad.push(key);
+    };
+    for (const key of Object.getOwnPropertyNames(raw))
+        note(key);
+    for (const key in raw)
+        note(key);
+    if (bad.length > 0) {
+        badInput(field + ' 里没有 `' + bad.join('`／`') + '` 这个键（入参表以外的键一律拒：写错的键静默吞掉会让'
+            + '调用方以为自己设上了；继承来的与不可枚举的键同样算）');
+    }
+}
+/** 顶层入参表的键（照 `attrs.ts` 的 `PortionGaugeInput` 列全：两个形态的字段都在表里——
+ *  形状决定读哪一组，不读的那一组照收不误，**别把合法入参误拒**）。 */
+export const INPUT_KEYS = ['title', 'form', 'stamp', 'tail', 'rows', 'gauge', 'note', 'missingCount', 'extraClass'];
+/** 换算一行的键（照 `attrs.ts` 的 `PortionGaugeRow`）。 */
+const ROW_KEYS = ['name', 'kind', 'recipe', 'grams', 'basis', 'toLabel', 'shareOf', 'sharePct'];
+/** A 档那一份量感的键（照 `attrs.ts` 的 `PortionGaugeGauge`）。 */
+const GAUGE_KEYS = ['name', 'usedPct', 'capText', 'refText', 'refPct', 'equiv'];
+/** 三位分组（`1200` → `1,200`；负号留在最前；小数部分原样）。
+ *
+ *  **指数写法原样返回**：量级大到（或小到）`String()` 只给指数写法时（`1e+21`／`1e-7`），
+ *  按三位插逗号会把它切成 `1e,+21`／`1,e-7`——那是**读不出来的数**（同族先例
+ *  `spread-dist/scale.ts` 的 `numText()`）。**非有限值一律 `badInput`**：写不出数的东西不上屏。 */
+export function groupNum(value) {
+    if (!Number.isFinite(value))
+        badInput('portion-gauge: 要写的数必须是有限数（读不到 ' + String(value) + '）');
+    const s = String(value);
+    if (s.includes('e') || s.includes('E'))
+        return s;
+    const dot = s.indexOf('.');
+    const head = dot < 0 ? s : s.slice(0, dot);
+    const frac = dot < 0 ? '' : s.slice(dot);
+    const neg = head.startsWith('-');
+    const body = neg ? head.slice(1) : head;
+    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 + frac;
+}
+/** 一行的克数（有限数、量级可读、且大于 0）：0 与负数不是“一行菜的量”，小数照收（`12.5 g`）。 */
+function reqGrams(value, field) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        badInput(field + ' 必须是有限数（`NaN`／`Infinity` 这类"写不成数的东西"一律拒）');
+    }
+    if (!(value > 0))
+        badInput(field + ' 必须大于 0（一行菜没有克数就谈不上换算）');
+    return reqMagnitude(value, field);
+}
+/** 占比（有限数且落在 0…100）：越界的占比画出来会顶出轨道，不静默夹。 */
+function reqSharePct(value, field) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        badInput(field + ' 必须是有限数');
+    if (!(value >= 0 && value <= 100))
+        badInput(field + ' 必须落在 0 到 100 之间（越界的占比会顶出轨道）');
+    return reqMagnitude(Math.round(value * 10) / 10, field);
+}
+/** 换算各行：1–8 行；每一行的名字、菜谱写法、克数、占比项、占比都得到位。 */
+export function reqRows(value) {
+    if (!Array.isArray(value) || value.length < PORTION_GAUGE_MIN_ROWS) {
+        badInput('portion-gauge: input.rows 至少 ' + String(PORTION_GAUGE_MIN_ROWS)
+            + ' 行（一道菜也要换算，请调用方至少给一行）');
+    }
+    if (value.length > PORTION_GAUGE_MAX_ROWS) {
+        badInput('portion-gauge: input.rows 最多 ' + String(PORTION_GAUGE_MAX_ROWS)
+            + ' 行（再多一屏读不完，请调用方先按餐分组）');
+    }
+    assertDenseArray(value, 'portion-gauge: input.rows');
+    return value.map((item, i) => {
+        const at = 'portion-gauge: input.rows[' + String(i) + ']';
+        assertPlainObject(item, at);
+        const r = item;
+        assertKeys(r, ROW_KEYS, at);
+        const row = {
+            name: reqRealText(r.name, at + '.name'),
+            recipe: reqRealText(r.recipe, at + '.recipe'),
+            grams: reqGrams(r.grams, at + '.grams'),
+            shareOf: reqRealText(r.shareOf, at + '.shareOf'),
+            sharePct: reqSharePct(r.sharePct, at + '.sharePct'),
+        };
+        const kind = optRealText(r.kind, at + '.kind');
+        const basis = optRealText(r.basis, at + '.basis');
+        const toLabel = optRealText(r.toLabel, at + '.toLabel');
+        return {
+            ...row,
+            ...(kind === undefined ? {} : { kind }),
+            ...(basis === undefined ? {} : { basis }),
+            ...(toLabel === undefined ? {} : { toLabel }),
+        };
+    });
+}
+/** 缺换算有几样（非负整数、量级可读；0＝没有缺的）。**写法与克数同一处出**：屏上那个数经 `groupNum()`。 */
+export function reqMissingCount(value) {
+    if (value === undefined)
+        return 0;
+    if (typeof value !== 'number' || !Number.isInteger(value) || value < 0) {
+        badInput('portion-gauge: input.missingCount 必须是非负整数（缺几样就写几样，没有缺的就不给）');
+    }
+    return reqMagnitude(value, 'portion-gauge: input.missingCount');
+}
+/** A 档那一份量感：名字、已用几成、上限那个量必给；**建议那句与它落的位置成对给**。 */
+export function reqGauge(value) {
+    assertPlainObject(value, 'portion-gauge: input.gauge');
+    const g = value;
+    const at = 'portion-gauge: input.gauge';
+    assertKeys(g, GAUGE_KEYS, at);
+    const name = reqRealText(g.name, at + '.name');
+    const usedPct = reqSharePct(g.usedPct, at + '.usedPct');
+    const capText = reqRealText(g.capText, at + '.capText');
+    const refText = optRealText(g.refText, at + '.refText');
+    const refPct = g.refPct === undefined ? undefined : reqSharePct(g.refPct, at + '.refPct');
+    if ((refText === undefined) !== (refPct === undefined)) {
+        badInput(at + ' 的一餐建议要**成对**给（`refText` 那句字与 `refPct` 它落在几成处）——'
+            + '只给一样，那句参照要么没地方挂，要么挂在编出来的位置上');
+    }
+    const equiv = optRealText(g.equiv, at + '.equiv');
+    return {
+        name,
+        usedPct,
+        capText,
+        ...(refText === undefined ? {} : { refText, refPct }),
+        ...(equiv === undefined ? {} : { equiv }),
+    };
+}
+//# sourceMappingURL=fields.js.map

package/dist/components/portion-gauge/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../../src/components/portion-gauge/fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACxG,OAAO,EACL,sBAAsB,EACtB,sBAAsB,GAGvB,MAAM,YAAY,CAAC;AACpB,qDAAqD;AACrD,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,KAAa;IACvD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,QAAQ,CAAC,KAAK,GAAG,kBAAkB,CAAC,CAAC;IAC7D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,KAAa;IACvD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACnC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,QAAQ,CAAC,KAAK,GAAG,kBAAkB,CAAC,CAAC;IACnF,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;wFAEwF;AACxF,MAAM,2BAA2B,GAAG,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC;AAEzD,2FAA2F;AAC3F,SAAS,YAAY,CAAC,CAAS,EAAE,KAAa;IAC5C,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,2BAA2B,EAAE,CAAC;QAC9C,QAAQ,CAAC,KAAK,GAAG,kCAAkC;cAC/C,4DAA4D,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;iFAGiF;AACjF,MAAM,UAAU,UAAU,CAAC,GAA4B,EAAE,OAA0B,EAAE,KAAa;IAChG,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,CAAC,GAAW,EAAQ,EAAE;QACjC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClE,CAAC,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC;QAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7D,KAAK,MAAM,GAAG,IAAI,GAAG;QAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnB,QAAQ,CAAC,KAAK,GAAG,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,6BAA6B;cACvE,4BAA4B,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED;yCACyC;AACzC,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,YAAY,CAAU,CAAC;AAC7H,gDAAgD;AAChD,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,CAAU,CAAC;AACzG,sDAAsD;AACtD,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;AAEzF;;;;8EAI8E;AAC9E,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,QAAQ,CAAC,gCAAgC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;IAC9F,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,GAAG,IAAI,GAAG,CAAC;QACrD,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC;AACvC,CAAC;AAED,2DAA2D;AAC3D,SAAS,QAAQ,CAAC,KAAc,EAAE,KAAa;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,QAAQ,CAAC,KAAK,GAAG,0CAA0C,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;QAAE,QAAQ,CAAC,KAAK,GAAG,wBAAwB,CAAC,CAAC;IAC7D,OAAO,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACpC,CAAC;AAED,2CAA2C;AAC3C,SAAS,WAAW,CAAC,KAAc,EAAE,KAAa;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,QAAQ,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IACtF,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,GAAG,CAAC;QAAE,QAAQ,CAAC,KAAK,GAAG,8BAA8B,CAAC,CAAC;IACpF,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,sBAAsB,EAAE,CAAC;QACnE,QAAQ,CAAC,+BAA+B,GAAG,MAAM,CAAC,sBAAsB,CAAC;cACrE,uBAAuB,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,sBAAsB,EAAE,CAAC;QAC1C,QAAQ,CAAC,+BAA+B,GAAG,MAAM,CAAC,sBAAsB,CAAC;cACrE,uBAAuB,CAAC,CAAC;IAC/B,CAAC;IACD,gBAAgB,CAAC,KAAK,EAAE,2BAA2B,CAAC,CAAC;IACrD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QAC3B,MAAM,EAAE,GAAG,4BAA4B,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QAC1D,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5B,MAAM,CAAC,GAAG,IAA+B,CAAC;QAC1C,UAAU,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC5B,MAAM,GAAG,GAAoB;YAC3B,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,CAAC;YACvC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,GAAG,SAAS,CAAC;YAC7C,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,GAAG,QAAQ,CAAC;YACvC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,GAAG,UAAU,CAAC;YAChD,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,GAAG,WAAW,CAAC;SACpD,CAAC;QACF,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,GAAG,QAAQ,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,GAAG,UAAU,CAAC,CAAC;QACxD,OAAO;YACL,GAAG,GAAG;YACN,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;YACvC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;YACzC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;SAC9C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACvE,QAAQ,CAAC,4DAA4D,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,YAAY,CAAC,KAAK,EAAE,mCAAmC,CAAC,CAAC;AAClE,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,iBAAiB,CAAC,KAAK,EAAE,4BAA4B,CAAC,CAAC;IACvD,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,MAAM,EAAE,GAAG,4BAA4B,CAAC;IACxC,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,GAAG,UAAU,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,GAAG,UAAU,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,GAAG,UAAU,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,GAAG,SAAS,CAAC,CAAC;IAC1F,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,EAAE,CAAC;QACvD,QAAQ,CAAC,EAAE,GAAG,kDAAkD;cAC5D,6BAA6B,CAAC,CAAC;IACrC,CAAC;IACD,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,GAAG,QAAQ,CAAC,CAAC;IAClD,OAAO;QACL,IAAI;QACJ,OAAO;QACP,OAAO;QACP,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QACrD,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;KAC1C,CAAC;AACJ,CAAC"}

package/dist/components/portion-gauge/index.d.ts

@@ -0,0 +1,18 @@
+/** portion-gauge · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  出口：`renderPortionGauge(input)`（产标记，零 DOM）／`portionGaugeCss()`（样式段）／
+ *  `PORTION_GAUGE_FORMS`（形态闭集：换算三栏 `convert`／量感条 `gauge`）／
+ *  `PORTION_GAUGE_CLASS` 与 `portionGaugeSlot()`（标记契约）／
+ *  `PORTION_GAUGE_NARROW_PX` 与 `PORTION_GAUGE_BAR_MIN_PX`（几何常量：判据拿它对两档几何与条宽）／
+ *  `normalizePortionGauge`（归一化入口）／行数上下限（判据拿它对非法入参）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ */
+export { renderPortionGauge } from './render.js';
+export type { PortionGaugeForm, PortionGaugeGauge, PortionGaugeInput, PortionGaugeRow, PortionGaugeSlot, } from './attrs.js';
+export { PORTION_GAUGE_CLASS, PORTION_GAUGE_FORMS, PORTION_GAUGE_MAX_ROWS, PORTION_GAUGE_MIN_ROWS, PORTION_GAUGE_NARROW_PX, PORTION_GAUGE_SLOTS, portionGaugeSlot, } from './attrs.js';
+export { PORTION_GAUGE_NOTE, normalizePortionGauge } from './model.js';
+export type { PortionGaugeGaugeModel, PortionGaugeMarkModel, PortionGaugeModel, PortionGaugeRowModel, PortionGaugeTickModel, } from './model.js';
+export { PORTION_GAUGE_BAR_MIN_PX, portionGaugeCss } from './style.js';
+export { PORTION_GAUGE_RAIL_PX } from './style-gauge.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/portion-gauge/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/portion-gauge/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACvE,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/components/portion-gauge/index.js

@@ -0,0 +1,16 @@
+/** portion-gauge · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  出口：`renderPortionGauge(input)`（产标记，零 DOM）／`portionGaugeCss()`（样式段）／
+ *  `PORTION_GAUGE_FORMS`（形态闭集：换算三栏 `convert`／量感条 `gauge`）／
+ *  `PORTION_GAUGE_CLASS` 与 `portionGaugeSlot()`（标记契约）／
+ *  `PORTION_GAUGE_NARROW_PX` 与 `PORTION_GAUGE_BAR_MIN_PX`（几何常量：判据拿它对两档几何与条宽）／
+ *  `normalizePortionGauge`（归一化入口）／行数上下限（判据拿它对非法入参）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ */
+export { renderPortionGauge } from './render.js';
+export { PORTION_GAUGE_CLASS, PORTION_GAUGE_FORMS, PORTION_GAUGE_MAX_ROWS, PORTION_GAUGE_MIN_ROWS, PORTION_GAUGE_NARROW_PX, PORTION_GAUGE_SLOTS, portionGaugeSlot, } from './attrs.js';
+export { PORTION_GAUGE_NOTE, normalizePortionGauge } from './model.js';
+export { PORTION_GAUGE_BAR_MIN_PX, portionGaugeCss } from './style.js';
+export { PORTION_GAUGE_RAIL_PX } from './style-gauge.js';
+//# sourceMappingURL=index.js.map

package/dist/components/portion-gauge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/portion-gauge/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAQjD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAQvE,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/components/portion-gauge/model.d.ts

@@ -0,0 +1,76 @@
+import { type PortionGaugeForm } from './attrs.js';
+/** 一行的内部形状：每个字段都已校验、已归一、已算好（`render.ts` 只拼标记，一个算术都不写）。 */
+export interface PortionGaugeRowModel {
+    readonly name: string;
+    /** 出处那句（`主料，菜谱写“2 份”`）：分档与菜谱写法拼在这里，换算左栏读的是同一个菜谱串。 */
+    readonly sub: string;
+    /** 这一行合计多少克的写法（`700 g`）：行头与换算右栏读的是**同一个串**。 */
+    readonly gramsText: string;
+    /** 菜谱写的那一句（`2 份`）：出处句与换算左栏读的是**同一个串**。 */
+    readonly recipeText: string;
+    /** 右栏口径名（`营养库口径`／`生重（1 碗 ＝ 150 g）`）。 */
+    readonly toLabelText: string;
+    /** 占比（0…100，取一位小数）：占比那句的字与占比条的宽度读的是**同一个数**。 */
+    readonly sharePct: number;
+    /** 占比那句（`占一天蛋白 70%`）。 */
+    readonly shareText: string;
+}
+/** 轨道上的一根刻度竖线：位置与粗细都由 `model.ts` 定形（`render.ts` 只贴上去，不拼算术）。 */
+export interface PortionGaugeTickModel {
+    /** 行内定位（`left: 25%`）。 */
+    readonly pos: string;
+    /** 整份那一档（`0`／`50`）：刻度画长一档。 */
+    readonly major: boolean;
+}
+/** 轨道上的一枚参照刻度竖线：一餐建议（实线）／一天上限（虚线）。 */
+export interface PortionGaugeMarkModel {
+    readonly kind: 'ref' | 'cap';
+    /** 行内定位。右端那枚是 `right: 0`——`left: 100%` 会把它自己那 1px 描边推到轨道外面（横溢）。 */
+    readonly pos: string;
+}
+/** A 档量感条（`gauge`）的内部形状：每个字段都已校验、已归一、已算好。 */
+export interface PortionGaugeGaugeModel {
+    /** 这一份叫什么（`红烧肉`）：卡头上屏 ＋ 进无障碍名。 */
+    readonly name: string;
+    /** 已用占上限的几成（0…100，取一位小数）：大字与已用那一段的长度读的是**同一个数**。 */
+    readonly usedPct: number;
+    /** 那个大字（`58%`）。 */
+    readonly usedText: string;
+    /** 上限那枚刻度值（`一天上限 2 份`），挂在尺子右端。 */
+    readonly capLabel: string;
+    /** 一餐建议那枚刻度值（`一餐建议 1.2 份`）；没给建议＝不出这一行。 */
+    readonly refLabel?: string;
+    /** 建议那枚刻度值那一行的**行内内距**（把那一行的话居中到它那枚刻度上）；正中那一档是空串＝不写。 */
+    readonly refPad?: string;
+    /** 实物参照那一行（`≈ 1 个拳头 ＋ 2 汤勺`）；不给＝不出那一行。 */
+    readonly equiv?: string;
+    /** 轨道那句话（`role="img"` 的无障碍名）：把这一条读数说成一句话，数出自上面同一批字段。 */
+    readonly ariaText: string;
+    /** 刻度竖线（四等分；右端那枚由「一天上限」那枚参照收口，同一处不画两条线）。 */
+    readonly ticks: readonly PortionGaugeTickModel[];
+    /** 参照刻度竖线（有建议时两枚，否则只有上限那一枚）。 */
+    readonly marks: readonly PortionGaugeMarkModel[];
+}
+/** 内部类型：每个字段都已校验、已归一、已算好。 */
+export interface PortionGaugeModel {
+    readonly form: PortionGaugeForm;
+    readonly title: string;
+    readonly stamp?: string;
+    readonly tail?: string;
+    /** `convert` 的行；`gauge` 形态是**空数组**（那个形态读 `gauge`）。 */
+    readonly rows: readonly PortionGaugeRowModel[];
+    /** `gauge` 的那一份；`convert` 形态是 `null`。 */
+    readonly gauge: PortionGaugeGaugeModel | null;
+    readonly note: string;
+    /** 缺换算的食材有几样（0＝没有缺的，那一行整行不出）。 */
+    readonly missingCount: number;
+    /** 缺换算那一行里的数（`还差 12 样没有换算` 里的 `12`）：**与克数走同一把分组**（同一处出，
+     *  指数写法同样不被打散）；`missingCount` 是 0 时是空串（那一行整行不出）。 */
+    readonly missingText: string;
+    readonly extraClass?: string;
+}
+/** 本件的口径句（调用方不给 `note` 时用它；分隔符只用逗号与句号）。 */
+export declare const PORTION_GAUGE_NOTE: string;
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `PortionGaugeModel`，不再自己碰 `any`。 */
+export declare function normalizePortionGauge(input: unknown): PortionGaugeModel;
+//# sourceMappingURL=model.d.ts.map

package/dist/components/portion-gauge/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/components/portion-gauge/model.ts"],"names":[],"mappings":"AAgBA,OAAO,EAIL,KAAK,gBAAgB,EAGtB,MAAM,YAAY,CAAC;AAKpB,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,wCAAwC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,yBAAyB;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,+DAA+D;AAC/D,MAAM,WAAW,qBAAqB;IACpC,yBAAyB;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,sCAAsC;AACtC,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,6CAA6C;AAC7C,MAAM,WAAW,sBAAsB;IACrC,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mBAAmB;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACjD,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,qBAAqB,EAAE,CAAC;CAClD;AAED,6BAA6B;AAC7B,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC/C,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;wDACoD;IACpD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,2CAA2C;AAC3C,eAAO,MAAM,kBAAkB,QAGE,CAAC;AA4DlC,yEAAyE;AACzE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAiDvE"}

package/dist/components/portion-gauge/model.js

@@ -0,0 +1,127 @@
+/** portion-gauge · **入参校验与归一化入口**（把 `any` 与说不出的 `unknown` 挡在门外，产出内部类型）。
+ *
+ *  三条口径：
+ *   1. **非法入参一律 `badInput()`**（抛 `BlocksError`）——不静默降级、不“尽量猜”：
+ *      行数不够、克数不是数、占比越界，画出来都是“错位”，而调用方以为拿到了一组完整换算。
+ *   2. **换算链三栏的数是同一份真值**：克数串、百分比、菜谱那一句都在这里**各算一次**，
+ *      `render.ts` 只把算好的串写进两处（行头与换算栏各一处）——两处各算一遍必然走散。
+ *      A 档量感条同此：那个百分比大字与已用那一段的长度是**同一个数**，两枚参照刻度值的位置
+ *      与它们各自那句字也在这一处定形。
+ *   3. **空白串不是文本**：全空白的 `title`／食材名会在屏上留一块空白，**一律拒**
+ *      （与同层 `optExtraClass` 对空白串的口径一致；可选文本字段同办：空串仍按“未给”处理）。
+ *
+ *  **形态决定读哪一组字段**（同族先例 `spread-dist/model.ts`）：`convert` 读 `rows`、`gauge` 读 `gauge`，
+ *  另一个形态的字段一概不读（缺了就是缺了，不拿另一形态的字段顶上）。
+ */
+import { assertPlainObject, badInput, optExtraClass } from '../shared/validate.js';
+import { PORTION_GAUGE_FORMS, } from './attrs.js';
+import { assertKeys, groupNum, INPUT_KEYS, optRealText, reqGauge, reqMissingCount, reqRealText, reqRows, } from './fields.js';
+/** 本件的口径句（调用方不给 `note` 时用它；分隔符只用逗号与句号）。 */
+export const PORTION_GAUGE_NOTE = '口径：左边永远是菜谱写的单位（份，碗，把），'
+    + '右边永远是营养库认的单位（g）。中间是这一份菜的换算系数，'
+    + '系数变了要写明是哪一版菜谱改的，不悄悄改数。'
+    + '缺换算系数的食材整行不画，只在下面写还差几样没有换算。';
+/** 尺子的刻度：四等分（0／25／50／75）。**右端那枚不画**——它由「一天上限」那枚参照收口
+ *  （同一处画两条线＝同一个位置说两遍）。 */
+const RAIL_TICKS = [0, 25, 50, 75];
+/** 参照刻度值那一行的**行内内距**：把那一行的话**居中到它那枚刻度**上（`text-align: center` ＋ 一侧内距）。
+ *  刻度过半时内距压在左边、不过半时压右边 —— 两侧都推不出轨道，也不用 `translateX`（那会让
+ *  0 宽刻度上的标签自己吃掉一半宽）。
+ *
+ *  **内距最多压到 `REF_PAD_MAX_PCT`**：刻度贴着尺子两端时（0／100），按上面那把尺算出来的内距
+ *  会把那一行的可用宽压成 0，一个字居中在 0 宽里 ⇒ 半个字被推到轨道外（真机读数 `scrollWidth`
+ *  比 `clientWidth` 多 12px）。压到 75% ＝ 至少给那枚标签留四分之一条轨道：话仍**贴着它那一端**，
+ *  只是不再严格居中（尺子两端本来就摆不下居中）。 */
+const REF_PAD_MAX_PCT = 75;
+function refPad(pct) {
+    if (pct > 50)
+        return 'padding-left: ' + String(Math.min(2 * pct - 100, REF_PAD_MAX_PCT)) + '%';
+    if (pct < 50)
+        return 'padding-right: ' + String(Math.min(100 - 2 * pct, REF_PAD_MAX_PCT)) + '%';
+    return '';
+}
+/** 一枚刻度／参照竖线的位置：贴着尺子右端（100%）的那一枚用 `right: 0` 收口 ——
+ *  `left: 100%` 会把它自己那 1px 描边推到轨道外面（真机读数：`scrollWidth` 比 `clientWidth` 多 1）。 */
+function markPos(pct) {
+    return pct >= 100 ? 'right: 0' : 'left: ' + String(pct) + '%';
+}
+/** A 档那一份量感：大字、两枚参照刻度值、刻度竖线、无障碍名都在这一处定形。 */
+function gaugeModel(g) {
+    const usedText = String(g.usedPct) + '%';
+    const capLabel = '一天上限 ' + g.capText;
+    const ticks = RAIL_TICKS
+        .map((p) => ({ pos: 'left: ' + String(p) + '%', major: p % 50 === 0 }));
+    /* 上限那枚收右端；有建议时它排在前面（屏上先读到建议，再读到上限）。 */
+    const marks = [{ kind: 'cap', pos: markPos(100) }];
+    let refLabel;
+    let pad;
+    if (g.refPct !== undefined && g.refText !== undefined) {
+        refLabel = '一餐建议 ' + g.refText;
+        pad = refPad(g.refPct);
+        marks.unshift({ kind: 'ref', pos: markPos(g.refPct) });
+    }
+    /* 无障碍名把这一条读数说成一句话：数**出自上面同一批字段**（不另算一遍）。 */
+    const ariaText = '量感条：' + g.name + '用掉一天上限 ' + g.capText + '的' + usedText
+        + (refLabel === undefined || g.refPct === undefined
+            ? '。' : '，' + refLabel + '那枚刻度落在 ' + String(g.refPct) + '% 处。');
+    return {
+        name: g.name,
+        usedPct: g.usedPct,
+        usedText,
+        capLabel,
+        ...(refLabel === undefined ? {} : { refLabel }),
+        ...(pad === undefined ? {} : { refPad: pad }),
+        ...(g.equiv === undefined ? {} : { equiv: g.equiv }),
+        ariaText,
+        ticks,
+        marks,
+    };
+}
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `PortionGaugeModel`，不再自己碰 `any`。 */
+export function normalizePortionGauge(input) {
+    assertPlainObject(input, 'renderPortionGauge: input');
+    const raw = input;
+    assertKeys(raw, INPUT_KEYS, 'portion-gauge: input');
+    const form = raw.form === undefined ? PORTION_GAUGE_FORMS[0] : raw.form;
+    if (!PORTION_GAUGE_FORMS.includes(form)) {
+        badInput('portion-gauge: input.form 必须是 ' + PORTION_GAUGE_FORMS.join('／')
+            + ' 之一（A 量感条／B 换算三栏）');
+    }
+    const gauge = form === 'gauge' ? gaugeModel(reqGauge(raw.gauge)) : null;
+    const rows = form === 'gauge' ? [] : reqRows(raw.rows).map((r) => {
+        /* 同一份真值各算一次：克数串只拼一遍（行头与右栏同引），菜谱串只收一遍
+           （出处句与左栏同引），百分比只取一位（占比句与条宽同引）。 */
+        const gramsText = groupNum(r.grams) + ' g';
+        const pctText = String(r.sharePct) + '%';
+        const toName = r.toLabel ?? '营养库口径';
+        const model = {
+            name: r.name,
+            sub: (r.kind === undefined ? '' : r.kind + '，') + '菜谱写「' + r.recipe + '」',
+            gramsText,
+            recipeText: r.recipe,
+            toLabelText: r.basis === undefined ? toName : toName + '（' + r.basis + '）',
+            sharePct: r.sharePct,
+            shareText: '占一天' + r.shareOf + ' ' + pctText,
+        };
+        return model;
+    });
+    /* 缺换算那个数也在这一处定形（写法与克数同一把分组）：`render.ts` 只贴它，不再自己 `String()`。 */
+    const missingCount = reqMissingCount(raw.missingCount);
+    /* 脚注缺省按形态分：`convert` 用本件的口径句；`gauge` **不出脚注**（那两条参照刻度值在尺子上
+       自己报了名，再写一句口径＝同一件事印两遍，正是用户砍掉的那类文字）。 */
+    const noteIn = optRealText(raw.note, 'portion-gauge: input.note');
+    const note = noteIn ?? (form === 'gauge' ? '' : PORTION_GAUGE_NOTE);
+    return {
+        form: form,
+        title: reqRealText(raw.title, 'portion-gauge: input.title'),
+        stamp: optRealText(raw.stamp, 'portion-gauge: input.stamp'),
+        tail: optRealText(raw.tail, 'portion-gauge: input.tail'),
+        rows,
+        gauge,
+        note,
+        missingCount,
+        missingText: missingCount > 0 ? groupNum(missingCount) : '',
+        extraClass: optExtraClass(raw.extraClass, 'portion-gauge: input.extraClass'),
+    };
+}
+//# sourceMappingURL=model.js.map

package/dist/components/portion-gauge/model.js.map

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

package/dist/components/portion-gauge/render.d.ts

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

package/dist/components/portion-gauge/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/components/portion-gauge/render.ts"],"names":[],"mappings":"AAkKA,wDAAwD;AACxD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKzD"}

package/dist/components/portion-gauge/render.js

@@ -0,0 +1,158 @@
+/** portion-gauge · **渲染**（纯函数产 HTML；本件两档骨架：A 量感条／B 换算三栏）。
+ *
+ *  —— 形态 `convert`：换算三栏 ——
+ *
+ *  一行一样食材，每行三栏：第一栏是菜谱写的那一句（`2 份`），第二栏是营养库认的那一句
+ *  （`700 g`），第三栏是实物占比（占比条 ＋ `占一天蛋白 70%`）。行头写清食材名、
+ *  出处与这一行合计多少克，脚注写口径，缺换算的另起一行只报数。
+ *  它替掉的两种错法：
+ *   · 只给克数 —— 人对着 `200 g` 不知道这是多是少；
+ *   · 单位靠人自己心算 —— 菜谱的份碗把与营养库的克各说各的。
+ *
+ *  —— 形态 `gauge`：量感条（占上限几成 ＋ 两条参照刻度）——
+ *
+ *  一条尺子（量程＝0…上限）：余量底是一根发丝线、已用那一段压在它上面、刻度是竖线（三级重量）；
+ *  上面一档大字是占比，两枚参照刻度值（一餐建议／一天上限）**一高一低挂在自己那枚刻度上**；
+ *  最下面一行是实物参照（`≈ 1 个拳头 ＋ 2 汤勺`）。
+ *  它替掉的那一种错法：**只报一个百分比**（58% 是多少，人对着手比不出来）。
+ *
+ *  三条硬口径（判据断的就是它们）：
+ *   · **算数不在这里**：克数串、百分比、菜谱串、刻度位置、无障碍名都在 `model.ts` 算好；
+ *     这一支只把**算好的数**写进它该去的地方，静态规则一律住 `style.ts`；
+ *   · **同一份真值只印一次**：换算三栏的行头与换算栏同引一个串；量感条的占比大字、已用那一段的
+ *     宽度、无障碍名里的百分比是**同一个数**（`usedPct`）；
+ *   · **本件不带可点元素、不带脚本**：没有 `runtime.ts`；调用方把某一行包成入口时，
+ *     件里那条 `:focus-visible` 地板保证焦点看得见（见 `README.md`）。
+ */
+import { esc } from '../shared/escape.js';
+import { badInput } from '../shared/validate.js';
+import { PORTION_GAUGE_CLASS, portionGaugeSlot } from './attrs.js';
+import { normalizePortionGauge, } from './model.js';
+/** 卡头：标题（＋ A 档的「这一份叫什么」）＋ 口径那枚 ＋ 换算基准。 */
+function headHtml(m) {
+    const parts = ['<div class="' + portionGaugeSlot('hd') + '">'];
+    parts.push('<h4 class="' + portionGaugeSlot('title') + '">' + esc(m.title) + '</h4>');
+    /* A 档才有「这一份叫什么」（`convert` 那一档的模型里 `gauge` 恒为 `null` ⇒ 这段不进标记）。 */
+    if (m.gauge !== null) {
+        parts.push('<b class="' + portionGaugeSlot('subject') + '">' + esc(m.gauge.name) + '</b>');
+    }
+    if (m.stamp !== undefined) {
+        parts.push('<span class="' + portionGaugeSlot('stamp') + '">' + esc(m.stamp) + '</span>');
+    }
+    if (m.tail !== undefined) {
+        parts.push('<span class="' + portionGaugeSlot('tail') + '">' + esc(m.tail) + '</span>');
+    }
+    parts.push('</div>');
+    return parts.join('');
+}
+/** 一行：行头（名 ＋ 出处 ＋ 合计）→ 换算框（左栏 → 右栏）→ 实物占比（条 ＋ 那句）。 */
+function rowHtml(r) {
+    const parts = ['<div class="' + portionGaugeSlot('row') + '">'];
+    parts.push('<span class="' + portionGaugeSlot('head') + '">'
+        + '<b class="' + portionGaugeSlot('name') + '">' + esc(r.name) + '</b>'
+        + '<span class="' + portionGaugeSlot('sub') + '">' + esc(r.sub) + '</span>'
+        + '<span class="' + portionGaugeSlot('same') + '">' + esc(r.gramsText) + '</span>'
+        + '</span>');
+    parts.push('<span class="' + portionGaugeSlot('eq') + '">'
+        + '<span class="' + portionGaugeSlot('side') + '">'
+        + '<b class="' + portionGaugeSlot('side-value') + '">' + esc(r.recipeText) + '</b>'
+        + '<em class="' + portionGaugeSlot('side-label') + '">菜谱单位</em>'
+        + '</span>'
+        + '<span class="' + portionGaugeSlot('arrow') + '" aria-hidden="true">→</span>'
+        + '<span class="' + portionGaugeSlot('side') + ' is-to">'
+        + '<b class="' + portionGaugeSlot('side-value') + '">' + esc(r.gramsText) + '</b>'
+        + '<em class="' + portionGaugeSlot('side-label') + '">' + esc(r.toLabelText) + '</em>'
+        + '</span>'
+        + '</span>');
+    /* 占比条是纯装饰（那句占比已经把数说出来了）：填充宽度就是占比本身，与那句同源。 */
+    parts.push('<span class="' + portionGaugeSlot('obj') + '">'
+        + '<span class="' + portionGaugeSlot('bar') + '" aria-hidden="true">'
+        + '<i class="' + portionGaugeSlot('fill') + '" style="width: ' + String(r.sharePct) + '%"></i>'
+        + '</span>'
+        + '<span class="' + portionGaugeSlot('share') + '">' + esc(r.shareText) + '</span>'
+        + '</span>');
+    parts.push('</div>');
+    return parts.join('');
+}
+/** 脚注一句人话 ＋（有缺换算时）缺的那一行。 */
+function footHtml(m) {
+    const parts = ['<p class="' + portionGaugeSlot('note') + '">' + esc(m.note) + '</p>'];
+    if (m.missingCount > 0) {
+        /* 那个数在 `model.ts` 就定好形（与克数同一把分组）：这里只贴，不再自己 `String()` 一遍
+           ——两处各拼一遍必然走散（同 `gramsText`／`shareText` 的口径）。 */
+        parts.push('<p class="' + portionGaugeSlot('missing') + '">还差 ' + m.missingText
+            + ' 样没有换算</p>');
+    }
+    return parts.join('');
+}
+/** 形态 `convert` 的骨架：卡头 → 一行一样 → 脚注。 */
+function renderConvert(m) {
+    const parts = [headHtml(m)];
+    parts.push('<div class="' + portionGaugeSlot('conv') + '">'
+        + m.rows.map(rowHtml).join('') + '</div>');
+    parts.push(footHtml(m));
+    return parts.join('');
+}
+/** A 档那一份量感（归一化保证 `form === 'gauge'` 时它**不是** `null`；真缺了就当错报，不静默降级）。 */
+function gaugeOf(m) {
+    if (m.gauge === null)
+        badInput('portion-gauge: 形态 gauge 缺 input.gauge');
+    return m.gauge;
+}
+/** 尺子：余量底 → 已用那一段 → 刻度竖线 → 参照刻度竖线（位置一律由 `model.ts` 定形）。 */
+function railHtml(g) {
+    const parts = ['<span class="' + portionGaugeSlot('rail') + '" role="img" aria-label="'
+            + esc(g.ariaText) + '">'];
+    parts.push('<span class="' + portionGaugeSlot('rest') + '" aria-hidden="true"></span>');
+    /* 已用那一段的宽度**就是占比本身**（与大字、与无障碍名同一个数）。 */
+    parts.push('<span class="' + portionGaugeSlot('used') + '" aria-hidden="true" style="width: '
+        + String(g.usedPct) + '%"></span>');
+    for (const tick of g.ticks) {
+        parts.push('<span class="' + portionGaugeSlot('tick') + (tick.major ? ' is-major' : '')
+            + '" aria-hidden="true" style="' + tick.pos + '"></span>');
+    }
+    for (const mark of g.marks) {
+        parts.push('<span class="' + portionGaugeSlot('mark') + ' is-' + mark.kind
+            + '" aria-hidden="true" style="' + mark.pos + '"></span>');
+    }
+    parts.push('</span>');
+    return parts.join('');
+}
+/** 形态 `gauge` 的骨架：卡头 → 占比大字 → 尺子（两枚参照刻度值 ＋ 轨道）→ 实物参照 →（给了才出）脚注。 */
+function renderGauge(m) {
+    const g = gaugeOf(m);
+    const parts = [headHtml(m)];
+    parts.push('<p class="' + portionGaugeSlot('lead') + '"><b class="'
+        + portionGaugeSlot('lead-value') + '">' + esc(g.usedText) + '</b></p>');
+    const box = ['<span class="' + portionGaugeSlot('gauge') + '">'];
+    /* 两枚参照刻度值一高一低：上面那行是上限，贴着轨道那行是建议（离得近的那一枚是「这一餐」）。 */
+    box.push('<span class="' + portionGaugeSlot('mark-label') + ' is-cap" aria-hidden="true">'
+        + esc(g.capLabel) + '</span>');
+    if (g.refLabel !== undefined) {
+        box.push('<span class="' + portionGaugeSlot('mark-label') + ' is-ref" aria-hidden="true"'
+            + (g.refPad === undefined || g.refPad === '' ? '' : ' style="' + g.refPad + '"') + '>'
+            + esc(g.refLabel) + '</span>');
+    }
+    box.push(railHtml(g));
+    box.push('</span>');
+    parts.push(box.join(''));
+    if (g.equiv !== undefined) {
+        parts.push('<p class="' + portionGaugeSlot('equiv') + '"><b>' + esc(g.equiv) + '</b></p>');
+    }
+    if (m.note !== '')
+        parts.push('<p class="' + portionGaugeSlot('note') + '">' + esc(m.note) + '</p>');
+    return parts.join('');
+}
+/** 形态 → 骨架（分派写在这里；加形态就是在这里加一支）。 */
+const SKELETONS = {
+    convert: renderConvert,
+    gauge: renderGauge,
+};
+/** 渲染份量换算（纯函数：同样的入参恒产同样的字节；转义只经 `shared/escape.ts`）。 */
+export function renderPortionGauge(input) {
+    const m = normalizePortionGauge(input);
+    const extra = m.extraClass === undefined ? '' : ' ' + m.extraClass;
+    return '<div class="' + PORTION_GAUGE_CLASS + ' is-' + m.form + extra + '">'
+        + SKELETONS[m.form](m) + '</div>';
+}
+//# sourceMappingURL=render.js.map