@greypan/web-ui 3.0.0 → 4.0.0

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

@@ -0,0 +1,65 @@
+import { definePlugin as e } from "@greypan/js-kit";
+//#region src/shared/option-portal/index.ts
+var t = "web-ui-option", n = () => e((e) => {
+	let n = /* @__PURE__ */ new Set(), r = /* @__PURE__ */ new WeakMap(), i = 0, a = (t) => {
+		e.bindOption(t), t.addEventListener("option-unregister", s);
+	}, o = (t) => {
+		e.unbindOption(t), t.removeEventListener("option-unregister", s);
+	}, s = (e) => {
+		e.target instanceof HTMLElement && e.target.localName === t && n.add(e.target), l.scheduleRefresh();
+	}, c = () => {
+		l.scheduleRefresh();
+	}, l = {
+		queryOptions() {
+			let n = e.getPortal()?.panel ?? e.getPortalContent(), r = n ? [...n.querySelectorAll(t)] : [];
+			return r.length > 0 ? r : [...e.element.querySelectorAll(t)];
+		},
+		refresh(e, t) {
+			let n = l.queryOptions();
+			for (let t of e) n.includes(t) || o(t);
+			return n.forEach(a), {
+				options: n,
+				activeIndex: t && n.includes(t) ? n.indexOf(t) : -1
+			};
+		},
+		ensureOptionIds(t) {
+			let n = new Set(t.map((e) => e.id).filter((e) => !!e));
+			t.forEach((t) => {
+				if (t.id) return;
+				let a = r.get(t);
+				if (!a || n.has(a)) {
+					do
+						a = `${e.idPrefix}-option-${++i}`;
+					while (n.has(a));
+					r.set(t, a);
+				}
+				t.id = a, n.add(a);
+			});
+		},
+		syncPortalContent() {
+			let t = e.getPortal(), r = e.getPortalContent();
+			if (!t || !r) return;
+			for (let i of n) !r.contains(i) && !e.element.contains(i) && t.removeContent([i]);
+			if (n.clear(), !e.isOpen()) return;
+			let i = e.getMigratableNodes();
+			i.length && t.appendContent(i, r);
+		},
+		scheduleRefresh() {
+			queueMicrotask(() => {
+				e.element.isConnected && (l.syncPortalContent(), e.requestUpdate(), e.isOpen() && e.hasUpdated() && e.onImmediateSync?.());
+			});
+		},
+		handleOptionUnregister: s,
+		bindHost() {
+			e.element.addEventListener("option-register", c), e.element.addEventListener("option-unregister", s);
+		},
+		dispose() {
+			e.element.removeEventListener("option-register", c), e.element.removeEventListener("option-unregister", s), n.clear();
+		}
+	};
+	return l;
+});
+//#endregion
+export { n as defineOptionPortal };
+
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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        const nodes = host.getMigratableNodes()\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;GAIpB,IAAM,IAAQ,EAAK,mBAAmB;GACtC,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/overlay.js

@@ -57,7 +57,7 @@ var h = () => o((n) => {
 				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-overlay-transform-origin", m(n));
+				i.style.left = `${e}px`, i.style.top = `${t}px`, i.style.setProperty("--wui-internal-overlay-transform-origin", m(n));
 			});
 		};
 		o(), s?.(), s = e(c, i, o);

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 元素的定位基准（如右键菜单的鼠标坐标）。 */\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-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\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 元素的定位基准（如右键菜单的鼠标坐标）。 */\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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"}

package/dist/shared/overlay/portal.js

@@ -8,29 +8,32 @@ var i = () => r((e) => {
 	let n = t.attachShadow({ mode: "open" }), r = document.createElement("style");
 	r.textContent = e.style;
 	let i = document.createElement("div");
-	i.className = e.className, i.dataset.wuiPresence = "entering", n.append(r, i), a(e.container, e.target).appendChild(t);
-	let o = [], s = (e) => {
+	i.className = e.className, i.dataset.wuiPresence = "entering", n.append(r, i);
+	let o = [], s = new MutationObserver(() => e.onContentChange?.()), c = (e) => {
 		e.forEach((e) => {
 			let t = o.indexOf(e);
 			t >= 0 && o.splice(t, 1);
 		});
 	};
-	return {
+	return a(e.container, e.target).appendChild(t), e.onContentChange && s.observe(i, {
+		childList: !0,
+		subtree: !0
+	}), {
 		panel: i,
 		moveContent(e, t = i) {
 			o.splice(0, o.length, ...e), t.append(...o);
 		},
 		appendContent(e, t = i) {
-			s(e), o.push(...e), t.append(...e);
+			c(e), o.push(...e), t.append(...e);
 		},
 		removeContent(e) {
-			s(e);
+			c(e);
 		},
 		restoreContent() {
 			e.target.append(...o), o.length = 0;
 		},
 		remove() {
-			t.remove();
+			s.disconnect(), t.remove();
 		}
 	};
 });

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

@@ -1 +1 @@
-{"version":3,"file":"portal.js","names":[],"sources":["../../../src/shared/overlay/portal.ts"],"sourcesContent":["import { definePlugin } from '@greypan/js-kit'\n\nimport { getFallbackOverlayRoot } from '@/shared/theme/overlay-root'\nimport { findNearestTheme, findRootTheme } from '@/shared/theme/theme-scope'\n\nexport type OverlayContainer = HTMLElement | (() => HTMLElement | undefined)\n\nexport interface OverlayContainerResolutionOptions {\n  /** 无 target 时优先使用文档中的 root theme。 */\n  preferRootTheme?: boolean\n}\n\nexport interface OverlayPortalOptions {\n  container?: OverlayContainer\n  target: Element\n  style: string\n  className: string\n}\n\nexport interface OverlayPortal {\n  readonly panel: HTMLElement\n  restoreContent(): void\n  moveContent(nodes: Node[], target?: HTMLElement): void\n  appendContent(nodes: Node[], target?: HTMLElement): void\n  removeContent(nodes: Node[]): void\n  remove(): void\n}\n\n/**\n * 构建带 Shadow DOM 样式边界的 Portal 面板，并追踪被迁移的内容节点以便恢复。\n */\nexport const defineOverlayPortal = () =>\n  definePlugin<OverlayPortal, OverlayPortalOptions>(ctx => {\n    const host = document.createElement('div')\n    // :host 规则可能让宿主在 overlay 容器中生成行盒；display: contents 保留面板定位而不参与布局。\n    host.style.display = 'contents'\n\n    const root = host.attachShadow({ mode: 'open' })\n    const style = document.createElement('style')\n    style.textContent = ctx.style\n    const panel = document.createElement('div')\n    panel.className = ctx.className\n    panel.dataset.wuiPresence = 'entering'\n    root.append(style, panel)\n\n    resolveOverlayContainer(ctx.container, ctx.target).appendChild(host)\n\n    const trackedNodes: Node[] = []\n    const untrackNodes = (nodes: Node[]) => {\n      nodes.forEach(node => {\n        const index = trackedNodes.indexOf(node)\n        if (index >= 0) trackedNodes.splice(index, 1)\n      })\n    }\n\n    return {\n      panel,\n\n      moveContent(nodes, target = panel) {\n        trackedNodes.splice(0, trackedNodes.length, ...nodes)\n        target.append(...trackedNodes)\n      },\n\n      appendContent(nodes, target = panel) {\n        untrackNodes(nodes)\n        trackedNodes.push(...nodes)\n        target.append(...nodes)\n      },\n\n      removeContent(nodes) {\n        untrackNodes(nodes)\n      },\n\n      restoreContent() {\n        ctx.target.append(...trackedNodes)\n        trackedNodes.length = 0\n      },\n\n      remove() {\n        host.remove()\n      }\n    }\n  })\n\nexport function resolveOverlayContainer(\n  container: OverlayContainer | undefined,\n  target: Element,\n  options: OverlayContainerResolutionOptions = {}\n): HTMLElement {\n  const explicit = typeof container === 'function' ? container() : container\n  if (explicit) return explicit\n\n  // 无 target 的调用（如菜单）优先使用 root theme；有 target 时使用最近的 theme。\n  const theme = options.preferRootTheme ? findRootTheme() : findNearestTheme(target)\n  return theme?.getOverlayRoot() ?? getFallbackOverlayRoot()\n}\n"],"mappings":";;;;AA+BA,IAAa,UACX,GAAkD,MAAO;CACvD,IAAM,IAAO,SAAS,cAAc,KAAK;CAEzC,EAAK,MAAM,UAAU;CAErB,IAAM,IAAO,EAAK,aAAa,EAAE,MAAM,OAAO,CAAC,GACzC,IAAQ,SAAS,cAAc,OAAO;CAC5C,EAAM,cAAc,EAAI;CACxB,IAAM,IAAQ,SAAS,cAAc,KAAK;CAK1C,AAJA,EAAM,YAAY,EAAI,WACtB,EAAM,QAAQ,cAAc,YAC5B,EAAK,OAAO,GAAO,CAAK,GAExB,EAAwB,EAAI,WAAW,EAAI,MAAM,CAAC,CAAC,YAAY,CAAI;CAEnE,IAAM,IAAuB,CAAC,GACxB,KAAgB,MAAkB;EACtC,EAAM,SAAQ,MAAQ;GACpB,IAAM,IAAQ,EAAa,QAAQ,CAAI;GACvC,AAAI,KAAS,KAAG,EAAa,OAAO,GAAO,CAAC;EAC9C,CAAC;CACH;CAEA,OAAO;EACL;EAEA,YAAY,GAAO,IAAS,GAAO;GAEjC,AADA,EAAa,OAAO,GAAG,EAAa,QAAQ,GAAG,CAAK,GACpD,EAAO,OAAO,GAAG,CAAY;EAC/B;EAEA,cAAc,GAAO,IAAS,GAAO;GAGnC,AAFA,EAAa,CAAK,GAClB,EAAa,KAAK,GAAG,CAAK,GAC1B,EAAO,OAAO,GAAG,CAAK;EACxB;EAEA,cAAc,GAAO;GACnB,EAAa,CAAK;EACpB;EAEA,iBAAiB;GAEf,AADA,EAAI,OAAO,OAAO,GAAG,CAAY,GACjC,EAAa,SAAS;EACxB;EAEA,SAAS;GACP,EAAK,OAAO;EACd;CACF;AACF,CAAC;AAEH,SAAgB,EACd,GACA,GACA,IAA6C,CAAC,GACjC;CAMb,QALiB,OAAO,KAAc,aAAa,EAAU,IAAI,QAInD,EAAQ,kBAAkB,EAAc,IAAI,EAAiB,CAAM,EAAA,EACnE,eAAe,KAAK,EAAuB;AAC3D"}
+{"version":3,"file":"portal.js","names":[],"sources":["../../../src/shared/overlay/portal.ts"],"sourcesContent":["import { definePlugin } from '@greypan/js-kit'\n\nimport { getFallbackOverlayRoot } from '@/shared/theme/overlay-root'\nimport { findNearestTheme, findRootTheme } from '@/shared/theme/theme-scope'\n\nexport type OverlayContainer = HTMLElement | (() => HTMLElement | undefined)\n\nexport interface OverlayContainerResolutionOptions {\n  /** 无 target 时优先使用文档中的 root theme。 */\n  preferRootTheme?: boolean\n}\n\nexport interface OverlayPortalOptions {\n  container?: OverlayContainer\n  target: Element\n  style: string\n  className: string\n  onContentChange?: () => void\n}\n\nexport interface OverlayPortal {\n  readonly panel: HTMLElement\n  restoreContent(): void\n  moveContent(nodes: Node[], target?: HTMLElement): void\n  appendContent(nodes: Node[], target?: HTMLElement): void\n  removeContent(nodes: Node[]): void\n  remove(): void\n}\n\n/**\n * 构建带 Shadow DOM 样式边界的 Portal 面板，并追踪被迁移的内容节点以便恢复。\n */\nexport const defineOverlayPortal = () =>\n  definePlugin<OverlayPortal, OverlayPortalOptions>(ctx => {\n    const host = document.createElement('div')\n    // :host 规则可能让宿主在 overlay 容器中生成行盒；display: contents 保留面板定位而不参与布局。\n    host.style.display = 'contents'\n\n    const root = host.attachShadow({ mode: 'open' })\n    const style = document.createElement('style')\n    style.textContent = ctx.style\n    const panel = document.createElement('div')\n    panel.className = ctx.className\n    panel.dataset.wuiPresence = 'entering'\n    root.append(style, panel)\n\n    const trackedNodes: Node[] = []\n    const contentObserver = new MutationObserver(() => ctx.onContentChange?.())\n    const untrackNodes = (nodes: Node[]) => {\n      nodes.forEach(node => {\n        const index = trackedNodes.indexOf(node)\n        if (index >= 0) trackedNodes.splice(index, 1)\n      })\n    }\n\n    resolveOverlayContainer(ctx.container, ctx.target).appendChild(host)\n    if (ctx.onContentChange) contentObserver.observe(panel, { childList: true, subtree: true })\n\n    return {\n      panel,\n\n      moveContent(nodes, target = panel) {\n        trackedNodes.splice(0, trackedNodes.length, ...nodes)\n        target.append(...trackedNodes)\n      },\n\n      appendContent(nodes, target = panel) {\n        untrackNodes(nodes)\n        trackedNodes.push(...nodes)\n        target.append(...nodes)\n      },\n\n      removeContent(nodes) {\n        untrackNodes(nodes)\n      },\n\n      restoreContent() {\n        ctx.target.append(...trackedNodes)\n        trackedNodes.length = 0\n      },\n\n      remove() {\n        contentObserver.disconnect()\n        host.remove()\n      }\n    }\n  })\n\nexport function resolveOverlayContainer(\n  container: OverlayContainer | undefined,\n  target: Element,\n  options: OverlayContainerResolutionOptions = {}\n): HTMLElement {\n  const explicit = typeof container === 'function' ? container() : container\n  if (explicit) return explicit\n\n  // 无 target 的调用（如菜单）优先使用 root theme；有 target 时使用最近的 theme。\n  const theme = options.preferRootTheme ? findRootTheme() : findNearestTheme(target)\n  return theme?.getOverlayRoot() ?? getFallbackOverlayRoot()\n}\n"],"mappings":";;;;AAgCA,IAAa,UACX,GAAkD,MAAO;CACvD,IAAM,IAAO,SAAS,cAAc,KAAK;CAEzC,EAAK,MAAM,UAAU;CAErB,IAAM,IAAO,EAAK,aAAa,EAAE,MAAM,OAAO,CAAC,GACzC,IAAQ,SAAS,cAAc,OAAO;CAC5C,EAAM,cAAc,EAAI;CACxB,IAAM,IAAQ,SAAS,cAAc,KAAK;CAG1C,AAFA,EAAM,YAAY,EAAI,WACtB,EAAM,QAAQ,cAAc,YAC5B,EAAK,OAAO,GAAO,CAAK;CAExB,IAAM,IAAuB,CAAC,GACxB,IAAkB,IAAI,uBAAuB,EAAI,kBAAkB,CAAC,GACpE,KAAgB,MAAkB;EACtC,EAAM,SAAQ,MAAQ;GACpB,IAAM,IAAQ,EAAa,QAAQ,CAAI;GACvC,AAAI,KAAS,KAAG,EAAa,OAAO,GAAO,CAAC;EAC9C,CAAC;CACH;CAKA,OAHA,EAAwB,EAAI,WAAW,EAAI,MAAM,CAAC,CAAC,YAAY,CAAI,GAC/D,EAAI,mBAAiB,EAAgB,QAAQ,GAAO;EAAE,WAAW;EAAM,SAAS;CAAK,CAAC,GAEnF;EACL;EAEA,YAAY,GAAO,IAAS,GAAO;GAEjC,AADA,EAAa,OAAO,GAAG,EAAa,QAAQ,GAAG,CAAK,GACpD,EAAO,OAAO,GAAG,CAAY;EAC/B;EAEA,cAAc,GAAO,IAAS,GAAO;GAGnC,AAFA,EAAa,CAAK,GAClB,EAAa,KAAK,GAAG,CAAK,GAC1B,EAAO,OAAO,GAAG,CAAK;EACxB;EAEA,cAAc,GAAO;GACnB,EAAa,CAAK;EACpB;EAEA,iBAAiB;GAEf,AADA,EAAI,OAAO,OAAO,GAAG,CAAY,GACjC,EAAa,SAAS;EACxB;EAEA,SAAS;GAEP,AADA,EAAgB,WAAW,GAC3B,EAAK,OAAO;EACd;CACF;AACF,CAAC;AAEH,SAAgB,EACd,GACA,GACA,IAA6C,CAAC,GACjC;CAMb,QALiB,OAAO,KAAc,aAAa,EAAU,IAAI,QAInD,EAAQ,kBAAkB,EAAc,IAAI,EAAiB,CAAM,EAAA,EACnE,eAAe,KAAK,EAAuB;AAC3D"}

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

@@ -1 +1 @@
-{"version":3,"file":"presence.js","names":[],"sources":["../../../src/shared/overlay/presence.ts"],"sourcesContent":["const DEFAULT_EXIT_DURATION = 160\nconst EXIT_FALLBACK_BUFFER = 80\n\nconst pendingExits = new WeakMap<HTMLElement, () => void>()\n\ninterface OverlayPresenceOptions {\n  isInstant?: boolean\n}\n\nfunction parseDuration(value: string): number {\n  const trimmed = value.trim()\n  if (trimmed.endsWith('ms')) return Number.parseFloat(trimmed)\n  if (trimmed.endsWith('s')) return Number.parseFloat(trimmed) * 1000\n  return 0\n}\n\n// 读取元素实际 CSS transition 的最长时长，供可覆盖主题 token 的 JS 生命周期使用。\nexport function getTransitionDuration(panel: HTMLElement, fallback = DEFAULT_EXIT_DURATION): number {\n  const style = getComputedStyle(panel)\n  const durations = style.transitionDuration.split(',').map(parseDuration)\n  const delays = style.transitionDelay.split(',').map(parseDuration)\n  const longest = durations.reduce(\n    (max, duration, index) => Math.max(max, duration + (delays[index] ?? delays[0] ?? 0)),\n    0\n  )\n\n  return longest || fallback\n}\n\n// 以可中断的方式显示浮层，避免快速切换时重启动画。\nexport function showOverlayPresence(panel: HTMLElement, options: OverlayPresenceOptions = {}) {\n  pendingExits.get(panel)?.()\n  panel.hidden = false\n  if (options.isInstant) {\n    panel.dataset.wuiPresence = 'open'\n    return\n  }\n  panel.dataset.wuiPresence = 'entering'\n\n  // Commit the initial state so a newly mounted panel has a transition source.\n  void panel.offsetWidth\n\n  requestAnimationFrame(() => {\n    if (panel.dataset.wuiPresence === 'entering') panel.dataset.wuiPresence = 'open'\n  })\n}\n\n// 播放退出过渡；若在结束前重新显示则返回 false。\nexport function hideOverlayPresence(panel: HTMLElement): Promise<boolean> {\n  pendingExits.get(panel)?.()\n  panel.dataset.wuiPresence = 'closing'\n\n  // jsdom 等没有计算 CSS transition 的环境无需伪造退场等待。\n  if (getTransitionDuration(panel, 0) === 0) {\n    panel.hidden = true\n    return Promise.resolve(true)\n  }\n\n  return new Promise(resolve => {\n    let settled = false\n    const finish = (didClose: boolean) => {\n      if (settled) return\n      settled = true\n      panel.removeEventListener('transitionend', onTransitionEnd)\n      clearTimeout(timeout)\n      pendingExits.delete(panel)\n      if (didClose && panel.dataset.wuiPresence === 'closing') panel.hidden = true\n      resolve(didClose)\n    }\n\n    const onTransitionEnd = (event: TransitionEvent) => {\n      if (event.target === panel && (event.propertyName === 'opacity' || event.propertyName === 'transform'))\n        finish(true)\n    }\n\n    pendingExits.set(panel, () => finish(false))\n    panel.addEventListener('transitionend', onTransitionEnd)\n    const timeout = setTimeout(() => finish(true), getTransitionDuration(panel) + EXIT_FALLBACK_BUFFER)\n  })\n}\n"],"mappings":";AAAA,IAGM,oBAAe,IAAI,QAAiC;AAM1D,SAAS,EAAc,GAAuB;CAC5C,IAAM,IAAU,EAAM,KAAK;CAG3B,OAFI,EAAQ,SAAS,IAAI,IAAU,OAAO,WAAW,CAAO,IACxD,EAAQ,SAAS,GAAG,IAAU,OAAO,WAAW,CAAO,IAAI,MACxD;AACT;AAGA,SAAgB,EAAsB,GAAoB,IAAW,KAA+B;CAClG,IAAM,IAAQ,iBAAiB,CAAK,GAC9B,IAAY,EAAM,mBAAmB,MAAM,GAAG,CAAC,CAAC,IAAI,CAAa,GACjE,IAAS,EAAM,gBAAgB,MAAM,GAAG,CAAC,CAAC,IAAI,CAAa;CAMjE,OALgB,EAAU,QACvB,GAAK,GAAU,MAAU,KAAK,IAAI,GAAK,KAAY,EAAO,MAAU,EAAO,MAAM,EAAE,GACpF,CAGK,KAAW;AACpB;AAGA,SAAgB,EAAoB,GAAoB,IAAkC,CAAC,GAAG;CAG5F,IAFA,EAAa,IAAI,CAAK,CAAC,GAAG,GAC1B,EAAM,SAAS,IACX,EAAQ,WAAW;EACrB,EAAM,QAAQ,cAAc;EAC5B;CACF;CAMA,AALA,EAAM,QAAQ,cAAc,YAG5B,EAAW,aAEX,4BAA4B;EAC1B,AAAI,EAAM,QAAQ,gBAAgB,eAAY,EAAM,QAAQ,cAAc;CAC5E,CAAC;AACH;AAGA,SAAgB,EAAoB,GAAsC;CAUxE,OATA,EAAa,IAAI,CAAK,CAAC,GAAG,GAC1B,EAAM,QAAQ,cAAc,WAGxB,EAAsB,GAAO,CAAC,MAAM,KACtC,EAAM,SAAS,IACR,QAAQ,QAAQ,EAAI,KAGtB,IAAI,SAAQ,MAAW;EAC5B,IAAI,IAAU,IACR,KAAU,MAAsB;GAChC,MACJ,IAAU,IACV,EAAM,oBAAoB,iBAAiB,CAAe,GAC1D,aAAa,CAAO,GACpB,EAAa,OAAO,CAAK,GACrB,KAAY,EAAM,QAAQ,gBAAgB,cAAW,EAAM,SAAS,KACxE,EAAQ,CAAQ;EAClB,GAEM,KAAmB,MAA2B;GAClD,AAAI,EAAM,WAAW,MAAU,EAAM,iBAAiB,aAAa,EAAM,iBAAiB,gBACxF,EAAO,EAAI;EACf;EAGA,AADA,EAAa,IAAI,SAAa,EAAO,EAAK,CAAC,GAC3C,EAAM,iBAAiB,iBAAiB,CAAe;EACvD,IAAM,IAAU,iBAAiB,EAAO,EAAI,GAAG,EAAsB,CAAK,IAAI,EAAoB;CACpG,CAAC;AACH"}
+{"version":3,"file":"presence.js","names":[],"sources":["../../../src/shared/overlay/presence.ts"],"sourcesContent":["const DEFAULT_EXIT_DURATION = 160\nconst EXIT_FALLBACK_BUFFER = 80\n\nconst pendingExits = new WeakMap<HTMLElement, () => void>()\n\ninterface OverlayPresenceOptions {\n  isInstant?: boolean\n}\n\nfunction parseDuration(value: string): number {\n  const trimmed = value.trim()\n  if (trimmed.endsWith('ms')) return Number.parseFloat(trimmed)\n  if (trimmed.endsWith('s')) return Number.parseFloat(trimmed) * 1000\n  return 0\n}\n\n// 读取元素实际 CSS transition 的最长时长，供可覆盖主题 token 的 JS 生命周期使用。\nexport function getTransitionDuration(panel: HTMLElement, fallback = DEFAULT_EXIT_DURATION): number {\n  const style = getComputedStyle(panel)\n  const durations = style.transitionDuration.split(',').map(parseDuration)\n  const delays = style.transitionDelay.split(',').map(parseDuration)\n  const longest = durations.reduce(\n    (max, duration, index) => Math.max(max, duration + (delays[index] ?? delays[0] ?? 0)),\n    0\n  )\n\n  return longest || fallback\n}\n\n// 以可中断的方式显示浮层，避免快速切换时重启动画。\nexport function showOverlayPresence(panel: HTMLElement, options: OverlayPresenceOptions = {}) {\n  pendingExits.get(panel)?.()\n  panel.hidden = false\n  if (options.isInstant) {\n    panel.dataset.wuiPresence = 'open'\n    return\n  }\n  panel.dataset.wuiPresence = 'entering'\n\n  // 提交初始状态，让新挂载的面板拥有过渡起点。\n  void panel.offsetWidth\n\n  requestAnimationFrame(() => {\n    if (panel.dataset.wuiPresence === 'entering') panel.dataset.wuiPresence = 'open'\n  })\n}\n\n// 播放退出过渡；若在结束前重新显示则返回 false。\nexport function hideOverlayPresence(panel: HTMLElement): Promise<boolean> {\n  pendingExits.get(panel)?.()\n  panel.dataset.wuiPresence = 'closing'\n\n  // jsdom 等没有计算 CSS transition 的环境无需伪造退场等待。\n  if (getTransitionDuration(panel, 0) === 0) {\n    panel.hidden = true\n    return Promise.resolve(true)\n  }\n\n  return new Promise(resolve => {\n    let settled = false\n    const finish = (didClose: boolean) => {\n      if (settled) return\n      settled = true\n      panel.removeEventListener('transitionend', onTransitionEnd)\n      clearTimeout(timeout)\n      pendingExits.delete(panel)\n      if (didClose && panel.dataset.wuiPresence === 'closing') panel.hidden = true\n      resolve(didClose)\n    }\n\n    const onTransitionEnd = (event: TransitionEvent) => {\n      if (event.target === panel && (event.propertyName === 'opacity' || event.propertyName === 'transform'))\n        finish(true)\n    }\n\n    pendingExits.set(panel, () => finish(false))\n    panel.addEventListener('transitionend', onTransitionEnd)\n    const timeout = setTimeout(() => finish(true), getTransitionDuration(panel) + EXIT_FALLBACK_BUFFER)\n  })\n}\n"],"mappings":";AAAA,IAGM,oBAAe,IAAI,QAAiC;AAM1D,SAAS,EAAc,GAAuB;CAC5C,IAAM,IAAU,EAAM,KAAK;CAG3B,OAFI,EAAQ,SAAS,IAAI,IAAU,OAAO,WAAW,CAAO,IACxD,EAAQ,SAAS,GAAG,IAAU,OAAO,WAAW,CAAO,IAAI,MACxD;AACT;AAGA,SAAgB,EAAsB,GAAoB,IAAW,KAA+B;CAClG,IAAM,IAAQ,iBAAiB,CAAK,GAC9B,IAAY,EAAM,mBAAmB,MAAM,GAAG,CAAC,CAAC,IAAI,CAAa,GACjE,IAAS,EAAM,gBAAgB,MAAM,GAAG,CAAC,CAAC,IAAI,CAAa;CAMjE,OALgB,EAAU,QACvB,GAAK,GAAU,MAAU,KAAK,IAAI,GAAK,KAAY,EAAO,MAAU,EAAO,MAAM,EAAE,GACpF,CAGK,KAAW;AACpB;AAGA,SAAgB,EAAoB,GAAoB,IAAkC,CAAC,GAAG;CAG5F,IAFA,EAAa,IAAI,CAAK,CAAC,GAAG,GAC1B,EAAM,SAAS,IACX,EAAQ,WAAW;EACrB,EAAM,QAAQ,cAAc;EAC5B;CACF;CAMA,AALA,EAAM,QAAQ,cAAc,YAG5B,EAAW,aAEX,4BAA4B;EAC1B,AAAI,EAAM,QAAQ,gBAAgB,eAAY,EAAM,QAAQ,cAAc;CAC5E,CAAC;AACH;AAGA,SAAgB,EAAoB,GAAsC;CAUxE,OATA,EAAa,IAAI,CAAK,CAAC,GAAG,GAC1B,EAAM,QAAQ,cAAc,WAGxB,EAAsB,GAAO,CAAC,MAAM,KACtC,EAAM,SAAS,IACR,QAAQ,QAAQ,EAAI,KAGtB,IAAI,SAAQ,MAAW;EAC5B,IAAI,IAAU,IACR,KAAU,MAAsB;GAChC,MACJ,IAAU,IACV,EAAM,oBAAoB,iBAAiB,CAAe,GAC1D,aAAa,CAAO,GACpB,EAAa,OAAO,CAAK,GACrB,KAAY,EAAM,QAAQ,gBAAgB,cAAW,EAAM,SAAS,KACxE,EAAQ,CAAQ;EAClB,GAEM,KAAmB,MAA2B;GAClD,AAAI,EAAM,WAAW,MAAU,EAAM,iBAAiB,aAAa,EAAM,iBAAiB,gBACxF,EAAO,EAAI;EACf;EAGA,AADA,EAAa,IAAI,SAAa,EAAO,EAAK,CAAC,GAC3C,EAAM,iBAAiB,iBAAiB,CAAe;EACvD,IAAM,IAAU,iBAAiB,EAAO,EAAI,GAAG,EAAsB,CAAK,IAAI,EAAoB;CACpG,CAAC;AACH"}

package/dist/shared/visible-area/index.js

@@ -0,0 +1,69 @@
+import { definePlugin as e } from "@greypan/js-kit";
+//#region src/shared/visible-area/index.ts
+var t = {
+	top: 0,
+	right: 0,
+	bottom: 0,
+	left: 0,
+	width: 0,
+	height: 0
+};
+function n(e) {
+	if (!e) return t;
+	let n = e.getBoundingClientRect(), r = Math.max(0, n.left), i = Math.max(0, n.top), a = Math.min(window.innerWidth, n.right), o = Math.min(window.innerHeight, n.bottom);
+	return a <= r || o <= i ? t : {
+		top: i,
+		right: a,
+		bottom: o,
+		left: r,
+		width: a - r,
+		height: o - i
+	};
+}
+function r(e, t) {
+	return e?.top === t.top && e.right === t.right && e.bottom === t.bottom && e.left === t.left && e.width === t.width && e.height === t.height;
+}
+function i(t) {
+	return e(() => {
+		let e = null, i, a, o = !1, s, c = () => {
+			if (a = void 0, !o) return;
+			let i = n(e);
+			r(s, i) || (s = i, t.onVisibleAreaChange(i));
+		}, l = () => {
+			!o || a !== void 0 || (a = requestAnimationFrame(c));
+		}, u = () => {
+			i?.disconnect(), i = void 0, !(!e || typeof ResizeObserver > "u") && (i = new ResizeObserver(l), i.observe(e));
+		};
+		return {
+			setTarget(t) {
+				if (e === t) {
+					l();
+					return;
+				}
+				e = t, s = void 0, o && (u(), l());
+			},
+			refresh: l,
+			connect() {
+				o || (o = !0, window.addEventListener("scroll", l, { passive: !0 }), window.addEventListener("resize", l, { passive: !0 }), u(), l());
+			},
+			disconnect() {
+				o && (o = !1, window.removeEventListener("scroll", l), window.removeEventListener("resize", l), i?.disconnect(), i = void 0, s = void 0, a !== void 0 && cancelAnimationFrame(a), a = void 0);
+			}
+		};
+	});
+}
+var a = class {
+	constructor(e, t) {
+		this.tracker = t, e.addController(this);
+	}
+	hostConnected() {
+		this.tracker.connect();
+	}
+	hostDisconnected() {
+		this.tracker.disconnect();
+	}
+};
+//#endregion
+export { a as VisibleAreaController, i as defineVisibleAreaTracker };
+
+//# sourceMappingURL=index.js.map

package/dist/shared/visible-area/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/shared/visible-area/index.ts"],"sourcesContent":["import { definePlugin } from '@greypan/js-kit'\nimport type { ReactiveController, ReactiveControllerHost } from 'lit'\n\nexport interface VisibleArea {\n  readonly top: number\n  readonly right: number\n  readonly bottom: number\n  readonly left: number\n  readonly width: number\n  readonly height: number\n}\n\nexport interface VisibleAreaTracker {\n  setTarget(target: Element | null): void\n  refresh(): void\n  connect(): void\n  disconnect(): void\n}\n\nconst emptyVisibleArea: VisibleArea = {\n  top: 0,\n  right: 0,\n  bottom: 0,\n  left: 0,\n  width: 0,\n  height: 0\n}\n\nfunction getVisibleArea(target: Element | null): VisibleArea {\n  if (!target) return emptyVisibleArea\n\n  const rect = target.getBoundingClientRect()\n  const left = Math.max(0, rect.left)\n  const top = Math.max(0, rect.top)\n  const right = Math.min(window.innerWidth, rect.right)\n  const bottom = Math.min(window.innerHeight, rect.bottom)\n\n  if (right <= left || bottom <= top) return emptyVisibleArea\n\n  return {\n    top,\n    right,\n    bottom,\n    left,\n    width: right - left,\n    height: bottom - top\n  }\n}\n\nfunction visibleAreasEqual(a: VisibleArea | undefined, b: VisibleArea): boolean {\n  return (\n    a?.top === b.top &&\n    a.right === b.right &&\n    a.bottom === b.bottom &&\n    a.left === b.left &&\n    a.width === b.width &&\n    a.height === b.height\n  )\n}\n\n/**\n * 追踪单个元素与浏览器 viewport 的交集区域。\n *\n * 模块统一持有 ResizeObserver、viewport 监听器和 rAF 合帧；\n * 使用方只需管理 target 并响应可见区域变化。\n */\nexport function defineVisibleAreaTracker(options: { readonly onVisibleAreaChange: (area: VisibleArea) => void }) {\n  return definePlugin<VisibleAreaTracker, Record<never, never>>(() => {\n    let target: Element | null = null\n    let observer: ResizeObserver | undefined\n    let frame: number | undefined\n    let connected = false\n    let previousArea: VisibleArea | undefined\n\n    const report = () => {\n      frame = undefined\n      if (!connected) return\n\n      const nextArea = getVisibleArea(target)\n      if (visibleAreasEqual(previousArea, nextArea)) return\n\n      previousArea = nextArea\n      options.onVisibleAreaChange(nextArea)\n    }\n\n    const refresh = () => {\n      if (!connected || frame !== undefined) return\n      frame = requestAnimationFrame(report)\n    }\n\n    const observeTarget = () => {\n      observer?.disconnect()\n      observer = undefined\n\n      if (!target || typeof ResizeObserver === 'undefined') return\n\n      observer = new ResizeObserver(refresh)\n      observer.observe(target)\n    }\n\n    return {\n      setTarget(nextTarget) {\n        if (target === nextTarget) {\n          refresh()\n          return\n        }\n\n        target = nextTarget\n        previousArea = undefined\n        if (!connected) return\n\n        observeTarget()\n        refresh()\n      },\n\n      refresh,\n\n      connect() {\n        if (connected) return\n\n        connected = true\n        window.addEventListener('scroll', refresh, { passive: true })\n        window.addEventListener('resize', refresh, { passive: true })\n        observeTarget()\n        refresh()\n      },\n\n      disconnect() {\n        if (!connected) return\n\n        connected = false\n        window.removeEventListener('scroll', refresh)\n        window.removeEventListener('resize', refresh)\n        observer?.disconnect()\n        observer = undefined\n        previousArea = undefined\n\n        if (frame !== undefined) cancelAnimationFrame(frame)\n        frame = undefined\n      }\n    }\n  })\n}\n\n/** 将内部可见区域追踪器接入 Lit host 生命周期。 */\nexport class VisibleAreaController implements ReactiveController {\n  constructor(\n    host: ReactiveControllerHost,\n    private readonly tracker: VisibleAreaTracker\n  ) {\n    host.addController(this)\n  }\n\n  hostConnected() {\n    this.tracker.connect()\n  }\n\n  hostDisconnected() {\n    this.tracker.disconnect()\n  }\n}\n"],"mappings":";;AAmBA,IAAM,IAAgC;CACpC,KAAK;CACL,OAAO;CACP,QAAQ;CACR,MAAM;CACN,OAAO;CACP,QAAQ;AACV;AAEA,SAAS,EAAe,GAAqC;CAC3D,IAAI,CAAC,GAAQ,OAAO;CAEpB,IAAM,IAAO,EAAO,sBAAsB,GACpC,IAAO,KAAK,IAAI,GAAG,EAAK,IAAI,GAC5B,IAAM,KAAK,IAAI,GAAG,EAAK,GAAG,GAC1B,IAAQ,KAAK,IAAI,OAAO,YAAY,EAAK,KAAK,GAC9C,IAAS,KAAK,IAAI,OAAO,aAAa,EAAK,MAAM;CAIvD,OAFI,KAAS,KAAQ,KAAU,IAAY,IAEpC;EACL;EACA;EACA;EACA;EACA,OAAO,IAAQ;EACf,QAAQ,IAAS;CACnB;AACF;AAEA,SAAS,EAAkB,GAA4B,GAAyB;CAC9E,OACE,GAAG,QAAQ,EAAE,OACb,EAAE,UAAU,EAAE,SACd,EAAE,WAAW,EAAE,UACf,EAAE,SAAS,EAAE,QACb,EAAE,UAAU,EAAE,SACd,EAAE,WAAW,EAAE;AAEnB;AAQA,SAAgB,EAAyB,GAAwE;CAC/G,OAAO,QAA6D;EAClE,IAAI,IAAyB,MACzB,GACA,GACA,IAAY,IACZ,GAEE,UAAe;GAEnB,IADA,IAAQ,KAAA,GACJ,CAAC,GAAW;GAEhB,IAAM,IAAW,EAAe,CAAM;GAClC,EAAkB,GAAc,CAAQ,MAE5C,IAAe,GACf,EAAQ,oBAAoB,CAAQ;EACtC,GAEM,UAAgB;GAChB,CAAC,KAAa,MAAU,KAAA,MAC5B,IAAQ,sBAAsB,CAAM;EACtC,GAEM,UAAsB;GAC1B,GAAU,WAAW,GACrB,IAAW,KAAA,GAEP,GAAC,KAAU,OAAO,iBAAmB,SAEzC,IAAW,IAAI,eAAe,CAAO,GACrC,EAAS,QAAQ,CAAM;EACzB;EAEA,OAAO;GACL,UAAU,GAAY;IACpB,IAAI,MAAW,GAAY;KACzB,EAAQ;KACR;IACF;IAEA,IAAS,GACT,IAAe,KAAA,GACV,MAEL,EAAc,GACd,EAAQ;GACV;GAEA;GAEA,UAAU;IACJ,MAEJ,IAAY,IACZ,OAAO,iBAAiB,UAAU,GAAS,EAAE,SAAS,GAAK,CAAC,GAC5D,OAAO,iBAAiB,UAAU,GAAS,EAAE,SAAS,GAAK,CAAC,GAC5D,EAAc,GACd,EAAQ;GACV;GAEA,aAAa;IACN,MAEL,IAAY,IACZ,OAAO,oBAAoB,UAAU,CAAO,GAC5C,OAAO,oBAAoB,UAAU,CAAO,GAC5C,GAAU,WAAW,GACrB,IAAW,KAAA,GACX,IAAe,KAAA,GAEX,MAAU,KAAA,KAAW,qBAAqB,CAAK,GACnD,IAAQ,KAAA;GACV;EACF;CACF,CAAC;AACH;AAGA,IAAa,IAAb,MAAiE;CAC/D,YACE,GACA,GACA;EACA,AAFiB,KAAA,UAAA,GAEjB,EAAK,cAAc,IAAI;CACzB;CAEA,gBAAgB;EACd,KAAK,QAAQ,QAAQ;CACvB;CAEA,mBAAmB;EACjB,KAAK,QAAQ,WAAW;CAC1B;AACF"}

package/dist/types/utils.d.ts

@@ -32,11 +32,16 @@ export type WithHost<T extends EventTarget, E> = E extends Event ? E & {
 export type HostEventMap<T extends HTMLElement> = {
     [K in keyof ComponentEvents<T>]: WithHost<T, ComponentEvents<T>[K]>;
 };
+/**
+ * 组件 `$events` 中的 string 事件名。
+ * 无公共事件或仅有非 string 键的组件得到 `never`。
+ */
+export type WebUiEventName<T extends HTMLElement> = keyof ComponentEvents<T> & string;
 /**
  * 具名 handler 的显式事件类型，用于 Vue 命名 handler 等无法从上下文推导 `$event` 的位置。
  * 用法：`function onChange(e: WebUiEvent<WebUiSelect, 'change'>)`
  */
-export type WebUiEvent<T extends HTMLElement, K extends keyof HostEventMap<T>> = HostEventMap<T>[K];
+export type WebUiEvent<T extends HTMLElement, K extends WebUiEventName<T>> = HostEventMap<T>[K];
 /**
  * React 自定义事件（kebab-case 事件名）→ `on<event>` 绑定。
  * 标准 DOM 事件（input/change/focus/blur）由 React 的 camelCase handler 提供，

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@greypan/web-ui",
-  "version": "3.0.0",
+  "version": "4.0.0",
   "description": "Lit-based web components for React, Vue, and vanilla JS",
   "license": "MIT",
   "repository": {
@@ -41,12 +41,12 @@
   },
   "dependencies": {
     "@floating-ui/dom": "^1.8.0",
-    "@greypan/js-kit": "1.6.6",
-    "@greypan/browser-kit": "1.7.7"
+    "@greypan/js-kit": "2.0.0",
+    "@greypan/browser-kit": "2.0.0"
   },
   "devDependencies": {
     "@iconify-json/jam": "^1.2.3",
-    "@iconify-json/lucide": "^1.2.117",
+    "@iconify-json/lucide": "^1.2.126",
     "@iconify-json/si": "^1.2.17",
     "@iconify-json/heroicons": "^1.2.3",
     "@iconify-json/ooui": "^1.2.20",
@@ -56,7 +56,9 @@
     "lit": "^3.3.3",
     "vite-plugin-dts": "^5.0.3",
     "vue": "^3.5.39",
-    "@greypan/tsconfig": "1.0.4"
+    "vite": "npm:@voidzero-dev/vite-plus-core@0.3.0",
+    "vite-plus": "0.3.0",
+    "@greypan/tsconfig": "1.0.5"
   },
   "peerDependencies": {
     "@types/react": ">=19",