base-paint 0.3.13 → 0.3.15

package/dist/components/section-head/style.js

@@ -0,0 +1,172 @@
+/** section-head · **样式段**（本件唯一的样式来源）。
+ *
+ *  纪律（与本节其余件同一份）：
+ *   · 只经 `skinVar()` 读皮肤 —— 组件里**不写** `var(--ilife-…)`（兜底链只许住在 `skin/contract.ts`）；
+ *     颜色／圆角／字面／字号一个都不写死在选择器里；
+ *   · 全部规则 scope 在 `.<prefix>page-ui` 之下（不开本配方的页零命中）；不写 `:root`／`!important`、不新增 token 名；
+ *   · **宽度只许容器判**：布局靠 `@container` ＋ 内在尺寸 ＋ `flex-wrap`；
+ *     `@media` 只判设备能力（`hover:hover and pointer:fine` 与 `prefers-reduced-motion`），不判宽度。
+ *
+ *  几何契约（判据钉住）：标题行 `min-height` ＝ `SECTION_HEAD_SUM_MIN_PX`（触控命中盒地板）；
+ *  计数恒 `flex:none`（窄档只换行、不掉字）；标题恒 `overflow-wrap:anywhere`（**永不 `…` 截断**）。
+ */
+import { skinVar } from '../skin/contract.js';
+import { SECTION_HEAD_CARET_CODE, SECTION_HEAD_MORE_TEXTS, sectionHeadSlot, } from './attrs.js';
+/** 换行（仓库口径：不写字面换行转义）。 */
+const LF = String.fromCharCode(10);
+/** 标题行的命中盒高度下限（px）：触控目标 ≥44×44 是全宽口径（视觉上是"一行标题"，可点的是整行）。 */
+export const SECTION_HEAD_SUM_MIN_PX = 44;
+/** 窄容器阈值（px）：计数与展开指示改走「另起一行」。
+ *  **这是本件自己的宽度**（`@container` 判的），不是视口宽度。 */
+const NARROW_PX = 420;
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export function sectionHeadCss(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-section-head';
+    /** 槽位的**裸类名**（不带 scope）：**只用在组合器的右边**（`+`／`>`／后代那一段），
+     *  左边（选择器开头）一律走 `s()`——开头那次 scope 不能省，省了整条就裸着（与别件串味）。 */
+    const slot = (name) => '.' + sectionHeadSlot(name, p);
+    /** 带 scope 的完整选择器：**每条规则的左端**都用它（含伪元素那条，如 `s('more') + '::before'`）。 */
+    const s = (name) => root + ' ' + slot(name);
+    const more = s('more');
+    /** 展开态的元素级前缀：`<scope> <box>[open] `（后半截的内容由调用处拼**裸类名**）。 */
+    const boxOpen = box + '[open] ';
+    return [
+        '/* section-head（小节头 · 形态 C「可折叠小节（原生 details，零脚本）」）：',
+        '   序号 ＋ 小节标题 ＋ 计数 ＋ 展开指示；正文原生开合，标记里没有一行脚本。',
+        '   折行全走内在尺寸（`flex-basis:max-content` ＋ `flex-wrap`），不吃视口媒体查询。 */',
+        box + ' {',
+        /* 宽度判据的落点：本件是**自己的容器**——嵌进侧栏／面板／卡片时照样按自己的宽度折行。 */
+        '  container-type: inline-size;',
+        '  display: block;',
+        '  min-width: 0;',
+        '}',
+        '/* 标题行：标题的内在宽度撑到 12ch，计数与展开指示自己折到下一行——',
+        '   标题不被挤成一列孤字、也不掉字（不用 `…`）。整行是命中盒（`cursor:pointer` 走原生开合）。 */',
+        s('sum') + ' {',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  align-items: center;',
+        '  gap: 4px 8px;',
+        '  box-sizing: border-box;',
+        '  min-width: 0;',
+        '  min-height: ' + String(SECTION_HEAD_SUM_MIN_PX) + 'px;',
+        '  padding: 4px 0;',
+        '  cursor: pointer;',
+        '  touch-action: manipulation;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font') + ';',
+        /* 去掉 UA 的三角标（另给一枚自绘的展开指示：随开合换字 ＋ 箭头旋转，比三角标多一样信息通道）。 */
+        '  list-style: none;',
+        '  transition: background-color 120ms ease;',
+        '}',
+        s('sum') + '::-webkit-details-marker {',
+        '  display: none;',
+        '}',
+        '/* 序号：多小节文档里的一、二、三。等宽数字 ＋ 恒不换行（只换行、不掉字）。',
+        '   窄档下它可能独占一行（标题的内在宽度撑满整行）：序号是**顺序信息**、不是与标题同级的一块，',
+        '   独占一行仍读得出"这是第几节"，故不为它单独开一档布局（换了会让标题掉字）。 */',
+        s('ordinal') + ' {',
+        '  flex: none;',
+        '  color: ' + skinVar('accent-text') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  font-weight: 800;',
+        '  font-variant-numeric: tabular-nums;',
+        '  white-space: nowrap;',
+        '}',
+        s('title') + ' {',
+        '  flex: 1 1 max-content;',
+        '  min-width: min(100%, 12ch);',
+        '  margin: 0;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font') + ';',
+        '  font-size: ' + skinVar('fs-h3') + ';',
+        '  font-weight: 700;',
+        '  line-height: 1.35;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* 计数：恒不换行、恒不被压没（`flex:none` 是它在窄档的保命符）。 */',
+        s('count') + ' {',
+        '  flex: none;',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  font-weight: 700;',
+        '  font-variant-numeric: tabular-nums;',
+        '  white-space: nowrap;',
+        '}',
+        '/* 展开指示：`::before` 出字（按 `[open]` 换「展开／收起」）、`::after` 只出旋转的箭头 ——',
+        '   换字不跳版（两枚字宽度不同，但箭头那一段恒宽）。文本是**呈现事实**，不住在标记里。 */',
+        more + ' {',
+        '  flex: none;',
+        '  margin-left: auto;',
+        /* **给「展开／收起」留一格地板**：两枚字与箭头都由 `::before`／`::after` 出，而**伪元素的内容宽
+           不进入 flex 的自动下限**（实测：`min-width:max-content`／`width:max-content` 三档都压成 30px，
+           内容要 36px ⇒ 整件横向溢出 6px）。这一格里最长的一枚是「展开」（2 个 `fs-xs` 汉字 ≈ 24px）
+           加箭头那一段（≈ 8px）⇒ 右侧留出 2 个 `fs-xs` 的空。 */
+        '  padding-right: calc(2 * ' + skinVar('fs-xs') + ');',
+        '  color: ' + skinVar('accent-text') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  font-weight: 700;',
+        '  white-space: nowrap;',
+        '}',
+        s('more') + '::before {',
+        '  content: "' + SECTION_HEAD_MORE_TEXTS.folded + '";',
+        '}',
+        s('more') + '::after {',
+        '  content: "' + SECTION_HEAD_CARET_CODE + '";',
+        '  display: inline-block;',
+        '  margin-left: 2px;',
+        '  transition: transform 120ms ease;',
+        '}',
+        boxOpen + slot('more') + '::before {',
+        '  content: "' + SECTION_HEAD_MORE_TEXTS.open + '";',
+        '}',
+        boxOpen + slot('more') + '::after {',
+        '  transform: rotate(90deg);',
+        '}',
+        '/* 正文：受信透传的标记落这里，只给分组间距与换行——本件不再给它加壳。 */',
+        s('body') + ' {',
+        '  display: grid;',
+        '  gap: ' + skinVar('space') + ';',
+        '  min-width: 0;',
+        '  padding: 4px 0 8px;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* 折叠时必须真的看不见：UA 给 details 的闭合内容上的是 `content-visibility: hidden`，',
+        '   而上面那条 `display: grid` 会把它顶掉（实测：折叠后正文仍占 26px 高）⇒ 这一条按闭合态显式收口。',
+        '   只收本件自己的正文槽（`>` 限直系），不碰调用方塞进来的任何东西。 */',
+        box + ':not([open]) > ' + slot('body') + ' {',
+        '  display: none;',
+        '}',
+        '/* 焦点地板：本件自身不带可点元素；调用方若把标题或正文里的东西包成链接，焦点必须看得见',
+        '   ——不许只写 `outline:none` 而不给替代。 */',
+        box + ' :focus-visible {',
+        '  outline: 2px solid ' + skinVar('accent') + ';',
+        '  outline-offset: 2px;',
+        '}',
+        '/* 悬停反馈只在细指针 ＋ 有悬停时给（触屏不靠它——它**不是**唯一通路）。 */',
+        '@media (hover:hover) and (pointer:fine) {',
+        '  ' + s('sum') + ':hover {',
+        '    background-color: ' + skinVar('accent-soft') + ';',
+        '  }',
+        '}',
+        '@media (prefers-reduced-motion:reduce) {',
+        '  ' + s('sum') + ',',
+        '  ' + s('more') + '::after {',
+        '    transition-duration: 0.01ms;',
+        '  }',
+        '}',
+        '/* 窄容器（<' + String(NARROW_PX) + 'px）：计数与展开指示整行掉到第二行——',
+        '   标题占满整行（不被挤成一列孤字），计数与指示各自成段。判的是**本件自己的宽度**。 */',
+        '@container (max-width: ' + String(NARROW_PX) + 'px) {',
+        '  ' + s('sum') + ' {',
+        '    align-items: baseline;',
+        '  }',
+        '  ' + s('more') + ' {',
+        '    margin-left: 0;',
+        '  }',
+        '}',
+    ].join(LF);
+}

package/dist/components/section-head/style.js.map

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

package/dist/components/shared/escape.d.ts

@@ -0,0 +1,3 @@
+/** 五字符转义（`& < > " '`）；表外的字符原样。 */
+export declare function esc(value: string): string;
+//# sourceMappingURL=escape.d.ts.map

package/dist/components/shared/escape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.d.ts","sourceRoot":"","sources":["../../../src/components/shared/escape.ts"],"names":[],"mappings":"AAUA,kCAAkC;AAClC,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzC"}

package/dist/components/shared/escape.js

@@ -0,0 +1,11 @@
+/** 组件层共用：五字符转义（唯一口径 = 冻结的 `ESCAPE_HTML_CHARS`／`ESCAPE_HTML_ENTITIES`，
+ *  与 `controls.ts`／`blocks.ts` 同源——第三处不新造表，只读同一份冻结常量）。
+ *
+ *  为什么单独一件：每个组件都要转义自己的文本字段，把这张表抄进各组件 = 五处走散的风险；
+ *  本件是组件层的**唯一转义入口**（`shared/` 只放这类跨组件小件，不放组件）。 */
+import { ESCAPE_HTML_CHARS, ESCAPE_HTML_ENTITIES } from '../../spec/controls.js';
+const ESCAPE_RE = new RegExp('[' + ESCAPE_HTML_CHARS.join('') + ']', 'g');
+/** 五字符转义（`& < > " '`）；表外的字符原样。 */
+export function esc(value) {
+    return value.replace(ESCAPE_RE, (ch) => ESCAPE_HTML_ENTITIES[ch] ?? ch);
+}

package/dist/components/shared/escape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.js","sourceRoot":"","sources":["../../../src/components/shared/escape.ts"],"names":[],"mappings":"AAAA;;;;mDAImD;AACnD,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAGjF,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,GAAG,GAAG,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC;AAE1E,kCAAkC;AAClC,MAAM,UAAU,GAAG,CAAC,KAAa;IAC/B,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,oBAAoB,CAAC,EAAoB,CAAC,IAAI,EAAE,CAAC,CAAC;AAC5F,CAAC"}

package/dist/components/shared/typography.d.ts

@@ -0,0 +1,32 @@
+/** 组件层共用：纸面族的两条**字面栈**（唯一一处定义；**2026-09-25 起没有组件引用它**，见文末一段）。
+ *
+ *  **逐字照抄原型**（`.scratch/diet-ui-proto/v2-小票.html` 的 `:root`）：
+ *   · `PAPER_SANS_STACK` ← 原型 `--sans`：纸上的**字**（标签／名称／备注／小标题／印章）；
+ *   · `PAPER_MONO_STACK` ← 原型 `--mono`：纸上的**数**（主数字／分母／账目值／时间／克数／
+ *     明细值／刻度行读数／打孔格）。
+ *
+ *  为什么数字要单独一条栈（2026-09-24 用户两轮图报「数字 0 不是同一个字体」「为什么数字 0 还是不变」）：
+ *  原型里**所有数字位都写 `font-family:var(--mono)`**（`.total .n`／`.line .v`／`.item .t,.g,.kcal`／
+ *  `.code-row .pct`／`.punch .d,.b.on`），Windows 上命中 **Consolas**——它的 0 带一条斜杠；
+ *  上一版只把纸面的**正文**栈按原型排了序（命中雅黑），数字仍继承正文字面 ⇒ 0 是"普通椭圆"。
+ *  放大裁剪实测（`.dsh-vision-router` 产物，1200×900 截图按原始像素裁比例）：样张 860 的 0 **带斜杠**，
+ *  落地页 860 的 0 是**完整椭圆**——这才是"看起来不是同一个字体"的实况。
+ *  所以这里的口径是：**字面的两条栈都照抄原型**——正文归 sans、**数字归 mono**。
+ *
+ *  纪律：只写栈值本身，不写 `font-family:` 前缀、不带分号（调用方拼进各自的规则里）；
+ *  栈里不引用 token（照 `helpShell` 的 `BODY_FONT_STACK` 先例，字面量与 token 名是两回事）。
+ *
+ *  **现在还有谁在用／为什么留着**（#950 整改，2026-09-25 实测：全仓 `grep PAPER_MONO_STACK|PAPER_SANS_STACK`
+ *  只命中本文件与 `docs/base/base-render/单据族组件.md`）：
+ *   · **没有任何组件引用这两条栈**——单据族六件（`sheet-frame`／`summary-head`／`scale-bar`／`ledger-rows`／
+ *     `entry-rows`／`punch-strip`）已改成经 `skinVar('font-num')`（九处数字位）与 `skinVar('font')`（纸面正文）
+ *     读皮肤 ⇒ 它们的字面**随皮肤走**（`paper` 皮肤的 `font-num` 就是下面这条 `--mono` 等宽栈，默认档观感不变）。
+ *   · **不删**：① 文档仍按名字引它（上引那份的第七节）；② 它是原型 `--sans`／`--mono` **原序的唯一记录**
+ *     （保真轮的对照物），删掉这串顺序就无处可查；③ 删它属于动"别人可能引用的共用位"，不在本次整改范围。
+ *   · **值一个字都不许动**：改了它，那些仍靠 `var(--fg)` 一类冻结 token 的老页面基线就跟着动。
+ */
+/** 正文栈（原型 `--sans`，**顺序不许动**：Windows 上没有前两项 ⇒ 命中 Microsoft YaHei）。 */
+export declare const PAPER_SANS_STACK = "-apple-system, BlinkMacSystemFont, \"PingFang SC\", \"Microsoft YaHei\", system-ui, sans-serif";
+/** 数字栈（原型 `--mono`，**顺序不许动**：Windows 上没有前四项 ⇒ 命中 Consolas，0 带斜杠）。 */
+export declare const PAPER_MONO_STACK = "ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, \"Liberation Mono\", monospace";
+//# sourceMappingURL=typography.d.ts.map

package/dist/components/shared/typography.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typography.d.ts","sourceRoot":"","sources":["../../../src/components/shared/typography.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,mGAA+F,CAAC;AAE7H,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,+FAA2F,CAAC"}

package/dist/components/shared/typography.js

@@ -0,0 +1,31 @@
+/** 组件层共用：纸面族的两条**字面栈**（唯一一处定义；**2026-09-25 起没有组件引用它**，见文末一段）。
+ *
+ *  **逐字照抄原型**（`.scratch/diet-ui-proto/v2-小票.html` 的 `:root`）：
+ *   · `PAPER_SANS_STACK` ← 原型 `--sans`：纸上的**字**（标签／名称／备注／小标题／印章）；
+ *   · `PAPER_MONO_STACK` ← 原型 `--mono`：纸上的**数**（主数字／分母／账目值／时间／克数／
+ *     明细值／刻度行读数／打孔格）。
+ *
+ *  为什么数字要单独一条栈（2026-09-24 用户两轮图报「数字 0 不是同一个字体」「为什么数字 0 还是不变」）：
+ *  原型里**所有数字位都写 `font-family:var(--mono)`**（`.total .n`／`.line .v`／`.item .t,.g,.kcal`／
+ *  `.code-row .pct`／`.punch .d,.b.on`），Windows 上命中 **Consolas**——它的 0 带一条斜杠；
+ *  上一版只把纸面的**正文**栈按原型排了序（命中雅黑），数字仍继承正文字面 ⇒ 0 是"普通椭圆"。
+ *  放大裁剪实测（`.dsh-vision-router` 产物，1200×900 截图按原始像素裁比例）：样张 860 的 0 **带斜杠**，
+ *  落地页 860 的 0 是**完整椭圆**——这才是"看起来不是同一个字体"的实况。
+ *  所以这里的口径是：**字面的两条栈都照抄原型**——正文归 sans、**数字归 mono**。
+ *
+ *  纪律：只写栈值本身，不写 `font-family:` 前缀、不带分号（调用方拼进各自的规则里）；
+ *  栈里不引用 token（照 `helpShell` 的 `BODY_FONT_STACK` 先例，字面量与 token 名是两回事）。
+ *
+ *  **现在还有谁在用／为什么留着**（#950 整改，2026-09-25 实测：全仓 `grep PAPER_MONO_STACK|PAPER_SANS_STACK`
+ *  只命中本文件与 `docs/base/base-render/单据族组件.md`）：
+ *   · **没有任何组件引用这两条栈**——单据族六件（`sheet-frame`／`summary-head`／`scale-bar`／`ledger-rows`／
+ *     `entry-rows`／`punch-strip`）已改成经 `skinVar('font-num')`（九处数字位）与 `skinVar('font')`（纸面正文）
+ *     读皮肤 ⇒ 它们的字面**随皮肤走**（`paper` 皮肤的 `font-num` 就是下面这条 `--mono` 等宽栈，默认档观感不变）。
+ *   · **不删**：① 文档仍按名字引它（上引那份的第七节）；② 它是原型 `--sans`／`--mono` **原序的唯一记录**
+ *     （保真轮的对照物），删掉这串顺序就无处可查；③ 删它属于动"别人可能引用的共用位"，不在本次整改范围。
+ *   · **值一个字都不许动**：改了它，那些仍靠 `var(--fg)` 一类冻结 token 的老页面基线就跟着动。
+ */
+/** 正文栈（原型 `--sans`，**顺序不许动**：Windows 上没有前两项 ⇒ 命中 Microsoft YaHei）。 */
+export const PAPER_SANS_STACK = '-apple-system, BlinkMacSystemFont, "PingFang SC", "Microsoft YaHei", system-ui, sans-serif';
+/** 数字栈（原型 `--mono`，**顺序不许动**：Windows 上没有前四项 ⇒ 命中 Consolas，0 带斜杠）。 */
+export const PAPER_MONO_STACK = 'ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace';

package/dist/components/shared/typography.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typography.js","sourceRoot":"","sources":["../../../src/components/shared/typography.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,sEAAsE;AACtE,MAAM,CAAC,MAAM,gBAAgB,GAAG,4FAA4F,CAAC;AAE7H,qEAAqE;AACrE,MAAM,CAAC,MAAM,gBAAgB,GAAG,wFAAwF,CAAC"}

package/dist/components/shared/validate.d.ts

@@ -0,0 +1,26 @@
+/** 组件层共用：入参校验小件（口径与 `blocks.ts` 的同名小件逐条一致——**同一个规矩不在两处各写一套**）。
+ *
+ *  错误类型：`BlocksError`（与区块层同名同形）。组件层不新造错误类：调用方按 `error.name` 分辨即可。
+ */
+/** 入参违规：抛 `BlocksError`（`name` 与区块层一致，调用方一条判据通吃）。 */
+export declare function badInput(message: string): never;
+/** 必须是普通对象（数组／null 一律拒）。 */
+export declare function assertPlainObject(value: unknown, field: string): void;
+/** 必填非空字符串。 */
+export declare function reqText(value: unknown, field: string): string;
+/** 可选字符串：`undefined` 透传；空串按"未给"处理（与区块层同口径）。 */
+export declare function optText(value: unknown, field: string): string | undefined;
+/** 可选数字：数字收 `String(value)`；字串须非空非空白且 `Number()` 有限。 */
+export declare function optNumeric(value: unknown, field: string): string | undefined;
+/** 可选附加类名：空格分隔、逐个过类名正则（防注入任意选择器）。 */
+export declare function optExtraClass(value: unknown, field: string): string | undefined;
+/** 数组**不许有洞**（稀疏数组一律拒）：`new Array(3)` 这种数组 `length` 照算，可
+ *  `Array.prototype.map`／`forEach` 会**跳过**空洞、`for…of` 又会把洞取成 `undefined`
+ *  ⇒ 校验遍历被跳过、渲染那一头在 `undefined` 上读字段，抛出来的是一枚 `TypeError`，
+ *  不是 `BlocksError`（「非法入参一律 `badInput`」当场破功，且报错点离真正的错处很远）。
+ *
+ *  逐下标查 `hasOwnProperty`：`[undefined]`（**显式**给了 `undefined` 的密数组）不算洞——
+ *  那种会在各件自己的逐项校验里被拒（元素不是对象），报错点照样点得准。
+ */
+export declare function assertDenseArray(value: readonly unknown[], field: string): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/components/shared/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/components/shared/validate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qDAAqD;AACrD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAI/C;AAED,4BAA4B;AAC5B,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAErE;AAED,eAAe;AACf,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED,+CAA+C;AAC/C,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIzE;AAED,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAY5E;AAED,qCAAqC;AACrC,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ/E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAO/E"}

package/dist/components/shared/validate.js

@@ -0,0 +1,75 @@
+/** 组件层共用：入参校验小件（口径与 `blocks.ts` 的同名小件逐条一致——**同一个规矩不在两处各写一套**）。
+ *
+ *  错误类型：`BlocksError`（与区块层同名同形）。组件层不新造错误类：调用方按 `error.name` 分辨即可。
+ */
+/** 入参违规：抛 `BlocksError`（`name` 与区块层一致，调用方一条判据通吃）。 */
+export function badInput(message) {
+    const err = new Error(message);
+    err.name = 'BlocksError';
+    throw err;
+}
+/** 必须是普通对象（数组／null 一律拒）。 */
+export function assertPlainObject(value, field) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        badInput(field + ' 必须是对象');
+}
+/** 必填非空字符串。 */
+export function reqText(value, field) {
+    if (typeof value !== 'string' || value === '')
+        badInput(field + ' 必须是非空字符串');
+    return value;
+}
+/** 可选字符串：`undefined` 透传；空串按"未给"处理（与区块层同口径）。 */
+export function optText(value, field) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string')
+        badInput(field + ' 必须是字符串');
+    return value === '' ? undefined : value;
+}
+/** 可选数字：数字收 `String(value)`；字串须非空非空白且 `Number()` 有限。 */
+export function optNumeric(value, field) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value))
+            badInput(field + ' 必须是有限数字');
+        return String(value);
+    }
+    if (typeof value === 'string') {
+        const s = value.trim();
+        if (s === '' || !Number.isFinite(Number(s)))
+            badInput(field + ' 必须是数字串');
+        return s;
+    }
+    badInput(field + ' 必须是数字或数字串');
+}
+/** 可选附加类名：空格分隔、逐个过类名正则（防注入任意选择器）。 */
+export function optExtraClass(value, field) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string' || value.trim() === '')
+        badInput(field + ' 必须是非空字符串');
+    const names = value.trim().split(/\s+/);
+    for (const name of names) {
+        if (!/^-?[A-Za-z_][A-Za-z0-9_-]*$/.test(name))
+            badInput(field + ' 只许空格分隔的类名：' + name);
+    }
+    return names.join(' ');
+}
+/** 数组**不许有洞**（稀疏数组一律拒）：`new Array(3)` 这种数组 `length` 照算，可
+ *  `Array.prototype.map`／`forEach` 会**跳过**空洞、`for…of` 又会把洞取成 `undefined`
+ *  ⇒ 校验遍历被跳过、渲染那一头在 `undefined` 上读字段，抛出来的是一枚 `TypeError`，
+ *  不是 `BlocksError`（「非法入参一律 `badInput`」当场破功，且报错点离真正的错处很远）。
+ *
+ *  逐下标查 `hasOwnProperty`：`[undefined]`（**显式**给了 `undefined` 的密数组）不算洞——
+ *  那种会在各件自己的逐项校验里被拒（元素不是对象），报错点照样点得准。
+ */
+export function assertDenseArray(value, field) {
+    for (let i = 0; i < value.length; i += 1) {
+        if (!Object.prototype.hasOwnProperty.call(value, i)) {
+            badInput(field + '[' + String(i) + '] 是个空洞（稀疏数组）'
+                + '：每个下标上都要真有一项（`new Array(n)` 这种写法先填满再传）');
+        }
+    }
+}

package/dist/components/shared/validate.js.map

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

package/dist/components/sheet-frame/index.d.ts

@@ -0,0 +1,14 @@
+/** sheet-frame · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  四件出口：
+ *   · `renderSheetFrame(input)` —— 产标记（纯函数，零 DOM）；
+ *   · `sheetFrameCss()` —— 纸这一件的样式段；
+ *   · `sheetCss()` —— **本族样式汇总**（纸 ＋ 主数字头 ＋ 刻度条 ＋ 账目行 ＋ 明细行）；
+ *   · `SHEET_VARIANTS` —— 纸的性格闭集（`plain`／`receipt`）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ */
+export { SHEET_VARIANTS, renderSheetFrame } from './render.js';
+export type { SheetFrameInput, SheetVariant } from './render.js';
+export { sheetCss, sheetFrameCss } from './style.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/sheet-frame/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/sheet-frame/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/D,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/sheet-frame/index.js

@@ -0,0 +1,12 @@
+/** sheet-frame · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  四件出口：
+ *   · `renderSheetFrame(input)` —— 产标记（纯函数，零 DOM）；
+ *   · `sheetFrameCss()` —— 纸这一件的样式段；
+ *   · `sheetCss()` —— **本族样式汇总**（纸 ＋ 主数字头 ＋ 刻度条 ＋ 账目行 ＋ 明细行）；
+ *   · `SHEET_VARIANTS` —— 纸的性格闭集（`plain`／`receipt`）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ */
+export { SHEET_VARIANTS, renderSheetFrame } from './render.js';
+export { sheetCss, sheetFrameCss } from './style.js';

package/dist/components/sheet-frame/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/sheet-frame/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/D,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/sheet-frame/render.d.ts

@@ -0,0 +1,21 @@
+/** 纸的两种性格：`plain`＝素纸（中性卡片纸，缺省）／`receipt`＝小票纸（暖白、纸边、配撕口与裁切线）。 */
+export declare const SHEET_VARIANTS: readonly ["plain", "receipt"];
+export type SheetVariant = (typeof SHEET_VARIANTS)[number];
+/** 纸面页框的入参。 */
+export interface SheetFrameInput {
+    /** 纸里的正文（**已装配好的标记**，受信透传、不再转义——与 `renderPageShell.content` 同口径）。 */
+    readonly content: string;
+    /** 纸的性格；缺省 `plain`。 */
+    readonly variant?: SheetVariant;
+    /** 左右两枚撕口（打孔）；缺省 `false`（素纸不出这两枚）。 */
+    readonly notch?: boolean;
+    /** 页尾裁切线；缺省 `false`。 */
+    readonly cutLine?: boolean;
+    /** 版面锚点（页内导航指过来用）；不给＝不带 id。 */
+    readonly id?: string;
+    /** 版面根附加类名（空格分隔）。 */
+    readonly extraClass?: string;
+}
+/** 纸面页框：一整页的纸张层。`content` 为空串＝出一张空纸（不报错——空页也是一种页）。 */
+export declare function renderSheetFrame(input: SheetFrameInput): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/components/sheet-frame/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/components/sheet-frame/render.ts"],"names":[],"mappings":"AAoBA,gEAAgE;AAChE,eAAO,MAAM,cAAc,+BAAgC,CAAC;AAC5D,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,eAAe;AACf,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uBAAuB;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,sCAAsC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,wBAAwB;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAoB/D"}

package/dist/components/sheet-frame/render.js

@@ -0,0 +1,45 @@
+/** sheet-frame · **渲染**（本组件对外的形状面之一）。
+ *
+ *  —— 纸面页框（"整页是一张单据"）——
+ *
+ *  一句话：把一整页内容放进**一张纸**里——纸面、纸边、可选的两枚撕口（打孔）与页尾裁切线。
+ *
+ *  它替掉的是哪几种错法（见同目录 README「常见错法」）：
+ *   · 每张页各写一套 `background`／`border`／`border-radius`／`box-shadow`（同族页的纸边逐页不同）；
+ *   · 拿「卡片」当「纸」：卡片是**页里的块**，纸是**页本身**——两者混用会出现「卡里卡」；
+ *   · 撕口／裁切线用图片或伪元素各页自造，且与纸边对不齐。
+ *
+ *  它**不**管：页头（`renderPageShell`）、来源与口径行（`renderCaliberLine`）、复制区（`renderCopyBlock`）——
+ *  这三件的落点与文案归调用方，本件只提供"纸"这一层。
+ *
+ *  本组件无运行时 ⇒ 无 `attrs.ts`：契约常量与入参类型就住本件（那条目录规矩的用途是
+ *  「渲染与运行时共用同一份事实」，没有运行时就没有第二个读者）。
+ */
+import { esc } from '../shared/escape.js';
+import { assertPlainObject, badInput, optExtraClass, optText } from '../shared/validate.js';
+/** 纸的两种性格：`plain`＝素纸（中性卡片纸，缺省）／`receipt`＝小票纸（暖白、纸边、配撕口与裁切线）。 */
+export const SHEET_VARIANTS = ['plain', 'receipt'];
+/** 纸面页框：一整页的纸张层。`content` 为空串＝出一张空纸（不报错——空页也是一种页）。 */
+export function renderSheetFrame(input) {
+    assertPlainObject(input, 'renderSheetFrame: input');
+    const variant = input.variant ?? 'plain';
+    if (!SHEET_VARIANTS.includes(variant)) {
+        badInput('sheet-frame: input.variant 必须是 ' + SHEET_VARIANTS.join('／') + ' 之一');
+    }
+    if (typeof input.content !== 'string')
+        badInput('sheet-frame: input.content 必须是字符串');
+    const id = optText(input.id, 'sheet-frame: input.id');
+    const extra = optExtraClass(input.extraClass, 'sheet-frame: input.extraClass');
+    const parts = ['<section class="ilife-block-sheet is-' + variant
+            + (extra === undefined ? '' : ' ' + extra) + '"'
+            + (id === undefined ? '' : ' id="' + esc(id) + '"') + '>'];
+    if (input.notch === true) {
+        parts.push('<span class="ilife-block-sheet-notch is-left" aria-hidden="true"></span>');
+        parts.push('<span class="ilife-block-sheet-notch is-right" aria-hidden="true"></span>');
+    }
+    parts.push('<div class="ilife-block-sheet-body">' + input.content + '</div>');
+    if (input.cutLine === true)
+        parts.push('<div class="ilife-block-sheet-cut" aria-hidden="true"></div>');
+    parts.push('</section>');
+    return parts.join('');
+}

package/dist/components/sheet-frame/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/components/sheet-frame/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAE5F,gEAAgE;AAChE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,SAAS,CAAU,CAAC;AAmB5D,sDAAsD;AACtD,MAAM,UAAU,gBAAgB,CAAC,KAAsB;IACrD,iBAAiB,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,OAAO,CAAC;IACzC,IAAI,CAAE,cAAoC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7D,QAAQ,CAAC,iCAAiC,GAAG,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QAAE,QAAQ,CAAC,mCAAmC,CAAC,CAAC;IACrF,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,uBAAuB,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,UAAU,EAAE,+BAA+B,CAAC,CAAC;IAC/E,MAAM,KAAK,GAAa,CAAC,uCAAuC,GAAG,OAAO;cACtE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,GAAG;cAC9C,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;IAC7D,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;QACvF,KAAK,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;IAC1F,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,sCAAsC,GAAG,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC;IAC9E,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;IACvG,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC"}

package/dist/components/sheet-frame/style.d.ts

@@ -0,0 +1,14 @@
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export declare function sheetFrameCss(input?: {
+    readonly prefix?: string;
+}): string;
+/** **本族样式的汇总入口**（纸面 ＋ 主数字头 ＋ 刻度条 ＋ 账目行 ＋ 明细行 ＋ 打孔格带）。
+ *
+ *  为什么汇总在"纸"这一件：这一族的五个内容件都只在纸上成立（同一份纸边、同一套内距与行距），
+ *  调用方一行 `sheetCss()` 就能把它们一起挂上，不必记住五个函数名——
+ *  与 `pageShapeCss()` 汇总导航族／横条族是同一条口径。
+ *  恒返回非空 CSS 文本。 */
+export declare function sheetCss(input?: {
+    readonly prefix?: string;
+}): string;
+//# sourceMappingURL=style.d.ts.map

package/dist/components/sheet-frame/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../../src/components/sheet-frame/style.ts"],"names":[],"mappings":"AAwBA,4BAA4B;AAC5B,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAiE1E;AAED;;;;;oBAKoB;AACpB,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CASrE"}