vintage-frames 0.14.1 → 0.15.0

package/dist/shell/index.d.ts

@@ -14,7 +14,7 @@ export type { AppContext, AppDefinition, CatalogSetup, KindDefinition, Shell, Sh
 export { createWindowManager, focusInto } from './windows.js';
 export type { AdoptOptions, ArrangeGroup, BoxInput, FocusHome, HomeBox, OpenOptions, PlacePolicy, Placed, WindowManager, WindowManagerOptions, } from './windows.js';
 export { finder, FINDER } from './finder.js';
-export type { FinderApi, FinderArt, FinderCommand, FinderCommandSpec, FinderMenu, FinderOpen, FinderOptions, } from './finder.js';
+export type { FinderAlert, FinderAlertHandler, FinderAlerts, FinderApi, FinderArt, FinderCommand, FinderCommandSpec, FinderFailedAction, FinderMenu, FinderOpen, FinderOptions, } from './finder.js';
 export { fileByDrag } from './filing.js';
 export type { FilingOptions } from './filing.js';
 export { createCatalog, memoryStorage, childrenOf, containerOf, copyName, descendantsOf, enclosingFolders, isContainerKind, isInside, isTrashed, isVolume, itemCount, itemOf, nextFolderName, DISK, FOLDER, TRASH, UNTITLED_FOLDER, } from './catalog.js';
@@ -25,5 +25,3 @@ export type { LocalStorageStateOptions, SavedSession, SavedWindow, SessionSnapsh
 export { BAND, CASCADE_SLOTS, CASCADE_STEP, ICON_CELL, ICON_COLUMN, ICON_INSET, ICON_ROW, NEAR, WINDOW_ORIGIN, cascadedBox, cascadeFrom, cascadeSlot, centeredBox, cleanUp, collisions, desktopLattice, fieldExtent, fillOrder, folderLattice, frameOf, isPin, latticeCell, latticeSlot, nearBox, nextFreeCell, pinOf, pinTo, trashCell, windowOrigin, } from './geometry.js';
 export type { Bands, Box, CascadeOptions, EdgePin, Frame, Lattice, LatticeOptions, Pin, Point, Policy, Size, } from './geometry.js';
 export { startClock, formatDate, formatTime, DATE_HOLD_MS } from './clock.js';
-export { showAlert } from './alert.js';
-export type { AlertButton, AlertOptions } from './alert.js';

package/dist/shell/index.js

@@ -3,9 +3,8 @@ import { BAND as v, CASCADE_SLOTS as y, CASCADE_STEP as b, ICON_CELL as x, ICON_
 import { createWindowManager as q, focusInto as J } from "./windows.js";
 import { localStorageState as Y, mergeSession as X, openWindowsOf as Z, readSession as Q } from "./state.js";
 import { DATE_HOLD_MS as $, formatDate as ee, formatTime as te, startClock as ne } from "./clock.js";
-import { showAlert as re } from "./alert.js";
-import { APP_KIND as ie, appIdOf as ae, createShell as oe, defineApp as se } from "./shell.js";
-import { fileByDrag as ce } from "./filing.js";
-import { FINDER as le, finder as ue } from "./finder.js";
-import { indexedDbStorage as de } from "./storage.js";
-export { ie as APP_KIND, v as BAND, y as CASCADE_SLOTS, b as CASCADE_STEP, $ as DATE_HOLD_MS, e as DISK, le as FINDER, t as FOLDER, x as ICON_CELL, S as ICON_COLUMN, C as ICON_INSET, w as ICON_ROW, T as NEAR, n as TRASH, r as UNTITLED_FOLDER, E as WINDOW_ORIGIN, ae as appIdOf, D as cascadeFrom, O as cascadeSlot, k as cascadedBox, A as centeredBox, i as childrenOf, j as cleanUp, M as collisions, a as containerOf, o as copyName, s as createCatalog, oe as createShell, q as createWindowManager, se as defineApp, c as descendantsOf, N as desktopLattice, l as enclosingFolders, P as fieldExtent, ce as fileByDrag, F as fillOrder, ue as finder, J as focusInto, I as folderLattice, ee as formatDate, te as formatTime, L as frameOf, de as indexedDbStorage, u as isContainerKind, d as isInside, R as isPin, f as isTrashed, p as isVolume, m as itemCount, h as itemOf, z as latticeCell, B as latticeSlot, Y as localStorageState, g as memoryStorage, X as mergeSession, V as nearBox, _ as nextFolderName, H as nextFreeCell, Z as openWindowsOf, U as pinOf, W as pinTo, Q as readSession, re as showAlert, ne as startClock, G as trashCell, K as windowOrigin };
+import { APP_KIND as re, appIdOf as ie, createShell as ae, defineApp as oe } from "./shell.js";
+import { fileByDrag as se } from "./filing.js";
+import { FINDER as ce, finder as le } from "./finder.js";
+import { indexedDbStorage as ue } from "./storage.js";
+export { re as APP_KIND, v as BAND, y as CASCADE_SLOTS, b as CASCADE_STEP, $ as DATE_HOLD_MS, e as DISK, ce as FINDER, t as FOLDER, x as ICON_CELL, S as ICON_COLUMN, C as ICON_INSET, w as ICON_ROW, T as NEAR, n as TRASH, r as UNTITLED_FOLDER, E as WINDOW_ORIGIN, ie as appIdOf, D as cascadeFrom, O as cascadeSlot, k as cascadedBox, A as centeredBox, i as childrenOf, j as cleanUp, M as collisions, a as containerOf, o as copyName, s as createCatalog, ae as createShell, q as createWindowManager, oe as defineApp, c as descendantsOf, N as desktopLattice, l as enclosingFolders, P as fieldExtent, se as fileByDrag, F as fillOrder, le as finder, J as focusInto, I as folderLattice, ee as formatDate, te as formatTime, L as frameOf, ue as indexedDbStorage, u as isContainerKind, d as isInside, R as isPin, f as isTrashed, p as isVolume, m as itemCount, h as itemOf, z as latticeCell, B as latticeSlot, Y as localStorageState, g as memoryStorage, X as mergeSession, V as nearBox, _ as nextFolderName, H as nextFreeCell, Z as openWindowsOf, U as pinOf, W as pinTo, Q as readSession, ne as startClock, G as trashCell, K as windowOrigin };

package/dist/shell/shell.d.ts

@@ -7,21 +7,23 @@
  *   nodes come back each time it is front, so items keep their state. A menu
  *   off the bar has no key equivalents, so only the front application's fire.
  *   The bar's label is the front application's name.
+ * - While an application's held dialog is open, the bar shows that
+ *   application's name and menus instead; nothing else changes.
  * - Each application's `init(ctx)` gets the desktop, the window manager, its
- *   own menus, the system menu, the other applications' actions (read at the
- *   call), the catalog when a Finder runs, the site's services, `alert()`,
- *   `gate()`, `onFront()` and `onDispose()`. Everything it sets up comes down
- *   through `onDispose()`, so a hot reload starts clean.
+ *   own menus and dialogs, the system menu, the other applications' actions
+ *   (read at the call), the catalog when a Finder runs, the site's services,
+ *   `ask()`, `gate()`, `onFront()` and `onDispose()`. Everything it sets up
+ *   comes down through `onDispose()`, and its dialogs with it, so a hot
+ *   reload starts clean. The shell composes no UI of its own.
  * - A window showing a catalog item follows it: its title follows a rename,
  *   and it closes when the item is removed.
  * - The boot reads the catalog, seeds it once, reopens the last session's
  *   windows deepest first and the active one last, then starts saving.
  */
-import type { VfDesktop, VfMenu, VfMenuItem, VfViewportBox } from '../index.js';
+import type { VfDesktop, VfDialog, VfMenu, VfMenuItem, VfModalDialog, VfViewportBox } from '../index.js';
 import type { Catalog, CatalogStorage, Item, Volumes } from './catalog.js';
 import type { WindowManager } from './windows.js';
 import type { ShellState } from './state.js';
-import type { AlertOptions } from './alert.js';
 /** A kind of catalog item an application registers: how it looks and opens. */
 export interface KindDefinition {
     /** Its 32×32 art: one URL, or one per item. */
@@ -57,6 +59,11 @@ export interface AppDefinition<Actions = unknown> {
     icon?: string;
     /** A fragment of `vf-menu` elements, each with a `data-menu` name. */
     menus?: string;
+    /**
+     * A fragment of dialogs, each with a `data-dialog` name: a `vf-dialog`, or
+     * an element that renders one inside itself. Held under the application.
+     */
+    dialogs?: string;
     /** The catalog kinds it opens. */
     kinds?: Record<string, KindDefinition>;
     /** The Finder's: the catalog every application shares. */
@@ -98,8 +105,18 @@ export interface AppContext {
     onMenu(fn: (value: string, item: VfMenuItem) => void): void;
     /** Put an item in the system menu, which runs `fn` when picked. */
     systemItem(value: string, label: string, fn: () => void): VfMenuItem;
-    /** Show an alert with the site's caution art; resolves the button's value. */
-    alert(message: string, options?: AlertOptions): Promise<string | null>;
+    /** One of its dialogs by `data-dialog`; throws when the markup drifts. */
+    dialog<T extends HTMLElement = VfDialog>(name: string): T;
+    /** Hold a dialog it made in code: appended to the desktop, held under it, removed with it. Returns it. */
+    hold<T extends Element>(dialog: T): T;
+    /** Let a dialog it holds go, and remove it. */
+    release(dialog: Element): void;
+    /**
+     * Show a dialog it holds, and resolve its `returnValue`: the value of the
+     * button that submitted it, or null when it closed without one. Throws for
+     * a dialog it doesn't hold.
+     */
+    ask(dialog: VfModalDialog): Promise<string | null>;
     /** Keep `item` disabled while `test` is false: re-run on every press, key, selection change and activation. */
     gate(item: VfMenuItem, test: () => boolean): void;
     /** Whether a text field has keyboard focus, read through shadow roots at the call. */
@@ -128,8 +145,6 @@ export interface ShellOptions {
     services?: Record<string, unknown>;
     /** The clock in the menu bar's `end` slot. Default true. */
     clock?: boolean;
-    /** The 32×32 caution art the alerts carry. */
-    caution?: string | null;
 }
 /** A running shell. */
 export interface Shell {
@@ -139,7 +154,6 @@ export interface Shell {
     readonly apps: Record<string, any>;
     /** Settles once the boot has read the catalog and reopened the session. */
     readonly ready: Promise<void>;
-    alert(message: string, options?: AlertOptions): Promise<string | null>;
     dispose(): void;
 }
 /** The kind the shell registers: an application's icon, which opens it. */

package/dist/shell/shell.js

@@ -5,93 +5,96 @@ import { createCatalog as n } from "./catalog.js";
 import { createWindowManager as r, deepActiveElement as i } from "./windows.js";
 import { openWindowsOf as a } from "./state.js";
 import { startClock as o } from "./clock.js";
-import { showAlert as s } from "./alert.js";
 //#region src/shell/shell.ts
-function c(e) {
+function s(e) {
 	return e;
 }
-var l = "app", u = (e) => e instanceof HTMLInputElement || e instanceof HTMLTextAreaElement || e?.isContentEditable === !0;
-function d(c, l) {
-	let d = l.apps, p = d.find((e) => e.catalog), m = l.defaultApp ?? p?.id ?? d[0]?.id ?? "", h = l.state ?? null, g = l.services ?? {}, _ = [], v = c.querySelector(":scope > vf-menu-bar");
-	if (!v) throw Error("vintage-frames/shell: the desktop has no vf-menu-bar");
-	let y = v.querySelector(":scope > vf-menu");
-	if (!y) throw Error("vintage-frames/shell: the menu bar has no system menu");
-	v.shortcuts = !0;
-	let b = h?.saved?.pattern;
-	b && (c.pattern = b);
-	let x = null;
-	if (l.fit === "viewport") {
+var c = "app", l = (e) => e instanceof HTMLInputElement || e instanceof HTMLTextAreaElement || e?.isContentEditable === !0;
+function u(s, c) {
+	let u = c.apps, f = u.find((e) => e.catalog), p = c.defaultApp ?? f?.id ?? u[0]?.id ?? "", m = c.state ?? null, h = c.services ?? {}, g = [], _ = s.querySelector(":scope > vf-menu-bar");
+	if (!_) throw Error("vintage-frames/shell: the desktop has no vf-menu-bar");
+	let v = _.querySelector(":scope > vf-menu");
+	if (!v) throw Error("vintage-frames/shell: the menu bar has no system menu");
+	_.shortcuts = !0;
+	let y = m?.saved?.pattern;
+	y && (s.pattern = y);
+	let b = null;
+	if (c.fit === "viewport") {
 		let t = () => {
 			let e = {
-				width: c.width,
-				height: c.height
+				width: s.width,
+				height: s.height
 			};
-			c.fitWithin(document.documentElement.clientWidth, document.documentElement.clientHeight), x?.resized(e);
+			s.fitWithin(document.documentElement.clientWidth, document.documentElement.clientHeight), b?.resized(e);
 		};
 		t(), window.addEventListener("resize", t);
 		let n = e(t);
-		_.push(() => {
+		g.push(() => {
 			window.removeEventListener("resize", t), n();
 		});
 	}
-	let S = r(c, {
-		defaultApp: m,
-		savedPin: (e) => h?.pin(e) ?? null
+	let x = r(s, {
+		defaultApp: p,
+		savedPin: (e) => m?.pin(e) ?? null
 	});
-	x = S;
-	let C = (e) => {
-		e.target === c && c.clearActive();
+	b = x;
+	let S = (e) => {
+		e.target === s && s.clearActive();
 	};
-	c.addEventListener("pointerdown", C), _.push(() => c.removeEventListener("pointerdown", C));
-	let w = {}, T = /* @__PURE__ */ new Map();
-	T.set("app", {
-		art: (e) => d.find((t) => t.id === f(e))?.icon ?? "",
-		open: (e, t) => void w[f(e) ?? ""]?.open?.({ from: t }),
+	s.addEventListener("pointerdown", S), g.push(() => s.removeEventListener("pointerdown", S));
+	let C = {}, w = /* @__PURE__ */ new Map();
+	w.set("app", {
+		art: (e) => u.find((t) => t.id === d(e))?.icon ?? "",
+		open: (e, t) => void C[d(e) ?? ""]?.open?.({ from: t }),
 		editable: !1
 	});
-	for (let e of d) for (let [t, n] of Object.entries(e.kinds ?? {})) T.set(t, n);
-	let E = p?.catalog ? n({
-		storage: p.catalog.storage,
-		volumes: p.catalog.volumes,
-		listed: (e) => T.has(e),
-		hooks: (e) => T.get(e)
-	}) : null, D = () => !!document.querySelector("vf-dialog[open]"), O = () => u(i()), k = /* @__PURE__ */ new Map(), A = () => {
-		for (let [e, t] of k) {
+	for (let e of u) for (let [t, n] of Object.entries(e.kinds ?? {})) w.set(t, n);
+	let T = f?.catalog ? n({
+		storage: f.catalog.storage,
+		volumes: f.catalog.volumes,
+		listed: (e) => w.has(e),
+		hooks: (e) => w.get(e)
+	}) : null, E = () => !!document.querySelector("vf-dialog[open]"), D = () => l(i()), O = /* @__PURE__ */ new Map(), k = () => {
+		for (let [e, t] of O) {
 			let n = !t();
 			e.disabled !== n && (e.disabled = n);
 		}
 	};
-	document.addEventListener("pointerdown", A, !0), document.addEventListener("keydown", A, !0), c.addEventListener("vf-select", A), c.addEventListener("vf-activate", A), _.push(() => document.removeEventListener("pointerdown", A, !0), () => document.removeEventListener("keydown", A, !0), () => c.removeEventListener("vf-select", A), () => c.removeEventListener("vf-activate", A), S.onWindows(A), S.onLayout(A)), E && _.push(E.subscribe(A));
-	let j = (e, t = {}) => s(c, e, {
-		art: l.caution ?? null,
-		...t
-	}), M = (e) => {
+	document.addEventListener("pointerdown", k, !0), document.addEventListener("keydown", k, !0), s.addEventListener("vf-select", k), s.addEventListener("vf-activate", k), g.push(() => document.removeEventListener("pointerdown", k, !0), () => document.removeEventListener("keydown", k, !0), () => s.removeEventListener("vf-select", k), () => s.removeEventListener("vf-activate", k), x.onWindows(k), x.onLayout(k)), T && g.push(T.subscribe(k));
+	let A = (e) => {
 		if (!e) return [];
 		let t = document.createElement("div");
 		t.innerHTML = e, customElements.upgrade(t);
-		let n = [...t.children].filter((e) => e.localName === "vf-menu");
+		let n = [...t.children].filter((e) => e instanceof HTMLElement);
 		for (let e of n) e.remove();
 		return n;
-	}, N = d.map((e) => ({
+	}, j = u.map((e) => ({
 		def: e,
-		menus: M(e.menus)
-	})), P = [];
-	for (let { def: e, menus: t } of N) {
-		let n = [], r = `vintage-frames/shell (${e.id})`, i = {
-			desktop: c,
-			windows: S,
+		menus: A(e.menus).filter((e) => e.localName === "vf-menu"),
+		dialogs: A(e.dialogs).filter((e) => e.dataset.dialog != null)
+	})), M = [];
+	for (let { def: e, menus: t, dialogs: n } of j) {
+		let r = [], i = `vintage-frames/shell (${e.id})`, a = /* @__PURE__ */ new Set();
+		for (let t of n) x.holdDialog(t, { app: e.id }), a.add(t);
+		r.push(() => {
+			for (let e of a) x.releaseDialog(e), e.remove();
+			a.clear();
+		});
+		let o = {
+			desktop: s,
+			windows: x,
 			menus: t,
-			systemMenu: y,
-			apps: w,
-			catalog: E,
-			services: g,
-			state: h,
-			kinds: T,
-			kind: (e) => T.get(e),
-			app: (e) => d.find((t) => t.id === e),
+			systemMenu: v,
+			apps: C,
+			catalog: T,
+			services: h,
+			state: m,
+			kinds: w,
+			kind: (e) => w.get(e),
+			app: (e) => u.find((t) => t.id === e),
 			menu(e) {
 				let n = t.find((t) => t.dataset.menu === e);
-				if (!n) throw Error(`${r}: missing menu ${e}`);
+				if (!n) throw Error(`${i}: missing menu ${e}`);
 				return n;
 			},
 			item(e) {
@@ -99,115 +102,133 @@ function d(c, l) {
 					let t = n.querySelector(`vf-menu-item[value="${CSS.escape(e)}"]`);
 					if (t) return t;
 				}
-				throw Error(`${r}: missing menu item ${e}`);
+				throw Error(`${i}: missing menu item ${e}`);
 			},
 			onMenu(e) {
-				for (let n of t) i.on(n, "vf-menu-select", (t) => {
-					if (D()) return;
+				for (let n of t) o.on(n, "vf-menu-select", (t) => {
+					if (E()) return;
 					let { value: n, item: r } = t.detail;
 					e(n, r);
 				});
 			},
-			systemItem(e, t, r) {
-				let a = document.createElement("vf-menu-item");
-				return a.setAttribute("value", e), a.textContent = t, y.append(a), i.on(y, "vf-menu-select", (t) => {
-					!D() && t.detail.value === e && r();
-				}), n.push(() => a.remove()), a;
+			systemItem(e, t, n) {
+				let i = document.createElement("vf-menu-item");
+				return i.setAttribute("value", e), i.textContent = t, v.append(i), o.on(v, "vf-menu-select", (t) => {
+					!E() && t.detail.value === e && n();
+				}), r.push(() => i.remove()), i;
+			},
+			dialog(e) {
+				let t = n.find((t) => t.dataset.dialog === e);
+				if (!t) throw Error(`${i}: missing dialog ${e}`);
+				return t;
+			},
+			hold(t) {
+				return x.holdDialog(t, { app: e.id }), a.add(t), t;
+			},
+			release(e) {
+				a.delete(e) && (x.releaseDialog(e), e.remove());
+			},
+			ask(t) {
+				if (x.appOf(t) !== e.id) throw Error(`${i}: ask() takes a dialog the application holds`);
+				return new Promise((e) => {
+					let n = (r) => {
+						r.target === t && (t.removeEventListener("vf-close", n), e(r.detail.returnValue));
+					};
+					t.addEventListener("vf-close", n), t.show();
+				});
 			},
-			alert: j,
 			gate(e, t) {
-				k.set(e, t), n.push(() => k.delete(e));
-				let r = !t();
-				e.disabled !== r && (e.disabled = r);
+				O.set(e, t), r.push(() => O.delete(e));
+				let n = !t();
+				e.disabled !== n && (e.disabled = n);
 			},
-			typing: O,
-			modalOpen: D,
+			typing: D,
+			modalOpen: E,
 			onFront(t) {
-				t(S.front === e.id), n.push(S.onFront((n) => t(n === e.id)));
+				t(x.front === e.id), r.push(x.onFront((n) => t(n === e.id)));
 			},
-			on(e, t, r, i) {
-				e.addEventListener(t, r, i), n.push(() => e.removeEventListener(t, r, i));
+			on(e, t, n, i) {
+				e.addEventListener(t, n, i), r.push(() => e.removeEventListener(t, n, i));
 			},
 			onDispose(e) {
-				n.push(e);
+				r.push(e);
 			}
-		}, a = e.init(i);
-		a && (w[e.id] = a), P.push(() => {
-			for (let e of n.splice(0).reverse()) e();
+		}, c = e.init(o);
+		c && (C[e.id] = c), M.push(() => {
+			for (let e of r.splice(0).reverse()) e();
 		});
 	}
-	let F = null, I = () => {
-		let e = N.find((e) => e.def.id === S.front) ?? N.find((e) => e.def.id === m) ?? null;
-		if (!(!e || e === F)) {
-			if (F) for (let e of F.menus) e.remove();
-			y.after(...e.menus), v.label = e.def.name, F = e, A();
+	let N = null, P = () => {
+		let e = x.asking ?? x.front, t = j.find((t) => t.def.id === e) ?? j.find((e) => e.def.id === p) ?? null;
+		if (!(!t || t === N)) {
+			if (N) for (let e of N.menus) e.remove();
+			v.after(...t.menus), _.label = t.def.name, N = t, k();
 		}
 	};
-	if (_.push(S.onFront(I)), I(), l.clock !== !1) {
-		let e = v.querySelector(":scope > [slot=\"end\"]"), t = !e;
-		e || (e = document.createElement("vf-label"), e.slot = "end", v.append(e));
+	if (g.push(x.onFront(P), x.onDialogs(P)), P(), c.clock !== !1) {
+		let e = _.querySelector(":scope > [slot=\"end\"]"), t = !e;
+		e || (e = document.createElement("vf-label"), e.slot = "end", _.append(e));
 		let n = o(e);
-		_.push(() => {
+		g.push(() => {
 			n(), t && e.remove();
 		});
 	}
-	let L = /* @__PURE__ */ new WeakSet(), R = () => {
-		if (E) for (let e of c.stackingOrder) {
+	let F = /* @__PURE__ */ new WeakSet(), I = () => {
+		if (T) for (let e of s.stackingOrder) {
 			if (!(e instanceof t)) continue;
-			let n = S.itemOf(e);
+			let n = x.itemOf(e);
 			if (n == null) continue;
-			let r = E.item(n);
-			r ? (L.add(e), e.heading !== r.name && (e.heading = r.name)) : L.has(e) && E.get().available && S.close(e, { to: null });
+			let r = T.item(n);
+			r ? (F.add(e), e.heading !== r.name && (e.heading = r.name)) : F.has(e) && T.get().available && x.close(e, { to: null });
 		}
 	};
-	return E && _.push(E.subscribe(R), S.onWindows(R)), h?.hold(), {
-		desktop: c,
-		windows: S,
-		catalog: E,
-		apps: w,
+	return T && g.push(T.subscribe(I), x.onWindows(I)), m?.hold(), {
+		desktop: s,
+		windows: x,
+		catalog: T,
+		apps: C,
 		ready: (async () => {
 			try {
-				E && (await E.refresh(), p?.catalog?.seed && await E.seed(p.catalog.seed));
-				for (let { item: e, app: t } of a(h?.saved ?? null)) await w[t]?.open?.({ item: e });
-				let e = h?.saved?.active;
+				T && (await T.refresh(), f?.catalog?.seed && await T.seed(f.catalog.seed));
+				for (let { item: e, app: t } of a(m?.saved ?? null)) await C[t]?.open?.({ item: e });
+				let e = m?.saved?.active;
 				if (e) {
-					let t = S.windowFor(e);
-					t && c.bringToFront(t);
+					let t = x.windowFor(e);
+					t && s.bringToFront(t);
 				}
 			} finally {
-				if (h) {
-					let e = h.start(() => ({
-						windows: S.snapshot(),
-						active: S.itemOf(c.activeWindow),
-						pattern: c.pattern ?? null
+				if (m) {
+					let e = m.start(() => ({
+						windows: x.snapshot(),
+						active: x.itemOf(s.activeWindow),
+						pattern: s.pattern ?? null
 					}), (e) => {
 						let t = [
-							S.onLayout(e),
-							S.onWindows(e),
-							...E ? [E.subscribe(e)] : []
+							x.onLayout(e),
+							x.onWindows(e),
+							...T ? [T.subscribe(e)] : []
 						];
-						return c.addEventListener("vf-activate", e), () => {
+						return s.addEventListener("vf-activate", e), () => {
 							for (let e of t) e();
-							c.removeEventListener("vf-activate", e);
+							s.removeEventListener("vf-activate", e);
 						};
 					});
-					_.push(e), h.release();
+					g.push(e), m.release();
 				}
 			}
 		})(),
-		alert: j,
 		dispose() {
-			for (let e of P.splice(0).reverse()) e();
-			if (F) for (let e of F.menus) e.remove();
-			F = null;
-			for (let e of _.splice(0)) e();
-			S.dispose(), E?.dispose();
+			for (let e of M.splice(0).reverse()) e();
+			if (N) for (let e of N.menus) e.remove();
+			N = null;
+			for (let e of g.splice(0)) e();
+			x.dispose(), T?.dispose();
 		}
 	};
 }
-function f(e) {
+function d(e) {
 	let t = e.data;
 	return typeof t?.app == "string" ? t.app : null;
 }
 //#endregion
-export { l as APP_KIND, f as appIdOf, d as createShell, c as defineApp };
+export { c as APP_KIND, d as appIdOf, u as createShell, s as defineApp };

package/dist/shell/windows.d.ts

@@ -29,6 +29,9 @@
  *   resizable window's pin when its size changed, floors it at the window's
  *   own size limits and caps it to the window area, so growing back restores
  *   every place.
+ * - Dialogs: `holdDialog()` holds an application's dialog under it, in the
+ *   desktop. The manager follows each held dialog's `open` attribute, and
+ *   `asking` is the application of the one opened last and still open.
  */
 import { VfWindow } from '../index.js';
 import type { VfDesktop, VfViewportBox } from '../index.js';
@@ -151,8 +154,22 @@ export declare function createWindowManager(desktop: VfDesktop, options: WindowM
     windowsOf(app: string): VfWindow[];
     /** A window's item, or null. */
     itemOf(win: Element | null): string | null;
-    /** A window's application, or null when the manager doesn't hold it. */
-    appOf(win: Element | null): string | null;
+    /** A window's or a held dialog's application, or null when the manager doesn't hold it. */
+    appOf(el: Element | null): string | null;
+    /**
+     * Hold an application's dialog: a `vf-dialog`, or an element that renders
+     * one inside itself. It is appended to the desktop unless it is already
+     * in it, and its `open` is followed from then on.
+     */
+    holdDialog(dialog: Element, { app }: {
+        app: string;
+    }): void;
+    /** Let a held dialog go. It stays where it is; the caller removes it. */
+    releaseDialog(dialog: Element): void;
+    /** An application's held dialogs. */
+    dialogsOf(app: string): Element[];
+    /** The application of the held dialog opened last and still open, or null. */
+    readonly asking: string | null;
     /** Whether `win` is a palette. */
     isPalette(win: Element | null): boolean;
     /** Change the item a window shows: an untitled document's first save, say. */
@@ -209,6 +226,8 @@ export declare function createWindowManager(desktop: VfDesktop, options: WindowM
     beforeFront(fn: (win: HTMLElement | null) => void): () => void;
     /** The front application changed. */
     onFront(fn: (app: string) => void): () => void;
+    /** A held dialog opened or closed, so `asking` may have changed. */
+    onDialogs(fn: () => void): () => void;
     dispose(): void;
 };
 export type WindowManager = ReturnType<typeof createWindowManager>;