vintage-frames 0.16.0 → 0.16.2

package/dist/shell/index.d.ts

@@ -9,7 +9,7 @@
  * Its API may change in any minor release while it is experimental.
  * docs/SHELL.md is the guide.
  */
-export { createShell, defineApp, appIdOf, APP_KIND } from './shell.js';
+export { createShell, defineApp } from './shell.js';
 export type { AppContext, AppDefinition, CatalogSetup, KindDefinition, Shell, ShellOptions } from './shell.js';
 export { createWindowManager, focusInto } from './windows.js';
 export type { AdoptOptions, ArrangeGroup, BoxInput, CloseHandler, FocusHome, HomeBox, OpenOptions, PlacePolicy, Placed, WindowManager, WindowManagerOptions, } from './windows.js';
@@ -17,7 +17,7 @@ export { finder, FINDER } 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';
+export { createCatalog, memoryStorage, appIdOf, childrenOf, containerOf, copyName, descendantsOf, enclosingFolders, isContainerKind, isInside, isTrashed, isVolume, itemCount, itemOf, nextFolderName, APP_KIND, DISK, FOLDER, TRASH, UNTITLED_FOLDER, } from './catalog.js';
 export type { Catalog, CatalogArchive, CatalogOptions, CatalogState, CatalogStorage, Item, KindHooks, NewItem, Volumes, } from './catalog.js';
 export { indexedDbStorage } from './storage.js';
 export { localStorageState, mergeSession, openWindowsOf, readSession } from './state.js';

package/dist/shell/index.js

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

package/dist/shell/pure.js

@@ -1,4 +1,4 @@
-import { DISK as e, FOLDER as t, TRASH as n, UNTITLED_FOLDER as r, childrenOf as i, containerOf as a, copyName as o, createCatalog as s, descendantsOf as c, enclosingFolders as l, isContainerKind as u, isInside as d, isTrashed as f, isVolume as p, itemCount as m, itemOf as h, memoryStorage as g, nextFolderName as _ } from "./catalog.js";
-import { BAND as v, CASCADE_SLOTS as y, CASCADE_STEP as b, ICON_CELL as x, ICON_COLUMN as S, ICON_INSET as C, ICON_ROW as w, NEAR as T, WINDOW_ORIGIN as E, cascadeFrom as D, cascadeSlot as O, cascadedBox as k, centeredBox as A, cleanUp as j, collisions as M, desktopLattice as N, fieldExtent as P, fillOrder as F, folderLattice as I, frameOf as L, isPin as R, latticeCell as z, latticeSlot as B, nearBox as V, nextFreeCell as H, pinOf as U, pinTo as W, trashCell as G, windowOrigin as K } from "./geometry.js";
-import { localStorageState as q, mergeSession as J, openWindowsOf as Y, readSession as X } from "./state.js";
-export { v as BAND, y as CASCADE_SLOTS, b as CASCADE_STEP, e as DISK, 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, 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, c as descendantsOf, N as desktopLattice, l as enclosingFolders, P as fieldExtent, F as fillOrder, I as folderLattice, L as frameOf, 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, q as localStorageState, g as memoryStorage, J as mergeSession, V as nearBox, _ as nextFolderName, H as nextFreeCell, Y as openWindowsOf, U as pinOf, W as pinTo, X as readSession, G as trashCell, K as windowOrigin };
+import { APP_KIND as e, DISK as t, FOLDER as n, TRASH as r, UNTITLED_FOLDER as i, appIdOf as a, childrenOf as o, containerOf as s, copyName as c, createCatalog as l, descendantsOf as u, enclosingFolders as d, isContainerKind as f, isInside as p, isTrashed as m, isVolume as h, itemCount as g, itemOf as _, memoryStorage as v, nextFolderName as y } from "./catalog.js";
+import { BAND as b, CASCADE_SLOTS as x, CASCADE_STEP as S, ICON_CELL as C, ICON_COLUMN as w, ICON_INSET as T, ICON_ROW as E, NEAR as D, WINDOW_ORIGIN as O, cascadeFrom as k, cascadeSlot as A, cascadedBox as j, centeredBox as M, cleanUp as N, collisions as P, desktopLattice as F, fieldExtent as I, fillOrder as L, folderLattice as R, frameOf as z, isPin as B, latticeCell as V, latticeSlot as H, nearBox as U, nextFreeCell as W, pinOf as G, pinTo as K, trashCell as q, windowOrigin as J } from "./geometry.js";
+import { localStorageState as Y, mergeSession as X, openWindowsOf as Z, readSession as Q } from "./state.js";
+export { e as APP_KIND, b as BAND, x as CASCADE_SLOTS, S as CASCADE_STEP, t as DISK, n as FOLDER, C as ICON_CELL, w as ICON_COLUMN, T as ICON_INSET, E as ICON_ROW, D as NEAR, r as TRASH, i as UNTITLED_FOLDER, O as WINDOW_ORIGIN, a as appIdOf, k as cascadeFrom, A as cascadeSlot, j as cascadedBox, M as centeredBox, o as childrenOf, N as cleanUp, P as collisions, s as containerOf, c as copyName, l as createCatalog, u as descendantsOf, F as desktopLattice, d as enclosingFolders, I as fieldExtent, L as fillOrder, R as folderLattice, z as frameOf, f as isContainerKind, p as isInside, B as isPin, m as isTrashed, h as isVolume, g as itemCount, _ as itemOf, V as latticeCell, H as latticeSlot, Y as localStorageState, v as memoryStorage, X as mergeSession, U as nearBox, y as nextFolderName, W as nextFreeCell, Z as openWindowsOf, G as pinOf, K as pinTo, Q as readSession, q as trashCell, J as windowOrigin };

package/dist/shell/shell.d.ts

@@ -169,9 +169,5 @@ export interface Shell {
     readonly ready: Promise<void>;
     dispose(): void;
 }
-/** The kind the shell registers: an application's icon, which opens it. */
-export declare const APP_KIND = "app";
 /** Start the shell over `desktop`. The page has imported `vintage-frames` first. */
 export declare function createShell(desktop: VfDesktop, options: ShellOptions): Shell;
-/** The application an `app` item stands for. */
-export declare function appIdOf(item: Item): string | null;

package/dist/shell/shell.js

@@ -1,31 +1,31 @@
 import { onScaleChange as e } from "../scale.js";
 import { VfWindow as t } from "../components/vf-window.js";
 import "../index.js";
-import { createCatalog as n } from "./catalog.js";
-import { createWindowManager as r, deepActiveElement as i, desktopRendered as a } from "./windows.js";
-import { openWindowsOf as o } from "./state.js";
-import { startClock as s } from "./clock.js";
+import { appIdOf as n, createCatalog as r } from "./catalog.js";
+import { createWindowManager as i, deepActiveElement as a, desktopRendered as o } from "./windows.js";
+import { openWindowsOf as s } from "./state.js";
+import { startClock as c } from "./clock.js";
 //#region src/shell/shell.ts
-function c(e) {
+function l(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");
+var u = (e) => e instanceof HTMLInputElement || e instanceof HTMLTextAreaElement || e?.isContentEditable === !0;
+function d(l, d) {
+	let f = d.apps, p = f.find((e) => e.catalog), m = d.defaultApp ?? p?.id ?? f[0]?.id ?? "", h = d.state ?? null, g = d.services ?? {}, _ = [], v = l.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);
+	b && (l.pattern = b);
 	let x = null;
-	if (l.fit === "viewport") {
+	if (d.fit === "viewport") {
 		let t = () => {
 			let e = {
-				width: c.width,
-				height: c.height
+				width: l.width,
+				height: l.height
 			};
-			c.fitWithin(document.documentElement.clientWidth, document.documentElement.clientHeight), x?.resized(e);
+			l.fitWithin(document.documentElement.clientWidth, document.documentElement.clientHeight), x?.resized(e);
 		};
 		t(), window.addEventListener("resize", t);
 		let n = e(t);
@@ -33,34 +33,34 @@ function d(c, l) {
 			window.removeEventListener("resize", t), n();
 		});
 	}
-	let S = r(c, {
+	let S = i(l, {
 		defaultApp: m,
 		savedPin: (e) => h?.pin(e) ?? null
 	});
 	x = S;
 	let C = (e) => {
-		e.target === c && c.clearActive();
+		e.target === l && l.clearActive();
 	};
-	c.addEventListener("pointerdown", C), _.push(() => c.removeEventListener("pointerdown", C));
+	l.addEventListener("pointerdown", C), _.push(() => l.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 }),
+		art: (e) => f.find((t) => t.id === n(e))?.icon ?? "",
+		open: (e, t) => void w[n(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({
+	for (let e of f) for (let [t, n] of Object.entries(e.kinds ?? {})) T.set(t, n);
+	let E = p?.catalog ? r({
 		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 = () => {
+	}) : null, D = () => !!document.querySelector("vf-dialog[open]"), O = () => u(a()), k = /* @__PURE__ */ new Map(), A = () => {
 		for (let [e, t] of k) {
 			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));
+	document.addEventListener("pointerdown", A, !0), document.addEventListener("keydown", A, !0), l.addEventListener("vf-select", A), l.addEventListener("vf-activate", A), _.push(() => document.removeEventListener("pointerdown", A, !0), () => document.removeEventListener("keydown", A, !0), () => l.removeEventListener("vf-select", A), () => l.removeEventListener("vf-activate", A), S.onWindows(A), S.onLayout(A)), E && _.push(E.subscribe(A));
 	let j = (e) => {
 		if (!e) return [];
 		let t = document.createElement("div");
@@ -68,7 +68,7 @@ function d(c, l) {
 		let n = [...t.children].filter((e) => e instanceof HTMLElement);
 		for (let e of n) e.remove();
 		return n;
-	}, M = d.map((e) => ({
+	}, M = f.map((e) => ({
 		def: e,
 		menus: j(e.menus).filter((e) => e.localName === "vf-menu"),
 		dialogs: j(e.dialogs).filter((e) => e.dataset.dialog != null),
@@ -85,7 +85,7 @@ function d(c, l) {
 			o.clear();
 		});
 		let s = {
-			desktop: c,
+			desktop: l,
 			windows: S,
 			menus: t,
 			systemMenu: y,
@@ -95,7 +95,7 @@ function d(c, l) {
 			state: h,
 			kinds: T,
 			kind: (e) => T.get(e),
-			app: (e) => d.find((t) => t.id === e),
+			app: (e) => f.find((t) => t.id === e),
 			menu(e) {
 				let n = t.find((t) => t.dataset.menu === e);
 				if (!n) throw Error(`${a}: missing menu ${e}`);
@@ -163,8 +163,8 @@ function d(c, l) {
 			onDispose(e) {
 				i.push(e);
 			}
-		}, l = e.init(s);
-		l && (w[e.id] = l), N.push(() => {
+		}, c = e.init(s);
+		c && (w[e.id] = c), N.push(() => {
 			for (let e of i.splice(0).reverse()) e();
 		});
 	}
@@ -175,16 +175,16 @@ function d(c, l) {
 			y.after(...t.menus), v.label = t.def.name, P = t, A();
 		}
 	};
-	if (_.push(S.onFront(F), S.onDialogs(F)), F(), l.clock !== !1) {
+	if (_.push(S.onFront(F), S.onDialogs(F)), F(), d.clock !== !1) {
 		let e = v.querySelector(":scope > [slot=\"end\"]"), t = !e;
 		e || (e = document.createElement("vf-label"), e.slot = "end", v.append(e));
-		let n = s(e);
+		let n = c(e);
 		_.push(() => {
 			n(), t && e.remove();
 		});
 	}
 	let I = /* @__PURE__ */ new WeakSet(), L = () => {
-		if (E) for (let e of c.stackingOrder) {
+		if (E) for (let e of l.stackingOrder) {
 			if (!(e instanceof t)) continue;
 			let n = S.itemOf(e);
 			if (n == null) continue;
@@ -193,39 +193,39 @@ function d(c, l) {
 		}
 	};
 	return E && _.push(E.subscribe(L), S.onWindows(L)), h?.hold(), {
-		desktop: c,
+		desktop: l,
 		windows: S,
 		catalog: E,
 		apps: w,
 		ready: (async () => {
 			try {
-				await a(c), E && (await E.refresh(), p?.catalog?.seed && await E.seed(p.catalog.seed));
-				for (let { item: e, app: t } of o(h?.saved ?? null)) await w[t]?.open?.({ item: e });
+				await o(l), E && (await E.refresh(), p?.catalog?.seed && await E.seed(p.catalog.seed));
+				for (let { item: e, app: t } of s(h?.saved ?? null)) await w[t]?.open?.({ item: e });
 				let e = h?.saved?.active;
 				if (e) {
 					let t = S.windowFor(e);
-					t && c.bringToFront(t);
+					t && l.bringToFront(t);
 				}
 			} finally {
 				if (h) {
 					let e = h.start(() => ({
 						windows: S.snapshot(),
-						active: S.itemOf(c.activeWindow),
-						pattern: c.pattern ?? null
+						active: S.itemOf(l.activeWindow),
+						pattern: l.pattern ?? null
 					}), (e) => {
 						let t = [
 							S.onLayout(e),
 							S.onWindows(e),
 							...E ? [E.subscribe(e)] : []
 						];
-						c.addEventListener("vf-activate", e);
+						l.addEventListener("vf-activate", e);
 						let n = new MutationObserver(e);
-						return n.observe(c, {
+						return n.observe(l, {
 							attributes: !0,
 							attributeFilter: ["pattern"]
 						}), () => {
 							for (let e of t) e();
-							c.removeEventListener("vf-activate", e), n.disconnect();
+							l.removeEventListener("vf-activate", e), n.disconnect();
 						};
 					});
 					_.push(e), h.release();
@@ -241,9 +241,5 @@ function d(c, l) {
 		}
 	};
 }
-function f(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 { d as createShell, l as defineApp };

package/dist/shell/windows.d.ts

@@ -17,7 +17,8 @@
  *   none is active. `beforeFront` runs before a change, `onFront` reports it.
  * - Palettes are an application's utility windows: shown while it is front
  *   and hidden otherwise, never closed or removed.
- * - Opening a window moves keyboard focus into it; closing the active one
+ * - Opening a window moves keyboard focus into it, and a new window's field
+ *   marked `autoselect` opens with its text selected; closing the active one
  *   moves focus to the window that becomes active, else to the closed
  *   window's icon, else to the desktop's icons. Focus left behind in a
  *   window that is no longer active — a title-bar press moves none — goes
@@ -128,16 +129,20 @@ export declare function desktopRendered(desktop: VfDesktop): Promise<void>;
 export declare function deepActiveElement(): Element | null;
 /**
  * Move keyboard focus into `win`'s content once that content has rendered —
- * and then only if `when`, read at that point, still holds: to a descendant
- * marked `autofocus`, else to the first thing that takes the focus. An
- * element whose `tabindex` is negative is passed over: a roving cell parked
- * off the tab order, a disabled control. A kit host with no `tabindex` goes
- * through, since it hands the focus on inside itself. Resolves whether the
- * focus moved: a window with nothing focusable in its content keeps the
- * focus where it was.
+ * and then only if `when`, read at that point, still holds: to the first
+ * descendant marked `autofocus` or `autoselect`, else to the first thing that
+ * takes the focus. With `select`, a control marked `autoselect` has its text
+ * selected too; the window manager passes it on a window's first open only,
+ * so a caret placed in the window survives a return to it. An element whose
+ * `tabindex` is negative is passed over: a roving cell parked off the tab
+ * order, a disabled control. A kit host with no `tabindex` goes through,
+ * since it hands the focus on inside itself. Resolves whether the focus
+ * moved: a window with nothing focusable in its content keeps the focus where
+ * it was.
  */
-export declare function focusInto(win: Element, { when }?: {
+export declare function focusInto(win: Element, { when, select }?: {
     when?: () => boolean;
+    select?: boolean;
 }): Promise<boolean>;
 /** The window manager over a desktop. */
 export declare function createWindowManager(desktop: VfDesktop, options: WindowManagerOptions): {
@@ -155,7 +160,8 @@ export declare function createWindowManager(desktop: VfDesktop, options: WindowM
      * Open the window for `item`: raise it if one is open, else make it,
      * append it, adopt it and place it — this session's pin, then the saved
      * one, then `place`, by default the first free cascade slot — and show it
-     * out of `from`. Keyboard focus moves into it. Returns the window.
+     * out of `from`. Keyboard focus moves into it, and a new window's field
+     * marked `autoselect` has its text selected. Returns the window.
      */
     open(opts: OpenOptions): VfWindow;
     /**