@moubing/bing-ui 0.11.2 → 0.12.1

package/dist/motion/useTextControlCaret.js

@@ -0,0 +1,136 @@
+import { onBeforeUnmount as e, onMounted as t, onUpdated as n } from "vue";
+import { gsap as r } from "gsap";
+//#region src/motion/useTextControlCaret.ts
+var i = "(prefers-reduced-motion: reduce), (forced-colors: active), (pointer: coarse)", a = new Set([
+	"text",
+	"search",
+	"tel",
+	"url"
+]), o = /[\u0590-\u08ff\u200e\u200f\u202a-\u202e\u2066-\u2069\ufb1d-\ufdff\ufe70-\ufeff]/u, s = [
+	"fontFamily",
+	"fontSize",
+	"fontWeight",
+	"fontStyle",
+	"fontStretch",
+	"fontVariant",
+	"fontKerning",
+	"fontFeatureSettings",
+	"fontVariationSettings",
+	"letterSpacing",
+	"wordSpacing",
+	"textTransform"
+];
+function c(c, l, u, ee) {
+	let d = () => {}, f = () => {};
+	n(() => d()), e(() => f()), t(() => {
+		let e = c.value, t = l.value, n = u.value;
+		if (!e || !t || !n) return;
+		let p = e.tagName === "TEXTAREA", m = () => p || a.has(e.type), h = e.ownerDocument, g = h.defaultView, _ = g.matchMedia(i), v = !1, y = !1, b = !1, x = !1, S = !1, C = 0, w = !1, T = !1, E, D, O, k = "", A = NaN, j = NaN, M = 0, N = 0, P = 0, F, I, L, R = h.createRange();
+		function z() {
+			S && (e.removeAttribute("data-smooth-caret"), n.removeAttribute("data-active")), S = !1, n.classList.contains("is-idle") && n.classList.remove("is-idle"), clearTimeout(E), I?.tween.pause(), L?.tween.pause();
+		}
+		function B() {
+			clearTimeout(E), n.classList.remove("is-idle"), E = setTimeout(() => {
+				S && !x && n.classList.add("is-idle");
+			}, 600);
+		}
+		function V() {
+			C = 0;
+			let i = w, a = T;
+			if (w = T = !1, x) return;
+			let c = y && e.selectionDirection !== "backward" ? e.selectionEnd : e.selectionStart;
+			if (!v || !ee() || e.disabled || e.readOnly || b || _.matches || h.hidden || !h.hasFocus() || h.activeElement !== e || !m() || c === null || !y && c !== e.selectionEnd || o.test(e.value)) {
+				z(), O && !m() && (O.data = "");
+				return;
+			}
+			let l = g.getComputedStyle(e);
+			if (l.direction !== "ltr" || l.writingMode !== "horizontal-tb" || !["start", "left"].includes(l.textAlign) || parseFloat(l.textIndent) !== 0 || !e.clientWidth) {
+				z();
+				return;
+			}
+			D || (D = h.createElement("span"), D.setAttribute("aria-hidden", "true"), D.style.cssText = "position:absolute;left:0;top:0;visibility:hidden;white-space:pre;width:max-content;pointer-events:none;", p && (D.style.cssText = "position:fixed;left:0;top:0;display:block;visibility:hidden;pointer-events:none;box-sizing:content-box;margin:0;padding:0;border:0;direction:ltr;", D.dataset.bingTextareaMeasure = ""), O = h.createTextNode(""), D.append(O), (p ? h.body : t).append(D));
+			let u = s.map((e) => l[e]).join("|");
+			if (k !== u && (s.forEach((e) => {
+				D.style[e] = l[e];
+			}), k = u), p) {
+				let t = e.clientWidth - parseFloat(l.paddingLeft) - parseFloat(l.paddingRight);
+				if (t <= 0) {
+					z();
+					return;
+				}
+				for (let e of [
+					"lineHeight",
+					"whiteSpace",
+					"overflowWrap",
+					"wordBreak",
+					"tabSize"
+				]) D.style[e] !== l[e] && (D.style[e] = l[e]);
+				D.style.width !== `${t}px` && (D.style.width = `${t}px`);
+			}
+			let d = p ? e.value + "​" : e.value || "​";
+			O.data !== d && (O.data = d), R.setStart(O, c), R.collapse(!0);
+			let f = R.getClientRects();
+			if (!f.length) {
+				z();
+				return;
+			}
+			let E = D.getBoundingClientRect(), V = p ? 1 : t.getBoundingClientRect().width / t.clientWidth || 1, H = parseFloat(l.paddingLeft) || 0, U = f[0], W = e.offsetLeft + H + (U.left - E.left) / V - e.scrollLeft, G = Math.min(e.clientHeight, parseFloat(l.fontSize) * 1.2), K = parseFloat(l.lineHeight) || U.height, q = Math.max(0, Math.round((U.top - E.top) / K)), J = p ? e.offsetTop + parseFloat(l.paddingTop) + q * K + (K - G) / 2 - e.scrollTop : e.offsetTop + (e.clientHeight - G) / 2;
+			if (W < e.offsetLeft - 1 || W > e.offsetLeft + e.clientWidth + 1 || J + G <= e.offsetTop || J >= e.offsetTop + e.clientHeight) {
+				z();
+				return;
+			}
+			let Y = Math.max(e.offsetLeft, Math.min(e.offsetLeft + e.clientWidth - 2, W)), X = !S || Math.abs(A - Y) > .1 || Math.abs(j - J) > .1, Z = M !== e.scrollLeft || N !== e.scrollTop || P !== e.clientWidth;
+			I || (F = r.context(() => {
+				I = r.quickTo(n, "x", {
+					duration: .09,
+					ease: "power2.out"
+				}), p && (L = r.quickTo(n, "y", {
+					duration: .09,
+					ease: "power2.out"
+				}));
+			}, t)), !S || i || Z ? (I(Y, Y), I.tween.progress(1).pause(), L && (L(J, J), L.tween.progress(1).pause())) : X && (I(Y), L?.(J)), n.style.height !== `${G}px` && (n.style.height = `${G}px`);
+			let Q = p ? "0px" : `${J}px`;
+			n.style.top !== Q && (n.style.top = Q), n.style.color !== l.color && (n.style.color = l.color), S || (n.setAttribute("data-active", ""), e.setAttribute("data-smooth-caret", "")), S = !0, A = Y, j = J, M = e.scrollLeft, N = e.scrollTop, P = e.clientWidth, (X || a) && B();
+		}
+		function H(e = !1, t = !1) {
+			x || !v || (w ||= e, T ||= t, C ||= g.requestAnimationFrame(V));
+		}
+		function U() {
+			x || !v || (g.cancelAnimationFrame(C), w = T = !0, V());
+		}
+		let W = () => H(), G = () => H(!0), K = () => H(!1, !0), q = () => z(), J = () => h.hidden ? z() : H(!0), Y = () => U(), X = new ResizeObserver(() => H());
+		function Z() {
+			v || (v = !0, h.addEventListener("selectionchange", W), h.addEventListener("pointerup", Y), h.addEventListener("pointercancel", Y), h.addEventListener("visibilitychange", J), g.addEventListener("blur", q), g.addEventListener("focus", G), g.addEventListener("resize", G), _.addEventListener("change", G), h.fonts?.addEventListener("loadingdone", G), X.observe(e), U(), H(!0, !0));
+		}
+		function Q() {
+			v = y = b = !1, z(), g.cancelAnimationFrame(C), C = 0, w = T = !1, h.removeEventListener("selectionchange", W), h.removeEventListener("pointerup", Y), h.removeEventListener("pointercancel", Y), h.removeEventListener("visibilitychange", J), g.removeEventListener("blur", q), g.removeEventListener("focus", G), g.removeEventListener("resize", G), _.removeEventListener("change", G), h.fonts?.removeEventListener("loadingdone", G), X.disconnect(), F?.revert(), F = I = L = void 0, D?.remove(), D = O = void 0, k = "";
+		}
+		let $ = {
+			focus: Z,
+			blur: Q,
+			input: K,
+			keydown: K,
+			keyup: W,
+			select: W,
+			scroll: G,
+			pointerdown: (e) => {
+				b ||= e.pointerType === "touch", b ? z() : H(!0, !0);
+			},
+			compositionstart: () => {
+				y = !0, H(!1, !0);
+			},
+			compositionupdate: K,
+			compositionend: () => {
+				y = !1, H(!1, !0);
+			}
+		};
+		for (let [t, n] of Object.entries($)) e.addEventListener(t, n);
+		d = () => H(), f = () => {
+			x = !0, Q();
+			for (let [t, n] of Object.entries($)) e.removeEventListener(t, n);
+			d = () => {};
+		}, h.activeElement === e && Z();
+	});
+}
+//#endregion
+export { c as useTextControlCaret };

package/dist/utils/clipboard.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 通过 Clipboard API 写入文本。环境不支持时返回 false；写入被拒绝时抛出原始错误，
+ * 由调用方决定是否回退。
+ */
+export declare function writeTextWithClipboardApi(value: string): Promise<boolean>;
+/**
+ * 使用隐藏 textarea + execCommand('copy') 的兼容方案写入文本。
+ */
+export declare function writeTextWithTextareaFallback(value: string): boolean;

package/dist/utils/clipboard.js

@@ -0,0 +1,16 @@
+//#region src/utils/clipboard.ts
+async function e(e) {
+	return typeof navigator > "u" || !navigator.clipboard?.writeText ? !1 : (await navigator.clipboard.writeText(e), !0);
+}
+function t(e) {
+	if (typeof document > "u") return !1;
+	let t = document.createElement("textarea");
+	t.value = e, t.setAttribute("readonly", ""), t.style.position = "fixed", t.style.inset = "0 auto auto 0", t.style.width = "1px", t.style.height = "1px", t.style.opacity = "0", t.style.pointerEvents = "none", document.body.appendChild(t), t.select(), t.setSelectionRange(0, t.value.length);
+	try {
+		return document.execCommand?.("copy") === !0;
+	} finally {
+		t.remove();
+	}
+}
+//#endregion
+export { e as writeTextWithClipboardApi, t as writeTextWithTextareaFallback };

package/dist/utils/config.d.ts

@@ -0,0 +1,42 @@
+import { ComputedRef, InjectionKey } from 'vue';
+export type BingConfigSize = 'sm' | 'md' | 'lg';
+/**
+ * - `user`：跟随系统的 `prefers-reduced-motion` 设置（默认）。
+ * - `always`：始终减少动效，适合应用内提供“关闭动画”开关。
+ * - `never`：忽略系统设置，始终播放完整动效。
+ */
+export type BingReducedMotion = 'user' | 'always' | 'never';
+export interface BingConfig {
+    /** 支持尺寸的组件在未显式传入 `size` 时使用的默认尺寸。 */
+    size?: BingConfigSize;
+    /** 浮层层级基准，默认 2000；各类浮层在此基础上保持固定的相对顺序。 */
+    zIndex?: number;
+    /** JS 驱动动效的减弱策略。 */
+    reducedMotion?: BingReducedMotion;
+}
+export interface BingConfigContext {
+    size: ComputedRef<BingConfigSize | undefined>;
+    zIndex: ComputedRef<number>;
+    reducedMotion: ComputedRef<BingReducedMotion>;
+}
+export declare const defaultBingZIndex = 2000;
+/** 各浮层相对 `zIndex` 基准的偏移，与引入全局配置前的默认层级一致。 */
+export declare const bingZIndexOffset: {
+    readonly dialog: 0;
+    readonly toast: 100;
+    readonly filePreview: 300;
+    readonly imagePreview: 400;
+    readonly colorPicker: 900;
+    readonly popover: 1000;
+    readonly datePicker: 1100;
+    readonly tooltip: 1200;
+};
+export type BingZIndexLayer = keyof typeof bingZIndexOffset;
+export declare const bingConfigKey: InjectionKey<BingConfigContext>;
+/** 在当前组件下提供全局配置；未设置的字段继承上层配置。 */
+export declare function provideBingConfig(config: () => BingConfig): BingConfigContext;
+export declare function useBingConfig(): BingConfigContext;
+/** 组件 `size` 优先，其次全局配置，最后回落到 `md`。 */
+export declare function useConfigSize<Size extends string>(getSize: () => Size | undefined): ComputedRef<Size | BingConfigSize>;
+/** 组件显式传入的 `zIndex` 优先，否则使用全局基准加上该类浮层的偏移。 */
+export declare function useConfigZIndex(layer: BingZIndexLayer, getZIndex?: () => number | undefined): ComputedRef<number>;

package/dist/utils/config.js

@@ -0,0 +1,37 @@
+import { computed as e, inject as t, provide as n } from "vue";
+//#region src/utils/config.ts
+var r = 2e3, i = {
+	dialog: 0,
+	toast: 100,
+	filePreview: 300,
+	imagePreview: 400,
+	colorPicker: 900,
+	popover: 1e3,
+	datePicker: 1100,
+	tooltip: 1200
+}, a = Symbol("BingConfig"), o = {
+	size: e(() => void 0),
+	zIndex: e(() => r),
+	reducedMotion: e(() => "user")
+};
+function s(r) {
+	let i = t(a, o), s = {
+		size: e(() => r().size ?? i.size.value),
+		zIndex: e(() => r().zIndex ?? i.zIndex.value),
+		reducedMotion: e(() => r().reducedMotion ?? i.reducedMotion.value)
+	};
+	return n(a, s), s;
+}
+function c() {
+	return t(a, o);
+}
+function l(t) {
+	let n = c();
+	return e(() => t() ?? n.size.value ?? "md");
+}
+function u(t, n = () => void 0) {
+	let r = c();
+	return e(() => n() ?? r.zIndex.value + i[t]);
+}
+//#endregion
+export { s as provideBingConfig, c as useBingConfig, l as useConfigSize, u as useConfigZIndex };

package/dist/utils/controlAttrs.js

@@ -0,0 +1,37 @@
+import { useAttrs as e } from "vue";
+//#region src/utils/controlAttrs.ts
+var t = new Set([
+	"role",
+	"readonly",
+	"required",
+	"form",
+	"maxlength",
+	"minlength",
+	"pattern",
+	"inputmode",
+	"autofocus",
+	"enterkeyhint",
+	"tabindex",
+	"list",
+	"autocapitalize",
+	"autocorrect",
+	"dirname",
+	"wrap",
+	"cols",
+	"onChange",
+	"onBeforeinput",
+	"onCompositionstart",
+	"onCompositionupdate",
+	"onCompositionend",
+	"onSelect",
+	"onInvalid"
+]);
+function n() {
+	let n = e(), r = (e) => t.has(e) || e.startsWith("aria-");
+	return {
+		rootAttrs: () => Object.fromEntries(Object.entries(n).filter(([e]) => !r(e))),
+		controlAttrs: () => Object.fromEntries(Object.entries(n).filter(([e]) => r(e)))
+	};
+}
+//#endregion
+export { n as useControlAttrs };

package/dist/utils/floating.d.ts

@@ -0,0 +1,86 @@
+/**
+ * 浮层定位的公共几何计算与视口跟随。
+ *
+ * 几何部分是纯函数：给定锚点矩形、浮层尺寸与视口，求出方向和左上角坐标。
+ * 各组件只负责测量自身尺寸、决定首选方向，并在结果上叠加各自的派生状态
+ * （最大高度、变换原点、侧边工具栏等）。
+ */
+export type FloatingSide = 'top' | 'bottom' | 'left' | 'right';
+export type FloatingAlign = 'start' | 'center' | 'end';
+/**
+ * - `none`：始终使用首选方向。
+ * - `opposite`：首选方向放不下且对侧空间更大时翻到对侧。
+ * - `best`：依次尝试首选、对侧及其余方向，取第一个放得下的；都放不下时取空间最大的。
+ */
+export type FloatingFlip = 'none' | 'opposite' | 'best';
+export interface FloatingRect {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+    width: number;
+    height: number;
+}
+export interface FloatingSize {
+    width: number;
+    height: number;
+}
+export interface FloatingLayoutOptions {
+    /** 锚点与浮层的间距。 */
+    gap?: number;
+    /** 浮层与视口边缘保留的最小距离。 */
+    padding?: number;
+    /** 默认读取当前窗口尺寸。 */
+    viewport?: FloatingSize;
+}
+export interface ResolveFloatingSideOptions extends FloatingLayoutOptions {
+    anchor: FloatingRect;
+    floating: FloatingSize;
+    side: FloatingSide;
+    flip?: FloatingFlip;
+}
+export interface ComputeFloatingPositionOptions extends ResolveFloatingSideOptions {
+    align?: FloatingAlign;
+    /**
+     * 主轴方向是否把整个浮层推回视口。默认 `true`；
+     * 为 `false` 时只保证浮层起点不越过视口边距，浮层可以向外延伸。
+     */
+    shiftMainAxis?: boolean;
+}
+export interface FloatingPosition {
+    side: FloatingSide;
+    left: number;
+    top: number;
+}
+export declare function getOppositeSide(side: FloatingSide): FloatingSide;
+export declare function isVerticalSide(side: FloatingSide): side is "top" | "bottom";
+export declare function getViewportSize(): FloatingSize;
+/** 限制在区间内；区间无效时取下限。 */
+export declare function clampToRange(value: number, min: number, max: number): number;
+/** 对齐到设备像素，避免半像素模糊。 */
+export declare function snapToDevicePixel(value: number): number;
+/** 锚点某一侧到视口边距之间的可用空间，可能为负数。 */
+export declare function getAvailableSpace(anchor: FloatingRect, side: FloatingSide, { gap, padding, viewport }?: FloatingLayoutOptions): number;
+export declare function resolveFloatingSide({ anchor, floating, side, flip, ...layout }: ResolveFloatingSideOptions): FloatingSide;
+export declare function computeFloatingPosition(options: ComputeFloatingPositionOptions): FloatingPosition;
+export interface FloatingAutoUpdateOptions {
+    /** 返回 `false` 时忽略本次调度，例如浮层已经关闭。 */
+    enabled?: () => boolean;
+}
+export interface FloatingAutoUpdate {
+    /** 开始监听窗口尺寸变化与任意祖先滚动。重复调用无副作用。 */
+    start: () => void;
+    /** 停止监听。 */
+    stop: () => void;
+    /** 在下一帧执行更新，同一帧内的多次调度会合并。 */
+    schedule: () => void;
+    /** 取消尚未执行的更新。 */
+    cancel: () => void;
+    /** 停止监听并取消待执行的更新。 */
+    dispose: () => void;
+}
+/**
+ * 浮层打开期间跟随视口变化重新定位。
+ * 在组件 setup 中调用时会在卸载前自动释放。
+ */
+export declare function useFloatingAutoUpdate(update: () => void, { enabled }?: FloatingAutoUpdateOptions): FloatingAutoUpdate;

package/dist/utils/floating.js

@@ -0,0 +1,99 @@
+import { getCurrentInstance as e, onBeforeUnmount as t } from "vue";
+//#region src/utils/floating.ts
+var n = {
+	top: "bottom",
+	bottom: "top",
+	left: "right",
+	right: "left"
+};
+function r(e) {
+	return n[e];
+}
+function i(e) {
+	return e === "top" || e === "bottom";
+}
+function a() {
+	return typeof window > "u" ? {
+		width: 0,
+		height: 0
+	} : {
+		width: window.innerWidth,
+		height: window.innerHeight
+	};
+}
+function o(e, t, n) {
+	return n < t ? t : Math.min(n, Math.max(t, e));
+}
+function s(e) {
+	if (typeof window > "u") return Math.round(e);
+	let t = window.devicePixelRatio || 1;
+	return Math.round(e * t) / t;
+}
+function c(e, t, { gap: n = 0, padding: r = 0, viewport: i = a() } = {}) {
+	return t === "top" ? e.top - n - r : t === "bottom" ? i.height - e.bottom - n - r : t === "left" ? e.left - n - r : i.width - e.right - n - r;
+}
+function l(e, t) {
+	return i(e) ? t.height : t.width;
+}
+function u({ anchor: e, floating: t, side: n, flip: i = "opposite", ...a }) {
+	if (i === "none") return n;
+	let o = (t) => c(e, t, a);
+	if (i === "opposite") {
+		let e = r(n), i = o(n);
+		return i >= l(n, t) || i >= o(e) ? n : e;
+	}
+	let s = [
+		n,
+		r(n),
+		"top",
+		"bottom",
+		"right",
+		"left"
+	].filter((e, t, n) => n.indexOf(e) === t), u = (e) => Math.max(0, o(e));
+	return s.find((e) => u(e) >= l(e, t)) || s.reduce((e, t) => u(t) > u(e) ? t : e);
+}
+function d(e, t, n, r) {
+	return e === "end" ? t + n - r : e === "center" ? t + n / 2 - r / 2 : t;
+}
+function f(e) {
+	let { anchor: t, floating: n, align: r = "start", gap: s = 0, padding: c = 0, viewport: l = a(), shiftMainAxis: f = !0 } = e, p = u({
+		...e,
+		gap: s,
+		padding: c,
+		viewport: l
+	}), m = i(p), h = m ? d(r, t.left, t.width, n.width) : p === "left" ? t.left - s - n.width : t.right + s, g = m ? p === "top" ? t.top - s - n.height : t.bottom + s : d(r, t.top, t.height, n.height), _ = !m && !f ? l.width - c : Math.max(c, l.width - c - n.width), v = m && !f ? l.height - c : Math.max(c, l.height - c - n.height);
+	return {
+		side: p,
+		left: o(h, c, _),
+		top: o(g, c, v)
+	};
+}
+function p(n, { enabled: r } = {}) {
+	let i = !1, a = 0;
+	function o() {
+		!a || typeof window > "u" || (window.cancelAnimationFrame(a), a = 0);
+	}
+	function s() {
+		typeof window > "u" || r && !r() || (o(), a = window.requestAnimationFrame(() => {
+			a = 0, n();
+		}));
+	}
+	function c() {
+		i || typeof window > "u" || (window.addEventListener("resize", s), window.addEventListener("scroll", s, !0), i = !0);
+	}
+	function l() {
+		!i || typeof window > "u" || (window.removeEventListener("resize", s), window.removeEventListener("scroll", s, !0), i = !1);
+	}
+	function u() {
+		l(), o();
+	}
+	return e() && t(u), {
+		start: c,
+		stop: l,
+		schedule: s,
+		cancel: o,
+		dispose: u
+	};
+}
+//#endregion
+export { o as clampToRange, f as computeFloatingPosition, c as getAvailableSpace, i as isVerticalSide, u as resolveFloatingSide, s as snapToDevicePixel, p as useFloatingAutoUpdate };

package/dist/utils/glass.js

@@ -0,0 +1,25 @@
+//#region src/utils/glass.ts
+var e = {
+	glass: !0,
+	glassBlur: 16,
+	glassOpacity: .85,
+	glassSaturation: 1.28
+};
+function t(e, t, n) {
+	return Math.min(n, Math.max(t, e));
+}
+function n(e) {
+	if (typeof e == "number") return `${Math.max(0, e)}px`;
+	let t = e.trim();
+	return /^-?\d+(\.\d+)?$/.test(t) ? `${Math.max(0, Number(t))}px` : e;
+}
+function r(e, r) {
+	let i = r.glass !== !1, a = i ? r.glassBlur === void 0 ? "var(--bing-glass-blur, 16px)" : n(r.glassBlur) : "0px", o = i ? r.glassOpacity === void 0 ? "var(--bing-glass-opacity, 0.85)" : t(r.glassOpacity, 0, 1) : 1, s = i ? r.glassSaturation === void 0 ? "var(--bing-glass-saturation, 1.05)" : Math.max(0, r.glassSaturation) : 1;
+	return {
+		[`--${e}-glass-blur`]: a,
+		[`--${e}-glass-opacity`]: String(o),
+		[`--${e}-glass-saturation`]: String(s)
+	};
+}
+//#endregion
+export { r as createGlassCssVariables, e as defaultGlassEffect, n as normalizeGlassCssLength };

package/dist/utils/overlay.js

@@ -0,0 +1,94 @@
+import { computed as e, inject as t, nextTick as n, onBeforeUnmount as r, provide as i, ref as a, watch as o } from "vue";
+//#region src/utils/overlay.ts
+var s = Symbol("BingOverlay"), c = /* @__PURE__ */ new WeakMap(), l = /* @__PURE__ */ new WeakMap();
+function u(e, t) {
+	let n = l.get(e);
+	return n || (n = /* @__PURE__ */ new Set(), l.set(e, n)), n.add(t), () => {
+		n.delete(t), n.size || l.delete(e);
+	};
+}
+var d = "a[href],button,input,select,textarea,[tabindex],[contenteditable=\"true\"]";
+function f(e, t) {
+	return e === t || !!(e.parent && f(e.parent, t));
+}
+function p(e) {
+	let t = [], r = /* @__PURE__ */ new WeakMap(), i = () => t.at(-1), a = () => [...t].reverse().find((e) => e.modal), o = (e, n) => !!n && t.some((t) => f(t, e) && t.elements().some((e) => e?.contains(n)));
+	function s() {
+		let e = 0;
+		for (let n of t) n.zIndex.value = Math.max(n.minimumZIndex(), e + 2), e = n.zIndex.value;
+	}
+	function u(n) {
+		let r = t.filter((e) => f(e, n)).flatMap((e) => e.elements());
+		return [...new Set(r.flatMap((e) => e ? [e, ...e.querySelectorAll(d)] : []))].filter((t) => t.matches(d) && t.tabIndex >= 0 && !t.matches(":disabled") && !t.closest("[inert]") && t.getClientRects().length > 0 && e.defaultView?.getComputedStyle(t).visibility !== "hidden");
+	}
+	function p(e) {
+		(u(e)[0] ?? e.elements().find(Boolean))?.focus({ preventScroll: !0 });
+	}
+	function m(t) {
+		r.set(t, i());
+		let n = a();
+		if (t.key !== "Tab" || !n) return;
+		let o = u(n), s = o.indexOf(e.activeElement);
+		(!o.length || s < 0 || (t.shiftKey ? s === 0 : s === o.length - 1)) && (t.preventDefault(), o.length ? o[t.shiftKey ? o.length - 1 : 0]?.focus() : p(n));
+	}
+	function h(e) {
+		let t = r.get(e);
+		e.key === "Escape" && !e.defaultPrevented && t?.closeOnEscape() && (e.preventDefault(), r.set(e, void 0), t.onEscape?.(e));
+	}
+	function g(e) {
+		let t = a();
+		t && !o(t, e.target) && p(t);
+	}
+	return {
+		contains: o,
+		allowsFocus: (e) => !i() || o(i(), e),
+		isTop: (e, t) => (t && r.has(t) ? r.get(t) : i()) === e,
+		add(r) {
+			if (t.includes(r)) {
+				s();
+				return;
+			}
+			r.previousFocus = e.activeElement, t.push(r), s(), l.get(e)?.forEach((e) => e()), t.length === 1 && (e.defaultView?.addEventListener("keydown", m, !0), e.defaultView?.addEventListener("keydown", h), e.addEventListener("focusin", g)), r.modal && n(() => {
+				a() === r && !o(r, e.activeElement) && p(r);
+			});
+		},
+		remove(r) {
+			let i = t.indexOf(r);
+			if (i < 0) return;
+			let s = a() === r;
+			t.splice(i, 1), s && n(() => {
+				let e = a(), t = r.previousFocus;
+				t?.isConnected && (!e || o(e, t)) ? t.focus({ preventScroll: !0 }) : e && p(e);
+			}), t.length || (e.defaultView?.removeEventListener("keydown", m, !0), e.defaultView?.removeEventListener("keydown", h), e.removeEventListener("focusin", g), c.delete(e)), l.get(e)?.forEach((e) => e());
+		}
+	};
+}
+function m(e) {
+	return c.get(e.ownerDocument)?.allowsFocus(e) ?? !0;
+}
+function h(n) {
+	let l = {
+		parent: t(s, null),
+		elements: n.elements,
+		modal: n.modal ?? !1,
+		minimumZIndex: n.zIndex,
+		zIndex: a(n.zIndex()),
+		closeOnEscape: n.closeOnEscape ?? (() => !0),
+		onEscape: n.onEscape,
+		previousFocus: null
+	};
+	i(s, l);
+	let u;
+	return o([n.open, n.zIndex], ([e]) => {
+		typeof document > "u" || (e ? (u = c.get(document), u || (u = p(document), c.set(document, u)), u.add(l)) : u?.remove(l));
+	}, {
+		immediate: !0,
+		flush: "post"
+	}), r(() => u?.remove(l)), {
+		zIndex: e(() => Math.max(n.zIndex(), l.zIndex.value)),
+		isTop: (e) => u?.isTop(l, e) ?? !1,
+		contains: (e) => u?.contains(l, e) ?? !1
+	};
+}
+//#endregion
+export { m as isInActiveOverlayScope, u as onOverlayScopeChange, h as useOverlay };

package/dist/utils/scrollLock.js

@@ -0,0 +1,44 @@
+//#region src/utils/scrollLock.ts
+var e = /* @__PURE__ */ new WeakMap();
+function t() {
+	let t = Symbol("scroll-lock"), n;
+	function r() {
+		if (!n) return;
+		let r = e.get(n);
+		r?.owners.delete(t), r && r.owners.size === 0 && (r.restore(), e.delete(n)), n = void 0;
+	}
+	function i(i = document) {
+		if (n === i) return;
+		r();
+		let { body: a, documentElement: o, defaultView: s } = i;
+		if (!a || !s) return;
+		let c = e.get(i);
+		if (!c) {
+			let t = [a, o], n = [
+				"overflow",
+				"overscroll-behavior",
+				"padding-right"
+			], r = t.map((e) => n.map((t) => ({
+				property: t,
+				value: e.style.getPropertyValue(t),
+				priority: e.style.getPropertyPriority(t)
+			})));
+			c = {
+				owners: /* @__PURE__ */ new Set(),
+				restore: () => t.forEach((e, t) => r[t]?.forEach(({ property: t, value: n, priority: r }) => {
+					n ? e.style.setProperty(t, n, r) : e.style.removeProperty(t);
+				}))
+			}, e.set(i, c);
+			let l = Math.max(0, s.innerWidth - o.clientWidth), u = Number.parseFloat(s.getComputedStyle(a).paddingRight) || 0;
+			l > 0 && (a.style.paddingRight = `${u + l}px`);
+			for (let e of t) e.style.overflow = "hidden", e.style.overscrollBehavior = "contain";
+		}
+		c.owners.add(t), n = i;
+	}
+	return {
+		lock: i,
+		unlock: r
+	};
+}
+//#endregion
+export { t as createScrollLock };

package/dist/utils/search.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 选项类组件共用的本地搜索匹配。
+ *
+ * 文本先做归一化：拆分驼峰、去除变音符号、下划线与连字符视作空格、统一小写。
+ * 查询按空白拆成多个关键词，每个关键词都需命中；不含数字的关键词还可以匹配单词首字母。
+ */
+export declare function normalizeSearchText(value: unknown): string;
+export declare function getSearchInitials(value: string): string;
+export declare function searchTokenMatches(token: string, haystack: string): boolean;
+/** `haystack` 需已归一化；`query` 为归一化后的查询。 */
+export declare function searchQueryMatches(haystack: string, query: string): boolean;
+/** 过滤空值后的元信息键值对，用于详情展示和搜索。 */
+export declare function getMetaEntries(meta: Record<string, unknown> | undefined): {
+    key: string;
+    value: string;
+}[];

package/dist/utils/search.js

@@ -0,0 +1,23 @@
+//#region src/utils/search.ts
+function e(e) {
+	return String(e ?? "").replace(/([a-z0-9])([A-Z])/g, "$1 $2").normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[_-]+/g, " ").toLowerCase().replace(/\s+/g, " ").trim();
+}
+function t(e) {
+	return e.split(/\s+/).filter(Boolean).map((e) => e[0]).join("");
+}
+function n(e, n) {
+	if (!e) return !0;
+	let r = e.replace(/\s+/g, ""), i = n.replace(/\s+/g, "");
+	return /\d/.test(r) ? n.includes(r) || i.includes(r) : n.includes(r) || i.includes(r) || t(n).includes(r);
+}
+function r(e, t) {
+	return t.split(/\s+/).filter(Boolean).every((t) => n(t, e));
+}
+function i(e) {
+	return e ? Object.entries(e).filter(([, e]) => e != null && e !== "").map(([e, t]) => ({
+		key: e,
+		value: String(t)
+	})) : [];
+}
+//#endregion
+export { i as getMetaEntries, e as normalizeSearchText, r as searchQueryMatches };