vintage-frames 0.19.0 → 0.20.0

package/dist/shell/catalog.js

@@ -1,317 +0,0 @@
-//#region src/shell/catalog.ts
-var e = "trash", t = "disk", n = "system-folder", r = "apple-menu-items", i = "startup-items", a = "folder", o = "app", s = "alias", c = "untitled folder", l = "#seeded", u = (e) => e === "folder" || e === "trash" || e === "disk", d = (e) => e === "trash" || e === "disk", f = (e) => d(e) || e === "system-folder" || e === "apple-menu-items" || e === "startup-items";
-function p(e) {
-	let t = e.data;
-	return typeof t?.app == "string" ? t.app : null;
-}
-function m(e) {
-	if (e.kind !== "alias") return null;
-	let t = e.data;
-	return typeof t?.original == "string" ? t.original : null;
-}
-function h(e, t) {
-	return t == null ? null : e.items.find((e) => e.id === t) ?? null;
-}
-function g(e, t) {
-	let n = /* @__PURE__ */ new Set(), r = h(e, t);
-	for (; r?.kind === s;) {
-		if (n.has(r.id)) return null;
-		n.add(r.id), r = h(e, m(r));
-	}
-	return r;
-}
-function _(e, t) {
-	let n = h(e, t);
-	return n && u(n.kind) ? n.id : null;
-}
-function v(e, t) {
-	let n = _(e, t);
-	return e.items.filter((t) => t.id !== n && _(e, t.parent) === n);
-}
-function y(e, t) {
-	return v(e, t).length;
-}
-var b = (e, t) => _(e, h(e, t)?.parent ?? null);
-function x(e, t, n) {
-	let r = /* @__PURE__ */ new Set(), i = b(e, t);
-	for (; i != null && !r.has(i);) {
-		if (i === n) return !0;
-		r.add(i), i = b(e, i);
-	}
-	return !1;
-}
-function S(e, t) {
-	let n = [], r = /* @__PURE__ */ new Set(), i = _(e, t ?? null);
-	for (; i != null && !r.has(i);) n.push(i), r.add(i), i = b(e, i);
-	return n;
-}
-function C(e, t) {
-	return t == null ? !1 : t === "trash" || x(e, t, "trash");
-}
-function w(e, t) {
-	let n = [], r = /* @__PURE__ */ new Set(), i = (t) => {
-		for (let a of v(e, t)) r.has(a.id) || (r.add(a.id), n.push(a), u(a.kind) && i(a.id));
-	};
-	return i(_(e, t)), n;
-}
-function T(e, t) {
-	let n = new Set(v(e, t).filter((e) => e.kind === a).map((e) => e.name));
-	if (!n.has("untitled folder")) return c;
-	for (let e = 2;; e++) {
-		let t = `${c} ${e}`;
-		if (!n.has(t)) return t;
-	}
-}
-var E = (e) => e.replace(/ copy( \d+)?$/, "");
-function D(e, t, n, r) {
-	let i = new Set(v(e, t).filter((e) => e.kind === r).map((e) => e.name));
-	if (!i.has(n)) return n;
-	let a = E(n);
-	if (!i.has(`${a} copy`)) return `${a} copy`;
-	for (let e = 2;; e++) {
-		let t = `${a} copy ${e}`;
-		if (!i.has(t)) return t;
-	}
-}
-function O(e, t, n) {
-	let r = new Set(v(e, t).filter((e) => e.kind === s).map((e) => e.name)), i = `${n} alias`;
-	if (!r.has(i)) return i;
-	for (let e = 2;; e++) {
-		let t = `${i} ${e}`;
-		if (!r.has(t)) return t;
-	}
-}
-var k = new Intl.Collator("en");
-function A(e, t) {
-	return h(e, t) ? v(e, t).sort((e, t) => k.compare(e.name, t.name) || N(e, t)) : [];
-}
-var j = (e) => A(e, r), M = (e) => A(e, i), N = (e, t) => e.createdAt - t.createdAt || (e.id < t.id ? -1 : 1);
-function P(e, t) {
-	let n = { ...e };
-	return t ? (n.left = t.left, n.top = t.top) : (delete n.left, delete n.top), n;
-}
-function F(o) {
-	let { storage: s, volumes: c = {}, system: d, listed: p = () => !0, hooks: g = () => void 0, placeDelay: v = 400 } = o, y = () => (o.now ?? Date.now)(), b = () => o.newId ? o.newId() : crypto.randomUUID(), S = [], E = (e, t, n, r) => S.push({
-		id: e,
-		name: t,
-		kind: n,
-		parent: r,
-		createdAt: 0,
-		modifiedAt: 0
-	});
-	c.disk && E(t, c.disk, t, null), c.trash !== !1 && E(e, c.trash ?? "Trash", e, null), d && (E(n, d.folder, a, c.disk ? t : null), E(r, d.appleMenu, a, n), E(i, d.startup, a, n));
-	let O = /* @__PURE__ */ new Map(), k = !1, A = !1, j = F(), M = /* @__PURE__ */ new Set();
-	function F() {
-		let e = S.map((e) => {
-			let t = O.get(e.id);
-			return t?.left != null && t.top != null ? {
-				...e,
-				left: t.left,
-				top: t.top
-			} : e;
-		}), t = [...O.values()].filter((e) => !f(e.id) && (e.kind === "folder" || p(e.kind))).sort(N);
-		return {
-			available: k,
-			items: [...e, ...t]
-		};
-	}
-	function I() {
-		j = F();
-		for (let e of [...M]) e(j);
-	}
-	let L = () => {
-		if (!s) throw Error("storage is unavailable");
-		return s;
-	};
-	async function R(e) {
-		await L().put(e), O.set(e.id, e);
-	}
-	let z = /* @__PURE__ */ new Set(), B = null;
-	async function V() {
-		B && clearTimeout(B), B = null;
-		let e = [...z];
-		if (z.clear(), !(!s || !k)) for (let t of e) {
-			let e = O.get(t);
-			e && await s.put(e).catch(() => {});
-		}
-	}
-	let H = (e) => {
-		let t = S.find((t) => t.id === e);
-		return O.get(e) ?? {
-			...t,
-			name: ""
-		};
-	};
-	async function U() {
-		z.clear();
-		for (let e of await L().list()) e.id !== l && (await L().remove(e.id), O.delete(e.id));
-		O = /* @__PURE__ */ new Map();
-	}
-	let W = {
-		get: () => j,
-		subscribe(e) {
-			return M.add(e), () => {
-				M.delete(e);
-			};
-		},
-		item: (e) => h(j, e),
-		async refresh() {
-			if (!s) {
-				O = /* @__PURE__ */ new Map(), k = !1, I();
-				return;
-			}
-			try {
-				let e = await s.list();
-				O = /* @__PURE__ */ new Map(), A = !1;
-				for (let t of e) t.id === l ? A = !0 : O.set(t.id, t);
-				k = !0;
-			} catch (e) {
-				console.warn("vintage-frames/shell: the catalog could not be read —", e), O = /* @__PURE__ */ new Map(), k = !1;
-			}
-			I();
-		},
-		async seed(e) {
-			return !s || !k || A ? !1 : (await e(W), await s.put({
-				id: l,
-				name: "",
-				kind: l,
-				parent: null,
-				createdAt: y(),
-				modifiedAt: y()
-			}), A = !0, !0);
-		},
-		async create(e = {}) {
-			let t = _(j, e.parent ?? null);
-			if (C(j, t)) return null;
-			let n = e.kind ?? "folder", r = e.at ?? y(), i = {
-				id: b(),
-				name: e.name ?? (n === "folder" ? T(j, t) : "untitled"),
-				kind: n,
-				parent: t,
-				createdAt: r,
-				modifiedAt: r
-			};
-			return e.data !== void 0 && (i.data = e.data), e.left != null && e.top != null && (i = P(i, {
-				left: e.left,
-				top: e.top
-			})), await R(i), I(), i;
-		},
-		async rename(e, t) {
-			let n = O.get(e);
-			return !n || f(e) || n.name === t ? !1 : (await R({
-				...n,
-				name: t,
-				modifiedAt: y()
-			}), I(), !0);
-		},
-		async update(e, t) {
-			let n = O.get(e);
-			return !n || f(e) ? !1 : (await R({
-				...n,
-				data: t,
-				modifiedAt: y()
-			}), I(), !0);
-		},
-		async move(e, t, n) {
-			let r = _(j, t), i = [];
-			for (let t of e) {
-				let e = O.get(t);
-				!e || f(t) || r === t || r != null && u(e.kind) && x(j, r, t) || _(j, e.parent) !== r && (z.delete(t), await R(P({
-					...e,
-					parent: r
-				}, n?.get(t) ?? null)), i.push(t));
-			}
-			return i.length && I(), i;
-		},
-		place(e) {
-			let t = !1;
-			for (let [n, r] of e) {
-				let e = f(n) ? S.some((e) => e.id === n) ? H(n) : null : O.get(n);
-				!e || e.left === r.left && e.top === r.top || (O.set(n, P(e, r)), z.add(n), t = !0);
-			}
-			t && (I(), B && clearTimeout(B), B = setTimeout(() => void V(), v));
-		},
-		flush: V,
-		async copy(e, t) {
-			let n = _(j, t);
-			if (C(j, n)) return [];
-			let r = [];
-			for (let t of e) {
-				let e = h(j, t);
-				if (!e || f(t)) continue;
-				let i = u(e.kind) ? w(j, t) : [], a = /* @__PURE__ */ new Map(), o = async (e, t, n) => {
-					let r = y(), i = {
-						...e,
-						id: b(),
-						name: n ? D(j, t, e.name, e.kind) : e.name,
-						parent: t,
-						createdAt: r,
-						modifiedAt: r
-					};
-					return n && (i = P(i, null)), a.set(e.id, i.id), await R(i), await g(e.kind)?.copy?.(e, i), i;
-				};
-				r.push(await o(e, n, !0));
-				for (let e of i) await o(e, a.get(_(j, e.parent) ?? "") ?? null, !1);
-				I();
-			}
-			return r;
-		},
-		async emptyTrash() {
-			let t = w(j, e);
-			for (let e of t) await L().remove(e.id), O.delete(e.id), z.delete(e.id), await g(e.kind)?.onRemove?.(e);
-			return t.length && I(), t;
-		},
-		trashSize() {
-			return w(j, e).reduce((e, t) => e + (g(t.kind)?.size?.(t) ?? 0), 0);
-		},
-		dump() {
-			return { items: [...O.values()] };
-		},
-		async clear() {
-			if (s) try {
-				await U();
-			} finally {
-				I();
-			}
-		},
-		async import(e, { mode: t = "merge" } = {}) {
-			let n = /* @__PURE__ */ new Map(), r = e.items.filter((e) => e.id !== l && !f(e.id));
-			if (!r.length || !s) return n;
-			let i = t === "replace", a = /* @__PURE__ */ new Map();
-			for (let e of r) a.set(e.id, i ? e.id : b());
-			let o = (e) => e == null || f(e) ? e : a.get(e) ?? null;
-			try {
-				i && await U();
-				for (let e of r) {
-					let t = {
-						...e,
-						id: a.get(e.id),
-						parent: o(e.parent)
-					}, r = m(e);
-					r != null && a.has(r) && (t.data = {
-						...e.data,
-						original: a.get(r)
-					}), await R(t), n.set(e.id, t);
-				}
-			} finally {
-				I();
-			}
-			return n;
-		},
-		async dispose() {
-			await V(), M.clear();
-		}
-	};
-	return W;
-}
-function I(e = []) {
-	let t = new Map(e.map((e) => [e.id, e]));
-	return {
-		records: t,
-		list: async () => [...t.values()],
-		put: async (e) => t.set(e.id, e),
-		remove: async (e) => t.delete(e)
-	};
-}
-//#endregion
-export { s as ALIAS_KIND, r as APPLE_MENU_ITEMS, o as APP_KIND, t as DISK, a as FOLDER, i as STARTUP_ITEMS, n as SYSTEM_FOLDER, e as TRASH, c as UNTITLED_FOLDER, O as aliasName, p as appIdOf, j as appleMenuItemsOf, v as childrenOf, _ as containerOf, D as copyName, F as createCatalog, w as descendantsOf, S as enclosingFolders, u as isContainerKind, x as isInside, f as isKept, C as isTrashed, d as isVolume, y as itemCount, h as itemOf, I as memoryStorage, T as nextFolderName, m as originalOf, g as resolve, M as startupItemsOf };

package/dist/shell/clock.d.ts

@@ -1,16 +0,0 @@
-/**
- * The menu bar's clock: a label in the bar's `end` slot showing the time,
- * updated on the minute. A press shows the date for a few seconds; a second
- * press returns to the time early.
- */
-/** How long a press shows the date, ms. */
-export declare const DATE_HOLD_MS = 3000;
-/** "7:27 PM": 12-hour local time. */
-export declare function formatTime(d: Date): string;
-/** "9/27/26": M/D/YY local date. */
-export declare function formatDate(d: Date): string;
-/** Render the clock into `label` now and on every minute boundary. Returns the stop function. */
-export declare function startClock(label: HTMLElement, { now, holdMs }?: {
-    now?: () => number;
-    holdMs?: number;
-}): () => void;

package/dist/shell/clock.js

@@ -1,36 +0,0 @@
-//#region src/shell/clock.ts
-var e = 3e3, t = (e) => String(e).padStart(2, "0");
-function n(e) {
-	let n = e.getHours();
-	return `${n % 12 || 12}:${t(e.getMinutes())} ${n < 12 ? "AM" : "PM"}`;
-}
-function r(e) {
-	return `${e.getMonth() + 1}/${e.getDate()}/${t(e.getFullYear() % 100)}`;
-}
-function i(t, { now: i = Date.now, holdMs: a = e } = {}) {
-	let o = !1, s = 0, c = 0, l = () => {
-		let e = new Date(i());
-		t.textContent = o ? r(e) : n(e);
-	}, u = () => {
-		c = window.setTimeout(() => {
-			l(), u();
-		}, 6e4 - i() % 6e4 + 20);
-	}, d = () => {
-		clearTimeout(s), s = 0, o = !1, l();
-	}, f = (e) => {
-		if (e.button === 0) {
-			if (e.preventDefault(), o) {
-				d();
-				return;
-			}
-			o = !0, l(), s = window.setTimeout(d, a);
-		}
-	}, p = () => {
-		document.hidden || l();
-	};
-	return l(), u(), t.addEventListener("pointerdown", f), document.addEventListener("visibilitychange", p), () => {
-		clearTimeout(c), clearTimeout(s), t.removeEventListener("pointerdown", f), document.removeEventListener("visibilitychange", p);
-	};
-}
-//#endregion
-export { e as DATE_HOLD_MS, r as formatDate, n as formatTime, i as startClock };

package/dist/shell/filing.d.ts

@@ -1,39 +0,0 @@
-/**
- * Filing by drag: what a drop of icons means. A drop onto a folder icon
- * files the icons into that folder at its next free cells; a drop into a
- * folder window lands each icon where its outline was let go; a drop out of
- * a window onto the desktop the same. The folder under the pointer wears
- * `target`. A folder never goes into itself or a folder inside it, and a
- * drop over another application's window moves nothing. A drop inside the
- * icons' own field is the kit's: its default action moves them there.
- *
- * The Finder runs it over its catalog; a page of its own can run it over the
- * DOM, with callbacks that say what a container is and what filing does.
- */
-import type { VfDesktop, VfIcon, VfWindow } from '../index.js';
-import type { Point } from './geometry.js';
-/** What filing needs to know, and what it does. */
-export interface FilingOptions {
-    /**
-     * The container a window shows — a folder's id — or undefined for a
-     * window that holds no icons of the page's: a drop over it moves nothing.
-     */
-    folderOfWindow(win: VfWindow): string | undefined;
-    /** The container a folder icon opens — its folder's id — or undefined for any other icon. */
-    folderOfIcon(icon: VfIcon): string | undefined;
-    /**
-     * The container an icon sits in: a folder's id, or null for the desktop.
-     * Undefined for an icon filing leaves alone, another application's: its
-     * drags go by.
-     */
-    containerOf(icon: VfIcon): string | null | undefined;
-    /** Whether `icons` may go into `folder` (null: the desktop). */
-    canFile(icons: VfIcon[], folder: string | null): boolean;
-    /**
-     * File the icons into `folder` (null: the desktop), each at its landing
-     * there in whole system px, or null for the folder's next free cell.
-     */
-    file(icons: VfIcon[], folder: string | null, landings: Map<VfIcon, Point | null>): void;
-}
-/** Wire filing by drag on a desktop. Returns the teardown. */
-export declare function fileByDrag(desktop: VfDesktop, options: FilingOptions): () => void;

package/dist/shell/filing.js

@@ -1,68 +0,0 @@
-//#region src/shell/filing.ts
-function e(e, t) {
-	let { folderOfWindow: n, folderOfIcon: r, containerOf: i, canFile: a, file: o } = t, s = (t, i, a) => {
-		let o = document.elementsFromPoint(t, i).filter((e) => !a.includes(e)), s = o.findIndex((e) => e.localName === "vf-window"), c = (s < 0 ? o : o.slice(0, s)).find((e) => e.localName === "vf-icon" && r(e) !== void 0) ?? null, l = s < 0 ? null : o[s];
-		return {
-			folderIcon: c,
-			folder: c ? r(c) : void 0,
-			win: l,
-			window: l ? n(l) : void 0,
-			desktop: !l && o.includes(e)
-		};
-	}, c = null, l = (e) => {
-		c !== e && (c && (c.target = !1), c = e, c && (c.target = !0));
-	}, u = (e) => {
-		if (i(e.target) === void 0) return;
-		let { clientX: t, clientY: n, icons: r } = e.detail, o = s(t, n, r);
-		l(o.folderIcon && a(r, o.folder ?? null) ? o.folderIcon : null);
-	}, d = () => l(null), f = (t) => {
-		let n = t.target, r = i(n);
-		if (r === void 0) return;
-		let { clientX: c, clientY: u, x: d, y: f, icons: p } = t.detail, m = s(c, u, p);
-		l(null);
-		let h = n.getBoundingClientRect(), g = p.map((e) => {
-			let t = e.getBoundingClientRect();
-			return {
-				icon: e,
-				x: t.left + (d - h.left),
-				y: t.top + (f - h.top)
-			};
-		});
-		if (m.folder !== void 0) {
-			t.preventDefault(), a(p, m.folder) && o(p, m.folder, new Map(p.map((e) => [e, null])));
-			return;
-		}
-		if (m.win && m.window === void 0) {
-			t.preventDefault();
-			return;
-		}
-		if (m.win && m.window !== void 0 && m.window !== r) {
-			if (t.preventDefault(), !a(p, m.window)) return;
-			let e = m.win;
-			o(p, m.window, new Map(g.map(({ icon: t, x: n, y: r }) => {
-				let i = e.placementAt(n, r);
-				return [t, {
-					left: Math.max(0, i.left),
-					top: Math.max(0, i.top)
-				}];
-			})));
-			return;
-		}
-		if (m.desktop && r !== null) {
-			if (t.preventDefault(), !a(p, null)) return;
-			let n = e.workArea.top;
-			o(p, null, new Map(g.map(({ icon: t, x: r, y: i }) => {
-				let a = e.placementAt(r, i);
-				return [t, {
-					left: Math.max(0, a.left),
-					top: Math.max(n, a.top)
-				}];
-			})));
-		}
-	};
-	return e.addEventListener("vf-drag", u), e.addEventListener("vf-drag-cancel", d), e.addEventListener("vf-drop", f), () => {
-		l(null), e.removeEventListener("vf-drag", u), e.removeEventListener("vf-drag-cancel", d), e.removeEventListener("vf-drop", f);
-	};
-}
-//#endregion
-export { e as fileByDrag };

package/dist/shell/finder.d.ts

@@ -1,179 +0,0 @@
-/**
- * The Finder: the stock application that shows the catalog as icons on the
- * desktop and in folder windows.
- *
- * - Icons are reconciled from the catalog into each container's field: the
- *   desktop's, and that of every open folder window. An icon that changes
- *   container moves with its item and keeps its selection.
- * - Positions are the items'. An icon is placed where its item says, and an
- *   item with none takes its container's next free cell — the Trash the
- *   desktop's bottom-right corner. Every move (a drag, a nudge, a Clean Up
- *   landing, the resize rule) goes back onto the item. The desktop's lattice
- *   runs down its right edge below the menu bar; a folder's runs in rows. On
- *   a raster resize the desktop's icons re-pin by the nine-slice rule.
- * - A press anywhere in the desktop's field, on an icon or the bare desktop,
- *   brings the Finder forward. The selection survives an application switch.
- * - Folder windows are made on open and removed on close, each with its item
- *   count in the header and a field sized to the scroll range.
- * - A window closes into its item's icon, else the nearest open folder
- *   around it. An application's icon stands for the application: it is drawn
- *   open while the application has a window open, and the application's own
- *   windows close into it.
- * - An alias wears its original's art with its name in italics, and opens
- *   its original; with the original gone, an alert says so. Make Alias makes
- *   one beside each selected application or document.
- * - Menus: File (Open, New Folder, Close, Make Alias), Edit (Copy, Paste,
- *   Select All), View (Arrange Windows), Special (Clean Up, Empty Trash…),
- *   each disabled while it has nothing to act on. A site switches commands
- *   off and adds its own.
- * - Alerts are the Finder's own, composed with the site's caution art and
- *   held by it while they are up. A site answers any of them with its own
- *   dialog through `alertWith`.
- */
-import type { VfIcon, VfMenuItem, VfViewportBox } from '../index.js';
-import type { Catalog, CatalogStorage, Item, SystemFolders, Volumes } from './catalog.js';
-import type { LatticeOptions, Size } from './geometry.js';
-import type { AppContext, AppDefinition } from './shell.js';
-/** The Finder's application id. */
-export declare const FINDER = "finder";
-/** The Finder's art: the kit ships none. */
-export interface FinderArt {
-    /** 32×32, as each of these. */
-    folder: string;
-    /** The Trash, empty and full. */
-    trash: string;
-    trashFull: string;
-    /** An item whose kind has no art of its own. */
-    document: string;
-    /** The startup disk; the folder's art without it. */
-    disk?: string;
-    /** The System Folder and its two folders; the folder's art without them. */
-    systemFolder?: string;
-    appleMenuItems?: string;
-    startupItems?: string;
-    /** 12×12: the mark before the item count in the Trash's window and trashed folders. */
-    trashMark?: string;
-    /** 32×32: beside the message in the Finder's alerts. Without it they have no art. */
-    caution?: string;
-}
-/** What a failed command was, in the `failed` alert. */
-export type FinderFailedAction = 'new-folder' | 'empty-trash' | 'paste' | 'add-file' | 'make-alias';
-/** The Finder's alerts, by id, with the details each one's handler gets. */
-export interface FinderAlerts {
-    /** Special → Empty Trash…: an answer of `'ok'` empties the Trash. */
-    'empty-trash': {
-        count: number;
-        bytes: number;
-    };
-    /** New Folder, Paste, a dropped file or `storageReady()`, without storage. */
-    'storage-unavailable': Record<string, never>;
-    /** A rename past the limit. */
-    'name-too-long': {
-        limit: number;
-    };
-    /** A rename to nothing. */
-    'name-rejected': Record<string, never>;
-    /** A filing storage refused. */
-    'move-failed': {
-        error: Error;
-    };
-    /** Opening an alias whose original is gone. */
-    'original-missing': {
-        alias: Item;
-    };
-    /** New Folder, Empty Trash, Paste, Make Alias or a dropped file failed. */
-    failed: {
-        action: FinderFailedAction;
-        error: Error;
-    };
-}
-/** One of the Finder's alerts. */
-export type FinderAlert = keyof FinderAlerts;
-/** Answers one of the Finder's alerts: resolves the answer, or null. */
-export type FinderAlertHandler<K extends FinderAlert> = (details: FinderAlerts[K]) => string | null | Promise<string | null>;
-/** The Finder's own commands, each of which a site can switch off. */
-export type FinderCommand = 'open' | 'new-folder' | 'close' | 'make-alias' | 'copy' | 'paste' | 'select-all' | 'arrange' | 'clean-up' | 'empty-trash';
-/** The Finder's menus, by `data-menu`. */
-export type FinderMenu = 'file' | 'edit' | 'view' | 'special';
-/** A command a site adds to the Finder's menus. */
-export interface FinderCommandSpec {
-    menu: FinderMenu;
-    /** The item's `value`, unique among the Finder's. */
-    value: string;
-    label: string;
-    shortcut?: string;
-    /** Put a separator before it. */
-    separator?: boolean;
-    run(): void;
-    /** Whether it has anything to act on; disabled while false. */
-    enabled?(): boolean;
-}
-/** What the Finder's `open` action takes: the item to open, and the box it opens out of. */
-export interface FinderOpen {
-    item?: string | null;
-    from?: VfViewportBox | null;
-}
-/** The Finder's actions, for a site's extension and other applications. */
-export interface FinderApi {
-    readonly catalog: Catalog;
-    /** The selected items, volumes included, in listing order. */
-    selection(): Item[];
-    /** Make `ids` the selection. */
-    select(ids: readonly string[]): void;
-    /** The folder whose window is active, or null for the desktop. */
-    activeFolder(): string | null;
-    /** Open an item as a double-click would: a folder's window, or the item's kind. The boot reopens folder windows through it. */
-    open(target?: FinderOpen): void;
-    /** Select an item's icon and open its rename box. */
-    rename(id: string): Promise<void>;
-    /** Clean Up a container (null: the desktop). */
-    cleanUp(folder: string | null): Promise<void>;
-    /** An item's icon, where one is rendered. */
-    iconFor(id: string): VfIcon | null;
-    /** Add a command to the Finder's menus. Call it from `extend`, before the menus first reach the bar. */
-    addCommand(spec: FinderCommandSpec): VfMenuItem;
-    /** Answer one of the Finder's alerts with the site's own dialog. Call it from `extend`. */
-    alertWith<K extends FinderAlert>(id: K, handler: FinderAlertHandler<K>): void;
-    /**
-     * Whether storage answers. When it doesn't, raises Storage Unavailable —
-     * the site's answer to it, where `alertWith` gave one — and returns false.
-     */
-    storageReady(): boolean;
-}
-export interface FinderOptions {
-    /** Where the catalog is kept: `memoryStorage()`, `indexedDbStorage(name)`, the site's own, or null for nothing. */
-    storage: CatalogStorage | null;
-    art: FinderArt;
-    /** The volumes: the Trash by default, and a startup disk when named. */
-    volumes?: Volumes;
-    /**
-     * The System Folder and its folders, named: what Apple Menu Items holds is
-     * the Apple menu, and what Startup Items holds opens at startup. Unset, none.
-     */
-    system?: SystemFolders;
-    /**
-     * What the catalog starts with, stored once per storage: `'markup'` reads
-     * the `<vf-icon data-app>` and `<template data-folder="Name">` the page
-     * put in the desktop's field, and a `<template data-system="apple-menu-items">`
-     * files what it holds in that folder of the System Folder; a function
-     * stores the site's defaults.
-     */
-    seed?: 'markup' | ((catalog: Catalog) => void | Promise<void>);
-    /** The lattices' cells, pitches and insets (default: 64px cells, 80px columns, 72px rows, 16px insets). */
-    lattice?: {
-        desktop?: LatticeOptions;
-        folder?: LatticeOptions;
-    };
-    /** Clean Up the desktop once a resize settles with icons overlapping. Default false. */
-    cleanUpAfterResize?: boolean;
-    /** Switch commands off: `{ 'empty-trash': false }`. */
-    commands?: Partial<Record<FinderCommand, boolean>>;
-    /** The site's dialogs for the Finder, each with a `data-dialog` name, held by it: `ctx.dialog(name)` in `extend`. */
-    dialogs?: string;
-    /** Add the site's own commands, and answer the Finder's alerts. */
-    extend?(finder: FinderApi, ctx: AppContext): void;
-    /** A folder window's size, system px. Default 320 × 223: three columns and two rows of icons. */
-    window?: Size;
-}
-/** The Finder, as an application of the shell. */
-export declare function finder(options: FinderOptions): AppDefinition<FinderApi>;