base-paint 0.3.13 → 0.3.15

package/dist/components/scatter-fit/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../../src/components/scatter-fit/style.ts"],"names":[],"mappings":"AAsBA,qDAAqD;AACrD,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAIvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAMtD,4BAA4B;AAC5B,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAmP1E"}

package/dist/components/scatter-fit/style.js

@@ -0,0 +1,272 @@
+/** scatter-fit · **样式段**（本件唯一的样式来源；分箱段与滞后段在 `style-forms.ts`，由这里汇总）。
+ *
+ *  纪律（与本节其余件同一份）：
+ *   · 只经 `skinVar()` 读皮肤 —— 组件里**不写** `var(--ilife-…)`（兜底链只许住在 `skin/contract.ts`）；
+ *   · 全部规则 scope 在 `.<prefix>page-ui` 之下（不开本配方页零命中）；不写 `:root`／`!important`、不新增 token 名；
+ *   · **宽度只许容器判**：布局靠 `@container` ＋ 内在尺寸 ＋ 纯 CSS 等分；本件不写任何 `@media`（视口宽 ≠ 组件宽）。
+ *
+ *  几何契约（判据钉住）：
+ *   · **点阵区不留横滑**：坐标框是「纵轴刻度列（`max-content`）＋ 图区（`minmax(0,1fr)`）」两列，
+ *     点的坐标是**算出来的百分比**（`forms.ts` 把数据映射到 3%…97%，点的半径再大也不跑出框）；
+ *   · **色都从强调色系出**：点与线是 `accent` 实底（无文字的图形），概率带是强调色的**淡洗**
+ *     （`color-mix` 往卡面掺），离群点是"圈出"的环（形），**任何一处都不拿 `ink`／`ink-2`／`ink-3` 当面**
+ *     （那三支只做字）。换皮只换取值，色序不写死。
+ *   · 分箱段与滞后段见 `style-forms.ts`（同一份纪律；搬走的是行数，不是取值）。
+ */
+import { skinVar } from '../skin/contract.js';
+import { SCATTER_FIT_NARROW_PX, scatterFitSlot } from './attrs.js';
+import { scatterFitFormsCss } from './style-forms.js';
+/** 换行（仓库口径：不写字面换行转义）。 */
+const LF = String.fromCharCode(10);
+/** 图区高度（px）：宽容器一档、窄容器一档（分箱那一档住 `style-forms.ts`）。 */
+export const SCATTER_FIT_PLOT_PX = 170;
+const NARROW_PLOT_PX = 150;
+/* 分箱区高度在本件的名字面上只报一次（取值住 `style-forms.ts`，判据与调用方读这里）。 */
+export { SCATTER_FIT_BIN_PX } from './style-forms.js';
+/** 一个百分比档：强调色往卡面掺 `weight`%（淡洗＝合法的面；不是"拿墨色当面"）。 */
+const wash = (weight) => 'color-mix(in srgb, ' + skinVar('accent') + ' ' + String(weight)
+    + '%, ' + skinVar('surface') + ')';
+/** 本组件的样式段。恒返回非空 CSS 文本。 */
+export function scatterFitCss(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-scatter-fit';
+    /* 槽类名（**不带 scope**）：只用在**已经落进本件某条选择器内部**的位置（前缀由外层那条选择器给）。
+       拿 `s()` 去拼后代／兄弟选择器会拼出 `.page-ui .a .page-ui .b` —— 第二条 `.page-ui` 永远匹配不到，
+       规则「看着在、其实不生效」（样张页上抓到过一次真事：段内字色没生效）。本文件只用 `s()`；
+       要拼嵌在选择器内部的裸槽类时，才在那一处现加一个 `c()`（`style-forms.ts` 有两处这样用）。 */
+    const s = (slot) => root + ' .' + scatterFitSlot(slot, p);
+    return [
+        '/* scatter-fit（相关性散点 · 三个形态：散点／分箱／滞后）：两个读数放在一张图上，',
+        '   点是一片云、趋势是一条线、带子是大概率的范围。色一律从强调色系出',
+        '   （实底给无文字的条与点、淡洗给概率带）：换皮只换取值、不换结构；任何一档都不拿文字墨色当面。 */',
+        box + ' {',
+        /* 宽度判据的落点：本件是**自己的容器**——嵌进侧栏／面板／卡片时照样按自己的宽度排。 */
+        '  container-type: inline-size;',
+        /* 宿主页不保证是 `border-box`（真页面默认 content-box）：本件带边框／内距的位子
+           在那种页里会比容器宽出边框那几像素 ⇒ 在本件**自己的子树里**把 `box-sizing` 钉成 `border-box`。 */
+        '  box-sizing: border-box;',
+        '  display: grid;',
+        '  gap: 10px;',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font') + ';',
+        '  font-size: ' + skinVar('fs-body') + ';',
+        '  line-height: 1.5;',
+        '}',
+        box + ' * {',
+        '  box-sizing: border-box;',
+        '}',
+        s('hd') + ' {',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  align-items: baseline;',
+        '  gap: 3px 10px;',
+        '  min-width: 0;',
+        '}',
+        s('title') + ' {',
+        '  margin: 0;',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink') + ';',
+        '  font-family: ' + skinVar('font-display') + ';',
+        '  font-size: ' + skinVar('fs-h3') + ';',
+        '  font-weight: 700;',
+        '  line-height: 1.35;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        s('stamp') + ' {',
+        /* 内容撑宽是横溢的来源：调用方给一句长口径（时间窗可以很长）时，`flex: none` ＋ `nowrap`
+           会让这一项拒绝收窄 ⇒ 父行跟着溢出（320 档实测 384 > 320）。故 `flex: 0 1 auto`（可收窄）＋
+           `min-width: 0`（收窄到零也允许）＋ 允许在词内断行（`overflow-wrap`）。 */
+        '  flex: 0 1 auto;',
+        '  min-width: 0;',
+        '  margin-left: auto;',
+        '  padding: 1px 8px;',
+        '  border-radius: ' + skinVar('radius-pill') + ';',
+        '  background: ' + skinVar('surface-2') + ';',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  font-weight: 600;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        s('tail') + ' {',
+        '  flex: 0 1 auto;',
+        '  min-width: 0;',
+        '  margin-left: auto;',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  font-weight: 700;',
+        '  font-variant-numeric: tabular-nums;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        /* 坐标框：第一列按纵轴刻度文字占位（`max-content`），第二列是图区（`minmax(0,1fr)`）⇒
+           图区在任何容器宽度下都摊在容器内，纵轴刻度长一点也不会把图挤出框。 */
+        s('plotbox') + ' {',
+        '  display: grid;',
+        '  grid-template-columns: max-content minmax(0, 1fr);',
+        '  column-gap: 8px;',
+        '  row-gap: 4px;',
+        '  min-width: 0;',
+        '}',
+        s('yticks') + ' {',
+        '  grid-column: 1;',
+        '  grid-row: 1;',
+        '  display: flex;',
+        '  flex-direction: column;',
+        '  justify-content: space-between;',
+        '  align-items: flex-end;',
+        '  min-width: 0;',
+        '}',
+        s('ytick') + ' {',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink-3') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  font-weight: 600;',
+        '  font-variant-numeric: tabular-nums;',
+        '  white-space: nowrap;',
+        '}',
+        s('plot') + ' {',
+        '  grid-column: 2;',
+        '  grid-row: 1;',
+        '  position: relative;',
+        '  height: ' + String(SCATTER_FIT_PLOT_PX) + 'px;',
+        '  min-width: 0;',
+        '  border-left: 1px solid ' + skinVar('line') + ';',
+        '  border-bottom: 1px solid ' + skinVar('line') + ';',
+        '}',
+        /* 概率带：强调色 16% 的淡洗（"大概率的范围"是面，不是条）；形状由行内 `clip-path` 的多边形给。 */
+        s('band') + ' {',
+        '  position: absolute;',
+        '  inset: 0;',
+        '  background: ' + wash(16) + ';',
+        '}',
+        s('fitline') + ' {',
+        '  position: absolute;',
+        '  inset: 0;',
+        '  background: ' + skinVar('accent') + ';',
+        '}',
+        /* 一个读数：**无文字的图形 ⇒ `accent` 实底**；坐标取 3%…97% 的轴内距，半径再大也不跑出框。 */
+        s('dot') + ' {',
+        '  position: absolute;',
+        '  width: 10px;',
+        '  height: 10px;',
+        '  border-radius: 50%;',
+        '  background: ' + skinVar('accent') + ';',
+        '  transform: translate(-50%, 50%);',
+        '}',
+        /* 被点名的离群点：**形**（圈出来，比别的点大一圈）＋**字**（图例里写清原因）——
+           不靠颜色，也不静默丢掉。 */
+        s('dot') + '.is-outlier {',
+        '  width: 14px;',
+        '  height: 14px;',
+        '  background: ' + skinVar('surface') + ';',
+        '  border: 3px solid ' + skinVar('accent') + ';',
+        '}',
+        s('xticks') + ' {',
+        '  grid-column: 2;',
+        '  grid-row: 2;',
+        '  display: flex;',
+        /* 一排塞不下就**换行**（不是把每一枚压成一列竖字）：`flex-wrap` 先按各枚的自然宽度分行，
+           只有"单独一枚比容器还宽"时才收窄——那时它自己换行，容器照旧不横滑。 */
+        '  flex-wrap: wrap;',
+        '  gap: 6px;',
+        '  justify-content: space-between;',
+        '  min-width: 0;',
+        '}',
+        s('xtick') + ' {',
+        '  flex: 0 1 auto;',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink-3') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  font-weight: 600;',
+        '  font-variant-numeric: tabular-nums;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        /* 图例：每一项是「形 ＋ 字」——形由四档 `is-*` 给，字说清那是什么（形不是唯一信息）。 */
+        s('legend') + ' {',
+        '  list-style: none;',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  align-items: center;',
+        '  gap: 5px 14px;',
+        '  margin: 0;',
+        '  padding: 9px 0 0;',
+        '  border-top: 1px solid ' + skinVar('line') + ';',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-size: ' + skinVar('fs-xs') + ';',
+        '  font-weight: 600;',
+        '}',
+        s('legend-item') + ' {',
+        '  display: flex;',
+        '  align-items: center;',
+        '  gap: 5px;',
+        '  min-width: 0;',
+        '  list-style: none;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        s('legend-mark') + ' {',
+        '  display: block;',
+        '  flex: 0 0 auto;',
+        '  width: 12px;',
+        '  height: 12px;',
+        '  border-radius: ' + skinVar('radius-sm') + ';',
+        '  background: ' + skinVar('accent') + ';',
+        '}',
+        s('legend-mark') + '.is-dot {',
+        '  width: 10px;',
+        '  height: 10px;',
+        '  border-radius: 50%;',
+        '}',
+        s('legend-mark') + '.is-ring {',
+        '  width: 13px;',
+        '  height: 13px;',
+        '  border: 3px solid ' + skinVar('accent') + ';',
+        '  border-radius: 50%;',
+        '  background: ' + skinVar('surface') + ';',
+        '}',
+        s('legend-mark') + '.is-median {',
+        '  height: 3px;',
+        '  border-radius: ' + skinVar('radius-pill') + ';',
+        '}',
+        s('legend-mark') + '.is-range {',
+        '  background: ' + wash(24) + ';',
+        '}',
+        s('note') + ' {',
+        '  margin: 0;',
+        '  min-width: 0;',
+        '  color: ' + skinVar('ink-2') + ';',
+        '  font-size: ' + skinVar('fs-sm') + ';',
+        '  line-height: 1.6;',
+        '  overflow-wrap: anywhere;',
+        '}',
+        '/* 本件自身不带可点元素。这一条是**地板**：调用方把某一点包成入口（点开那一天）时焦点必须看得见。 */',
+        box + ' :focus-visible {',
+        '  outline: 2px solid ' + skinVar('accent') + ';',
+        '  outline-offset: 2px;',
+        '}',
+        '/* 分箱段与滞后段（`style-forms.ts`）：同一份纪律、同一个前缀，插在这里——',
+        '   顺序即层叠顺序，改动前后产物逐字节相同。 */',
+        scatterFitFormsCss({ prefix: p }),
+        '/* 窄容器（<' + String(SCATTER_FIT_NARROW_PX) + 'px，阈值住 `attrs.ts`，两份样式文件共用同一份）：',
+        '   图区矮一档、点小一档、刻度距收一档 —— **一列不减**；宽度靠 `minmax(0,1fr)`／`flex: 1 1 0` 自己变窄，',
+        '   不横滑、不藏横滑。 */',
+        '@container (max-width: ' + String(SCATTER_FIT_NARROW_PX) + 'px) {',
+        '  ' + s('plot') + ' {',
+        '    height: ' + String(NARROW_PLOT_PX) + 'px;',
+        '  }',
+        '  ' + s('dot') + ' {',
+        '    width: 9px;',
+        '    height: 9px;',
+        '  }',
+        '  ' + s('dot') + '.is-outlier {',
+        '    width: 12px;',
+        '    height: 12px;',
+        '  }',
+        '  ' + s('xticks') + ' {',
+        '    gap: 4px;',
+        '  }',
+        '}',
+    ].join(LF);
+}

package/dist/components/scatter-fit/style.js.map

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

package/dist/components/search-field/attrs.d.ts

@@ -0,0 +1,136 @@
+/** searchField · **标记契约**（渲染与运行时共用的唯一事实）。
+ *
+ *  形态：**B**（范围分段 ＋ 下划线输入 ＋ 命中读数）。
+ *  为什么是 B：`#950` 打分台账里 search-field 三形态 A/B/C ＝ 1/3/3、4/4/4、4/4/4，
+ *  并列取先者 ⇒ B 胜出。B 的骨架＝「先圈定在哪找（分段）→ 真打字 → 页上写着命中几处」。
+ *  下划线（印刷风）是 B 的**视觉**档（原型 B 的框换成下划线），骨架一档没少。
+ *
+ *  运行时的发现锚一律是 `data-*`：类名只管长相，属性管行为——改样式不动行为。
+ *  **命中计数是真数**：运行时按结果区里真实存在的条目与真实出现的词数出来，渲染期只写「—」。
+ */
+/** 本件的类名根（`ilife-block-<件名>`）。所有槽位类名都由它派生出 `-<槽>`。 */
+export declare const SEARCH_ROOT_CLASS = "ilife-block-search-field";
+/** 形态闭集：本件只落裁定胜出的那一档（闭集外的值 → `bad-input`，不静默降级）。 */
+export declare const SEARCH_FORMS: readonly ["B"];
+export type SearchFieldForm = (typeof SEARCH_FORMS)[number];
+/** 根：值＝机器键（`SearchFieldInput.name`）。运行时的发现锚。 */
+export declare const SEARCH_NAME_ATTR = "data-ilife-search";
+/** 形态键（闭集见 `SEARCH_FORMS`）。 */
+export declare const SEARCH_FORM_ATTR = "data-ilife-search-form";
+/** 结果区键：值＝结果区自己挂的 `data-ilife-search-region` 值。不给＝整页找。 */
+export declare const SEARCH_TARGET_ATTR = "data-ilife-search-target";
+/** 绑定完成标记（运行时幂等：重复注入不重复绑定）。 */
+export declare const SEARCH_BOUND_ATTR = "data-ilife-search-bound";
+/** 运行时挂载标记（挂在 `<html>` 上：同一页注入多份运行时也只绑一次）。 */
+export declare const SEARCH_RUNTIME_ATTR = "data-ilife-search-runtime";
+/** 载入态标记（`1` ＝正在找）。 */
+export declare const SEARCH_LOADING_ATTR = "data-ilife-search-loading";
+/** 载入态文案（原地换字用；不给取 `SEARCH_DEFAULTS.loadingText`）。 */
+export declare const SEARCH_LOADING_TEXT_ATTR = "data-ilife-search-loading-text";
+/** 错态标记（`1` ＝控件旁边那句错在生效）。 */
+export declare const SEARCH_INVALID_ATTR = "data-ilife-search-invalid";
+/** 禁用标记（输入框与三颗键一起禁用）。 */
+export declare const SEARCH_DISABLED_ATTR = "data-ilife-search-disabled";
+/** 结果区（一段可以整体被某个搜索框圈定的区域）。 */
+export declare const SEARCH_REGION_ATTR = "data-ilife-search-region";
+/** 结果条目（被搜、被过滤、被标命中词的单元）。 `result-row` 的每一条也带它。 */
+export declare const SEARCH_ITEM_ATTR = "data-ilife-search-item";
+/** 条目的范围标签（空格分隔；范围分段按它对号入座）。没有标签的条目只算进「全部」。 */
+export declare const SEARCH_TAGS_ATTR = "data-ilife-search-tags";
+export declare const SEARCH_INPUT_ATTR = "data-ilife-search-input";
+export declare const SEARCH_CLEAR_ATTR = "data-ilife-search-clear";
+/** 范围分段键：值＝该档的 `value`。 */
+export declare const SEARCH_SCOPE_ATTR = "data-ilife-search-scope";
+/** 范围键里的计数位（运行时按真实命中数写它）。 */
+export declare const SEARCH_N_ATTR = "data-ilife-search-n";
+/** 读数里的当前范围名。 */
+export declare const SEARCH_SCOPE_NAME_ATTR = "data-ilife-search-scope-name";
+/** 读数节点（`role="status"`；载入态在原地换字）。 */
+export declare const SEARCH_STATUS_ATTR = "data-ilife-search-status";
+/** 读数整行（状态 ＋ 前后跳；窄档换行时整行一起换）。 */
+export declare const SEARCH_READOUT_ATTR = "data-ilife-search-readout";
+/** 位置节点（「第 i 处 / 共 n 处」整句；`i`／`n` 分住在两个 `SEARCH_AT_ATTR`／`SEARCH_COUNT_ATTR` 位里）。 */
+export declare const SEARCH_POS_ATTR = "data-ilife-search-pos";
+/** 命中数位（「N 处命中」里的 N；两处共用同一个属性名，运行时一起写）。 */
+export declare const SEARCH_COUNT_ATTR = "data-ilife-search-count";
+/** 当前第几处（「第 i 处 / 共 n 处」里的 i）。 */
+export declare const SEARCH_AT_ATTR = "data-ilife-search-at";
+export declare const SEARCH_PREV_ATTR = "data-ilife-search-prev";
+export declare const SEARCH_NEXT_ATTR = "data-ilife-search-next";
+/** 运行时打上的命中词标签（`<mark>`；**卸载时逐字还原原文**）。 */
+export declare const SEARCH_HIT_ATTR = "data-ilife-search-hit";
+/** 当前那一处命中（跳转落点）。 */
+export declare const SEARCH_CURRENT_ATTR = "data-ilife-search-current";
+/** 空态行（设计过的空态句；词为空或有命中时收起）。 */
+export declare const SEARCH_EMPTY_ATTR = "data-ilife-search-empty";
+/** 错态行（写在控件旁边的那句；`aria-describedby` 指向它的 id）。 */
+export declare const SEARCH_ERROR_ATTR = "data-ilife-search-error";
+/** 每次查询变化（打字／清空／换范围）：`detail = { name, query, scope, hits, items }`。 */
+export declare const SEARCH_EVENT_QUERY = "ilife:search";
+/** 跳转：`detail = { name, index, total }`。 */
+export declare const SEARCH_EVENT_JUMP = "ilife:search-jump";
+/** 载入态开关（页面驱动）：`detail = { name, on, text? }`。 */
+export declare const SEARCH_EVENT_LOADING = "ilife:search-loading";
+/** 缺省文案与量词（渲染与运行时共用这一份，判据也从这里取，不抄字面量）。 */
+export declare const SEARCH_DEFAULTS: Readonly<{
+    /** 输入框的 `aria-label`（没给字段名时的兜底）。 */
+    readonly label: "搜索";
+    readonly clearLabel: "清空";
+    readonly prevLabel: "上一处";
+    readonly nextLabel: "下一处";
+    /** 空态句：命中 0 处时写在读数下面（**设计过的空态**，不是一片空白）。 */
+    readonly emptyText: "没有命中，换个词或放宽范围";
+    /** 载入态原地换的那句。 */
+    readonly loadingText: "正在找…";
+    /** 没接上结果区时那句（错态，写在控件旁边）。 */
+    readonly unwiredText: "这个搜索框没接上结果区：页面上找不到可搜的条目";
+    /** 「全部」档的机器值（范围分段里代表不过滤）。 */
+    readonly scopeAll: "all";
+    /** 命中数的量词：「N 处命中」的「处」。 */
+    readonly noun: "处";
+    /** 缺值写法（工艺书：缺值写成 `—`）。 */
+    readonly unset: "—";
+    /** 结果区条目一个字都没有时的报错文案。 */
+    readonly emptyRegionText: "结果区里没有可搜的条目";
+}>;
+/** 范围分段的一档。 */
+export interface SearchScopeInput {
+    /** 机器值（`detail.scope` 与条目的 `data-ilife-search-tags` 按它对号）。 */
+    readonly value: string;
+    /** 上屏字。 */
+    readonly label: string;
+    /** 计数位（渲染期的初值；运行时按真实命中重写）。 */
+    readonly count?: number | string;
+}
+export interface SearchFieldInput {
+    /** 形态键（本件只有 `B`；给了闭集外的值就 `bad-input`，不静默换档）。 */
+    readonly form?: SearchFieldForm;
+    /** 机器键（事件 `detail.name` 按它定位；同一页内应唯一）。非空字符串。 */
+    readonly name: string;
+    /** 人类可读字段名（`aria-label` 用它；缺省 `搜索`）。 */
+    readonly label?: string;
+    readonly placeholder?: string;
+    /** 初始查询串（可为空串＝没有查询）。 */
+    readonly query?: string;
+    /** 范围分段：不给／空数组＝不渲染分段；给就至少两档（一档不成分段）。 */
+    readonly scopes?: readonly SearchScopeInput[];
+    /** 初始选中的范围（`scopes` 的某一个 `value`；缺省 `all`）。 */
+    readonly scope?: string;
+    /** 结果区键（对应结果区的 `data-ilife-search-region`）；不给＝整页找。 */
+    readonly target?: string;
+    /** 量词（「N 处命中」的「处」；如「道」「条」）。 */
+    readonly noun?: string;
+    /** 空态句（命中 0 处时上屏）。 */
+    readonly emptyText?: string;
+    /** 载入态文案。 */
+    readonly loadingText?: string;
+    /** 初始错态：给了就在控件旁边写这一句（`aria-describedby` 指过去）。 */
+    readonly error?: string;
+    /** 初始载入态。 */
+    readonly loading?: boolean;
+    /** 禁用：输入框与三颗键一起禁用（"看着能用、用了没反应"是不许留的中间档）。 */
+    readonly disabled?: boolean;
+    /** 附加类名（空格分隔；逐个过类名正则）。 */
+    readonly extraClass?: string;
+}
+//# sourceMappingURL=attrs.d.ts.map

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

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

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

@@ -0,0 +1,98 @@
+/** searchField · **标记契约**（渲染与运行时共用的唯一事实）。
+ *
+ *  形态：**B**（范围分段 ＋ 下划线输入 ＋ 命中读数）。
+ *  为什么是 B：`#950` 打分台账里 search-field 三形态 A/B/C ＝ 1/3/3、4/4/4、4/4/4，
+ *  并列取先者 ⇒ B 胜出。B 的骨架＝「先圈定在哪找（分段）→ 真打字 → 页上写着命中几处」。
+ *  下划线（印刷风）是 B 的**视觉**档（原型 B 的框换成下划线），骨架一档没少。
+ *
+ *  运行时的发现锚一律是 `data-*`：类名只管长相，属性管行为——改样式不动行为。
+ *  **命中计数是真数**：运行时按结果区里真实存在的条目与真实出现的词数出来，渲染期只写「—」。
+ */
+/** 本件的类名根（`ilife-block-<件名>`）。所有槽位类名都由它派生出 `-<槽>`。 */
+export const SEARCH_ROOT_CLASS = 'ilife-block-search-field';
+/** 形态闭集：本件只落裁定胜出的那一档（闭集外的值 → `bad-input`，不静默降级）。 */
+export const SEARCH_FORMS = ['B'];
+/* ── 根 ────────────────────────────────────────────────────────────── */
+/** 根：值＝机器键（`SearchFieldInput.name`）。运行时的发现锚。 */
+export const SEARCH_NAME_ATTR = 'data-ilife-search';
+/** 形态键（闭集见 `SEARCH_FORMS`）。 */
+export const SEARCH_FORM_ATTR = 'data-ilife-search-form';
+/** 结果区键：值＝结果区自己挂的 `data-ilife-search-region` 值。不给＝整页找。 */
+export const SEARCH_TARGET_ATTR = 'data-ilife-search-target';
+/** 绑定完成标记（运行时幂等：重复注入不重复绑定）。 */
+export const SEARCH_BOUND_ATTR = 'data-ilife-search-bound';
+/** 运行时挂载标记（挂在 `<html>` 上：同一页注入多份运行时也只绑一次）。 */
+export const SEARCH_RUNTIME_ATTR = 'data-ilife-search-runtime';
+/** 载入态标记（`1` ＝正在找）。 */
+export const SEARCH_LOADING_ATTR = 'data-ilife-search-loading';
+/** 载入态文案（原地换字用；不给取 `SEARCH_DEFAULTS.loadingText`）。 */
+export const SEARCH_LOADING_TEXT_ATTR = 'data-ilife-search-loading-text';
+/** 错态标记（`1` ＝控件旁边那句错在生效）。 */
+export const SEARCH_INVALID_ATTR = 'data-ilife-search-invalid';
+/** 禁用标记（输入框与三颗键一起禁用）。 */
+export const SEARCH_DISABLED_ATTR = 'data-ilife-search-disabled';
+/* ── 结果区 ────────────────────────────────────────────────────────── */
+/** 结果区（一段可以整体被某个搜索框圈定的区域）。 */
+export const SEARCH_REGION_ATTR = 'data-ilife-search-region';
+/** 结果条目（被搜、被过滤、被标命中词的单元）。 `result-row` 的每一条也带它。 */
+export const SEARCH_ITEM_ATTR = 'data-ilife-search-item';
+/** 条目的范围标签（空格分隔；范围分段按它对号入座）。没有标签的条目只算进「全部」。 */
+export const SEARCH_TAGS_ATTR = 'data-ilife-search-tags';
+/* ── 控件槽 ────────────────────────────────────────────────────────── */
+export const SEARCH_INPUT_ATTR = 'data-ilife-search-input';
+export const SEARCH_CLEAR_ATTR = 'data-ilife-search-clear';
+/** 范围分段键：值＝该档的 `value`。 */
+export const SEARCH_SCOPE_ATTR = 'data-ilife-search-scope';
+/** 范围键里的计数位（运行时按真实命中数写它）。 */
+export const SEARCH_N_ATTR = 'data-ilife-search-n';
+/** 读数里的当前范围名。 */
+export const SEARCH_SCOPE_NAME_ATTR = 'data-ilife-search-scope-name';
+/** 读数节点（`role="status"`；载入态在原地换字）。 */
+export const SEARCH_STATUS_ATTR = 'data-ilife-search-status';
+/** 读数整行（状态 ＋ 前后跳；窄档换行时整行一起换）。 */
+export const SEARCH_READOUT_ATTR = 'data-ilife-search-readout';
+/** 位置节点（「第 i 处 / 共 n 处」整句；`i`／`n` 分住在两个 `SEARCH_AT_ATTR`／`SEARCH_COUNT_ATTR` 位里）。 */
+export const SEARCH_POS_ATTR = 'data-ilife-search-pos';
+/** 命中数位（「N 处命中」里的 N；两处共用同一个属性名，运行时一起写）。 */
+export const SEARCH_COUNT_ATTR = 'data-ilife-search-count';
+/** 当前第几处（「第 i 处 / 共 n 处」里的 i）。 */
+export const SEARCH_AT_ATTR = 'data-ilife-search-at';
+export const SEARCH_PREV_ATTR = 'data-ilife-search-prev';
+export const SEARCH_NEXT_ATTR = 'data-ilife-search-next';
+/** 运行时打上的命中词标签（`<mark>`；**卸载时逐字还原原文**）。 */
+export const SEARCH_HIT_ATTR = 'data-ilife-search-hit';
+/** 当前那一处命中（跳转落点）。 */
+export const SEARCH_CURRENT_ATTR = 'data-ilife-search-current';
+/** 空态行（设计过的空态句；词为空或有命中时收起）。 */
+export const SEARCH_EMPTY_ATTR = 'data-ilife-search-empty';
+/** 错态行（写在控件旁边的那句；`aria-describedby` 指向它的 id）。 */
+export const SEARCH_ERROR_ATTR = 'data-ilife-search-error';
+/* ── 事件（冒泡 `CustomEvent`，页面按 `detail` 接自己的重算，**不引入全局**）── */
+/** 每次查询变化（打字／清空／换范围）：`detail = { name, query, scope, hits, items }`。 */
+export const SEARCH_EVENT_QUERY = 'ilife:search';
+/** 跳转：`detail = { name, index, total }`。 */
+export const SEARCH_EVENT_JUMP = 'ilife:search-jump';
+/** 载入态开关（页面驱动）：`detail = { name, on, text? }`。 */
+export const SEARCH_EVENT_LOADING = 'ilife:search-loading';
+/** 缺省文案与量词（渲染与运行时共用这一份，判据也从这里取，不抄字面量）。 */
+export const SEARCH_DEFAULTS = Object.freeze({
+    /** 输入框的 `aria-label`（没给字段名时的兜底）。 */
+    label: '搜索',
+    clearLabel: '清空',
+    prevLabel: '上一处',
+    nextLabel: '下一处',
+    /** 空态句：命中 0 处时写在读数下面（**设计过的空态**，不是一片空白）。 */
+    emptyText: '没有命中，换个词或放宽范围',
+    /** 载入态原地换的那句。 */
+    loadingText: '正在找…',
+    /** 没接上结果区时那句（错态，写在控件旁边）。 */
+    unwiredText: '这个搜索框没接上结果区：页面上找不到可搜的条目',
+    /** 「全部」档的机器值（范围分段里代表不过滤）。 */
+    scopeAll: 'all',
+    /** 命中数的量词：「N 处命中」的「处」。 */
+    noun: '处',
+    /** 缺值写法（工艺书：缺值写成 `—`）。 */
+    unset: '—',
+    /** 结果区条目一个字都没有时的报错文案。 */
+    emptyRegionText: '结果区里没有可搜的条目',
+});

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

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

package/dist/components/search-field/index.d.ts

@@ -0,0 +1,39 @@
+/** searchField · **组件出口**（该组件对外的唯一名字面）。
+ *
+ *  —— 搜索框（形态 B：范围分段 ＋ 下划线输入 ＋ 命中读数）——
+ *
+ *  一句话：**先圈定在哪找，再真打字，页上写着命中几处**——命中数是数出来的，不是编的。
+ *
+ *  什么时候用它（对照既有件想清楚再选）：
+ *   · 页面上有一批已经渲染好的条目（菜谱／食品／笔记／物品…），要按词找 → 用它；
+ *     **命中计数、清空、回车跳下一处都是真行为**（`buildSearchFieldJs()`）。
+ *   · 要「筛一批记录」（不是找词，而是按属性取子集）→ 用 `filter-chips`；
+ *   · 要「换一段窗口看读数」→ 用 `window-picker`；
+ *   · HELP 页里那个搜索框（`controls` 的共享 helper）**不是本件**：它绑死在 HELP 模板的固定 id 上，
+ *     随模板注入、不可当积木拼；本件是能拼的公共件（结果区与它只通过 `data-*` 约定相接）。
+ *
+ *  与结果区的接线（三段，全走 `data-*`）：
+ *   1. 结果区挂 `data-ilife-search-region="<键>"`；搜索框给 `target: '<键>'`（不给＝整页找）；
+ *   2. 每条结果挂 `data-ilife-search-item`（`renderResultRow` 已自带），可选 `data-ilife-search-tags="范围1 范围2"`；
+ *   3. 运行时给命中词打 `<mark data-ilife-search-hit>`，并派发 `ilife:search` / `ilife:search-jump`。
+ *
+ *  三件出口：
+ *   · `renderSearchField(input)` —— 产标记（纯函数，零 DOM；命中数写 `—`，运行时填真数）；
+ *   · `searchFieldCss()` —— 该组件的样式段（页面按需注入；住 `.<prefix>page-ui` 之下）；
+ *   · `buildSearchFieldJs()` —— 运行时（产出 JS 文本；DOM 只出现在文本里）。
+ *
+ *  页面怎么接自己的重算（不引入任何全局）：
+ *  ```js
+ *  document.addEventListener('ilife:search', (e) => {
+ *    const { name, query, scope, hits, items } = e.detail;   // hits／items 都是数出来的
+ *  });
+ *  document.dispatchEvent(new CustomEvent('ilife:search-loading', { detail: { name: 'main', on: true } }));
+ *  ```
+ *  完整用法与参数表见同目录 `README.md`。
+ */
+export { SEARCH_AT_ATTR, SEARCH_BOUND_ATTR, SEARCH_CLEAR_ATTR, SEARCH_COUNT_ATTR, SEARCH_CURRENT_ATTR, SEARCH_DEFAULTS, SEARCH_DISABLED_ATTR, SEARCH_EMPTY_ATTR, SEARCH_ERROR_ATTR, SEARCH_EVENT_JUMP, SEARCH_EVENT_LOADING, SEARCH_EVENT_QUERY, SEARCH_FORM_ATTR, SEARCH_FORMS, SEARCH_HIT_ATTR, SEARCH_INPUT_ATTR, SEARCH_INVALID_ATTR, SEARCH_ITEM_ATTR, SEARCH_LOADING_ATTR, SEARCH_LOADING_TEXT_ATTR, SEARCH_NAME_ATTR, SEARCH_NEXT_ATTR, SEARCH_N_ATTR, SEARCH_POS_ATTR, SEARCH_PREV_ATTR, SEARCH_READOUT_ATTR, SEARCH_REGION_ATTR, SEARCH_ROOT_CLASS, SEARCH_RUNTIME_ATTR, SEARCH_SCOPE_ATTR, SEARCH_SCOPE_NAME_ATTR, SEARCH_STATUS_ATTR, SEARCH_TAGS_ATTR, SEARCH_TARGET_ATTR, } from './attrs.js';
+export type { SearchFieldForm, SearchFieldInput, SearchScopeInput } from './attrs.js';
+export { searchErrorId, renderSearchField } from './render.js';
+export { searchFieldCss, SEARCH_MAX_WIDTH_PX, SEARCH_STATUS_MIN_CH, SEARCH_TOUCH_MIN_PX } from './style.js';
+export { buildSearchFieldJs } from './runtime.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/search-field/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,OAAO,EACL,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAC5F,eAAe,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAC9F,oBAAoB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,YAAY,EAAE,eAAe,EACzF,iBAAiB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,mBAAmB,EAC7E,wBAAwB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAC5F,gBAAgB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EACjG,iBAAiB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,kBAAkB,GACpG,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC5G,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,37 @@
+/** searchField · **组件出口**（该组件对外的唯一名字面）。
+ *
+ *  —— 搜索框（形态 B：范围分段 ＋ 下划线输入 ＋ 命中读数）——
+ *
+ *  一句话：**先圈定在哪找，再真打字，页上写着命中几处**——命中数是数出来的，不是编的。
+ *
+ *  什么时候用它（对照既有件想清楚再选）：
+ *   · 页面上有一批已经渲染好的条目（菜谱／食品／笔记／物品…），要按词找 → 用它；
+ *     **命中计数、清空、回车跳下一处都是真行为**（`buildSearchFieldJs()`）。
+ *   · 要「筛一批记录」（不是找词，而是按属性取子集）→ 用 `filter-chips`；
+ *   · 要「换一段窗口看读数」→ 用 `window-picker`；
+ *   · HELP 页里那个搜索框（`controls` 的共享 helper）**不是本件**：它绑死在 HELP 模板的固定 id 上，
+ *     随模板注入、不可当积木拼；本件是能拼的公共件（结果区与它只通过 `data-*` 约定相接）。
+ *
+ *  与结果区的接线（三段，全走 `data-*`）：
+ *   1. 结果区挂 `data-ilife-search-region="<键>"`；搜索框给 `target: '<键>'`（不给＝整页找）；
+ *   2. 每条结果挂 `data-ilife-search-item`（`renderResultRow` 已自带），可选 `data-ilife-search-tags="范围1 范围2"`；
+ *   3. 运行时给命中词打 `<mark data-ilife-search-hit>`，并派发 `ilife:search` / `ilife:search-jump`。
+ *
+ *  三件出口：
+ *   · `renderSearchField(input)` —— 产标记（纯函数，零 DOM；命中数写 `—`，运行时填真数）；
+ *   · `searchFieldCss()` —— 该组件的样式段（页面按需注入；住 `.<prefix>page-ui` 之下）；
+ *   · `buildSearchFieldJs()` —— 运行时（产出 JS 文本；DOM 只出现在文本里）。
+ *
+ *  页面怎么接自己的重算（不引入任何全局）：
+ *  ```js
+ *  document.addEventListener('ilife:search', (e) => {
+ *    const { name, query, scope, hits, items } = e.detail;   // hits／items 都是数出来的
+ *  });
+ *  document.dispatchEvent(new CustomEvent('ilife:search-loading', { detail: { name: 'main', on: true } }));
+ *  ```
+ *  完整用法与参数表见同目录 `README.md`。
+ */
+export { SEARCH_AT_ATTR, SEARCH_BOUND_ATTR, SEARCH_CLEAR_ATTR, SEARCH_COUNT_ATTR, SEARCH_CURRENT_ATTR, SEARCH_DEFAULTS, SEARCH_DISABLED_ATTR, SEARCH_EMPTY_ATTR, SEARCH_ERROR_ATTR, SEARCH_EVENT_JUMP, SEARCH_EVENT_LOADING, SEARCH_EVENT_QUERY, SEARCH_FORM_ATTR, SEARCH_FORMS, SEARCH_HIT_ATTR, SEARCH_INPUT_ATTR, SEARCH_INVALID_ATTR, SEARCH_ITEM_ATTR, SEARCH_LOADING_ATTR, SEARCH_LOADING_TEXT_ATTR, SEARCH_NAME_ATTR, SEARCH_NEXT_ATTR, SEARCH_N_ATTR, SEARCH_POS_ATTR, SEARCH_PREV_ATTR, SEARCH_READOUT_ATTR, SEARCH_REGION_ATTR, SEARCH_ROOT_CLASS, SEARCH_RUNTIME_ATTR, SEARCH_SCOPE_ATTR, SEARCH_SCOPE_NAME_ATTR, SEARCH_STATUS_ATTR, SEARCH_TAGS_ATTR, SEARCH_TARGET_ATTR, } from './attrs.js';
+export { searchErrorId, renderSearchField } from './render.js';
+export { searchFieldCss, SEARCH_MAX_WIDTH_PX, SEARCH_STATUS_MIN_CH, SEARCH_TOUCH_MIN_PX } from './style.js';
+export { buildSearchFieldJs } from './runtime.js';

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/search-field/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,OAAO,EACL,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAC5F,eAAe,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAC9F,oBAAoB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,YAAY,EAAE,eAAe,EACzF,iBAAiB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,mBAAmB,EAC7E,wBAAwB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAC5F,gBAAgB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EACjG,iBAAiB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,kBAAkB,GACpG,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC5G,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}