@greypan/web-ui 6.0.0 → 6.2.0

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/shared/option-portal/index.ts"],"sourcesContent":["import { definePlugin } from '@greypan/js-kit'\n\nimport type { WebUiOption } from '@/components/option'\nimport type { OverlayPortal } from '@/shared/overlay/portal'\n\n/**\n * select / autocomplete 共用的 portal option 域：宿主侧 option 注册表、\n * portal 内容同步（打开期迁移 + 真删除清理）与微任务调度。\n *\n * 交互语义与 Lit 响应式由各组件保留（同 anchored-panel 的边界约定）：\n * 组件通过 host 回调注入差异点（迁移节点来源、打开期即时同步等），\n * 并持有 _options/_activeIndex 的 @state，shared 只经返回值同步数据。\n */\n\nexport interface OptionPortalHost {\n  /** 承载宿主级监听的元素（select / autocomplete 宿主自身）。 */\n  readonly element: HTMLElement\n  /** option id 前缀；宿主应保证跨实例唯一（如含实例序号），供 aria 引用与样式定位。 */\n  readonly idPrefix: string\n  getPortal(): OverlayPortal | undefined\n  getPortalContent(): HTMLElement | undefined\n  /** 打开判定：syncPortalContent 仅在打开期执行内容迁移。 */\n  isOpen(): boolean\n  /**\n   * 打开期待迁移的节点来源。两组件粒度不同（select 迁裸 option，\n   * autocomplete 迁全部 childNodes），保持各自现状不在此统一。\n   */\n  getMigratableNodes(): Node[]\n  /** 微任务回调中判断宿主是否已完成首次渲染（Lit hasUpdated）。 */\n  hasUpdated(): boolean\n  /** 微任务末的宿主刷新（requestUpdate）。 */\n  requestUpdate(): void\n  /**\n   * 打开期即时同步钩子。select 在微任务内立即刷新标签与激活态\n   * （portal 打开时 willUpdate 查不到面板外的新增项），autocomplete 无此需要。\n   */\n  onImmediateSync?(): void\n  /**\n   * 组件侧的逐元素交互监听（click/pointerover/pointerdown/option-update）。\n   * shared 负责随 refresh 配对调用，语义由组件定义。\n   */\n  bindOption(option: WebUiOption): void\n  unbindOption(option: WebUiOption): void\n}\n\nexport interface OptionPortalApi {\n  /** 面板优先查询，面板无 option 或关闭时回退 light DOM。 */\n  queryOptions(): WebUiOption[]\n  /**\n   * diff 出旧集合解绑、新集合绑定；按 option 身份保持激活索引。\n   * 返回新注册表数组与新的激活索引（-1 表示激活项已失效，如移除/迁移）。\n   */\n  refresh(\n    previous: readonly WebUiOption[],\n    activeOption: WebUiOption | undefined\n  ): {\n    options: WebUiOption[]\n    activeIndex: number\n  }\n  /** 稳定 id 分配（WeakMap 身份 + 冲突循环），跨 remove/reorder 保持不变。 */\n  ensureOptionIds(options: readonly WebUiOption[]): void\n  /** pending 真删除清理 + 打开期把滞留 light DOM 的节点迁入面板。 */\n  syncPortalContent(): void\n  /** register/unregister/contentChange 的统一微任务收敛入口（slot 监听由组件模板持有）。 */\n  scheduleRefresh(): void\n  /** 宿主级与逐元素 unregister 监听共用的处理器。 */\n  handleOptionUnregister(event: Event): void\n  /** 宿主级监听配对（connectedCallback 调用，与 dispose 配对）。 */\n  bindHost(): void\n  /** 断连清理：解绑宿主监听并清空 pending 集合。 */\n  dispose(): void\n}\n\nconst OPTION_TAG = 'web-ui-option'\n\nexport const defineOptionPortal = () =>\n  definePlugin<OptionPortalApi, OptionPortalHost>(host => {\n    const pendingUnregistered = new Set<WebUiOption>()\n    // 稳定 id：WeakMap 按 option 身份记忆分配结果，remove/reorder 后 id 不变；\n    // aria-activedescendant / 外部样式都依赖 id 的时序稳定性。\n    const optionIds = new WeakMap<WebUiOption, string>()\n    let nextOptionId = 0\n\n    const bindOption = (option: WebUiOption) => {\n      host.bindOption(option)\n      option.addEventListener('option-unregister', handleOptionUnregister)\n    }\n\n    const unbindOption = (option: WebUiOption) => {\n      host.unbindOption(option)\n      option.removeEventListener('option-unregister', handleOptionUnregister)\n    }\n\n    const handleOptionUnregister = (event: Event) => {\n      // Portal 迁移与真实删除都会触发 unregister；先记录候选，\n      // 微任务末 syncPortalContent 按最终位置区分二者。\n      if (event.target instanceof HTMLElement && event.target.localName === OPTION_TAG) {\n        pendingUnregistered.add(event.target as WebUiOption)\n      }\n      api.scheduleRefresh()\n    }\n\n    const handleRegister = () => {\n      api.scheduleRefresh()\n    }\n\n    const api: OptionPortalApi = {\n      queryOptions() {\n        const panel = host.getPortal()?.panel ?? host.getPortalContent()\n        const panelOptions = panel ? [...panel.querySelectorAll<WebUiOption>(OPTION_TAG)] : []\n        // 面板内容仅在浮层打开、moveContent 之后存在；关闭时回退 light DOM，\n        // 否则 portal 组件首次加载时注册表为空。\n        return panelOptions.length > 0 ? panelOptions : [...host.element.querySelectorAll<WebUiOption>(OPTION_TAG)]\n      },\n\n      refresh(previous, activeOption) {\n        const nextOptions = api.queryOptions()\n\n        // register/unregister 是 composed 事件：Portal 迁移时 target 会 retarget 成宿主，\n        // 不能作为监听器绑定依据；绑定只发生在按 DOM 查询确认身份的 option 上。\n        for (const option of previous) if (!nextOptions.includes(option)) unbindOption(option)\n        nextOptions.forEach(bindOption)\n\n        // 激活索引按 option 身份保持，避免移除中间项后静默偏移到相邻项\n        return {\n          options: nextOptions,\n          activeIndex: activeOption && nextOptions.includes(activeOption) ? nextOptions.indexOf(activeOption) : -1\n        }\n      },\n\n      ensureOptionIds(registryOptions) {\n        const usedIds = new Set(registryOptions.map(option => option.id).filter((id): id is string => Boolean(id)))\n        registryOptions.forEach(option => {\n          if (option.id) return\n\n          let id = optionIds.get(option)\n          if (!id || usedIds.has(id)) {\n            do {\n              id = `${host.idPrefix}-option-${++nextOptionId}`\n            } while (usedIds.has(id))\n            optionIds.set(option, id)\n          }\n          option.id = id\n          usedIds.add(id)\n        })\n      },\n\n      syncPortalContent() {\n        const portal = host.getPortal()\n        const portalContent = host.getPortalContent()\n        if (!portal || !portalContent) return\n\n        // 真删除（既不在面板也不在 light DOM）的 option 从 portal 追踪列表摘除，\n        // 否则关闭时 restoreContent 会把它复活回 light DOM。\n        for (const option of pendingUnregistered) {\n          if (!portalContent.contains(option) && !host.element.contains(option)) portal.removeContent([option])\n        }\n        pendingUnregistered.clear()\n\n        if (!host.isOpen()) return\n\n        // Portal 打开期间框架条件渲染（v-if）可能在 light DOM 插入新节点；\n        // 面板内已有内容时 queryOptions 不会回退 light DOM，必须显式迁入面板。\n        // 注释（框架锚点与 portal 的 marker）不迁移：锚点留守宿主是实时渲染契约。\n        const nodes = host.getMigratableNodes().filter(node => !(node instanceof Comment))\n        if (nodes.length) portal.appendContent(nodes, portalContent)\n      },\n\n      scheduleRefresh() {\n        queueMicrotask(() => {\n          if (!host.element.isConnected) return\n          api.syncPortalContent()\n          host.requestUpdate()\n          // 关闭状态下 willUpdate 查不到 portal 面板内容；打开期的新增/删除\n          // 由宿主在微任务内立即同步标签与激活态。\n          if (host.isOpen() && host.hasUpdated()) host.onImmediateSync?.()\n        })\n      },\n\n      handleOptionUnregister,\n\n      bindHost() {\n        host.element.addEventListener('option-register', handleRegister)\n        host.element.addEventListener('option-unregister', handleOptionUnregister)\n      },\n\n      dispose() {\n        host.element.removeEventListener('option-register', handleRegister)\n        host.element.removeEventListener('option-unregister', handleOptionUnregister)\n        pendingUnregistered.clear()\n      }\n    }\n\n    return api\n  })\n"],"mappings":";;AAyEA,IAAM,IAAa,iBAEN,UACX,GAAgD,MAAQ;CACtD,IAAM,oBAAsB,IAAI,IAAiB,GAG3C,oBAAY,IAAI,QAA6B,GAC/C,IAAe,GAEb,KAAc,MAAwB;EAE1C,AADA,EAAK,WAAW,CAAM,GACtB,EAAO,iBAAiB,qBAAqB,CAAsB;CACrE,GAEM,KAAgB,MAAwB;EAE5C,AADA,EAAK,aAAa,CAAM,GACxB,EAAO,oBAAoB,qBAAqB,CAAsB;CACxE,GAEM,KAA0B,MAAiB;EAM/C,AAHI,EAAM,kBAAkB,eAAe,EAAM,OAAO,cAAc,KACpE,EAAoB,IAAI,EAAM,MAAqB,GAErD,EAAI,gBAAgB;CACtB,GAEM,UAAuB;EAC3B,EAAI,gBAAgB;CACtB,GAEM,IAAuB;EAC3B,eAAe;GACb,IAAM,IAAQ,EAAK,UAAU,CAAC,EAAE,SAAS,EAAK,iBAAiB,GACzD,IAAe,IAAQ,CAAC,GAAG,EAAM,iBAA8B,CAAU,CAAC,IAAI,CAAC;GAGrF,OAAO,EAAa,SAAS,IAAI,IAAe,CAAC,GAAG,EAAK,QAAQ,iBAA8B,CAAU,CAAC;EAC5G;EAEA,QAAQ,GAAU,GAAc;GAC9B,IAAM,IAAc,EAAI,aAAa;GAIrC,KAAK,IAAM,KAAU,GAAU,AAAK,EAAY,SAAS,CAAM,KAAG,EAAa,CAAM;GAIrF,OAHA,EAAY,QAAQ,CAAU,GAGvB;IACL,SAAS;IACT,aAAa,KAAgB,EAAY,SAAS,CAAY,IAAI,EAAY,QAAQ,CAAY,IAAI;GACxG;EACF;EAEA,gBAAgB,GAAiB;GAC/B,IAAM,IAAU,IAAI,IAAI,EAAgB,KAAI,MAAU,EAAO,EAAE,CAAC,CAAC,QAAQ,MAAqB,EAAQ,CAAG,CAAC;GAC1G,EAAgB,SAAQ,MAAU;IAChC,IAAI,EAAO,IAAI;IAEf,IAAI,IAAK,EAAU,IAAI,CAAM;IAC7B,IAAI,CAAC,KAAM,EAAQ,IAAI,CAAE,GAAG;KAC1B;MACE,IAAK,GAAG,EAAK,SAAS,UAAU,EAAE;YAC3B,EAAQ,IAAI,CAAE;KACvB,EAAU,IAAI,GAAQ,CAAE;IAC1B;IAEA,AADA,EAAO,KAAK,GACZ,EAAQ,IAAI,CAAE;GAChB,CAAC;EACH;EAEA,oBAAoB;GAClB,IAAM,IAAS,EAAK,UAAU,GACxB,IAAgB,EAAK,iBAAiB;GAC5C,IAAI,CAAC,KAAU,CAAC,GAAe;GAI/B,KAAK,IAAM,KAAU,GACnB,AAAI,CAAC,EAAc,SAAS,CAAM,KAAK,CAAC,EAAK,QAAQ,SAAS,CAAM,KAAG,EAAO,cAAc,CAAC,CAAM,CAAC;GAItG,IAFA,EAAoB,MAAM,GAEtB,CAAC,EAAK,OAAO,GAAG;GAKpB,IAAM,IAAQ,EAAK,mBAAmB,CAAC,CAAC,QAAO,MAAQ,EAAE,aAAgB,QAAQ;GACjF,AAAI,EAAM,UAAQ,EAAO,cAAc,GAAO,CAAa;EAC7D;EAEA,kBAAkB;GAChB,qBAAqB;IACd,EAAK,QAAQ,gBAClB,EAAI,kBAAkB,GACtB,EAAK,cAAc,GAGf,EAAK,OAAO,KAAK,EAAK,WAAW,KAAG,EAAK,kBAAkB;GACjE,CAAC;EACH;EAEA;EAEA,WAAW;GAET,AADA,EAAK,QAAQ,iBAAiB,mBAAmB,CAAc,GAC/D,EAAK,QAAQ,iBAAiB,qBAAqB,CAAsB;EAC3E;EAEA,UAAU;GAGR,AAFA,EAAK,QAAQ,oBAAoB,mBAAmB,CAAc,GAClE,EAAK,QAAQ,oBAAoB,qBAAqB,CAAsB,GAC5E,EAAoB,MAAM;EAC5B;CACF;CAEA,OAAO;AACT,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/shared/option-portal/index.ts"],"sourcesContent":["import { definePlugin } from '@greypan/js-kit'\n\nimport type { WebUiOption } from '@/components/option'\nimport type { OverlayPortal } from '@/shared/overlay/portal'\n\n/**\n * select / autocomplete 共用的 portal option 域：宿主侧 option 注册表、\n * portal 内容同步（打开期迁移 + 真删除清理）与微任务调度。\n *\n * 交互语义与 Lit 响应式由各组件保留（同 anchored-panel 的边界约定）：\n * 组件通过 host 回调注入差异点（迁移节点来源、打开期即时同步等），\n * 并持有 _options/_activeIndex 的 @state，shared 只经返回值同步数据。\n */\n\nexport interface OptionPortalHost {\n  /** 承载宿主级监听的元素（select / autocomplete 宿主自身）。 */\n  readonly element: HTMLElement\n  /** option id 前缀；宿主应保证跨实例唯一（如含实例序号），供 aria 引用与样式定位。 */\n  readonly idPrefix: string\n  getPortal(): OverlayPortal | undefined\n  getPortalContent(): HTMLElement | undefined\n  /** 打开判定：syncPortalContent 仅在打开期执行内容迁移。 */\n  isOpen(): boolean\n  /**\n   * 打开期待迁移的节点来源。两组件粒度不同（select 迁裸 option，\n   * autocomplete 迁全部 childNodes），保持各自现状不在此统一。\n   */\n  getMigratableNodes(): Node[]\n  /** 微任务回调中判断宿主是否已完成首次渲染（Lit hasUpdated）。 */\n  hasUpdated(): boolean\n  /** 微任务末的宿主刷新（requestUpdate）。 */\n  requestUpdate(): void\n  /**\n   * 打开期即时同步钩子。select 在微任务内立即刷新标签与激活态\n   * （portal 打开时 willUpdate 查不到面板外的新增项），autocomplete 无此需要。\n   */\n  onImmediateSync?(): void\n  /**\n   * 组件侧的逐元素交互监听（click/pointerover/pointerdown/option-update）。\n   * shared 负责随 refresh 配对调用，语义由组件定义。\n   */\n  bindOption(option: WebUiOption): void\n  unbindOption(option: WebUiOption): void\n}\n\nexport interface OptionPortalApi {\n  /** 面板优先查询，面板无 option 或关闭时回退 light DOM。 */\n  queryOptions(): WebUiOption[]\n  /**\n   * diff 出旧集合解绑、新集合绑定；按 option 身份保持激活索引。\n   * 返回新注册表数组与新的激活索引（-1 表示激活项已失效，如移除/迁移）。\n   */\n  refresh(\n    previous: readonly WebUiOption[],\n    activeOption: WebUiOption | undefined\n  ): {\n    options: WebUiOption[]\n    activeIndex: number\n  }\n  /** 稳定 id 分配（WeakMap 身份 + 冲突循环），跨 remove/reorder 保持不变。 */\n  ensureOptionIds(options: readonly WebUiOption[]): void\n  /** pending 真删除清理 + 打开期把滞留 light DOM 的节点迁入面板。 */\n  syncPortalContent(): void\n  /** register/unregister/contentChange 的统一微任务收敛入口（slot 监听由组件模板持有）。 */\n  scheduleRefresh(): void\n  /** 宿主级与逐元素 unregister 监听共用的处理器。 */\n  handleOptionUnregister(event: Event): void\n  /** 宿主级监听配对（connectedCallback 调用，与 dispose 配对）。 */\n  bindHost(): void\n  /** 断连清理：解绑宿主监听并清空 pending 集合。 */\n  dispose(): void\n}\n\nconst OPTION_TAG = 'web-ui-option'\n\nexport const defineOptionPortal = () =>\n  definePlugin<OptionPortalApi, OptionPortalHost>(host => {\n    const pendingUnregistered = new Set<WebUiOption>()\n    // 稳定 id：WeakMap 按 option 身份记忆分配结果，remove/reorder 后 id 不变；\n    // aria-activedescendant / 外部样式都依赖 id 的时序稳定性。\n    const optionIds = new WeakMap<WebUiOption, string>()\n    let nextOptionId = 0\n\n    const bindOption = (option: WebUiOption) => {\n      host.bindOption(option)\n      option.addEventListener('option-unregister', handleOptionUnregister)\n    }\n\n    const unbindOption = (option: WebUiOption) => {\n      host.unbindOption(option)\n      option.removeEventListener('option-unregister', handleOptionUnregister)\n    }\n\n    const handleOptionUnregister = (event: Event) => {\n      // Portal 迁移与真实删除都会触发 unregister；先记录候选，\n      // 微任务末 syncPortalContent 按最终位置区分二者。\n      if (event.target instanceof HTMLElement && event.target.localName === OPTION_TAG) {\n        pendingUnregistered.add(event.target as WebUiOption)\n      }\n      api.scheduleRefresh()\n    }\n\n    const handleRegister = () => {\n      api.scheduleRefresh()\n    }\n\n    const api: OptionPortalApi = {\n      queryOptions() {\n        const panel = host.getPortal()?.panel ?? host.getPortalContent()\n        const panelOptions = panel ? [...panel.querySelectorAll<WebUiOption>(OPTION_TAG)] : []\n        // 面板内容仅在浮层打开、moveContent 之后存在；关闭时回退 light DOM，\n        // 否则 portal 组件首次加载时注册表为空。\n        return panelOptions.length > 0 ? panelOptions : [...host.element.querySelectorAll<WebUiOption>(OPTION_TAG)]\n      },\n\n      refresh(previous, activeOption) {\n        const nextOptions = api.queryOptions()\n\n        // register/unregister 是 composed 事件：Portal 迁移时 target 会 retarget 成宿主，\n        // 不能作为监听器绑定依据；绑定只发生在按 DOM 查询确认身份的 option 上。\n        for (const option of previous) if (!nextOptions.includes(option)) unbindOption(option)\n        nextOptions.forEach(bindOption)\n\n        // 激活索引按 option 身份保持，避免移除中间项后静默偏移到相邻项\n        return {\n          options: nextOptions,\n          activeIndex: activeOption && nextOptions.includes(activeOption) ? nextOptions.indexOf(activeOption) : -1\n        }\n      },\n\n      ensureOptionIds(registryOptions) {\n        const usedIds = new Set(registryOptions.map(option => option.id).filter((id): id is string => Boolean(id)))\n        registryOptions.forEach(option => {\n          if (option.id) return\n\n          let id = optionIds.get(option)\n          if (!id || usedIds.has(id)) {\n            do {\n              id = `${host.idPrefix}-option-${++nextOptionId}`\n            } while (usedIds.has(id))\n            optionIds.set(option, id)\n          }\n          option.id = id\n          usedIds.add(id)\n        })\n      },\n\n      syncPortalContent() {\n        const portal = host.getPortal()\n        const portalContent = host.getPortalContent()\n        if (!portal || !portalContent) return\n\n        // 真删除（既不在面板也不在 light DOM）的 option 从 portal 追踪列表摘除，\n        // 否则关闭时 restoreContent 会把它复活回 light DOM。\n        for (const option of pendingUnregistered) {\n          if (!portalContent.contains(option) && !host.element.contains(option)) portal.removeContent([option])\n        }\n        pendingUnregistered.clear()\n\n        if (!host.isOpen()) return\n\n        // Portal 打开期间框架条件渲染（v-if）可能在 light DOM 插入新节点；\n        // 面板内已有内容时 queryOptions 不会回退 light DOM，必须显式迁入面板。\n        // 注释（框架锚点与 portal 的 marker）不迁移：锚点留守宿主是实时渲染契约。\n        const nodes = host.getMigratableNodes().filter(node => !(node instanceof Comment))\n        if (nodes.length) portal.appendContent(nodes, portalContent)\n      },\n\n      scheduleRefresh() {\n        queueMicrotask(() => {\n          if (!host.element.isConnected) return\n          api.syncPortalContent()\n          host.requestUpdate()\n          // 关闭状态下 willUpdate 查不到 portal 面板内容；打开期的新增/删除\n          // 由宿主在微任务内立即同步标签与激活态。\n          if (host.isOpen() && host.hasUpdated()) host.onImmediateSync?.()\n        })\n      },\n\n      handleOptionUnregister,\n\n      bindHost() {\n        host.element.addEventListener('option-register', handleRegister)\n        host.element.addEventListener('option-unregister', handleOptionUnregister)\n      },\n\n      dispose() {\n        host.element.removeEventListener('option-register', handleRegister)\n        host.element.removeEventListener('option-unregister', handleOptionUnregister)\n        pendingUnregistered.clear()\n      }\n    }\n\n    return api\n  })\nexport * from './combobox-shell'\n"],"mappings":";;;AAyEA,IAAM,IAAa,iBAEN,UACX,GAAgD,MAAQ;CACtD,IAAM,oBAAsB,IAAI,IAAiB,GAG3C,oBAAY,IAAI,QAA6B,GAC/C,IAAe,GAEb,KAAc,MAAwB;EAE1C,AADA,EAAK,WAAW,CAAM,GACtB,EAAO,iBAAiB,qBAAqB,CAAsB;CACrE,GAEM,KAAgB,MAAwB;EAE5C,AADA,EAAK,aAAa,CAAM,GACxB,EAAO,oBAAoB,qBAAqB,CAAsB;CACxE,GAEM,KAA0B,MAAiB;EAM/C,AAHI,EAAM,kBAAkB,eAAe,EAAM,OAAO,cAAc,KACpE,EAAoB,IAAI,EAAM,MAAqB,GAErD,EAAI,gBAAgB;CACtB,GAEM,UAAuB;EAC3B,EAAI,gBAAgB;CACtB,GAEM,IAAuB;EAC3B,eAAe;GACb,IAAM,IAAQ,EAAK,UAAU,CAAC,EAAE,SAAS,EAAK,iBAAiB,GACzD,IAAe,IAAQ,CAAC,GAAG,EAAM,iBAA8B,CAAU,CAAC,IAAI,CAAC;GAGrF,OAAO,EAAa,SAAS,IAAI,IAAe,CAAC,GAAG,EAAK,QAAQ,iBAA8B,CAAU,CAAC;EAC5G;EAEA,QAAQ,GAAU,GAAc;GAC9B,IAAM,IAAc,EAAI,aAAa;GAIrC,KAAK,IAAM,KAAU,GAAU,AAAK,EAAY,SAAS,CAAM,KAAG,EAAa,CAAM;GAIrF,OAHA,EAAY,QAAQ,CAAU,GAGvB;IACL,SAAS;IACT,aAAa,KAAgB,EAAY,SAAS,CAAY,IAAI,EAAY,QAAQ,CAAY,IAAI;GACxG;EACF;EAEA,gBAAgB,GAAiB;GAC/B,IAAM,IAAU,IAAI,IAAI,EAAgB,KAAI,MAAU,EAAO,EAAE,CAAC,CAAC,QAAQ,MAAqB,EAAQ,CAAG,CAAC;GAC1G,EAAgB,SAAQ,MAAU;IAChC,IAAI,EAAO,IAAI;IAEf,IAAI,IAAK,EAAU,IAAI,CAAM;IAC7B,IAAI,CAAC,KAAM,EAAQ,IAAI,CAAE,GAAG;KAC1B;MACE,IAAK,GAAG,EAAK,SAAS,UAAU,EAAE;YAC3B,EAAQ,IAAI,CAAE;KACvB,EAAU,IAAI,GAAQ,CAAE;IAC1B;IAEA,AADA,EAAO,KAAK,GACZ,EAAQ,IAAI,CAAE;GAChB,CAAC;EACH;EAEA,oBAAoB;GAClB,IAAM,IAAS,EAAK,UAAU,GACxB,IAAgB,EAAK,iBAAiB;GAC5C,IAAI,CAAC,KAAU,CAAC,GAAe;GAI/B,KAAK,IAAM,KAAU,GACnB,AAAI,CAAC,EAAc,SAAS,CAAM,KAAK,CAAC,EAAK,QAAQ,SAAS,CAAM,KAAG,EAAO,cAAc,CAAC,CAAM,CAAC;GAItG,IAFA,EAAoB,MAAM,GAEtB,CAAC,EAAK,OAAO,GAAG;GAKpB,IAAM,IAAQ,EAAK,mBAAmB,CAAC,CAAC,QAAO,MAAQ,EAAE,aAAgB,QAAQ;GACjF,AAAI,EAAM,UAAQ,EAAO,cAAc,GAAO,CAAa;EAC7D;EAEA,kBAAkB;GAChB,qBAAqB;IACd,EAAK,QAAQ,gBAClB,EAAI,kBAAkB,GACtB,EAAK,cAAc,GAGf,EAAK,OAAO,KAAK,EAAK,WAAW,KAAG,EAAK,kBAAkB;GACjE,CAAC;EACH;EAEA;EAEA,WAAW;GAET,AADA,EAAK,QAAQ,iBAAiB,mBAAmB,CAAc,GAC/D,EAAK,QAAQ,iBAAiB,qBAAqB,CAAsB;EAC3E;EAEA,UAAU;GAGR,AAFA,EAAK,QAAQ,oBAAoB,mBAAmB,CAAc,GAClE,EAAK,QAAQ,oBAAoB,qBAAqB,CAAsB,GAC5E,EAAoB,MAAM;EAC5B;CACF;CAEA,OAAO;AACT,CAAC"}

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

@@ -1,49 +1,52 @@
-import { defineOverlay as e } from "./overlay.js";
-import { hideOverlayPresence as t, showOverlayPresence as n } from "./presence.js";
-import { definePlugin as r } from "@greypan/js-kit";
+import { overlayComposition as e } from "./composition.js";
+import { defineOverlay as t } from "./overlay.js";
+import { hideOverlayPresence as n, showOverlayPresence as r } from "./presence.js";
+import { definePlugin as i } from "@greypan/js-kit";
 //#region src/shared/overlay/anchored-panel.ts
-var i = () => r((r) => {
-	let i, a, o = () => a?.panel ?? r.getLocalPanel(), s = () => {
-		a && (a.restoreContent(), a.remove(), a = void 0, i = void 0);
-	}, c = () => r.isPortal() ? (a ??= r.createPortal(), a.panel) : r.getLocalPanel(), l = (t, n) => {
-		if (i) {
-			i.updateAnchor(t), i.update(r.getPositioning());
+var a = () => i((i) => {
+	let a, o, s = () => o?.panel ?? i.getLocalPanel(), c = () => {
+		o && (e.unregisterPanel(o.panel), o.restoreContent(), o.remove(), o = void 0, a = void 0);
+	}, l = () => i.isPortal() ? (o ??= i.createPortal(), o.panel) : i.getLocalPanel(), u = (e, n) => {
+		if (a) {
+			a.updateAnchor(e), a.update(i.getPositioning());
 			return;
 		}
-		i = e().make({
-			anchor: t,
+		a = t().make({
+			anchor: e,
 			overlay: n,
-			...r.getPositioning()
+			...i.getPositioning()
 		});
-	}, u = (e = !1) => {
-		let t = r.getAnchor();
-		if (!t) return;
-		let a = c();
-		a && (l(t, a), i?.open(), n(a, { isInstant: e }));
-	}, d = () => {
-		i?.dispose(), i = void 0, s();
+	}, d = (t = !1) => {
+		let n = i.getAnchor();
+		if (!n) return;
+		let o = l();
+		o && (e.registerPanelFromAncestry(o, n), u(n, o), a?.open(), r(o, { isInstant: t }));
+	}, f = () => {
+		a?.dispose(), a = void 0;
+		let t = s();
+		t && e.unregisterPanel(t), c();
 	};
 	return {
 		getPanel() {
-			return o();
+			return s();
 		},
-		open: u,
-		async close(e) {
-			i?.close();
-			let n = o();
-			return n && !await t(n) || e() ? !1 : (s(), !0);
+		open: d,
+		async close(t) {
+			a?.close();
+			let r = s();
+			return r && !await n(r) || t() ? !1 : (r && e.unregisterPanel(r), c(), !0);
 		},
 		updatePosition() {
-			i?.update(r.getPositioning());
+			a?.update(i.getPositioning());
 		},
 		reconfigure(e) {
-			let t = o()?.dataset.wuiPresence === "entering";
-			d(), e && u(!t);
+			let t = s()?.dataset.wuiPresence === "entering";
+			f(), e && d(!t);
 		},
-		dispose: d
+		dispose: f
 	};
 });
 //#endregion
-export { i as defineAnchoredPanel };
+export { a as defineAnchoredPanel };
 
 //# sourceMappingURL=anchored-panel.js.map

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 { 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\n/**\n * 管理锚定面板的本地/Portal 容器、定位器和可中断 presence。\n * 内容迁移与交互语义由各组件保留，避免把不同组件的 public contract 混入此模块。\n */\nexport interface AnchoredPanelApi {\n  getPanel(): HTMLElement | 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\n    const getPanel = () => portal?.panel ?? ctx.getLocalPanel()\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      ensureOverlay(anchor, panel)\n      overlay?.open()\n      showOverlayPresence(panel, { isInstant })\n    }\n\n    const dispose = () => {\n      overlay?.dispose()\n      overlay = undefined\n      disposePortal()\n    }\n\n    return {\n      getPanel() {\n        return getPanel()\n      },\n\n      open,\n\n      async close(isStillOpen) {\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":";;;;AA6BA,IAAa,UACX,GAAqD,MAAO;CAC1D,IAAI,GACA,GAEE,UAAiB,GAAQ,SAAS,EAAI,cAAc,GAEpD,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,MACL,EAAc,GAAQ,CAAK,GAC3B,GAAS,KAAK,GACd,EAAoB,GAAO,EAAE,aAAU,CAAC;CAC1C,GAEM,UAAgB;EAGpB,AAFA,GAAS,QAAQ,GACjB,IAAU,KAAA,GACV,EAAc;CAChB;CAEA,OAAO;EACL,WAAW;GACT,OAAO,EAAS;EAClB;EAEA;EAEA,MAAM,MAAM,GAAa;GACvB,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 { overlayComposition } from './composition'\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\n/**\n * 管理锚定面板的本地/Portal 容器、定位器和可中断 presence。\n * 内容迁移与交互语义由各组件保留，避免把不同组件的 public contract 混入此模块。\n */\nexport interface AnchoredPanelApi {\n  getPanel(): HTMLElement | 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\n    const getPanel = () => portal?.panel ?? ctx.getLocalPanel()\n\n    const disposePortal = () => {\n      if (!portal) return\n      overlayComposition.unregisterPanel(portal.panel)\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 祖先链寻找最近的已登记 overlay，建立统一逻辑父子关系。\n      overlayComposition.registerPanelFromAncestry(panel, anchor)\n      ensureOverlay(anchor, panel)\n      overlay?.open()\n      showOverlayPresence(panel, { isInstant })\n    }\n\n    const dispose = () => {\n      overlay?.dispose()\n      overlay = undefined\n      const panel = getPanel()\n      if (panel) overlayComposition.unregisterPanel(panel)\n      disposePortal()\n    }\n\n    return {\n      getPanel() {\n        return getPanel()\n      },\n\n      open,\n\n      async close(isStillOpen) {\n        overlay?.close()\n        const panel = getPanel()\n        if (panel && !(await hideOverlayPresence(panel))) return false\n        if (isStillOpen()) return false\n        if (panel) overlayComposition.unregisterPanel(panel)\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":";;;;;AA8BA,IAAa,UACX,GAAqD,MAAO;CAC1D,IAAI,GACA,GAEE,UAAiB,GAAQ,SAAS,EAAI,cAAc,GAEpD,UAAsB;EACrB,MACL,EAAmB,gBAAgB,EAAO,KAAK,GAC/C,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,MAGL,EAAmB,0BAA0B,GAAO,CAAM,GAC1D,EAAc,GAAQ,CAAK,GAC3B,GAAS,KAAK,GACd,EAAoB,GAAO,EAAE,aAAU,CAAC;CAC1C,GAEM,UAAgB;EAEpB,AADA,GAAS,QAAQ,GACjB,IAAU,KAAA;EACV,IAAM,IAAQ,EAAS;EAEvB,AADI,KAAO,EAAmB,gBAAgB,CAAK,GACnD,EAAc;CAChB;CAEA,OAAO;EACL,WAAW;GACT,OAAO,EAAS;EAClB;EAEA;EAEA,MAAM,MAAM,GAAa;GACvB,GAAS,MAAM;GACf,IAAM,IAAQ,EAAS;GAKvB,OAJI,KAAS,CAAE,MAAM,EAAoB,CAAK,KAC1C,EAAY,IAAU,MACtB,KAAO,EAAmB,gBAAgB,CAAK,GACnD,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/composition.js

@@ -0,0 +1,57 @@
+//#region src/shared/overlay/composition.ts
+var e = /* @__PURE__ */ new WeakMap(), t = /* @__PURE__ */ new WeakMap(), n = /* @__PURE__ */ new WeakMap();
+function r(t) {
+	let n = e.get(t);
+	return n || (n = { children: /* @__PURE__ */ new Set() }, e.set(t, n)), n;
+}
+function i(e) {
+	return e instanceof Element && e.assignedSlot ? e.assignedSlot : e.parentNode ? e.parentNode : e instanceof ShadowRoot ? e.host : null;
+}
+function a(e, t) {
+	let n = t;
+	for (; n;) {
+		if (n === e || e.contains(n)) return !0;
+		n = i(n);
+	}
+	return !1;
+}
+function o(e) {
+	let r = t.get(e);
+	r && (n.get(r)?.delete(e), n.get(r)?.size === 0 && n.delete(r), t.delete(e));
+}
+var s = {
+	registerPanel(e, i) {
+		if (e === i || (o(e), r(e), !i)) return;
+		r(i);
+		let a = n.get(i) ?? /* @__PURE__ */ new Set();
+		a.add(e), n.set(i, a), t.set(e, i);
+	},
+	registerPanelFromAncestry(t, n) {
+		let r = n === t ? i(n) : n;
+		for (; r;) {
+			if (r instanceof HTMLElement && r !== t && e.has(r)) return this.registerPanel(t, r), r;
+			r = i(r);
+		}
+		this.registerPanel(t), o(t);
+	},
+	unregisterPanel(t) {
+		Array.from(n.get(t) ?? []).forEach((e) => this.unregisterPanel(e)), o(t), n.delete(t), e.delete(t);
+	},
+	contains(e, t) {
+		if (a(e, t)) return !0;
+		for (let r of n.get(e) ?? []) if (this.contains(r, t)) return !0;
+		return !1;
+	},
+	containsEvent(e, t) {
+		return t.composedPath().some((t) => t instanceof Node && this.contains(e, t));
+	},
+	hasFocusWithin(e) {
+		if (e.matches(":focus-within")) return !0;
+		for (let t of n.get(e) ?? []) if (this.hasFocusWithin(t)) return !0;
+		return !1;
+	}
+};
+//#endregion
+export { s as overlayComposition };
+
+//# sourceMappingURL=composition.js.map

package/dist/shared/overlay/composition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.js","names":[],"sources":["../../../src/shared/overlay/composition.ts"],"sourcesContent":["/**\n * Overlay 逻辑祖先关系注册表。\n *\n * Portal 会让 DOM 祖先链与用户感知的组合关系分离：submenu、嵌套 popover 或\n * panel 内的子 overlay 通常被迁到独立 overlay root。交互所有权必须以这里登记\n * 的逻辑树判定，而不是继续在各组件内复制 contains()。\n */\n\ninterface OverlayPanelEntry {\n  children: Set<HTMLElement>\n}\n\nconst entries = new WeakMap<HTMLElement, OverlayPanelEntry>()\nconst parents = new WeakMap<HTMLElement, HTMLElement>()\nconst children = new WeakMap<HTMLElement, Set<HTMLElement>>()\n\nfunction entryFor(panel: HTMLElement): OverlayPanelEntry {\n  let entry = entries.get(panel)\n  if (!entry) {\n    entry = { children: new Set() }\n    entries.set(panel, entry)\n  }\n  return entry\n}\n\n/** 判断 node 是否在 root 的物理或 shadow DOM 子树内。 */\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 removeFromParent(panel: HTMLElement): void {\n  const parent = parents.get(panel)\n  if (!parent) return\n  children.get(parent)?.delete(panel)\n  if (children.get(parent)?.size === 0) children.delete(parent)\n  parents.delete(panel)\n}\n\nexport const overlayComposition = {\n  /**\n   * 登记 panel；parentPanel 存在时建立逻辑父子关系。重复登记会迁移到新父级，\n   * 但不影响 panel 已有后代，供同 panel 重定位/恢复场景复用。\n   */\n  registerPanel(panel: HTMLElement, parentPanel?: HTMLElement): void {\n    if (panel === parentPanel) return\n    removeFromParent(panel)\n    entryFor(panel)\n    if (!parentPanel) return\n\n    entryFor(parentPanel)\n    const siblings = children.get(parentPanel) ?? new Set<HTMLElement>()\n    siblings.add(panel)\n    children.set(parentPanel, siblings)\n    parents.set(panel, parentPanel)\n  },\n\n  /**\n   * 通过 owner 的物理祖先链寻找已登记 overlay panel。panel 可以是本地 shadow\n   * panel，也可以是 portal panel；portal 场景传入 portal target 即可找到原组合父级。\n   */\n  registerPanelFromAncestry(panel: HTMLElement, owner: Node): HTMLElement | undefined {\n    let current: Node | null = owner === panel ? nextCompositionNode(owner) : owner\n    while (current) {\n      if (current instanceof HTMLElement && current !== panel && entries.has(current)) {\n        this.registerPanel(panel, current)\n        return current\n      }\n      current = nextCompositionNode(current)\n    }\n    this.registerPanel(panel)\n    removeFromParent(panel)\n    return undefined\n  },\n\n  /** 注销 panel 及其全部逻辑后代，避免关闭后留下 stale ancestry。 */\n  unregisterPanel(panel: HTMLElement): void {\n    const descendants = Array.from(children.get(panel) ?? [])\n    descendants.forEach(descendant => this.unregisterPanel(descendant))\n    removeFromParent(panel)\n    children.delete(panel)\n    entries.delete(panel)\n  },\n\n  /** target 是否属于 panel 自身或任何已登记逻辑后代 panel。 */\n  contains(panel: HTMLElement, target: Node): boolean {\n    if (nodeIsInside(panel, target)) return true\n    for (const child of children.get(panel) ?? []) {\n      if (this.contains(child, target)) return true\n    }\n    return false\n  },\n\n  /** event 的完整 composed path 是否落入 panel 的逻辑组合子树。 */\n  containsEvent(panel: HTMLElement, event: Event): boolean {\n    return event.composedPath().some(node => node instanceof Node && this.contains(panel, node))\n  },\n\n  /** 焦点是否在 panel 或其逻辑后代 panel 内。 */\n  hasFocusWithin(panel: HTMLElement): boolean {\n    if (panel.matches(':focus-within')) return true\n    for (const child of children.get(panel) ?? []) {\n      if (this.hasFocusWithin(child)) return true\n    }\n    return false\n  }\n}\n"],"mappings":";AAYA,IAAM,oBAAU,IAAI,QAAwC,GACtD,oBAAU,IAAI,QAAkC,GAChD,oBAAW,IAAI,QAAuC;AAE5D,SAAS,EAAS,GAAuC;CACvD,IAAI,IAAQ,EAAQ,IAAI,CAAK;CAK7B,OAJK,MACH,IAAQ,EAAE,0BAAU,IAAI,IAAI,EAAE,GAC9B,EAAQ,IAAI,GAAO,CAAK,IAEnB;AACT;AAGA,SAAS,EAAoB,GAAyB;CAIpD,OAHI,aAAgB,WAAW,EAAK,eAAqB,EAAK,eAC1D,EAAK,aAAmB,EAAK,aAC7B,aAAgB,aAAmB,EAAK,OACrC;AACT;AAEA,SAAS,EAAa,GAAmB,GAAqB;CAC5D,IAAI,IAAuB;CAC3B,OAAO,IAAS;EACd,IAAI,MAAY,KAAQ,EAAK,SAAS,CAAO,GAAG,OAAO;EACvD,IAAU,EAAoB,CAAO;CACvC;CACA,OAAO;AACT;AAEA,SAAS,EAAiB,GAA0B;CAClD,IAAM,IAAS,EAAQ,IAAI,CAAK;CAC3B,MACL,EAAS,IAAI,CAAM,CAAC,EAAE,OAAO,CAAK,GAC9B,EAAS,IAAI,CAAM,CAAC,EAAE,SAAS,KAAG,EAAS,OAAO,CAAM,GAC5D,EAAQ,OAAO,CAAK;AACtB;AAEA,IAAa,IAAqB;CAKhC,cAAc,GAAoB,GAAiC;EAIjE,IAHI,MAAU,MACd,EAAiB,CAAK,GACtB,EAAS,CAAK,GACV,CAAC,IAAa;EAElB,EAAS,CAAW;EACpB,IAAM,IAAW,EAAS,IAAI,CAAW,qBAAK,IAAI,IAAiB;EAGnE,AAFA,EAAS,IAAI,CAAK,GAClB,EAAS,IAAI,GAAa,CAAQ,GAClC,EAAQ,IAAI,GAAO,CAAW;CAChC;CAMA,0BAA0B,GAAoB,GAAsC;EAClF,IAAI,IAAuB,MAAU,IAAQ,EAAoB,CAAK,IAAI;EAC1E,OAAO,IAAS;GACd,IAAI,aAAmB,eAAe,MAAY,KAAS,EAAQ,IAAI,CAAO,GAE5E,OADA,KAAK,cAAc,GAAO,CAAO,GAC1B;GAET,IAAU,EAAoB,CAAO;EACvC;EAEA,AADA,KAAK,cAAc,CAAK,GACxB,EAAiB,CAAK;CAExB;CAGA,gBAAgB,GAA0B;EAKxC,AAHA,MAD0B,KAAK,EAAS,IAAI,CAAK,KAAK,CAAC,CACvD,CAAA,CAAY,SAAQ,MAAc,KAAK,gBAAgB,CAAU,CAAC,GAClE,EAAiB,CAAK,GACtB,EAAS,OAAO,CAAK,GACrB,EAAQ,OAAO,CAAK;CACtB;CAGA,SAAS,GAAoB,GAAuB;EAClD,IAAI,EAAa,GAAO,CAAM,GAAG,OAAO;EACxC,KAAK,IAAM,KAAS,EAAS,IAAI,CAAK,KAAK,CAAC,GAC1C,IAAI,KAAK,SAAS,GAAO,CAAM,GAAG,OAAO;EAE3C,OAAO;CACT;CAGA,cAAc,GAAoB,GAAuB;EACvD,OAAO,EAAM,aAAa,CAAC,CAAC,MAAK,MAAQ,aAAgB,QAAQ,KAAK,SAAS,GAAO,CAAI,CAAC;CAC7F;CAGA,eAAe,GAA6B;EAC1C,IAAI,EAAM,QAAQ,eAAe,GAAG,OAAO;EAC3C,KAAK,IAAM,KAAS,EAAS,IAAI,CAAK,KAAK,CAAC,GAC1C,IAAI,KAAK,eAAe,CAAK,GAAG,OAAO;EAEzC,OAAO;CACT;AACF"}

package/dist/shared/overlay/lifecycle.js

@@ -0,0 +1,41 @@
+import { definePlugin as e } from "@greypan/js-kit";
+//#region src/shared/overlay/lifecycle.ts
+var t = () => e((e) => {
+	let t = 0, n = !1, r = /* @__PURE__ */ new Set(), i = (e) => {
+		cancelAnimationFrame(e.id), r.delete(e);
+	}, a = () => {
+		if (!n) {
+			t += 1;
+			for (let e of Array.from(r)) i(e);
+		}
+	};
+	return {
+		getGeneration() {
+			return t;
+		},
+		invalidate: a,
+		scheduleFrame(a, o = {}) {
+			if (n) return { cancel() {} };
+			let s = t, c = {
+				generation: s,
+				id: requestAnimationFrame(() => {
+					r.delete(c), !(n || s !== t) && e.isConnected() && (o.expectedOpen === void 0 || e.isOpen() === o.expectedOpen) && a(s);
+				}),
+				cancel() {
+					i(c);
+				}
+			};
+			return r.add(c), c;
+		},
+		dispose() {
+			n || (n = !0, a());
+		},
+		resume() {
+			n && (n = !1, t += 1);
+		}
+	};
+});
+//#endregion
+export { t as defineOverlayLifecycle };
+
+//# sourceMappingURL=lifecycle.js.map

package/dist/shared/overlay/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","names":[],"sources":["../../../src/shared/overlay/lifecycle.ts"],"sourcesContent":["import { definePlugin } from '@greypan/js-kit'\n\nexport interface OverlayLifecycleHost {\n  isConnected(): boolean\n  isOpen(): boolean\n}\n\nexport interface OverlayFrameOptions {\n  /**\n   * 显式要求回调执行时 open 状态必须等于该值；未传入时只校验连接状态。\n   */\n  expectedOpen?: boolean\n}\n\nexport interface OverlayFrameHandle {\n  cancel(): void\n}\n\nexport interface OverlayLifecycle {\n  /** generation 只能通过方法读取：definePlugin.make 展开对象时会立即消费 getter。 */\n  getGeneration(): number\n  /** 结束当前事务：取消该事务内尚未执行的 frame，并让旧 generation 回调失效。 */\n  invalidate(): void\n  scheduleFrame(callback: (generation: number) => void, options?: OverlayFrameOptions): OverlayFrameHandle\n  dispose(): void\n  /** temporary disconnect 后恢复调度；generation 继续单调递增，旧事务保持失效。 */\n  resume(): void\n}\n\n/**\n * Overlay 组件共享的帧级事务调度。portal / presence / positioning 可能跨多帧，\n * 同帧 controlled open/close、disconnect 或 reconfigure 都必须使旧事务失效，\n * 而不是让每个组件各自散落 open / isConnected 复查。\n */\nexport const defineOverlayLifecycle = () =>\n  definePlugin<OverlayLifecycle, OverlayLifecycleHost>(host => {\n    let generation = 0\n    let disposed = 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 invalidateCurrent = () => {\n      if (disposed) return\n      generation += 1\n      for (const frame of Array.from(frames)) cancelFrame(frame)\n    }\n\n    return {\n      getGeneration() {\n        return generation\n      },\n\n      invalidate: invalidateCurrent,\n\n      scheduleFrame(callback, options = {}) {\n        if (disposed) return { cancel() {} }\n\n        const scheduledGeneration = generation\n        const frame = {\n          generation: scheduledGeneration,\n          id: requestAnimationFrame(() => {\n            frames.delete(frame)\n            if (disposed || scheduledGeneration !== generation) return\n            if (!host.isConnected()) return\n            if (options.expectedOpen !== undefined && host.isOpen() !== options.expectedOpen) return\n            callback(scheduledGeneration)\n          }),\n          cancel() {\n            cancelFrame(frame)\n          }\n        }\n        frames.add(frame)\n        return frame\n      },\n\n      dispose() {\n        if (disposed) return\n        disposed = true\n        invalidateCurrent()\n      },\n\n      resume() {\n        if (!disposed) return\n        disposed = false\n        generation += 1\n      }\n    }\n  })\n"],"mappings":";;AAkCA,IAAa,UACX,GAAqD,MAAQ;CAC3D,IAAI,IAAa,GACb,IAAW,IACT,oBAAS,IAAI,IAA6D,GAE1E,KAAe,MAAmE;EAEtF,AADA,qBAAqB,EAAM,EAAE,GAC7B,EAAO,OAAO,CAAK;CACrB,GAEM,UAA0B;EAC1B,QACJ;QAAc;GACd,KAAK,IAAM,KAAS,MAAM,KAAK,CAAM,GAAG,EAAY,CAAK;EAD3C;CAEhB;CAEA,OAAO;EACL,gBAAgB;GACd,OAAO;EACT;EAEA,YAAY;EAEZ,cAAc,GAAU,IAAU,CAAC,GAAG;GACpC,IAAI,GAAU,OAAO,EAAE,SAAS,CAAC,EAAE;GAEnC,IAAM,IAAsB,GACtB,IAAQ;IACZ,YAAY;IACZ,IAAI,4BAA4B;KAC9B,EAAO,OAAO,CAAK,GACf,OAAY,MAAwB,MACnC,EAAK,YAAY,MAClB,EAAQ,iBAAiB,KAAA,KAAa,EAAK,OAAO,MAAM,EAAQ,iBACpE,EAAS,CAAmB;IAC9B,CAAC;IACD,SAAS;KACP,EAAY,CAAK;IACnB;GACF;GAEA,OADA,EAAO,IAAI,CAAK,GACT;EACT;EAEA,UAAU;GACJ,MACJ,IAAW,IACX,EAAkB;EACpB;EAEA,SAAS;GACF,MACL,IAAW,IACX,KAAc;EAChB;CACF;AACF,CAAC"}

package/dist/shared/overlay/native-dialog-presence.js

@@ -2,45 +2,45 @@ import { getTransitionDuration as e } from "./presence.js";
 import { definePlugin as t } from "@greypan/js-kit";
 //#region src/shared/overlay/native-dialog-presence.ts
 var n = () => t((t) => {
-	let n, r, i = !1, a = () => {
+	let n, r, i = !1, a = !1, o = () => {
 		n !== void 0 && (clearTimeout(n), n = void 0);
-	}, o = () => {
-		r !== void 0 && (cancelAnimationFrame(r), r = void 0);
 	}, s = () => {
-		let e = t.getDialog();
-		!e || !i || t.isOpen() || (a(), i = !1, e.classList.remove("is-closing", "is-visible"), e.open && e.close?.());
+		r !== void 0 && (cancelAnimationFrame(r), r = void 0);
 	}, c = () => {
+		let e = t.getDialog();
+		!e || !i || t.isOpen() || (o(), i = !1, e.classList.remove("is-closing", "is-visible"), e.open && (a = !0, e.close?.()));
+	}, l = () => {
 		let e = t.getDialog();
 		if (e) {
-			if (i = !1, a(), e.classList.remove("is-closing"), !e.open) try {
+			if (i = !1, o(), e.classList.remove("is-closing"), !e.open) try {
 				e.showModal?.();
 			} catch {}
-			o(), r = requestAnimationFrame(() => {
+			e.offsetWidth, s(), r = requestAnimationFrame(() => {
 				r = void 0, !(!t.isConnected() || !t.isOpen() || !e.open) && e.classList.add("is-visible");
 			});
 		}
-	}, l = () => {
+	}, u = () => {
 		let r = t.getDialog();
 		if (r?.open) {
-			if (o(), i = !0, !r.classList.contains("is-visible")) {
-				s();
+			if (s(), i = !0, !r.classList.contains("is-visible")) {
+				c();
 				return;
 			}
-			r.classList.add("is-closing"), r.classList.remove("is-visible"), a(), n = setTimeout(() => s(), e(r) + 80);
+			r.classList.add("is-closing"), r.classList.remove("is-visible"), o(), n = setTimeout(() => c(), e(r) + 80);
 		}
 	};
 	return {
 		sync(e) {
-			e ? c() : l();
+			e ? l() : u();
 		},
 		handleTransitionEnd(e) {
-			e.target === t.getDialog() && e.propertyName === "transform" && s();
+			e.target === t.getDialog() && e.propertyName === "transform" && c();
 		},
 		handleNativeClose() {
-			o(), a(), i = !1, t.getDialog()?.classList.remove("is-closing", "is-visible");
+			return a ? (a = !1, !0) : (s(), o(), i = !1, t.getDialog()?.classList.remove("is-closing", "is-visible"), !1);
 		},
 		dispose() {
-			o(), a(), i = !1;
+			s(), o(), i = !1, a = !1;
 		}
 	};
 });

package/dist/shared/overlay/native-dialog-presence.js.map

@@ -1 +1 @@
-{"version":3,"file":"native-dialog-presence.js","names":[],"sources":["../../../src/shared/overlay/native-dialog-presence.ts"],"sourcesContent":["import { definePlugin } from '@greypan/js-kit'\n\nimport { getTransitionDuration } from './presence'\n\nexport interface NativeDialogPresenceOptions {\n  getDialog(): HTMLDialogElement | null\n  isConnected(): boolean\n  isOpen(): boolean\n}\n\nexport interface NativeDialogPresenceApi {\n  sync(open: boolean): void\n  handleTransitionEnd(event: TransitionEvent): void\n  handleNativeClose(): void\n  dispose(): void\n}\n\n// 管理原生 dialog 保持在 top layer 直至退出动画完成的生命周期。\nexport const defineNativeDialogPresence = () =>\n  definePlugin<NativeDialogPresenceApi, NativeDialogPresenceOptions>(ctx => {\n    let closeFallbackTimer: ReturnType<typeof setTimeout> | undefined\n    let openFrame: number | undefined\n    let isClosing = false\n\n    const clearCloseFallback = () => {\n      if (closeFallbackTimer === undefined) return\n      clearTimeout(closeFallbackTimer)\n      closeFallbackTimer = undefined\n    }\n\n    const cancelOpenFrame = () => {\n      if (openFrame === undefined) return\n      cancelAnimationFrame(openFrame)\n      openFrame = undefined\n    }\n\n    const finishClosing = () => {\n      const dialog = ctx.getDialog()\n      if (!dialog || !isClosing || ctx.isOpen()) return\n      clearCloseFallback()\n      isClosing = false\n      dialog.classList.remove('is-closing', 'is-visible')\n      if (dialog.open) dialog.close?.()\n    }\n\n    const startOpening = () => {\n      const dialog = ctx.getDialog()\n      if (!dialog) return\n      isClosing = false\n      clearCloseFallback()\n      dialog.classList.remove('is-closing')\n      if (!dialog.open) {\n        try {\n          // 并发多个 modal dialog（nested drawer 场景）在规范中合法；\n          // 此 try/catch 为防御性兜底（如对已在 top layer 的 dialog 重复 showModal\n          // 会抛 InvalidStateError），失败时由下方 rAF 回调的 dialog.open 判断中止动画。\n          dialog.showModal?.()\n        } catch {\n          // 保留未打开状态\n        }\n      }\n\n      cancelOpenFrame()\n      openFrame = requestAnimationFrame(() => {\n        openFrame = undefined\n        if (!ctx.isConnected() || !ctx.isOpen() || !dialog.open) return\n        dialog.classList.add('is-visible')\n      })\n    }\n\n    const startClosing = () => {\n      const dialog = ctx.getDialog()\n      if (!dialog?.open) return\n      cancelOpenFrame()\n      isClosing = true\n      if (!dialog.classList.contains('is-visible')) {\n        finishClosing()\n        return\n      }\n\n      dialog.classList.add('is-closing')\n      dialog.classList.remove('is-visible')\n      clearCloseFallback()\n      closeFallbackTimer = setTimeout(() => finishClosing(), getTransitionDuration(dialog) + 80)\n    }\n\n    return {\n      sync(open) {\n        if (open) startOpening()\n        else startClosing()\n      },\n\n      handleTransitionEnd(event) {\n        if (event.target !== ctx.getDialog() || event.propertyName !== 'transform') return\n        finishClosing()\n      },\n\n      handleNativeClose() {\n        cancelOpenFrame()\n        clearCloseFallback()\n        isClosing = false\n        ctx.getDialog()?.classList.remove('is-closing', 'is-visible')\n      },\n\n      dispose() {\n        cancelOpenFrame()\n        clearCloseFallback()\n        isClosing = false\n      }\n    }\n  })\n"],"mappings":";;;AAkBA,IAAa,UACX,GAAmE,MAAO;CACxE,IAAI,GACA,GACA,IAAY,IAEV,UAA2B;EAC3B,MAAuB,KAAA,MAC3B,aAAa,CAAkB,GAC/B,IAAqB,KAAA;CACvB,GAEM,UAAwB;EACxB,MAAc,KAAA,MAClB,qBAAqB,CAAS,GAC9B,IAAY,KAAA;CACd,GAEM,UAAsB;EAC1B,IAAM,IAAS,EAAI,UAAU;EACzB,CAAC,KAAU,CAAC,KAAa,EAAI,OAAO,MACxC,EAAmB,GACnB,IAAY,IACZ,EAAO,UAAU,OAAO,cAAc,YAAY,GAC9C,EAAO,QAAM,EAAO,QAAQ;CAClC,GAEM,UAAqB;EACzB,IAAM,IAAS,EAAI,UAAU;EACxB,OAIL;OAHA,IAAY,IACZ,EAAmB,GACnB,EAAO,UAAU,OAAO,YAAY,GAChC,CAAC,EAAO,MACV,IAAI;IAIF,EAAO,YAAY;GACrB,QAAQ,CAER;GAIF,AADA,EAAgB,GAChB,IAAY,4BAA4B;IACtC,IAAY,KAAA,GACR,GAAC,EAAI,YAAY,KAAK,CAAC,EAAI,OAAO,KAAK,CAAC,EAAO,SACnD,EAAO,UAAU,IAAI,YAAY;GACnC,CAAC;EARC;CASJ,GAEM,UAAqB;EACzB,IAAM,IAAS,EAAI,UAAU;EACxB,OAAQ,MAGb;OAFA,EAAgB,GAChB,IAAY,IACR,CAAC,EAAO,UAAU,SAAS,YAAY,GAAG;IAC5C,EAAc;IACd;GACF;GAKA,AAHA,EAAO,UAAU,IAAI,YAAY,GACjC,EAAO,UAAU,OAAO,YAAY,GACpC,EAAmB,GACnB,IAAqB,iBAAiB,EAAc,GAAG,EAAsB,CAAM,IAAI,EAAE;EALzF;CAMF;CAEA,OAAO;EACL,KAAK,GAAM;GACT,AAAI,IAAM,EAAa,IAClB,EAAa;EACpB;EAEA,oBAAoB,GAAO;GACrB,EAAM,WAAW,EAAI,UAAU,KAAK,EAAM,iBAAiB,eAC/D,EAAc;EAChB;EAEA,oBAAoB;GAIlB,AAHA,EAAgB,GAChB,EAAmB,GACnB,IAAY,IACZ,EAAI,UAAU,CAAC,EAAE,UAAU,OAAO,cAAc,YAAY;EAC9D;EAEA,UAAU;GAGR,AAFA,EAAgB,GAChB,EAAmB,GACnB,IAAY;EACd;CACF;AACF,CAAC"}
+{"version":3,"file":"native-dialog-presence.js","names":[],"sources":["../../../src/shared/overlay/native-dialog-presence.ts"],"sourcesContent":["import { definePlugin } from '@greypan/js-kit'\n\nimport { getTransitionDuration } from './presence'\n\nexport interface NativeDialogPresenceOptions {\n  getDialog(): HTMLDialogElement | null\n  isConnected(): boolean\n  isOpen(): boolean\n}\n\nexport interface NativeDialogPresenceApi {\n  sync(open: boolean): void\n  handleTransitionEnd(event: TransitionEvent): void\n  /**\n   * 处理原生 dialog 的 `close` 事件。\n   *\n   * 返回 `true` 表示该事件是本模块自己 `finishClosing → dialog.close()` 排队的\n   * 异步事件（正常时序在本关闭会话内到达，快速重开时在重开后到达的过期事件），\n   * 消费方不应把它当成外部关闭；返回 `false` 表示真实的外部关闭\n   * （如表单 method=\"dialog\"、宿主程序化 dialog.close()），消费方需自行恢复状态。\n   */\n  handleNativeClose(): boolean\n  dispose(): void\n}\n\n// 管理原生 dialog 保持在 top layer 直至退出动画完成的生命周期。\nexport const defineNativeDialogPresence = () =>\n  definePlugin<NativeDialogPresenceApi, NativeDialogPresenceOptions>(ctx => {\n    let closeFallbackTimer: ReturnType<typeof setTimeout> | undefined\n    let openFrame: number | undefined\n    let isClosing = false\n    // 由本模块 finishClosing 主动 dialog.close() 时置 true。原生 dialog 的 close 事件\n    // 是异步任务（queue a task），可能在之后任意时刻才到达：正常时序在本关闭会话内\n    // 到达（消费方 open 已为 false，本就该忽略）；快速「关闭→重开」时它在重新打开\n    // 之后才到达，若消费方把它当成外部关闭，会把刚重开的 dialog 关掉——这是 drawer\n    // 连续开关后丢失过渡动画（重开即被误关）的根因。置位后由消费方的\n    // handleNativeClose 经 handleNativeClose() 消费；消费方 open 为 false 提前返回时\n    // 也必须调用一次以消费标志，避免泄漏到下一次真实关闭。\n    let selfClosePending = false\n\n    const clearCloseFallback = () => {\n      if (closeFallbackTimer === undefined) return\n      clearTimeout(closeFallbackTimer)\n      closeFallbackTimer = undefined\n    }\n\n    const cancelOpenFrame = () => {\n      if (openFrame === undefined) return\n      cancelAnimationFrame(openFrame)\n      openFrame = undefined\n    }\n\n    const finishClosing = () => {\n      const dialog = ctx.getDialog()\n      if (!dialog || !isClosing || ctx.isOpen()) return\n      clearCloseFallback()\n      isClosing = false\n      dialog.classList.remove('is-closing', 'is-visible')\n      if (dialog.open) {\n        selfClosePending = true\n        dialog.close?.()\n      }\n    }\n\n    const startOpening = () => {\n      const dialog = ctx.getDialog()\n      if (!dialog) return\n      isClosing = false\n      clearCloseFallback()\n      dialog.classList.remove('is-closing')\n      if (!dialog.open) {\n        try {\n          // 并发多个 modal dialog（nested drawer 场景）在规范中合法；\n          // 此 try/catch 为防御性兜底（如对已在 top layer 的 dialog 重复 showModal\n          // 会抛 InvalidStateError），失败时由下方 rAF 回调的 dialog.open 判断中止动画。\n          dialog.showModal?.()\n        } catch {\n          // 保留未打开状态\n        }\n      }\n      // 强制计算初始 top-layer 布局，确保 Safari 等浏览器在下一帧切换 class 时\n      // 有稳定的 transition 起点，而不是偶发跳过进场过渡。\n      void dialog.offsetWidth\n\n      cancelOpenFrame()\n      openFrame = requestAnimationFrame(() => {\n        openFrame = undefined\n        if (!ctx.isConnected() || !ctx.isOpen() || !dialog.open) return\n        dialog.classList.add('is-visible')\n      })\n    }\n\n    const startClosing = () => {\n      const dialog = ctx.getDialog()\n      if (!dialog?.open) return\n      cancelOpenFrame()\n      isClosing = true\n      if (!dialog.classList.contains('is-visible')) {\n        finishClosing()\n        return\n      }\n\n      dialog.classList.add('is-closing')\n      dialog.classList.remove('is-visible')\n      clearCloseFallback()\n      closeFallbackTimer = setTimeout(() => finishClosing(), getTransitionDuration(dialog) + 80)\n    }\n\n    return {\n      sync(open) {\n        if (open) startOpening()\n        else startClosing()\n      },\n\n      handleTransitionEnd(event) {\n        if (event.target !== ctx.getDialog() || event.propertyName !== 'transform') return\n        finishClosing()\n      },\n\n      handleNativeClose() {\n        if (selfClosePending) {\n          // 我们自己的 dialog.close() 排队的事件：正常时序在本会话内到达、快速重开\n          // 时是上一会话的过期事件——两种情况本模块都已在 finishClosing 完成全部清理，\n          // 消费标志并让调用方跳过外部关闭处理即可。\n          selfClosePending = false\n          return true\n        }\n        // 真实的外部关闭：重置打开/关闭状态，等待消费方恢复（如 open=false）。\n        cancelOpenFrame()\n        clearCloseFallback()\n        isClosing = false\n        ctx.getDialog()?.classList.remove('is-closing', 'is-visible')\n        return false\n      },\n\n      dispose() {\n        cancelOpenFrame()\n        clearCloseFallback()\n        isClosing = false\n        selfClosePending = false\n      }\n    }\n  })\n"],"mappings":";;;AA0BA,IAAa,UACX,GAAmE,MAAO;CACxE,IAAI,GACA,GACA,IAAY,IAQZ,IAAmB,IAEjB,UAA2B;EAC3B,MAAuB,KAAA,MAC3B,aAAa,CAAkB,GAC/B,IAAqB,KAAA;CACvB,GAEM,UAAwB;EACxB,MAAc,KAAA,MAClB,qBAAqB,CAAS,GAC9B,IAAY,KAAA;CACd,GAEM,UAAsB;EAC1B,IAAM,IAAS,EAAI,UAAU;EACzB,CAAC,KAAU,CAAC,KAAa,EAAI,OAAO,MACxC,EAAmB,GACnB,IAAY,IACZ,EAAO,UAAU,OAAO,cAAc,YAAY,GAC9C,EAAO,SACT,IAAmB,IACnB,EAAO,QAAQ;CAEnB,GAEM,UAAqB;EACzB,IAAM,IAAS,EAAI,UAAU;EACxB,OAIL;OAHA,IAAY,IACZ,EAAmB,GACnB,EAAO,UAAU,OAAO,YAAY,GAChC,CAAC,EAAO,MACV,IAAI;IAIF,EAAO,YAAY;GACrB,QAAQ,CAER;GAOF,AAHA,EAAY,aAEZ,EAAgB,GAChB,IAAY,4BAA4B;IACtC,IAAY,KAAA,GACR,GAAC,EAAI,YAAY,KAAK,CAAC,EAAI,OAAO,KAAK,CAAC,EAAO,SACnD,EAAO,UAAU,IAAI,YAAY;GACnC,CAAC;EAXC;CAYJ,GAEM,UAAqB;EACzB,IAAM,IAAS,EAAI,UAAU;EACxB,OAAQ,MAGb;OAFA,EAAgB,GAChB,IAAY,IACR,CAAC,EAAO,UAAU,SAAS,YAAY,GAAG;IAC5C,EAAc;IACd;GACF;GAKA,AAHA,EAAO,UAAU,IAAI,YAAY,GACjC,EAAO,UAAU,OAAO,YAAY,GACpC,EAAmB,GACnB,IAAqB,iBAAiB,EAAc,GAAG,EAAsB,CAAM,IAAI,EAAE;EALzF;CAMF;CAEA,OAAO;EACL,KAAK,GAAM;GACT,AAAI,IAAM,EAAa,IAClB,EAAa;EACpB;EAEA,oBAAoB,GAAO;GACrB,EAAM,WAAW,EAAI,UAAU,KAAK,EAAM,iBAAiB,eAC/D,EAAc;EAChB;EAEA,oBAAoB;GAalB,OAZI,KAIF,IAAmB,IACZ,OAGT,EAAgB,GAChB,EAAmB,GACnB,IAAY,IACZ,EAAI,UAAU,CAAC,EAAE,UAAU,OAAO,cAAc,YAAY,GACrD;EACT;EAEA,UAAU;GAIR,AAHA,EAAgB,GAChB,EAAmB,GACnB,IAAY,IACZ,IAAmB;EACrB;CACF;AACF,CAAC"}

package/dist/shared/{theme → overlay}/overlay-root.js

@@ -2,7 +2,7 @@ import e from "../../assets/glass.js";
 import t from "../../assets/overlay-motion.js";
 import n from "../../assets/menu-portal.js";
 import r from "../../assets/toast-containers.js";
-//#region src/shared/theme/overlay-root.ts
+//#region src/shared/overlay/overlay-root.ts
 var i = "data-wui-overlay-root", a = `${e}\n${r}\n${n}\n${t}`;
 function o(e) {
 	let t = document.createElement("style");

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

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-root.js","names":[],"sources":["../../../src/shared/overlay/overlay-root.ts"],"sourcesContent":["import glass from '@/assets/glass.css?inline'\nimport menuPortalStyle from '@/assets/menu-portal.css?inline'\nimport overlayMotion from '@/assets/overlay-motion.css?inline'\nimport toastContainerStyle from '@/assets/toast-containers.css?inline'\n\n/**\n * Theme-owned overlay root plumbing: applies shared overlay styles to a theme\n * root and lazily creates the document-level fallback overlay root.\n */\nconst FALLBACK_ROOT_ATTRIBUTE = 'data-wui-overlay-root'\n\nconst overlayStyle = `${glass}\\n${toastContainerStyle}\\n${menuPortalStyle}\\n${overlayMotion}`\n\nexport function applyOverlayRootStyles(root: ShadowRoot) {\n  const style = document.createElement('style')\n  style.textContent = overlayStyle\n  root.prepend(style)\n}\n\nexport function getFallbackOverlayRoot(): HTMLElement {\n  const existing = document.querySelector<HTMLElement>(`[${FALLBACK_ROOT_ATTRIBUTE}]`)\n  if (existing?.shadowRoot) return getOverlayContainer(existing.shadowRoot)\n\n  const host = document.createElement('div')\n  host.setAttribute(FALLBACK_ROOT_ATTRIBUTE, '')\n  const root = host.attachShadow({ mode: 'open' })\n  applyOverlayRootStyles(root)\n  document.body.appendChild(host)\n  return getOverlayContainer(root)\n}\n\nexport function getOverlayContainer(root: ShadowRoot): HTMLElement {\n  const existing = root.querySelector<HTMLElement>('[data-wui-overlay-container]')\n  if (existing) return existing\n\n  const container = document.createElement('div')\n  container.setAttribute('data-wui-overlay-container', '')\n  root.appendChild(container)\n  return container\n}\n"],"mappings":";;;;;AASA,IAAM,IAA0B,yBAE1B,IAAe,GAAG,EAAM,IAAI,EAAoB,IAAI,EAAgB,IAAI;AAE9E,SAAgB,EAAuB,GAAkB;CACvD,IAAM,IAAQ,SAAS,cAAc,OAAO;CAE5C,AADA,EAAM,cAAc,GACpB,EAAK,QAAQ,CAAK;AACpB;AAEA,SAAgB,IAAsC;CACpD,IAAM,IAAW,SAAS,cAA2B,IAAI,EAAwB,EAAE;CACnF,IAAI,GAAU,YAAY,OAAO,EAAoB,EAAS,UAAU;CAExE,IAAM,IAAO,SAAS,cAAc,KAAK;CACzC,EAAK,aAAa,GAAyB,EAAE;CAC7C,IAAM,IAAO,EAAK,aAAa,EAAE,MAAM,OAAO,CAAC;CAG/C,OAFA,EAAuB,CAAI,GAC3B,SAAS,KAAK,YAAY,CAAI,GACvB,EAAoB,CAAI;AACjC;AAEA,SAAgB,EAAoB,GAA+B;CACjE,IAAM,IAAW,EAAK,cAA2B,8BAA8B;CAC/E,IAAI,GAAU,OAAO;CAErB,IAAM,IAAY,SAAS,cAAc,KAAK;CAG9C,OAFA,EAAU,aAAa,8BAA8B,EAAE,GACvD,EAAK,YAAY,CAAS,GACnB;AACT"}

package/dist/shared/overlay/overlay.js

@@ -1,7 +1,8 @@
 import { autoUpdate as e, computePosition as t, flip as n, offset as r, shift as i, size as a } from "../../node_modules/.pnpm/@floating-ui_dom@1.8.0/node_modules/@floating-ui/dom/dist/floating-ui.dom.js";
-import { definePlugin as o } from "@greypan/js-kit";
+import { defineOverlayPositioningGeneration as o } from "./positioning-generation.js";
+import { definePlugin as s } from "@greypan/js-kit";
 //#region src/shared/overlay/overlay.ts
-var s = 120, c = "--wui-overlay-min-width", l = {
+var c = 120, l = "--wui-overlay-min-width", u = {
 	placement: "bottom-start",
 	offset: 4,
 	flip: !0,
@@ -10,77 +11,78 @@ var s = 120, c = "--wui-overlay-min-width", l = {
 	minAnchorWidth: !1,
 	strategy: "absolute"
 };
-function u(e) {
-	if (typeof getComputedStyle != "function") return s;
-	let t = Number.parseFloat(getComputedStyle(e).getPropertyValue(c));
-	return Number.isFinite(t) ? t : s;
-}
 function d(e) {
+	if (typeof getComputedStyle != "function") return c;
+	let t = Number.parseFloat(getComputedStyle(e).getPropertyValue(l));
+	return Number.isFinite(t) ? t : c;
+}
+function f(e) {
 	e.style.removeProperty("width"), e.style.removeProperty("min-width");
 }
-function f(e, t, n) {
+function p(e, t, n, r, i) {
+	let o = () => r.isCurrent(i);
 	if (t.matchWidth) return e.style.removeProperty("min-width"), n.hasManagedStyles = !0, a({ apply({ rects: t }) {
-		e.style.width = `${t.reference.width}px`;
+		o() && (e.style.width = `${t.reference.width}px`);
 	} });
 	if (t.minAnchorWidth) {
-		let t = u(e);
+		let t = d(e);
 		return n.hasManagedStyles = !0, a({ apply({ rects: n }) {
-			e.style.width = "max-content", e.style.minWidth = `${Math.max(n.reference.width, t)}px`;
+			o() && (e.style.width = "max-content", e.style.minWidth = `${Math.max(n.reference.width, t)}px`);
 		} });
 	}
-	n.hasManagedStyles &&= (d(e), !1);
+	n.hasManagedStyles &&= (f(e), !1);
 }
-function p(e, t, a) {
-	let o = [r(t.offset)];
-	t.flip && o.push(n()), t.shift && o.push(i({ padding: 8 }));
-	let s = f(e, t, a);
-	return s && o.push(s), o;
+function m(e, t, a, o, s) {
+	let c = [r(t.offset)];
+	t.flip && c.push(n()), t.shift && c.push(i({ padding: 8 }));
+	let l = p(e, t, a, o, s);
+	return l && c.push(l), c;
 }
-function m(e) {
+function h(e) {
 	let [t, n] = e.split("-"), r = n === "start" ? "left" : n === "end" ? "right" : "center", i = n === "start" ? "top" : n === "end" ? "bottom" : "center";
 	return t === "top" ? `bottom ${r}` : t === "bottom" ? `top ${r}` : t === "left" ? `right ${i}` : `left ${i}`;
 }
-var h = () => o((n) => {
+var g = () => s((n) => {
 	let r = {
-		placement: n.placement ?? l.placement,
-		offset: n.offset ?? l.offset,
-		flip: n.flip ?? l.flip,
-		shift: n.shift ?? l.shift,
-		matchWidth: n.matchWidth ?? l.matchWidth,
-		minAnchorWidth: n.minAnchorWidth ?? l.minAnchorWidth,
-		strategy: n.strategy ?? l.strategy
-	}, i = n.overlay, a = { hasManagedStyles: !1 }, o = !1, s = null, c = n.anchor;
-	function u() {
-		let n = p(i, r, a), o = () => {
-			t(c, i, {
+		placement: n.placement ?? u.placement,
+		offset: n.offset ?? u.offset,
+		flip: n.flip ?? u.flip,
+		shift: n.shift ?? u.shift,
+		matchWidth: n.matchWidth ?? u.matchWidth,
+		minAnchorWidth: n.minAnchorWidth ?? u.minAnchorWidth,
+		strategy: n.strategy ?? u.strategy
+	}, i = n.overlay, a = { hasManagedStyles: !1 }, s = !1, c = null, l = n.anchor, d = o().make();
+	function f() {
+		let n = d.next(), o = m(i, r, a, d, n), u = () => {
+			t(l, i, {
 				placement: r.placement,
 				strategy: r.strategy,
-				middleware: n
-			}).then(({ x: e, y: t, placement: n }) => {
-				i.style.left = `${e}px`, i.style.top = `${t}px`, i.style.setProperty("--wui-internal-overlay-transform-origin", m(n));
+				middleware: o
+			}).then(({ x: e, y: t, placement: r }) => {
+				!d.isCurrent(n) || !s || (i.style.left = `${e}px`, i.style.top = `${t}px`, i.style.setProperty("--wui-internal-overlay-transform-origin", h(r)));
 			});
 		};
-		o(), s?.(), s = e(c, i, o);
+		u(), c?.(), c = e(l, i, u);
 	}
 	return {
 		isOpen() {
-			return o;
+			return s;
 		},
 		options: r,
 		open() {
-			o || (o = !0, i.style.display = "", u());
+			s || (s = !0, i.style.display = "", f());
 		},
 		close() {
-			o && (o = !1, s?.(), s = null);
+			s && (s = !1, d.invalidate(), c?.(), c = null);
 		},
 		toggle() {
-			o ? this.close() : this.open();
+			s ? this.close() : this.open();
 		},
 		update(e) {
-			Object.assign(r, e), o && u();
+			Object.assign(r, e), s && f();
 		},
 		updateAnchor(e) {
-			c = e, o && u();
+			l = e, s && f();
 		},
 		dispose() {
 			this.close();
@@ -88,6 +90,6 @@ var h = () => o((n) => {
 	};
 });
 //#endregion
-export { h as defineOverlay };
+export { g as defineOverlay };
 
 //# sourceMappingURL=overlay.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"overlay.js","names":[],"sources":["../../../src/shared/overlay/overlay.ts"],"sourcesContent":["import {\n  autoUpdate,\n  computePosition,\n  flip,\n  offset,\n  shift,\n  size,\n  type Middleware,\n  type Placement,\n  type Strategy\n} from '@floating-ui/dom'\nimport { definePlugin } from '@greypan/js-kit'\n\nexport interface OverlayOptions {\n  placement?: Placement\n  offset?: number\n  flip?: boolean\n  shift?: boolean\n  /** 面板宽度与锚点宽度保持一致。 */\n  matchWidth?: boolean\n  /** 面板至少与锚点同宽，同时允许内容将面板撑宽。 */\n  minAnchorWidth?: boolean\n  strategy?: Strategy\n}\n\n/** 虚拟锚点：无对应 DOM 元素的定位基准。context-menu 未走 defineOverlay（定位语义分歧见 ADR-0046）。 */\nexport interface OverlayVirtualAnchor {\n  getBoundingClientRect(): DOMRect\n}\n\nexport type OverlayAnchor = HTMLElement | OverlayVirtualAnchor\n\nexport interface OverlayApi {\n  isOpen(): boolean\n  readonly options: Required<OverlayOptions>\n  open(): void\n  close(): void\n  toggle(): void\n  update(options: Partial<OverlayOptions>): void\n  updateAnchor(anchor: OverlayAnchor): void\n  dispose(): void\n}\n\nconst DEFAULT_OVERLAY_MIN_WIDTH = 120\nconst OVERLAY_MIN_WIDTH_VARIABLE = '--wui-overlay-min-width'\n\nconst DEFAULT_OPTIONS: Required<OverlayOptions> = {\n  placement: 'bottom-start',\n  offset: 4,\n  flip: true,\n  shift: true,\n  matchWidth: false,\n  minAnchorWidth: false,\n  strategy: 'absolute'\n}\n\ninterface WidthStyleState {\n  hasManagedStyles: boolean\n}\n\nfunction readOverlayMinWidth(overlay: HTMLElement): number {\n  if (typeof getComputedStyle !== 'function') return DEFAULT_OVERLAY_MIN_WIDTH\n\n  const minWidth = Number.parseFloat(getComputedStyle(overlay).getPropertyValue(OVERLAY_MIN_WIDTH_VARIABLE))\n  return Number.isFinite(minWidth) ? minWidth : DEFAULT_OVERLAY_MIN_WIDTH\n}\n\nfunction clearManagedWidthStyles(overlay: HTMLElement) {\n  overlay.style.removeProperty('width')\n  overlay.style.removeProperty('min-width')\n}\n\nfunction createWidthMiddleware(\n  overlay: HTMLElement,\n  options: Required<OverlayOptions>,\n  widthStyles: WidthStyleState\n): Middleware | undefined {\n  if (options.matchWidth) {\n    // matchWidth 必须移除之前 minAnchorWidth 写入的 min-width，才能精确跟随 trigger。\n    overlay.style.removeProperty('min-width')\n    widthStyles.hasManagedStyles = true\n    return size({\n      apply({ rects }) {\n        overlay.style.width = `${rects.reference.width}px`\n      }\n    })\n  }\n\n  if (options.minAnchorWidth) {\n    const minWidth = readOverlayMinWidth(overlay)\n    widthStyles.hasManagedStyles = true\n    return size({\n      apply({ rects }) {\n        // max-content 让内容决定宽度，min-width 再提供 trigger 与 floor 两个下限。\n        overlay.style.width = 'max-content'\n        overlay.style.minWidth = `${Math.max(rects.reference.width, minWidth)}px`\n      }\n    })\n  }\n\n  if (widthStyles.hasManagedStyles) {\n    clearManagedWidthStyles(overlay)\n    widthStyles.hasManagedStyles = false\n  }\n\n  return undefined\n}\n\nfunction createPositioningMiddleware(\n  overlay: HTMLElement,\n  options: Required<OverlayOptions>,\n  widthStyles: WidthStyleState\n): Middleware[] {\n  const middleware: Middleware[] = [offset(options.offset)]\n  if (options.flip) middleware.push(flip())\n  if (options.shift) middleware.push(shift({ padding: 8 }))\n\n  const widthMiddleware = createWidthMiddleware(overlay, options, widthStyles)\n  if (widthMiddleware) middleware.push(widthMiddleware)\n\n  return middleware\n}\n\nfunction getTransformOrigin(placement: Placement): string {\n  const [side, alignment] = placement.split('-')\n  const horizontalOrigin = alignment === 'start' ? 'left' : alignment === 'end' ? 'right' : 'center'\n  const verticalOrigin = alignment === 'start' ? 'top' : alignment === 'end' ? 'bottom' : 'center'\n\n  if (side === 'top') return `bottom ${horizontalOrigin}`\n  if (side === 'bottom') return `top ${horizontalOrigin}`\n  if (side === 'left') return `right ${verticalOrigin}`\n  return `left ${verticalOrigin}`\n}\n\nexport const defineOverlay = () =>\n  definePlugin<OverlayApi, { anchor: OverlayAnchor; overlay: HTMLElement } & OverlayOptions>(ctx => {\n    const options: Required<OverlayOptions> = {\n      placement: ctx.placement ?? DEFAULT_OPTIONS.placement,\n      offset: ctx.offset ?? DEFAULT_OPTIONS.offset,\n      flip: ctx.flip ?? DEFAULT_OPTIONS.flip,\n      shift: ctx.shift ?? DEFAULT_OPTIONS.shift,\n      matchWidth: ctx.matchWidth ?? DEFAULT_OPTIONS.matchWidth,\n      minAnchorWidth: ctx.minAnchorWidth ?? DEFAULT_OPTIONS.minAnchorWidth,\n      strategy: ctx.strategy ?? DEFAULT_OPTIONS.strategy\n    }\n\n    const overlay = ctx.overlay\n    const widthStyles: WidthStyleState = { hasManagedStyles: false }\n    let isOpen = false\n    let cleanupAutoUpdate: (() => void) | null = null\n    let currentAnchor = ctx.anchor\n\n    function updatePosition() {\n      const middleware = createPositioningMiddleware(overlay, options, widthStyles)\n\n      const applyPosition = () => {\n        void computePosition(currentAnchor, overlay, {\n          placement: options.placement,\n          strategy: options.strategy,\n          middleware\n        }).then(({ x, y, placement }) => {\n          overlay.style.left = `${x}px`\n          overlay.style.top = `${y}px`\n          overlay.style.setProperty('--wui-internal-overlay-transform-origin', getTransformOrigin(placement))\n        })\n      }\n\n      // 立即定位一次，避免浮层首帧出现在左上角；autoUpdate 负责后续滚动/尺寸变化。\n      applyPosition()\n      cleanupAutoUpdate?.()\n      cleanupAutoUpdate = autoUpdate(currentAnchor, overlay, applyPosition)\n    }\n\n    return {\n      isOpen() {\n        return isOpen\n      },\n      options,\n\n      open() {\n        if (isOpen) return\n        isOpen = true\n        overlay.style.display = ''\n        updatePosition()\n      },\n\n      close() {\n        if (!isOpen) return\n        isOpen = false\n        cleanupAutoUpdate?.()\n        cleanupAutoUpdate = null\n      },\n\n      toggle() {\n        if (isOpen) this.close()\n        else this.open()\n      },\n\n      update(nextOptions) {\n        Object.assign(options, nextOptions)\n        if (isOpen) updatePosition()\n      },\n\n      updateAnchor(newAnchor: OverlayAnchor) {\n        currentAnchor = newAnchor\n        if (isOpen) updatePosition()\n      },\n\n      dispose() {\n        this.close()\n      }\n    }\n  })\n"],"mappings":"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"}
+{"version":3,"file":"overlay.js","names":[],"sources":["../../../src/shared/overlay/overlay.ts"],"sourcesContent":["import {\n  autoUpdate,\n  computePosition,\n  flip,\n  offset,\n  shift,\n  size,\n  type Middleware,\n  type Placement,\n  type Strategy\n} from '@floating-ui/dom'\nimport { definePlugin } from '@greypan/js-kit'\n\nimport { defineOverlayPositioningGeneration, type OverlayPositioningGeneration } from './positioning-generation'\n\nexport interface OverlayOptions {\n  placement?: Placement\n  offset?: number\n  flip?: boolean\n  shift?: boolean\n  /** 面板宽度与锚点宽度保持一致。 */\n  matchWidth?: boolean\n  /** 面板至少与锚点同宽，同时允许内容将面板撑宽。 */\n  minAnchorWidth?: boolean\n  strategy?: Strategy\n}\n\n/** 虚拟锚点：无对应 DOM 元素的定位基准。context-menu 未走 defineOverlay（定位语义分歧见 ADR-0038）。 */\nexport interface OverlayVirtualAnchor {\n  getBoundingClientRect(): DOMRect\n}\n\nexport type OverlayAnchor = HTMLElement | OverlayVirtualAnchor\n\nexport interface OverlayApi {\n  isOpen(): boolean\n  readonly options: Required<OverlayOptions>\n  open(): void\n  close(): void\n  toggle(): void\n  update(options: Partial<OverlayOptions>): void\n  updateAnchor(anchor: OverlayAnchor): void\n  dispose(): void\n}\n\nconst DEFAULT_OVERLAY_MIN_WIDTH = 120\nconst OVERLAY_MIN_WIDTH_VARIABLE = '--wui-overlay-min-width'\n\nconst DEFAULT_OPTIONS: Required<OverlayOptions> = {\n  placement: 'bottom-start',\n  offset: 4,\n  flip: true,\n  shift: true,\n  matchWidth: false,\n  minAnchorWidth: false,\n  strategy: 'absolute'\n}\n\ninterface WidthStyleState {\n  hasManagedStyles: boolean\n}\n\nfunction readOverlayMinWidth(overlay: HTMLElement): number {\n  if (typeof getComputedStyle !== 'function') return DEFAULT_OVERLAY_MIN_WIDTH\n\n  const minWidth = Number.parseFloat(getComputedStyle(overlay).getPropertyValue(OVERLAY_MIN_WIDTH_VARIABLE))\n  return Number.isFinite(minWidth) ? minWidth : DEFAULT_OVERLAY_MIN_WIDTH\n}\n\nfunction clearManagedWidthStyles(overlay: HTMLElement) {\n  overlay.style.removeProperty('width')\n  overlay.style.removeProperty('min-width')\n}\n\nfunction createWidthMiddleware(\n  overlay: HTMLElement,\n  options: Required<OverlayOptions>,\n  widthStyles: WidthStyleState,\n  positioningGeneration: OverlayPositioningGeneration,\n  generation: number\n): Middleware | undefined {\n  const isCurrentGeneration = () => positioningGeneration.isCurrent(generation)\n  if (options.matchWidth) {\n    // matchWidth 必须移除之前 minAnchorWidth 写入的 min-width，才能精确跟随 trigger。\n    overlay.style.removeProperty('min-width')\n    widthStyles.hasManagedStyles = true\n    return size({\n      apply({ rects }) {\n        if (!isCurrentGeneration()) return\n        overlay.style.width = `${rects.reference.width}px`\n      }\n    })\n  }\n\n  if (options.minAnchorWidth) {\n    const minWidth = readOverlayMinWidth(overlay)\n    widthStyles.hasManagedStyles = true\n    return size({\n      apply({ rects }) {\n        if (!isCurrentGeneration()) return\n        // max-content 让内容决定宽度，min-width 再提供 trigger 与 floor 两个下限。\n        overlay.style.width = 'max-content'\n        overlay.style.minWidth = `${Math.max(rects.reference.width, minWidth)}px`\n      }\n    })\n  }\n\n  if (widthStyles.hasManagedStyles) {\n    clearManagedWidthStyles(overlay)\n    widthStyles.hasManagedStyles = false\n  }\n\n  return undefined\n}\n\nfunction createPositioningMiddleware(\n  overlay: HTMLElement,\n  options: Required<OverlayOptions>,\n  widthStyles: WidthStyleState,\n  positioningGeneration: OverlayPositioningGeneration,\n  generation: number\n): Middleware[] {\n  const middleware: Middleware[] = [offset(options.offset)]\n  if (options.flip) middleware.push(flip())\n  if (options.shift) middleware.push(shift({ padding: 8 }))\n\n  const widthMiddleware = createWidthMiddleware(overlay, options, widthStyles, positioningGeneration, generation)\n  if (widthMiddleware) middleware.push(widthMiddleware)\n\n  return middleware\n}\n\nfunction getTransformOrigin(placement: Placement): string {\n  const [side, alignment] = placement.split('-')\n  const horizontalOrigin = alignment === 'start' ? 'left' : alignment === 'end' ? 'right' : 'center'\n  const verticalOrigin = alignment === 'start' ? 'top' : alignment === 'end' ? 'bottom' : 'center'\n\n  if (side === 'top') return `bottom ${horizontalOrigin}`\n  if (side === 'bottom') return `top ${horizontalOrigin}`\n  if (side === 'left') return `right ${verticalOrigin}`\n  return `left ${verticalOrigin}`\n}\n\nexport const defineOverlay = () =>\n  definePlugin<OverlayApi, { anchor: OverlayAnchor; overlay: HTMLElement } & OverlayOptions>(ctx => {\n    const options: Required<OverlayOptions> = {\n      placement: ctx.placement ?? DEFAULT_OPTIONS.placement,\n      offset: ctx.offset ?? DEFAULT_OPTIONS.offset,\n      flip: ctx.flip ?? DEFAULT_OPTIONS.flip,\n      shift: ctx.shift ?? DEFAULT_OPTIONS.shift,\n      matchWidth: ctx.matchWidth ?? DEFAULT_OPTIONS.matchWidth,\n      minAnchorWidth: ctx.minAnchorWidth ?? DEFAULT_OPTIONS.minAnchorWidth,\n      strategy: ctx.strategy ?? DEFAULT_OPTIONS.strategy\n    }\n\n    const overlay = ctx.overlay\n    const widthStyles: WidthStyleState = { hasManagedStyles: false }\n    let isOpen = false\n    let cleanupAutoUpdate: (() => void) | null = null\n    let currentAnchor = ctx.anchor\n    // 每次刷新都是新定位代；open 期间 autoUpdate 的多次回调属于同一代。\n    // reposition/close 会让上一代 promise 失效，避免乱序完成覆盖最新坐标。\n    const positioningGeneration = defineOverlayPositioningGeneration().make()\n\n    function updatePosition() {\n      const generation = positioningGeneration.next()\n      const middleware = createPositioningMiddleware(overlay, options, widthStyles, positioningGeneration, generation)\n\n      const applyPosition = () => {\n        void computePosition(currentAnchor, overlay, {\n          placement: options.placement,\n          strategy: options.strategy,\n          middleware\n        }).then(({ x, y, placement }) => {\n          if (!positioningGeneration.isCurrent(generation) || !isOpen) return\n          overlay.style.left = `${x}px`\n          overlay.style.top = `${y}px`\n          overlay.style.setProperty('--wui-internal-overlay-transform-origin', getTransformOrigin(placement))\n        })\n      }\n\n      // 立即定位一次，避免浮层首帧出现在左上角；autoUpdate 负责后续滚动/尺寸变化。\n      applyPosition()\n      cleanupAutoUpdate?.()\n      cleanupAutoUpdate = autoUpdate(currentAnchor, overlay, applyPosition)\n    }\n\n    return {\n      isOpen() {\n        return isOpen\n      },\n      options,\n\n      open() {\n        if (isOpen) return\n        isOpen = true\n        overlay.style.display = ''\n        updatePosition()\n      },\n\n      close() {\n        if (!isOpen) return\n        isOpen = false\n        positioningGeneration.invalidate()\n        cleanupAutoUpdate?.()\n        cleanupAutoUpdate = null\n      },\n\n      toggle() {\n        if (isOpen) this.close()\n        else this.open()\n      },\n\n      update(nextOptions) {\n        Object.assign(options, nextOptions)\n        if (isOpen) updatePosition()\n      },\n\n      updateAnchor(newAnchor: OverlayAnchor) {\n        currentAnchor = newAnchor\n        if (isOpen) updatePosition()\n      },\n\n      dispose() {\n        this.close()\n      }\n    }\n  })\n"],"mappings":"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"}

package/dist/shared/overlay/placement-props.js

@@ -0,0 +1,19 @@
+//#region src/shared/overlay/placement-props.ts
+var e = [
+	"top",
+	"top-start",
+	"top-end",
+	"bottom",
+	"bottom-start",
+	"bottom-end",
+	"left",
+	"left-start",
+	"left-end",
+	"right",
+	"right-start",
+	"right-end"
+];
+//#endregion
+export { e as FLOATING_PLACEMENTS };
+
+//# sourceMappingURL=placement-props.js.map

package/dist/shared/overlay/placement-props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"placement-props.js","names":[],"sources":["../../../src/shared/overlay/placement-props.ts"],"sourcesContent":["/**\n * Floating UI anchored overlay 组件共享的 placement 白名单。\n *\n * 12 个方向成员相同、声明顺序在各组件历史上有差异；normalizeLiteral 只做\n * 成员判定，顺序不参与语义，因此这里以稳定顺序单源化，组件不再各自声明。\n */\nexport const FLOATING_PLACEMENTS = [\n  'top',\n  'top-start',\n  'top-end',\n  'bottom',\n  'bottom-start',\n  'bottom-end',\n  'left',\n  'left-start',\n  'left-end',\n  'right',\n  'right-start',\n  'right-end'\n] as const\n\nexport type FloatingPlacement = (typeof FLOATING_PLACEMENTS)[number]\n"],"mappings":";AAMA,IAAa,IAAsB;CACjC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF"}