vintage-frames 0.18.0 → 0.19.1

package/dist/shell/catalog.js

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

package/dist/shell/finder.d.ts

@@ -19,16 +19,20 @@
  *   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.
- * - Menus: File (Open, New Folder, Close), 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.
+ * - An alias wears its original's art with its name in italics, and opens
+ *   its original; an alias of a folder or the disk also files a drop into
+ *   it. With the original gone, an alert says so. Make Alias makes one
+ *   beside each selected application, document, folder or disk.
+ * - 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, Volumes } from './catalog.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. */
@@ -44,13 +48,17 @@ export interface FinderArt {
     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';
+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. */
@@ -70,7 +78,11 @@ export interface FinderAlerts {
     'move-failed': {
         error: Error;
     };
-    /** New Folder, Empty Trash, Paste or a dropped file failed. */
+    /** Opening an alias whose original is gone, or a drop onto an alias of a folder 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;
@@ -81,7 +93,7 @@ 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' | 'copy' | 'paste' | 'select-all' | 'arrange' | 'clean-up' | 'empty-trash';
+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. */
@@ -135,10 +147,17 @@ export interface FinderOptions {
     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; a function stores the site's defaults.
+     * 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). */