base-paint 0.3.14 → 0.3.16

package/dist/components/punch-strip/render.d.ts

@@ -0,0 +1,24 @@
+/** 一行最多几格（600px 纸上格宽 ≥40px、390px 屏上 ≥25px 的实测口径）；更多天请用账目行。 */
+export declare const PUNCH_STRIP_MAX_CELLS = 14;
+/** 缺数格里的缺省占位（与全仓"缺数一律写 —"同字，同 `DAY_STRIP_EMPTY_MARK`）。 */
+export declare const PUNCH_STRIP_EMPTY_MARK = "\u2014";
+export interface PunchCellInput {
+    /** 格上的日期串（如 `09-17`；「今天」二字带不带由调用方定）。 */
+    readonly label: string;
+    /** 那天的读数（**已是给人看的样子**）；`null` ＝ 那天缺数（空心盒 ＋ `emptyMark`）。 */
+    readonly value: string | null;
+    /** 当前正在细看的那天（朱红描边，一页至多一格）；缺省 `false`。 */
+    readonly selected?: boolean;
+}
+export interface PunchStripInput {
+    /** 逐天的格子（顺序＝时间顺序）；0 格＝空串（与"没内容不留空块"同口径）。 */
+    readonly days: readonly PunchCellInput[];
+    /** 小标题（如「这 7 天」）；不给＝不出。字距由样式段统一，调用方不要自己加空格的写法。 */
+    readonly heading?: string;
+    /** 缺数格里的占位；缺省 `—`；给空串＝空格（原型缺数格就是空格）。 */
+    readonly emptyMark?: string;
+    readonly extraClass?: string;
+}
+/** 打孔格带：把"哪几天有数、各是多少"画成一排格。空数组出不了一个字。 */
+export declare function renderPunchStrip(input: PunchStripInput): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/components/punch-strip/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/components/punch-strip/render.ts"],"names":[],"mappings":"AAwBA,8DAA8D;AAC9D,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,WAAW,CAAC;AAE/C,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,SAAS,cAAc,EAAE,CAAC;IACzC,kDAAkD;IAClD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,yCAAyC;AACzC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CA+B/D"}

package/dist/components/punch-strip/render.js

@@ -0,0 +1,64 @@
+/** punch-strip · **渲染**（打孔格带：N 天里"哪几天有数、各是多少"，像纸边一排打孔刻度）。
+ *
+ *  —— 打孔格带 ——
+ *
+ *  形状：一格一天——**日期在上、格在下**；格是一只虚线小盒，那天有数就**填深色、值写在盒里**，
+ *  缺数留空心盒（写 `—`）；"当前正在细看的那天"套一圈朱红描边（一页至多一格）。
+ *
+ *  它替掉的是哪几种错法：
+ *   · 逐日只说一句「有记录 1/7 天」——句子报得出**数量**，报不出**哪几天**；
+ *   · 用折线讲 7 天的日级读数——7 个点在窄档挤成一条毛刺，读者要的是"哪几天有、各多少"；
+ *   · 逐日做成六列表（日期／摄入／三宏量）——窄档被卡片化成一列七块，一屏放不下；
+ *   · 逐日做成一行小字的并列串（`09-14 · 09-15 · …`）——分隔符串里读不出值，还犯去分隔符门禁。
+ *
+ *  与既有件的关系（**选型先看这三条**）：
+ *   · 要"哪天有／哪天没有"的**格带**、值进格 → 本件；
+ *   · 要"标签 → 值"的**清单**（整窗逐日、行数不定）→ `renderLedgerRows`；
+ *   · 要"值／目标"的**比例形状** → `renderScaleBar`；要"哪几天有记录"的**行式提要** → `renderDayStrip`。
+ *
+ *  出处＝原型 `.scratch/diet-ui-proto/v2-小票.html` 的 `.punch` 一族（用户点名那件「这 7 天」控件）。
+ *  格数上限住 `PUNCH_STRIP_MAX_CELLS`：它是"一行可数"的形状，再多天就该换账目行（**本件不替表格**）。
+ */
+import { esc } from '../shared/escape.js';
+import { assertPlainObject, badInput, optExtraClass, optText, reqText } from '../shared/validate.js';
+/** 一行最多几格（600px 纸上格宽 ≥40px、390px 屏上 ≥25px 的实测口径）；更多天请用账目行。 */
+export const PUNCH_STRIP_MAX_CELLS = 14;
+/** 缺数格里的缺省占位（与全仓"缺数一律写 —"同字，同 `DAY_STRIP_EMPTY_MARK`）。 */
+export const PUNCH_STRIP_EMPTY_MARK = '\u2014';
+/** 打孔格带：把"哪几天有数、各是多少"画成一排格。空数组出不了一个字。 */
+export function renderPunchStrip(input) {
+    assertPlainObject(input, 'renderPunchStrip: input');
+    const days = input.days;
+    if (!Array.isArray(days))
+        badInput('punch-strip: input.days 必须是数组');
+    if (days.length === 0)
+        return '';
+    if (days.length > PUNCH_STRIP_MAX_CELLS) {
+        badInput('punch-strip: input.days 最多 ' + PUNCH_STRIP_MAX_CELLS + ' 格（一行可数；更多天请用账目行）');
+    }
+    let emptyMark = PUNCH_STRIP_EMPTY_MARK;
+    if (input.emptyMark !== undefined) {
+        if (typeof input.emptyMark !== 'string')
+            badInput('punch-strip: input.emptyMark 必须是字符串');
+        emptyMark = input.emptyMark;
+    }
+    const heading = optText(input.heading, 'punch-strip: input.heading');
+    const extra = optExtraClass(input.extraClass, 'punch-strip: input.extraClass');
+    const p = 'ilife-block-punch-strip';
+    const cells = days.map((raw, i) => {
+        const field = 'punch-strip: input.days[' + i + ']';
+        assertPlainObject(raw, field);
+        const label = reqText(raw.label, field + '.label');
+        const value = raw.value === null || raw.value === undefined ? null : reqText(raw.value, field + '.value');
+        return '<div class="' + p + '-cell' + (value === null ? '' : ' is-on')
+            + (raw.selected === true ? ' is-selected' : '') + '">'
+            + '<span class="' + p + '-date">' + esc(label) + '</span>'
+            + '<span class="' + p + '-box">' + esc(value === null ? emptyMark : value) + '</span>'
+            + '</div>';
+    }).join('');
+    return '<div class="' + p + (extra === undefined ? '' : ' ' + extra) + '">'
+        + (heading === undefined ? '' : '<div class="' + p + '-heading">' + esc(heading) + '</div>')
+        + '<div class="' + p + '-cells">' + cells + '</div>'
+        + '</div>';
+}
+//# sourceMappingURL=render.js.map

package/dist/components/punch-strip/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/components/punch-strip/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErG,8DAA8D;AAC9D,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAExC,0DAA0D;AAC1D,MAAM,CAAC,MAAM,sBAAsB,GAAG,QAAQ,CAAC;AAqB/C,yCAAyC;AACzC,MAAM,UAAU,gBAAgB,CAAC,KAAsB;IACrD,iBAAiB,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,QAAQ,CAAC,+BAA+B,CAAC,CAAC;IACpE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,IAAI,CAAC,MAAM,GAAG,qBAAqB,EAAE,CAAC;QACxC,QAAQ,CAAC,6BAA6B,GAAG,qBAAqB,GAAG,mBAAmB,CAAC,CAAC;IACxF,CAAC;IACD,IAAI,SAAS,GAAG,sBAAsB,CAAC;IACvC,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;YAAE,QAAQ,CAAC,qCAAqC,CAAC,CAAC;QACzF,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IAC9B,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,4BAA4B,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,UAAU,EAAE,+BAA+B,CAAC,CAAC;IAC/E,MAAM,CAAC,GAAG,yBAAyB,CAAC;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QAChC,MAAM,KAAK,GAAG,0BAA0B,GAAG,CAAC,GAAG,GAAG,CAAC;QACnD,iBAAiB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,KAAK,IAAI,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,CAAC,CAAC;QAC1G,OAAO,cAAc,GAAG,CAAC,GAAG,OAAO,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;cAClE,CAAC,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI;cACpD,eAAe,GAAG,CAAC,GAAG,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,SAAS;cACxD,eAAe,GAAG,CAAC,GAAG,QAAQ,GAAG,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,SAAS;cACpF,QAAQ,CAAC;IACf,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,cAAc,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI;UACvE,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,GAAG,YAAY,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC;UAC1F,cAAc,GAAG,CAAC,GAAG,UAAU,GAAG,KAAK,GAAG,QAAQ;UAClD,QAAQ,CAAC;AACf,CAAC"}

package/dist/components/punch-strip/style.d.ts

@@ -0,0 +1,8 @@
+/** 盒子的几何（px）：高度与被"打孔"的方角——两处读数住这里，样式与测试都读它。 */
+export declare const PUNCH_STRIP_BOX_HEIGHT_PX = 34;
+export declare const PUNCH_STRIP_BOX_RADIUS_PX = 3;
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export declare function punchStripCss(input?: {
+    readonly prefix?: string;
+}): string;
+//# sourceMappingURL=style.d.ts.map

package/dist/components/punch-strip/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../../src/components/punch-strip/style.ts"],"names":[],"mappings":"AAoBA,+CAA+C;AAC/C,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,4BAA4B;AAC5B,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAuE1E"}

package/dist/components/punch-strip/style.js

@@ -0,0 +1,95 @@
+/** punch-strip · **样式段**（本组件唯一的样式来源）。
+ *
+ *  纪律（与本层其余件同一份）：只读 token，不新增 token 名；全部规则 scope 在 `.<prefix>page-ui` 下。
+ *  **色一律读 token**：文字走冻结 token（皮肤作用域里有旧名映射），虚线／软底／描边几处显式经 `skinVar()` 读皮肤。
+ *
+ *  几何契约（钉在测试里）：
+ *   · 格宽是**份数**（`flex: 1 1 0`）⇒ 总宽永远等于容器宽，N 格换 M 格不横滑（390 档无横滚）；
+ *   · 空心盒与实心盒**同一副盒模型**（描边改成实色、不删边框）⇒ 有数／没数的格子等高等宽，不跳版；
+ *   · 日期位与盒子里的小字（两处都是"数"）都经 `skinVar('font-num')` 读皮肤的数字字面。
+ *
+ *  色（选中态口径）：打孔虚线走 `line`、选中描边走 `accent`；**有数格走"有文字的选中面"那一档**
+ *  （底 `accent-soft`、字 `accent-text`、描边 `accent`）——盒里那枚 10.5px 读数是**字**，
+ *  而实心 `accent` 那一档只许放图形／勾／大字（`accent-ink` on `accent` 在 `neutral` 只有 4.02:1，
+ *  过不了文本地板 ⇒ 读数不许坐在实心强调底上）。件里零颜色字面量。
+ */
+import { skinVar } from '../skin/contract.js';
+/** 换行（仓库口径：不写字面换行转义）。 */
+const LF = String.fromCharCode(10);
+/** 盒子的几何（px）：高度与被"打孔"的方角——两处读数住这里，样式与测试都读它。 */
+export const PUNCH_STRIP_BOX_HEIGHT_PX = 34;
+export const PUNCH_STRIP_BOX_RADIUS_PX = 3;
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export function punchStripCss(input) {
+    const p = input !== undefined && input !== null
+        && typeof input.prefix === 'string' && input.prefix !== '' ? input.prefix : 'ilife-';
+    const root = '.' + p + 'page-ui';
+    const s = root + ' .' + p + 'block-punch-strip';
+    return [
+        '/* punch-strip（打孔格带）：一格一天，虚线"打孔"盒；有数格填主色软底＋主色字、选中套主色圈。 */',
+        s + ' {',
+        '  display: flex;',
+        '  flex-direction: column;',
+        '  gap: 4px;',
+        '  min-width: 0;',
+        '}',
+        '/* 小标题与"账目/明细"两件的标题同一套字距语汇（同一族里只有一种小标题写法）。 */',
+        s + '-heading {',
+        '  margin-bottom: 2px;',
+        '  color: var(--fg3);',
+        '  font-size: 11.5px;',
+        '  font-weight: 700;',
+        '  letter-spacing: .22em;',
+        '}',
+        s + '-cells {',
+        '  display: flex;',
+        '  align-items: flex-end;',
+        '  gap: 6px;',
+        '  min-width: 0;',
+        '}',
+        s + '-cell {',
+        '  flex: 1 1 0;',
+        '  min-width: 0;',
+        '  display: flex;',
+        '  flex-direction: column;',
+        '  gap: 4px;',
+        '}',
+        s + '-date {',
+        '  font-family: ' + skinVar('font-num') + ';',
+        '  font-size: 10px;',
+        '  letter-spacing: -.02em;',
+        '  color: var(--fg3);',
+        '  text-align: center;',
+        '  white-space: nowrap;',
+        '}',
+        s + '-box {',
+        '  box-sizing: border-box;',
+        '  height: ' + PUNCH_STRIP_BOX_HEIGHT_PX + 'px;',
+        '  border: 1px dashed ' + skinVar('line') + ';',
+        '  border-radius: ' + PUNCH_STRIP_BOX_RADIUS_PX + 'px;',
+        '  display: flex;',
+        '  align-items: flex-end;',
+        '  justify-content: center;',
+        '  padding-bottom: 4px;',
+        '  font-family: ' + skinVar('font-num') + ';',
+        '  font-size: 10.5px;',
+        '  color: var(--fg3);',
+        '  overflow: hidden;',
+        '}',
+        '/* 有数：底改主色软底、字取强调色的文本档、描边取主色（**面上有读数 ⇒ 走"有文字的选中面"那一档**；',
+        '   实心 accent 那一档只许放图形／勾／大写大字）。描边改实色、不删边框 ⇒ 与空心盒等高等宽、不跳版。 */',
+        s + '-cell.is-on ' + '.' + p + 'block-punch-strip-box {',
+        '  background: ' + skinVar('accent-soft') + ';',
+        '  border-color: ' + skinVar('accent') + ';',
+        '  border-style: solid;',
+        '  color: ' + skinVar('accent-text') + ';',
+        '  font-weight: 700;',
+        '}',
+        '/* 选中：一格主色描边（一页至多一格；只描边、不改字色 ⇒ 不写成反白）。 */',
+        s + '-cell.is-selected ' + '.' + p + 'block-punch-strip-box {',
+        '  outline: 1.5px solid ' + skinVar('accent') + ';',
+        '  outline-offset: 1px;',
+        '}',
+    ].join(LF);
+}
+//# sourceMappingURL=style.js.map

package/dist/components/punch-strip/style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.js","sourceRoot":"","sources":["../../../src/components/punch-strip/style.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,yBAAyB;AACzB,MAAM,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AAEnC,+CAA+C;AAC/C,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAC5C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAE3C,4BAA4B;AAC5B,MAAM,UAAU,aAAa,CAAC,KAAoC;IAChE,MAAM,CAAC,GAAG,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;WAC1C,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;IACvF,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC;IACjC,MAAM,CAAC,GAAG,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,mBAAmB,CAAC;IAChD,OAAO;QACL,2DAA2D;QAC3D,CAAC,GAAG,IAAI;QACR,kBAAkB;QAClB,2BAA2B;QAC3B,aAAa;QACb,iBAAiB;QACjB,GAAG;QACH,+CAA+C;QAC/C,CAAC,GAAG,YAAY;QAChB,uBAAuB;QACvB,sBAAsB;QACtB,sBAAsB;QACtB,qBAAqB;QACrB,0BAA0B;QAC1B,GAAG;QACH,CAAC,GAAG,UAAU;QACd,kBAAkB;QAClB,0BAA0B;QAC1B,aAAa;QACb,iBAAiB;QACjB,GAAG;QACH,CAAC,GAAG,SAAS;QACb,gBAAgB;QAChB,iBAAiB;QACjB,kBAAkB;QAClB,2BAA2B;QAC3B,aAAa;QACb,GAAG;QACH,CAAC,GAAG,SAAS;QACb,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,GAAG;QAC7C,oBAAoB;QACpB,2BAA2B;QAC3B,sBAAsB;QACtB,uBAAuB;QACvB,wBAAwB;QACxB,GAAG;QACH,CAAC,GAAG,QAAQ;QACZ,2BAA2B;QAC3B,YAAY,GAAG,yBAAyB,GAAG,KAAK;QAChD,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,GAAG;QAC/C,mBAAmB,GAAG,yBAAyB,GAAG,KAAK;QACvD,kBAAkB;QAClB,0BAA0B;QAC1B,4BAA4B;QAC5B,wBAAwB;QACxB,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,GAAG;QAC7C,sBAAsB;QACtB,sBAAsB;QACtB,qBAAqB;QACrB,GAAG;QACH,yDAAyD;QACzD,6DAA6D;QAC7D,CAAC,GAAG,cAAc,GAAG,GAAG,GAAG,CAAC,GAAG,yBAAyB;QACxD,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,GAAG,GAAG;QAC/C,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,GAAG;QAC5C,wBAAwB;QACxB,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,GAAG,GAAG;QAC1C,qBAAqB;QACrB,GAAG;QACH,2CAA2C;QAC3C,CAAC,GAAG,oBAAoB,GAAG,GAAG,GAAG,CAAC,GAAG,yBAAyB;QAC9D,yBAAyB,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,GAAG;QACnD,wBAAwB;QACxB,GAAG;KACJ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACb,CAAC"}

package/dist/components/quick-capture/attrs.d.ts

@@ -0,0 +1,181 @@
+/** quick-capture · **标记契约**（渲染与运行时共用的唯一事实：类名／槽位／`data-*`／事件名／闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/新件/parts-交互与流程.mjs` 第 86 件，2026-09 起用户逐格打分）
+ *  里 **A 一档「一行式录入 ＋ 解析预览（哪格认错了点哪格改）」**——三套皮肤都打 4 分的那一版；
+ *  2026-09-26 用户给 **B 档「常驻条（一行）↔ 推开的 6 格」** 补分（中性／小票纸／大字报刊三套皮各 4 分），
+ *  照**砍过字的那一版原型**补落为第二档 `drawer`（同一份入参契约，只换骨架：解析预览住进推开的抽屉）。
+ *
+ *  它替掉的两种错法（原型墙那一格的原文）：①「随手记一笔也要开浮层、填 6 格、再点保存」；
+ *  ②「一句话里说了三件事（吃了什么／多少钱／哪张卡），人得自己拆成三格」。
+ *
+ *  **一屏只留一层话**（2026-09-25 用户口径：原型里写了好多文字、看起来很混乱）：本件屏上只有三样——
+ *  「写的那一句话」（输入框里的字）＋「它认出来的几格」（每格：原文那一截 ＋ ＝ ＋ 认成的值 ＋ 改）
+ *  ＋「能按什么」（分开填／存、记过的那几条）。原型里的旁白与口径句（「解析成」「这样记过的」，
+ *  以及句尾那些说明）**一句都不进屏面**：那些话住在本说明书里。同一个数只印一次。
+ *
+ *  **本件不猜词**：一句话怎么拆成几格、每一格认成了什么，**由调用方给**（`cells`）；
+ *  运行时段只在人改了某一格时把那一格原地重写，不重算别的格、也不从字面反推字段——
+ *  「午饭」是哪一类、32 元该记成 32.00 还是 3.20，那是各技能自己的词表（铁律一：能力自治）。
+ *
+ *  **触屏可达是底线**（触屏优先法条）：一行里两颗按钮、每一格、每一枚候选、记过的每一条都是 ≥44×44 的
+ *  真按钮，相邻留 8px 缝；「哪格认错了点哪格改」一根手指走完（点那一格 → 点一枚候选）。
+ *  打字只是**一条**通路：「记过的」那几条点一下就把那句话填回输入框。
+ *  键盘（`:focus-visible`）只留给真实键盘用户，是本件的地板，不是通路。
+ *
+ *  **零键盘语汇**：标记与文案里没有键帽（`⌘`／`Esc`／`↑↓` 那一路），运行时段不接任何键盘事件。
+ */
+/** 本件的类名根：全部槽位类名都是 `QUICK_CAPTURE_CLASS + '-' + 槽名`。 */
+export declare const QUICK_CAPTURE_CLASS = "ilife-block-quick-capture";
+/** 槽位闭集（标记契约的一部分：`render.ts`／`style.ts`／`runtime.ts` 与判据都用这里的名字拼类名）。
+ *
+ *  取名避开「一个槽名是另一个槽名的前缀」那种撞法（`pick` 与 `picks`／`field` 与 `fields`）：
+ *  判据在标记串上找槽位时才不会把容器当项。 */
+export declare const QUICK_CAPTURE_SLOTS: readonly ["host", "line", "lead", "input", "more", "save", "parse", "drawer", "hd", "grid", "unit", "chip", "src", "field", "to", "pen", "tray", "pick", "keep", "recent", "lb", "recall"];
+export type QuickCaptureSlot = (typeof QUICK_CAPTURE_SLOTS)[number];
+/** 槽类的类名（唯一拼法：别处不许再写 `QUICK_CAPTURE_CLASS + '-' + …`）。 */
+export declare function quickCaptureSlot(slot: QuickCaptureSlot, prefix?: string): string;
+/** 形态闭集（**两档英文键**，同一份入参契约）：
+ *   · `oneline`＝A 档「一行式录入 ＋ 解析预览」（录入与预览都在这一行上，哪格认错了点哪格改）；
+ *   · `drawer` ＝B 档「常驻条（一行）↔ 推开的 6 格」（解析预览住进抽屉；「分开填」那枚是抽屉开关）。 */
+export declare const QUICK_CAPTURE_FORMS: readonly ["oneline", "drawer"];
+export type QuickCaptureForm = (typeof QUICK_CAPTURE_FORMS)[number];
+/** 根（值＝机器键 `id`）。 */
+export declare const QUICK_CAPTURE_ATTR = "data-ilife-quick-capture";
+/** 形态（值是闭集内的那一个键，照实写进标记）。 */
+export declare const QUICK_CAPTURE_FORM_ATTR = "data-ilife-quick-capture-form";
+/** 输入框（值＝`id`）：运行时按它认「哪一句话的字变了」。 */
+export declare const QUICK_CAPTURE_BOX_ATTR = "data-ilife-quick-capture-box";
+/** 根上：现在写的那一句话（机器读数；输入框里的字是它的另一种摆法，两处一起写）。 */
+export declare const QUICK_CAPTURE_TEXT_ATTR = "data-ilife-quick-capture-text";
+/** 一格里的一枚（值＝这一格的机器键）。 */
+export declare const QUICK_CAPTURE_CELL_ATTR = "data-ilife-quick-capture-cell";
+/** 这一格现在认成的机器键（运行时改完原地重写它：屏面与机器读数一起翻）。 */
+export declare const QUICK_CAPTURE_VALUE_ATTR = "data-ilife-quick-capture-value";
+/** 格里的读数那一格（值＝这一格的机器键；运行时按它原地重写那一串字）。 */
+export declare const QUICK_CAPTURE_READ_ATTR = "data-ilife-quick-capture-read";
+/** 某一格的候选带（值＝这一格的机器键）。 */
+export declare const QUICK_CAPTURE_TRAY_ATTR = "data-ilife-quick-capture-tray";
+/** 候选带里的一枚候选（值＝这一枚的机器键）。 */
+export declare const QUICK_CAPTURE_PICK_ATTR = "data-ilife-quick-capture-pick";
+/** 候选带里那枚「不改」（值＝这一格的机器键）。 */
+export declare const QUICK_CAPTURE_KEEP_ATTR = "data-ilife-quick-capture-keep";
+/** 「存」那枚（值＝`id`）。 */
+export declare const QUICK_CAPTURE_SAVE_ATTR = "data-ilife-quick-capture-save";
+/** 「分开填」那枚（值＝`id`）。**形态 `drawer` 下它是抽屉开关**：`aria-expanded` 说得出摊开没收起。 */
+export declare const QUICK_CAPTURE_SPLIT_ATTR = "data-ilife-quick-capture-split";
+/** 推开的抽屉（值＝`id`；**形态 `drawer` 专属**，常驻收起时 `hidden`）。 */
+export declare const QUICK_CAPTURE_DRAWER_ATTR = "data-ilife-quick-capture-drawer";
+/** 记过的一条（值＝`id`；那句话就是这一枚自己的字）。 */
+export declare const QUICK_CAPTURE_RECALL_ATTR = "data-ilife-quick-capture-recall";
+/** 记账：这张卡已被运行时段接管（幂等读数，不是开关）。 */
+export declare const QUICK_CAPTURE_BOUND_ATTR = "data-ilife-quick-capture-bound";
+/** 幂等开关：挂在 `<html>` 上（重复注入只绑一次）。 */
+export declare const QUICK_CAPTURE_RUNTIME_ATTR = "data-ilife-quick-capture-runtime";
+/** 写的那一句话变了（打字，或点了一条记过的）：`detail={id,text}`。
+ *  **页面按它重算解析预览并重渲染**（本件不猜词）：`text` 是新句子的机器读数。 */
+export declare const QUICK_CAPTURE_EVENT_CHANGE = "ilife:quick-capture-change";
+/** 某一格改成别的了：`detail={id,key,value,to}`（`key`＝哪一格，`value`＝新机器键，`to`＝新读数）。 */
+export declare const QUICK_CAPTURE_EVENT_PICK = "ilife:quick-capture-pick";
+/** 点了「存」：`detail={id,text,cells}`（`cells`＝每一格现在的读数，顺序＝屏上顺序）。本件不写库。 */
+export declare const QUICK_CAPTURE_EVENT_SAVE = "ilife:quick-capture-save";
+/** 点了「分开填」：`detail={id,text}`（本件不开表单，开表单归页面）。 */
+export declare const QUICK_CAPTURE_EVENT_SPLIT = "ilife:quick-capture-split";
+/** 触控地板：每一枚可点件的命中盒不小于这个数（px）。 */
+export declare const QUICK_CAPTURE_TOUCH_PX = 44;
+/** 相邻触控目标之间的缝（px）：一行里的两颗按钮、格与格、候选与候选都按它让开。 */
+export declare const QUICK_CAPTURE_GAP_PX = 8;
+/** 本件自己的**容器**名（`@container` 按它命中，不会跟别件的容器串味）。 */
+export declare const QUICK_CAPTURE_CONTAINER = "ilife-quick-capture";
+/** 窄档断点（px）：**本件自己**窄于它就把那一行摊开（输入框占满一行，两颗按钮跟着走）。
+ *  这是容器断点，不是视口断点。 */
+export declare const QUICK_CAPTURE_NARROW_PX = 560;
+/** 抽屉那 6 格走单列的容器宽（px）：本件窄于它就一格一列（两列在一格里放不下读数时，宁可往下排）。
+ *  同样是容器断点。 */
+export declare const QUICK_CAPTURE_DRAWER_NARROW_PX = 480;
+/** 悬停只许是增强：这一段能力查询**样式段读它**（运行时不抢焦点，不读它）。 */
+export declare const QUICK_CAPTURE_HOVER_QUERY = "(hover: hover) and (pointer: fine)";
+/** 输入框在窄档下的最小可用宽（px）：比它再窄就整行占满（不让输入框被两颗按钮挤成一道缝）。 */
+export declare const QUICK_CAPTURE_BOX_MIN_PX = 120;
+/** 一格能改成的那几枚候选：**至少 1 枚、至多 6 枚**（一个都改不了的格不该做成可点件）。 */
+export declare const QUICK_CAPTURE_MIN_CHOICES = 1;
+export declare const QUICK_CAPTURE_MAX_CHOICES = 6;
+/** 一句话能拆成几格：**至少 1 格、至多 6 格**。 */
+export declare const QUICK_CAPTURE_MIN_CELLS = 1;
+export declare const QUICK_CAPTURE_MAX_CELLS = 6;
+/** 「记过的」最多摆几条（0 条＝不出这一条带）。 */
+export declare const QUICK_CAPTURE_MAX_RECENT = 4;
+/** 候选带里现在这一枚前面那枚勾。 */
+export declare const QUICK_CAPTURE_TICK = "\u2713";
+/** 候选带里现在这一枚的勾选槽位宽（px）：**未选也留同宽**，一排候选的左右沿才齐平。 */
+export declare const QUICK_CAPTURE_TICK_PX = 14;
+/** 格尾那枚「改」的高度（px）：它住在整枚按钮里，是**记号不是命中盒**（命中盒＝整枚格 ≥44）。 */
+export declare const QUICK_CAPTURE_PEN_PX = 32;
+export declare const QUICK_CAPTURE_TEXT: Readonly<{
+    /** 行首那枚小签。 */
+    readonly lead: "随手记";
+    /** 左边是原话、右边是认成的值，中间这一枚（印在左边那一截的末尾：「午饭」＝）。 */
+    readonly eq: "＝";
+    /** 格尾那枚（点它会改这一格）。 */
+    readonly pen: "改";
+    /** 候选带里那枚取消。 */
+    readonly keep: "不改";
+    /** 主按钮。 */
+    readonly save: "存";
+    /** 第二颗按钮。 */
+    readonly split: "分开填";
+    /** 「记过的」那三个字。 */
+    readonly recentLead: "记过的";
+    /** 抽屉标题里那一段连接（「分开填 · 6 格」）：标题＝`split ＋ 这一截 ＋ 格数 ＋ 单位`。 */
+    readonly drawerJoin: " · ";
+    /** 抽屉标题里的单位（「分开填 · 6 格」）。 */
+    readonly drawerUnit: " 格";
+    /** 输入框的无障碍名（不上屏）。 */
+    readonly boxLabel: "一句话记一笔";
+    /** 候选带的无障碍名尾巴（不上屏）：`<这一格叫什么>能改成`。 */
+    readonly trayLead: "能改成";
+}>;
+/** 一格能改成的那一枚（词表里的一项：机器键 ＋ 屏上那两个字）。 */
+export interface QuickCaptureChoice {
+    /** 机器键（事件 `detail.value` 就是它）。**非空、只许标识符字符**，同一格内唯一。 */
+    readonly key: string;
+    /** 屏上那一串（如「餐饮」／「32.00」／「现金账户」）。**非空、且不能只有空白**；长了换行，绝不截断。 */
+    readonly label: string;
+}
+/** 一句话拆出来的一格（哪一格认错了，点哪一格改）。 */
+export interface QuickCaptureCell {
+    /** 这一格的机器键（如 `category`／`amount`；事件 `detail.key` 就是它）。**非空、只许标识符字符**，表内唯一。 */
+    readonly key: string;
+    /** 这一格现在认成的机器键：**必须命中 `choices` 里的一枚**（屏上那一串就是它的名字）。 */
+    readonly value: string;
+    /** 这一格能改成的那几枚（**含现在这一枚**；1–6 枚）。一枚都不给＝这一格改不了，那种格不许做成可点件。 */
+    readonly choices: readonly QuickCaptureChoice[];
+    /** 原文那一截（如「午饭」；屏上印成「午饭」）。**与 `label` 恰好给一个**：
+     *  给了它＝这一格是从这句话里认出来的。**非空、且不能只有空白**。 */
+    readonly from?: string;
+    /** 这一格叫什么（如「日期」）。**与 `from` 恰好给一个**：给了它＝原文里没写这一格，
+     *  它是**补上的**（屏上不带引号，形是虚线边框）。**非空、且不能只有空白**。 */
+    readonly label?: string;
+}
+/** 快速录入条入参。`id`／`text`／`cells` 三样必填——没有 `text` 就没有「写的那一句话」，
+ *  没有 `cells` 就没有「它认出来的几格」（两半各印一半，屏上会自相矛盾）。 */
+export interface QuickCaptureInput {
+    /** 机器键（根上的发现锚与事件 `detail.id` 都拿它）。**非空、只许标识符字符**。 */
+    readonly id: string;
+    /** 现在写着的那一句话（如「午饭 32 元 现金」）。**非空、且不能只有空白**。 */
+    readonly text: string;
+    /** 一句话拆出来的几格（**1–6 格**，顺序＝屏上顺序）。**调用的那一方算出来的**：本件不猜词。 */
+    readonly cells: readonly QuickCaptureCell[];
+    /** 「记过的」那几条（0–4 条，每条是一句完整的话；点一条＝把它填回输入框）。不给＝不出这一条带。 */
+    readonly recent?: readonly string[];
+    /** 形态键（闭集，缺省 `oneline`）。 */
+    readonly form?: QuickCaptureForm;
+    /** 附加类名（空格分隔；逐个过类名正则）。 */
+    readonly extraClass?: string;
+}
+/** 一格在「认成哪一枚」这件事上的唯一口径：**渲染期标选中态、运行时段翻选中态跑的是同一份源码**
+ *  （`buildQuickCaptureJs()` 把它的 `toString()` 原样嵌进产出的 JS）。
+ *
+ *  故函数体只许读**自己的入参**（不许碰模块作用域里的任何名字），返回命中的那一枚的机器键；
+ *  一枚都不命中＝`''`（这种情形由入参校验挡住，运行时段不做兜底猜谜）。 */
+export declare function quickCaptureChoiceOn(keys: readonly string[], value: string): string;
+//# sourceMappingURL=attrs.d.ts.map

package/dist/components/quick-capture/attrs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.d.ts","sourceRoot":"","sources":["../../../src/components/quick-capture/attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,wDAAwD;AACxD,eAAO,MAAM,mBAAmB,8BAA8B,CAAC;AAE/D;;;2BAG2B;AAC3B,eAAO,MAAM,mBAAmB,4LA8CtB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,SAAW,GAAG,MAAM,CAElF;AAED;;iEAEiE;AACjE,eAAO,MAAM,mBAAmB,gCAAiC,CAAC;AAClE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAIpE,qBAAqB;AACrB,eAAO,MAAM,kBAAkB,6BAA6B,CAAC;AAC7D,6BAA6B;AAC7B,eAAO,MAAM,uBAAuB,kCAAkC,CAAC;AACvE,oCAAoC;AACpC,eAAO,MAAM,sBAAsB,iCAAiC,CAAC;AACrE,8CAA8C;AAC9C,eAAO,MAAM,uBAAuB,kCAAkC,CAAC;AACvE,yBAAyB;AACzB,eAAO,MAAM,uBAAuB,kCAAkC,CAAC;AACvE,0CAA0C;AAC1C,eAAO,MAAM,wBAAwB,mCAAmC,CAAC;AACzE,yCAAyC;AACzC,eAAO,MAAM,uBAAuB,kCAAkC,CAAC;AACvE,0BAA0B;AAC1B,eAAO,MAAM,uBAAuB,kCAAkC,CAAC;AACvE,4BAA4B;AAC5B,eAAO,MAAM,uBAAuB,kCAAkC,CAAC;AACvE,6BAA6B;AAC7B,eAAO,MAAM,uBAAuB,kCAAkC,CAAC;AACvE,qBAAqB;AACrB,eAAO,MAAM,uBAAuB,kCAAkC,CAAC;AACvE,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,mCAAmC,CAAC;AACzE,uDAAuD;AACvD,eAAO,MAAM,yBAAyB,oCAAoC,CAAC;AAC3E,kCAAkC;AAClC,eAAO,MAAM,yBAAyB,oCAAoC,CAAC;AAC3E,iCAAiC;AACjC,eAAO,MAAM,wBAAwB,mCAAmC,CAAC;AACzE,oCAAoC;AACpC,eAAO,MAAM,0BAA0B,qCAAqC,CAAC;AAI7E;kDACkD;AAClD,eAAO,MAAM,0BAA0B,+BAA+B,CAAC;AACvE,4EAA4E;AAC5E,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AACnE,sEAAsE;AACtE,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AACnE,iDAAiD;AACjD,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AAIrE,iCAAiC;AACjC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,8CAA8C;AAC9C,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,kDAAkD;AAClD,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAC7D;qBACqB;AACrB,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C;eACe;AACf,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAClD,6CAA6C;AAC7C,eAAO,MAAM,yBAAyB,uCAAuC,CAAC;AAC9E,oDAAoD;AACpD,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,sDAAsD;AACtD,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,kCAAkC;AAClC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,8BAA8B;AAC9B,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAI1C,sBAAsB;AACtB,eAAO,MAAM,kBAAkB,WAAM,CAAC;AACtC,kDAAkD;AAClD,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,yDAAyD;AACzD,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAOvC,eAAO,MAAM,kBAAkB;IAC7B,cAAc;;IAEd,6CAA6C;;IAE7C,qBAAqB;;IAErB,gBAAgB;;IAEhB,WAAW;;IAEX,aAAa;;IAEb,iBAAiB;;IAEjB,0DAA0D;;IAE1D,6BAA6B;;IAE7B,qBAAqB;;IAErB,qCAAqC;;EAE5B,CAAC;AAIZ,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,+BAA+B;AAC/B,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAChD;4CACwC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;mDAC+C;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;+CAC+C;AAC/C,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC5C,uDAAuD;IACvD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACjC,0BAA0B;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;2CAI2C;AAC3C,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKnF"}

package/dist/components/quick-capture/attrs.js

@@ -0,0 +1,203 @@
+/** quick-capture · **标记契约**（渲染与运行时共用的唯一事实：类名／槽位／`data-*`／事件名／闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/新件/parts-交互与流程.mjs` 第 86 件，2026-09 起用户逐格打分）
+ *  里 **A 一档「一行式录入 ＋ 解析预览（哪格认错了点哪格改）」**——三套皮肤都打 4 分的那一版；
+ *  2026-09-26 用户给 **B 档「常驻条（一行）↔ 推开的 6 格」** 补分（中性／小票纸／大字报刊三套皮各 4 分），
+ *  照**砍过字的那一版原型**补落为第二档 `drawer`（同一份入参契约，只换骨架：解析预览住进推开的抽屉）。
+ *
+ *  它替掉的两种错法（原型墙那一格的原文）：①「随手记一笔也要开浮层、填 6 格、再点保存」；
+ *  ②「一句话里说了三件事（吃了什么／多少钱／哪张卡），人得自己拆成三格」。
+ *
+ *  **一屏只留一层话**（2026-09-25 用户口径：原型里写了好多文字、看起来很混乱）：本件屏上只有三样——
+ *  「写的那一句话」（输入框里的字）＋「它认出来的几格」（每格：原文那一截 ＋ ＝ ＋ 认成的值 ＋ 改）
+ *  ＋「能按什么」（分开填／存、记过的那几条）。原型里的旁白与口径句（「解析成」「这样记过的」，
+ *  以及句尾那些说明）**一句都不进屏面**：那些话住在本说明书里。同一个数只印一次。
+ *
+ *  **本件不猜词**：一句话怎么拆成几格、每一格认成了什么，**由调用方给**（`cells`）；
+ *  运行时段只在人改了某一格时把那一格原地重写，不重算别的格、也不从字面反推字段——
+ *  「午饭」是哪一类、32 元该记成 32.00 还是 3.20，那是各技能自己的词表（铁律一：能力自治）。
+ *
+ *  **触屏可达是底线**（触屏优先法条）：一行里两颗按钮、每一格、每一枚候选、记过的每一条都是 ≥44×44 的
+ *  真按钮，相邻留 8px 缝；「哪格认错了点哪格改」一根手指走完（点那一格 → 点一枚候选）。
+ *  打字只是**一条**通路：「记过的」那几条点一下就把那句话填回输入框。
+ *  键盘（`:focus-visible`）只留给真实键盘用户，是本件的地板，不是通路。
+ *
+ *  **零键盘语汇**：标记与文案里没有键帽（`⌘`／`Esc`／`↑↓` 那一路），运行时段不接任何键盘事件。
+ */
+/** 本件的类名根：全部槽位类名都是 `QUICK_CAPTURE_CLASS + '-' + 槽名`。 */
+export const QUICK_CAPTURE_CLASS = 'ilife-block-quick-capture';
+/** 槽位闭集（标记契约的一部分：`render.ts`／`style.ts`／`runtime.ts` 与判据都用这里的名字拼类名）。
+ *
+ *  取名避开「一个槽名是另一个槽名的前缀」那种撞法（`pick` 与 `picks`／`field` 与 `fields`）：
+ *  判据在标记串上找槽位时才不会把容器当项。 */
+export const QUICK_CAPTURE_SLOTS = [
+    /** 根（卡：写的那一行 ＋ 解析预览 ＋ 记过的；它自己就是容器）。 */
+    'host',
+    /** 写的那一行（行首小签 ＋ 输入框 ＋ 分开填 ＋ 存）。 */
+    'line',
+    /** 行首那枚小签（「随手记」：这一行是干什么的，只有三个字）。 */
+    'lead',
+    /** 输入框（那一句话本身）。 */
+    'input',
+    /** 「分开填」那枚（形态 `oneline`：去字段表单里一格格填，本件只报一件事；
+     *  **形态 `drawer`：它是抽屉开关**——点它把下面那 6 格推开／收起）。 */
+    'more',
+    /** 「存」那枚（这一件的主按钮，看得见的第一动作）。 */
+    'save',
+    /** 解析预览那一条带（**形态 `oneline` 专属**：每一格就在这一行上）。 */
+    'parse',
+    /** 推开的抽屉（**形态 `drawer` 专属**：常驻收起时 `hidden`，一格都不上屏）。 */
+    'drawer',
+    /** 抽屉的标题（「分开填 · 6 格」：这一屉是什么、里面几格）。 */
+    'hd',
+    /** 抽屉里那 6 格的网格（两列；本件窄于常量那个宽度时走一列）。 */
+    'grid',
+    /** 抽屉里的一格 ＋ 它自己的候选带（**网格的一项**：带子摊开时留在这一项里，不横跨整行）。 */
+    'unit',
+    /** 一格里的一枚（**整枚就是那颗按钮**：命中盒就是它）。 */
+    'chip',
+    /** 原文那一截（「午饭」；这一格是从这句话里认出来的）。 */
+    'src',
+    /** 补出来的那一格的名字（如「日期」：原文里没写，这一格是补上的默认值）。 */
+    'field',
+    /** 认成的值（这一格真正的读数；**永不截断**，运行时原地重写的就是它）。 */
+    'to',
+    /** 格尾那枚「改」（装饰：整枚是按钮，这一枚说明点它会改这一格）。 */
+    'pen',
+    /** 某一格的候选带（**收起时 `hidden`**：一屏只留一层话，一次只摊开一格）。 */
+    'tray',
+    /** 候选带里的一枚候选（点它＝这一格改成它）。 */
+    'pick',
+    /** 候选带里那枚「不改」（取消：收起带子，这一格一动不动）。 */
+    'keep',
+    /** 「记过的」那一条带（点一条＝把那句话填回输入框）。 */
+    'recent',
+    /** 「记过的」那三个字。 */
+    'lb',
+    /** 记过的一条（点它＝不用打字也能换一句话）。 */
+    'recall',
+];
+/** 槽类的类名（唯一拼法：别处不许再写 `QUICK_CAPTURE_CLASS + '-' + …`）。 */
+export function quickCaptureSlot(slot, prefix = 'ilife-') {
+    return prefix + 'block-quick-capture-' + slot;
+}
+/** 形态闭集（**两档英文键**，同一份入参契约）：
+ *   · `oneline`＝A 档「一行式录入 ＋ 解析预览」（录入与预览都在这一行上，哪格认错了点哪格改）；
+ *   · `drawer` ＝B 档「常驻条（一行）↔ 推开的 6 格」（解析预览住进抽屉；「分开填」那枚是抽屉开关）。 */
+export const QUICK_CAPTURE_FORMS = ['oneline', 'drawer'];
+/* ── `data-*` 名（渲染与运行时共用的发现锚） ───────────────────────── */
+/** 根（值＝机器键 `id`）。 */
+export const QUICK_CAPTURE_ATTR = 'data-ilife-quick-capture';
+/** 形态（值是闭集内的那一个键，照实写进标记）。 */
+export const QUICK_CAPTURE_FORM_ATTR = 'data-ilife-quick-capture-form';
+/** 输入框（值＝`id`）：运行时按它认「哪一句话的字变了」。 */
+export const QUICK_CAPTURE_BOX_ATTR = 'data-ilife-quick-capture-box';
+/** 根上：现在写的那一句话（机器读数；输入框里的字是它的另一种摆法，两处一起写）。 */
+export const QUICK_CAPTURE_TEXT_ATTR = 'data-ilife-quick-capture-text';
+/** 一格里的一枚（值＝这一格的机器键）。 */
+export const QUICK_CAPTURE_CELL_ATTR = 'data-ilife-quick-capture-cell';
+/** 这一格现在认成的机器键（运行时改完原地重写它：屏面与机器读数一起翻）。 */
+export const QUICK_CAPTURE_VALUE_ATTR = 'data-ilife-quick-capture-value';
+/** 格里的读数那一格（值＝这一格的机器键；运行时按它原地重写那一串字）。 */
+export const QUICK_CAPTURE_READ_ATTR = 'data-ilife-quick-capture-read';
+/** 某一格的候选带（值＝这一格的机器键）。 */
+export const QUICK_CAPTURE_TRAY_ATTR = 'data-ilife-quick-capture-tray';
+/** 候选带里的一枚候选（值＝这一枚的机器键）。 */
+export const QUICK_CAPTURE_PICK_ATTR = 'data-ilife-quick-capture-pick';
+/** 候选带里那枚「不改」（值＝这一格的机器键）。 */
+export const QUICK_CAPTURE_KEEP_ATTR = 'data-ilife-quick-capture-keep';
+/** 「存」那枚（值＝`id`）。 */
+export const QUICK_CAPTURE_SAVE_ATTR = 'data-ilife-quick-capture-save';
+/** 「分开填」那枚（值＝`id`）。**形态 `drawer` 下它是抽屉开关**：`aria-expanded` 说得出摊开没收起。 */
+export const QUICK_CAPTURE_SPLIT_ATTR = 'data-ilife-quick-capture-split';
+/** 推开的抽屉（值＝`id`；**形态 `drawer` 专属**，常驻收起时 `hidden`）。 */
+export const QUICK_CAPTURE_DRAWER_ATTR = 'data-ilife-quick-capture-drawer';
+/** 记过的一条（值＝`id`；那句话就是这一枚自己的字）。 */
+export const QUICK_CAPTURE_RECALL_ATTR = 'data-ilife-quick-capture-recall';
+/** 记账：这张卡已被运行时段接管（幂等读数，不是开关）。 */
+export const QUICK_CAPTURE_BOUND_ATTR = 'data-ilife-quick-capture-bound';
+/** 幂等开关：挂在 `<html>` 上（重复注入只绑一次）。 */
+export const QUICK_CAPTURE_RUNTIME_ATTR = 'data-ilife-quick-capture-runtime';
+/* ── 事件（冒泡 `CustomEvent`；`detail` 见 README 的「交互契约」） ────── */
+/** 写的那一句话变了（打字，或点了一条记过的）：`detail={id,text}`。
+ *  **页面按它重算解析预览并重渲染**（本件不猜词）：`text` 是新句子的机器读数。 */
+export const QUICK_CAPTURE_EVENT_CHANGE = 'ilife:quick-capture-change';
+/** 某一格改成别的了：`detail={id,key,value,to}`（`key`＝哪一格，`value`＝新机器键，`to`＝新读数）。 */
+export const QUICK_CAPTURE_EVENT_PICK = 'ilife:quick-capture-pick';
+/** 点了「存」：`detail={id,text,cells}`（`cells`＝每一格现在的读数，顺序＝屏上顺序）。本件不写库。 */
+export const QUICK_CAPTURE_EVENT_SAVE = 'ilife:quick-capture-save';
+/** 点了「分开填」：`detail={id,text}`（本件不开表单，开表单归页面）。 */
+export const QUICK_CAPTURE_EVENT_SPLIT = 'ilife:quick-capture-split';
+/* ── 几何与能力（判据与样式段读同一份常量） ─────────────────────── */
+/** 触控地板：每一枚可点件的命中盒不小于这个数（px）。 */
+export const QUICK_CAPTURE_TOUCH_PX = 44;
+/** 相邻触控目标之间的缝（px）：一行里的两颗按钮、格与格、候选与候选都按它让开。 */
+export const QUICK_CAPTURE_GAP_PX = 8;
+/** 本件自己的**容器**名（`@container` 按它命中，不会跟别件的容器串味）。 */
+export const QUICK_CAPTURE_CONTAINER = 'ilife-quick-capture';
+/** 窄档断点（px）：**本件自己**窄于它就把那一行摊开（输入框占满一行，两颗按钮跟着走）。
+ *  这是容器断点，不是视口断点。 */
+export const QUICK_CAPTURE_NARROW_PX = 560;
+/** 抽屉那 6 格走单列的容器宽（px）：本件窄于它就一格一列（两列在一格里放不下读数时，宁可往下排）。
+ *  同样是容器断点。 */
+export const QUICK_CAPTURE_DRAWER_NARROW_PX = 480;
+/** 悬停只许是增强：这一段能力查询**样式段读它**（运行时不抢焦点，不读它）。 */
+export const QUICK_CAPTURE_HOVER_QUERY = '(hover: hover) and (pointer: fine)';
+/** 输入框在窄档下的最小可用宽（px）：比它再窄就整行占满（不让输入框被两颗按钮挤成一道缝）。 */
+export const QUICK_CAPTURE_BOX_MIN_PX = 120;
+/** 一格能改成的那几枚候选：**至少 1 枚、至多 6 枚**（一个都改不了的格不该做成可点件）。 */
+export const QUICK_CAPTURE_MIN_CHOICES = 1;
+export const QUICK_CAPTURE_MAX_CHOICES = 6;
+/** 一句话能拆成几格：**至少 1 格、至多 6 格**。 */
+export const QUICK_CAPTURE_MIN_CELLS = 1;
+export const QUICK_CAPTURE_MAX_CELLS = 6;
+/** 「记过的」最多摆几条（0 条＝不出这一条带）。 */
+export const QUICK_CAPTURE_MAX_RECENT = 4;
+/* ── 形（选中／打开那两档的「形」那一半：不只靠颜色） ─────────────── */
+/** 候选带里现在这一枚前面那枚勾。 */
+export const QUICK_CAPTURE_TICK = '✓';
+/** 候选带里现在这一枚的勾选槽位宽（px）：**未选也留同宽**，一排候选的左右沿才齐平。 */
+export const QUICK_CAPTURE_TICK_PX = 14;
+/** 格尾那枚「改」的高度（px）：它住在整枚按钮里，是**记号不是命中盒**（命中盒＝整枚格 ≥44）。 */
+export const QUICK_CAPTURE_PEN_PX = 32;
+/* ── 文案（缺省的那几句；调用方换句子与格名，这几枚控制字样别换） ─────
+ *
+ *  **屏上只留一层话**：这一份里每一句都是「这一处是什么／这一枚按了会怎样」，
+ *  一句解释性的话都没有（「认错了点那一格改」这类口径由**格上那枚「改」**承担，不由句子承担）。 */
+export const QUICK_CAPTURE_TEXT = Object.freeze({
+    /** 行首那枚小签。 */
+    lead: '随手记',
+    /** 左边是原话、右边是认成的值，中间这一枚（印在左边那一截的末尾：「午饭」＝）。 */
+    eq: '＝',
+    /** 格尾那枚（点它会改这一格）。 */
+    pen: '改',
+    /** 候选带里那枚取消。 */
+    keep: '不改',
+    /** 主按钮。 */
+    save: '存',
+    /** 第二颗按钮。 */
+    split: '分开填',
+    /** 「记过的」那三个字。 */
+    recentLead: '记过的',
+    /** 抽屉标题里那一段连接（「分开填 · 6 格」）：标题＝`split ＋ 这一截 ＋ 格数 ＋ 单位`。 */
+    drawerJoin: ' · ',
+    /** 抽屉标题里的单位（「分开填 · 6 格」）。 */
+    drawerUnit: ' 格',
+    /** 输入框的无障碍名（不上屏）。 */
+    boxLabel: '一句话记一笔',
+    /** 候选带的无障碍名尾巴（不上屏）：`<这一格叫什么>能改成`。 */
+    trayLead: '能改成',
+});
+/** 一格在「认成哪一枚」这件事上的唯一口径：**渲染期标选中态、运行时段翻选中态跑的是同一份源码**
+ *  （`buildQuickCaptureJs()` 把它的 `toString()` 原样嵌进产出的 JS）。
+ *
+ *  故函数体只许读**自己的入参**（不许碰模块作用域里的任何名字），返回命中的那一枚的机器键；
+ *  一枚都不命中＝`''`（这种情形由入参校验挡住，运行时段不做兜底猜谜）。 */
+export function quickCaptureChoiceOn(keys, value) {
+    for (const key of keys) {
+        if (key === value)
+            return key;
+    }
+    return '';
+}
+//# sourceMappingURL=attrs.js.map

package/dist/components/quick-capture/attrs.js.map

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