base-paint 0.3.13 → 0.3.15

package/dist/components/popover-menu/attrs.js

@@ -0,0 +1,81 @@
+/** popover-menu · **标记契约**（渲染与运行时共用的唯一事实：类名／`data-*`／事件名／闭集／入参类型）。
+ *
+ *  这一件落地的是原型墙（`.scratch/ui-组件墙/parts-10-容器与浮层.mjs`，2026-09 用户裁定）
+ *  里的**形态 A「贴着按钮＝复制格式」**——一颗触发键 ＋ 贴着它弹出来的小菜单
+ *  （分组头、快捷键、当前项打勾、危险项垫最后）。用在哪：六个技能的复制格式、更多操作、快捷切换。
+ *
+ *  落地路线（票面钉死）：**`popover` 属性**——
+ *   · 开／关／`Esc`／点外面关，浏览器白送（触发键带 `popovertarget`，**一行脚本都没有也开得出来**）；
+ *   · 定位：`@supports (anchor-name: --a)` **之内**才用 CSS 锚定定位（`position-area` ＋
+ *     `position-try-fallbacks` 贴不下就翻边），**之外**退回普通定位（打开时由运行时按触发键的矩形算边距）；
+ *   · 逐实例锚名从 `id` 算：`--ilife-menu-<id>`，由标记写进 `style` 属性（静态 CSS 认不出逐实例名字）。
+ */
+/** 本件的类名根（挂在包住「触发键 ＋ 面板」的那层容器上）。 */
+export const MENU_CLASS = 'ilife-block-popover-menu';
+/** 类名根（带前缀）。 */
+export function menuClass(prefix = 'ilife-') {
+    return prefix + 'block-popover-menu';
+}
+/** 槽位闭集。 */
+export const MENU_SLOTS = [
+    /** 触发键（贴着它弹菜单的那颗）。 */
+    'trigger',
+    /** 面板（`popover` ＋ `role=menu`）。 */
+    'panel',
+    /** 分组头（「文字」「数据」这一行）。 */
+    'group',
+    /** 发丝线分隔（比分组头弱一档的分法）。 */
+    'sep',
+    /** 一枚菜单项。 */
+    'item',
+    /** 项里的主文字格。 */
+    'key',
+    /** 项里的次文字（如「带标题与表格」）。 */
+    'note',
+    /** 项右端的快捷键位。 */
+    'shortcut',
+    /** 项左端的打勾位（`kind=check` 才出）。 */
+    'tick',
+];
+/** 槽类的类名（唯一拼法）。 */
+export function menuSlot(slot, prefix = 'ilife-') {
+    return menuClass(prefix) + '-' + slot;
+}
+/** 形态闭集：本件只落地形态 A「贴着按钮」。 */
+export const MENU_FORMS = ['hug'];
+/** 贴哪一边（横向）：`end`＝面板右缘贴触发键右缘（贴右，缺省）／`start`＝左缘贴左缘。 */
+export const MENU_ALIGNS = ['start', 'end'];
+/** 项的档闭集：`action`（普通）／`check`（当前项打勾）／`danger`（危险项）。 */
+export const MENU_KINDS = ['action', 'check', 'danger'];
+/* ── `data-*` 名 ─────────────────────────────────────────────────── */
+/** 容器的发现锚：值＝菜单 `id`。 */
+export const MENU_ATTR = 'data-ilife-popover-menu';
+/** 触发键：值＝菜单 `id`。 */
+export const MENU_TRIGGER_ATTR = 'data-ilife-menu-trigger';
+/** 面板：值＝菜单 `id`；**降级路的开关**（值＝`end`／`start`，运行时按它算贴哪边）。 */
+export const MENU_PANEL_ATTR = 'data-ilife-menu-panel';
+/** 一枚菜单项：值＝该项的机器值。 */
+export const MENU_ITEM_ATTR = 'data-ilife-menu-item';
+/** 绑定完成标记（幂等）。 */
+export const MENU_BOUND_ATTR = 'data-ilife-menu-bound';
+/** 事件名（冒泡 `CustomEvent`；`detail` 见 README 的「交互契约」）。 */
+export const MENU_EVENT_SELECT = 'ilife:menu-select';
+/** 面板开／关时派发（`detail.phase`＝`open`／`close`）——页面拿它记账或联动，不拿它开菜单。 */
+export const MENU_EVENT_TOGGLE = 'ilife:menu-toggle';
+/** 锚定定位的两条能力查询：**CSS 与运行时读同一个串**（两边判据必须说同一件事，否则会各走各的）。 */
+export const MENU_ANCHOR_QUERY = 'anchor-name: --a';
+export const MENU_AREA_QUERY = 'position-area: bottom';
+/** 逐实例锚名的前缀（完整名＝`--ilife-menu-<id>`；触发键与面板**写同一个名字**）。 */
+export const MENU_ANCHOR_PREFIX = '--ilife-menu-';
+/** 几何口径：触发键与菜单项的命中高度下限／相邻命中区间距／面板宽上限／离容器边至少留多少。 */
+export const MENU_MIN_HEIGHT_PX = 44;
+export const MENU_GAP_PX = 8;
+export const MENU_EDGE_PX = 12;
+export const MENU_WIDTH_PX = 262;
+export const MENU_MAX_HEIGHT_PX = 320;
+/** 面板与触发键之间那道缝（锚定定位下是 `margin`，降级路下是同一个数）。 */
+export const MENU_OFFSET_PX = 8;
+/** 触发键上那枚「会弹出东西」的记号（纯装饰，`aria-hidden`）。 */
+export const MENU_CARET = '▾';
+/** 打勾位那枚记号（纯装饰；`aria-checked` 才是语义）。 */
+export const MENU_TICK = '✓';

package/dist/components/popover-menu/attrs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attrs.js","sourceRoot":"","sources":["../../../src/components/popover-menu/attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,oCAAoC;AACpC,MAAM,CAAC,MAAM,UAAU,GAAG,0BAA0B,CAAC;AAErD,gBAAgB;AAChB,MAAM,UAAU,SAAS,CAAC,MAAM,GAAG,QAAQ;IACzC,OAAO,MAAM,GAAG,oBAAoB,CAAC;AACvC,CAAC;AAED,YAAY;AACZ,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,sBAAsB;IACtB,SAAS;IACT,mCAAmC;IACnC,OAAO;IACP,wBAAwB;IACxB,OAAO;IACP,yBAAyB;IACzB,KAAK;IACL,aAAa;IACb,MAAM;IACN,eAAe;IACf,KAAK;IACL,yBAAyB;IACzB,MAAM;IACN,gBAAgB;IAChB,UAAU;IACV,gCAAgC;IAChC,MAAM;CACE,CAAC;AAGX,mBAAmB;AACnB,MAAM,UAAU,QAAQ,CAAC,IAAc,EAAE,MAAM,GAAG,QAAQ;IACxD,OAAO,SAAS,CAAC,MAAM,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC;AACxC,CAAC;AAED,4BAA4B;AAC5B,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAK,CAAU,CAAC;AAG3C,sDAAsD;AACtD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,KAAK,CAAU,CAAC;AAGrD,uDAAuD;AACvD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAU,CAAC;AAGjE,uEAAuE;AAEvE,wBAAwB;AACxB,MAAM,CAAC,MAAM,SAAS,GAAG,yBAAyB,CAAC;AACnD,qBAAqB;AACrB,MAAM,CAAC,MAAM,iBAAiB,GAAG,yBAAyB,CAAC;AAC3D,0DAA0D;AAC1D,MAAM,CAAC,MAAM,eAAe,GAAG,uBAAuB,CAAC;AACvD,sBAAsB;AACtB,MAAM,CAAC,MAAM,cAAc,GAAG,sBAAsB,CAAC;AACrD,kBAAkB;AAClB,MAAM,CAAC,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAEvD,uDAAuD;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AACrD,iEAAiE;AACjE,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AAErD,0DAA0D;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AACpD,MAAM,CAAC,MAAM,eAAe,GAAG,uBAAuB,CAAC;AACvD,0DAA0D;AAC1D,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAElD,mDAAmD;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AACrC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAC7B,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAC/B,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AACjC,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AACtC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEhC,2CAA2C;AAC3C,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC;AAC9B,wCAAwC;AACxC,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC"}

package/dist/components/popover-menu/index.d.ts

@@ -0,0 +1,33 @@
+/** popover-menu · **组件出口**（该组件对外的唯一名字面）。
+ *
+ *  —— 浮出菜单 · 形态 A「贴着按钮」——
+ *
+ *  一句话：把几条动作**贴着触发它的那颗键**弹出来（分组头、快捷键、当前项打勾、危险项垫最后）——
+ *  走原生 `popover`：点外面关、`Esc` 关、顶层都是浏览器给的，**脚本坏了也开得出来**。
+ *
+ *  什么时候用它（对照既有件想清楚再选）：
+ *   · 要「贴着一颗键弹出几条动作」（复制格式、更多操作、快捷切换）→ 用它；
+ *   · 要「页面里摆一排常态可见的动作」→ 用 `action-bar`；
+ *   · 要「确认一件破坏性的事」→ 用 `dialog`；要「从一长串里勾几个」→ 用 `drawer-sheet`。
+ *
+ *  两件出口：
+ *   · `renderPopoverMenu(input)` —— 产触发键 ＋ 面板（纯函数，零 DOM；`popovertarget` 已接好）；
+ *   · `popoverMenuCss()` —— 该组件样式段（页面按需注入；不进 12 区闭集）；
+ *   · `buildPopoverMenuJs()` —— 运行时（产出 JS 文本；DOM 只出现在文本里）。
+ *
+ *  页面怎么接自己的逻辑（不引入任何全局）：
+ *  ```js
+ *  document.addEventListener('ilife:menu-select', (e) => {
+ *    const { id, value, kind } = e.detail;   // 面板已关、焦点已还给触发键
+ *    if (id === 'menu-copy' && value === 'markdown') copyAsMarkdown();
+ *  });
+ *  ```
+ *  完整用法与参数表见同目录 `README.md`。
+ */
+export { MENU_ALIGNS, MENU_ANCHOR_PREFIX, MENU_ANCHOR_QUERY, MENU_AREA_QUERY, MENU_ATTR, MENU_BOUND_ATTR, MENU_CARET, MENU_CLASS, MENU_EDGE_PX, MENU_EVENT_SELECT, MENU_EVENT_TOGGLE, MENU_FORMS, MENU_GAP_PX, MENU_ITEM_ATTR, MENU_KINDS, MENU_MAX_HEIGHT_PX, MENU_MIN_HEIGHT_PX, MENU_OFFSET_PX, MENU_PANEL_ATTR, MENU_SLOTS, MENU_TICK, MENU_TRIGGER_ATTR, MENU_WIDTH_PX, menuClass, menuSlot, } from './attrs.js';
+export type { MenuAlign, MenuForm, MenuKind, MenuSlot, PopoverMenuInput, PopoverMenuItem, } from './attrs.js';
+export { renderPopoverMenu } from './render.js';
+export { popoverMenuCss } from './style.js';
+export type { PopoverMenuCssInput } from './style.js';
+export { buildPopoverMenuJs } from './runtime.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/popover-menu/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/popover-menu/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EACL,WAAW,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,eAAe,EAAE,SAAS,EAAE,eAAe,EAC/F,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,UAAU,EAAE,WAAW,EACnG,cAAc,EAAE,UAAU,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EACnG,UAAU,EAAE,SAAS,EAAE,iBAAiB,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,GAC7E,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,eAAe,GAC3E,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/components/popover-menu/index.js

@@ -0,0 +1,30 @@
+/** popover-menu · **组件出口**（该组件对外的唯一名字面）。
+ *
+ *  —— 浮出菜单 · 形态 A「贴着按钮」——
+ *
+ *  一句话：把几条动作**贴着触发它的那颗键**弹出来（分组头、快捷键、当前项打勾、危险项垫最后）——
+ *  走原生 `popover`：点外面关、`Esc` 关、顶层都是浏览器给的，**脚本坏了也开得出来**。
+ *
+ *  什么时候用它（对照既有件想清楚再选）：
+ *   · 要「贴着一颗键弹出几条动作」（复制格式、更多操作、快捷切换）→ 用它；
+ *   · 要「页面里摆一排常态可见的动作」→ 用 `action-bar`；
+ *   · 要「确认一件破坏性的事」→ 用 `dialog`；要「从一长串里勾几个」→ 用 `drawer-sheet`。
+ *
+ *  两件出口：
+ *   · `renderPopoverMenu(input)` —— 产触发键 ＋ 面板（纯函数，零 DOM；`popovertarget` 已接好）；
+ *   · `popoverMenuCss()` —— 该组件样式段（页面按需注入；不进 12 区闭集）；
+ *   · `buildPopoverMenuJs()` —— 运行时（产出 JS 文本；DOM 只出现在文本里）。
+ *
+ *  页面怎么接自己的逻辑（不引入任何全局）：
+ *  ```js
+ *  document.addEventListener('ilife:menu-select', (e) => {
+ *    const { id, value, kind } = e.detail;   // 面板已关、焦点已还给触发键
+ *    if (id === 'menu-copy' && value === 'markdown') copyAsMarkdown();
+ *  });
+ *  ```
+ *  完整用法与参数表见同目录 `README.md`。
+ */
+export { MENU_ALIGNS, MENU_ANCHOR_PREFIX, MENU_ANCHOR_QUERY, MENU_AREA_QUERY, MENU_ATTR, MENU_BOUND_ATTR, MENU_CARET, MENU_CLASS, MENU_EDGE_PX, MENU_EVENT_SELECT, MENU_EVENT_TOGGLE, MENU_FORMS, MENU_GAP_PX, MENU_ITEM_ATTR, MENU_KINDS, MENU_MAX_HEIGHT_PX, MENU_MIN_HEIGHT_PX, MENU_OFFSET_PX, MENU_PANEL_ATTR, MENU_SLOTS, MENU_TICK, MENU_TRIGGER_ATTR, MENU_WIDTH_PX, menuClass, menuSlot, } from './attrs.js';
+export { renderPopoverMenu } from './render.js';
+export { popoverMenuCss } from './style.js';
+export { buildPopoverMenuJs } from './runtime.js';

package/dist/components/popover-menu/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/popover-menu/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EACL,WAAW,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,eAAe,EAAE,SAAS,EAAE,eAAe,EAC/F,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,UAAU,EAAE,WAAW,EACnG,cAAc,EAAE,UAAU,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EACnG,UAAU,EAAE,SAAS,EAAE,iBAAiB,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,GAC7E,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/components/popover-menu/model.d.ts

@@ -0,0 +1,26 @@
+import { type MenuAlign, type MenuForm, type MenuKind, type PopoverMenuInput, type PopoverMenuItem } from './attrs.js';
+/** 菜单项的内部形状（已归一）。 */
+export interface MenuItemModel {
+    readonly value: string;
+    readonly label: string;
+    readonly note?: string;
+    readonly shortcut?: string;
+    readonly group?: string;
+    readonly sep: boolean;
+    readonly kind: MenuKind;
+    readonly checked: boolean;
+}
+/** 内部类型。 */
+export interface MenuModel {
+    readonly id: string;
+    readonly form: MenuForm;
+    readonly trigger: string;
+    readonly menuLabel: string;
+    readonly align: MenuAlign;
+    readonly items: readonly MenuItemModel[];
+    readonly extraClass?: string;
+}
+/** 入参归一化（**唯一入口**：`render.ts` 只吃它产出的 `MenuModel`）。 */
+export declare function normalizePopoverMenu(input: unknown): MenuModel;
+export type { PopoverMenuInput, PopoverMenuItem };
+//# sourceMappingURL=model.d.ts.map

package/dist/components/popover-menu/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/components/popover-menu/model.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAC1F,MAAM,YAAY,CAAC;AAKpB,qBAAqB;AACrB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,YAAY;AACZ,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AA2CD,sDAAsD;AACtD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CA0B9D;AAED,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC"}

package/dist/components/popover-menu/model.js

@@ -0,0 +1,79 @@
+/** popover-menu · **入参归一化与校验**（把 `any` 与说不出的 `unknown` 挡在门外，产出内部类型）。
+ *
+ *  三条口径（与同族两件同一套）：
+ *   1. **非法入参一律 `badInput()`**（抛 `BlocksError`）——不静默降级；
+ *   2. **`id` 只许标识符字符**：它同时喂 `id=`／`popovertarget=`／**逐实例锚名** `--ilife-menu-<id>`；
+ *   3. **说不清的档是错**：`kind='check'` 与 `checked` 一起给才算数；`danger` 不许带打勾位。
+ */
+import { assertPlainObject, badInput, optExtraClass, optText, reqText } from '../shared/validate.js';
+import { MENU_ALIGNS, MENU_FORMS, MENU_KINDS, } from './attrs.js';
+/** `id` 的字面口径（与同族两件同一套口径；本件自足，不从别的件取）。 */
+const ID_RE = /^[A-Za-z0-9_\u00a0-\uffff][A-Za-z0-9_-\u00a0-\uffff]*$/;
+/** 菜单项：逐项校验；`value` 菜单内唯一；`check`／`danger` 两档不许打架。 */
+function reqItems(value) {
+    if (!Array.isArray(value) || value.length === 0) {
+        badInput('popover-menu: input.items 必须是非空数组（一枚都没有的菜单不发）');
+    }
+    const seen = new Set();
+    const out = [];
+    for (let i = 0; i < value.length; i += 1) {
+        assertPlainObject(value[i], 'popover-menu: input.items[' + i + ']');
+        const raw = value[i];
+        const kind = raw.kind === undefined ? 'action' : raw.kind;
+        if (!MENU_KINDS.includes(kind)) {
+            badInput('popover-menu: input.items[' + i + '].kind 必须是 ' + MENU_KINDS.join('／') + ' 之一');
+        }
+        if (raw.checked !== undefined && typeof raw.checked !== 'boolean') {
+            badInput('popover-menu: input.items[' + i + '].checked 必须是布尔值');
+        }
+        if (raw.sep !== undefined && typeof raw.sep !== 'boolean') {
+            badInput('popover-menu: input.items[' + i + '].sep 必须是布尔值');
+        }
+        if (raw.checked === true && kind !== 'check') {
+            /* 打勾位只归 `check` 档：别的档打了勾，读的人分不清是「当前项」还是「选中的项」。 */
+            badInput('popover-menu: items[' + i + '].checked 只对 kind=check 有效');
+        }
+        const item = {
+            value: reqText(raw.value, 'popover-menu: input.items[' + i + '].value'),
+            label: reqText(raw.label, 'popover-menu: input.items[' + i + '].label'),
+            note: optText(raw.note, 'popover-menu: input.items[' + i + '].note'),
+            shortcut: optText(raw.shortcut, 'popover-menu: input.items[' + i + '].shortcut'),
+            group: optText(raw.group, 'popover-menu: input.items[' + i + '].group'),
+            sep: raw.sep === true,
+            kind: kind,
+            checked: raw.checked === true,
+        };
+        if (seen.has(item.value))
+            badInput('popover-menu: items 的 value 必须唯一：' + item.value);
+        seen.add(item.value);
+        out.push(item);
+    }
+    return out;
+}
+/** 入参归一化（**唯一入口**：`render.ts` 只吃它产出的 `MenuModel`）。 */
+export function normalizePopoverMenu(input) {
+    assertPlainObject(input, 'renderPopoverMenu: input');
+    const raw = input;
+    const form = raw.form === undefined ? MENU_FORMS[0] : raw.form;
+    if (!MENU_FORMS.includes(form)) {
+        badInput('popover-menu: input.form 必须是 ' + MENU_FORMS.join('／') + ' 之一（本件只落地形态 A「贴着按钮」）');
+    }
+    const align = raw.align === undefined ? MENU_ALIGNS[1] : raw.align;
+    if (!MENU_ALIGNS.includes(align)) {
+        badInput('popover-menu: input.align 必须是 ' + MENU_ALIGNS.join('／') + ' 之一');
+    }
+    const id = reqText(raw.id, 'popover-menu: input.id');
+    if (!ID_RE.test(id)) {
+        badInput('popover-menu: input.id 只许标识符字符（字母／数字／下划线／连字符／汉字）：' + id);
+    }
+    const trigger = reqText(raw.trigger, 'popover-menu: input.trigger');
+    return {
+        id,
+        form: form,
+        trigger,
+        menuLabel: optText(raw.menuLabel, 'popover-menu: input.menuLabel') ?? trigger,
+        align: align,
+        items: reqItems(raw.items),
+        extraClass: optExtraClass(raw.extraClass, 'popover-menu: input.extraClass'),
+    };
+}

package/dist/components/popover-menu/model.js.map

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

package/dist/components/popover-menu/render.d.ts

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

package/dist/components/popover-menu/render.d.ts.map

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

package/dist/components/popover-menu/render.js

@@ -0,0 +1,84 @@
+/** popover-menu · **渲染**（纯函数产 HTML；本件只有形态 A「贴着按钮」一种骨架）。
+ *
+ *  —— 形态 A：贴着按钮 ——
+ *
+ *  骨架＝**一颗触发键 ＋ 贴着它弹出来的小菜单**。它替掉的两种错法：
+ *   · 把几条动作摊在页面上——每页都要一张工具条，正文被挤成一条；
+ *   · 自己搓弹层管「点外面关／`Esc` 关」——漏一条就把用户关在菜单里。
+ *
+ *  三条硬口径（判据断的就是它们）：
+ *   · 面板是**真 `popover` ＋ `role=menu`**；触发键带 **`popovertarget`**（**一行脚本都没有也开得出来**）
+ *     与 `aria-haspopup="true"`，展开态由运行时同步到 `aria-expanded`；
+ *   · 定位两道：`@supports (anchor-name: --a)` 之内走 CSS 锚定（`position-area` ＋ 翻边），
+ *     之外按**普通定位**（打开时运行时按触发键的矩形算边距）；逐实例锚名 `--ilife-menu-<id>`
+ *     由标记写进 `style` 属性（触发键与面板写**同一个**名字）；
+ *   · 每一枚项都是**真 `<button>`**（`role=menuitem`／`menuitemradio`），机器值落
+ *     `data-ilife-menu-item`（**不落 id**：`id` 归页面所有）。
+ */
+import { esc } from '../shared/escape.js';
+import { MENU_ANCHOR_PREFIX, MENU_ATTR, MENU_CARET, MENU_ITEM_ATTR, MENU_PANEL_ATTR, MENU_TICK, MENU_TRIGGER_ATTR, menuClass, menuSlot, } from './attrs.js';
+import { normalizePopoverMenu } from './model.js';
+/** 触发键上那颗「会弹出东西」的记号（装饰位，`aria-hidden`）。 */
+function triggerHtml(m) {
+    return '<button class="' + menuSlot('trigger') + '" type="button"'
+        + ' id="' + esc(m.id) + '-btn"'
+        + ' popovertarget="' + esc(m.id) + '"'
+        + ' aria-haspopup="true" aria-expanded="false"'
+        + ' style="anchor-name:' + esc(MENU_ANCHOR_PREFIX + m.id) + '"'
+        + ' ' + MENU_TRIGGER_ATTR + '="' + esc(m.id) + '">'
+        + esc(m.trigger)
+        + '<span aria-hidden="true">' + esc(MENU_CARET) + '</span>'
+        + '</button>';
+}
+/** 一枚菜单项：分组头／发丝线由**前一项到这一项的差**决定（标记里不写「分隔符」）。 */
+function itemHtml(item, prev) {
+    const parts = [];
+    if (item.group !== undefined && (prev === undefined || prev.group !== item.group)) {
+        parts.push('<div class="' + menuSlot('group') + '" role="presentation">' + esc(item.group) + '</div>');
+    }
+    else if (item.sep && prev !== undefined) {
+        parts.push('<div class="' + menuSlot('sep') + '" role="presentation"></div>');
+    }
+    const classes = [menuSlot('item')].concat(item.kind === 'action' ? [] : ['is-' + item.kind]).join(' ');
+    const role = item.kind === 'check' ? 'menuitemradio' : 'menuitem';
+    const attrs = [
+        'class="' + esc(classes) + '"',
+        'type="button"',
+        'role="' + role + '"',
+        MENU_ITEM_ATTR + '="' + esc(item.value) + '"',
+    ];
+    if (item.kind === 'check')
+        attrs.push('aria-checked="' + (item.checked ? 'true' : 'false') + '"');
+    const tick = item.kind === 'check'
+        ? '<span class="' + menuSlot('tick') + '" aria-hidden="true">' + (item.checked ? esc(MENU_TICK) : '') + '</span>'
+        : '';
+    const key = '<span class="' + menuSlot('key') + '">' + esc(item.label)
+        + (item.note === undefined ? '' : '<span class="' + menuSlot('note') + '">' + esc(item.note) + '</span>')
+        + '</span>';
+    const shortcut = item.shortcut === undefined
+        ? '' : '<span class="' + menuSlot('shortcut') + '">' + esc(item.shortcut) + '</span>';
+    parts.push('<button ' + attrs.join(' ') + '>' + tick + key + shortcut + '</button>');
+    return parts.join('');
+}
+/** 形态 A 的骨架。 */
+function renderHug(m) {
+    const body = m.items.map((item, i) => itemHtml(item, i === 0 ? undefined : m.items[i - 1])).join('');
+    const panel = '<div class="' + menuSlot('panel') + ' is-' + m.align + '"'
+        + ' id="' + esc(m.id) + '"'
+        + ' popover="auto" role="menu" aria-label="' + esc(m.menuLabel) + '"'
+        + ' style="position-anchor:' + esc(MENU_ANCHOR_PREFIX + m.id) + '"'
+        + ' ' + MENU_PANEL_ATTR + '="' + m.align + '">' + body + '</div>';
+    return triggerHtml(m) + panel;
+}
+/** 形态 → 骨架（本件只有一格）。 */
+const SKELETONS = {
+    hug: renderHug,
+};
+/** 渲染一个浮出菜单（纯函数：同样的入参恒产同样的字节；转义只经 `shared/escape.ts`）。 */
+export function renderPopoverMenu(input) {
+    const m = normalizePopoverMenu(input);
+    const classes = [menuClass(), 'is-' + m.form]
+        .concat(m.extraClass === undefined ? [] : [m.extraClass]).join(' ');
+    return '<span class="' + esc(classes) + '" ' + MENU_ATTR + '="' + esc(m.id) + '">'
+        + SKELETONS[m.form](m) + '</span>';
+}

package/dist/components/popover-menu/render.js.map

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

package/dist/components/popover-menu/runtime.d.ts

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

package/dist/components/popover-menu/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/components/popover-menu/runtime.ts"],"names":[],"mappings":"AAqBA,6DAA6D;AAC7D,wBAAgB,kBAAkB,IAAI,MAAM,CAwF3C"}

package/dist/components/popover-menu/runtime.js

@@ -0,0 +1,107 @@
+/** popover-menu · **运行时**（产出 JS 文本；DOM 只允许出现在这段文本里）。
+ *
+ *  分工与同族其余件一致：模块代码零 DOM，DOM 只在产出的字符串里。
+ *
+ *  行为契约（逐条对应判据）：
+ *   · **开／关不靠脚本**：触发键带 `popovertarget`，`Esc`／点外面关都是浏览器的默认行为——
+ *     本段不拦、不改、不 preventDefault（脚本坏了菜单照样开得出来）。
+ *   · **委派 ＋ 幂等**：`document` 上一枚 `click`／一枚 `keydown`；`toggle` 走**捕获相位**
+ *     （它不冒泡）。重复注入靠根上的 `data-ilife-popover-menu-runtime` 拦住。
+ *   · **展开态同步**：开着时触发键 `aria-expanded="true"`（样式与屏读器都读它）。
+ *   · **键盘走位**：`↑`／`↓`／`Home`／`End` 在项之间搬焦点（`Tab` 不拦：菜单不关，浏览器自己走）。
+ *   · **选中**：点／回车一枚项 → 派发 `ilife:menu-select` ＋ 关面板 ＋ **焦点还给触发键**；
+ *     `kind=check` 的那一族里就地翻 `aria-checked`（勾只有一个）。
+ *   · **降级定位**：引擎不支持锚定 API 时（与 CSS 的 `@supports` 读**同一份能力查询串**），
+ *     打开时按触发键的矩形算 `left`／`top`，贴不下就往上翻、左右夹进容器。
+ */
+import { MENU_ANCHOR_QUERY, MENU_AREA_QUERY, MENU_ATTR, MENU_BOUND_ATTR, MENU_EVENT_SELECT, MENU_EVENT_TOGGLE, MENU_GAP_PX, MENU_ITEM_ATTR, MENU_PANEL_ATTR, MENU_TRIGGER_ATTR, } from './attrs.js';
+/** 产出运行时的 JS 文本（经典 script 作用域可跑的 IIFE；由页面拼进共享 helpers 槽）。 */
+export function buildPopoverMenuJs() {
+    const q = (s) => JSON.stringify(s);
+    return '(function(){' + '\n'
+        + '  var ATTR=' + q(MENU_ATTR) + ', TRIG=' + q(MENU_TRIGGER_ATTR) + ', PANEL=' + q(MENU_PANEL_ATTR) + ';' + '\n'
+        + '  var ITEM=' + q(MENU_ITEM_ATTR) + ', BOUND=' + q(MENU_BOUND_ATTR) + ', EV=' + q(MENU_EVENT_SELECT) + ';' + '\n'
+        + '  var EVT=' + q(MENU_EVENT_TOGGLE) + ';' + '\n'
+        + '  var AQ=' + q(MENU_ANCHOR_QUERY) + ', PQ=' + q(MENU_AREA_QUERY) + ', OFF=' + String(MENU_GAP_PX * 2) + ';' + '\n'
+        + '  var doc=document;' + '\n'
+        + '  if (doc.documentElement.getAttribute("data-ilife-popover-menu-runtime")==="1") return;' + '\n'
+        + '  doc.documentElement.setAttribute("data-ilife-popover-menu-runtime","1");' + '\n'
+        + '  var canAnchor=!!(window.CSS && CSS.supports && CSS.supports(AQ) && CSS.supports(PQ));' + '\n'
+        + '  function fire(el,name,detail){ el.dispatchEvent(new CustomEvent(name,{bubbles:true,detail:detail})); }' + '\n'
+        + '  function isPanel(el){ return !!(el && el.hasAttribute && el.hasAttribute(PANEL)); }' + '\n'
+        /* 面板的发现锚是 **`data-ilife-menu-panel`**（`data-ilife-popover-menu` 在**容器**上）——
+           两枚锚各管一头：容器认「这是一套菜单」，面板认「这是一块弹出面」。 */
+        + '  function panelOf(el){ return (el && el.closest) ? el.closest("["+PANEL+"]") : null; }' + '\n'
+        + '  function itemsOf(panel){ return panel.querySelectorAll("["+ITEM+"]"); }' + '\n'
+        + '  function triggerOf(panel){ var w=panel.parentNode;'
+        + ' return (w && w.querySelector) ? w.querySelector("["+TRIG+"]") : null; }' + '\n'
+        /* 降级定位：只在引擎不支持锚定 API 时用（CSS 那边同样在 @supports 之外 ⇒ 两边一致）。 */
+        + '  function place(panel){' + '\n'
+        + '    var t=triggerOf(panel); if (!t) return;' + '\n'
+        + '    var r=t.getBoundingClientRect(), w=panel.offsetWidth, h=panel.offsetHeight;' + '\n'
+        + '    var vw=doc.documentElement.clientWidth, vh=doc.documentElement.clientHeight;' + '\n'
+        + '    var align=panel.getAttribute(PANEL)||"end";' + '\n'
+        + '    var left=(align==="end") ? (r.right-w) : r.left;' + '\n'
+        + '    left=Math.max(8, Math.min(left, vw-w-8));' + '\n'
+        + '    var top=r.bottom+8;' + '\n'
+        + '    if (top+h > vh-8) top=Math.max(8, r.top-h-8);' + '\n'
+        + '    panel.style.left=left+"px"; panel.style.top=top+"px";' + '\n'
+        + '    panel.style.right="auto"; panel.style.bottom="auto";' + '\n'
+        + '  }' + '\n'
+        + '  function onOpen(panel){' + '\n'
+        + '    var t=triggerOf(panel); if (t) t.setAttribute("aria-expanded","true");' + '\n'
+        + '    if (!canAnchor) place(panel);' + '\n'
+        + '    var items=itemsOf(panel);' + '\n'
+        + '    if (items.length>0){ try{ items[0].focus(); }catch(e){} }' + '\n'
+        + '    fire(panel,EVT,{id:panel.id,phase:"open"});' + '\n'
+        + '  }' + '\n'
+        + '  function onClose(panel){' + '\n'
+        + '    var t=triggerOf(panel); if (t) t.setAttribute("aria-expanded","false");' + '\n'
+        + '    if (panel.style.left){ panel.style.left=""; panel.style.top=""; }' + '\n'
+        + '    if (t && t.isConnected && (doc.activeElement===panel || panel.contains(doc.activeElement))){' + '\n'
+        + '      try{ t.focus(); }catch(e){}' + '\n'
+        + '    }' + '\n'
+        + '    fire(panel,EVT,{id:panel.id,phase:"close"});' + '\n'
+        + '  }' + '\n'
+        + '  doc.addEventListener("toggle", function(e){' + '\n'
+        + '    var panel=e.target;' + '\n'
+        + '    if (!isPanel(panel)) return;' + '\n'
+        + '    if (e.newState==="open") onOpen(panel); else onClose(panel);' + '\n'
+        + '  }, true);' + '\n'
+        + '  doc.addEventListener("click", function(e){' + '\n'
+        + '    var t=e.target; if (!t || !t.closest) return;' + '\n'
+        + '    var item=t.closest("["+ITEM+"]"); if (!item) return;' + '\n'
+        + '    var panel=panelOf(item); if (!panel) return;' + '\n'
+        + '    if (item.disabled) return;' + '\n'
+        + '    if (item.getAttribute("role")==="menuitemradio"){' + '\n'
+        + '      var all=itemsOf(panel);' + '\n'
+        + '      for (var i=0;i<all.length;i+=1) if (all[i].getAttribute("role")==="menuitemradio"){'
+        + ' all[i].setAttribute("aria-checked", all[i]===item ? "true" : "false"); }' + '\n'
+        + '    }' + '\n'
+        + '    var detail={id:panel.id,value:item.getAttribute(ITEM),'
+        + 'label:item.textContent,checked:item.getAttribute("aria-checked")==="true"};' + '\n'
+        + '    var trig=triggerOf(panel);' + '\n'
+        + '    if (typeof panel.hidePopover==="function"){ try{ panel.hidePopover(); }catch(e2){} }' + '\n'
+        + '    if (trig && trig.isConnected){ try{ trig.focus(); }catch(e3){} }' + '\n'
+        + '    fire(panel,EV,detail);' + '\n'
+        + '  });' + '\n'
+        /* 键盘走位：只在面板里的项之间搬焦点（开／关与 Esc 都是原生行为，这里一概不拦）。 */
+        + '  doc.addEventListener("keydown", function(e){' + '\n'
+        + '    var t=e.target; if (!t || !t.closest) return;' + '\n'
+        + '    var item=t.closest("["+ITEM+"]"); if (!item) return;' + '\n'
+        + '    var panel=item.closest("["+ATTR+"]"); if (!panel) return;' + '\n'
+        + '    var all=itemsOf(panel), at=-1, i;' + '\n'
+        + '    for (i=0;i<all.length;i+=1) if (all[i]===item) at=i;' + '\n'
+        + '    var want=-1;' + '\n'
+        + '    if (e.key==="ArrowDown") want=(at+1)%all.length;' + '\n'
+        + '    else if (e.key==="ArrowUp") want=(at-1+all.length)%all.length;' + '\n'
+        + '    else if (e.key==="Home") want=0;' + '\n'
+        + '    else if (e.key==="End") want=all.length-1;' + '\n'
+        + '    else return;' + '\n'
+        + '    e.preventDefault();' + '\n'
+        + '    if (all[want]) all[want].focus();' + '\n'
+        + '  });' + '\n'
+        + '  var all=doc.querySelectorAll("["+TRIG+"]");' + '\n'
+        + '  for (var j=0;j<all.length;j+=1) all[j].setAttribute(BOUND,"1");' + '\n'
+        + '}());';
+}

package/dist/components/popover-menu/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/components/popover-menu/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EACL,iBAAiB,EAAE,eAAe,EAAE,SAAS,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EACpG,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,GAChE,MAAM,YAAY,CAAC;AAEpB,6DAA6D;AAC7D,MAAM,UAAU,kBAAkB;IAChC,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,SAAS,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,iBAAiB,CAAC,GAAG,UAAU,GAAG,CAAC,CAAC,eAAe,CAAC,GAAG,GAAG,GAAG,IAAI;UAC9G,aAAa,GAAG,CAAC,CAAC,cAAc,CAAC,GAAG,UAAU,GAAG,CAAC,CAAC,eAAe,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC,iBAAiB,CAAC,GAAG,GAAG,GAAG,IAAI;UACjH,YAAY,GAAG,CAAC,CAAC,iBAAiB,CAAC,GAAG,GAAG,GAAG,IAAI;UAChD,WAAW,GAAG,CAAC,CAAC,iBAAiB,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC,eAAe,CAAC,GAAG,QAAQ,GAAG,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI;UACnH,qBAAqB,GAAG,IAAI;UAC5B,0FAA0F,GAAG,IAAI;UACjG,4EAA4E,GAAG,IAAI;UACnF,yFAAyF,GAAG,IAAI;UAChG,0GAA0G,GAAG,IAAI;UACjH,uFAAuF,GAAG,IAAI;QAChG;+CACuC;UACrC,yFAAyF,GAAG,IAAI;UAChG,2EAA2E,GAAG,IAAI;UAClF,sDAAsD;UACtD,0EAA0E,GAAG,IAAI;QACnF,2DAA2D;UACzD,0BAA0B,GAAG,IAAI;UACjC,6CAA6C,GAAG,IAAI;UACpD,iFAAiF,GAAG,IAAI;UACxF,kFAAkF,GAAG,IAAI;UACzF,iDAAiD,GAAG,IAAI;UACxD,sDAAsD,GAAG,IAAI;UAC7D,+CAA+C,GAAG,IAAI;UACtD,yBAAyB,GAAG,IAAI;UAChC,mDAAmD,GAAG,IAAI;UAC1D,2DAA2D,GAAG,IAAI;UAClE,0DAA0D,GAAG,IAAI;UACjE,KAAK,GAAG,IAAI;UACZ,2BAA2B,GAAG,IAAI;UAClC,4EAA4E,GAAG,IAAI;UACnF,mCAAmC,GAAG,IAAI;UAC1C,+BAA+B,GAAG,IAAI;UACtC,+DAA+D,GAAG,IAAI;UACtE,iDAAiD,GAAG,IAAI;UACxD,KAAK,GAAG,IAAI;UACZ,4BAA4B,GAAG,IAAI;UACnC,6EAA6E,GAAG,IAAI;UACpF,uEAAuE,GAAG,IAAI;UAC9E,kGAAkG,GAAG,IAAI;UACzG,mCAAmC,GAAG,IAAI;UAC1C,OAAO,GAAG,IAAI;UACd,kDAAkD,GAAG,IAAI;UACzD,KAAK,GAAG,IAAI;UACZ,+CAA+C,GAAG,IAAI;UACtD,yBAAyB,GAAG,IAAI;UAChC,kCAAkC,GAAG,IAAI;UACzC,kEAAkE,GAAG,IAAI;UACzE,aAAa,GAAG,IAAI;UACpB,8CAA8C,GAAG,IAAI;UACrD,mDAAmD,GAAG,IAAI;UAC1D,0DAA0D,GAAG,IAAI;UACjE,kDAAkD,GAAG,IAAI;UACzD,gCAAgC,GAAG,IAAI;UACvC,uDAAuD,GAAG,IAAI;UAC9D,+BAA+B,GAAG,IAAI;UACtC,2FAA2F;UAC3F,2EAA2E,GAAG,IAAI;UAClF,OAAO,GAAG,IAAI;UACd,4DAA4D;UAC5D,6EAA6E,GAAG,IAAI;UACpF,gCAAgC,GAAG,IAAI;UACvC,0FAA0F,GAAG,IAAI;UACjG,sEAAsE,GAAG,IAAI;UAC7E,4BAA4B,GAAG,IAAI;UACnC,OAAO,GAAG,IAAI;QAChB,gDAAgD;UAC9C,gDAAgD,GAAG,IAAI;UACvD,mDAAmD,GAAG,IAAI;UAC1D,0DAA0D,GAAG,IAAI;UACjE,+DAA+D,GAAG,IAAI;UACtE,uCAAuC,GAAG,IAAI;UAC9C,0DAA0D,GAAG,IAAI;UACjE,kBAAkB,GAAG,IAAI;UACzB,sDAAsD,GAAG,IAAI;UAC7D,oEAAoE,GAAG,IAAI;UAC3E,sCAAsC,GAAG,IAAI;UAC7C,gDAAgD,GAAG,IAAI;UACvD,kBAAkB,GAAG,IAAI;UACzB,yBAAyB,GAAG,IAAI;UAChC,uCAAuC,GAAG,IAAI;UAC9C,OAAO,GAAG,IAAI;UACd,+CAA+C,GAAG,IAAI;UACtD,mEAAmE,GAAG,IAAI;UAC1E,OAAO,CAAC;AACd,CAAC"}

package/dist/components/popover-menu/style.d.ts

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

package/dist/components/popover-menu/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../../src/components/popover-menu/style.ts"],"names":[],"mappings":"AAoBA,gBAAgB;AAChB,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,eAAe;AACf,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,mBAAmB,GAAG,MAAM,CA0ElE"}