base-paint 0.3.13 → 0.3.15

package/dist/components/search-field/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../../src/components/search-field/style.ts"],"names":[],"mappings":"AAcA,6DAA6D;AAC7D,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,IAAyB,CAAC;AAE1D,uDAAuD;AACvD,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,2DAA2D;AAC3D,wBAAgB,cAAc,IAAI,MAAM,CA6FvC"}

package/dist/components/search-field/style.js

@@ -0,0 +1,113 @@
+/** searchField · **样式段**（本件唯一的样式来源）。
+ *
+ *  三条纪律：
+ *   1. 只经 `skinVar()` 读皮肤（**不手写 `var(--ilife-…)`**：兜底链只许住在 `skin/contract.ts`），
+ *      零硬编码颜色、零 `:root`、零 `!important`；
+ *   2. 全部选择器 scope 在 `.<prefix>page-ui` 之下（`PAGE_UI_CLASS` 从 `page-ui` 取，不另抄一份字面量）
+ *      ⇒ 没挂根类的页面一条都命中不到（加法式）；
+ *   3. 宽度一律容器驱动：换行靠 `flex-wrap`、收缩靠 `minmax(0,…)`／`min-width:0`，
+ *      **零** `@media (max-width: …)`；媒体查询只判设备能力（hover／pointer／reduced-motion）。
+ */
+import { PAGE_LIMITS, PAGE_UI_CLASS } from '../page-ui/index.js';
+import { skinVar } from '../skin/contract.js';
+import { SEARCH_CURRENT_ATTR, SEARCH_HIT_ATTR, SEARCH_ITEM_ATTR, SEARCH_LOADING_ATTR, SEARCH_ROOT_CLASS } from './attrs.js';
+/** 宽档上限：1280 档下不让输入框拉成一条 1252px 的空带（390 档上限不生效，内容宽本就小于它）。 */
+export const SEARCH_MAX_WIDTH_PX = 680;
+/** 触控目标下限（≥44×44，**全宽档**口径）：与 `page-ui` 的 `PAGE_LIMITS.touchMinPx` 同一个数、同一件事。 */
+export const SEARCH_TOUCH_MIN_PX = PAGE_LIMITS.touchMinPx;
+/** 读数行的宽度锁（`ch`）：载入态原地换字时行宽不许跳（工艺书状态矩阵的 loading 条）。 */
+export const SEARCH_STATUS_MIN_CH = 14;
+/** 本件的样式段（调用方拼进 `<style>`；`searchFieldCss()` 是它唯一的对外名）。 */
+export function searchFieldCss() {
+    const R = '.' + PAGE_UI_CLASS + ' .' + SEARCH_ROOT_CLASS;
+    const P = '.' + PAGE_UI_CLASS + ' ';
+    const LOADING_ON = '[' + SEARCH_LOADING_ATTR + '="1"]';
+    const T = SEARCH_TOUCH_MIN_PX + 'px';
+    const ink = skinVar('ink');
+    const ink2 = skinVar('ink-2');
+    const ink3 = skinVar('ink-3');
+    const line = skinVar('line');
+    const accent = skinVar('accent');
+    const accentText = skinVar('accent-text');
+    const accentSoft = skinVar('accent-soft');
+    const surface2 = skinVar('surface-2');
+    const danger = skinVar('danger');
+    const radiusSm = skinVar('radius-sm');
+    const font = skinVar('font');
+    const fsSm = skinVar('fs-sm');
+    const fsXs = skinVar('fs-xs');
+    const fsBody = skinVar('fs-body');
+    const fsH2 = skinVar('fs-h2');
+    return [
+        '/* searchField（搜索框 · 形态 B：范围分段 ＋ 下划线输入 ＋ 命中读数）。',
+        '   下划线走 `border-bottom`（印刷风）；读数里的数是运行时的真读数，渲染期写「—」。 */',
+        R + '{display:grid;gap:8px;min-width:0;' + 'max-width:' + SEARCH_MAX_WIDTH_PX + 'px;',
+        '  color:' + ink + ';font-family:' + font + ';font-size:' + fsBody + ';line-height:1.5}',
+        /* 范围分段：换行不横滑 */
+        R + '-scope{display:flex;flex-wrap:wrap;gap:8px;min-width:0}',
+        R + '-scope-btn{display:inline-flex;align-items:center;justify-content:center;gap:6px;box-sizing:border-box;',
+        '  min-height:' + T + ';padding:0 12px;border:0;border-bottom:2px solid ' + line + ';',
+        '  background:transparent;color:' + ink2 + ';font:inherit;font-size:' + fsSm + ';cursor:pointer;white-space:nowrap;',
+        '  transition:transform 80ms}',
+        R + '-scope-btn .' + SEARCH_ROOT_CLASS + '-n{color:' + ink3 + ';font-size:' + fsXs + ';font-variant-numeric:tabular-nums}',
+        /* 聚焦范围钮＝**有文字的选中面**（`docs/base/base-render/选中态与皮肤语言.md` 第三节）：
+           底 `accent-soft`、字 `accent-text`、描边＝主色下划线 `accent`、✓ 走 `accent`、字重 700。
+           本件的形态要害是下划线，故 `border-bottom-color` 直接就是法则表那条「描边 `accent`」。 */
+        R + '-scope-btn[aria-pressed="true"]{background:' + accentSoft + ';border-bottom-color:' + accent + ';'
+            + 'color:' + accentText + ';font-weight:700}',
+        R + '-scope-btn[aria-pressed="true"]::before{content:"✓";color:' + accent + ';font-size:11px}',
+        R + '-scope-btn[aria-pressed="true"] .' + SEARCH_ROOT_CLASS + '-n{color:' + accentText + '}',
+        /* 输入行：下划线。行内各件间距 ≥8px（工艺书：相邻触控目标间距 ≥8px——输入框与清空键都是命中盒） */
+        R + '-box{display:flex;align-items:center;gap:8px;box-sizing:border-box;min-height:' + T + ';min-width:0;',
+        '  border-bottom:2px solid ' + line + ';background:transparent}',
+        R + '-box:focus-within{border-bottom-color:' + accent + '}',
+        R + '-ico{flex:0 0 auto;margin-right:-4px;color:' + ink3 + ';font-size:' + fsBody + ';line-height:1}',
+        R + '-input{flex:1 1 auto;min-width:0;box-sizing:border-box;min-height:' + T + ';padding:0;border:0;',
+        '  background:transparent;color:' + ink + ';font:inherit;font-size:' + fsBody + '}',
+        R + '-input::placeholder{color:' + ink3 + '}',
+        R + '-input:focus-visible{outline:2px solid ' + accent + ';outline-offset:1px}',
+        R + '-input[disabled]{color:' + ink3 + ';cursor:not-allowed}',
+        /* 清空与前后跳：命中盒 ≥44×44（视觉小、命中大） */
+        R + '-clear,' + R + '-step{display:inline-flex;align-items:center;justify-content:center;flex:0 0 auto;',
+        '  box-sizing:border-box;min-width:' + T + ';min-height:' + T + ';padding:0;border:0;border-radius:' + radiusSm + ';',
+        '  background:transparent;color:' + ink2 + ';font:inherit;font-size:' + fsSm + ';cursor:pointer;transition:transform 80ms}',
+        R + '-step{font-size:' + fsH2 + '}',
+        R + '-clear:active,' + R + '-step:active,' + R + '-scope-btn:active{transform:scale(.98)}',
+        R + '-clear:focus-visible,' + R + '-step:focus-visible,' + R + '-scope-btn:focus-visible{outline:2px solid ' + accent + ';outline-offset:2px}',
+        R + '-clear[disabled],' + R + '-step[disabled],' + R + '-scope-btn[disabled]{color:' + ink3 + ';cursor:not-allowed;background:transparent}',
+        R + '-clear[disabled]:active,' + R + '-step[disabled]:active,' + R + '-scope-btn[disabled]:active{transform:none}',
+        /* 读数行：命中数 ＋ 当前范围 ＋ 第几处（宽度锁住，载入态原地换字不跳版） */
+        R + '-readout{display:flex;flex-wrap:wrap;align-items:center;justify-content:space-between;gap:4px 12px;min-width:0}',
+        R + '-status{margin:0;min-width:' + SEARCH_STATUS_MIN_CH + 'ch;min-height:1.6em;color:' + ink2 + ';font-size:' + fsSm + ';line-height:1.6}',
+        R + '-status b{color:' + ink + ';font-weight:700;font-variant-numeric:tabular-nums}',
+        R + '-dim{color:' + ink3 + '}',
+        R + '-status-loading{display:none;color:' + ink3 + '}',
+        R + LOADING_ON + ' .' + SEARCH_ROOT_CLASS + '-status-text{display:none}',
+        R + LOADING_ON + ' .' + SEARCH_ROOT_CLASS + '-status-loading{display:inline}',
+        R + '-nav{display:inline-flex;align-items:center;gap:8px;flex:0 0 auto}',
+        R + '-pos{color:' + ink2 + ';font-size:' + fsSm + ';white-space:nowrap;font-variant-numeric:tabular-nums}',
+        R + '-pos b{color:' + ink + ';font-weight:700}',
+        /* 空态与错态：写在控件旁边，不只染色 */
+        R + '-empty{margin:0;padding:8px 0;color:' + ink2 + ';font-size:' + fsSm + ';line-height:1.6;overflow-wrap:anywhere}',
+        R + '-err{margin:0;padding:6px 0 6px 10px;border-left:2px solid ' + danger + ';color:' + danger + ';',
+        '  font-size:' + fsSm + ';line-height:1.6;overflow-wrap:anywhere}',
+        R + '-empty[hidden],' + R + '-err[hidden]{display:none}',
+        /* 被搜的条目：不匹配就收起（`hidden` 是运行时的过滤通道） */
+        P + '[' + SEARCH_ITEM_ATTR + '][hidden]{display:none}',
+        /* 命中词：`<mark>` ＋ 下划线 ＋ 加粗（形／字重两样，不只靠色块） */
+        P + '[' + SEARCH_HIT_ATTR + ']{background:transparent;color:' + ink + ';font-weight:700;',
+        '  box-shadow:inset 0 -2px 0 0 ' + accent + '}',
+        P + '[' + SEARCH_HIT_ATTR + '][' + SEARCH_CURRENT_ATTR + ']{background:' + accentSoft + ';',
+        '  box-shadow:inset 0 -3px 0 0 ' + accent + '}',
+        /* 载入态：整块降一档存在感，但**不**动版（不新增行、不改宽） */
+        R + LOADING_ON + ' .' + SEARCH_ROOT_CLASS + '-box{border-bottom-color:' + line + '}',
+        '@media (hover:hover) and (pointer:fine){',
+        '  ' + R + '-clear:hover,' + R + '-step:hover{color:' + ink + ';background:' + surface2 + '}',
+        '  ' + R + '-scope-btn:hover{border-bottom-color:' + ink2 + ';color:' + ink + '}',
+        '  ' + R + '-clear[disabled]:hover,' + R + '-step[disabled]:hover,' + R + '-scope-btn[disabled]:hover{background:transparent;color:' + ink3 + '}',
+        '}',
+        '@media (prefers-reduced-motion:reduce){',
+        '  ' + R + '-clear,' + R + '-step,' + R + '-scope-btn{transition:none}',
+        '}',
+    ].join('\n');
+}

package/dist/components/search-field/style.js.map

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

package/dist/components/section-head/attrs.d.ts

@@ -0,0 +1,53 @@
+/** section-head · **标记契约**（渲染与调用方共用的唯一事实：类名／槽位／形态闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-01-纸面与页头.mjs`，2026-09 用户裁定）
+ *  里的**形态 C「可折叠小节（原生 `details`，零脚本）」**——一段内容的开头一行：
+ *  序号 ＋ 小节标题 ＋ 计数 ＋ 展开指示，正文原生开合。
+ *
+ *  形态键写在 `SECTION_HEAD_FORMS`（闭集）：本件只有一格，但键必须存在——
+ *  「形态是骨架，不是地址」，日后加第二形态是在闭集里加一格，不是新开一件。
+ *  闭集外的值一律 `badInput`（不静默降级：降级会让调用方以为自己拿到了另一种骨架）。
+ */
+/** 本件的类名根：全部槽位类名都是 `SECTION_HEAD_CLASS + '-' + 槽名`。 */
+export declare const SECTION_HEAD_CLASS = "ilife-block-section-head";
+/** 槽位闭集（标记契约的一部分：`render.ts` 与判据都用这里的名字拼类名，不各抄一份字面量）。
+ *  **纯状态的类也算槽位**（`form-*`／`value-num` 这类）：一切挂在元素上的类名都从这一份拼出来，
+ *  这样"只碰自己的类名"这条纪律才能被机器断（自造的 `is-*` 短类名会混进公共命名空间）。 */
+export declare const SECTION_HEAD_SLOTS: readonly ["sum", "ordinal", "title", "count", "more", "body", "form-fd"];
+export type SectionHeadSlot = (typeof SECTION_HEAD_SLOTS)[number];
+/** 槽类的类名（唯一拼法：别处不许再写 `SECTION_HEAD_CLASS + '-' + …`）。 */
+export declare function sectionHeadSlot(slot: SectionHeadSlot, prefix?: string): string;
+/** 形态闭集：本件只落地了形态 C「可折叠小节（原生 `details`，零脚本）」。 */
+export declare const SECTION_HEAD_FORMS: readonly ["fd"];
+export type SectionHeadForm = (typeof SECTION_HEAD_FORMS)[number];
+/** 序号的取值范围（`1`–`999`）：整数、正数；出界即 `badInput`。 */
+export declare const SECTION_HEAD_SEQ_MIN = 1;
+export declare const SECTION_HEAD_SEQ_MAX = 999;
+/** 展开／收起两枚字**写在样式里**（`::before` 按 `[open]` 换）：标记里只有一枚空 `<span class="…-more">`。
+ *  这两枚串是**呈现事实**、不是入参，故住这里一处，判据按它对账。 */
+export declare const SECTION_HEAD_MORE_TEXTS: Readonly<{
+    folded: "展开";
+    open: "收起";
+}>;
+/** 展开指示的箭头字形（转义前的码位；样式里拼成 CSS 的 `content`）。 */
+export declare const SECTION_HEAD_CARET_CODE = "\\203A";
+/** 小节头入参。`title`／`body` 必填——**没有正文的"小节头"不是小节**（那是一条标题行）。 */
+export interface SectionHeadInput {
+    /** 小节标题（人话短标题，如「步骤」「食材」）。必填非空。 */
+    readonly title: string;
+    /** 正文（**已渲染好的标记**，受信透传、不转义；与 `sheet-frame.content` 同口径）。想要空小节给空串。 */
+    readonly body: string;
+    /** 序号（`1`–`999` 的整数）：多小节文档里的一、二、三。不给＝不出这一槽。 */
+    readonly seq?: number;
+    /** 计数（`6 步`／`11 味`／`3 件`）：恒不换行，窄档只换行、不掉字。 */
+    readonly count?: string;
+    /** 起始展开；缺省折叠（一页里展开多节＝读者先要滚动）。 */
+    readonly open?: boolean;
+    /** 形态键（闭集，缺省 `fd`）。 */
+    readonly form?: SectionHeadForm;
+    /** 锚点 id（页内导航指到这一节用）。 */
+    readonly id?: string;
+    /** 附加类名（空格分隔；逐个过类名正则）。 */
+    readonly extraClass?: string;
+}
+//# sourceMappingURL=attrs.d.ts.map

package/dist/components/section-head/attrs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.d.ts","sourceRoot":"","sources":["../../../src/components/section-head/attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,6BAA6B,CAAC;AAE7D;;sDAEsD;AACtD,eAAO,MAAM,kBAAkB,0EAerB,CAAC;AACX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,SAAW,GAAG,MAAM,CAEhF;AAED,gDAAgD;AAChD,eAAO,MAAM,kBAAkB,iBAAkB,CAAC;AAClD,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,+CAA+C;AAC/C,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC;wCACwC;AACxC,eAAO,MAAM,uBAAuB;;;EAA8C,CAAC;AAEnF,+CAA+C;AAC/C,eAAO,MAAM,uBAAuB,WAAW,CAAC;AAEhD,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,uBAAuB;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC;IAChC,yBAAyB;IACzB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B"}

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

@@ -0,0 +1,45 @@
+/** section-head · **标记契约**（渲染与调用方共用的唯一事实：类名／槽位／形态闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-01-纸面与页头.mjs`，2026-09 用户裁定）
+ *  里的**形态 C「可折叠小节（原生 `details`，零脚本）」**——一段内容的开头一行：
+ *  序号 ＋ 小节标题 ＋ 计数 ＋ 展开指示，正文原生开合。
+ *
+ *  形态键写在 `SECTION_HEAD_FORMS`（闭集）：本件只有一格，但键必须存在——
+ *  「形态是骨架，不是地址」，日后加第二形态是在闭集里加一格，不是新开一件。
+ *  闭集外的值一律 `badInput`（不静默降级：降级会让调用方以为自己拿到了另一种骨架）。
+ */
+/** 本件的类名根：全部槽位类名都是 `SECTION_HEAD_CLASS + '-' + 槽名`。 */
+export const SECTION_HEAD_CLASS = 'ilife-block-section-head';
+/** 槽位闭集（标记契约的一部分：`render.ts` 与判据都用这里的名字拼类名，不各抄一份字面量）。
+ *  **纯状态的类也算槽位**（`form-*`／`value-num` 这类）：一切挂在元素上的类名都从这一份拼出来，
+ *  这样"只碰自己的类名"这条纪律才能被机器断（自造的 `is-*` 短类名会混进公共命名空间）。 */
+export const SECTION_HEAD_SLOTS = [
+    /** 标题行（`<summary>`）：序号 ＋ 标题 ＋ 计数 ＋ 展开指示并成的那一排。 */
+    'sum',
+    /** 序号（`1`／`2`…）：多小节文档里的一、二、三。不给＝不出这一槽。 */
+    'ordinal',
+    /** 小节标题（`<h4>`，一节一个）。 */
+    'title',
+    /** 计数（`6 步`／`11 味`）：**恒不换行**，窄档只换行、不掉字。 */
+    'count',
+    /** 展开指示：文本随 `details[open]` 换（**不靠脚本**），箭头随开合旋转。 */
+    'more',
+    /** 正文容器（受信透传的 `body` 落这里；本件不再给它加壳）。 */
+    'body',
+    /** 形态类（形态 C「可折叠小节」）：`<prefix>block-section-head-form-fd`。 */
+    'form-fd',
+];
+/** 槽类的类名（唯一拼法：别处不许再写 `SECTION_HEAD_CLASS + '-' + …`）。 */
+export function sectionHeadSlot(slot, prefix = 'ilife-') {
+    return prefix + 'block-section-head-' + slot;
+}
+/** 形态闭集：本件只落地了形态 C「可折叠小节（原生 `details`，零脚本）」。 */
+export const SECTION_HEAD_FORMS = ['fd'];
+/** 序号的取值范围（`1`–`999`）：整数、正数；出界即 `badInput`。 */
+export const SECTION_HEAD_SEQ_MIN = 1;
+export const SECTION_HEAD_SEQ_MAX = 999;
+/** 展开／收起两枚字**写在样式里**（`::before` 按 `[open]` 换）：标记里只有一枚空 `<span class="…-more">`。
+ *  这两枚串是**呈现事实**、不是入参，故住这里一处，判据按它对账。 */
+export const SECTION_HEAD_MORE_TEXTS = Object.freeze({ folded: '展开', open: '收起' });
+/** 展开指示的箭头字形（转义前的码位；样式里拼成 CSS 的 `content`）。 */
+export const SECTION_HEAD_CARET_CODE = '\\203A';

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

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.js","sourceRoot":"","sources":["../../../src/components/section-head/attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,uDAAuD;AACvD,MAAM,CAAC,MAAM,kBAAkB,GAAG,0BAA0B,CAAC;AAE7D;;sDAEsD;AACtD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,kDAAkD;IAClD,KAAK;IACL,0CAA0C;IAC1C,SAAS;IACT,yBAAyB;IACzB,OAAO;IACP,2CAA2C;IAC3C,OAAO;IACP,oDAAoD;IACpD,MAAM;IACN,uCAAuC;IACvC,MAAM;IACN,6DAA6D;IAC7D,SAAS;CACD,CAAC;AAGX,yDAAyD;AACzD,MAAM,UAAU,eAAe,CAAC,IAAqB,EAAE,MAAM,GAAG,QAAQ;IACtE,OAAO,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAAC;AAC/C,CAAC;AAED,gDAAgD;AAChD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAI,CAAU,CAAC;AAGlD,+CAA+C;AAC/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AACtC,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAExC;wCACwC;AACxC,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AAEnF,+CAA+C;AAC/C,MAAM,CAAC,MAAM,uBAAuB,GAAG,QAAQ,CAAC"}

package/dist/components/section-head/index.d.ts

@@ -0,0 +1,14 @@
+/** section-head · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  三个运行名：`renderSectionHead(input)`（产标记，零 DOM）／`sectionHeadCss()`（样式段）／
+ *  形态闭集 `SECTION_HEAD_FORMS`（本件只落地形态 C「可折叠小节」）＋类名根 `SECTION_HEAD_CLASS`
+ *  ＋命中盒读数 `SECTION_HEAD_SUM_MIN_PX`（标题行 ≥44px）。加四个类型名（入参面）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ */
+export { SECTION_HEAD_CLASS, SECTION_HEAD_FORMS, SECTION_HEAD_MORE_TEXTS, SECTION_HEAD_SEQ_MAX, SECTION_HEAD_SEQ_MIN, sectionHeadSlot, } from './attrs.js';
+export type { SectionHeadForm, SectionHeadInput, SectionHeadSlot } from './attrs.js';
+export { normalizeSectionHead } from './model.js';
+export { renderSectionHead, sectionHeadOrdinalText } from './render.js';
+export { SECTION_HEAD_SUM_MIN_PX, sectionHeadCss } from './style.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/section-head/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/section-head/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,12 @@
+/** section-head · **组件出口**（本组件对外的唯一名字面）。
+ *
+ *  三个运行名：`renderSectionHead(input)`（产标记，零 DOM）／`sectionHeadCss()`（样式段）／
+ *  形态闭集 `SECTION_HEAD_FORMS`（本件只落地形态 C「可折叠小节」）＋类名根 `SECTION_HEAD_CLASS`
+ *  ＋命中盒读数 `SECTION_HEAD_SUM_MIN_PX`（标题行 ≥44px）。加四个类型名（入参面）。
+ *
+ *  用法与参数表见同目录 `README.md`。消费方走 `base-paint/blocks`（组件层出口），不走根出口。
+ */
+export { SECTION_HEAD_CLASS, SECTION_HEAD_FORMS, SECTION_HEAD_MORE_TEXTS, SECTION_HEAD_SEQ_MAX, SECTION_HEAD_SEQ_MIN, sectionHeadSlot, } from './attrs.js';
+export { normalizeSectionHead } from './model.js';
+export { renderSectionHead, sectionHeadOrdinalText } from './render.js';
+export { SECTION_HEAD_SUM_MIN_PX, sectionHeadCss } from './style.js';

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/section-head/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/section-head/model.d.ts

@@ -0,0 +1,16 @@
+import { type SectionHeadForm } from './attrs.js';
+/** 内部类型：每个字段都已校验、已归一（`undefined` 一律换成「不给」）。
+ *  `readonly` 的**可选**字段与 `exactOptionalPropertyTypes` 无关：本仓不开该档，`undefined` 即「不给」。 */
+export interface SectionHeadModel {
+    readonly form: SectionHeadForm;
+    readonly title: string;
+    readonly body: string;
+    readonly seq?: number;
+    readonly count?: string;
+    readonly open: boolean;
+    readonly id?: string;
+    readonly extraClass?: string;
+}
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `SectionHeadModel`，不再自己碰 `any`。 */
+export declare function normalizeSectionHead(input: unknown): SectionHeadModel;
+//# sourceMappingURL=model.d.ts.map

package/dist/components/section-head/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/components/section-head/model.ts"],"names":[],"mappings":"AAUA,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,YAAY,CAAC;AAEpB;sFACsF;AACtF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAwBD,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CA4BrE"}

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

@@ -0,0 +1,61 @@
+/** section-head · **入参归一化与校验**（把 `any` 与说不出的 `unknown` 挡在门外，产出内部类型）。
+ *
+ *  三条口径（与 `page-head` 同一份）：
+ *   1. **非法入参一律 `badInput()`**（抛 `BlocksError`）——不静默降级、不「尽量猜」；
+ *   2. 必填缺、类型错、闭集外、越界各点各的名（报错文案里带字段路径，调用方一眼定位）；
+ *   3. 归一化只做「形状」：序号的十进写法、计数的文案**归调用方**——本件只收「已经是给人看的样子」的串。
+ *
+ *  唯一「受信透传」的字段是 `body`：它接已渲染好的区块标记，不转义（与 `sheet-frame.content` 同口径）。
+ */
+import { assertPlainObject, badInput, optExtraClass, optText, reqText } from '../shared/validate.js';
+import { SECTION_HEAD_FORMS, SECTION_HEAD_SEQ_MAX, SECTION_HEAD_SEQ_MIN, } from './attrs.js';
+/** id 的合法形状：可作页内锚点、可进 `querySelector`（不以数字打头、无空白与引号）。 */
+const ID_RE = /^[A-Za-z_][A-Za-z0-9_-]*$/;
+/** 序号：整数且在闭区间内；`undefined` 透传（＝不出这一槽）。 */
+function optOrdinal(value, field) {
+    if (value === undefined)
+        return undefined;
+    const range = SECTION_HEAD_SEQ_MIN + '–' + SECTION_HEAD_SEQ_MAX;
+    if (typeof value !== 'number' || !Number.isInteger(value))
+        badInput(field + ' 必须是 ' + range + ' 的整数');
+    if (value < SECTION_HEAD_SEQ_MIN || value > SECTION_HEAD_SEQ_MAX) {
+        badInput(field + ' 必须在 ' + range + ' 之间，收到 ' + String(value));
+    }
+    return value;
+}
+/** 锚点 id：可省；给了就得是合法锚点。 */
+function optId(value, field) {
+    const text = optText(value, field);
+    if (text === undefined)
+        return undefined;
+    if (!ID_RE.test(text))
+        badInput(field + ' 只许字母／数字／连字符，且不以数字打头：' + text);
+    return text;
+}
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `SectionHeadModel`，不再自己碰 `any`。 */
+export function normalizeSectionHead(input) {
+    assertPlainObject(input, 'renderSectionHead: input');
+    const raw = input;
+    const form = raw.form === undefined ? SECTION_HEAD_FORMS[0] : raw.form;
+    if (!SECTION_HEAD_FORMS.includes(form)) {
+        badInput('section-head: input.form 必须是 ' + SECTION_HEAD_FORMS.join('／')
+            + ' 之一（本件只落地形态 C「可折叠小节」）');
+    }
+    const body = raw.body;
+    if (typeof body !== 'string') {
+        badInput('section-head: input.body 必须是字符串（受信标记，不转义；空小节给空串）');
+    }
+    const open = raw.open;
+    if (open !== undefined && typeof open !== 'boolean')
+        badInput('section-head: input.open 必须是布尔值');
+    return {
+        form: form,
+        title: reqText(raw.title, 'section-head: input.title'),
+        body,
+        seq: optOrdinal(raw.seq, 'section-head: input.seq'),
+        count: optText(raw.count, 'section-head: input.count'),
+        open: open === true,
+        id: optId(raw.id, 'section-head: input.id'),
+        extraClass: optExtraClass(raw.extraClass, 'section-head: input.extraClass'),
+    };
+}

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

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../src/components/section-head/model.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrG,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,GAErB,MAAM,YAAY,CAAC;AAepB,yDAAyD;AACzD,MAAM,KAAK,GAAG,2BAA2B,CAAC;AAE1C,0CAA0C;AAC1C,SAAS,UAAU,CAAC,KAAc,EAAE,KAAa;IAC/C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,KAAK,GAAG,oBAAoB,GAAG,GAAG,GAAG,oBAAoB,CAAC;IAChE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;QAAE,QAAQ,CAAC,KAAK,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC,CAAC;IACtG,IAAI,KAAK,GAAG,oBAAoB,IAAI,KAAK,GAAG,oBAAoB,EAAE,CAAC;QACjE,QAAQ,CAAC,KAAK,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,0BAA0B;AAC1B,SAAS,KAAK,CAAC,KAAc,EAAE,KAAa;IAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACnC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,QAAQ,CAAC,KAAK,GAAG,uBAAuB,GAAG,IAAI,CAAC,CAAC;IACxE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,iBAAiB,CAAC,KAAK,EAAE,0BAA0B,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAE7C,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IACvE,IAAI,CAAE,kBAAyC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/D,QAAQ,CAAC,+BAA+B,GAAG,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC;cACnE,uBAAuB,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,IAAI,GAAY,GAAG,CAAC,IAAI,CAAC;IAC/B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,QAAQ,CAAC,kDAAkD,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,IAAI,GAAY,GAAG,CAAC,IAAI,CAAC;IAC/B,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,KAAK,SAAS;QAAE,QAAQ,CAAC,iCAAiC,CAAC,CAAC;IAEjG,OAAO;QACL,IAAI,EAAE,IAAuB;QAC7B,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,2BAA2B,CAAC;QACtD,IAAI;QACJ,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,yBAAyB,CAAC;QACnD,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,2BAA2B,CAAC;QACtD,IAAI,EAAE,IAAI,KAAK,IAAI;QACnB,EAAE,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,wBAAwB,CAAC;QAC3C,UAAU,EAAE,aAAa,CAAC,GAAG,CAAC,UAAU,EAAE,gCAAgC,CAAC;KAC5E,CAAC;AACJ,CAAC"}

package/dist/components/section-head/render.d.ts

@@ -0,0 +1,6 @@
+import { type SectionHeadInput } from './attrs.js';
+/** 序号的上屏字：十进、不补零（补零只在等宽对齐的账目里有意义）。 */
+export declare function sectionHeadOrdinalText(seq: number): string;
+/** 可折叠小节头：一节的标题行 ＋ 可折叠正文。纯函数产标记，零 DOM、零脚本。 */
+export declare function renderSectionHead(input: SectionHeadInput): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/components/section-head/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/components/section-head/render.ts"],"names":[],"mappings":"AAiBA,OAAO,EAIL,KAAK,gBAAgB,EAEtB,MAAM,YAAY,CAAC;AAGpB,sCAAsC;AACtC,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1D;AA4CD,8CAA8C;AAC9C,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAIjE"}

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

@@ -0,0 +1,68 @@
+/** section-head · **渲染**（纯函数产 HTML；本件只有形态 C「可折叠小节」一种骨架）。
+ *
+ *  —— 形态 C：可折叠小节（原生 `details`，零脚本）——
+ *
+ *  骨架：根 `<details class="… is-fd">` → 标题行 `<summary class="…-sum">`（序号／标题／计数／展开指示）
+ *  → 正文 `<div class="…-body">`。
+ *
+ *  它替掉的两种错法：
+ *   · 标题长了就拿 `…` 截断 —— 标题与计数抢同一行，读者看到的是「红烧肉的做法（含腌…」；
+ *   · 计数跟着标题一起被压没 —— 计数是「这一节有多少条」的唯一落点，掉了就没人知道有 11 味还是 1 味。
+ *
+ *  两条硬口径（判据断的就是它们）：
+ *   · **零脚本**：开合走 `<details>` 原生行为，标记里没有一行 JS、没有内联事件处理器；
+ *     「展开／收起」两枚字由样式的 `::before` 按 `[open]` 换 —— 换字不跳版（`::after` 只旋转箭头）。
+ *   · **标记里不写分隔符**：序号／标题／计数／指示之间的缝由样式的列距承担。
+ */
+import { esc } from '../shared/escape.js';
+import { SECTION_HEAD_CLASS, sectionHeadSlot, } from './attrs.js';
+import { normalizeSectionHead } from './model.js';
+/** 序号的上屏字：十进、不补零（补零只在等宽对齐的账目里有意义）。 */
+export function sectionHeadOrdinalText(seq) {
+    return String(seq);
+}
+/** 形态键 → 形态类名（**闭集里那一格**；`Record<SectionHeadForm, …>` 让"加了形态却忘了补类名"当场红）。 */
+const FORM_SLOTS = Object.freeze({
+    fd: 'form-fd',
+});
+/** 根上的属性：形态类总是出，`id`／`open` 给了才出。 */
+function rootAttrs(m) {
+    let out = ' class="' + SECTION_HEAD_CLASS + ' ' + sectionHeadSlot(FORM_SLOTS[m.form])
+        + (m.extraClass === undefined ? '' : ' ' + m.extraClass) + '"';
+    if (m.id !== undefined)
+        out += ' id="' + esc(m.id) + '"';
+    if (m.open)
+        out += ' open';
+    return out;
+}
+/** 标题行：序号（可省）／标题／计数（可省）／展开指示（恒出）。 */
+function summaryHtml(m) {
+    const parts = ['<summary class="' + sectionHeadSlot('sum') + '">'];
+    if (m.seq !== undefined) {
+        /* 序号是**呈现位**：读屏从标题就知道这是什么，序号读出来只是噪音（`aria-hidden`）。 */
+        parts.push('<span class="' + sectionHeadSlot('ordinal') + '" aria-hidden="true">'
+            + esc(sectionHeadOrdinalText(m.seq)) + '</span>');
+    }
+    parts.push('<h4 class="' + sectionHeadSlot('title') + '">' + esc(m.title) + '</h4>');
+    if (m.count !== undefined) {
+        parts.push('<span class="' + sectionHeadSlot('count') + '">' + esc(m.count) + '</span>');
+    }
+    /* 展开指示是**空元素**：两枚字与箭头都由样式出（这样"展开／收起"的换字不用一行脚本）。 */
+    parts.push('<span class="' + sectionHeadSlot('more') + '"></span>');
+    parts.push('</summary>');
+    return parts.join('');
+}
+/** 形态 C 的骨架。正文受信透传：`body` 是调用方已渲染好的标记，本件只把它放进正文槽、不再加壳。 */
+function renderFolded(m) {
+    return '<details' + rootAttrs(m) + '>' + summaryHtml(m)
+        + '<div class="' + sectionHeadSlot('body') + '">' + m.body + '</div></details>';
+}
+const RENDERERS = Object.freeze({
+    fd: renderFolded,
+});
+/** 可折叠小节头：一节的标题行 ＋ 可折叠正文。纯函数产标记，零 DOM、零脚本。 */
+export function renderSectionHead(input) {
+    const m = normalizeSectionHead(input);
+    const render = RENDERERS[m.form];
+    return render(m);
+}

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

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

package/dist/components/section-head/style.d.ts

@@ -0,0 +1,7 @@
+/** 标题行的命中盒高度下限（px）：触控目标 ≥44×44 是全宽口径（视觉上是"一行标题"，可点的是整行）。 */
+export declare const SECTION_HEAD_SUM_MIN_PX = 44;
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export declare function sectionHeadCss(input?: {
+    readonly prefix?: string;
+}): string;
+//# sourceMappingURL=style.d.ts.map

package/dist/components/section-head/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../../src/components/section-head/style.ts"],"names":[],"mappings":"AAwBA,4DAA4D;AAC5D,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAM1C,4BAA4B;AAC5B,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAsJ3E"}