base-paint 0.3.14 → 0.3.16

package/dist/components/rating-row/runtime.js

@@ -0,0 +1,93 @@
+import { RATING_ROW_BOUND_ATTR, RATING_ROW_EVENT_CHANGE, RATING_ROW_HALF_ATTR, RATING_ROW_LOADING_ATTR, RATING_ROW_MAX_ATTR, RATING_ROW_NAME_ATTR, RATING_ROW_MISSING, RATING_ROW_RUNTIME_ATTR, RATING_ROW_STAR_ATTR, RATING_ROW_VALUE_ATTR, ratingRowSlot, } from './attrs.js';
+/** 换行（仓库口径：不写字面换行转义）。 */
+const LF = String.fromCharCode(10);
+/** rating-row · **运行时**（产出 JS 文本；DOM 只允许出现在这段文本里）。
+ *
+ *  与 `editable-value/runtime.ts` 同一处分工：模块代码零 DOM；DOM 只出现在本文件产出的**字符串**里。
+ *
+ *  行为契约（逐条对应判据）：
+ *   · **委派 ＋ 幂等**：`document` 上一枚 `click` 与一枚 `keydown` 委派；重复注入只绑定一次。
+ *   · **一处写（`paint`）**：`aria-checked`／半颗标记／漫游 `tabindex`／那枚大数字，
+ *     全部由同一趟算出来——四处各写各的必然走散。
+ *   · **点星**：分数＝那一颗的号（整星）；机器值落 `data-ilife-rating-value`；派发 `ilife:rating-change`。
+ *   · **键盘**（`role="radio"` 该有的那一套）：左右／上下移动并**随即选中**、`Home` 到第一颗、`End` 到最后一颗；
+ *     方向键 `preventDefault`（否则页面会跟着滚）。
+ *   · **不评就是没评**：清空要由页面重渲染（本件不给"点已选中的星取消"这种隐藏手势——
+ *     隐藏手势没人发现得了，值为 `null` 的入口在入参面）。
+ *   · **禁用／加载不响应**：根上有标记时点了不派发（按钮自己也落 `disabled`）。
+ *   · **无脚本降级**：这段不跑时，星与读数按标记里画好的那一份显示（可读），只是不能改。
+ */
+export function buildRatingRowJs() {
+    const q = (s) => JSON.stringify(s);
+    return '(function(){' + LF
+        + '  var ATTR_NAME=' + q(RATING_ROW_NAME_ATTR) + ', ATTR_VALUE=' + q(RATING_ROW_VALUE_ATTR) + ';' + LF
+        + '  var ATTR_MAX=' + q(RATING_ROW_MAX_ATTR) + ', ATTR_STAR=' + q(RATING_ROW_STAR_ATTR) + ';' + LF
+        + '  var ATTR_LOADING=' + q(RATING_ROW_LOADING_ATTR) + ', ATTR_BOUND=' + q(RATING_ROW_BOUND_ATTR) + ';' + LF
+        + '  var ATTR_HALF=' + q(RATING_ROW_HALF_ATTR) + ', ATTR_RUNTIME=' + q(RATING_ROW_RUNTIME_ATTR) + ';' + LF
+        + '  var EV=' + q(RATING_ROW_EVENT_CHANGE) + ';' + LF
+        + '  var SEL_NUM=' + q(ratingRowSlot('num')) + ', MISSING=' + q(RATING_ROW_MISSING) + ';' + LF
+        + '  var doc=document;' + LF
+        + '  if (doc.documentElement.getAttribute(ATTR_RUNTIME)==="1") return;' + LF
+        + '  doc.documentElement.setAttribute(ATTR_RUNTIME,"1");' + LF
+        + '  function rootOf(el){ return el && el.closest ? el.closest("["+ATTR_NAME+"]") : null; }' + LF
+        + '  function starsOf(root){ return root.querySelectorAll("button["+ATTR_STAR+"]"); }' + LF
+        + '  function valueOf(root){' + LF
+        + '    var raw=root.getAttribute(ATTR_VALUE);' + LF
+        + '    if (raw===null || raw==="") return null;' + LF
+        + '    var n=Number(raw); return isFinite(n) ? n : null;' + LF
+        + '  }' + LF
+        /* 一处写：分数 → 星的三态（`aria-checked` ＋ 半颗标记）＋ 漫游焦点 ＋ 那枚大数字。
+           状态只写这两处，不挂 `is-on`／`is-half` 这类修饰类：短类名会与别件撞名。 */
+        + '  function paint(root, value){' + LF
+        + '    var stars=starsOf(root), i, n=null;' + LF
+        + '    var focusAt = value===null ? 1 : Math.max(1, Math.ceil(value));' + LF
+        + '    for (i=0;i<stars.length;i+=1){' + LF
+        + '      n=Number(stars[i].getAttribute(ATTR_STAR));' + LF
+        + '      var on = value!==null && n<=value;' + LF
+        + '      var half = !on && value!==null && (n-0.5)<=value;' + LF
+        + '      stars[i].setAttribute("aria-checked", on ? "true" : "false");' + LF
+        + '      if (half) stars[i].setAttribute(ATTR_HALF,"1"); else stars[i].removeAttribute(ATTR_HALF);' + LF
+        + '      stars[i].setAttribute("tabindex", n===focusAt ? "0" : "-1");' + LF
+        + '    }' + LF
+        + '    if (value===null) root.removeAttribute(ATTR_VALUE); else root.setAttribute(ATTR_VALUE, String(value));' + LF
+        + '    var num=root.querySelector("."+SEL_NUM);' + LF
+        + '    if (num) num.textContent = value===null ? MISSING : String(value);' + LF
+        + '  }' + LF
+        + '  function pick(root, star, why){' + LF
+        + '    if (root.getAttribute(ATTR_LOADING)==="1") return;' + LF
+        + '    var prev=valueOf(root);' + LF
+        + '    if (prev===star) return;' + LF
+        + '    paint(root, star);' + LF
+        + '    var focus=root.querySelector("button["+ATTR_STAR+"=\\""+star+"\\"]"); if (focus && why==="key") focus.focus();' + LF
+        + '    root.dispatchEvent(new CustomEvent(EV,{bubbles:true,detail:{' + LF
+        + '      name:root.getAttribute(ATTR_NAME), value:star, prev:prev}}));' + LF
+        + '  }' + LF
+        + '  function starOf(el){' + LF
+        + '    if (!el || !el.closest) return null;' + LF
+        + '    var b=el.closest("button["+ATTR_STAR+"]"); return b && !b.disabled ? b : null;' + LF
+        + '  }' + LF
+        + '  doc.addEventListener("click", function(e){' + LF
+        + '    var btn=starOf(e.target); if (!btn) return;' + LF
+        + '    var root=rootOf(btn); if (!root) return;' + LF
+        + '    e.preventDefault();' + LF
+        + '    pick(root, Number(btn.getAttribute(ATTR_STAR)), "click");' + LF
+        + '  });' + LF
+        + '  doc.addEventListener("keydown", function(e){' + LF
+        + '    var btn=starOf(e.target); if (!btn) return;' + LF
+        + '    var root=rootOf(btn); if (!root) return;' + LF
+        + '    var max=Number(root.getAttribute(ATTR_MAX)||starsOf(root).length);' + LF
+        + '    var at=Number(btn.getAttribute(ATTR_STAR)), next=null;' + LF
+        + '    if (e.key==="ArrowRight" || e.key==="ArrowDown") next=Math.min(max, at+1);' + LF
+        + '    else if (e.key==="ArrowLeft" || e.key==="ArrowUp") next=Math.max(1, at-1);' + LF
+        + '    else if (e.key==="Home") next=1;' + LF
+        + '    else if (e.key==="End") next=max;' + LF
+        + '    else return;' + LF
+        + '    e.preventDefault();' + LF
+        + '    pick(root, next, "key");' + LF
+        + '  });' + LF
+        /* init 那一趟：打绑定标记 ＋ 按标记里那一份机器值把三态与读数收敛到一处。 */
+        + '  var all=doc.querySelectorAll("["+ATTR_NAME+"]");' + LF
+        + '  for (var i=0;i<all.length;i+=1){ all[i].setAttribute(ATTR_BOUND,"1"); paint(all[i], valueOf(all[i])); }' + LF
+        + '}());';
+}
+//# sourceMappingURL=runtime.js.map

package/dist/components/rating-row/runtime.js.map

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

package/dist/components/rating-row/style.d.ts

@@ -0,0 +1,13 @@
+/** 一颗星的命中盒（px）：**触控目标的地板**，全宽口径（视觉上的星形可以小，盒子必须够）。 */
+export declare const RATING_ROW_STAR_PX = 44;
+/** 星字形的字号（px）：盒子 44 里放 26 的字形，指头按下去有富余。 */
+export declare const RATING_ROW_STAR_FONT_PX = 26;
+/** 那枚数字读数的倍数（相对皮肤 `fs-body`）：三套皮肤下都 ≥ 正文的 1.5 倍。 */
+export declare const RATING_ROW_NUM_SCALE = 2.2;
+/** 窄容器阈值（px）：读数改走「另起一行、左对齐」。**判的是本件自己的宽度**。 */
+export declare const RATING_ROW_NARROW_PX = 420;
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export declare function ratingRowCss(input?: {
+    readonly prefix?: string;
+}): string;
+//# sourceMappingURL=style.d.ts.map

package/dist/components/rating-row/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../../src/components/rating-row/style.ts"],"names":[],"mappings":"AAwBA,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,2CAA2C;AAC3C,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,oDAAoD;AACpD,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,+CAA+C;AAC/C,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,4BAA4B;AAC5B,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CA2MzE"}

package/dist/components/rating-row/style.js

@@ -0,0 +1,235 @@
+/** rating-row · **样式段**（本件唯一的样式来源）。
+ *
+ *  纪律（与本节其余件同一份）：
+ *   · 只经 `skinVar()` 读皮肤——组件里**不写**手写的 CSS 变量（兜底链只许住在 `skin/contract.ts`）；
+ *   · 全部规则 scope 在 `.<prefix>page-ui` 之下；不写 `:root`／`!important`、不新增 token 名；
+ *   · **宽度只许容器判**：本件自己是容器（`container-type: inline-size`），窄档调整走 `@container`；
+ *     `@media` 只判设备能力，不判宽度。
+ *
+ *  几何契约（判据钉住）：
+ *   · 每颗星是**可聚焦的按钮**，命中盒 44×44（`RATING_ROW_STAR_PX`）；
+ *   · 那枚数字读数是**大字号**：＝ 正文档 × `RATING_ROW_NUM_SCALE`（皮肤只给 `fs-body` 一档 ⇒
+ *     三套皮肤下都成立「读数 ≥ 正文 1.5 倍」），且走等宽数字（数位一变宽就跳版）；
+ *   · 选中态**至少两重标记**：空心星 `☆` → 实心星 `★`（字形换了）＋ 那枚大数字（字）；
+ *     颜色只是第三重。皮肤「大字报刊」下强调色＝墨黑 ⇒ 前两重必须自己扛。
+ *   · 颜色这一重按**法则表**走：已填满的星＝**无文字的点状选中** ⇒ 主色实底（`accent` 填满这枚字形，
+ *     不是"反白"、也不是正文墨色）；未填满的星仍是弱文字墨色 `ink-3`。
+ *     口径住 `docs/base/base-render/选中态与皮肤语言.md` 第三、四节。
+ */
+import { skinVar } from '../skin/contract.js';
+import { RATING_ROW_HALF_ATTR, ratingRowSlot } from './attrs.js';
+/** 换行（仓库口径：不写字面换行转义）。 */
+const LF = String.fromCharCode(10);
+/** 一颗星的命中盒（px）：**触控目标的地板**，全宽口径（视觉上的星形可以小，盒子必须够）。 */
+export const RATING_ROW_STAR_PX = 44;
+/** 星字形的字号（px）：盒子 44 里放 26 的字形，指头按下去有富余。 */
+export const RATING_ROW_STAR_FONT_PX = 26;
+/** 那枚数字读数的倍数（相对皮肤 `fs-body`）：三套皮肤下都 ≥ 正文的 1.5 倍。 */
+export const RATING_ROW_NUM_SCALE = 2.2;
+/** 窄容器阈值（px）：读数改走「另起一行、左对齐」。**判的是本件自己的宽度**。 */
+export const RATING_ROW_NARROW_PX = 420;
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export function ratingRowCss(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-rating-row';
+    const s = (slot) => root + ' .' + ratingRowSlot(slot, p);
+    /** **裸类名**：用在复合选择器的中段（`X > .槽`）。
+     *  `s()` 自带作用域前缀，只许当选择器的**开头**——把它接在 `>` 后面会拼出
+     *  `.ilife-page-ui X > .ilife-page-ui .槽`，那种规则永远匹配不到
+     *  （2026-09 实拍：实心星一个都没画出来，就是这一处拼错）。 */
+    const c = (slot) => '.' + ratingRowSlot(slot, p);
+    const star = s('star');
+    return [
+        '/* rating-row（评分行 · 形态 A「星级 ＋ 数字读数」）：星星读"大约几颗"，那枚大数字读"到底几分"。',
+        '   层次不靠阴影与大圆角（小票纸零阴影、大字报刊零圆角）：靠发丝线、字重与尺度差 ⇒ 换皮只换取值。 */',
+        box + ' {',
+        /* 宽度判据的落点：本件是**自己的容器**——嵌进侧栏／面板／卡片时照样按自己的宽度折行。 */
+        '  container-type: inline-size;',
+        '  display: grid;',
+        '  gap: 8px;',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font') + ';',
+        '  font-size: ' + skinVar('fs-body') + ';',
+        '  line-height: 1.5;',
+        '}',
+        '/* 标题行：给什么打分（主段）＋ 上次对照（次段）。两段都能换行——**不许 `…` 截断**。 */',
+        s('label') + ' {',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  align-items: baseline;',
+        '  gap: 4px 10px;',
+        '  margin: 0;',
+        '  min-width: 0;',
+        '}',
+        s('label-title') + ' {',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-weight: 700;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        s('prev') + ' {',
+        '  margin-left: auto;',
+        '  color: ' + skinVar('ink-3') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  font-variant-numeric: tabular-nums;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* 星与读数并成的那一排：容器一窄，读数自己折到下一行（不压星星、不掉字）。 */',
+        s('body') + ' {',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  align-items: center;',
+        '  gap: 4px 14px;',
+        '  min-width: 0;',
+        '}',
+        s('stars') + ' {',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  gap: 0;',
+        '  min-width: 0;',
+        '}',
+        '/* 一颗星：命中盒 44×44（可聚焦的按钮），字形比盒小一圈。 */',
+        star + ' {',
+        '  position: relative;',
+        '  display: flex;',
+        '  align-items: center;',
+        '  justify-content: center;',
+        '  box-sizing: border-box;',
+        '  width: ' + String(RATING_ROW_STAR_PX) + 'px;',
+        '  height: ' + String(RATING_ROW_STAR_PX) + 'px;',
+        '  margin: 0;',
+        '  padding: 0;',
+        '  border: 0;',
+        '  border-radius: ' + skinVar('radius-sm') + ';',
+        '  background: transparent;',
+        '  color: ' + skinVar('ink-3') + ';',
+        '  font: inherit;',
+        '  font-size: ' + String(RATING_ROW_STAR_FONT_PX) + 'px;',
+        '  line-height: 1;',
+        '  cursor: pointer;',
+        '  transition: transform 80ms cubic-bezier(.22, 1, .36, 1);',
+        '}',
+        '/* 星字形：空的是空心星 `☆`，实心的是实心星 `★`——**形状换了**，不只是颜色换了。',
+        '   判"填满了"走 `aria-checked="true"`（这一件每颗星本来就带它），不另挂 `is-on` 这类修饰类。 */',
+        s('glyph') + '::before {',
+        '  content: "\\2606";',
+        '}',
+        star + '[aria-checked="true"] {',
+        '  /* 无文字的点状选中 ⇒ 主色实底：`accent` 把这枚字形填满（图形对比 ≥3:1 即可，不需要字色反白）。 */',
+        '  color: ' + skinVar('accent') + ';',
+        '}',
+        star + '[aria-checked="true"] > ' + c('glyph') + '::before {',
+        '  content: "\\2605";',
+        '}',
+        '/* 半颗（小数分值的显示）：左半实心、右半仍是空心——形状上看得出来"4.5 不是 4"。',
+        '   半颗只由 `data-*` 标记（挂在这颗星上），因为"左半边"这件事没有对应的原生状态。 */',
+        star + '[' + RATING_ROW_HALF_ATTR + '="1"] {',
+        '  color: ' + skinVar('ink-3') + ';',
+        '}',
+        star + '[' + RATING_ROW_HALF_ATTR + '="1"] > ' + c('glyph') + ' {',
+        '  position: relative;',
+        '  display: block;',
+        '}',
+        star + '[' + RATING_ROW_HALF_ATTR + '="1"] > ' + c('glyph') + '::after {',
+        '  content: "\\2605";',
+        '  position: absolute;',
+        '  left: 0;',
+        '  top: 0;',
+        '  width: 50%;',
+        '  overflow: hidden;',
+        '  color: ' + skinVar('accent') + ';',
+        '}',
+        '/* 鼠标悬停只是**提示**，不是唯一通路（选中态与焦点各有自己的标记）。',
+        '   提示只给**未填满**的星：已填满的星是"无文字的点状选中"，走主色实底（`accent` 填字形），',
+        '   若被 `ink-2` 顶掉，悬停那一刻选中态就掉回正文墨色（口径见 `选中态与皮肤语言.md` 第三节）。 */',
+        '@media (hover: hover) and (pointer: fine) {',
+        '  ' + star + ':not([aria-checked="true"]):not([disabled]):hover {',
+        '    color: ' + skinVar('ink-2') + ';',
+        '  }',
+        '}',
+        '/* 真按下：缩一格（≤80ms 内回弹；只动 transform，不触发布局）。 */',
+        star + ':active {',
+        '  transform: scale(.98);',
+        '}',
+        '/* 焦点：**可见焦点**（≥2px），键盘走到哪一颗就看得见哪一颗。 */',
+        star + ':focus-visible {',
+        '  outline: 2px solid ' + skinVar('accent') + ';',
+        '  outline-offset: -2px;',
+        '}',
+        '/* 不可评：`cursor: not-allowed` ＋ 说明为什么（原因那句由标记渲染在 `why` 槽里）。 */',
+        star + '[disabled] {',
+        '  cursor: not-allowed;',
+        '}',
+        '/* 数字读数：星星之外的**那一重**（读得出 4 与 4.5 的差别）。等宽数字 ＋ 大字号。 */',
+        s('score') + ' {',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  align-items: baseline;',
+        '  gap: 2px 6px;',
+        '  margin: 0 0 0 auto;',
+        '  min-width: 0;',
+        '}',
+        s('num') + ' {',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font-num') + ';',
+        '  font-size: calc(' + skinVar('fs-body') + ' * ' + String(RATING_ROW_NUM_SCALE) + ');',
+        '  font-weight: 700;',
+        /* `line-height` 必须比 1 宽一点：数字字形（衬线皮肤下更明显）会顶出行盒，
+           实拍 35.2px 字号 `line-height:1` 时 content 盒只有 35px、字形 37px ⇒ 被裁。 */
+        '  line-height: 1.15;',
+        '  letter-spacing: -.02em;',
+        '  font-variant-numeric: tabular-nums;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        s('den') + ' {',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-size: ' + skinVar('fs-sm') + ';',
+        '  font-weight: 600;',
+        '  font-variant-numeric: tabular-nums;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        s('hint') + ' {',
+        '  color: ' + skinVar('ink-3') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* 禁用原因：写在控件旁边（不只 `cursor: not-allowed`）。 */',
+        s('why') + ' {',
+        '  margin: 0;',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* 错态：写在控件旁边（不是只染色），并带一枚记号字。 */',
+        s('error') + ' {',
+        '  display: flex;',
+        '  gap: 6px;',
+        '  margin: 0;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-size: ' + skinVar('fs-sm') + ';',
+        '  font-weight: 600;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        s('error') + '::before {',
+        '  content: "\\26A0";',
+        '  flex: none;',
+        '  color: ' + skinVar('ink-2') + ';',
+        '}',
+        '/* 窄容器（<' + String(RATING_ROW_NARROW_PX) + 'px）：读数另起一行、左对齐（不再与星星挤一排）。',
+        '   判的是**本件自己的宽度**：本件会被嵌进侧栏／面板／卡片，视口宽 ≠ 组件宽（所以这里不用 `@media`）。 */',
+        '@container (max-width: ' + String(RATING_ROW_NARROW_PX) + 'px) {',
+        '  ' + s('score') + ' {',
+        '    margin-left: 0;',
+        '  }',
+        '}',
+        '/* 动效偏好：只关过渡，不关状态（状态不许卡在半路 ⇒ 不用 `transitionend` 驱动任何东西）。 */',
+        '@media (prefers-reduced-motion: reduce) {',
+        '  ' + star + ' {',
+        '    transition: none;',
+        '  }',
+        '}',
+    ].join(LF);
+}
+//# sourceMappingURL=style.js.map

package/dist/components/rating-row/style.js.map

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

package/dist/components/relation-picker/attrs.d.ts

@@ -0,0 +1,196 @@
+/** relation-picker · **标记契约**（渲染与运行时共用的唯一事实：类名／槽位／`data-*`／事件名／闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/新件/parts-交互与流程.mjs` 第 90 件，2026-09 用户裁定）
+ *  里**两档都过**的两个形态：
+ *   · **形态 `overlay`「浮层选一个」**（原型 A）：字段行一枚看得见的触发键，点开是一块顶层浮面——
+ *     搜一行 ＋「最近用过」一组 ＋「全部」一组 ＋ 末行「新建」；
+ *   · **形态 `inline`「行内展开选一个」**（原型 B）：不浮层，整块就在字段行下面推开——先选源
+ *     （最近一排 ＋ 可搜的列表 ＋ 末行「新建」），选完收成一行读得出的结果（✓ ＋ 选了什么 ＋ 一枚真按钮「换」）。
+ *  两档共用同一份选项表：`inline` 就是把 `overlay` 浮面里的那三组搬进行内。
+ *
+ *  它替掉的两种错法（原型墙那一格的原文）：①「下拉里几十个按拼音排，最常用的每次都得滚」；
+ *  ②「库里还没有的时候只能退出去先建好再回来选」。
+ *
+ *  **零键盘通路**：选一个实体**必须能用手点做完**——搜索框可打字，但每一行都是整行可点的 `<button>`，
+ *  不点键盘也选得完；标记与文案里没有一处键帽／键名／方向键（`:focus-visible` 只留给真实键盘用户，是地板不是通路）。
+ *
+ *  **形态键写在 `RELATION_PICKER_FORMS` 闭集**（`overlay`／`inline`，两个都是英文键，不许用 A/B 当键）；
+ *  闭集外的值一律 `badInput`（不静默降级：降级会让调用方以为自己拿到了另一种骨架）。
+ */
+/** 本件的类名根：全部槽位类名都是 `RELATION_PICKER_CLASS + '-' + 槽名`。 */
+export declare const RELATION_PICKER_CLASS = "ilife-block-relation-picker";
+/** 槽位闭集（标记契约的一部分：`render.ts`／`style.ts`／`runtime.ts` 与判据都用这里的名字拼类名）。 */
+export declare const RELATION_PICKER_SLOTS: readonly ["field", "label", "state", "box", "value", "caret", "panel", "inline", "in", "q", "clear", "colh", "col", "colr", "grp", "rows", "row", "mk", "tx", "name", "note", "reading", "pick", "hit", "quick", "chip", "tag", "gh", "count", "list", "new", "newlabel", "create", "empty", "foot", "err", "chosen", "tick", "result", "why", "change", "hint"];
+export type RelationPickerSlot = (typeof RELATION_PICKER_SLOTS)[number];
+/** 槽类的类名（唯一拼法：别处不许再写 `RELATION_PICKER_CLASS + '-' + …`）。 */
+export declare function relationPickerSlot(slot: RelationPickerSlot, prefix?: string): string;
+/** 形态闭集：`overlay`「浮层选一个」（原型 A）／`inline`「行内展开选一个」（原型 B）。 */
+export declare const RELATION_PICKER_FORMS: readonly ["overlay", "inline"];
+export type RelationPickerForm = (typeof RELATION_PICKER_FORMS)[number];
+/** 根（值＝机器键 `id`）。 */
+export declare const RELATION_PICKER_ATTR = "data-ilife-relation-picker";
+/** 形态（值是闭集内的那一个键，照实写进标记）。 */
+export declare const RELATION_PICKER_FORM_ATTR = "data-ilife-relation-form";
+/** 触发键（值＝`id`）：`overlay` 下运行时按它同步 `aria-expanded`。 */
+export declare const RELATION_PICKER_OPEN_ATTR = "data-ilife-relation-open";
+/** 浮面（值＝`id`；`overlay` 下是 `popover` 的 `id`）。 */
+export declare const RELATION_PICKER_PANEL_ATTR = "data-ilife-relation-panel";
+/** 行内那一块（值＝`id`）。 */
+export declare const RELATION_PICKER_INLINE_ATTR = "data-ilife-relation-inline";
+/** 搜索输入框（值＝`id`）。 */
+export declare const RELATION_PICKER_QUERY_ATTR = "data-ilife-relation-query";
+/** 清空搜索那枚键（值＝`id`）。 */
+export declare const RELATION_PICKER_CLEAR_ATTR = "data-ilife-relation-clear";
+/** 一行选项（值＝这一行的机器键）。 */
+export declare const RELATION_PICKER_ITEM_ATTR = "data-ilife-relation-item";
+/** 一行的**可搜底串**（小写；输入框里打的词在它里面找子串）。 */
+export declare const RELATION_PICKER_SEARCH_ATTR = "data-ilife-relation-search";
+/** 行的名字格（运行时按它重画命中词；它的 `textContent` 就是这一行的名字）。 */
+export declare const RELATION_PICKER_NAME_ATTR = "data-ilife-relation-name";
+/** 「最近用过」组里的那一行（值 `1`）。 */
+export declare const RELATION_PICKER_RECENT_ATTR = "data-ilife-relation-recent";
+/** 分组标题（值＝`recent`／`all`）。 */
+export declare const RELATION_PICKER_GROUP_ATTR = "data-ilife-relation-group";
+/** 空态那一行（值＝`id`）。 */
+export declare const RELATION_PICKER_EMPTY_ATTR = "data-ilife-relation-empty";
+/** 脚注行（值＝`id`）。 */
+export declare const RELATION_PICKER_FOOT_ATTR = "data-ilife-relation-foot";
+/** 命中词（`<mark>`，值 `1`）。 */
+export declare const RELATION_PICKER_HIT_ATTR = "data-ilife-relation-hit";
+/** 新建那枚键（值＝当前搜索词：点它就是把这个词建成新的）。 */
+export declare const RELATION_PICKER_CREATE_ATTR = "data-ilife-relation-create";
+/** 字段行里读当前值的那一格（运行时选中一变就重写它）。 */
+export declare const RELATION_PICKER_VALUE_ATTR = "data-ilife-relation-value";
+/** 选完那一行结果（值＝`id`；只在 `inline` 下有）。 */
+export declare const RELATION_PICKER_CHOSEN_ATTR = "data-ilife-relation-chosen";
+/** 「换」那枚键（值＝`id`：重新摊开行内那一块）。 */
+export declare const RELATION_PICKER_CHANGE_ATTR = "data-ilife-relation-change";
+/** 记账：这枚触发键已被运行时段接管（幂等读数，不是开关）。 */
+export declare const RELATION_PICKER_BOUND_ATTR = "data-ilife-relation-bound";
+/** 幂等开关：挂在 `<html>` 上（重复注入只绑一次）。 */
+export declare const RELATION_PICKER_RUNTIME_ATTR = "data-ilife-relation-runtime";
+/** 选中一行：`detail={id,key,title}`；`overlay` 下浮面此时已收起，`inline` 下行内那块已收成结果行。 */
+export declare const RELATION_PICKER_EVENT_SELECT = "ilife:relation-picker-select";
+/** 点了新建：`detail={id,value}`（`value`＝当前搜索词；本件不写库，只报「要建什么」）。 */
+export declare const RELATION_PICKER_EVENT_CREATE = "ilife:relation-picker-create";
+/** 输入即筛之后报一次真读数：`detail={id,query,hits}`（hits＝现在露着的行数）。 */
+export declare const RELATION_PICKER_EVENT_QUERY = "ilife:relation-picker-query";
+/** 触控地板：命中盒不小于这个数（px）。 */
+export declare const RELATION_PICKER_TOUCH_PX = 44;
+/** 一行选项的高度下限（px）：整行是命中区，比地板再宽裕一档。 */
+export declare const RELATION_PICKER_ROW_MIN_PX = 52;
+/** 相邻触控目标的缝（px）：行与行之间、独立控件之间都按它让开。 */
+export declare const RELATION_PICKER_GAP_PX = 8;
+/** 字段行与浮面的宽上限（px）：宽档下也不铺满屏（浮面是浮面，不是整页）。 */
+export declare const RELATION_PICKER_PANEL_MAX_PX = 460;
+/** 浮面离屏边至少留多少（px）。 */
+export declare const RELATION_PICKER_EDGE_PX = 14;
+/** 本件自己的**容器**名（`@container` 按它命中，不会跟别件的容器串味）。 */
+export declare const RELATION_PICKER_CONTAINER = "ilife-relation-picker";
+/** 窄档断点（px）：**本件自己**窄于它就收行内左右内边距与那两道缝。这是容器断点，不是视口断点。 */
+export declare const RELATION_PICKER_NARROW_PX = 560;
+/** 悬停只许是增强：这一段能力查询**样式段与运行时读同一个串**（两边必须说同一件事）。 */
+export declare const RELATION_PICKER_HOVER_QUERY = "(hover: hover) and (pointer: fine)";
+/** 浮面贴触发键的两条能力查询：**样式段与运行时段读同一个串**（两边对「这个引擎支不支持」必须说同一件事）。
+ *  支持 ⇒ CSS 锚定定位（`position-area` 贴触发键下沿，贴不下翻上去）；不支持 ⇒ 打开时运行时按触发键
+ *  的矩形算 `left`／`top`。口径同 `popover-menu`（`MENU_ANCHOR_QUERY`／`MENU_AREA_QUERY`）。 */
+export declare const RELATION_PICKER_ANCHOR_QUERY = "anchor-name: --a";
+export declare const RELATION_PICKER_AREA_QUERY = "position-area: bottom";
+/** 逐实例锚名的前缀（完整名＝前缀 ＋ 入参 `id`）：触发键写 `anchor-name`、浮面写 `position-anchor`，
+ *  两处写**同一个**名字——静态 CSS 认不出逐实例的名字（同 `popover-menu` 的 `--ilife-menu-<id>`）。 */
+export declare const RELATION_PICKER_ANCHOR_PREFIX = "--ilife-relation-picker-";
+/** 缺省文案与状态句（渲染期与运行时段**读同一份**，免得两处各写一句）。 */
+export declare const RELATION_PICKER_TEXT: Readonly<{
+    /** 还没选中时触发键里读的那一句。 */
+    readonly unpicked: "还没选";
+    /** 字段标签后面那句状态：正在选／已选。**选中一变这一句也要跟着换**——字段行读的是同一份事实
+     *  （运行时段里它跟值那一格一起重写；不然「已选的那一项」旁边还写着「正在选」）。 */
+    readonly stateLead: "— ";
+    readonly picking: "正在选";
+    readonly picked: "已选";
+    /** 分组标题两枚。 */
+    readonly recentGroup: "最近用过";
+    readonly allGroup: "全部";
+    /** 行尾那一枚：选中的写「已选」、其余写「选它」。 */
+    readonly pickedTag: "已选";
+    readonly pickTag: "选它";
+    /** 触发键右端那枚记号。 */
+    readonly caret: "▾";
+    /** 选中记号：✓ 选中／○ 没选。
+     *  未选态原来写中点 `·`（U+00B7）——那正是仓库分隔符门的 R1 命中（可见文本零豁免），
+     *  与 README 契约 13 自己写的「不出现 `·`」矛盾（2026-09 对抗审查读出：overlay 节点级 4 处／
+     *  inline 2 处，`separator-probe` exit=1）。改成空圆环 `○`：与 `radio-cards`／`wizard-shell` 的
+     *  「空圆环（未选）」、`goal-stairs` 的「还没开始 ○」同一套形语汇，且不是分隔符。 */
+    readonly tick: "✓";
+    readonly dot: "○";
+    /** 清空搜索那枚键的无障碍名（键上写的是 ✕）。 */
+    readonly clear: "清空搜索";
+    /** 末行新建排前面那句。 */
+    readonly newPrefix: "没找到？";
+    /** 新建那枚键的字（中间夹着当前搜索词；搜索词为空时退成下一句）。 */
+    readonly createPre: "新建「";
+    readonly createPost: "」";
+    readonly createEmpty: "新建一个";
+    /** 「换」那枚键的字。 */
+    readonly change: "换";
+    /** 选完那一行结果的前缀（运行时重写结果行时带上它，不丢「选好了」三字）。 */
+    readonly chosenPre: "选好了";
+    /** 空态：没有一条命中时写的那句话（中间夹着用户打的词）。 */
+    readonly emptyPre: "没有找到与「";
+    readonly emptyPost: "」相关的，去末行新建一个。";
+    /** 脚注三档：空输入列常用去处／命中几条／一条没中。 */
+    readonly footIdle: "「最近用过」排最前，点任意一行就选好。";
+    /** 没有 `recentKeys`（屏上没有「最近用过」这一组）时，空输入那一档的脚注。
+     *  **脚注跟着实际分区走**：缺了这一组还写「排最前」，就是一句屏上兑不出来的空许诺
+     *  （2026-09 对抗审查读出：无 `recentKeys` 的实例脚注仍写「「最近用过」排最前」，而分组只有 `all`）。 */
+    readonly footIdlePlain: "全部都在下面，点任意一行就选好。";
+    readonly footHitPre: "命中 ";
+    readonly footHitPost: " 条，点任意一行就选好。";
+    readonly footNone: "换个短一点的词试试，搜不到就去末行新建。";
+}>;
+/** 一个可选的实体（库里已经存在的那一个）。 */
+export interface RelationPickerOption {
+    /** 机器键（点这一行时原样送出）。**非空、只许标识符字符**，表内唯一。 */
+    readonly key: string;
+    /** 名字（如「招行储蓄卡」）。**非空**；命中词在这里标出来；许换行、不许 `…` 截断。 */
+    readonly title: string;
+    /** 副语（一行一句人话，如「上次 09-24，记了 3 笔」）。**这一串由调用方给**：本件自己的记号与文案
+     *  一律过仓库分隔符门（README 契约 13），调用方塞进来的 `·`／`；` 由调用方负责。 */
+    readonly note?: string;
+    /** 行右端读数（余额／件数，**已经是给人看的样子**：取整与千分位归调用方）。**永不 `…` 截断**。 */
+    readonly reading?: string;
+}
+/** 关系选择器入参。`id`／`label`／`options` 三样必填——没有 `id`，浮面的 `id` 与触发键就接不上。 */
+export interface RelationPickerInput {
+    /** 机器键（浮面 `id`、行内 `id` 与事件 `detail.id` 都拿它拼）。**非空、同页唯一、只许标识符字符**。 */
+    readonly id: string;
+    /** 字段标签（如「账户」／「物品放在哪儿」）。**非空**。 */
+    readonly label: string;
+    /** 全部选项（顺序＝「全部」组里的顺序；**至少一项**）。 */
+    readonly options: readonly RelationPickerOption[];
+    /** 「最近用过」那几项的机器键（子集，**至多 6 项**；顺序＝屏上顺序）。不给＝不出这一组。 */
+    readonly recentKeys?: readonly string[];
+    /** 当前选中的机器键（必须命中一项；给了＝字段行读它的名字、列表里那一行是选中态）。 */
+    readonly selectedKey?: string;
+    /** 搜索框里的初值（渲染期就按它筛一遍；不给＝空，列出全部）。首尾空白一律去掉。 */
+    readonly query?: string;
+    /** 「全部」组名的字（缺省按 `label` 拼：如「全部账户」；给了就用调用方的）。 */
+    readonly allLabel?: string;
+    /** 读数列的列头（缺省不出列头行；如「余额」）。给了＝`overlay` 下出列头行。 */
+    readonly readingLabel?: string;
+    /** 末行新建排前面那句（缺省「没找到？」）。 */
+    readonly newPrefix?: string;
+    /** 空态那句的定制版（不给就按搜索词现拼）。 */
+    readonly emptyText?: string;
+    /** 卡底那句提示。 */
+    readonly hint?: string;
+    /** 错态（写在输入框下边的那一句；给了就出这一行）。 */
+    readonly error?: string;
+    /** 行内那一块渲染时就摊开（只在 `inline` 下有意义；选中有值时缺省收起，给 `true`＝硬摊开）。 */
+    readonly open?: boolean;
+    /** 形态键（闭集，缺省 `overlay`）。 */
+    readonly form?: RelationPickerForm;
+    /** 附加类名（空格分隔；逐个过类名正则）。 */
+    readonly extraClass?: string;
+}
+//# sourceMappingURL=attrs.d.ts.map

package/dist/components/relation-picker/attrs.d.ts.map

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