base-paint 0.3.14 → 0.3.16

package/dist/components/tooltip/attrs.d.ts

@@ -0,0 +1,91 @@
+/** tooltip · **标记契约**（渲染与运行时共用的唯一事实：类名／`data-*`／闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-10-容器与浮层.mjs`，2026-09 用户裁定）
+ *  里的**形态 B「宽气泡：一行『为什么重要』＋小标题」**——正文里一个**看不懂的词**，
+ *  点它／聚焦它／悬停它，弹出一条**宽气泡**：眉标（口径／字段说明）＋ 小标题 ＋ 解释 ＋
+ *  **「为什么重要」那一段**。用在哪：六个技能的口径解释、字段说明。
+ *
+ *  落地路线（票面钉死）：**`popover` 属性**——
+ *   · 开／关／点外面关都由浏览器给（触发键带 `popovertarget`，**一行脚本都没有也开得出来**）；
+ *     运行时在场时**由它接管「点那个词」这一步**：浏览器对触发键的开合在 `click` 之后跑，会把悬停刚开好的
+ *     气泡**关掉**（实测时序 `pointerover → toggle(开) → … → click → toggle(关)`）⇒ 运行时在场时
+ *     `preventDefault()` 拦掉那次开合，改成**恒开**（点那个词永不会关，关＝点别处）——见 `runtime.ts`；
+ *   · 定位：`@supports (anchor-name: --a)` **之内**才用 CSS 锚定定位——**竖轴贴着那个词**
+ *     （`anchor(bottom)`），**横轴夹在容器里**（宽气泡不跟词对齐，否则窄屏上必然越界）；
+ *     贴不下就 `position-try-fallbacks` 翻到词的上方。之外按普通定位元素排，运行时算 `top`。
+ *   · 三条通路都要能出：**悬停**（`hover:hover` 的设备）／**聚焦**（键盘增强）／**点击**（`popovertarget`）。
+ */
+/** 本件的类名根（挂在包住「词 ＋ 气泡」的那层容器上）。 */
+export declare const TOOLTIP_CLASS = "ilife-block-tooltip";
+/** 类名根（带前缀）。 */
+export declare function tooltipClass(prefix?: string): string;
+/** 槽位闭集。 */
+export declare const TOOLTIP_SLOTS: readonly ["word", "mark", "bubble", "head", "badge", "title", "hint", "text", "why"];
+export type TooltipSlot = (typeof TOOLTIP_SLOTS)[number];
+/** 槽类的类名（唯一拼法）。 */
+export declare function tooltipSlot(slot: TooltipSlot, prefix?: string): string;
+/** 形态闭集：本件只落地形态 B「宽气泡（带『为什么重要』）」。 */
+export declare const TOOLTIP_FORMS: readonly ["wide"];
+export type TooltipForm = (typeof TOOLTIP_FORMS)[number];
+/** 眉标闭集（这一条说明是「怎么算的」还是「这个字段是什么」）。 */
+export declare const TOOLTIP_BADGES: readonly ["caliber", "field"];
+export type TooltipBadge = (typeof TOOLTIP_BADGES)[number];
+/** 眉标上的字（闭集 → 字，一一对应；调用方要别的说法就自己给 `badgeText`）。 */
+export declare const TOOLTIP_BADGE_TEXT: Readonly<Record<TooltipBadge, string>>;
+/** 容器的发现锚：值＝气泡 `id`。 */
+export declare const TOOLTIP_ATTR = "data-ilife-tooltip";
+/** 被解释的那个词：值＝气泡 `id`（运行时按它认词）。 */
+export declare const TOOLTIP_WORD_ATTR = "data-ilife-tooltip-word";
+/** 气泡：值＝气泡 `id`。 */
+export declare const TOOLTIP_BUBBLE_ATTR = "data-ilife-tooltip-bubble";
+/** 绑定完成标记（幂等）。 */
+export declare const TOOLTIP_BOUND_ATTR = "data-ilife-tooltip-bound";
+/** 锚定定位的两条能力查询：**CSS 与运行时读同一个串**。 */
+export declare const TOOLTIP_ANCHOR_QUERY = "anchor-name: --a";
+/** 逐实例锚名的前缀（完整名＝`--tooltip-<id>`；词与气泡**写同一个名字**）。
+ *  **不带 `ilife-`**：`--ilife-*` 是**皮肤 token 的命名空间**（名单住 `skin/contract.ts`），
+ *  而锚名是**结构**不是语言——占了那个前缀，横切判据（`test/皮肤矩阵.test.mjs`）会把它当"拼错的 token"抓出来，
+ *  日后真加一条同名 token 也会撞车。 */
+export declare const TOOLTIP_ANCHOR_PREFIX = "--tooltip-";
+/** 词后那枚问号（纯装饰；「这是个可以问一句的词」的记号）。 */
+export declare const TOOLTIP_MARK = "?";
+/** 「为什么重要」那一段的行首标签（形态 B 的识别特征：**这一段必须有**）。 */
+export declare const TOOLTIP_WHY_LABEL = "\u4E3A\u4EC0\u4E48\u91CD\u8981";
+/** 关掉的提示（写在气泡头右端）。**不写键盘键名**：法条是"控件同时在手机与电脑用、不存在方向键一类键盘相关的东西"——
+ *  `Esc` 关掉浏览器仍然白送，但那是**增强**，不许摆到用户面前当唯一通路。 */
+export declare const TOOLTIP_HINT = "\u70B9\u522B\u5904\u5173\u6389";
+/** 几何口径：气泡宽上限／离容器边至少留多少／与词之间那道缝／词的最小命中边长。 */
+export declare const TOOLTIP_WIDTH_PX = 560;
+export declare const TOOLTIP_EDGE_PX = 12;
+export declare const TOOLTIP_OFFSET_PX = 8;
+/** 命中盒边长地板（44）：**样式段里也写着这个数**——`::after` 的纵向高度写成
+ *  `max(词盒高 ＋ 2×外扩, 44px)`，词盒再矮也破不了这条地板。 */
+export declare const TOOLTIP_HIT_PX = 44;
+/** 词周围那圈**看不见的命中扩展**（纵向；横向那 8px 写在样式段里）：词本身在行里，命中盒靠 `::after` 往外撑。
+ *  取 14 而不是 12：词盒高度由页面行高决定（`line-height: normal` 时只有 19px）——19＋24＝43，
+ *  **差 1px 不到 44 地板**（真指针普查实测有效命中 42）；14 撑到 47，加上样式里的 44 地板双重兜住。 */
+export declare const TOOLTIP_HIT_INSET_Y_PX = 14;
+/** 宽气泡入参（形态 B）。`id`／`word`／`title`／`text`／`why` 必填。 */
+export interface TooltipInput {
+    /** 气泡 `id`（也是词 `popovertarget` 指的那个 id）。同页唯一；只许标识符字符。 */
+    readonly id: string;
+    /** 被解释的那个词（页面正文里那两个字；整词是命中区）。 */
+    readonly word: string;
+    /** 小标题（如「「均摊」是怎么算的」）。 */
+    readonly title: string;
+    /** 解释那一段（一句话说清怎么算的／这个字段是什么）。 */
+    readonly text: string;
+    /** 「为什么重要」：不这么算会读错什么。**形态 B 的识别特征，必填**。 */
+    readonly why: string;
+    /** 眉标档（缺省 `caliber`）。 */
+    readonly badge?: TooltipBadge;
+    /** 眉标上的字（不给＝按 `badge` 档取现成话）。 */
+    readonly badgeText?: string;
+    /** 关掉的提示（不给＝「点别处关掉」；给了空串＝不出这一格）。 */
+    readonly hint?: string;
+    /** 形态键（闭集，缺省 `wide`）。 */
+    readonly form?: TooltipForm;
+    /** 附加类名。 */
+    readonly extraClass?: string;
+}
+//# sourceMappingURL=attrs.d.ts.map

package/dist/components/tooltip/attrs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.d.ts","sourceRoot":"","sources":["../../../src/components/tooltip/attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,kCAAkC;AAClC,eAAO,MAAM,aAAa,wBAAwB,CAAC;AAEnD,gBAAgB;AAChB,wBAAgB,YAAY,CAAC,MAAM,SAAW,GAAG,MAAM,CAEtD;AAED,YAAY;AACZ,eAAO,MAAM,aAAa,sFAoBhB,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,mBAAmB;AACnB,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,SAAW,GAAG,MAAM,CAExE;AAED,qCAAqC;AACrC,eAAO,MAAM,aAAa,mBAAoB,CAAC;AAC/C,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,qCAAqC;AACrC,eAAO,MAAM,cAAc,+BAAgC,CAAC;AAC5D,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAGpE,CAAC;AAIH,wBAAwB;AACxB,eAAO,MAAM,YAAY,uBAAuB,CAAC;AACjD,kCAAkC;AAClC,eAAO,MAAM,iBAAiB,4BAA4B,CAAC;AAC3D,oBAAoB;AACpB,eAAO,MAAM,mBAAmB,8BAA8B,CAAC;AAC/D,kBAAkB;AAClB,eAAO,MAAM,kBAAkB,6BAA6B,CAAC;AAE7D,qCAAqC;AACrC,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AACvD;;;2BAG2B;AAC3B,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAElD,mCAAmC;AACnC,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC,8CAA8C;AAC9C,eAAO,MAAM,iBAAiB,mCAAU,CAAC;AACzC;+CAC+C;AAC/C,eAAO,MAAM,YAAY,mCAAU,CAAC;AAEpC,6CAA6C;AAC7C,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC;4CAC4C;AAC5C,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC;;oEAEoE;AACpE,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,yDAAyD;IACzD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,iCAAiC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,yBAAyB;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,YAAY;IACZ,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B"}

package/dist/components/tooltip/attrs.js

@@ -0,0 +1,93 @@
+/** tooltip · **标记契约**（渲染与运行时共用的唯一事实：类名／`data-*`／闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-10-容器与浮层.mjs`，2026-09 用户裁定）
+ *  里的**形态 B「宽气泡：一行『为什么重要』＋小标题」**——正文里一个**看不懂的词**，
+ *  点它／聚焦它／悬停它，弹出一条**宽气泡**：眉标（口径／字段说明）＋ 小标题 ＋ 解释 ＋
+ *  **「为什么重要」那一段**。用在哪：六个技能的口径解释、字段说明。
+ *
+ *  落地路线（票面钉死）：**`popover` 属性**——
+ *   · 开／关／点外面关都由浏览器给（触发键带 `popovertarget`，**一行脚本都没有也开得出来**）；
+ *     运行时在场时**由它接管「点那个词」这一步**：浏览器对触发键的开合在 `click` 之后跑，会把悬停刚开好的
+ *     气泡**关掉**（实测时序 `pointerover → toggle(开) → … → click → toggle(关)`）⇒ 运行时在场时
+ *     `preventDefault()` 拦掉那次开合，改成**恒开**（点那个词永不会关，关＝点别处）——见 `runtime.ts`；
+ *   · 定位：`@supports (anchor-name: --a)` **之内**才用 CSS 锚定定位——**竖轴贴着那个词**
+ *     （`anchor(bottom)`），**横轴夹在容器里**（宽气泡不跟词对齐，否则窄屏上必然越界）；
+ *     贴不下就 `position-try-fallbacks` 翻到词的上方。之外按普通定位元素排，运行时算 `top`。
+ *   · 三条通路都要能出：**悬停**（`hover:hover` 的设备）／**聚焦**（键盘增强）／**点击**（`popovertarget`）。
+ */
+/** 本件的类名根（挂在包住「词 ＋ 气泡」的那层容器上）。 */
+export const TOOLTIP_CLASS = 'ilife-block-tooltip';
+/** 类名根（带前缀）。 */
+export function tooltipClass(prefix = 'ilife-') {
+    return prefix + 'block-tooltip';
+}
+/** 槽位闭集。 */
+export const TOOLTIP_SLOTS = [
+    /** 被解释的那个词（页面正文里的真 `<button>`；整词可点）。 */
+    'word',
+    /** 词后那枚问号记号（纯装饰，`aria-hidden`）。 */
+    'mark',
+    /** 气泡（`popover` ＋ `role=tooltip`）。 */
+    'bubble',
+    /** 气泡头部那一排（眉标 ＋ 小标题 ＋ 关掉的提示）。 */
+    'head',
+    /** 眉标（「口径」「字段说明」）。 */
+    'badge',
+    /** 小标题（如「「均摊」是怎么算的」）。 */
+    'title',
+    /** 关掉的提示（如「点别处关掉」）。**不写键盘键名**：法条是"控件同时在手机与电脑用、不存在方向键一类键盘相关的东西"；
+     *  `Esc` 关掉浏览器仍白送，但那是增强，不摆到用户面前当通路。 */
+    'hint',
+    /** 解释那一段。 */
+    'text',
+    /** 「为什么重要」那一段（形态 B 的识别特征）。 */
+    'why',
+];
+/** 槽类的类名（唯一拼法）。 */
+export function tooltipSlot(slot, prefix = 'ilife-') {
+    return tooltipClass(prefix) + '-' + slot;
+}
+/** 形态闭集：本件只落地形态 B「宽气泡（带『为什么重要』）」。 */
+export const TOOLTIP_FORMS = ['wide'];
+/** 眉标闭集（这一条说明是「怎么算的」还是「这个字段是什么」）。 */
+export const TOOLTIP_BADGES = ['caliber', 'field'];
+/** 眉标上的字（闭集 → 字，一一对应；调用方要别的说法就自己给 `badgeText`）。 */
+export const TOOLTIP_BADGE_TEXT = Object.freeze({
+    caliber: '口径',
+    field: '字段说明',
+});
+/* ── `data-*` 名 ─────────────────────────────────────────────────── */
+/** 容器的发现锚：值＝气泡 `id`。 */
+export const TOOLTIP_ATTR = 'data-ilife-tooltip';
+/** 被解释的那个词：值＝气泡 `id`（运行时按它认词）。 */
+export const TOOLTIP_WORD_ATTR = 'data-ilife-tooltip-word';
+/** 气泡：值＝气泡 `id`。 */
+export const TOOLTIP_BUBBLE_ATTR = 'data-ilife-tooltip-bubble';
+/** 绑定完成标记（幂等）。 */
+export const TOOLTIP_BOUND_ATTR = 'data-ilife-tooltip-bound';
+/** 锚定定位的两条能力查询：**CSS 与运行时读同一个串**。 */
+export const TOOLTIP_ANCHOR_QUERY = 'anchor-name: --a';
+/** 逐实例锚名的前缀（完整名＝`--tooltip-<id>`；词与气泡**写同一个名字**）。
+ *  **不带 `ilife-`**：`--ilife-*` 是**皮肤 token 的命名空间**（名单住 `skin/contract.ts`），
+ *  而锚名是**结构**不是语言——占了那个前缀，横切判据（`test/皮肤矩阵.test.mjs`）会把它当"拼错的 token"抓出来，
+ *  日后真加一条同名 token 也会撞车。 */
+export const TOOLTIP_ANCHOR_PREFIX = '--tooltip-';
+/** 词后那枚问号（纯装饰；「这是个可以问一句的词」的记号）。 */
+export const TOOLTIP_MARK = '?';
+/** 「为什么重要」那一段的行首标签（形态 B 的识别特征：**这一段必须有**）。 */
+export const TOOLTIP_WHY_LABEL = '为什么重要';
+/** 关掉的提示（写在气泡头右端）。**不写键盘键名**：法条是"控件同时在手机与电脑用、不存在方向键一类键盘相关的东西"——
+ *  `Esc` 关掉浏览器仍然白送，但那是**增强**，不许摆到用户面前当唯一通路。 */
+export const TOOLTIP_HINT = '点别处关掉';
+/** 几何口径：气泡宽上限／离容器边至少留多少／与词之间那道缝／词的最小命中边长。 */
+export const TOOLTIP_WIDTH_PX = 560;
+export const TOOLTIP_EDGE_PX = 12;
+export const TOOLTIP_OFFSET_PX = 8;
+/** 命中盒边长地板（44）：**样式段里也写着这个数**——`::after` 的纵向高度写成
+ *  `max(词盒高 ＋ 2×外扩, 44px)`，词盒再矮也破不了这条地板。 */
+export const TOOLTIP_HIT_PX = 44;
+/** 词周围那圈**看不见的命中扩展**（纵向；横向那 8px 写在样式段里）：词本身在行里，命中盒靠 `::after` 往外撑。
+ *  取 14 而不是 12：词盒高度由页面行高决定（`line-height: normal` 时只有 19px）——19＋24＝43，
+ *  **差 1px 不到 44 地板**（真指针普查实测有效命中 42）；14 撑到 47，加上样式里的 44 地板双重兜住。 */
+export const TOOLTIP_HIT_INSET_Y_PX = 14;
+//# sourceMappingURL=attrs.js.map

package/dist/components/tooltip/attrs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.js","sourceRoot":"","sources":["../../../src/components/tooltip/attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,kCAAkC;AAClC,MAAM,CAAC,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAEnD,gBAAgB;AAChB,MAAM,UAAU,YAAY,CAAC,MAAM,GAAG,QAAQ;IAC5C,OAAO,MAAM,GAAG,eAAe,CAAC;AAClC,CAAC;AAED,YAAY;AACZ,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,wCAAwC;IACxC,MAAM;IACN,mCAAmC;IACnC,MAAM;IACN,sCAAsC;IACtC,QAAQ;IACR,iCAAiC;IACjC,MAAM;IACN,sBAAsB;IACtB,OAAO;IACP,yBAAyB;IACzB,OAAO;IACP;2CACuC;IACvC,MAAM;IACN,aAAa;IACb,MAAM;IACN,8BAA8B;IAC9B,KAAK;CACG,CAAC;AAGX,mBAAmB;AACnB,MAAM,UAAU,WAAW,CAAC,IAAiB,EAAE,MAAM,GAAG,QAAQ;IAC9D,OAAO,YAAY,CAAC,MAAM,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC;AAC3C,CAAC;AAED,qCAAqC;AACrC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAM,CAAU,CAAC;AAG/C,qCAAqC;AACrC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,OAAO,CAAU,CAAC;AAG5D,mDAAmD;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAA2C,MAAM,CAAC,MAAM,CAAC;IACtF,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,MAAM;CACd,CAAC,CAAC;AAEH,uEAAuE;AAEvE,wBAAwB;AACxB,MAAM,CAAC,MAAM,YAAY,GAAG,oBAAoB,CAAC;AACjD,kCAAkC;AAClC,MAAM,CAAC,MAAM,iBAAiB,GAAG,yBAAyB,CAAC;AAC3D,oBAAoB;AACpB,MAAM,CAAC,MAAM,mBAAmB,GAAG,2BAA2B,CAAC;AAC/D,kBAAkB;AAClB,MAAM,CAAC,MAAM,kBAAkB,GAAG,0BAA0B,CAAC;AAE7D,qCAAqC;AACrC,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AACvD;;;2BAG2B;AAC3B,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAElD,mCAAmC;AACnC,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAC;AAChC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC;AACzC;+CAC+C;AAC/C,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC;AAEpC,6CAA6C;AAC7C,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AACpC,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAClC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AACnC;4CAC4C;AAC5C,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AACjC;;oEAEoE;AACpE,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC"}

package/dist/components/tooltip/index.d.ts

@@ -0,0 +1,28 @@
+/** tooltip · **组件出口**（该组件对外的唯一名字面）。
+ *
+ *  —— 气泡说明 · 形态 B「宽气泡（带『为什么重要』）」——
+ *
+ *  一句话：正文里那个**看不懂的词**后面补一句解释——点它／聚焦它／悬停它，弹出一条宽气泡：
+ *  眉标（口径／字段说明）＋ 小标题 ＋ 解释 ＋ **「为什么重要」**。走原生 `popover`：
+ *  点外面关、顶层都是浏览器给的，**脚本坏了也点得开**；运行时在场时「点那个词」这一步由它接管
+ *  （**只开不关**：浏览器对 `popovertarget` 触发键的那次开合会把悬停刚开好的气泡关掉）。
+ *
+ *  什么时候用它（对照既有件想清楚再选）：
+ *   · 要「给一个词补一句口径解释」（周均摄入、均摊、缺值）→ 用它；
+ *   · 要「一页统一交代口径」→ 用 `page-head` 的口径行；
+ *   · 要「贴着一颗键弹几条动作」→ 用 `popover-menu`（那是动作，不是说明）。
+ *
+ *  两件出口：
+ *   · `renderTooltip(input)` —— 产词 ＋ 气泡（纯函数，零 DOM；`popovertarget` 已接好）；
+ *   · `tooltipCss()` —— 该组件样式段（页面按需注入；不进 12 区闭集）；
+ *   · `buildTooltipJs()` —— 运行时（产出 JS 文本；DOM 只出现在文本里）。
+ *
+ *  完整用法与参数表见同目录 `README.md`。
+ */
+export { TOOLTIP_ANCHOR_PREFIX, TOOLTIP_ANCHOR_QUERY, TOOLTIP_ATTR, TOOLTIP_BADGES, TOOLTIP_BADGE_TEXT, TOOLTIP_BOUND_ATTR, TOOLTIP_BUBBLE_ATTR, TOOLTIP_CLASS, TOOLTIP_EDGE_PX, TOOLTIP_FORMS, TOOLTIP_HINT, TOOLTIP_HIT_INSET_Y_PX, TOOLTIP_HIT_PX, TOOLTIP_MARK, TOOLTIP_OFFSET_PX, TOOLTIP_SLOTS, TOOLTIP_WHY_LABEL, TOOLTIP_WIDTH_PX, TOOLTIP_WORD_ATTR, tooltipClass, tooltipSlot, } from './attrs.js';
+export type { TooltipBadge, TooltipForm, TooltipInput, TooltipSlot } from './attrs.js';
+export { renderTooltip } from './render.js';
+export { tooltipCss } from './style.js';
+export type { TooltipCssInput } from './style.js';
+export { buildTooltipJs } from './runtime.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/tooltip/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/tooltip/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EACL,qBAAqB,EAAE,oBAAoB,EAAE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAC7F,kBAAkB,EAAE,mBAAmB,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EACpG,sBAAsB,EAAE,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,iBAAiB,EACzG,gBAAgB,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,GAC/D,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/components/tooltip/index.js

@@ -0,0 +1,26 @@
+/** tooltip · **组件出口**（该组件对外的唯一名字面）。
+ *
+ *  —— 气泡说明 · 形态 B「宽气泡（带『为什么重要』）」——
+ *
+ *  一句话：正文里那个**看不懂的词**后面补一句解释——点它／聚焦它／悬停它，弹出一条宽气泡：
+ *  眉标（口径／字段说明）＋ 小标题 ＋ 解释 ＋ **「为什么重要」**。走原生 `popover`：
+ *  点外面关、顶层都是浏览器给的，**脚本坏了也点得开**；运行时在场时「点那个词」这一步由它接管
+ *  （**只开不关**：浏览器对 `popovertarget` 触发键的那次开合会把悬停刚开好的气泡关掉）。
+ *
+ *  什么时候用它（对照既有件想清楚再选）：
+ *   · 要「给一个词补一句口径解释」（周均摄入、均摊、缺值）→ 用它；
+ *   · 要「一页统一交代口径」→ 用 `page-head` 的口径行；
+ *   · 要「贴着一颗键弹几条动作」→ 用 `popover-menu`（那是动作，不是说明）。
+ *
+ *  两件出口：
+ *   · `renderTooltip(input)` —— 产词 ＋ 气泡（纯函数，零 DOM；`popovertarget` 已接好）；
+ *   · `tooltipCss()` —— 该组件样式段（页面按需注入；不进 12 区闭集）；
+ *   · `buildTooltipJs()` —— 运行时（产出 JS 文本；DOM 只出现在文本里）。
+ *
+ *  完整用法与参数表见同目录 `README.md`。
+ */
+export { TOOLTIP_ANCHOR_PREFIX, TOOLTIP_ANCHOR_QUERY, TOOLTIP_ATTR, TOOLTIP_BADGES, TOOLTIP_BADGE_TEXT, TOOLTIP_BOUND_ATTR, TOOLTIP_BUBBLE_ATTR, TOOLTIP_CLASS, TOOLTIP_EDGE_PX, TOOLTIP_FORMS, TOOLTIP_HINT, TOOLTIP_HIT_INSET_Y_PX, TOOLTIP_HIT_PX, TOOLTIP_MARK, TOOLTIP_OFFSET_PX, TOOLTIP_SLOTS, TOOLTIP_WHY_LABEL, TOOLTIP_WIDTH_PX, TOOLTIP_WORD_ATTR, tooltipClass, tooltipSlot, } from './attrs.js';
+export { renderTooltip } from './render.js';
+export { tooltipCss } from './style.js';
+export { buildTooltipJs } from './runtime.js';
+//# sourceMappingURL=index.js.map

package/dist/components/tooltip/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/tooltip/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EACL,qBAAqB,EAAE,oBAAoB,EAAE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAC7F,kBAAkB,EAAE,mBAAmB,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EACpG,sBAAsB,EAAE,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,iBAAiB,EACzG,gBAAgB,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,GAC/D,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/components/tooltip/model.d.ts

@@ -0,0 +1,18 @@
+import { type TooltipBadge, type TooltipForm, type TooltipInput } from './attrs.js';
+/** 内部类型。 */
+export interface TooltipModel {
+    readonly id: string;
+    readonly form: TooltipForm;
+    readonly word: string;
+    readonly title: string;
+    readonly text: string;
+    readonly why: string;
+    readonly badge: TooltipBadge;
+    readonly badgeText: string;
+    readonly hint: string;
+    readonly extraClass?: string;
+}
+/** 入参归一化（**唯一入口**：`render.ts` 只吃它产出的 `TooltipModel`）。 */
+export declare function normalizeTooltip(input: unknown): TooltipModel;
+export type { TooltipInput };
+//# sourceMappingURL=model.d.ts.map

package/dist/components/tooltip/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/components/tooltip/model.ts"],"names":[],"mappings":"AAUA,OAAO,EAEL,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EACvD,MAAM,YAAY,CAAC;AAKpB,YAAY;AACZ,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CA6B7D;AAED,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/dist/components/tooltip/model.js

@@ -0,0 +1,44 @@
+/** tooltip · **入参归一化与校验**（把 `any` 与说不出的 `unknown` 挡在门外，产出内部类型）。
+ *
+ *  三条口径：
+ *   1. **非法入参一律 `badInput()`**（抛 `BlocksError`）——不静默降级；
+ *   2. **`id` 只许标识符字符**：它同时喂 `id=`／`popovertarget=`／`aria-describedby=`／
+ *      **逐实例锚名** `--tooltip-<id>`（**不带 `ilife-`**：那是皮肤 token 的命名空间，锚名是结构不是语言）；
+ *   3. **`why` 必填**：形态 B 的识别特征就是那一段「为什么重要」——省掉它，这条气泡就退化成
+ *      「再说一遍词面意思」，读的人拿不到新信息（原型墙裁定里这一档正是被选中的理由）。
+ */
+import { assertPlainObject, badInput, optExtraClass, optText, reqText } from '../shared/validate.js';
+import { TOOLTIP_BADGES, TOOLTIP_BADGE_TEXT, TOOLTIP_FORMS, TOOLTIP_HINT, } from './attrs.js';
+/** `id` 的字面口径（与同族其余件同一套；本件自足，不从别的件取）。 */
+const ID_RE = /^[A-Za-z0-9_\u00a0-\uffff][A-Za-z0-9_-\u00a0-\uffff]*$/;
+/** 入参归一化（**唯一入口**：`render.ts` 只吃它产出的 `TooltipModel`）。 */
+export function normalizeTooltip(input) {
+    assertPlainObject(input, 'renderTooltip: input');
+    const raw = input;
+    const form = raw.form === undefined ? TOOLTIP_FORMS[0] : raw.form;
+    if (!TOOLTIP_FORMS.includes(form)) {
+        badInput('tooltip: input.form 必须是 ' + TOOLTIP_FORMS.join('／') + ' 之一（本件只落地形态 B「宽气泡」）');
+    }
+    const badge = raw.badge === undefined ? TOOLTIP_BADGES[0] : raw.badge;
+    if (!TOOLTIP_BADGES.includes(badge)) {
+        badInput('tooltip: input.badge 必须是 ' + TOOLTIP_BADGES.join('／') + ' 之一');
+    }
+    const id = reqText(raw.id, 'tooltip: input.id');
+    if (!ID_RE.test(id)) {
+        badInput('tooltip: input.id 只许标识符字符（字母／数字／下划线／连字符／汉字）：' + id);
+    }
+    return {
+        id,
+        form: form,
+        word: reqText(raw.word, 'tooltip: input.word'),
+        title: reqText(raw.title, 'tooltip: input.title'),
+        text: reqText(raw.text, 'tooltip: input.text'),
+        why: reqText(raw.why, 'tooltip: input.why（形态 B 的识别特征就是这一段：省掉它，这条气泡只剩下词面意思）'),
+        badge: badge,
+        badgeText: optText(raw.badgeText, 'tooltip: input.badgeText') ?? TOOLTIP_BADGE_TEXT[badge],
+        /* `hint` 给了空串＝不出那一格（`optText` 把空串按「未给」处理 ⇒ 这里显式分辨「给了空串」）。 */
+        hint: typeof raw.hint === 'string' && raw.hint.trim() === '' ? '' : (optText(raw.hint, 'tooltip: input.hint') ?? TOOLTIP_HINT),
+        extraClass: optExtraClass(raw.extraClass, 'tooltip: input.extraClass'),
+    };
+}
+//# sourceMappingURL=model.js.map

package/dist/components/tooltip/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../src/components/tooltip/model.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrG,OAAO,EACL,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,YAAY,GAEhE,MAAM,YAAY,CAAC;AAEpB,yCAAyC;AACzC,MAAM,KAAK,GAAG,wDAAwD,CAAC;AAgBvE,yDAAyD;AACzD,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAE7C,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IAClE,IAAI,CAAE,aAAoC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1D,QAAQ,CAAC,0BAA0B,GAAG,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,qBAAqB,CAAC,CAAC;IACzF,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;IACtE,IAAI,CAAE,cAAqC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5D,QAAQ,CAAC,2BAA2B,GAAG,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,mBAAmB,CAAC,CAAC;IAChD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACpB,QAAQ,CAAC,8CAA8C,GAAG,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,OAAO;QACL,EAAE;QACF,IAAI,EAAE,IAAmB;QACzB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,qBAAqB,CAAC;QAC9C,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,sBAAsB,CAAC;QACjD,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,qBAAqB,CAAC;QAC9C,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,qDAAqD,CAAC;QAC5E,KAAK,EAAE,KAAqB;QAC5B,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,0BAA0B,CAAC,IAAI,kBAAkB,CAAC,KAAqB,CAAC;QAC1G,6DAA6D;QAC7D,IAAI,EAAE,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,qBAAqB,CAAC,IAAI,YAAY,CAAC;QAC9H,UAAU,EAAE,aAAa,CAAC,GAAG,CAAC,UAAU,EAAE,2BAA2B,CAAC;KACvE,CAAC;AACJ,CAAC"}

package/dist/components/tooltip/render.d.ts

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

package/dist/components/tooltip/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/components/tooltip/render.ts"],"names":[],"mappings":"AA2DA,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMpD"}

package/dist/components/tooltip/render.js

@@ -0,0 +1,61 @@
+/** tooltip · **渲染**（纯函数产 HTML；本件只有形态 B「宽气泡」一种骨架）。
+ *
+ *  —— 形态 B：宽气泡（带「为什么重要」）——
+ *
+ *  骨架＝正文里**一个词**（真 `<button>`）＋ 一条**宽气泡**（眉标 ＋ 小标题 ＋ 解释 ＋
+ *  「为什么重要」那一段）。它替掉的两种错法：
+ *   · 用 `title` 属性顶事——手机上根本弹不出来、样式不可控、一屏只给一行的纯文本；
+ *   · 把口径写成正文里的一句灰字——读的人分不清「哪句是正文、哪句是算法说明」。
+ *
+ *  三条硬口径（判据断的就是它们）：
+ *   · 词是**真 `<button type=button>`**：`aria-describedby` 指着气泡（屏读器读得到），
+ *     气泡是 `popover` ＋ `role=tooltip`（点外面关是浏览器给的）；
+ *   · **三条通路都出得来**：点击（`popovertarget`；运行时在场时由它接管开合，见 `runtime.ts`）／
+ *     聚焦（键盘增强）／悬停（细指针设备）——三条通路都**只开不关**；
+ *   · 词在行里，**视觉盒不撑行**：≥44×44 的命中盒靠看不见的一圈 `::after` 往外撑。
+ */
+import { esc } from '../shared/escape.js';
+import { TOOLTIP_ANCHOR_PREFIX, TOOLTIP_ATTR, TOOLTIP_BUBBLE_ATTR, TOOLTIP_MARK, TOOLTIP_WHY_LABEL, TOOLTIP_WORD_ATTR, tooltipClass, tooltipSlot, } from './attrs.js';
+import { normalizeTooltip } from './model.js';
+/** 被解释的那个词：真按钮 ＋ 一枚问号记号（整词是命中区）。 */
+function wordHtml(m) {
+    return '<button class="' + tooltipSlot('word') + '" type="button"'
+        + ' id="' + esc(m.id) + '-word"'
+        + ' popovertarget="' + esc(m.id) + '"'
+        + ' aria-describedby="' + esc(m.id) + '"'
+        + ' ' + TOOLTIP_WORD_ATTR + '="' + esc(m.id) + '"'
+        + ' style="anchor-name:' + esc(TOOLTIP_ANCHOR_PREFIX + m.id) + '">'
+        + esc(m.word)
+        + '<span class="' + tooltipSlot('mark') + '" aria-hidden="true">' + esc(TOOLTIP_MARK) + '</span>'
+        + '</button>';
+}
+/** 气泡：眉标 ＋ 小标题 ＋ 关掉的提示 ／ 解释 ／ **为什么重要**。 */
+function bubbleHtml(m) {
+    const hint = m.hint === '' ? '' : '<span class="' + tooltipSlot('hint') + '">' + esc(m.hint) + '</span>';
+    return '<span class="' + tooltipSlot('bubble') + '"'
+        + ' id="' + esc(m.id) + '"'
+        + ' popover="auto" role="tooltip"'
+        + ' style="position-anchor:' + esc(TOOLTIP_ANCHOR_PREFIX + m.id) + '"'
+        + ' ' + TOOLTIP_BUBBLE_ATTR + '="' + esc(m.id) + '">'
+        + '<span class="' + tooltipSlot('head') + '">'
+        + '<b class="' + tooltipSlot('badge') + '">' + esc(m.badgeText) + '</b>'
+        + '<b class="' + tooltipSlot('title') + '">' + esc(m.title) + '</b>'
+        + hint
+        + '</span>'
+        + '<span class="' + tooltipSlot('text') + '">' + esc(m.text) + '</span>'
+        + '<span class="' + tooltipSlot('why') + '"><b>' + esc(TOOLTIP_WHY_LABEL) + '</b>' + esc(m.why) + '</span>'
+        + '</span>';
+}
+/** 形态 → 骨架（本件只有一格）。 */
+const SKELETONS = {
+    wide: (m) => wordHtml(m) + bubbleHtml(m),
+};
+/** 渲染一条气泡说明（纯函数：同样的入参恒产同样的字节；转义只经 `shared/escape.ts`）。 */
+export function renderTooltip(input) {
+    const m = normalizeTooltip(input);
+    const classes = [tooltipClass(), 'is-' + m.form]
+        .concat(m.extraClass === undefined ? [] : [m.extraClass]).join(' ');
+    return '<span class="' + esc(classes) + '" ' + TOOLTIP_ATTR + '="' + esc(m.id) + '">'
+        + SKELETONS[m.form](m) + '</span>';
+}
+//# sourceMappingURL=render.js.map

package/dist/components/tooltip/render.js.map

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

package/dist/components/tooltip/runtime.d.ts

@@ -0,0 +1,3 @@
+/** 产出运行时的 JS 文本（经典 script 作用域可跑的 IIFE；由页面拼进共享 helpers 槽）。 */
+export declare function buildTooltipJs(): string;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/components/tooltip/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/components/tooltip/runtime.ts"],"names":[],"mappings":"AAwBA,6DAA6D;AAC7D,wBAAgB,cAAc,IAAI,MAAM,CAgFvC"}

package/dist/components/tooltip/runtime.js

@@ -0,0 +1,103 @@
+/** tooltip · **运行时**（产出 JS 文本；DOM 只允许出现在这段文本里）。
+ *
+ *  分工与同族其余件一致：模块代码零 DOM，DOM 只在产出的字符串里。
+ *
+ *  行为契约（逐条对应判据）：
+ *   · **点那个词＝恒开，不参与开合**：带 `popovertarget` 的触发键，浏览器会在 `click` **之后**再开合一次
+ *     （实测时序 `pointerover → toggle(开) → pointerdown → focusin → pointerup → mouseup → click → toggle(关)`）
+ *     ⇒ 悬停刚开好的气泡被紧接的那一点**关掉**。本段在 `click` 上 `preventDefault()` 拦掉那次原生开合，
+ *     再自己 `show()`：**点一下只会开，永不会关**。
+ *     （`popovertarget` 属性留着：**运行时不在场时**它仍是白送的点击通路——脚本坏了也点得开。）
+ *   · **三条通路都只开不关**：点击／**聚焦**（键盘增强）／**悬停**（细指针设备）——触摸没有悬停那一口，
+ *     照样由 `click` 那一步打开。
+ *   · **关只有两条**：**点别处**（`popover=auto` 的浏览器点外关，本段不拦）与**指针／焦点离开**后的延时收。
+ *   · **悬停不留残留**：`pointerout` 之后延一小会儿再收，指针落回词上或气泡上就撤掉这次收
+ *     （气泡本身也可以正常读、可以滚）；`focusout` 同理。
+ *   · **降级定位**：引擎不支持锚定 API 时（与 CSS 的 `@supports` 读**同一份能力查询串**），
+ *     打开时按词的位置算 `top`（贴不下就翻到词上方）；横轴与宽度归 CSS（宽气泡夹在容器里）。
+ *   · **不许抢焦点**：悬停打开**不移动焦点**（焦点是键盘用户的东西）；`Esc` 关掉后焦点原地不动。
+ */
+import { TOOLTIP_ANCHOR_QUERY, TOOLTIP_ATTR, TOOLTIP_BOUND_ATTR, TOOLTIP_BUBBLE_ATTR, TOOLTIP_OFFSET_PX, TOOLTIP_WORD_ATTR, } from './attrs.js';
+/** 产出运行时的 JS 文本（经典 script 作用域可跑的 IIFE；由页面拼进共享 helpers 槽）。 */
+export function buildTooltipJs() {
+    const q = (s) => JSON.stringify(s);
+    return '(function(){' + '\n'
+        + '  var ATTR=' + q(TOOLTIP_ATTR) + ', WORD=' + q(TOOLTIP_WORD_ATTR) + ', BUBBLE=' + q(TOOLTIP_BUBBLE_ATTR) + ';' + '\n'
+        + '  var BOUND=' + q(TOOLTIP_BOUND_ATTR) + ', AQ=' + q(TOOLTIP_ANCHOR_QUERY) + ';' + '\n'
+        + '  var OFF=' + q(String(TOOLTIP_OFFSET_PX)) + ';' + '\n'
+        + '  var doc=document;' + '\n'
+        + '  if (doc.documentElement.getAttribute("data-ilife-tooltip-runtime")==="1") return;' + '\n'
+        + '  doc.documentElement.setAttribute("data-ilife-tooltip-runtime","1");' + '\n'
+        + '  var canAnchor=!!(window.CSS && CSS.supports && CSS.supports(AQ));' + '\n'
+        + '  var timers=[], pending=[];' + '\n'
+        + '  function boxOf(el){ return (el && el.closest) ? el.closest("["+ATTR+"]") : null; }' + '\n'
+        + '  function isOpen(b){ try{ return b.matches(":popover-open"); }catch(e){ return false; } }' + '\n'
+        + '  function place(bubble){' + '\n'
+        + '    var w=boxOf(bubble); if (!w) return;' + '\n'
+        + '    var word=w.querySelector("["+WORD+"]"); if (!word) return;' + '\n'
+        + '    var r=word.getBoundingClientRect(), h=bubble.offsetHeight;' + '\n'
+        + '    var vh=doc.documentElement.clientHeight;' + '\n'
+        + '    var top=r.bottom+8;' + '\n'
+        + '    if (top+h > vh-8) top=Math.max(8, r.top-h-8);' + '\n'
+        + '    bubble.style.top=top+"px"; bubble.style.bottom="auto";' + '\n'
+        + '  }' + '\n'
+        + '  function cancelHide(bubble){' + '\n'
+        + '    var i=pending.indexOf(bubble); if (i<0) return;' + '\n'
+        + '    clearTimeout(timers[i]); pending.splice(i,1); timers.splice(i,1);' + '\n'
+        + '  }' + '\n'
+        + '  function show(bubble){' + '\n'
+        + '    if (!bubble) return;' + '\n'
+        + '    cancelHide(bubble);' + '\n'
+        + '    if (isOpen(bubble)) return;' + '\n'
+        + '    if (typeof bubble.showPopover!=="function") return;' + '\n'
+        + '    try{ bubble.showPopover(); }catch(e){ return; }' + '\n'
+        + '    if (!canAnchor) place(bubble);' + '\n'
+        + '  }' + '\n'
+        + '  function hide(bubble){' + '\n'
+        + '    if (!bubble || !isOpen(bubble)) return;' + '\n'
+        + '    if (typeof bubble.hidePopover!=="function") return;' + '\n'
+        + '    try{ bubble.hidePopover(); }catch(e){}' + '\n'
+        + '    if (bubble.style.top){ bubble.style.top=""; }' + '\n'
+        + '  }' + '\n'
+        + '  function hideLater(bubble){' + '\n'
+        + '    var i=pending.indexOf(bubble); if (i>=0) return;' + '\n'
+        + '    pending.push(bubble);' + '\n'
+        + '    timers.push(setTimeout(function(){' + '\n'
+        + '      var j=pending.indexOf(bubble); if (j>=0){ pending.splice(j,1); timers.splice(j,1); }' + '\n'
+        + '      hide(bubble);' + '\n'
+        + '    }, 140));' + '\n'
+        + '  }' + '\n'
+        + '  doc.addEventListener("pointerover", function(e){' + '\n'
+        + '    var w=boxOf(e.target); if (!w){ return; }' + '\n'
+        + '    show(w.querySelector("["+BUBBLE+"]"));' + '\n'
+        + '  });' + '\n'
+        + '  doc.addEventListener("pointerout", function(e){' + '\n'
+        + '    var w=boxOf(e.target); if (!w) return;' + '\n'
+        + '    if (e.relatedTarget && w.contains(e.relatedTarget)) return;' + '\n'
+        + '    hideLater(w.querySelector("["+BUBBLE+"]"));' + '\n'
+        + '  });' + '\n'
+        + '  doc.addEventListener("focusin", function(e){' + '\n'
+        + '    var w=boxOf(e.target); if (!w) return;' + '\n'
+        + '    show(w.querySelector("["+BUBBLE+"]"));' + '\n'
+        + '  });' + '\n'
+        + '  doc.addEventListener("focusout", function(e){' + '\n'
+        + '    var w=boxOf(e.target); if (!w) return;' + '\n'
+        + '    if (e.relatedTarget && w.contains(e.relatedTarget)) return;' + '\n'
+        + '    hideLater(w.querySelector("["+BUBBLE+"]"));' + '\n'
+        + '  });' + '\n'
+        /* 点那个词：**恒开，不参与开合**。`preventDefault()` 拦掉浏览器对 `popovertarget` 触发键的那次开合
+           （它在 `click` 之后跑，正是「悬停开好了、一按又关掉」的成因），随后自己 `show()`——
+           关只留给「点别处」（浏览器点外关）与指针／焦点离开后的延时收。 */
+        + '  doc.addEventListener("click", function(e){' + '\n'
+        + '    var t=e.target; if (!t || !t.closest) return;' + '\n'
+        + '    var word=t.closest("["+WORD+"]"); if (!word) return;' + '\n'
+        + '    var w=boxOf(word); if (!w) return;' + '\n'
+        + '    var b=w.querySelector("["+BUBBLE+"]"); if (!b) return;' + '\n'
+        + '    if (e.cancelable) e.preventDefault();' + '\n'
+        + '    show(b);' + '\n'
+        + '  });' + '\n'
+        + '  var all=doc.querySelectorAll("["+WORD+"]");' + '\n'
+        + '  for (var i=0;i<all.length;i+=1) all[i].setAttribute(BOUND,"1");' + '\n'
+        + '}());';
+}
+//# sourceMappingURL=runtime.js.map

package/dist/components/tooltip/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/components/tooltip/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EACL,oBAAoB,EAAE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,iBAAiB,EAC9F,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,6DAA6D;AAC7D,MAAM,UAAU,cAAc;IAC5B,MAAM,CAAC,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACnD,OAAO,cAAc,GAAG,IAAI;UACxB,aAAa,GAAG,CAAC,CAAC,YAAY,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,iBAAiB,CAAC,GAAG,WAAW,GAAG,CAAC,CAAC,mBAAmB,CAAC,GAAG,GAAG,GAAG,IAAI;UACtH,cAAc,GAAG,CAAC,CAAC,kBAAkB,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC,oBAAoB,CAAC,GAAG,GAAG,GAAG,IAAI;UACvF,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI;UACxD,qBAAqB,GAAG,IAAI;UAC5B,qFAAqF,GAAG,IAAI;UAC5F,uEAAuE,GAAG,IAAI;UAC9E,qEAAqE,GAAG,IAAI;UAC5E,8BAA8B,GAAG,IAAI;UACrC,sFAAsF,GAAG,IAAI;UAC7F,4FAA4F,GAAG,IAAI;UACnG,2BAA2B,GAAG,IAAI;UAClC,0CAA0C,GAAG,IAAI;UACjD,gEAAgE,GAAG,IAAI;UACvE,gEAAgE,GAAG,IAAI;UACvE,8CAA8C,GAAG,IAAI;UACrD,yBAAyB,GAAG,IAAI;UAChC,mDAAmD,GAAG,IAAI;UAC1D,4DAA4D,GAAG,IAAI;UACnE,KAAK,GAAG,IAAI;UACZ,gCAAgC,GAAG,IAAI;UACvC,qDAAqD,GAAG,IAAI;UAC5D,uEAAuE,GAAG,IAAI;UAC9E,KAAK,GAAG,IAAI;UACZ,0BAA0B,GAAG,IAAI;UACjC,0BAA0B,GAAG,IAAI;UACjC,yBAAyB,GAAG,IAAI;UAChC,iCAAiC,GAAG,IAAI;UACxC,yDAAyD,GAAG,IAAI;UAChE,qDAAqD,GAAG,IAAI;UAC5D,oCAAoC,GAAG,IAAI;UAC3C,KAAK,GAAG,IAAI;UACZ,0BAA0B,GAAG,IAAI;UACjC,6CAA6C,GAAG,IAAI;UACpD,yDAAyD,GAAG,IAAI;UAChE,4CAA4C,GAAG,IAAI;UACnD,mDAAmD,GAAG,IAAI;UAC1D,KAAK,GAAG,IAAI;UACZ,+BAA+B,GAAG,IAAI;UACtC,sDAAsD,GAAG,IAAI;UAC7D,2BAA2B,GAAG,IAAI;UAClC,wCAAwC,GAAG,IAAI;UAC/C,4FAA4F,GAAG,IAAI;UACnG,qBAAqB,GAAG,IAAI;UAC5B,eAAe,GAAG,IAAI;UACtB,KAAK,GAAG,IAAI;UACZ,oDAAoD,GAAG,IAAI;UAC3D,+CAA+C,GAAG,IAAI;UACtD,4CAA4C,GAAG,IAAI;UACnD,OAAO,GAAG,IAAI;UACd,mDAAmD,GAAG,IAAI;UAC1D,4CAA4C,GAAG,IAAI;UACnD,iEAAiE,GAAG,IAAI;UACxE,iDAAiD,GAAG,IAAI;UACxD,OAAO,GAAG,IAAI;UACd,gDAAgD,GAAG,IAAI;UACvD,4CAA4C,GAAG,IAAI;UACnD,4CAA4C,GAAG,IAAI;UACnD,OAAO,GAAG,IAAI;UACd,iDAAiD,GAAG,IAAI;UACxD,4CAA4C,GAAG,IAAI;UACnD,iEAAiE,GAAG,IAAI;UACxE,iDAAiD,GAAG,IAAI;UACxD,OAAO,GAAG,IAAI;QAChB;;6CAEqC;UACnC,8CAA8C,GAAG,IAAI;UACrD,mDAAmD,GAAG,IAAI;UAC1D,0DAA0D,GAAG,IAAI;UACjE,wCAAwC,GAAG,IAAI;UAC/C,4DAA4D,GAAG,IAAI;UACnE,2CAA2C,GAAG,IAAI;UAClD,cAAc,GAAG,IAAI;UACrB,OAAO,GAAG,IAAI;UACd,+CAA+C,GAAG,IAAI;UACtD,mEAAmE,GAAG,IAAI;UAC1E,OAAO,CAAC;AACd,CAAC"}

package/dist/components/tooltip/style.d.ts

@@ -0,0 +1,8 @@
+/** 本件样式段的入参。 */
+export interface TooltipCssInput {
+    /** 类名前缀；缺省 `ilife-`。 */
+    readonly prefix?: string;
+}
+/** 本组件的样式段。 */
+export declare function tooltipCss(input?: TooltipCssInput): string;
+//# sourceMappingURL=style.d.ts.map

package/dist/components/tooltip/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../../src/components/tooltip/style.ts"],"names":[],"mappings":"AA0BA,gBAAgB;AAChB,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,eAAe;AACf,wBAAgB,UAAU,CAAC,KAAK,CAAC,EAAE,eAAe,GAAG,MAAM,CAkE1D"}