base-paint 0.3.14 → 0.3.16

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

@@ -0,0 +1,13 @@
+/** 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';
+//# sourceMappingURL=index.js.map

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,62 @@
+/** 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'),
+    };
+}
+//# sourceMappingURL=model.js.map

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,69 @@
+/** 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);
+}
+//# sourceMappingURL=render.js.map

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"}

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

@@ -0,0 +1,173 @@
+/** 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);
+}
+//# sourceMappingURL=style.js.map

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,12 @@
+/** 组件层共用：五字符转义（唯一口径 = 冻结的 `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);
+}
+//# sourceMappingURL=escape.js.map

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,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 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';
+//# sourceMappingURL=typography.js.map

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,76 @@
+/** 组件层共用：入参校验小件（口径与 `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)` 这种写法先填满再传）');
+        }
+    }
+}
+//# sourceMappingURL=validate.js.map

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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"}