@greypan/web-ui 7.0.0 → 8.1.0

package/dist/shared/option-portal/combobox-shell.js.map

@@ -1 +1 @@
-{"version":3,"file":"combobox-shell.js","names":[],"sources":["../../../src/shared/option-portal/combobox-shell.ts"],"sourcesContent":["import type { WebUiOption } from '@/components/option'\nimport type { OpenOverlayHandle } from '@/shared/overlay/open-overlay'\n\n/**\n * combobox 开合与 option 交互的共享骨架（select / autocomplete）。\n *\n * 与 option-portal 的边界约定一致：交互语义的\"差异点\"经回调注入，\n * 这里收口两组件逐行复制的生命周期不变量——\n * - open/close 状态迁移顺序：guard → 状态翻转 → open-change 派发 →\n *   激活钩子 → scroll-lock 配对 → portal 模式的 rAF 延迟 openOverlay\n * - close 路径：before-close 钩子（portal 内容先收敛）→ 激活清理 →\n *   scroll-lock 释放 → closeOverlay（关闭后使 portal 引用失效）\n * - option 四事件监听对的绑定/解绑\n * - focusout 的 rAF :focus-within 复核\n * - 键盘导航的环绕游标算法\n */\n\nexport interface ComboboxOpenHooks {\n  /** 是否允许打开（disabled / readonly 等由组件判断）。 */\n  canOpen(): boolean\n  getIsOpen(): boolean\n  setIsOpen(open: boolean): void\n  dispatchOpenChange(): void\n  syncScrollLock(open: boolean): void\n  /** 是否 portal 模式（决定 openOverlay 是否延迟到下一帧）。 */\n  isPortal(): boolean\n  openOverlay(isKeyboardNavigation: boolean): void\n  closeOverlay(): void\n  /** 打开时的激活项初始化（键盘导航取选中/首项，指针打开保留现状）。 */\n  onOpen?(isKeyboardNavigation: boolean): void\n  /** 关闭前钩子：autocomplete 需先把 light DOM 新增节点收敛进当前 portal content。 */\n  onBeforeClose?(): void\n  /** 关闭时清理激活状态（清 _activeIndex 与 active 属性）。 */\n  onAfterClose?(): void\n}\n\nexport interface ComboboxOpenController {\n  open(isKeyboardNavigation?: boolean): void\n  close(): void\n}\n\nexport function createComboboxOpenController(hooks: ComboboxOpenHooks): ComboboxOpenController {\n  function open(isKeyboardNavigation = false) {\n    if (hooks.canOpen() === false || hooks.getIsOpen()) return\n    hooks.setIsOpen(true)\n    hooks.dispatchOpenChange()\n    hooks.onOpen?.(isKeyboardNavigation)\n    hooks.syncScrollLock(true)\n    if (hooks.isPortal()) {\n      requestAnimationFrame(() => {\n        if (hooks.getIsOpen()) hooks.openOverlay(isKeyboardNavigation)\n      })\n    } else {\n      hooks.openOverlay(isKeyboardNavigation)\n    }\n  }\n\n  function close() {\n    if (!hooks.getIsOpen()) return\n    hooks.onBeforeClose?.()\n    hooks.setIsOpen(false)\n    hooks.dispatchOpenChange()\n    hooks.onAfterClose?.()\n    hooks.syncScrollLock(false)\n    hooks.closeOverlay()\n  }\n\n  return { open, close }\n}\n\nexport interface OptionListenerHandlers {\n  onClick: (event: Event) => void\n  onPointerOver: (event: PointerEvent) => void\n  onPointerDown: (event: PointerEvent) => void\n  onUpdate: () => void\n}\n\n/** option 四事件监听对的绑定/解绑；两组件的 handler 签名一致，仅实现不同。 */\nexport function createOptionListenerBinding(handlers: OptionListenerHandlers) {\n  function bind(option: WebUiOption) {\n    option.addEventListener('click', handlers.onClick)\n    option.addEventListener('pointerover', handlers.onPointerOver)\n    option.addEventListener('pointerdown', handlers.onPointerDown)\n    option.addEventListener('option-update', handlers.onUpdate)\n  }\n  function unbind(option: WebUiOption) {\n    option.removeEventListener('click', handlers.onClick)\n    option.removeEventListener('pointerover', handlers.onPointerOver)\n    option.removeEventListener('pointerdown', handlers.onPointerDown)\n    option.removeEventListener('option-update', handlers.onUpdate)\n  }\n  return { bind, unbind }\n}\n\n/**\n * focusout 关闭复核：焦点是否真的离开了宿主与面板。\n * rAF 等待 click/pointerdown 相关的焦点迁移完成后再判定。\n */\nexport function handleComboboxFocusOut(\n  host: HTMLElement,\n  getHandle: () => OpenOverlayHandle | null | undefined,\n  getIsOpen: () => boolean,\n  close: () => void\n): void {\n  requestAnimationFrame(() => {\n    const handle = getHandle()\n    if (getIsOpen() && !host.matches(':focus-within') && !handle?.hasFocusWithin()) {\n      close()\n    }\n  })\n}\n\n/**\n * 环绕游标：在 enabled 列表内按 delta 移动；从 -1（无激活）向下取首项、向上取末项。\n * 返回在 enabled 中的下一索引；调用方负责换算回全量 options 索引。\n */\nexport function nextWrappingIndex(enabledCount: number, currentIdx: number, delta: number): number {\n  if (enabledCount === 0) return -1\n  let nextIdx = currentIdx + delta\n  if (nextIdx < 0) nextIdx = enabledCount - 1\n  if (nextIdx >= enabledCount) nextIdx = 0\n  return nextIdx\n}\n"],"mappings":";AAyCA,SAAgB,EAA6B,GAAkD;CAC7F,SAAS,EAAK,IAAuB,IAAO;EACtC,EAAM,QAAQ,MAAM,MAAS,EAAM,UAAU,MACjD,EAAM,UAAU,EAAI,GACpB,EAAM,mBAAmB,GACzB,EAAM,SAAS,CAAoB,GACnC,EAAM,eAAe,EAAI,GACrB,EAAM,SAAS,IACjB,4BAA4B;GAC1B,AAAI,EAAM,UAAU,KAAG,EAAM,YAAY,CAAoB;EAC/D,CAAC,IAED,EAAM,YAAY,CAAoB;CAE1C;CAEA,SAAS,IAAQ;EACV,EAAM,UAAU,MACrB,EAAM,gBAAgB,GACtB,EAAM,UAAU,EAAK,GACrB,EAAM,mBAAmB,GACzB,EAAM,eAAe,GACrB,EAAM,eAAe,EAAK,GAC1B,EAAM,aAAa;CACrB;CAEA,OAAO;EAAE;EAAM;CAAM;AACvB;AAUA,SAAgB,EAA4B,GAAkC;CAC5E,SAAS,EAAK,GAAqB;EAIjC,AAHA,EAAO,iBAAiB,SAAS,EAAS,OAAO,GACjD,EAAO,iBAAiB,eAAe,EAAS,aAAa,GAC7D,EAAO,iBAAiB,eAAe,EAAS,aAAa,GAC7D,EAAO,iBAAiB,iBAAiB,EAAS,QAAQ;CAC5D;CACA,SAAS,EAAO,GAAqB;EAInC,AAHA,EAAO,oBAAoB,SAAS,EAAS,OAAO,GACpD,EAAO,oBAAoB,eAAe,EAAS,aAAa,GAChE,EAAO,oBAAoB,eAAe,EAAS,aAAa,GAChE,EAAO,oBAAoB,iBAAiB,EAAS,QAAQ;CAC/D;CACA,OAAO;EAAE;EAAM;CAAO;AACxB;AAMA,SAAgB,EACd,GACA,GACA,GACA,GACM;CACN,4BAA4B;EAC1B,IAAM,IAAS,EAAU;EACzB,AAAI,EAAU,KAAK,CAAC,EAAK,QAAQ,eAAe,KAAK,CAAC,GAAQ,eAAe,KAC3E,EAAM;CAEV,CAAC;AACH;AAMA,SAAgB,EAAkB,GAAsB,GAAoB,GAAuB;CACjG,IAAI,MAAiB,GAAG,OAAO;CAC/B,IAAI,IAAU,IAAa;CAG3B,OAFI,IAAU,MAAG,IAAU,IAAe,IACtC,KAAW,MAAc,IAAU,IAChC;AACT"}
+{"version":3,"file":"combobox-shell.js","names":[],"sources":["../../../src/shared/option-portal/combobox-shell.ts"],"sourcesContent":["import { definePlugin } from '@greypan/js-kit'\n\nimport type { WebUiOption } from '@/components/option'\nimport type { OpenOverlayHandle } from '@/shared/overlay/open-overlay'\n\n/**\n * combobox 开合与 option 交互的共享骨架（select / autocomplete）。\n *\n * 与 option-portal 的边界约定一致：交互语义的\"差异点\"经回调注入，\n * 这里收口两组件逐行复制的生命周期不变量——\n * - open/close 状态迁移顺序：guard → 状态翻转 → open-change 派发 →\n *   激活钩子 → scroll-lock 配对 → portal 模式的 rAF 延迟 openOverlay\n * - close 路径：before-close 钩子（portal 内容先收敛）→ 激活清理 →\n *   scroll-lock 释放 → closeOverlay（关闭后使 portal 引用失效）\n * - option 四事件监听对的绑定/解绑\n * - focusout 的 rAF :focus-within 复核\n * - 键盘导航的环绕游标算法\n */\n\nexport interface ComboboxOpenHooks {\n  /** 是否允许打开（disabled / readonly 等由组件判断）。 */\n  canOpen(): boolean\n  getIsOpen(): boolean\n  setIsOpen(open: boolean): void\n  dispatchOpenChange(): void\n  syncScrollLock(open: boolean): void\n  /** 是否 portal 模式（决定 openOverlay 是否延迟到下一帧）。 */\n  isPortal(): boolean\n  openOverlay(isKeyboardNavigation: boolean): void\n  closeOverlay(): void\n  /** 打开时的激活项初始化（键盘导航取选中/首项，指针打开保留现状）。 */\n  onOpen?(isKeyboardNavigation: boolean): void\n  /** 关闭前钩子：autocomplete 需先把 light DOM 新增节点收敛进当前 portal content。 */\n  onBeforeClose?(): void\n  /** 关闭时清理激活状态（清 _activeIndex 与 active 属性）。 */\n  onAfterClose?(): void\n}\n\nexport interface ComboboxOpenController {\n  open(isKeyboardNavigation?: boolean): void\n  close(): void\n}\n\nexport function createComboboxOpenController(hooks: ComboboxOpenHooks): ComboboxOpenController {\n  function open(isKeyboardNavigation = false) {\n    if (hooks.canOpen() === false || hooks.getIsOpen()) return\n    hooks.setIsOpen(true)\n    hooks.dispatchOpenChange()\n    hooks.onOpen?.(isKeyboardNavigation)\n    hooks.syncScrollLock(true)\n    if (hooks.isPortal()) {\n      requestAnimationFrame(() => {\n        if (hooks.getIsOpen()) hooks.openOverlay(isKeyboardNavigation)\n      })\n    } else {\n      hooks.openOverlay(isKeyboardNavigation)\n    }\n  }\n\n  function close() {\n    if (!hooks.getIsOpen()) return\n    hooks.onBeforeClose?.()\n    hooks.setIsOpen(false)\n    hooks.dispatchOpenChange()\n    hooks.onAfterClose?.()\n    hooks.syncScrollLock(false)\n    hooks.closeOverlay()\n  }\n\n  return { open, close }\n}\n\nexport interface OptionListenerHandlers {\n  onClick: (event: Event) => void\n  onPointerOver: (event: PointerEvent) => void\n  onPointerDown: (event: PointerEvent) => void\n  onUpdate: () => void\n}\n\nexport interface ComboboxTriggerSource {\n  /** 持 ARIA 与委托监听的 trigger 包装 div（shadow 内）。 */\n  getWrapper(): HTMLElement | null\n  /** `slot[name=\"trigger\"]` 的首个 assigned 元素；无自定义触发器时为 null。 */\n  getCustomTrigger(): HTMLElement | null\n  /** 默认触发器（shadow 内的 web-ui-input）；未渲染时为 null。 */\n  getFallbackTrigger(): HTMLElement | null\n}\n\nexport interface ComboboxTriggerHandlers {\n  /** 触发器文本变化；value 取自触发器 host 的字符串 value 属性。 */\n  onInput(value: string): void\n  /** 点击触发器区域（含包装 div 自身留白）。 */\n  onClick(): void\n  onFocusIn(event: FocusEvent): void\n  onFocusOut(event: FocusEvent): void\n}\n\nexport interface ComboboxTriggerApi {\n  /** 当前生效的触发器 host：自定义 trigger slot 首个 assigned 元素，否则默认触发器。 */\n  getTrigger(): HTMLElement | null\n  /** 触发器当前文本；触发器不暴露字符串 value 时返回 null。 */\n  getValue(): string | null\n  /** 回写文本；仅在文本触发器且值确实变化时写入，避免无谓重渲染。 */\n  setValue(value: string): void\n  /** 多行可编辑元素判定：Enter 保留换行语义，不接管为「选中高亮项」。 */\n  isMultilineEdit(event: KeyboardEvent): boolean\n  /**\n   * 程序化聚焦当前触发器。组件自带 focus 重定向（web-ui-input/textarea）时落到\n   * 内部原生控件；自定义触发器没有该能力时，原生 focus() 聚焦 host 自身。\n   */\n  focusTrigger(options?: FocusOptions): void\n  /** 失焦当前触发器，兜底语义同 focusTrigger。 */\n  blurTrigger(): void\n  /** 绑定包装 div 上的委托监听（幂等：包装 div 不变则跳过）。 */\n  bind(): void\n  dispose(): void\n}\n\n/**\n * combobox 触发器委托层（autocomplete）。\n *\n * 默认触发器是 shadow 内的 `web-ui-input`，自定义触发器由 `slot[name=\"trigger\"]`\n * 提供（`web-ui-textarea` 等）。两者对组件暴露同一形状：字符串 value、可聚焦、\n * 派发 composed 的 input / click / focusin / focusout。委托层把这些差异收敛成一份接口：\n * 监听统一挂在包装 div 上（事件委托，覆盖 shadow 内与 light DOM 两条路径），\n * 文本读写只认触发器 host 的 value 属性。\n *\n * 焦点用 focusin/focusout 而非 focus/blur：后两者不冒泡，到不了包装 div\n * （实测：shadow 内默认触发器与 light DOM 自定义触发器都不触发包装 div 的 focus/blur）。\n *\n * 触发器自身派发的 change（web-ui-input/textarea 在原生 change 不 composed 时补发）\n * 必须被拦下：组件的 change 只表示「选中提交」，否则失焦即误报一次 change。\n */\nexport const defineComboboxTrigger = () =>\n  definePlugin<ComboboxTriggerApi, ComboboxTriggerSource & ComboboxTriggerHandlers>(source => {\n    let boundWrapper: HTMLElement | null = null\n\n    const getTrigger = (): HTMLElement | null => source.getCustomTrigger() ?? source.getFallbackTrigger() ?? null\n\n    const readValue = (trigger: HTMLElement | null): string | null => {\n      const value = (trigger as (HTMLElement & { value?: unknown }) | null)?.value\n      return typeof value === 'string' ? value : null\n    }\n\n    // composed 事件在包装 div 上看到的是触发器 host（或其在 light DOM 内的后代）；\n    // 只有来自触发器内部的输入才计入，包装 div 上的其它内容不干扰。\n    const isWithinTrigger = (event: Event, trigger: HTMLElement | null): boolean => {\n      const target = event.target\n      return !!trigger && target instanceof Node && (target === trigger || trigger.contains(target))\n    }\n\n    const onInput = (event: Event) => {\n      const trigger = getTrigger()\n      if (!isWithinTrigger(event, trigger)) return\n      const value = readValue(trigger)\n      if (value !== null) source.onInput(value)\n    }\n\n    const onNativeChange = (event: Event) => {\n      if (isWithinTrigger(event, getTrigger())) event.stopPropagation()\n    }\n\n    const onClick = () => source.onClick()\n    const onFocusIn = (event: FocusEvent) => source.onFocusIn(event)\n    const onFocusOut = (event: FocusEvent) => source.onFocusOut(event)\n\n    return {\n      getTrigger,\n      getValue: () => readValue(getTrigger()),\n      setValue(value: string) {\n        const trigger = getTrigger()\n        const current = readValue(trigger)\n        if (!trigger || current === null || current === value) return\n        ;(trigger as HTMLElement & { value: string }).value = value\n      },\n      isMultilineEdit(event: KeyboardEvent) {\n        // composedPath()[0] 是未 retarget 的真实可编辑元素：textarea 保留 Enter 换行\n        return event.composedPath()[0] instanceof HTMLTextAreaElement\n      },\n      focusTrigger(options?: FocusOptions) {\n        // web-ui-input/textarea 的公共 focus() 已重定向到内部原生控件；普通元素或\n        // 未实现 focus 的自定义触发器走原生 HTMLElement.focus()，即聚焦 host 自身\n        getTrigger()?.focus(options)\n      },\n      blurTrigger() {\n        getTrigger()?.blur()\n      },\n      bind() {\n        const wrapper = source.getWrapper()\n        if (!wrapper || wrapper === boundWrapper) return\n        boundWrapper = wrapper\n        wrapper.addEventListener('input', onInput)\n        wrapper.addEventListener('change', onNativeChange)\n        wrapper.addEventListener('click', onClick)\n        wrapper.addEventListener('focusin', onFocusIn)\n        wrapper.addEventListener('focusout', onFocusOut)\n      },\n      dispose() {\n        const wrapper = boundWrapper\n        boundWrapper = null\n        if (!wrapper) return\n        wrapper.removeEventListener('input', onInput)\n        wrapper.removeEventListener('change', onNativeChange)\n        wrapper.removeEventListener('click', onClick)\n        wrapper.removeEventListener('focusin', onFocusIn)\n        wrapper.removeEventListener('focusout', onFocusOut)\n      }\n    }\n  })\n\n/** option 四事件监听对的绑定/解绑；两组件的 handler 签名一致，仅实现不同。 */\nexport function createOptionListenerBinding(handlers: OptionListenerHandlers) {\n  function bind(option: WebUiOption) {\n    option.addEventListener('click', handlers.onClick)\n    option.addEventListener('pointerover', handlers.onPointerOver)\n    option.addEventListener('pointerdown', handlers.onPointerDown)\n    option.addEventListener('option-update', handlers.onUpdate)\n  }\n  function unbind(option: WebUiOption) {\n    option.removeEventListener('click', handlers.onClick)\n    option.removeEventListener('pointerover', handlers.onPointerOver)\n    option.removeEventListener('pointerdown', handlers.onPointerDown)\n    option.removeEventListener('option-update', handlers.onUpdate)\n  }\n  return { bind, unbind }\n}\n\n/**\n * focusout 关闭复核：焦点是否真的离开了宿主与面板。\n * rAF 等待 click/pointerdown 相关的焦点迁移完成后再判定。\n */\nexport function handleComboboxFocusOut(\n  host: HTMLElement,\n  getHandle: () => OpenOverlayHandle | null | undefined,\n  getIsOpen: () => boolean,\n  close: () => void\n): void {\n  requestAnimationFrame(() => {\n    const handle = getHandle()\n    if (getIsOpen() && !host.matches(':focus-within') && !handle?.hasFocusWithin()) {\n      close()\n    }\n  })\n}\n\n/**\n * 环绕游标：在 enabled 列表内按 delta 移动；从 -1（无激活）向下取首项、向上取末项。\n * 返回在 enabled 中的下一索引；调用方负责换算回全量 options 索引。\n */\nexport function nextWrappingIndex(enabledCount: number, currentIdx: number, delta: number): number {\n  if (enabledCount === 0) return -1\n  let nextIdx = currentIdx + delta\n  if (nextIdx < 0) nextIdx = enabledCount - 1\n  if (nextIdx >= enabledCount) nextIdx = 0\n  return nextIdx\n}\n"],"mappings":";;AA2CA,SAAgB,EAA6B,GAAkD;CAC7F,SAAS,EAAK,IAAuB,IAAO;EACtC,EAAM,QAAQ,MAAM,MAAS,EAAM,UAAU,MACjD,EAAM,UAAU,EAAI,GACpB,EAAM,mBAAmB,GACzB,EAAM,SAAS,CAAoB,GACnC,EAAM,eAAe,EAAI,GACrB,EAAM,SAAS,IACjB,4BAA4B;GAC1B,AAAI,EAAM,UAAU,KAAG,EAAM,YAAY,CAAoB;EAC/D,CAAC,IAED,EAAM,YAAY,CAAoB;CAE1C;CAEA,SAAS,IAAQ;EACV,EAAM,UAAU,MACrB,EAAM,gBAAgB,GACtB,EAAM,UAAU,EAAK,GACrB,EAAM,mBAAmB,GACzB,EAAM,eAAe,GACrB,EAAM,eAAe,EAAK,GAC1B,EAAM,aAAa;CACrB;CAEA,OAAO;EAAE;EAAM;CAAM;AACvB;AA+DA,IAAa,UACX,GAAkF,MAAU;CAC1F,IAAI,IAAmC,MAEjC,UAAuC,EAAO,iBAAiB,KAAK,EAAO,mBAAmB,KAAK,MAEnG,KAAa,MAA+C;EAChE,IAAM,IAAS,GAAwD;EACvE,OAAO,OAAO,KAAU,WAAW,IAAQ;CAC7C,GAIM,KAAmB,GAAc,MAAyC;EAC9E,IAAM,IAAS,EAAM;EACrB,OAAO,CAAC,CAAC,KAAW,aAAkB,SAAS,MAAW,KAAW,EAAQ,SAAS,CAAM;CAC9F,GAEM,KAAW,MAAiB;EAChC,IAAM,IAAU,EAAW;EAC3B,IAAI,CAAC,EAAgB,GAAO,CAAO,GAAG;EACtC,IAAM,IAAQ,EAAU,CAAO;EAC/B,AAAI,MAAU,QAAM,EAAO,QAAQ,CAAK;CAC1C,GAEM,KAAkB,MAAiB;EACvC,AAAI,EAAgB,GAAO,EAAW,CAAC,KAAG,EAAM,gBAAgB;CAClE,GAEM,UAAgB,EAAO,QAAQ,GAC/B,KAAa,MAAsB,EAAO,UAAU,CAAK,GACzD,KAAc,MAAsB,EAAO,WAAW,CAAK;CAEjE,OAAO;EACL;EACA,gBAAgB,EAAU,EAAW,CAAC;EACtC,SAAS,GAAe;GACtB,IAAM,IAAU,EAAW,GACrB,IAAU,EAAU,CAAO;GAC7B,AAAC,KAAW,MAAY,QAAQ,MAAY,MAC/C,EAA6C,QAAQ;EACxD;EACA,gBAAgB,GAAsB;GAEpC,OAAO,EAAM,aAAa,CAAC,CAAC,cAAc;EAC5C;EACA,aAAa,GAAwB;GAGnC,EAAW,CAAC,EAAE,MAAM,CAAO;EAC7B;EACA,cAAc;GACZ,EAAW,CAAC,EAAE,KAAK;EACrB;EACA,OAAO;GACL,IAAM,IAAU,EAAO,WAAW;GAC9B,AAAC,KAAW,MAAY,MAC5B,IAAe,GACf,EAAQ,iBAAiB,SAAS,CAAO,GACzC,EAAQ,iBAAiB,UAAU,CAAc,GACjD,EAAQ,iBAAiB,SAAS,CAAO,GACzC,EAAQ,iBAAiB,WAAW,CAAS,GAC7C,EAAQ,iBAAiB,YAAY,CAAU;EACjD;EACA,UAAU;GACR,IAAM,IAAU;GAChB,IAAe,MACV,MACL,EAAQ,oBAAoB,SAAS,CAAO,GAC5C,EAAQ,oBAAoB,UAAU,CAAc,GACpD,EAAQ,oBAAoB,SAAS,CAAO,GAC5C,EAAQ,oBAAoB,WAAW,CAAS,GAChD,EAAQ,oBAAoB,YAAY,CAAU;EACpD;CACF;AACF,CAAC;AAGH,SAAgB,EAA4B,GAAkC;CAC5E,SAAS,EAAK,GAAqB;EAIjC,AAHA,EAAO,iBAAiB,SAAS,EAAS,OAAO,GACjD,EAAO,iBAAiB,eAAe,EAAS,aAAa,GAC7D,EAAO,iBAAiB,eAAe,EAAS,aAAa,GAC7D,EAAO,iBAAiB,iBAAiB,EAAS,QAAQ;CAC5D;CACA,SAAS,EAAO,GAAqB;EAInC,AAHA,EAAO,oBAAoB,SAAS,EAAS,OAAO,GACpD,EAAO,oBAAoB,eAAe,EAAS,aAAa,GAChE,EAAO,oBAAoB,eAAe,EAAS,aAAa,GAChE,EAAO,oBAAoB,iBAAiB,EAAS,QAAQ;CAC/D;CACA,OAAO;EAAE;EAAM;CAAO;AACxB;AAMA,SAAgB,EACd,GACA,GACA,GACA,GACM;CACN,4BAA4B;EAC1B,IAAM,IAAS,EAAU;EACzB,AAAI,EAAU,KAAK,CAAC,EAAK,QAAQ,eAAe,KAAK,CAAC,GAAQ,eAAe,KAC3E,EAAM;CAEV,CAAC;AACH;AAMA,SAAgB,EAAkB,GAAsB,GAAoB,GAAuB;CACjG,IAAI,MAAiB,GAAG,OAAO;CAC/B,IAAI,IAAU,IAAa;CAG3B,OAFI,IAAU,MAAG,IAAU,IAAe,IACtC,KAAW,MAAc,IAAU,IAChC;AACT"}

package/dist/shared/option-portal/index.js

@@ -1,23 +1,23 @@
-import { createComboboxOpenController as e, createOptionListenerBinding as t, handleComboboxFocusOut as n, nextWrappingIndex as r } from "./combobox-shell.js";
-import { definePlugin as i } from "@greypan/js-kit";
+import { createComboboxOpenController as e, createOptionListenerBinding as t, defineComboboxTrigger as n, handleComboboxFocusOut as r, nextWrappingIndex as i } from "./combobox-shell.js";
+import { definePlugin as a } from "@greypan/js-kit";
 //#region src/shared/option-portal/index.ts
-var a = "web-ui-option", o = () => i((e) => {
+var o = "web-ui-option", s = () => a((e) => {
 	let t = /* @__PURE__ */ new Set(), n = /* @__PURE__ */ new WeakMap(), r = 0, i = (t) => {
 		e.bindOption(t), t.addEventListener("option-unregister", s);
-	}, o = (t) => {
+	}, a = (t) => {
 		e.unbindOption(t), t.removeEventListener("option-unregister", s);
 	}, s = (e) => {
-		e.target instanceof HTMLElement && e.target.localName === a && t.add(e.target), l.scheduleRefresh();
+		e.target instanceof HTMLElement && e.target.localName === o && t.add(e.target), l.scheduleRefresh();
 	}, c = () => {
 		l.scheduleRefresh();
 	}, l = {
 		queryOptions() {
-			let t = e.getPortal()?.panel ?? e.getPortalContent(), n = t ? [...t.querySelectorAll(a)] : [];
-			return n.length > 0 ? n : [...e.element.querySelectorAll(a)];
+			let t = e.getPortal()?.panel ?? e.getPortalContent(), n = t ? [...t.querySelectorAll(o)] : [];
+			return n.length > 0 ? n : [...e.element.querySelectorAll(o)];
 		},
 		refresh(e, t) {
 			let n = l.queryOptions();
-			for (let t of e) n.includes(t) || o(t);
+			for (let t of e) n.includes(t) || a(t);
 			return n.forEach(i), {
 				options: n,
 				activeIndex: t && n.includes(t) ? n.indexOf(t) : -1
@@ -61,6 +61,6 @@ var a = "web-ui-option", o = () => i((e) => {
 	return l;
 });
 //#endregion
-export { e as createComboboxOpenController, t as createOptionListenerBinding, o as defineOptionPortal, n as handleComboboxFocusOut, r as nextWrappingIndex };
+export { e as createComboboxOpenController, t as createOptionListenerBinding, n as defineComboboxTrigger, s as defineOptionPortal, r as handleComboboxFocusOut, i as nextWrappingIndex };
 
 //# sourceMappingURL=index.js.map

package/dist/shared/overlay/anchored-panel.js

@@ -37,9 +37,9 @@ var i = () => r((r) => {
 		},
 		open: f,
 		async close(e) {
-			c(), i?.close();
+			o?.deferArbitration(), i?.close();
 			let n = s();
-			return n && !await t(n) || e() ? !1 : (l(), !0);
+			return n && !await t(n) ? !1 : e() ? (o?.deferArbitration(!1), !1) : (c(), l(), !0);
 		},
 		updatePosition() {
 			i?.update(r.getPositioning());

package/dist/shared/overlay/anchored-panel.js.map

@@ -1 +1 @@
-{"version":3,"file":"anchored-panel.js","names":[],"sources":["../../../src/shared/overlay/anchored-panel.ts"],"sourcesContent":["import { definePlugin } from '@greypan/js-kit'\n\nimport type { OpenOverlay, OpenOverlayHandle, OverlayArbitration } from './open-overlay'\nimport type { OverlayOptions } from './overlay'\nimport { defineOverlay } from './overlay'\nimport type { OverlayApi } from './overlay'\nimport type { OverlayPortal } from './portal'\nimport { hideOverlayPresence, showOverlayPresence } from './presence'\n\nexport interface AnchoredPanelOptions {\n  getAnchor(): HTMLElement | null\n  getLocalPanel(): HTMLElement | null\n  getPositioning(): OverlayOptions\n  isPortal(): boolean\n  createPortal(): OverlayPortal\n  /**\n   * 承载「本面板是一次开启态浮层」的实例：登记与 Escape 归属由它完成，本模块不再\n   * 自己维护逻辑父子关系。\n   *\n   * 必须是**调用方持有的那个实例**（而不是这里新建一个）——调用方同时要用它的帧\n   * 事务入口，两个实例会让「我开着吗」重新分裂。\n   */\n  openOverlay: OpenOverlay\n  /** 本面板与 Escape 仲裁的关系。tooltip 传 `none`；缺省 `escape`。 */\n  arbitration?: OverlayArbitration\n}\n\n/**\n * 管理锚定面板的本地/Portal 容器、定位器和可中断 presence。\n * 内容迁移与交互语义由各组件保留，避免把不同组件的 public contract 混入此模块。\n */\nexport interface AnchoredPanelApi {\n  getPanel(): HTMLElement | null\n  /**\n   * 当前开启会话的句柄；未开启时为 `null`。\n   * 查询（`contains` / `containsEvent` / `hasFocusWithin`）与 `setInert` 都走它，\n   * 调用方因此不必持有 panel 引用，也不知道存在全局注册表。\n   */\n  getHandle(): OpenOverlayHandle | null\n  open(isInstant?: boolean): void\n  close(isStillOpen: () => boolean): Promise<boolean>\n  updatePosition(): void\n  reconfigure(isOpen: boolean): void\n  dispose(): void\n}\n\nexport const defineAnchoredPanel = () =>\n  definePlugin<AnchoredPanelApi, AnchoredPanelOptions>(ctx => {\n    let overlay: OverlayApi | undefined\n    let portal: OverlayPortal | undefined\n    let handle: OpenOverlayHandle | null = null\n\n    const getPanel = () => portal?.panel ?? ctx.getLocalPanel()\n\n    const releaseHandle = () => {\n      handle?.release()\n      handle = null\n    }\n\n    const disposePortal = () => {\n      if (!portal) return\n      portal.restoreContent()\n      portal.remove()\n      portal = undefined\n      overlay = undefined\n    }\n\n    const getOrCreatePanel = (): HTMLElement | null => {\n      if (!ctx.isPortal()) return ctx.getLocalPanel()\n      portal ??= ctx.createPortal()\n      return portal.panel\n    }\n\n    const ensureOverlay = (anchor: HTMLElement, panel: HTMLElement) => {\n      if (overlay) {\n        overlay.updateAnchor(anchor)\n        overlay.update(ctx.getPositioning())\n        return\n      }\n      overlay = defineOverlay().make({ anchor, overlay: panel, ...ctx.getPositioning() })\n    }\n\n    const open = (isInstant = false) => {\n      const anchor = ctx.getAnchor()\n      if (!anchor) return\n      const panel = getOrCreatePanel()\n      if (!panel) return\n      // portal panel 与宿主物理分离；本地 panel 也可能隔着 shadow 边界。\n      // 以 anchor 祖先链寻找最近的已开启浮层，建立统一逻辑父子关系。\n      // claim ⟺ open：重复 open 视为新的一次开启，旧会话整体作废。\n      releaseHandle()\n      handle = ctx.openOverlay.claim(panel, { arbitration: ctx.arbitration, ancestryFrom: anchor })\n      ensureOverlay(anchor, panel)\n      overlay?.open()\n      showOverlayPresence(panel, { isInstant })\n    }\n\n    const dispose = () => {\n      overlay?.dispose()\n      overlay = undefined\n      releaseHandle()\n      disposePortal()\n    }\n\n    return {\n      getPanel() {\n        return getPanel()\n      },\n\n      getHandle() {\n        return handle\n      },\n\n      open,\n\n      async close(isStillOpen) {\n        /*\n         * 开启态在这一刻结束：仲裁归属与逻辑组合树同时撤销，不等退场动画。\n         *\n         * 撤销晚于 `open → false` 会让关闭中的面板继续当「最内层」——它已不再开启却仍\n         * 占着名额，于是紧接着的 Escape 被它吞掉，外层浮层永远等不到自己那一次\n         * （issue #120 承诺的「一次 Escape 关一层」退化成关不掉外面那层）。\n         * 旧实现里仲裁候选读 `isOpen()`、组合树读登记表，两者寿命本就不同；本模块用\n         * 「已登记 ⟺ 已开启」把二者统一到 open 语义上。\n         *\n         * 退场被中断（重新打开）时句柄已撤销，随后的 `open()` 会重新 claim —— 与\n         * 「重复 open 视为新的一次开启」走同一条路径，不会留下无主的层。\n         */\n        releaseHandle()\n        overlay?.close()\n        const panel = getPanel()\n        if (panel && !(await hideOverlayPresence(panel))) return false\n        if (isStillOpen()) return false\n        disposePortal()\n        return true\n      },\n\n      updatePosition() {\n        overlay?.update(ctx.getPositioning())\n      },\n\n      reconfigure(isOpen) {\n        const shouldAnimate = getPanel()?.dataset.wuiPresence === 'entering'\n        dispose()\n        if (isOpen) open(!shouldAnimate)\n      },\n\n      dispose\n    }\n  })\n"],"mappings":";;;;AA8CA,IAAa,UACX,GAAqD,MAAO;CAC1D,IAAI,GACA,GACA,IAAmC,MAEjC,UAAiB,GAAQ,SAAS,EAAI,cAAc,GAEpD,UAAsB;EAE1B,AADA,GAAQ,QAAQ,GAChB,IAAS;CACX,GAEM,UAAsB;EACrB,MACL,EAAO,eAAe,GACtB,EAAO,OAAO,GACd,IAAS,KAAA,GACT,IAAU,KAAA;CACZ,GAEM,UACC,EAAI,SAAS,KAClB,MAAW,EAAI,aAAa,GACrB,EAAO,SAFc,EAAI,cAAc,GAK1C,KAAiB,GAAqB,MAAuB;EACjE,IAAI,GAAS;GAEX,AADA,EAAQ,aAAa,CAAM,GAC3B,EAAQ,OAAO,EAAI,eAAe,CAAC;GACnC;EACF;EACA,IAAU,EAAc,CAAC,CAAC,KAAK;GAAE;GAAQ,SAAS;GAAO,GAAG,EAAI,eAAe;EAAE,CAAC;CACpF,GAEM,KAAQ,IAAY,OAAU;EAClC,IAAM,IAAS,EAAI,UAAU;EAC7B,IAAI,CAAC,GAAQ;EACb,IAAM,IAAQ,EAAiB;EAC1B,MAIL,EAAc,GACd,IAAS,EAAI,YAAY,MAAM,GAAO;GAAE,aAAa,EAAI;GAAa,cAAc;EAAO,CAAC,GAC5F,EAAc,GAAQ,CAAK,GAC3B,GAAS,KAAK,GACd,EAAoB,GAAO,EAAE,aAAU,CAAC;CAC1C,GAEM,UAAgB;EAIpB,AAHA,GAAS,QAAQ,GACjB,IAAU,KAAA,GACV,EAAc,GACd,EAAc;CAChB;CAEA,OAAO;EACL,WAAW;GACT,OAAO,EAAS;EAClB;EAEA,YAAY;GACV,OAAO;EACT;EAEA;EAEA,MAAM,MAAM,GAAa;GAcvB,AADA,EAAc,GACd,GAAS,MAAM;GACf,IAAM,IAAQ,EAAS;GAIvB,OAHI,KAAS,CAAE,MAAM,EAAoB,CAAK,KAC1C,EAAY,IAAU,MAC1B,EAAc,GACP;EACT;EAEA,iBAAiB;GACf,GAAS,OAAO,EAAI,eAAe,CAAC;EACtC;EAEA,YAAY,GAAQ;GAClB,IAAM,IAAgB,EAAS,CAAC,EAAE,QAAQ,gBAAgB;GAE1D,AADA,EAAQ,GACJ,KAAQ,EAAK,CAAC,CAAa;EACjC;EAEA;CACF;AACF,CAAC"}
+{"version":3,"file":"anchored-panel.js","names":[],"sources":["../../../src/shared/overlay/anchored-panel.ts"],"sourcesContent":["import { definePlugin } from '@greypan/js-kit'\n\nimport type { OpenOverlay, OpenOverlayHandle, OverlayArbitration } from './open-overlay'\nimport type { OverlayOptions } from './overlay'\nimport { defineOverlay } from './overlay'\nimport type { OverlayApi } from './overlay'\nimport type { OverlayPortal } from './portal'\nimport { hideOverlayPresence, showOverlayPresence } from './presence'\n\nexport interface AnchoredPanelOptions {\n  getAnchor(): HTMLElement | null\n  getLocalPanel(): HTMLElement | null\n  getPositioning(): OverlayOptions\n  isPortal(): boolean\n  createPortal(): OverlayPortal\n  /**\n   * 承载「本面板是一次开启态浮层」的实例：登记与 Escape 归属由它完成，本模块不再\n   * 自己维护逻辑父子关系。\n   *\n   * 必须是**调用方持有的那个实例**（而不是这里新建一个）——调用方同时要用它的帧\n   * 事务入口，两个实例会让「我开着吗」重新分裂。\n   */\n  openOverlay: OpenOverlay\n  /** 本面板与 Escape 仲裁的关系。tooltip 传 `none`；缺省 `escape`。 */\n  arbitration?: OverlayArbitration\n}\n\n/**\n * 管理锚定面板的本地/Portal 容器、定位器和可中断 presence。\n * 内容迁移与交互语义由各组件保留，避免把不同组件的 public contract 混入此模块。\n */\nexport interface AnchoredPanelApi {\n  getPanel(): HTMLElement | null\n  /**\n   * 当前在场会话的句柄；没有任何在场会话时为 `null`。\n   * 查询（`contains` / `containsEvent` / `hasFocusWithin`）与 `setInert` 都走它，\n   * 调用方因此不必持有 panel 引用，也不知道存在全局注册表。\n   * 退场等待期间仍是同一个句柄（暂缓仲裁），动画播完或重新 `open()` 才换人。\n   */\n  getHandle(): OpenOverlayHandle | null\n  open(isInstant?: boolean): void\n  close(isStillOpen: () => boolean): Promise<boolean>\n  updatePosition(): void\n  reconfigure(isOpen: boolean): void\n  dispose(): void\n}\n\nexport const defineAnchoredPanel = () =>\n  definePlugin<AnchoredPanelApi, AnchoredPanelOptions>(ctx => {\n    let overlay: OverlayApi | undefined\n    let portal: OverlayPortal | undefined\n    let handle: OpenOverlayHandle | null = null\n\n    const getPanel = () => portal?.panel ?? ctx.getLocalPanel()\n\n    const releaseHandle = () => {\n      handle?.release()\n      handle = null\n    }\n\n    const disposePortal = () => {\n      if (!portal) return\n      portal.restoreContent()\n      portal.remove()\n      portal = undefined\n      overlay = undefined\n    }\n\n    const getOrCreatePanel = (): HTMLElement | null => {\n      if (!ctx.isPortal()) return ctx.getLocalPanel()\n      portal ??= ctx.createPortal()\n      return portal.panel\n    }\n\n    const ensureOverlay = (anchor: HTMLElement, panel: HTMLElement) => {\n      if (overlay) {\n        overlay.updateAnchor(anchor)\n        overlay.update(ctx.getPositioning())\n        return\n      }\n      overlay = defineOverlay().make({ anchor, overlay: panel, ...ctx.getPositioning() })\n    }\n\n    const open = (isInstant = false) => {\n      const anchor = ctx.getAnchor()\n      if (!anchor) return\n      const panel = getOrCreatePanel()\n      if (!panel) return\n      // portal panel 与宿主物理分离；本地 panel 也可能隔着 shadow 边界。\n      // 以 anchor 祖先链寻找最近的已开启浮层，建立统一逻辑父子关系。\n      // claim ⟺ open：重复 open 视为新的一次开启，旧会话整体作废。\n      releaseHandle()\n      handle = ctx.openOverlay.claim(panel, { arbitration: ctx.arbitration, ancestryFrom: anchor })\n      ensureOverlay(anchor, panel)\n      overlay?.open()\n      showOverlayPresence(panel, { isInstant })\n    }\n\n    const dispose = () => {\n      overlay?.dispose()\n      overlay = undefined\n      releaseHandle()\n      disposePortal()\n    }\n\n    return {\n      getPanel() {\n        return getPanel()\n      },\n\n      getHandle() {\n        return handle\n      },\n\n      open,\n\n      async close(isStillOpen) {\n        /*\n         * 第三态「可见但暂缓仲裁」：退场等待期间面板仍在场，登记不撤，但不再走关闭\n         * 入口——它已经在关的路上了。撤销推迟到动画结束，或被 `open()` 以新会话取代。\n         *\n         * 旧实现在这里立即 `releaseHandle()`，于是两条提前返回的路径都把还看得见的面板\n         * 留在未登记状态：未登记即不参与「谁是最内层」的仲裁，直到下一次 `open()` 才\n         * 恢复（issue #138）。\n         *\n         * 暂缓层只是兜底候选：仍在开启的外层永远优先。否则「内层关掉后立刻再按一次\n         * Escape」会被退场动画吞掉，外层永远等不到自己那一次——issue #120 的契约。\n         *\n         * 退场被打断时 `showOverlayPresence` 已把面板带回场，`open()` 同时重新 claim\n         * （与「重复 open 视为新的一次开启」同一条路径），本条 `close()` 随后的\n         * `return false` 不碰那个新句柄。\n         *\n         * 走到 `isStillOpen()` 时退场已经播完：面板已 `hidden`。此刻宿主仍认为开着，\n         * 是面板状态与宿主状态不一致的那一格——把层交还仲裁而不是继续暂缓。继续暂缓的\n         * 前提是「面板可见」，而这里面板已经看不见了：一个隐藏的面板无限吞掉 Escape，\n         * 用户再也没有按键路径把这个状态收敛掉（按一次 Escape 走宿主的关闭入口，宿主\n         * 回写 open=false 后由随后的 close() 正常收尾）。登记仍然不撤，「宿主认为开着\n         * 就不掉出仲裁」的 #138 语义不变。\n         */\n        handle?.deferArbitration()\n        overlay?.close()\n        const panel = getPanel()\n        if (panel && !(await hideOverlayPresence(panel))) return false\n        if (isStillOpen()) {\n          handle?.deferArbitration(false)\n          return false\n        }\n        releaseHandle()\n        disposePortal()\n        return true\n      },\n\n      updatePosition() {\n        overlay?.update(ctx.getPositioning())\n      },\n\n      reconfigure(isOpen) {\n        const shouldAnimate = getPanel()?.dataset.wuiPresence === 'entering'\n        dispose()\n        if (isOpen) open(!shouldAnimate)\n      },\n\n      dispose\n    }\n  })\n"],"mappings":";;;;AA+CA,IAAa,UACX,GAAqD,MAAO;CAC1D,IAAI,GACA,GACA,IAAmC,MAEjC,UAAiB,GAAQ,SAAS,EAAI,cAAc,GAEpD,UAAsB;EAE1B,AADA,GAAQ,QAAQ,GAChB,IAAS;CACX,GAEM,UAAsB;EACrB,MACL,EAAO,eAAe,GACtB,EAAO,OAAO,GACd,IAAS,KAAA,GACT,IAAU,KAAA;CACZ,GAEM,UACC,EAAI,SAAS,KAClB,MAAW,EAAI,aAAa,GACrB,EAAO,SAFc,EAAI,cAAc,GAK1C,KAAiB,GAAqB,MAAuB;EACjE,IAAI,GAAS;GAEX,AADA,EAAQ,aAAa,CAAM,GAC3B,EAAQ,OAAO,EAAI,eAAe,CAAC;GACnC;EACF;EACA,IAAU,EAAc,CAAC,CAAC,KAAK;GAAE;GAAQ,SAAS;GAAO,GAAG,EAAI,eAAe;EAAE,CAAC;CACpF,GAEM,KAAQ,IAAY,OAAU;EAClC,IAAM,IAAS,EAAI,UAAU;EAC7B,IAAI,CAAC,GAAQ;EACb,IAAM,IAAQ,EAAiB;EAC1B,MAIL,EAAc,GACd,IAAS,EAAI,YAAY,MAAM,GAAO;GAAE,aAAa,EAAI;GAAa,cAAc;EAAO,CAAC,GAC5F,EAAc,GAAQ,CAAK,GAC3B,GAAS,KAAK,GACd,EAAoB,GAAO,EAAE,aAAU,CAAC;CAC1C,GAEM,UAAgB;EAIpB,AAHA,GAAS,QAAQ,GACjB,IAAU,KAAA,GACV,EAAc,GACd,EAAc;CAChB;CAEA,OAAO;EACL,WAAW;GACT,OAAO,EAAS;EAClB;EAEA,YAAY;GACV,OAAO;EACT;EAEA;EAEA,MAAM,MAAM,GAAa;GAwBvB,AADA,GAAQ,iBAAiB,GACzB,GAAS,MAAM;GACf,IAAM,IAAQ,EAAS;GAQvB,OAPI,KAAS,CAAE,MAAM,EAAoB,CAAK,IAAW,KACrD,EAAY,KACd,GAAQ,iBAAiB,EAAK,GACvB,OAET,EAAc,GACd,EAAc,GACP;EACT;EAEA,iBAAiB;GACf,GAAS,OAAO,EAAI,eAAe,CAAC;EACtC;EAEA,YAAY,GAAQ;GAClB,IAAM,IAAgB,EAAS,CAAC,EAAE,QAAQ,gBAAgB;GAE1D,AADA,EAAQ,GACJ,KAAQ,EAAK,CAAC,CAAa;EACjC;EAEA;CACF;AACF,CAAC"}

package/dist/shared/overlay/open-overlay.js

@@ -1,6 +1,7 @@
 import { definePlugin as e } from "@greypan/js-kit";
 //#region src/shared/overlay/open-overlay.ts
 var t = /* @__PURE__ */ new Set(), n = /* @__PURE__ */ new WeakMap(), r = /* @__PURE__ */ new WeakMap(), i = /* @__PURE__ */ new WeakMap(), a = /* @__PURE__ */ new WeakMap(), o = !1, s = 0, c = {
+	deferArbitration() {},
 	setInert() {},
 	adopt: () => c,
 	contains: () => !1,
@@ -58,10 +59,11 @@ function g(e) {
 			let e = n.get(t);
 			e ? g(e) : d(t);
 		}
-		t.delete(e), n.delete(e.panel), a.delete(e.panel), d(e.panel), x();
+		t.delete(e), n.delete(e.panel), a.delete(e.panel), d(e.panel);
 	}
 }
 function _(e) {
+	S();
 	let i = n.get(e.panel);
 	i && g(i);
 	let a = {
@@ -69,11 +71,15 @@ function _(e) {
 		host: e.host,
 		arbitration: e.arbitration,
 		inert: !1,
+		deferred: !1,
 		seq: ++s,
 		released: !1
 	};
 	t.add(a), n.set(e.panel, a), f(e.panel, e.parent);
 	let o = {
+		deferArbitration(e = !0) {
+			a.released || (a.deferred = e);
+		},
 		setInert(e) {
 			a.released || (a.inert = e);
 		},
@@ -95,43 +101,53 @@ function _(e) {
 			return !a.released && m(a.panel);
 		},
 		release() {
-			g(a);
+			g(a), C();
 		}
 	};
-	return r.set(o, a), x(), o;
+	return r.set(o, a), C(!1), o;
 }
 function v(e) {
 	return !e.released && e.arbitration !== "none" && e.panel.isConnected;
 }
-function y() {
-	let e = null;
-	for (let n of t) if (v(n)) {
-		if (!e) {
-			e = n;
+function y(e) {
+	let t = null;
+	for (let n of e) {
+		if (!t) {
+			t = n;
 			continue;
 		}
-		if (p(e.panel, n.panel)) {
-			e = n;
+		if (p(t.panel, n.panel)) {
+			t = n;
 			continue;
 		}
-		p(n.panel, e.panel) || n.seq > e.seq && (e = n);
+		p(n.panel, t.panel) || n.seq > t.seq && (t = n);
 	}
-	return e;
+	return t;
+}
+function b() {
+	C();
+	let e = [], n = [];
+	for (let r of t) v(r) && (r.deferred ? n.push(r) : e.push(r));
+	return y(e) ?? y(n);
 }
-function b(e) {
+function x(e) {
 	if (e.key !== "Escape" || e.defaultPrevented) return;
-	let t = y();
-	t && (e.preventDefault(), e.stopPropagation(), !t.inert && t.host.requestClose());
+	let t = b();
+	t && (e.preventDefault(), e.stopPropagation(), !(t.inert || t.deferred) && t.host.requestClose());
+}
+function S() {
+	for (let e of Array.from(t)) e.released || e.panel.isConnected || e.host.isConnected() || g(e);
 }
-function x() {
-	let e = !1;
-	for (let n of t) if (!n.released && n.arbitration !== "none") {
-		e = !0;
+function C(e = !0) {
+	e && S();
+	let n = !1;
+	for (let e of t) if (!e.released && e.arbitration !== "none") {
+		n = !0;
 		break;
 	}
-	e !== o && (o = e, e ? document.addEventListener("keydown", b, !0) : document.removeEventListener("keydown", b, !0));
+	n !== o && (o = n, n ? document.addEventListener("keydown", x, !0) : document.removeEventListener("keydown", x, !0));
 }
-var S = () => e((e) => {
+var w = () => e((e) => {
 	let t = 0, n = !1, i = /* @__PURE__ */ new Set(), a = (e) => {
 		cancelAnimationFrame(e.id), i.delete(e);
 	}, o = () => {
@@ -177,6 +193,6 @@ var S = () => e((e) => {
 	};
 });
 //#endregion
-export { S as defineOpenOverlay };
+export { w as defineOpenOverlay };
 
 //# sourceMappingURL=open-overlay.js.map

package/dist/shared/overlay/open-overlay.js.map

@@ -1 +1 @@
-{"version":3,"file":"open-overlay.js","names":[],"sources":["../../../src/shared/overlay/open-overlay.ts"],"sourcesContent":["/**\n * 开启态浮层（open overlay）——「哪一层正开着」的唯一拥有者。\n *\n * 合并原先三个各自问一遍「你现在开着吗」的模块：composition（逻辑父子树）、\n * escape-dismiss（最内层仲裁）、lifecycle（帧事务失效）。合并的判据不是三者文件相邻，\n * 而是它们共享同一条不变量：**已登记 ⟺ 已开启 ⟺ 参与 Escape 仲裁**。\n *\n * 拆成三个模块时这条不变量没有主人，8 个浮层组件各自把它拼成三步协议\n * （`registerPanelFromAncestry` + `setPanel` / `unregisterPanel` + `setPanel(null)`）。\n * 结果是「漏撤销」与「重挂载后与仲裁失联」只能靠每个组件自己记得，而\n * `lifecycle` 还得让调用方手工传一个 `expectedOpen` 来复述「我开着吗」。\n *\n * 本模块的取舍：\n *\n * - 身份是**句柄**而非 panel 元素：`release()` 不需要调用方回忆当初传了哪个 panel。\n * - 开启状态是**声明**而非询问：仲裁时不再回调宿主问 `isOpen()`，宿主只提供\n *   `requestClose()`；模块持有的真相即真相。\n * - `claim` 即「我开着」：一次 claim 对应一次开启，登记与仲裁是同一个动作。\n * - 查询走句柄（`contains` / `containsEvent` / `hasFocusWithin`），调用方不再需要\n *   持有 panel 引用，也不知道存在全局注册表。\n * - 实例作用域与会话作用域分开：帧事务的 lifetime 比一次开合长（tooltip 跨断连\n *   `resume()`），把它压进会话句柄会在 `release()` 时误杀事务。\n *\n * 刻意**不**吸收 presence、滚动锁与 drawer 的层序（nested layers）：它们回答的是\n * 视觉问题（`is-visible`、层序缩放），与「谁是最内层」正交，硬合并会互相污染。\n */\n\nimport { definePlugin } from '@greypan/js-kit'\n\n/**\n * 本层是否参与 Escape 仲裁。\n *\n * - `escape`：正常候选。命中即走宿主既有的用户关闭入口。\n * - `none`：只在逻辑组合树内，完全不参与仲裁，Escape 穿过它落到下层。用于 tooltip\n *   —— 它今天就在树里（经 anchored panel 登记）但从不作为候选。\n *\n * 「暂时不可关闭」不在这里，而由 `setInert` 表达。静态与动态是同一件事的两面：\n * `no-escape-close` 这类策略看似静态，但它是**被观察的属性**，开启期间可被改写，\n * 所以同样要走动态通道（claim 后立即 `setInert(noEscapeClose)`）。把静态策略做成\n * 第三个枚举值只会产生一个没有真实调用方的成员。\n */\nexport type OverlayArbitration = 'escape' | 'none'\n\nexport interface OverlayClaimOptions {\n  /** 默认 `escape`。 */\n  arbitration?: OverlayArbitration\n  /**\n   * 沿该节点的祖先链寻找最近的已开启浮层，作为本层的逻辑父级；缺省用 panel 自身。\n   *\n   * portal 面板与宿主物理分离，从 panel 自身向上走找不到组合父级，必须由调用方给出\n   * 锚点（trigger）或宿主，才能把「谁在谁里面」判对。\n   *\n   * **顺序约束**：祖先链查找要求 panel 与 ancestryFrom 此刻都已就位（在 DOM 中）。\n   * 本模块不做「等一帧再补登记」——那会让「已登记」与「已开启」短暂不等。\n   */\n  ancestryFrom?: Node\n}\n\nexport interface OverlayFrameHandle {\n  cancel(): void\n}\n\n/** 会话作用域：一次开启对应一个句柄。 */\nexport interface OpenOverlayHandle {\n  /**\n   * 惰性：仍是候选（照旧 `preventDefault()` 压掉原生 `<dialog>` 的关闭请求），但不走\n   * 关闭入口。这是「暂时不可关闭」的唯一通道，静态策略与瞬时状态都走这里。\n   *\n   * 不改变本层在树里的位置，也不改变 `seq` —— 因此不会影响并列浮层的裁决顺序。\n   * `none` 层不受影响（它本就不是候选）。\n   *\n   * **与会话同 lifetime，新会话恒从 `false` 开始**：`claim` 建立的每一层都重置为\n   * 非惰性。所以凡是「重新 claim」的路径（`anchored-panel.reconfigure`、同一 panel 重复\n   * `open()`）之后，都必须按当前状态重推一次，否则惰性会被静默清掉。重推放在哪里取决于\n   * 该组件在 reconfigure 后是否渲染：会渲染的（select / autocomplete 在 `updated()` 里\n   * 同步）可以把紧随 claim 的那一行降级为备份，不会渲染的（popover）必须自己补。\n   */\n  setInert(inert: boolean): void\n  /**\n   * 把子层 panel 纳入本句柄的子树（多级子菜单），默认不成为独立候选。\n   *\n   * 与 `claim` 的区别只在父级如何确定：`claim` 走祖先链，`adopt` 由调用方指名。\n   *\n   * 在已 `release()` 的句柄上调用**不建层**、返回空操作句柄 —— 否则会建出一个父层已死\n   * 的孤层：它仍参与仲裁，却不在父层的子树里，除调用方手里那个句柄外没有回收路径。\n   */\n  adopt(panel: HTMLElement, options?: OverlayClaimOptions): OpenOverlayHandle\n  /** 本层子树（含已 adopt 的子层）是否包含 node。 */\n  contains(node: Node): boolean\n  /** event 的完整 composed path 是否落入本层子树。 */\n  containsEvent(event: Event): boolean\n  /** 焦点是否在本层子树内。 */\n  hasFocusWithin(): boolean\n  /** 幂等。撤销本层及其全部子层，退出仲裁。 */\n  release(): void\n}\n\n/** 实例作用域：每个宿主组件一次，跨开合与断连存活。 */\nexport interface OpenOverlay {\n  claim(panel: HTMLElement, options?: OverlayClaimOptions): OpenOverlayHandle\n  /**\n   * 帧事务调度。`whileLive` 句柄一旦 release，回调自动作废 —— 取代原先由调用方\n   * 手工传入 `expectedOpen` 的轮询（那个参数正是「模块还得回头问宿主」的证据）。\n   */\n  scheduleFrame(callback: () => void, whileLive?: OpenOverlayHandle): OverlayFrameHandle\n  /** 结束当前事务：取消未执行的 frame，并让旧 generation 的回调失效。 */\n  invalidate(): void\n  /** 断连后停止调度（可 `resume()`）；generation 继续单调递增，旧事务保持失效。 */\n  suspend(): void\n  resume(): void\n}\n\nexport interface OpenOverlayHost {\n  /** 走宿主既有的用户关闭入口（内部负责 controlled 语义与 `open-change` 派发）。 */\n  requestClose(): void\n}\n\ninterface Layer {\n  panel: HTMLElement\n  host: OpenOverlayHost\n  arbitration: OverlayArbitration\n  /** 动态惰性开关，与会话同 lifetime。 */\n  inert: boolean\n  /** 登记序号：互不包含的并列浮层里，后开的更靠上。 */\n  seq: number\n  released: boolean\n}\n\n/*\n * 模块级注册表：单例 document 监听器需要一个全局视野，这正是「谁是最内层」不能被\n * 拆到各组件里的原因。显式 release 是唯一的删除路径；`panel.isConnected` 作为兜底\n * 过滤，避免「宿主被移除但忘了 release」留下仍可仲裁的幽灵层（读 panel 的 DOM 属性\n * 不是回调宿主，不违反声明式的取舍）。\n */\nconst layers = new Set<Layer>()\nconst layerByPanel = new WeakMap<HTMLElement, Layer>()\nconst layerByHandle = new WeakMap<OpenOverlayHandle, Layer>()\nconst parents = new WeakMap<HTMLElement, HTMLElement>()\nconst childPanels = new WeakMap<HTMLElement, Set<HTMLElement>>()\nlet listening = false\nlet sequence = 0\n\n/*\n * 已失效句柄的空操作替身，用于 `adopt` 在 released 句柄上的返回值。其余句柄方法在\n * released 时都静默降级，返回值也必须一起降级，否则调用方会以为自己拿到了一棵可用子树。\n */\nconst inactiveHandle: OpenOverlayHandle = {\n  setInert() {},\n  adopt: () => inactiveHandle,\n  contains: () => false,\n  containsEvent: () => false,\n  hasFocusWithin: () => false,\n  release() {}\n}\n\nfunction nextCompositionNode(node: Node): Node | null {\n  if (node instanceof Element && node.assignedSlot) return node.assignedSlot\n  if (node.parentNode) return node.parentNode\n  if (node instanceof ShadowRoot) return node.host\n  return null\n}\n\nfunction nodeIsInside(root: HTMLElement, node: Node): boolean {\n  let current: Node | null = node\n  while (current) {\n    if (current === root || root.contains(current)) return true\n    current = nextCompositionNode(current)\n  }\n  return false\n}\n\nfunction detachFromParent(panel: HTMLElement): void {\n  const parent = parents.get(panel)\n  if (!parent) return\n  const siblings = childPanels.get(parent)\n  siblings?.delete(panel)\n  if (siblings?.size === 0) childPanels.delete(parent)\n  parents.delete(panel)\n}\n\nfunction attachToParent(panel: HTMLElement, parent: HTMLElement | undefined): void {\n  detachFromParent(panel)\n  if (!parent || parent === panel) return\n  const siblings = childPanels.get(parent) ?? new Set<HTMLElement>()\n  siblings.add(panel)\n  childPanels.set(parent, siblings)\n  parents.set(panel, parent)\n}\n\n/** panel 自身或其任何已登记子层是否包含 target。 */\nfunction containsPanel(panel: HTMLElement, target: Node): boolean {\n  if (nodeIsInside(panel, target)) return true\n  for (const child of childPanels.get(panel) ?? []) {\n    if (containsPanel(child, target)) return true\n  }\n  return false\n}\n\nfunction hasFocusWithinPanel(panel: HTMLElement): boolean {\n  if (panel.matches(':focus-within')) return true\n  for (const child of childPanels.get(panel) ?? []) {\n    if (hasFocusWithinPanel(child)) return true\n  }\n  return false\n}\n\n/** 从 from 沿祖先链找最近的已开启浮层 panel；panel 自身永远不算自己的父级。 */\nfunction findOpenAncestor(panel: HTMLElement, from: Node): HTMLElement | null {\n  let current: Node | null = from === panel ? nextCompositionNode(from) : from\n  while (current) {\n    if (current instanceof HTMLElement && current !== panel) {\n      const candidate = layerByPanel.get(current)\n      if (candidate && !candidate.released) return current\n    }\n    current = nextCompositionNode(current)\n  }\n  return null\n}\n\nfunction releaseLayer(layer: Layer): void {\n  if (layer.released) return\n  layer.released = true\n  for (const child of Array.from(childPanels.get(layer.panel) ?? [])) {\n    const childLayer = layerByPanel.get(child)\n    if (childLayer) releaseLayer(childLayer)\n    else detachFromParent(child)\n  }\n  layers.delete(layer)\n  layerByPanel.delete(layer.panel)\n  childPanels.delete(layer.panel)\n  detachFromParent(layer.panel)\n  syncListener()\n}\n\nfunction createLayer(input: {\n  panel: HTMLElement\n  host: OpenOverlayHost\n  arbitration: OverlayArbitration\n  parent?: HTMLElement\n}): OpenOverlayHandle {\n  const previous = layerByPanel.get(input.panel)\n  // 同一 panel 重新 claim = 新的一次开启：旧会话（含其子层）整体作废，seq 重新分配。\n  if (previous) releaseLayer(previous)\n\n  const layer: Layer = {\n    panel: input.panel,\n    host: input.host,\n    arbitration: input.arbitration,\n    inert: false,\n    seq: ++sequence,\n    released: false\n  }\n  layers.add(layer)\n  layerByPanel.set(input.panel, layer)\n  attachToParent(input.panel, input.parent)\n\n  const handle: OpenOverlayHandle = {\n    setInert(inert) {\n      if (layer.released) return\n      layer.inert = inert\n    },\n\n    adopt(panel, options = {}) {\n      if (layer.released) return inactiveHandle\n      return createLayer({\n        panel,\n        host: layer.host,\n        arbitration: options.arbitration ?? 'none',\n        parent: layer.panel\n      })\n    },\n\n    contains(node) {\n      return !layer.released && containsPanel(layer.panel, node)\n    },\n\n    containsEvent(event) {\n      return (\n        !layer.released && event.composedPath().some(node => node instanceof Node && containsPanel(layer.panel, node))\n      )\n    },\n\n    hasFocusWithin() {\n      return !layer.released && hasFocusWithinPanel(layer.panel)\n    },\n\n    release() {\n      releaseLayer(layer)\n    }\n  }\n\n  layerByHandle.set(handle, layer)\n  syncListener()\n  return handle\n}\n\nfunction isCandidate(layer: Layer): boolean {\n  return !layer.released && layer.arbitration !== 'none' && layer.panel.isConnected\n}\n\n/**\n * 在候选里取最内层：子树包含关系下的极大元；互不包含时取后开的。\n *\n * 刻意**不按事件路径筛选**：抽屉打开、内部列表也打开、而焦点停在抽屉上时，事件路径\n * 只命中抽屉，按路径判定会关掉外层、留下内层 —— 正是本模块要修的缺陷。正确语义是\n * 「最内层优先」，与焦点无关。\n */\nfunction resolve(): Layer | null {\n  let best: Layer | null = null\n  for (const layer of layers) {\n    if (!isCandidate(layer)) continue\n    if (!best) {\n      best = layer\n      continue\n    }\n    if (containsPanel(best.panel, layer.panel)) {\n      best = layer\n      continue\n    }\n    if (containsPanel(layer.panel, best.panel)) continue\n    if (layer.seq > best.seq) best = layer\n  }\n  return best\n}\n\nfunction handleKeydown(event: KeyboardEvent): void {\n  if (event.key !== 'Escape') return\n  // 已有更早的捕获监听处理过本次 Escape：不重复介入。\n  if (event.defaultPrevented) return\n\n  const layer = resolve()\n  if (!layer) return\n\n  /*\n   * preventDefault 压掉原生 dialog 的关闭请求；stopPropagation 让组件自身的 handler\n   * 不再执行。惰性层同样被吞掉按键，只是不走关闭入口 —— 否则事件会落到下层浮层，\n   * 关闭顺序与用户预期相反。\n   *\n   * 已知边界：stopPropagation 不阻止**同一节点**（document）上后注册的其他捕获监听。\n   * 刻意不用 stopImmediatePropagation —— 那会连带掐掉应用自己在 document 上的捕获\n   * 监听，超出本模块职责。\n   */\n  event.preventDefault()\n  event.stopPropagation()\n  if (layer.inert) return\n  layer.host.requestClose()\n}\n\nfunction syncListener(): void {\n  let shouldListen = false\n  for (const layer of layers) {\n    if (!layer.released && layer.arbitration !== 'none') {\n      shouldListen = true\n      break\n    }\n  }\n  if (shouldListen === listening) return\n  listening = shouldListen\n  if (shouldListen) document.addEventListener('keydown', handleKeydown, true)\n  else document.removeEventListener('keydown', handleKeydown, true)\n}\n\nexport const defineOpenOverlay = () =>\n  definePlugin<OpenOverlay, OpenOverlayHost>(host => {\n    let generation = 0\n    let suspended = false\n    const frames = new Set<OverlayFrameHandle & { id: number; generation: number }>()\n\n    const cancelFrame = (frame: OverlayFrameHandle & { id: number; generation: number }) => {\n      cancelAnimationFrame(frame.id)\n      frames.delete(frame)\n    }\n\n    const cancelFrames = () => {\n      for (const frame of Array.from(frames)) cancelFrame(frame)\n    }\n\n    const invalidateCurrent = () => {\n      generation += 1\n      cancelFrames()\n    }\n\n    const api: OpenOverlay = {\n      claim(panel, options = {}) {\n        const arbitration = options.arbitration ?? 'escape'\n        const ancestryFrom = options.ancestryFrom ?? panel\n        return createLayer({\n          panel,\n          host,\n          arbitration,\n          parent: findOpenAncestor(panel, ancestryFrom) ?? undefined\n        })\n      },\n\n      scheduleFrame(callback, whileLive) {\n        if (suspended) return { cancel() {} }\n\n        const scheduledGeneration = generation\n        const frame: OverlayFrameHandle & { id: number; generation: number } = {\n          generation: scheduledGeneration,\n          id: requestAnimationFrame(() => {\n            frames.delete(frame)\n            if (suspended || scheduledGeneration !== generation) return\n            // 会话已结束：该帧属于上一轮开合，丢弃而不是执行在错误的层上。\n            // 句柄已 release，或同一 panel 重新 claim 换了新句柄（旧层仍在 WeakMap 里，\n            // 标记为 released），两种情形都要丢。\n            if (whileLive) {\n              const liveLayer = layerByHandle.get(whileLive)\n              if (!liveLayer || liveLayer.released) return\n            }\n            callback()\n          }),\n          cancel() {\n            cancelFrame(frame)\n          }\n        }\n        frames.add(frame)\n        return frame\n      },\n\n      invalidate: invalidateCurrent,\n\n      suspend() {\n        if (suspended) return\n        suspended = true\n        // 停调度之后再撤销在途帧（两者互不依赖，顺序不影响语义）。不能只靠回调内部的\n        // suspended 复查：那会让这些帧白占一个 rAF 周期（旧实现在此处因早退而没有取消）。\n        cancelFrames()\n      },\n\n      resume() {\n        if (!suspended) return\n        suspended = false\n        generation += 1\n      }\n    }\n\n    return api\n  })\n"],"mappings":"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"}
+{"version":3,"file":"open-overlay.js","names":[],"sources":["../../../src/shared/overlay/open-overlay.ts"],"sourcesContent":["/**\n * 开启态浮层（open overlay）——「哪一层正开着」的唯一拥有者。\n *\n * 合并原先三个各自问一遍「你现在开着吗」的模块：composition（逻辑父子树）、\n * escape-dismiss（最内层仲裁）、lifecycle（帧事务失效）。合并的判据不是三者文件相邻，\n * 而是它们共享同一条不变量：**已登记 ⟺ 在场 ⟺ 有仲裁身份**。\n *\n * 拆成三个模块时这条不变量没有主人，8 个浮层组件各自把它拼成三步协议\n * （`registerPanelFromAncestry` + `setPanel` / `unregisterPanel` + `setPanel(null)`）。\n * 结果是「漏撤销」与「重挂载后与仲裁失联」只能靠每个组件自己记得，而\n * `lifecycle` 还得让调用方手工传一个 `expectedOpen` 来复述「我开着吗」。\n *\n * 本模块的取舍：\n *\n * - 身份是**句柄**而非 panel 元素：`release()` 不需要调用方回忆当初传了哪个 panel。\n * - 开启状态是**声明**而非询问：仲裁时不再回调宿主问 `isOpen()`，宿主只提供\n *   `requestClose()` 与一个仅供惰性回收读取的 `isConnected()`；模块持有的真相即真相。\n * - `claim` 即「我开着」：一次 claim 对应一次开启，登记与仲裁是同一个动作。\n * - 在场分两态：开启中（Escape 走关闭入口）与退场中（面板仍可见，暂缓仲裁、只作兜底\n *   候选）。后者由 `deferArbitration()` 进入、随 `release()`、重新 claim 或显式\n *   `deferArbitration(false)` 离开：于是「退场被打断」与「宿主仍认为开着」不再把看得见\n *   的面板留在未登记状态，而退场已播完、宿主却仍认为开着的那一格，也不会让一个看不\n *   见的面板无限吞掉 Escape。\n * - 查询走句柄（`contains` / `containsEvent` / `hasFocusWithin`），调用方不再需要\n *   持有 panel 引用，也不知道存在全局注册表。\n * - 实例作用域与会话作用域分开：帧事务的 lifetime 比一次开合长（tooltip 跨断连\n *   `resume()`），把它压进会话句柄会在 `release()` 时误杀事务。\n *\n * 刻意**不**吸收 presence、滚动锁与 drawer 的层序（nested layers）：它们回答的是\n * 视觉问题（`is-visible`、层序缩放），与「谁是最内层」正交，硬合并会互相污染。\n */\n\nimport { definePlugin } from '@greypan/js-kit'\n\n/**\n * 本层是否参与 Escape 仲裁。\n *\n * - `escape`：正常候选。命中即走宿主既有的用户关闭入口。\n * - `none`：只在逻辑组合树内，完全不参与仲裁，Escape 穿过它落到下层。用于 tooltip\n *   —— 它今天就在树里（经 anchored panel 登记）但从不作为候选。\n *\n * 「暂时不可关闭」不在这里，而由 `setInert` 表达。静态与动态是同一件事的两面：\n * `no-escape-close` 这类策略看似静态，但它是**被观察的属性**，开启期间可被改写，\n * 所以同样要走动态通道（claim 后立即 `setInert(noEscapeClose)`）。把静态策略做成\n * 第三个枚举值只会产生一个没有真实调用方的成员。\n */\nexport type OverlayArbitration = 'escape' | 'none'\n\nexport interface OverlayClaimOptions {\n  /** 默认 `escape`。 */\n  arbitration?: OverlayArbitration\n  /**\n   * 沿该节点的祖先链寻找最近的已开启浮层，作为本层的逻辑父级；缺省用 panel 自身。\n   *\n   * portal 面板与宿主物理分离，从 panel 自身向上走找不到组合父级，必须由调用方给出\n   * 锚点（trigger）或宿主，才能把「谁在谁里面」判对。\n   *\n   * **顺序约束**：祖先链查找要求 panel 与 ancestryFrom 此刻都已就位（在 DOM 中）。\n   * 本模块不做「等一帧再补登记」——那会让「已登记」与「已开启」短暂不等。\n   */\n  ancestryFrom?: Node\n}\n\nexport interface OverlayFrameHandle {\n  cancel(): void\n}\n\n/** 会话作用域：一次开启对应一个句柄。 */\nexport interface OpenOverlayHandle {\n  /**\n   * 惰性：仍是候选（照旧 `preventDefault()` 压掉原生 `<dialog>` 的关闭请求），但不走\n   * 关闭入口。这是「暂时不可关闭」的唯一通道，静态策略与瞬时状态都走这里。\n   *\n   * 不改变本层在树里的位置，也不改变 `seq` —— 因此不会影响并列浮层的裁决顺序。\n   * `none` 层不受影响（它本就不是候选）。\n   *\n   * **与会话同 lifetime，新会话恒从 `false` 开始**：`claim` 建立的每一层都重置为\n   * 非惰性。所以凡是「重新 claim」的路径（`anchored-panel.reconfigure`、同一 panel 重复\n   * `open()`）之后，都必须按当前状态重推一次，否则惰性会被静默清掉。重推放在哪里取决于\n   * 该组件在 reconfigure 后是否渲染：会渲染的（select / autocomplete 在 `updated()` 里\n   * 同步）可以把紧随 claim 的那一行降级为备份，不会渲染的（popover）必须自己补。\n   */\n  setInert(inert: boolean): void\n  /**\n   * 进入退场暂缓态：面板仍在场（可见），本层继续留在登记表里并吞掉 Escape，但不走\n   * 关闭入口。`anchored-panel.close()` 在退场等待前调用它。\n   *\n   * 与 `setInert` 的分工：`inert` 是**调用方**对「暂时不可关闭」的声明，会随渲染被\n   * 重推；本态由**生命周期**进入，调用方没有任何途径清掉它，只有 `release()` 与\n   * 渲染重推它，只有 `release()`、「同一 panel 重新 claim」与下面那个 `false` 能让它\n   * 消失。因此重新 claim 出来的新会话恒不暂缓，退场被打断后由新会话接管仲裁。\n   *\n   * 传 `false` 退出暂态。唯一的使用者是 `anchored-panel.close()`：退场已播完（面板\n   * 已隐藏）而宿主仍认为开着时，把层交还仲裁——此刻面板并不在「可见但暂缓」的前提\n   * 里，继续暂缓会让一个看不见的面板无限吞掉 Escape，用户再也没有按键路径把这个\n   * 不一致的状态收敛掉。\n   *\n   * 暂缓层只是兜底候选：`resolve()` 里仍在开启的层永远优先。否则「内层关掉后立刻\n   * 再按一次 Escape」会被退场动画吞掉，外层永远等不到自己那一次（issue #120）。\n   */\n  deferArbitration(deferred?: boolean): void\n  /**\n   * 把子层 panel 纳入本句柄的子树（多级子菜单），默认不成为独立候选。\n   *\n   * 与 `claim` 的区别只在父级如何确定：`claim` 走祖先链，`adopt` 由调用方指名。\n   *\n   * 在已 `release()` 的句柄上调用**不建层**、返回空操作句柄 —— 否则会建出一个父层已死\n   * 的孤层：它仍参与仲裁，却不在父层的子树里，除调用方手里那个句柄外没有回收路径。\n   */\n  adopt(panel: HTMLElement, options?: OverlayClaimOptions): OpenOverlayHandle\n  /** 本层子树（含已 adopt 的子层）是否包含 node。 */\n  contains(node: Node): boolean\n  /** event 的完整 composed path 是否落入本层子树。 */\n  containsEvent(event: Event): boolean\n  /** 焦点是否在本层子树内。 */\n  hasFocusWithin(): boolean\n  /** 幂等。撤销本层及其全部子层，退出仲裁。 */\n  release(): void\n}\n\n/** 实例作用域：每个宿主组件一次，跨开合与断连存活。 */\nexport interface OpenOverlay {\n  claim(panel: HTMLElement, options?: OverlayClaimOptions): OpenOverlayHandle\n  /**\n   * 帧事务调度。`whileLive` 句柄一旦 release，回调自动作废 —— 取代原先由调用方\n   * 手工传入 `expectedOpen` 的轮询（那个参数正是「模块还得回头问宿主」的证据）。\n   */\n  scheduleFrame(callback: () => void, whileLive?: OpenOverlayHandle): OverlayFrameHandle\n  /** 结束当前事务：取消未执行的 frame，并让旧 generation 的回调失效。 */\n  invalidate(): void\n  /** 断连后停止调度（可 `resume()`）；generation 继续单调递增，旧事务保持失效。 */\n  suspend(): void\n  resume(): void\n}\n\nexport interface OpenOverlayHost {\n  /** 走宿主既有的用户关闭入口（内部负责 controlled 语义与 `open-change` 派发）。 */\n  requestClose(): void\n  /**\n   * 宿主元素是否仍在文档中。只被惰性回收读取（见 `layers` 注册表处的注释），\n   * 仲裁路径不回调它——读 DOM 连接状态不是回调宿主问「我开着吗」。\n   */\n  isConnected(): boolean\n}\n\ninterface Layer {\n  panel: HTMLElement\n  host: OpenOverlayHost\n  arbitration: OverlayArbitration\n  /** 动态惰性开关，与会话同 lifetime。 */\n  inert: boolean\n  /** 退场暂缓开关：面板仍在场，但只作兜底候选（见 `deferArbitration`）。 */\n  deferred: boolean\n  /** 登记序号：互不包含的并列浮层里，后开的更靠上。 */\n  seq: number\n  released: boolean\n}\n\n/*\n * 模块级注册表：单例 document 监听器需要一个全局视野，这正是「谁是最内层」不能被\n * 拆到各组件里的原因。\n *\n * `Layer` 强引用 panel 与 host，所以一条没被删掉的记录会让整个组件（含子树）无法回收。\n * 删除路径有两条：显式 `release()`，以及 `reclaimDisconnectedLayers()` 的惰性兜底\n * ——「宿主还在但组件被丢弃」这类漏 release 的路径，光靠 `isCandidate()` 筛掉不可达\n * 候选只会留下永久泄漏，还会让 `shouldListen` 恒为 true 把 document 监听留住。\n * 兜底判据取 panel 与 host **同时**失联：面板可能被 portal 在容器间搬运，也可能只是\n * 短暂移除再放回（层对象比 DOM 连接活得久），只有两者都不在文档里才判定为死层。\n * 回收**不扫刚 claim 的新层**：调用方完全可能先 claim 再把 panel 与宿主挂进文档，\n * 那一刻两者都还没连上。所以 claim 路径的回收跑在建层之前（`createLayer` 开头），\n * 新层入表之后只做监听对账。\n * 读 DOM 连接状态不是回调宿主问「我开着吗」，不违反声明式的取舍。\n */\nconst layers = new Set<Layer>()\nconst layerByPanel = new WeakMap<HTMLElement, Layer>()\nconst layerByHandle = new WeakMap<OpenOverlayHandle, Layer>()\nconst parents = new WeakMap<HTMLElement, HTMLElement>()\nconst childPanels = new WeakMap<HTMLElement, Set<HTMLElement>>()\nlet listening = false\nlet sequence = 0\n\n/*\n * dev 期测试钩子：登记表尺寸。\n *\n * 「漏 release」是结构性风险，而 `layers` 的尺寸无法从公开 interface 观察——调用方\n * 只持有句柄，看不到全局注册表，测试于是只能靠 GC 语义推断。有了它，泄漏在测试里\n * 是一个可直接断言的数字。`import.meta.env.DEV` 是编译期常量，生产构建里整段消失。\n */\ndeclare global {\n  // eslint-disable-next-line no-var\n  var __openOverlayLayerCount: () => number\n}\n\nif (import.meta.env.DEV) {\n  globalThis.__openOverlayLayerCount = () => layers.size\n}\n\n/*\n * 已失效句柄的空操作替身，用于 `adopt` 在 released 句柄上的返回值。其余句柄方法在\n * released 时都静默降级，返回值也必须一起降级，否则调用方会以为自己拿到了一棵可用子树。\n */\nconst inactiveHandle: OpenOverlayHandle = {\n  deferArbitration() {},\n  setInert() {},\n  adopt: () => inactiveHandle,\n  contains: () => false,\n  containsEvent: () => false,\n  hasFocusWithin: () => false,\n  release() {}\n}\n\nfunction nextCompositionNode(node: Node): Node | null {\n  if (node instanceof Element && node.assignedSlot) return node.assignedSlot\n  if (node.parentNode) return node.parentNode\n  if (node instanceof ShadowRoot) return node.host\n  return null\n}\n\nfunction nodeIsInside(root: HTMLElement, node: Node): boolean {\n  let current: Node | null = node\n  while (current) {\n    if (current === root || root.contains(current)) return true\n    current = nextCompositionNode(current)\n  }\n  return false\n}\n\nfunction detachFromParent(panel: HTMLElement): void {\n  const parent = parents.get(panel)\n  if (!parent) return\n  const siblings = childPanels.get(parent)\n  siblings?.delete(panel)\n  if (siblings?.size === 0) childPanels.delete(parent)\n  parents.delete(panel)\n}\n\nfunction attachToParent(panel: HTMLElement, parent: HTMLElement | undefined): void {\n  detachFromParent(panel)\n  if (!parent || parent === panel) return\n  const siblings = childPanels.get(parent) ?? new Set<HTMLElement>()\n  siblings.add(panel)\n  childPanels.set(parent, siblings)\n  parents.set(panel, parent)\n}\n\n/** panel 自身或其任何已登记子层是否包含 target。 */\nfunction containsPanel(panel: HTMLElement, target: Node): boolean {\n  if (nodeIsInside(panel, target)) return true\n  for (const child of childPanels.get(panel) ?? []) {\n    if (containsPanel(child, target)) return true\n  }\n  return false\n}\n\nfunction hasFocusWithinPanel(panel: HTMLElement): boolean {\n  if (panel.matches(':focus-within')) return true\n  for (const child of childPanels.get(panel) ?? []) {\n    if (hasFocusWithinPanel(child)) return true\n  }\n  return false\n}\n\n/** 从 from 沿祖先链找最近的已开启浮层 panel；panel 自身永远不算自己的父级。 */\nfunction findOpenAncestor(panel: HTMLElement, from: Node): HTMLElement | null {\n  let current: Node | null = from === panel ? nextCompositionNode(from) : from\n  while (current) {\n    if (current instanceof HTMLElement && current !== panel) {\n      const candidate = layerByPanel.get(current)\n      if (candidate && !candidate.released) return current\n    }\n    current = nextCompositionNode(current)\n  }\n  return null\n}\n\nfunction releaseLayer(layer: Layer): void {\n  if (layer.released) return\n  layer.released = true\n  for (const child of Array.from(childPanels.get(layer.panel) ?? [])) {\n    const childLayer = layerByPanel.get(child)\n    if (childLayer) releaseLayer(childLayer)\n    else detachFromParent(child)\n  }\n  layers.delete(layer)\n  layerByPanel.delete(layer.panel)\n  childPanels.delete(layer.panel)\n  detachFromParent(layer.panel)\n  // 不在这里 syncListener：本函数被子层递归与兜底回收复用，监听器对账由调用方在\n  // 整棵子树摘完后做一次即可。\n}\n\nfunction createLayer(input: {\n  panel: HTMLElement\n  host: OpenOverlayHost\n  arbitration: OverlayArbitration\n  parent?: HTMLElement\n}): OpenOverlayHandle {\n  /*\n   * 先摘死层，再建新层。claim/adopt 是完全合法的「先开启后挂载」时序——调用方那一刻\n   * 可能还没把 panel 与宿主挂进文档，两者都失联。回收跑在新层入表**之前**，新层就不\n   * 会被自己的 claim 判成死层；而漏 release 留下的死层依旧在这里被扫掉，与旧实现一致。\n   */\n  reclaimDisconnectedLayers()\n\n  const previous = layerByPanel.get(input.panel)\n  // 同一 panel 重新 claim = 新的一次开启：旧会话（含其子层）整体作废，seq 重新分配。\n  if (previous) releaseLayer(previous)\n\n  const layer: Layer = {\n    panel: input.panel,\n    host: input.host,\n    arbitration: input.arbitration,\n    inert: false,\n    deferred: false,\n    seq: ++sequence,\n    released: false\n  }\n  layers.add(layer)\n  layerByPanel.set(input.panel, layer)\n  attachToParent(input.panel, input.parent)\n\n  const handle: OpenOverlayHandle = {\n    deferArbitration(deferred = true) {\n      if (layer.released) return\n      layer.deferred = deferred\n    },\n\n    setInert(inert) {\n      if (layer.released) return\n      layer.inert = inert\n    },\n\n    adopt(panel, options = {}) {\n      if (layer.released) return inactiveHandle\n      return createLayer({\n        panel,\n        host: layer.host,\n        arbitration: options.arbitration ?? 'none',\n        parent: layer.panel\n      })\n    },\n\n    contains(node) {\n      return !layer.released && containsPanel(layer.panel, node)\n    },\n\n    containsEvent(event) {\n      return (\n        !layer.released && event.composedPath().some(node => node instanceof Node && containsPanel(layer.panel, node))\n      )\n    },\n\n    hasFocusWithin() {\n      return !layer.released && hasFocusWithinPanel(layer.panel)\n    },\n\n    release() {\n      releaseLayer(layer)\n      syncListener()\n    }\n  }\n\n  layerByHandle.set(handle, layer)\n  // 不带回收：新层面板与宿主可能还没挂载，回收已在函数开头跑过（见 `reclaim` 参数）。\n  syncListener(false)\n  return handle\n}\n\nfunction isCandidate(layer: Layer): boolean {\n  return !layer.released && layer.arbitration !== 'none' && layer.panel.isConnected\n}\n\n/** 在候选里取最内层：子树包含关系下的极大元；互不包含时取后开的。 */\nfunction pickInnermost(candidates: Layer[]): Layer | null {\n  let best: Layer | null = null\n  for (const layer of candidates) {\n    if (!best) {\n      best = layer\n      continue\n    }\n    if (containsPanel(best.panel, layer.panel)) {\n      best = layer\n      continue\n    }\n    if (containsPanel(layer.panel, best.panel)) continue\n    if (layer.seq > best.seq) best = layer\n  }\n  return best\n}\n\nfunction resolve(): Layer | null {\n  // 兜底回收：每次仲裁先摘掉死层，漏 release 的组件不会把注册表和监听一起拖住。\n  syncListener()\n\n  const live: Layer[] = []\n  const deferred: Layer[] = []\n  for (const layer of layers) {\n    if (!isCandidate(layer)) continue\n    if (layer.deferred) deferred.push(layer)\n    else live.push(layer)\n  }\n\n  /*\n   * 暂缓层只是兜底候选：仍在开启的层永远优先。\n   *\n   * 反过来（暂缓层也按最内层取胜）会让「内层关掉后立刻再按一次 Escape」被退场动画吞掉\n   * ——它已不再开启却仍占着名额，外层永远等不到自己那一次，正是 issue #120 的契约\n   * （escape-ownership.browser.spec.ts 压住它）。第三态要补的缺口是另一件事：退场被\n   * 打断、新会话 claim 之前，面板还在场上却不再登记，此刻按 Escape 会关到外层。\n   *\n   * 与 `pickInnermost` 同样刻意**不按事件路径筛选**：抽屉打开、内部列表也打开、而焦点\n   * 停在抽屉上时，事件路径只命中抽屉，按路径判定会关掉外层、留下内层。正确语义是\n   * 「最内层优先」，与焦点无关。\n   */\n  return pickInnermost(live) ?? pickInnermost(deferred)\n}\n\nfunction handleKeydown(event: KeyboardEvent): void {\n  if (event.key !== 'Escape') return\n  // 已有更早的捕获监听处理过本次 Escape：不重复介入。\n  if (event.defaultPrevented) return\n\n  const layer = resolve()\n  if (!layer) return\n\n  /*\n   * preventDefault 压掉原生 dialog 的关闭请求；stopPropagation 让组件自身的 handler\n   * 不再执行。惰性层与暂缓层同样被吞掉按键，只是不走关闭入口 —— 否则事件会落到下层\n   * 浮层，关闭顺序与用户预期相反。\n   *\n   * 已知边界：stopPropagation 不阻止**同一节点**（document）上后注册的其他捕获监听。\n   * 刻意不用 stopImmediatePropagation —— 那会连带掐掉应用自己在 document 上的捕获\n   * 监听，超出本模块职责。\n   */\n  event.preventDefault()\n  event.stopPropagation()\n  // 惰性与暂缓都吞掉按键，只是不走关闭入口。\n  if (layer.inert || layer.deferred) return\n  layer.host.requestClose()\n}\n\n/**\n * panel 与 host 同时失联的层是死层：显式 release 之外的兜底删除路径。\n *\n * 惰性体现在只在遍历登记表的入口跑（建层之前、仲裁、release），不挂 DOM 变动回调 ——\n * 面板短暂移除再放回必须不丢登记。建层**之后**不跑：新层可能还没挂载，扫它就会误杀\n * （见 `createLayer` 开头与 `layers` 注册表处的注释）。\n */\nfunction reclaimDisconnectedLayers(): void {\n  for (const layer of Array.from(layers)) {\n    if (layer.released || layer.panel.isConnected || layer.host.isConnected()) continue\n    releaseLayer(layer)\n  }\n}\n\n/**\n * 监听器对账：惰性回收死层，再按登记表重算 document 监听。\n *\n * `reclaim` 关掉回收，只给 `createLayer` 建层之后那一次调用用：新层刚入注册表，调用方\n * 可能还没把 panel 与宿主挂进文档，那一刻扫它等于把新层判成死层。死层不会因此漏掉——\n * 回收在建层之前已经单独跑过一轮（见 `createLayer` 开头）。\n */\nfunction syncListener(reclaim = true): void {\n  if (reclaim) reclaimDisconnectedLayers()\n\n  let shouldListen = false\n  for (const layer of layers) {\n    /*\n     * 未 release 的非 `none` 层就是监听理由，**不附加连接判据**：刚 claim 而尚未挂载的\n     * 层要靠这条把监听开着——面板挂上之后没有任何入口（不挂 DOM 变动回调）把它加回来，\n     * 监听一撤这一层就再也听不见 Escape。死层的截杀交给上面的回收：它在每个带回收的\n     * 入口先跑一步，轮到这里时同时失联的层已经不在表里，这条判据因此不会把死层留下来。\n     */\n    if (!layer.released && layer.arbitration !== 'none') {\n      shouldListen = true\n      break\n    }\n  }\n  if (shouldListen === listening) return\n  listening = shouldListen\n  if (shouldListen) document.addEventListener('keydown', handleKeydown, true)\n  else document.removeEventListener('keydown', handleKeydown, true)\n}\n\nexport const defineOpenOverlay = () =>\n  definePlugin<OpenOverlay, OpenOverlayHost>(host => {\n    let generation = 0\n    let suspended = false\n    const frames = new Set<OverlayFrameHandle & { id: number; generation: number }>()\n\n    const cancelFrame = (frame: OverlayFrameHandle & { id: number; generation: number }) => {\n      cancelAnimationFrame(frame.id)\n      frames.delete(frame)\n    }\n\n    const cancelFrames = () => {\n      for (const frame of Array.from(frames)) cancelFrame(frame)\n    }\n\n    const invalidateCurrent = () => {\n      generation += 1\n      cancelFrames()\n    }\n\n    const api: OpenOverlay = {\n      claim(panel, options = {}) {\n        const arbitration = options.arbitration ?? 'escape'\n        const ancestryFrom = options.ancestryFrom ?? panel\n        return createLayer({\n          panel,\n          host,\n          arbitration,\n          parent: findOpenAncestor(panel, ancestryFrom) ?? undefined\n        })\n      },\n\n      scheduleFrame(callback, whileLive) {\n        if (suspended) return { cancel() {} }\n\n        const scheduledGeneration = generation\n        const frame: OverlayFrameHandle & { id: number; generation: number } = {\n          generation: scheduledGeneration,\n          id: requestAnimationFrame(() => {\n            frames.delete(frame)\n            if (suspended || scheduledGeneration !== generation) return\n            // 会话已结束：该帧属于上一轮开合，丢弃而不是执行在错误的层上。\n            // 句柄已 release，或同一 panel 重新 claim 换了新句柄（旧层仍在 WeakMap 里，\n            // 标记为 released），两种情形都要丢。\n            if (whileLive) {\n              const liveLayer = layerByHandle.get(whileLive)\n              if (!liveLayer || liveLayer.released) return\n            }\n            callback()\n          }),\n          cancel() {\n            cancelFrame(frame)\n          }\n        }\n        frames.add(frame)\n        return frame\n      },\n\n      invalidate: invalidateCurrent,\n\n      suspend() {\n        if (suspended) return\n        suspended = true\n        // 停调度之后再撤销在途帧（两者互不依赖，顺序不影响语义）。不能只靠回调内部的\n        // suspended 复查：那会让这些帧白占一个 rAF 周期（旧实现在此处因早退而没有取消）。\n        cancelFrames()\n      },\n\n      resume() {\n        if (!suspended) return\n        suspended = false\n        generation += 1\n      }\n    }\n\n    return api\n  })\n"],"mappings":"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"}

package/dist/shared/theme/root-sync.js

@@ -0,0 +1,48 @@
+//#region src/shared/theme/root-sync.ts
+var e = "--wui-color-page", t = /* @__PURE__ */ new Set(), n, r = /* @__PURE__ */ new Set();
+function i(e) {
+	return t.values().next().value === e;
+}
+function a(t) {
+	return getComputedStyle(t).getPropertyValue(e).trim();
+}
+function o() {
+	let n = t.values().next().value;
+	if (!n || !n.isConnected) return;
+	let r = a(n);
+	if (!r) return;
+	let i = document.documentElement.style;
+	i.getPropertyValue(e) !== r && i.setProperty(e, r);
+}
+function s() {
+	o();
+	for (let e of r) e();
+}
+function c() {
+	if (t.size > 0 || r.size > 0) {
+		if (n) return;
+		try {
+			n = window.matchMedia("(prefers-color-scheme: dark)");
+		} catch {
+			return;
+		}
+		n.addEventListener("change", s);
+		return;
+	}
+	n &&= (n.removeEventListener("change", s), void 0);
+}
+function l(e) {
+	return r.add(e), c(), () => {
+		r.delete(e) && c();
+	};
+}
+function u(e) {
+	t.add(e), c(), i(e) && o();
+}
+function d(e) {
+	t.delete(e) && (c(), o());
+}
+//#endregion
+export { u as registerThemeRootSync, l as subscribeThemeSystemAppearanceChange, d as unregisterThemeRootSync };
+
+//# sourceMappingURL=root-sync.js.map

package/dist/shared/theme/root-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-sync.js","names":[],"sources":["../../../src/shared/theme/root-sync.ts"],"sourcesContent":["/**\n * 根节点 page 色同步 —— 「哪一层最外层」的唯一拥有者。\n *\n * macOS 橡皮筋回弹露白的成因不在 body 而在画布：body 的背景只覆盖滚动范围，回弹时被扯出来的\n * 那一圈用的是 documentElement 的画布背景。而 `--wui-color-page` 定义在 `<web-ui-theme>` 的\n * shadow 作用域里，自定义属性的继承链到 documentElement 就断了，所以消费方写\n * `body { background: var(--wui-color-page) }` 也管不到回弹区。\n *\n * 本模块补上这一环：最外层 active theme 把自己计算出的 `--wui-color-page` 写到 documentElement\n * 的行内自定义属性上，消费方仍然只需要那一行 body 规则。\n *\n * 为什么按 connect 顺序取「第一个 active 实例」，而不是去判「DOM 上最外层的那一个」：\n * 组件无法可靠地回答后者——portal、shadow host 与 slot 都会让「谁包着谁」的物理关系和主题\n * 作用域不一致（`WebUiTheme._findThemeAncestor()` 正是为此单独实现了跨 shadow 边界的祖先链）。\n * root 值只可能有一个来源，按 connect 顺序取第一个是唯一不需要猜树形状的判据，且与用户视角\n * 一致：嵌套主题总是后 connect，先进页面那个主题范围就是盖住整页的那个。\n *\n * 其余取舍：\n *\n * - 同步权在已登记实例之间按同一顺序顺延：最外层断开时下一个已连接实例接管，不查 DOM。\n *   重新挂载的实例按新的一次 connect 排到队尾——队首才是当前 outermost。\n * - 写入值取该实例的**计算值**，因此消费者在 host 上覆盖 `--wui-color-page`（包括在自己的\n *   媒体查询里覆盖）会被原样镜像，主题与消费者的优先级关系不因此改变。\n * - 全部断开时**保留最后值**：清掉属性会让 body 背景在主题卸载/重挂的间隙闪回 UA 白底，\n *   而那正是本能力要消除的观感。代价是最后一个主题卸载后 documentElement 上仍留着一个自定义\n *   属性；消费者自己写 body 背景时它不产生任何影响。\n * - `appearance=\"system\"` 的 token 计算值仍由组件内部 CSS 的 `prefers-color-scheme` 决定；\n *   root 同步与 `resolved-appearance` 输出共用同一个 MediaQueryList 监听，翻转时一次重算。\n * - 登记表强引用实例，但删除路径只有组件自己的 disconnectedCallback：自定义元素反应保证移除\n *   必然触发它，不存在 open-overlay 那种「面板被 portal 搬运」需要惰性兜底回收的形状。\n */\n\nconst ROOT_PAGE_TOKEN = '--wui-color-page'\n\n/** 按 connect 顺序排列的已登记 active 实例；队首持有 root 同步权。 */\nconst registered = new Set<HTMLElement>()\n\nlet schemeQuery: MediaQueryList | undefined\nconst schemeSubscribers = new Set<() => void>()\n\n/*\n * dev 期测试钩子：登记表尺寸。\n *\n * 「组件卸载后忘了撤销登记」是这层唯一的结构性风险，而 `registered` 无法从公开面观察——\n * 调用方只看见 documentElement 上的值，看不到注册表。有了它，泄漏在测试里是一个可直接断言的\n * 数字。`import.meta.env.DEV` 是编译期常量，生产构建里整段消失。\n */\ndeclare global {\n  // eslint-disable-next-line no-var\n  var __webUiThemeRootSyncCount: () => number\n}\n\nif (import.meta.env.DEV) {\n  globalThis.__webUiThemeRootSyncCount = () => registered.size\n}\n\nfunction isRootSyncOwner(host: HTMLElement): boolean {\n  return registered.values().next().value === host\n}\n\n/** 计算值可能为空（jsdom、未激活作用域、已断开），空值不写入也不删除既有值。 */\nfunction readPageColor(host: HTMLElement): string {\n  return getComputedStyle(host).getPropertyValue(ROOT_PAGE_TOKEN).trim()\n}\n\nfunction syncRootPageColor(): void {\n  const owner = registered.values().next().value as HTMLElement | undefined\n  if (!owner) return\n  // 已断开的所有者不能再写 root：整棵子树一起卸载时，队首顺延到的实例已经不在文档里\n  // （浏览器对 detached 元素取不到计算值，jsdom 却仍按选择器匹配返回旧值），\n  // 不设这道坎就会在两种环境里得到不同的 root 末值。\n  if (!owner.isConnected) return\n  const value = readPageColor(owner)\n  if (!value) return\n  const style = document.documentElement.style\n  // 与当前行内值比较而不是与模块记忆的上次写入比较：消费者中途覆写时，下一次同步仍然夺回\n  // 归属权，而值没变时不做无谓的样式写入。\n  if (style.getPropertyValue(ROOT_PAGE_TOKEN) === value) return\n  style.setProperty(ROOT_PAGE_TOKEN, value)\n}\n\nfunction handleSchemeChange(): void {\n  syncRootPageColor()\n  for (const subscriber of schemeSubscribers) subscriber()\n}\n\nfunction syncSchemeListener(): void {\n  if (registered.size > 0 || schemeSubscribers.size > 0) {\n    if (schemeQuery) return\n    try {\n      schemeQuery = window.matchMedia('(prefers-color-scheme: dark)')\n    } catch {\n      // jsdom 等没有 matchMedia 的环境：system 档跟随不到系统翻转，登记与输出仍保持当前值。\n      return\n    }\n    schemeQuery.addEventListener('change', handleSchemeChange)\n    return\n  }\n  if (!schemeQuery) return\n  schemeQuery.removeEventListener('change', handleSchemeChange)\n  schemeQuery = undefined\n}\n\n/*\n * 复用 root 同步已经持有的系统 scheme 监听：resolved-appearance 只登记回调，不另建 MediaQueryList。\n * 登记先于订阅或订阅先于登记都可以；syncSchemeListener 以两者任一非空为准。\n */\nexport function subscribeThemeSystemAppearanceChange(listener: () => void): () => void {\n  schemeSubscribers.add(listener)\n  syncSchemeListener()\n  return () => {\n    if (!schemeSubscribers.delete(listener)) return\n    syncSchemeListener()\n  }\n}\n\n/**\n * 登记一个 active theme。幂等，组件的 connectedCallback 与 updated() 可以无条件调用：\n * 已在表中的实例重复登记保留原队序，只有队首实例会刷新 root 值。\n */\nexport function registerThemeRootSync(host: HTMLElement): void {\n  registered.add(host)\n  syncSchemeListener()\n  // 嵌套实例的变更按契约不影响 root 值；顺延不到新实例时 root 值同样不变。\n  if (!isRootSyncOwner(host)) return\n  syncRootPageColor()\n}\n\n/** 撤销登记。移交同步权时由新的队首实例立即接管 root 值。 */\nexport function unregisterThemeRootSync(host: HTMLElement): void {\n  if (!registered.delete(host)) return\n  syncSchemeListener()\n  syncRootPageColor()\n}\n"],"mappings":";AAgCA,IAAM,IAAkB,oBAGlB,oBAAa,IAAI,IAAiB,GAEpC,GACE,oBAAoB,IAAI,IAAgB;AAkB9C,SAAS,EAAgB,GAA4B;CACnD,OAAO,EAAW,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU;AAC9C;AAGA,SAAS,EAAc,GAA2B;CAChD,OAAO,iBAAiB,CAAI,CAAC,CAAC,iBAAiB,CAAe,CAAC,CAAC,KAAK;AACvE;AAEA,SAAS,IAA0B;CACjC,IAAM,IAAQ,EAAW,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC;CAKzC,IAJI,CAAC,KAID,CAAC,EAAM,aAAa;CACxB,IAAM,IAAQ,EAAc,CAAK;CACjC,IAAI,CAAC,GAAO;CACZ,IAAM,IAAQ,SAAS,gBAAgB;CAGnC,EAAM,iBAAiB,CAAe,MAAM,KAChD,EAAM,YAAY,GAAiB,CAAK;AAC1C;AAEA,SAAS,IAA2B;CAClC,EAAkB;CAClB,KAAK,IAAM,KAAc,GAAmB,EAAW;AACzD;AAEA,SAAS,IAA2B;CAClC,IAAI,EAAW,OAAO,KAAK,EAAkB,OAAO,GAAG;EACrD,IAAI,GAAa;EACjB,IAAI;GACF,IAAc,OAAO,WAAW,8BAA8B;EAChE,QAAQ;GAEN;EACF;EACA,EAAY,iBAAiB,UAAU,CAAkB;EACzD;CACF;CACK,AAEL,OADA,EAAY,oBAAoB,UAAU,CAAkB,GAC9C,KAAA;AAChB;AAMA,SAAgB,EAAqC,GAAkC;CAGrF,OAFA,EAAkB,IAAI,CAAQ,GAC9B,EAAmB,SACN;EACN,EAAkB,OAAO,CAAQ,KACtC,EAAmB;CACrB;AACF;AAMA,SAAgB,EAAsB,GAAyB;CAC7D,EAAW,IAAI,CAAI,GACnB,EAAmB,GAEd,EAAgB,CAAI,KACzB,EAAkB;AACpB;AAGA,SAAgB,EAAwB,GAAyB;CAC1D,EAAW,OAAO,CAAI,MAC3B,EAAmB,GACnB,EAAkB;AACpB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@greypan/web-ui",
-  "version": "7.0.0",
+  "version": "8.1.0",
   "description": "Lit-based web components for React, Vue, and vanilla JS",
   "license": "MIT",
   "repository": {
@@ -43,6 +43,8 @@
   },
   "devDependencies": {
     "@greypan/tsconfig": "1.0.5",
+    "@iconify-json/akar-icons": "^1.2.7",
+    "@iconify-json/bi": "^1.2.7",
     "@iconify-json/jam": "^1.2.3",
     "@iconify-json/lucide": "^1.2.126",
     "@iconify-json/si": "^1.2.17",