base-paint 0.3.14 → 0.3.16

package/dist/components/note-block/model.js

@@ -0,0 +1,71 @@
+/** note-block · **入参归一化与校验**（把 `any` 与说不出的 `unknown` 挡在门外，产出内部类型）。
+ *
+ *  三条口径：
+ *   1. **非法入参一律 `badInput()`**（抛 `BlocksError`）——不静默降级；
+ *   2. **语气说不出「是什么」就是错的**（`tone` 非 `quiet` 而没给 `toneLabel` ⇒ 拒）：色不是唯一信息，
+ *      换到把警告色压成墨黑的皮肤上，读者得靠那两个字知道这条备注带着什么；
+ *   3. **算得出来的都不许调用方再给**：字数、摘要那一句、收不收起，都是本件算的。
+ */
+import { assertPlainObject, badInput, optExtraClass, optText, reqText } from '../shared/validate.js';
+import { NOTE_BLOCK_COLLAPSE_CHARS, NOTE_BLOCK_ELLIPSIS, NOTE_BLOCK_FORMS, NOTE_BLOCK_PEEK_CHARS, NOTE_BLOCK_TONES, } from './attrs.js';
+/** 正文 → 逐段（按换行拆；把每段两头的空白去掉；空段丢掉）。 */
+function splitLines(text) {
+    const out = [];
+    for (const raw of text.split(String.fromCharCode(10))) {
+        const line = raw.trim();
+        if (line !== '')
+            out.push(line);
+    }
+    return out;
+}
+/** 首行截一句摘要（**只截摘要**；正文一个字都不许截）。 */
+function peekOf(lines) {
+    const first = lines[0] ?? '';
+    return first.length <= NOTE_BLOCK_PEEK_CHARS
+        ? first
+        : first.slice(0, NOTE_BLOCK_PEEK_CHARS) + NOTE_BLOCK_ELLIPSIS;
+}
+/** 入参归一化。**唯一入口**：`render.ts` 只吃它产出的 `NoteBlockModel`。 */
+export function normalizeNoteBlock(input) {
+    assertPlainObject(input, 'renderNoteBlock: input');
+    const raw = input;
+    const form = raw.form === undefined ? NOTE_BLOCK_FORMS[0] : raw.form;
+    if (!NOTE_BLOCK_FORMS.includes(form)) {
+        badInput('note-block: input.form 必须是 ' + NOTE_BLOCK_FORMS.join('／')
+            + ' 之一（本件只落地形态 A「竖线备注」；引语形态已砍）');
+    }
+    const lines = splitLines(reqText(raw.text, 'note-block: input.text'));
+    if (lines.length === 0)
+        badInput('note-block: input.text 去掉空白后不许是空');
+    const toneGiven = raw.tone;
+    if (toneGiven !== undefined && !NOTE_BLOCK_TONES.includes(toneGiven)) {
+        badInput('note-block: input.tone 必须是 ' + NOTE_BLOCK_TONES.join('／') + ' 之一');
+    }
+    const tone = (toneGiven ?? 'quiet');
+    const toneLabel = optText(raw.toneLabel, 'note-block: input.toneLabel');
+    if (tone !== 'quiet' && toneLabel === undefined) {
+        badInput('note-block: tone 是 ' + tone + ' ⇒ toneLabel 必填（色不是唯一信息：这两个字说清这个语气是什么）');
+    }
+    const length = lines.join('').length;
+    const collapseGiven = raw.collapse;
+    if (collapseGiven !== undefined && typeof collapseGiven !== 'boolean') {
+        badInput('note-block: input.collapse 必须是 true／false');
+    }
+    const collapsed = collapseGiven === undefined
+        ? length > NOTE_BLOCK_COLLAPSE_CHARS
+        : collapseGiven;
+    return {
+        form: form,
+        lines,
+        length,
+        tone,
+        toneLabel,
+        owner: optText(raw.owner, 'note-block: input.owner'),
+        time: optText(raw.time, 'note-block: input.time'),
+        peek: optText(raw.summary, 'note-block: input.summary') ?? peekOf(lines),
+        collapsed,
+        attachedTo: optText(raw.attachedTo, 'note-block: input.attachedTo'),
+        extraClass: optExtraClass(raw.extraClass, 'note-block: input.extraClass'),
+    };
+}
+//# sourceMappingURL=model.js.map

package/dist/components/note-block/model.js.map

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

package/dist/components/note-block/render.d.ts

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

package/dist/components/note-block/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/components/note-block/render.ts"],"names":[],"mappings":"AA2FA,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAItD"}

package/dist/components/note-block/render.js

@@ -0,0 +1,89 @@
+/** note-block · **渲染**（纯函数产 HTML；本件只有形态 A「竖线备注」一种骨架）。
+ *
+ *  —— 形态 A：竖线备注 ——
+ *
+ *  层次靠三样**零阴影下也成立**的东西：**竖线**（左缘那道）／**缩进**（正文相对归属缩进）／**底色块**（正文自己的软底）。
+ *  **砍掉的**：引语形态（一根短横线 ＋ 一句斜体话）——三套皮肤全 2 分，那个骨架不成立。
+ *
+ *  长备注**默认收起**：走原生 `<details>` ＋ `<summary>`（一行里给归属、时间、字数与一句摘要），
+ *  展开是同一段正文 —— 收起时不丢信息（摘要是首行截出来的那句话），也不用脚本。
+ *
+ *  三条硬口径（判据断的就是它们）：
+ *   · **正文一个字都不截**（只有摘要那一行会带省略号）；
+ *   · **语气非无时必有语气字**（校验在 `model.ts` 拦住，"色不是唯一信息"落在这里）；
+ *   · **收起的判断是本件算的**（正文字数 > 阈值，或调用方显式指定）。
+ */
+import { esc } from '../shared/escape.js';
+import { NOTE_BLOCK_ATT_PREFIX, NOTE_BLOCK_CLASS, NOTE_BLOCK_LEN_SUFFIX, noteBlockSlot, } from './attrs.js';
+import { normalizeNoteBlock } from './model.js';
+/** 正文：逐段一枚 `<p>`（段间距离由样式承担；标记里不写空行、不写 `<br>`）。 */
+function bodyHtml(m) {
+    const parts = ['<div class="' + noteBlockSlot('body') + '">'];
+    for (const line of m.lines) {
+        parts.push('<p class="' + noteBlockSlot('line') + '">' + esc(line) + '</p>');
+    }
+    if (m.attachedTo !== undefined || m.time !== undefined) {
+        const att = [];
+        if (m.attachedTo !== undefined) {
+            att.push('<span>' + esc(NOTE_BLOCK_ATT_PREFIX + ' ' + m.attachedTo) + '</span>');
+        }
+        if (m.time !== undefined)
+            att.push('<span class="' + noteBlockSlot('time') + '">' + esc(m.time) + '</span>');
+        parts.push('<p class="' + noteBlockSlot('att') + '">' + att.join('') + '</p>');
+    }
+    parts.push('</div>');
+    return parts.join('');
+}
+/** 头上那一排的公共位：归属 ＋ 语气字。 */
+function headBits(m) {
+    const parts = [];
+    if (m.owner !== undefined) {
+        parts.push('<b class="' + noteBlockSlot('owner') + '">' + esc(m.owner) + '</b>');
+    }
+    if (m.toneLabel !== undefined) {
+        parts.push('<span class="' + noteBlockSlot('tone') + '">' + esc(m.toneLabel) + '</span>');
+    }
+    return parts;
+}
+/** 形态 A 的骨架：短的直接出；长的套 `<details>`（收起时那一排就是 `<summary>`）。 */
+function renderNote(m, extra) {
+    const cls = NOTE_BLOCK_CLASS + ' is-' + m.form + ' is-' + m.tone + extra;
+    if (!m.collapsed) {
+        const head = headBits(m);
+        const parts = ['<div class="' + cls + '">'];
+        if (head.length > 0 || m.time !== undefined) {
+            parts.push('<p class="' + noteBlockSlot('head') + '">' + head.join('')
+                + (m.time === undefined ? '' : '<span class="' + noteBlockSlot('time') + '">' + esc(m.time) + '</span>')
+                + '</p>');
+        }
+        parts.push(bodyHtml(m));
+        parts.push('</div>');
+        return parts.join('');
+    }
+    const parts = ['<details class="' + cls + ' is-collapsed">'];
+    parts.push('<summary class="' + noteBlockSlot('head') + '">');
+    parts.push('<i class="' + noteBlockSlot('caret') + '" aria-hidden="true"></i>');
+    parts.push(headBits(m).join(''));
+    if (m.time !== undefined) {
+        parts.push('<span class="' + noteBlockSlot('time') + '">' + esc(m.time) + '</span>');
+    }
+    parts.push('<span class="' + noteBlockSlot('len') + '">' + esc(String(m.length) + NOTE_BLOCK_LEN_SUFFIX) + '</span>');
+    if (m.peek !== undefined) {
+        parts.push('<span class="' + noteBlockSlot('peek') + '">' + esc(m.peek) + '</span>');
+    }
+    parts.push('</summary>');
+    parts.push(bodyHtml(m));
+    parts.push('</details>');
+    return parts.join('');
+}
+/** 形态 → 骨架（本件只有一格；引语形态已砍，分派写在这里，加第二形态就是加一支）。 */
+const SKELETONS = {
+    note: renderNote,
+};
+/** 渲染备注块（纯函数：同样的入参恒产同样的字节；转义只经 `shared/escape.ts`）。 */
+export function renderNoteBlock(input) {
+    const m = normalizeNoteBlock(input);
+    const extra = m.extraClass === undefined ? '' : ' ' + m.extraClass;
+    return SKELETONS[m.form](m, extra);
+}
+//# sourceMappingURL=render.js.map

package/dist/components/note-block/render.js.map

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

package/dist/components/note-block/style.d.ts

@@ -0,0 +1,11 @@
+/** 竖线宽度（px）：语气档把它加粗——**这是「色之外的第二样」在形状上的落点**。 */
+export declare const NOTE_BLOCK_RULE_PX = 3;
+/** 正文相对归属的缩进（px）。 */
+export declare const NOTE_BLOCK_INDENT_PX = 12;
+/** 收起时那一排的命中下限（px）：`<summary>` 是触控目标，不得小过它。 */
+export declare const NOTE_BLOCK_TOUCH_PX = 44;
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export declare function noteBlockCss(input?: {
+    readonly prefix?: string;
+}): string;
+//# sourceMappingURL=style.d.ts.map

package/dist/components/note-block/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../../src/components/note-block/style.ts"],"names":[],"mappings":"AAsBA,gDAAgD;AAChD,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,qBAAqB;AACrB,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,+CAA+C;AAC/C,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,4BAA4B;AAC5B,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CA2JzE"}

package/dist/components/note-block/style.js

@@ -0,0 +1,183 @@
+/** note-block · **样式段**（本件唯一的样式来源）。**重做件**：层次不许靠投影与圆角。
+ *
+ *  四条重做口径（`重做设计口径.md` §0）逐条落在这一段里：
+ *   ① 该件没有"占位物"；
+ *   ② **状态除色之外还有第二样**：语气档有**语气字**（由标记带出）＋ 竖线**粗细／虚实**（非语气档是细实线，
+ *      warn／danger 是粗实线＋底色块）——换到把警告色压成墨黑的皮肤，读者仍分得开；
+ *   ③ **零阴影下层次仍在**：竖线（左缘）＋ 缩进（正文相对归属）＋ 底色块（正文自己的软底）三样都不用投影；
+ *   ④ **骨架对得上这类数据**：一段「当时为什么这么记」的话——竖线块就是这类数据的形状（引语形态已砍）。
+ *
+ *  交互（`<details>` 展开／收起是原生行为，无需运行时）：rest／`:hover`（包在设备能力查询里）／
+ *  `:active`／`:focus-visible` 四档逐条给出；`disabled`／`loading`／`error` **原生 `<details>` 没有这三态**
+ *  （它不提交、不加载、也不出错）——不硬造。
+ *
+ *  纪律：只经 `skinVar()` 读皮肤；scope 在 `.<prefix>page-ui` 之下；零 `:root`／`!important`；
+ *  宽度只许容器判（`@container`），媒体查询只判设备能力。
+ */
+import { skinVar } from '../skin/contract.js';
+import { noteBlockSlot } from './attrs.js';
+/** 换行（仓库口径：不写字面换行转义）。 */
+const LF = String.fromCharCode(10);
+/** 竖线宽度（px）：语气档把它加粗——**这是「色之外的第二样」在形状上的落点**。 */
+export const NOTE_BLOCK_RULE_PX = 3;
+/** 正文相对归属的缩进（px）。 */
+export const NOTE_BLOCK_INDENT_PX = 12;
+/** 收起时那一排的命中下限（px）：`<summary>` 是触控目标，不得小过它。 */
+export const NOTE_BLOCK_TOUCH_PX = 44;
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export function noteBlockCss(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-note-block';
+    const slotSel = (s) => '.' + noteBlockSlot(s, p);
+    const s = (slot) => root + ' ' + slotSel(slot);
+    return [
+        '/* note-block（备注块 · 形态 A「竖线备注」）：层次＝竖线 ＋ 缩进 ＋ 底色块。',
+        '   **重做件**：引语形态（一根短横线 ＋ 一句斜体话）三套皮肤全 2 分，已砍；',
+        '   留下的这三样在**零阴影、零圆角**下都成立——层次不靠"浮起来"。 */',
+        box + ' {',
+        '  container-type: inline-size;',
+        '  display: grid;',
+        '  gap: 6px;',
+        '  min-width: 0;',
+        '  box-sizing: border-box;',
+        '  padding: 2px 0 2px ' + String(NOTE_BLOCK_INDENT_PX) + 'px;',
+        '  border-left: 1px solid ' + skinVar('line') + ';',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font') + ';',
+        '  font-size: ' + skinVar('fs-sm') + ';',
+        '  line-height: 1.7;',
+        '}',
+        '/* 语气：竖线加粗 ＋ 底色块换档（**色之外还有"粗"这一样**）。 */',
+        box + '.is-warn {',
+        '  border-left-width: ' + String(NOTE_BLOCK_RULE_PX) + 'px;',
+        '  border-left-color: ' + skinVar('warn') + ';',
+        '}',
+        box + '.is-danger {',
+        '  border-left-width: ' + String(NOTE_BLOCK_RULE_PX) + 'px;',
+        '  border-left-color: ' + skinVar('danger') + ';',
+        '}',
+        box + '.is-warn ' + slotSel('body') + ' { background: ' + skinVar('warn-soft') + '; }',
+        box + '.is-danger ' + slotSel('body') + ' { background: ' + skinVar('danger-soft') + '; }',
+        box + '.is-warn ' + slotSel('tone') + ' { color: ' + skinVar('warn') + '; border-color: ' + skinVar('warn') + '; }',
+        box + '.is-danger ' + slotSel('tone') + ' { color: ' + skinVar('danger') + '; border-color: ' + skinVar('danger') + '; }',
+        '/* 头上那一排（归属／时间／语气字／字数／摘要）：逐段一枚 span、段间只靠列距。 */',
+        s('head') + ' {',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  align-items: baseline;',
+        '  gap: 2px 10px;',
+        '  margin: 0;',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  line-height: 1.6;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        s('owner') + ' {',
+        '  flex: none;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-weight: 700;',
+        '}',
+        s('time') + ' {',
+        '  color: ' + skinVar('ink-3') + ';',
+        '  font-family: ' + skinVar('font-num') + ';',
+        '  font-variant-numeric: tabular-nums;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* 语气字：带一圈发丝线的小牌（**零阴影下的边界**），色只是第三样。 */',
+        s('tone') + ' {',
+        '  flex: none;',
+        '  padding: 0 6px;',
+        '  border: 1px solid ' + skinVar('line') + ';',
+        '  border-radius: ' + skinVar('radius-sm') + ';',
+        '  background: ' + skinVar('surface') + ';',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-weight: 700;',
+        '}',
+        s('len') + ' {',
+        '  flex: none;',
+        '  color: ' + skinVar('ink-3') + ';',
+        '  font-family: ' + skinVar('font-num') + ';',
+        '  font-variant-numeric: tabular-nums;',
+        '}',
+        '/* 摘要那一行：**只有它带省略号**（正文一个字都不截）。 */',
+        s('peek') + ' {',
+        '  flex: 1 1 100%;',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  line-height: 1.6;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* 正文块：缩进 ＋ 软底（第三样层次手段）。 */',
+        s('body') + ' {',
+        '  display: grid;',
+        '  gap: 6px;',
+        '  min-width: 0;',
+        '  padding: 10px 12px;',
+        '  box-sizing: border-box;',
+        '  border-radius: ' + skinVar('radius-sm') + ';',
+        '  background: ' + skinVar('surface-2') + ';',
+        '  color: ' + skinVar('ink-2') + ';',
+        '}',
+        s('line') + ' {',
+        '  margin: 0;',
+        '  min-width: 0;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* 归属行：正文末尾那一行（前导号由样式画，标记里不写分隔符）。 */',
+        s('att') + ' {',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  align-items: baseline;',
+        '  gap: 2px 8px;',
+        '  margin: 0;',
+        '  padding-top: 6px;',
+        '  min-width: 0;',
+        '  border-top: 1px solid ' + skinVar('line') + ';',
+        '  color: ' + skinVar('ink-3') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* 收起那一排是触控目标：命中小不了 ' + String(NOTE_BLOCK_TOUCH_PX) + 'px；',
+        '   展开三角的旋转只动 transform，减动效档下直接不转。 */',
+        box + ' > ' + slotSel('head') + ' {',
+        '  min-height: ' + String(NOTE_BLOCK_TOUCH_PX) + 'px;',
+        '  box-sizing: border-box;',
+        '  padding: 8px 0;',
+        '  cursor: pointer;',
+        '  list-style: none;',
+        '}',
+        box + ' > ' + slotSel('head') + '::-webkit-details-marker { display: none; }',
+        s('caret') + ' {',
+        '  flex: none;',
+        '  align-self: center;',
+        '  width: 0;',
+        '  height: 0;',
+        '  border-left: 6px solid ' + skinVar('ink-3') + ';',
+        '  border-top: 5px solid transparent;',
+        '  border-bottom: 5px solid transparent;',
+        '  transition: transform .18s ease;',
+        '}',
+        box + '[open] > ' + slotSel('head') + ' > ' + slotSel('caret') + ' { transform: rotate(90deg); }',
+        box + ' > ' + slotSel('head') + ':active { opacity: .9; }',
+        box + ' > ' + slotSel('head') + ':focus-visible {',
+        '  outline: 2px solid ' + skinVar('accent') + ';',
+        '  outline-offset: 2px;',
+        '}',
+        '/* hover 只判设备能力；它**不是唯一通路**——`<summary>` 本来就能点、能用键盘开（原生行为），',
+        '   rest 态也没有把"这里能展开"藏起来（三角 ＋ 摘要都在）。 */',
+        '@media (hover:hover) and (pointer:fine) {',
+        '  ' + box + ' > ' + slotSel('head') + ':hover { background: ' + skinVar('surface-2') + '; }',
+        '}',
+        '@media (prefers-reduced-motion:reduce) {',
+        '  ' + s('caret') + ' { transition: none; }',
+        '}',
+        '/* 窄容器：正文内距收一档（判的是本件自己的宽度，不是视口宽度）。 */',
+        '@container (max-width: 360px) {',
+        '  ' + s('body') + ' { padding: 8px 10px; }',
+        '}',
+    ].join(LF);
+}
+//# sourceMappingURL=style.js.map

package/dist/components/note-block/style.js.map

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

package/dist/components/number-stepper/attrs.d.ts

@@ -0,0 +1,113 @@
+/** number-stepper · **标记契约**（渲染与运行时共用的唯一事实：类名／槽位／`data-*`／事件／闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-08-表与输入.mjs`，2026-09 用户裁定）里的
+ *  **形态 A「标准：加减＋常用值排」**——「− n ＋」三个可点区并排，下面一排常用值省点击。
+ *  它替掉的两种错法：
+ *   · 只能敲键盘填数量（手指在手机上够不到"精确到 0.5"）；
+ *   · 加减按钮小到点不中（本形态把两边各 **≥44px** 的触区写进闭集，是硬口径不是建议）。
+ *
+ *  形态键写在 `NUMBER_STEPPER_FORMS`（闭集）：本件只有一格，但键必须存在——
+ *  「形态是骨架，不是地址」：日后加第二形态是在闭集里加一格，不是新开一件。
+ *  闭集外的值一律 `badInput`（不静默降级：降级会让调用方以为自己拿到了另一种骨架）。
+ */
+/** 本件的类名根：全部槽位类名都是 `numberStepperSlot(槽名)` 拼出来的。 */
+export declare const NUMBER_STEPPER_CLASS = "ilife-block-number-stepper";
+/** 形态闭集：本件只落地形态 A「标准：加减＋常用值排」。 */
+export declare const NUMBER_STEPPER_FORMS: readonly ["standard"];
+export type NumberStepperForm = (typeof NUMBER_STEPPER_FORMS)[number];
+/** 槽位闭集（标记契约的一部分：`render.ts` 与判据都用这里的名字拼类名，不各抄一份字面量）。 */
+export declare const NUMBER_STEPPER_SLOTS: readonly ["head", "label", "state", "controls", "dec", "value", "number", "unit", "inc", "editor", "quick", "quickLabel", "preset", "error", "caliber"];
+export type NumberStepperSlot = (typeof NUMBER_STEPPER_SLOTS)[number];
+/** 槽类的类名（唯一拼法：别处不许再写 `NUMBER_STEPPER_CLASS + '-' + …`）。 */
+export declare function numberStepperSlot(slot: NumberStepperSlot, prefix?: string): string;
+/** 机器键属性：值＝`NumberStepperInput.name`。**运行时的发现锚**（`[data-ilife-stepper]`）。 */
+export declare const NUMBER_STEPPER_NAME_ATTR = "data-ilife-stepper";
+/** 机器值（**数字串**：`1.5`／`3`，不带千分位、不带单位；显示字另算）。 */
+export declare const NUMBER_STEPPER_VALUE_ATTR = "data-ilife-stepper-value";
+/** 人类可读字段名（`aria-label` 与事件 `detail.label` 用它）。 */
+export declare const NUMBER_STEPPER_LABEL_ATTR = "data-ilife-stepper-label";
+/** 单位（小号，跟在值后；不参与机器值）。 */
+export declare const NUMBER_STEPPER_UNIT_ATTR = "data-ilife-stepper-unit";
+/** 下限／上限／步长（数字串；运行时的夹取与吸附都读它们）。 */
+export declare const NUMBER_STEPPER_MIN_ATTR = "data-ilife-stepper-min";
+export declare const NUMBER_STEPPER_MAX_ATTR = "data-ilife-stepper-max";
+export declare const NUMBER_STEPPER_STEP_ATTR = "data-ilife-stepper-step";
+/** 显示小数位（由 `step` 推出来：`step=0.5` ⇒ 1 位；`step=1` ⇒ 0 位）。 */
+export declare const NUMBER_STEPPER_DECIMALS_ATTR = "data-ilife-stepper-decimals";
+/** 禁用标记（三枚可点区一起落 `disabled` ＋ `aria-disabled`；**不留"看着能点、点了没反应"**）。 */
+export declare const NUMBER_STEPPER_DISABLED_ATTR = "data-ilife-stepper-disabled";
+/** 更新中标记（原地换字，值位宽度锁住不跳版）。 */
+export declare const NUMBER_STEPPER_LOADING_ATTR = "data-ilife-stepper-loading";
+/** 动作标记：这一枚按钮按下去要干什么。 */
+export declare const NUMBER_STEPPER_ACT_ATTR = "data-ilife-stepper-act";
+/** 一枚常用值带的目标值（数字串；点它＝直接落到那一档）。 */
+export declare const NUMBER_STEPPER_QUICK_ATTR = "data-ilife-stepper-quick";
+/** 命中区标记（运行时按它找可点控件；**每一枚都 ≥44×44**）。 */
+export declare const NUMBER_STEPPER_HIT_ATTR = "data-ilife-stepper-hit";
+/** 值位状态字（`已到下限`／`已到上限`／`未设置`／`更新中`；空串＝这一行不出）。 */
+export declare const NUMBER_STEPPER_STATE_ATTR = "data-ilife-stepper-state";
+/** 行内编辑器在场标记（运行时进出编辑用它做幂等；样式按它切显示）。 */
+export declare const NUMBER_STEPPER_EDITING_ATTR = "data-ilife-stepper-editing";
+/** 绑定完成标记（运行时幂等：重复注入不重复绑定）。 */
+export declare const NUMBER_STEPPER_BOUND_ATTR = "data-ilife-stepper-bound";
+/** 动作闭集（闭集外的值一律 `badInput`）。 */
+export declare const NUMBER_STEPPER_ACTIONS: readonly ["dec", "inc", "quick", "edit"];
+export type NumberStepperAction = (typeof NUMBER_STEPPER_ACTIONS)[number];
+/** 变更事件名（冒泡 `CustomEvent`，`detail = { name, label, value, prev, unit }`）。
+ *  页面用 `root.addEventListener(NUMBER_STEPPER_EVENT_CHANGE, …)` 接自己的重算逻辑——**不引入任何全局**。 */
+export declare const NUMBER_STEPPER_EVENT_CHANGE = "ilife:stepper-change";
+/** 触控目标（px）：三枚可点区与常用值一律不小于它（用户裁定：44 是全宽口径，不只窄屏）。 */
+export declare const NUMBER_STEPPER_TOUCH_PX = 44;
+/** 相邻触控目标的最小间距（px）：『− n ＋』三个可点区**不做连体**，留缝防误点。 */
+export declare const NUMBER_STEPPER_GAP_PX = 8;
+/** 值位的最小宽度（px）：数字位数变了也不让整排跳版（配合等宽数字使用）。 */
+export declare const NUMBER_STEPPER_VALUE_MIN_PX = 88;
+/** 缺值的写法：**缺值写成 `—`**（与「0」区分；全仓同一条地板）。 */
+export declare const NUMBER_STEPPER_MISSING = "\u2014";
+/** 状态字（字这一档的四个词：**状态不只靠颜色**）。 */
+export declare const NUMBER_STEPPER_AT_MIN = "\u5DF2\u5230\u4E0B\u9650";
+export declare const NUMBER_STEPPER_AT_MAX = "\u5DF2\u5230\u4E0A\u9650";
+export declare const NUMBER_STEPPER_UNSET = "\u672A\u8BBE\u7F6E";
+export declare const NUMBER_STEPPER_LOADING = "\u66F4\u65B0\u4E2D";
+/** 常用值那一排左端的小标签。 */
+export declare const NUMBER_STEPPER_QUICK_LABEL = "\u5E38\u7528";
+/** 减号／加号键面（几何上是两个全角符号，读屏器另有 `aria-label`）。 */
+export declare const NUMBER_STEPPER_DEC_GLYPH = "\u2212";
+export declare const NUMBER_STEPPER_INC_GLYPH = "\uFF0B";
+/** 一枚常用值：`value` 是机器值（必须落在 `[min, max]` 里），显示字按 `step` 的小数位格式化。 */
+export type NumberStepperPreset = number;
+/** 数量步进入参。`name`／`min`／`max`／`step` 必填——**没有上下限的步进器不成立**
+ *  （它会一路加到无穷），所以本件不提供"只有步长"的档。`value: null` ＝ 缺值（写成 `—`）。 */
+export interface NumberStepperInput {
+    /** 机器键（变更事件与载荷按它定位；同一页内应唯一）。非空字符串。 */
+    readonly name: string;
+    /** 当前值。`null` ＝ **缺值**（屏上写 `—`，按 ＋ 从下限起算）；缺席＝错。 */
+    readonly value: number | null;
+    /** 下限（含）。 */
+    readonly min: number;
+    /** 上限（含）。 */
+    readonly max: number;
+    /** 每次加减的步长（> 0）。 */
+    readonly step: number;
+    /** 单位（`份`／`g`／`件`）：小一号跟在值后，不参与任何机器口径。 */
+    readonly unit?: string;
+    /** 数量的名字（`份数`），进 `aria-label` 与事件 `detail.label`。 */
+    readonly label?: string;
+    /** 常用值（点一下直接落到那一档）。缺省＝不出这一排；每一项必须落在 `[min, max]` 里。 */
+    readonly presets?: readonly NumberStepperPreset[];
+    /** 口径行：加减步长与取值范围怎么定的（如「加减每次 0.5 份，范围 0.5–6 份」）。 */
+    readonly caliber?: string;
+    /** 错误说明：写在控件旁边，控件 `aria-describedby` 指向它（**不只染色**）。 */
+    readonly error?: string;
+    /** 禁用：三枚可点区一起禁用；`disabledReason` 写清**为什么**不能动。 */
+    readonly disabled?: boolean;
+    /** 禁用原因（禁用时必填：说不出为什么不能开＝读者只能猜）。 */
+    readonly disabledReason?: string;
+    /** 更新中：原地换字，值位宽度锁住不跳版。 */
+    readonly loading?: boolean;
+    /** 形态键（闭集，缺省 `standard`）。 */
+    readonly form?: NumberStepperForm;
+    /** 附加类名（空格分隔；逐个过类名正则）。 */
+    readonly extraClass?: string;
+}
+//# sourceMappingURL=attrs.d.ts.map

package/dist/components/number-stepper/attrs.d.ts.map

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

package/dist/components/number-stepper/attrs.js

@@ -0,0 +1,107 @@
+/** number-stepper · **标记契约**（渲染与运行时共用的唯一事实：类名／槽位／`data-*`／事件／闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-08-表与输入.mjs`，2026-09 用户裁定）里的
+ *  **形态 A「标准：加减＋常用值排」**——「− n ＋」三个可点区并排，下面一排常用值省点击。
+ *  它替掉的两种错法：
+ *   · 只能敲键盘填数量（手指在手机上够不到"精确到 0.5"）；
+ *   · 加减按钮小到点不中（本形态把两边各 **≥44px** 的触区写进闭集，是硬口径不是建议）。
+ *
+ *  形态键写在 `NUMBER_STEPPER_FORMS`（闭集）：本件只有一格，但键必须存在——
+ *  「形态是骨架，不是地址」：日后加第二形态是在闭集里加一格，不是新开一件。
+ *  闭集外的值一律 `badInput`（不静默降级：降级会让调用方以为自己拿到了另一种骨架）。
+ */
+/** 本件的类名根：全部槽位类名都是 `numberStepperSlot(槽名)` 拼出来的。 */
+export const NUMBER_STEPPER_CLASS = 'ilife-block-number-stepper';
+/** 形态闭集：本件只落地形态 A「标准：加减＋常用值排」。 */
+export const NUMBER_STEPPER_FORMS = ['standard'];
+/** 槽位闭集（标记契约的一部分：`render.ts` 与判据都用这里的名字拼类名，不各抄一份字面量）。 */
+export const NUMBER_STEPPER_SLOTS = [
+    /** 第一行：标签（左）＋ 可选的右上状态字位。 */
+    'head',
+    /** 数量的名字（`份数`／`份量`／`数量`）。 */
+    'label',
+    /** 右上状态字（`已到下限`／`未设置`／`更新中`）——**字**这一档的落点，不只靠颜色。 */
+    'state',
+    /** 「− n ＋」三个可点区并排的那一排（本形态的识别特征）。 */
+    'controls',
+    /** 减号键（触区 ≥44×44）。 */
+    'dec',
+    /** 值位：一枚按钮——点它直接填一个数（本形态的第三个可点区）。 */
+    'value',
+    /** 值文本（数字本体，等宽数字）。 */
+    'number',
+    /** 单位（小一号，跟在值后）。 */
+    'unit',
+    /** 加号键（触区 ≥44×44）。 */
+    'inc',
+    /** 行内编辑器（值位点开后在同一格里换上的 `<input type="number">`，由运行时段产出）。 */
+    'editor',
+    /** 常用值那一排。 */
+    'quick',
+    /** 「常用」这枚小标签。 */
+    'quickLabel',
+    /** 一枚常用值（按钮；当前值命中它时 `aria-pressed="true"`）。 */
+    'preset',
+    /** 错误说明（写在控件旁边；控件 `aria-describedby` 指向它）。 */
+    'error',
+    /** 口径行：这一件的加减步长与取值范围怎么定的。 */
+    'caliber',
+];
+/** 槽类的类名（唯一拼法：别处不许再写 `NUMBER_STEPPER_CLASS + '-' + …`）。 */
+export function numberStepperSlot(slot, prefix = 'ilife-') {
+    return prefix + 'block-number-stepper-' + slot;
+}
+/** 机器键属性：值＝`NumberStepperInput.name`。**运行时的发现锚**（`[data-ilife-stepper]`）。 */
+export const NUMBER_STEPPER_NAME_ATTR = 'data-ilife-stepper';
+/** 机器值（**数字串**：`1.5`／`3`，不带千分位、不带单位；显示字另算）。 */
+export const NUMBER_STEPPER_VALUE_ATTR = 'data-ilife-stepper-value';
+/** 人类可读字段名（`aria-label` 与事件 `detail.label` 用它）。 */
+export const NUMBER_STEPPER_LABEL_ATTR = 'data-ilife-stepper-label';
+/** 单位（小号，跟在值后；不参与机器值）。 */
+export const NUMBER_STEPPER_UNIT_ATTR = 'data-ilife-stepper-unit';
+/** 下限／上限／步长（数字串；运行时的夹取与吸附都读它们）。 */
+export const NUMBER_STEPPER_MIN_ATTR = 'data-ilife-stepper-min';
+export const NUMBER_STEPPER_MAX_ATTR = 'data-ilife-stepper-max';
+export const NUMBER_STEPPER_STEP_ATTR = 'data-ilife-stepper-step';
+/** 显示小数位（由 `step` 推出来：`step=0.5` ⇒ 1 位；`step=1` ⇒ 0 位）。 */
+export const NUMBER_STEPPER_DECIMALS_ATTR = 'data-ilife-stepper-decimals';
+/** 禁用标记（三枚可点区一起落 `disabled` ＋ `aria-disabled`；**不留"看着能点、点了没反应"**）。 */
+export const NUMBER_STEPPER_DISABLED_ATTR = 'data-ilife-stepper-disabled';
+/** 更新中标记（原地换字，值位宽度锁住不跳版）。 */
+export const NUMBER_STEPPER_LOADING_ATTR = 'data-ilife-stepper-loading';
+/** 动作标记：这一枚按钮按下去要干什么。 */
+export const NUMBER_STEPPER_ACT_ATTR = 'data-ilife-stepper-act';
+/** 一枚常用值带的目标值（数字串；点它＝直接落到那一档）。 */
+export const NUMBER_STEPPER_QUICK_ATTR = 'data-ilife-stepper-quick';
+/** 命中区标记（运行时按它找可点控件；**每一枚都 ≥44×44**）。 */
+export const NUMBER_STEPPER_HIT_ATTR = 'data-ilife-stepper-hit';
+/** 值位状态字（`已到下限`／`已到上限`／`未设置`／`更新中`；空串＝这一行不出）。 */
+export const NUMBER_STEPPER_STATE_ATTR = 'data-ilife-stepper-state';
+/** 行内编辑器在场标记（运行时进出编辑用它做幂等；样式按它切显示）。 */
+export const NUMBER_STEPPER_EDITING_ATTR = 'data-ilife-stepper-editing';
+/** 绑定完成标记（运行时幂等：重复注入不重复绑定）。 */
+export const NUMBER_STEPPER_BOUND_ATTR = 'data-ilife-stepper-bound';
+/** 动作闭集（闭集外的值一律 `badInput`）。 */
+export const NUMBER_STEPPER_ACTIONS = ['dec', 'inc', 'quick', 'edit'];
+/** 变更事件名（冒泡 `CustomEvent`，`detail = { name, label, value, prev, unit }`）。
+ *  页面用 `root.addEventListener(NUMBER_STEPPER_EVENT_CHANGE, …)` 接自己的重算逻辑——**不引入任何全局**。 */
+export const NUMBER_STEPPER_EVENT_CHANGE = 'ilife:stepper-change';
+/** 触控目标（px）：三枚可点区与常用值一律不小于它（用户裁定：44 是全宽口径，不只窄屏）。 */
+export const NUMBER_STEPPER_TOUCH_PX = 44;
+/** 相邻触控目标的最小间距（px）：『− n ＋』三个可点区**不做连体**，留缝防误点。 */
+export const NUMBER_STEPPER_GAP_PX = 8;
+/** 值位的最小宽度（px）：数字位数变了也不让整排跳版（配合等宽数字使用）。 */
+export const NUMBER_STEPPER_VALUE_MIN_PX = 88;
+/** 缺值的写法：**缺值写成 `—`**（与「0」区分；全仓同一条地板）。 */
+export const NUMBER_STEPPER_MISSING = '—';
+/** 状态字（字这一档的四个词：**状态不只靠颜色**）。 */
+export const NUMBER_STEPPER_AT_MIN = '已到下限';
+export const NUMBER_STEPPER_AT_MAX = '已到上限';
+export const NUMBER_STEPPER_UNSET = '未设置';
+export const NUMBER_STEPPER_LOADING = '更新中';
+/** 常用值那一排左端的小标签。 */
+export const NUMBER_STEPPER_QUICK_LABEL = '常用';
+/** 减号／加号键面（几何上是两个全角符号，读屏器另有 `aria-label`）。 */
+export const NUMBER_STEPPER_DEC_GLYPH = '−';
+export const NUMBER_STEPPER_INC_GLYPH = '＋';
+//# sourceMappingURL=attrs.js.map