vintage-frames 0.15.0 → 0.16.0

package/dist/shell/windows.js

@@ -12,43 +12,49 @@ var u = (e, t) => e.set(t, (e.get(t) ?? 0) + 1), d = (e, t) => {
 	width: e.width ?? 0,
 	height: e.height ?? 0
 });
-function m() {
+async function m(e) {
+	let t = e.querySelector(":scope > vf-menu-bar");
+	await Promise.all([e.updateComplete, t?.updateComplete]);
+}
+function h() {
 	let e = document.activeElement;
 	for (; e?.shadowRoot?.activeElement;) e = e.shadowRoot.activeElement;
 	return e;
 }
-var h = (e) => {
+var g = (e) => {
 	let t = document.activeElement;
 	return !!t && (t === e || e.contains(t));
 };
-async function g(e, { when: t } = {}) {
+async function ee(e, { when: t } = {}) {
 	let n = [...e.querySelectorAll("*")];
 	if (await Promise.all([e, ...n].map((e) => e.updateComplete)), !e.isConnected || t && !t()) return !1;
-	for (let t of n) if (!(t.closest("[hidden]") || !t.checkVisibility()) && !(t.tabIndex < 0 && !t.localName.startsWith("vf-")) && (t.focus({ preventScroll: !0 }), h(e))) return !0;
+	let r = (e) => !e.closest("[hidden]") && e.checkVisibility(), i = n.find((e) => e.hasAttribute("autofocus") && r(e));
+	if (i && (i.focus({ preventScroll: !0 }), g(e))) return !0;
+	for (let t of n) if (!(!r(t) || Number(t.getAttribute("tabindex")) < 0) && !(t.tabIndex < 0 && !t.localName.startsWith("vf-")) && (t.focus({ preventScroll: !0 }), g(e))) return !0;
 	return !1;
 }
-function ee(m, ee) {
-	let { defaultApp: te, savedPin: ne = () => null } = ee, _ = [], v = (e, t, n) => {
+function te(h, te) {
+	let { defaultApp: ne, savedPin: re = () => null } = te, _ = [], v = (e, t, n) => {
 		e.addEventListener(t, n), _.push(() => e.removeEventListener(t, n));
 	}, y = () => ({
-		width: m.width,
-		height: m.height
-	}), b = () => m.windowArea, x = /* @__PURE__ */ new Map(), S = /* @__PURE__ */ new Map(), C = /* @__PURE__ */ new Map(), w = /* @__PURE__ */ new Map(), T = /* @__PURE__ */ new Map(), E = /* @__PURE__ */ new WeakMap(), D = {}, O = () => a(b().top, D), k = /* @__PURE__ */ new Set(), A = !1, j = () => {
+		width: h.width,
+		height: h.height
+	}), b = () => h.windowArea, x = /* @__PURE__ */ new Map(), S = /* @__PURE__ */ new Map(), C = /* @__PURE__ */ new Map(), w = /* @__PURE__ */ new Map(), T = /* @__PURE__ */ new Map(), E = /* @__PURE__ */ new WeakMap(), D = /* @__PURE__ */ new WeakMap(), ie = {}, O = () => a(b().top, ie), k = /* @__PURE__ */ new Set(), A = !1, j = () => {
 		if (!A) for (let e of [...k]) e();
 	}, M = /* @__PURE__ */ new Set(), N = () => {
 		for (let e of [...M]) e();
-	}, P = /* @__PURE__ */ new Set(), F = /* @__PURE__ */ new Set(), I = /* @__PURE__ */ new Set(), L = /* @__PURE__ */ new Set(), R = /* @__PURE__ */ new Map(), z = [], re = (e) => {
+	}, P = /* @__PURE__ */ new Set(), F = /* @__PURE__ */ new Set(), I = /* @__PURE__ */ new Set(), L = /* @__PURE__ */ new Set(), R = /* @__PURE__ */ new Map(), z = [], ae = (e) => {
 		for (let t = e; t; t = t.parentElement) if (R.has(t)) return t;
 		return null;
-	}, B = (e) => e.isConnected && (e.matches("vf-dialog[open]") || !!e.querySelector("vf-dialog[open]")), V = () => {
-		let e = z.filter((e) => R.has(e) && B(e));
-		for (let t of R.keys()) !e.includes(t) && B(t) && e.push(t);
+	}, oe = (e) => e.isConnected && (e.matches("vf-dialog[open]") || !!e.querySelector("vf-dialog[open]")), B = () => {
+		let e = z.filter((e) => R.has(e) && oe(e));
+		for (let t of R.keys()) !e.includes(t) && oe(t) && e.push(t);
 		if (!(e.length === z.length && e.every((e, t) => e === z[t]))) {
 			z = e;
 			for (let e of [...L]) e();
 		}
-	}, H = () => null, U = () => !1;
-	function W(n, r) {
+	}, V = () => null, H = () => !1;
+	function U(n, r) {
 		let i = b(), a = t(n), o = (e) => Math.floor(e / a) * a, s = Math.ceil(i.top / a) * a, c = i.left + i.width, l = i.top + i.height, { width: u, height: d } = r;
 		n.resizable && (u != null && Number.isFinite(u) && (u = Math.min(u, o(i.width))), d != null && Number.isFinite(d) && (d = Math.min(d, o(Math.max(0, l - s)))));
 		let p = u ?? n.width ?? 0, m = d ?? n.height ?? 0;
@@ -59,11 +65,21 @@ function ee(m, ee) {
 			height: d
 		};
 	}
-	let G = (t, n) => {
+	let W = (t, n) => {
 		t.left = e(n.left, t), t.top = e(n.top, t), n.width != null && Number.isFinite(n.width) && (t.width = n.width), n.height != null && Number.isFinite(n.height) && (t.height = n.height), E.delete(t);
-	}, K = (e) => {
+	}, G = (e) => {
 		let t = x.get(e)?.place;
-		return t ? W(e, t(b())) : null;
+		return t ? U(e, t(b())) : null;
+	}, K = (e, t = b()) => {
+		let n = x.get(e)?.zoom;
+		if (!n) return null;
+		let r = p(e), i = n(t, r);
+		return {
+			left: i.left ?? r.left,
+			top: i.top ?? r.top,
+			width: i.width ?? r.width,
+			height: i.height ?? r.height
+		};
 	}, q = (e, t) => {
 		let n = x.get(e)?.policy;
 		if (n) return n(t);
@@ -76,7 +92,7 @@ function ee(m, ee) {
 			width: r,
 			height: i
 		} };
-	}, J = (e, t, n = q(e, p(e))) => W(e, c(t, y(), O(), n)), ie = (e, t) => {
+	}, J = (e, t, n = q(e, p(e))) => U(e, c(t, y(), O(), n)), se = (e, t) => {
 		let n = p(e);
 		return [
 			"left",
@@ -87,62 +103,81 @@ function ee(m, ee) {
 			let r = t[e];
 			return r == null || !Number.isFinite(r) || n[e] === r;
 		});
-	}, ae = (e) => {
+	}, ce = (e) => {
 		let t = [...x].filter(([t, n]) => t !== e && !t.hidden && !n.palette).map(([e]) => p(e));
 		return r(l(b()), t).slot;
-	}, Y = te, X = (e) => e instanceof n && x.get(e)?.app || te;
-	function oe() {
+	}, Y = ne, le = (e) => e instanceof n && x.get(e)?.app || ne;
+	function ue() {
 		let e = !1;
 		for (let [t, n] of x) {
 			if (!n.palette) continue;
 			let r = n.app === Y && n.palette();
-			t.hidden !== !r && (t.hidden = !r, r && m.bringToFront(t), e = !0);
+			t.hidden !== !r && (t.hidden = !r, r && h.bringToFront(t), e = !0);
 		}
 		e && j();
 	}
-	let se = (e) => {
+	let de = (e) => {
 		let t = document.activeElement?.closest("vf-window");
-		!(t instanceof n) || t === e || !x.has(t) || x.get(t).palette || (e ? Z(e) : U(null, null));
-	}, Z = (e) => void g(e, { when: () => m.activeWindow === e }), ce = (e) => {
-		se(e);
+		!(t instanceof n) || t === e || !x.has(t) || x.get(t).palette || (e ? X(e) : H(null, null));
+	}, X = (e) => void ee(e, { when: () => h.activeWindow === e }), fe = (e) => {
+		de(e);
 		for (let t of [...F]) t(e);
-		let t = X(e);
+		let t = le(e);
 		if (t !== Y) {
-			Y = t, oe();
+			Y = t, ue();
 			for (let e of [...I]) e(Y);
 		}
 	};
-	v(m, "vf-activate", (e) => ce(e.detail.window)), v(m, "vf-close", (e) => {
-		let t = e.target;
-		t instanceof n && x.has(t) && $.requestClose(t);
+	v(h, "vf-activate", (e) => fe(e.detail.window)), v(h, "vf-close", (e) => {
+		let t = e.target, r = t instanceof n ? x.get(t) : void 0;
+		if (!r) return;
+		let i = e.detail ?? {};
+		i.altKey && !r.palette ? $.closeAll(r.app, i) : $.requestClose(t, i);
 	});
-	let Q = 0, le = (e) => {
-		!(e.target instanceof n) || !x.has(e.target) || Q || (Q = window.setTimeout(() => {
-			Q = 0, j();
+	let Z = 0, pe = (e) => {
+		!(e.target instanceof n) || !x.has(e.target) || Z || (Z = window.setTimeout(() => {
+			Z = 0, j();
 		}, 0));
 	};
-	m.addEventListener("vf-placement-change", le), _.push(() => m.removeEventListener("vf-placement-change", le)), v(m, "vf-resize", (e) => {
+	h.addEventListener("vf-placement-change", pe), _.push(() => h.removeEventListener("vf-placement-change", pe)), v(h, "vf-zoom", (e) => {
+		let t = e.target;
+		t instanceof n && x.get(t)?.zoom && $.zoom(t);
+	}), v(h, "vf-resize", (e) => {
 		e.detail?.commit && j();
 	});
-	let ue = (e) => {
+	let me = (e) => {
 		let t = x.get(e);
 		t && (x.delete(e), E.delete(e), t.palette || N(), j());
-	}, de = (n, r, i, a) => {
+	}, he = (n, r, i, a) => {
 		let l = p(n), u = x.get(n);
 		if (u?.keep && o(l, u.keep(a))) {
-			G(n, W(n, u.keep(b())));
+			W(n, U(n, u.keep(b())));
+			return;
+		}
+		let d = K(n, a);
+		if (d && o(l, d)) {
+			W(n, U(n, K(n)));
 			return;
 		}
-		let d = E.get(n), f = !!d && n.resizable && (d.width !== l.width || d.height !== l.height), m = !d || d.left !== l.left || d.top !== l.top || f || !d ? s(l, r, O()) : d.pin, h = c(m, i, O(), q(n, l));
-		if (n.left = e(h.left, n), n.top = e(h.top, n), n.resizable) {
+		let f = E.get(n), m = !!f && n.resizable && (f.width !== l.width || f.height !== l.height), h = !f || f.left !== l.left || f.top !== l.top || m || !f ? s(l, r, O()) : f.pin, g = c(h, i, O(), q(n, l));
+		if (n.left = e(g.left, n), n.top = e(g.top, n), n.resizable) {
 			let r = t(n), i = b(), a = Math.ceil(i.top / r) * r, o = Math.floor(i.width / r) * r, s = Math.floor(Math.max(0, i.top + i.height - a) / r) * r;
-			n.width = Math.min(e(h.width, n), o), n.height = Math.min(e(h.height, n), s);
+			n.width = Math.min(e(g.width, n), o), n.height = Math.min(e(g.height, n), s);
 		}
 		E.set(n, {
-			pin: m,
+			pin: h,
 			...p(n)
 		});
-	}, $ = {
+	}, ge = (e, t) => {
+		let n = t ? J(e, t) : G(e);
+		n && W(e, n);
+	}, _e = !1, Q = /* @__PURE__ */ new Map();
+	m(h).then(() => {
+		_e = !0;
+		for (let [e, t] of Q) x.has(e) && ge(e, t);
+		Q.size && j(), Q.clear();
+	});
+	let $ = {
 		get area() {
 			return b();
 		},
@@ -157,40 +192,37 @@ function ee(m, ee) {
 				place: t.place ?? null,
 				policy: t.policy ?? null,
 				keep: t.keep ?? null,
+				zoom: t.zoom ?? null,
 				palette: n ? n === !0 ? () => !0 : n : null,
 				close: t.close ?? null
-			}), t.pin) G(e, J(e, t.pin));
-			else {
-				let t = K(e);
-				t && G(e, t);
-			}
-			if (n) {
+			}), ge(e, t.pin ?? null), _e || Q.set(e, t.pin ?? null), n) {
 				let t = x.get(e);
 				e.hidden = !(t.app === Y && t.palette());
 			}
-			m.activeWindow === e && ce(e), n || N(), j();
+			h.activeWindow === e && fe(e), n || N(), j();
 		},
 		open(e) {
 			let t = e.item == null ? null : $.windowFor(e.item);
-			if (t) return m.bringToFront(t), Z(t), t;
+			if (t) return h.bringToFront(t), X(t), t;
 			let n = e.create(), r = {
 				width: n.width ?? 0,
 				height: n.height ?? 0
-			}, a = ae();
-			m.append(n);
+			}, a = ce();
+			h.append(n);
 			let o = e.item ?? null;
 			return $.adopt(n, {
 				app: e.app,
 				item: o,
 				place: e.place ?? ((e) => i(e, r, l(e), a)),
-				pin: o == null ? null : C.get(o)?.pin ?? ne(o),
+				pin: o == null ? null : C.get(o)?.pin ?? re(o),
 				policy: e.policy ?? null,
 				keep: e.keep ?? null,
+				zoom: e.zoom ?? null,
 				close: e.close ?? null
-			}), o != null && C.delete(o), m.bringToFront(n), e.from && n.show({ from: e.from }), Z(n), n;
+			}), o != null && C.delete(o), h.bringToFront(n), e.from && n.show({ from: e.from }), X(n), n;
 		},
 		close(e, { to: t } = {}) {
-			let n = x.get(e), r = n?.item ?? null, i = n?.app ?? null, a = t === void 0 ? i == null ? null : H(r, i) : t, o = m.activeWindow === e || h(e);
+			let n = x.get(e), r = n?.item ?? null, i = n?.app ?? null, a = t === void 0 ? i == null ? null : V(r, i) : t, o = h.activeWindow === e || g(e);
 			r != null && i != null && C.set(r, {
 				app: i,
 				pin: s(p(e), y(), O())
@@ -200,35 +232,40 @@ function ee(m, ee) {
 			let l = () => {
 				r != null && d(w, r), i != null && !n?.palette && d(T, i), N();
 			};
-			return c.then(l, l), ue(e), e.remove(), o && queueMicrotask(() => {
-				let e = m.activeWindow;
-				e ? Z(e) : U(r, i) || U(null, null);
+			return c.then(l, l), me(e), e.remove(), o && queueMicrotask(() => {
+				let e = h.activeWindow;
+				e ? X(e) : H(r, i) || H(null, null);
 			}), c;
 		},
-		requestClose(e) {
-			let t = x.get(e)?.close;
-			t ? t(e) : $.close(e);
+		async requestClose(e, t = {}) {
+			let n = x.get(e)?.close;
+			return n ? await n(e, t) : $.close(e), !x.has(e);
+		},
+		async closeAll(e, t = {}) {
+			let n = $.windowsOf(e).filter((e) => !x.get(e)?.palette).reverse();
+			for (let e of n) if (x.has(e) && !await $.requestClose(e, t)) return !1;
+			return !0;
 		},
 		windowFor(e) {
 			for (let [t, n] of x) if (n.item === e) return t;
 			return null;
 		},
 		windowsOf(e) {
-			return m.stackingOrder.filter((t) => t instanceof n && x.get(t)?.app === e);
+			return h.stackingOrder.filter((t) => t instanceof n && x.get(t)?.app === e);
 		},
 		itemOf(e) {
 			return e instanceof n ? x.get(e)?.item ?? null : null;
 		},
 		appOf(e) {
 			if (e instanceof n) return x.get(e)?.app ?? null;
-			let t = re(e);
+			let t = ae(e);
 			return t ? R.get(t).app : null;
 		},
 		holdDialog(e, { app: t }) {
 			let n = R.get(e);
 			if (n) n.app = t;
 			else {
-				let n = new MutationObserver(V);
+				let n = new MutationObserver(B);
 				n.observe(e, {
 					attributes: !0,
 					attributeFilter: ["open"],
@@ -238,11 +275,11 @@ function ee(m, ee) {
 					observer: n
 				});
 			}
-			m.contains(e) || m.append(e), V();
+			h.contains(e) || h.append(e), B();
 		},
 		releaseDialog(e) {
 			let t = R.get(e);
-			t && (t.observer.disconnect(), R.delete(e), V());
+			t && (t.observer.disconnect(), R.delete(e), B());
 		},
 		dialogsOf(e) {
 			return [...R].filter(([, t]) => t.app === e).map(([e]) => e);
@@ -267,16 +304,34 @@ function ee(m, ee) {
 			return !1;
 		},
 		palettesChanged() {
-			oe();
+			ue();
 		},
 		write(e, t) {
-			G(e, t), j();
+			W(e, t), j();
+		},
+		zoom(e) {
+			let t = K(e);
+			if (!t) return;
+			let n = p(e), r = U(e, t);
+			if (o(n, {
+				...n,
+				...r
+			})) {
+				let t = D.get(e);
+				D.delete(e);
+				let n = t ? J(e, t.pin, q(e, t.box)) : G(e);
+				n && W(e, n);
+			} else D.set(e, {
+				pin: s(n, y(), O()),
+				box: n
+			}), W(e, r);
+			j();
 		},
 		clamped(e, t) {
-			return W(e, t);
+			return U(e, t);
 		},
 		placed(e) {
-			return K(e);
+			return G(e);
 		},
 		pinOf(e) {
 			return s(p(e), y(), O());
@@ -285,7 +340,7 @@ function ee(m, ee) {
 			return J(e, t, n);
 		},
 		setFrameBands(e) {
-			D = { ...e }, E = /* @__PURE__ */ new WeakMap();
+			ie = { ...e }, E = /* @__PURE__ */ new WeakMap();
 		},
 		arrangeWith(e, t) {
 			return S.set(e, t), j(), () => {
@@ -297,8 +352,8 @@ function ee(m, ee) {
 			try {
 				for (let e of S.values()) e.arrange();
 				for (let e of x.keys()) {
-					let t = K(e);
-					t && G(e, t);
+					let t = G(e);
+					t && W(e, t);
 				}
 			} finally {
 				A = !1;
@@ -308,8 +363,8 @@ function ee(m, ee) {
 		arranged() {
 			for (let e of S.values()) if (!e.arranged()) return !1;
 			for (let e of x.keys()) {
-				let t = K(e);
-				if (t && !e.hidden && !ie(e, t)) return !1;
+				let t = G(e);
+				if (t && !e.hidden && !se(e, t)) return !1;
 			}
 			return !0;
 		},
@@ -322,14 +377,14 @@ function ee(m, ee) {
 				width: e.width - n.left,
 				height: Math.max(0, e.height - n.top)
 			};
-			for (let n of x.keys()) de(n, e, t, r);
+			for (let n of x.keys()) he(n, e, t, r);
 			for (let n of [...P]) n(e, t);
 			j();
 		},
 		snapshot() {
 			let e = {};
 			for (let [t, n] of C) e[t] = { ...n };
-			let t = m.stackingOrder;
+			let t = h.stackingOrder;
 			for (let [n, r] of x) {
 				if (r.item == null) continue;
 				let i = s(p(n), y(), O());
@@ -351,8 +406,8 @@ function ee(m, ee) {
 			j();
 		},
 		setHome(e, t) {
-			return H = e, U = t, () => {
-				H = () => null, U = () => !1;
+			return V = e, H = t, () => {
+				V = () => null, H = () => !1;
 			};
 		},
 		onLayout(e) {
@@ -374,14 +429,16 @@ function ee(m, ee) {
 			return L.add(e), () => void L.delete(e);
 		},
 		dispose() {
-			clearTimeout(Q);
+			clearTimeout(Z);
 			for (let e of _) e();
 			k.clear(), M.clear(), P.clear(), F.clear(), I.clear(), L.clear();
 			for (let { observer: e } of R.values()) e.disconnect();
-			R.clear(), z = [], S.clear(), x.clear();
+			R.clear(), z = [], S.clear();
+			for (let e of x.keys()) e.remove();
+			x.clear();
 		}
 	};
-	return Y = X(m.activeWindow), $;
+	return Y = le(h.activeWindow), $;
 }
 //#endregion
-export { ee as createWindowManager, m as deepActiveElement, g as focusInto };
+export { te as createWindowManager, h as deepActiveElement, m as desktopRendered, ee as focusInto };

package/dist/text-control.d.ts

@@ -87,6 +87,18 @@ export declare class VfTextControlBase extends VfShadowRoleControl {
      * wrapper once and can't drift on what turns the rule on.
      */
     protected get wellClass(): string;
+    /**
+     * The text as last committed: taken when the field gains focus, then at
+     * each commit. A commit that brings nothing new isn't announced, so the
+     * native `change` that follows a Return commit, or a step, is not a second
+     * one.
+     */
+    protected committed: string | null;
+    constructor();
+    /** The inner native control every field renders, tagged `vf-field`. */
+    protected get control(): HTMLInputElement | HTMLTextAreaElement | null;
+    /** Select all of the field's text, as a native field's `select()` does. */
+    select(): void;
     connectedCallback(): void;
     /**
      * Re-submit the value only when it (or the disabled state gating it) actually
@@ -139,6 +151,17 @@ export declare class VfTextControlBase extends VfShadowRoleControl {
     protected emitValue(type: 'vf-input' | 'vf-change', detail?: Record<string, unknown>): void;
     /** Mirror the native control's value into `value` and announce a keystroke. */
     protected handleInput(event: Event): void;
-    /** Mirror the native control's value into `value` and announce a commit. */
+    /** The committed form of typed text: as typed here; `vf-number-field` clamps and rounds it. */
+    protected committedText(raw: string): string;
+    /** Commit typed text: its committed form into `value`, announced unless it is what was last committed. */
+    protected commit(raw: string): void;
+    /** The native control's commit. */
     protected handleChange(event: Event): void;
+    /**
+     * A plain Return in a single-line field with a form: commit, then the
+     * form's implicit submission, the order a native input keeps (its `change`
+     * comes before the submission). The keydown is cancelled, so an enclosing
+     * modal does not route the same press to its default button as well.
+     */
+    protected submitOnEnter(event: KeyboardEvent): void;
 }

package/dist/text-control.js

@@ -8,9 +8,6 @@ import { nothing as s } from "lit";
 import { property as c } from "lit/decorators.js";
 //#region src/text-control.ts
 var l = class extends a {
-	constructor(...e) {
-		super(...e), this.value = "", this.placeholder = "", this.readonly = !1, this.name = "", this.label = "", this.scale = new n(this), this.gridSnap = new i(this), this.focusRule = new o(this);
-	}
 	static {
 		this.shadowRootOptions = {
 			...a.shadowRootOptions,
@@ -42,6 +39,20 @@ var l = class extends a {
 	get wellClass() {
 		return `vf-field-well vf-snap${this.focusRule.marked ? " vf-focus-rule" : ""}`;
 	}
+	constructor() {
+		super(), this.value = "", this.placeholder = "", this.readonly = !1, this.name = "", this.label = "", this.scale = new n(this), this.gridSnap = new i(this), this.focusRule = new o(this), this.committed = null, this.addEventListener("focusin", () => {
+			this.committed = this.value;
+		}), this.addEventListener("focusout", () => {
+			let e = this.control;
+			e && this.commit(e.value);
+		});
+	}
+	get control() {
+		return this.renderRoot.querySelector(".vf-field");
+	}
+	select() {
+		this.control?.select();
+	}
 	connectedCallback() {
 		super.connectedCallback(), this.latchFormDefault(this.value);
 	}
@@ -66,8 +77,18 @@ var l = class extends a {
 	handleInput(e) {
 		this.value = e.target.value, this.emitValue("vf-input");
 	}
+	committedText(e) {
+		return e;
+	}
+	commit(e) {
+		let n = this.committedText(e);
+		this.value = n, n !== this.committed && (this.committed = n, this.emitValue("vf-change"), t(this, "change"));
+	}
 	handleChange(e) {
-		this.value = e.target.value, this.emitValue("vf-change"), t(this, "change");
+		this.commit(e.target.value);
+	}
+	submitOnEnter(e) {
+		!this.isSubmitEnter(e) || !this.internals.form || (this.commit(e.target.value), this.requestImplicitSubmit() && e.preventDefault());
 	}
 };
 r([c()], l.prototype, "value", void 0), r([c()], l.prototype, "placeholder", void 0), r([c({

package/dist/top-layer.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The kit's entries into the top layer. Whatever enters the top layer later
+ * paints over what entered before, so an overlay that must stay above
+ * everything — the drawn cursor (src/cursor.ts) — re-promotes itself after
+ * each kit entry. A popup shown here escapes every stacking context on its
+ * way up: a window's z-index can't hold it under a palette.
+ */
+/** Show a manual popover in the top layer, then let the overlays above it re-promote. */
+export declare function showInTopLayer(el: HTMLElement): void;
+/** Take a popover {@link showInTopLayer} showed back out of the top layer. */
+export declare function hideFromTopLayer(el: HTMLElement): void;
+/** Run `fn` after every kit entry into the top layer. Returns the unsubscribe. */
+export declare function onTopLayerEntry(fn: () => void): () => void;

package/dist/top-layer.js

@@ -0,0 +1,16 @@
+//#region src/top-layer.ts
+var e = /* @__PURE__ */ new Set();
+function t(t) {
+	if (!(!("showPopover" in t) || !t.isConnected || t.matches(":popover-open"))) {
+		t.showPopover();
+		for (let t of [...e]) t();
+	}
+}
+function n(e) {
+	"hidePopover" in e && e.matches(":popover-open") && e.hidePopover();
+}
+function r(t) {
+	return e.add(t), () => void e.delete(t);
+}
+//#endregion
+export { n as hideFromTopLayer, r as onTopLayerEntry, t as showInTopLayer };