vintage-frames 0.18.0 → 0.19.1

package/dist/menu-press.d.ts

@@ -21,8 +21,7 @@ export interface MenuPressTarget {
  * driven: **press a title, keep the button down, slide onto a command, release
  * over it to run it.** Sliding sideways onto another title switches menus
  * mid-press; releasing over a disabled row, a separator, the title, or off the
- * menu entirely closes with nothing chosen (the classic "release outside"
- * cancel).
+ * menu entirely closes with nothing chosen (the classic "release outside").
  *
  * The modern click-to-open style coexists, disambiguated by the gesture itself
  * and resolved at the first release: a quick in-place tap on a title (under
@@ -31,15 +30,28 @@ export interface MenuPressTarget {
  * in-place release — any press that travels to another title or row is a
  * drag-pick however long it took.
  *
+ * **One pointer model for both.** While a menu is open the pointer is tracked
+ * with or without a button down; the button only changes what a release
+ * means. Each open menu highlights the row under the pointer, or, with the
+ * pointer elsewhere, the item whose submenu is open. The pointer resting on
+ * an item for {@link SUBMENU_OPEN_MS} opens its submenu, and an open submenu
+ * stays {@link SUBMENU_CLOSE_MS} after the pointer moves onto another row of
+ * its menu, so a diagonal slide into it can cross the rows between. A release
+ * on an item that opens a submenu chooses nothing: the submenu opens now, and
+ * every menu stays dropped for clicking on.
+ *
  * Everything is hit-tested by **coordinates**, not by event target, for the
  * same reason `vf-select` is: under touch, the pointer is implicitly captured
  * by the element the gesture started on, so every move and the release itself
  * are delivered to the pressed title no matter what they are actually over.
+ * The open menus are tried deepest first, since a submenu is painted over its
+ * parent.
  *
  * The host binds {@link onPointerDown} to a `pointerdown` on itself — presses
- * on titles and rows both bubble up composed — and supplies a
- * {@link MenuPressTarget}. Everything else (tracking to the release anywhere on
- * the page, the row highlight, classification) lives here.
+ * on titles and rows both bubble up composed — calls {@link track} as its
+ * menus open and close, and supplies a {@link MenuPressTarget}. Everything
+ * else (tracking to the release anywhere on the page, the highlight, the
+ * submenus, classification) lives here.
  */
 export declare class MenuPressController implements ReactiveController {
     #private;
@@ -47,10 +59,16 @@ export declare class MenuPressController implements ReactiveController {
     constructor(host: ReactiveControllerHost, target: MenuPressTarget);
     /**
      * Host torn down mid-gesture. The listener controller detaches itself; drop
-     * the press state and any highlight it stamped on a row, which the normal
-     * close path is no longer going to run for.
+     * the press and tracking state, which the normal close path is no longer
+     * going to run for.
      */
     hostDisconnected(): void;
+    /**
+     * The host opened (`true`) or closed (`false`) its menus. While one is open
+     * the pointer is tracked with or without a button down, so a resting mouse
+     * highlights rows and opens submenus in the click-to-open style too.
+     */
+    track(open: boolean): void;
     /**
      * Starts a press: drops the menu under the pointer if it isn't already, then
      * tracks the press to its release. Both interaction styles begin here; the

package/dist/menu-press.js

@@ -1,7 +1,8 @@
 import { DocumentListenersController as e } from "./document-listeners.js";
 import "./motion.js";
+import { openPath as t } from "./menu-navigation.js";
 //#region src/menu-press.ts
-var t = class {
+var n = class {
 	#e;
 	#t;
 	#n;
@@ -9,89 +10,122 @@ var t = class {
 	#i;
 	#a;
 	#o;
+	#s;
+	#c;
+	#l;
 	constructor(t, n) {
-		this.target = n, this.#e = !1, this.#t = !1, this.#n = !1, this.#r = null, this.#i = 0, this.#a = null, this.onPointerDown = (e) => {
+		this.target = n, this.#e = !1, this.#t = !1, this.#n = !1, this.#r = null, this.#i = 0, this.#a = !1, this.#o = !1, this.#s = null, this.onPointerDown = (e) => {
 			if (e.button > 0 || !e.isPrimary) return;
-			let t = this.#p(e.clientX, e.clientY);
-			if (t) {
-				if (e.preventDefault(), this.#e = !0, this.#n = !1, this.#r = t.item ?? t.menu, this.#i = e.timeStamp, this.#t = !t.menu.open, this.#o.attach(), t.item) {
-					this.#f(t.item);
+			let t = this.#_(e.clientX, e.clientY);
+			if (!(!t || !t.title && !t.item)) {
+				if (e.preventDefault(), this.#e = !0, this.#n = !1, this.#r = t.item ?? t.menu, this.#i = e.timeStamp, this.#t = !t.menu.open, this.#l.attach(), t.item) {
+					this.#h(t);
 					return;
 				}
 				t.menu.focus(), this.#t && this.target.open(t.menu);
 			}
-		}, this.#s = (e) => {
-			if (!this.#e) return;
-			e.preventDefault();
-			let t = this.#p(e.clientX, e.clientY), n = t ? t.item ?? t.menu : null;
-			!this.#n && n !== this.#r && (this.#n = !0), t && !t.item && !t.menu.open && this.target.open(t.menu), this.#f(t?.item ?? null);
-		}, this.#c = (e) => {
+		}, this.#u = (e) => {
+			if (this.#o) return;
+			let t = this.#_(e.clientX, e.clientY);
+			if (this.#e) {
+				e.preventDefault();
+				let n = t ? t.item ?? (t.title ? t.menu : null) : null;
+				!this.#n && n !== this.#r && (this.#n = !0), t?.title && !t.menu.open && this.target.open(t.menu);
+			}
+			this.#h(t);
+		}, this.#d = (e) => {
 			if (!this.#e) return;
-			let t = this.#p(e.clientX, e.clientY), n = this.#t, r = !this.#n, i = e.timeStamp - this.#i < 200;
-			this.#u(), !(n && r && i) && this.#d(t?.item ?? null);
-		}, this.#l = () => {
-			this.#u(), this.#f(null);
-		}, t.addController(this), this.#o = new e(t, () => [
+			let t = this.#_(e.clientX, e.clientY), n = this.#t, r = !this.#n, i = e.timeStamp - this.#i < 200;
+			this.#p(), !(n && r && i) && this.#m(t && !t.title ? t : null);
+		}, this.#f = () => {
+			this.#p(), this.#h(null);
+		}, t.addController(this), this.#l = new e(t, () => [
 			[
 				document,
 				"pointermove",
-				this.#s,
+				this.#u,
 				!0
 			],
 			[
 				document,
 				"pointerup",
-				this.#c,
+				this.#d,
 				!0
 			],
 			[
 				document,
 				"pointercancel",
-				this.#l,
+				this.#f,
 				!0
 			]
 		]);
 	}
 	hostDisconnected() {
-		this.#u(), this.#f(null);
+		this.#p(), this.track(!1);
 	}
-	#s;
-	#c;
-	#l;
-	#u() {
-		this.#e && (this.#e = !1, this.#r = null, this.#o.detach());
+	track(e) {
+		if (this.#a = e, e) {
+			this.#l.attach();
+			return;
+		}
+		this.#o = !1, this.#s = null, this.#g(), this.#e || this.#l.detach();
 	}
-	#d(e) {
-		if (!e || e.disabled) {
-			this.#f(null), this.target.close();
+	#u;
+	#d;
+	#f;
+	#p() {
+		this.#e && (this.#e = !1, this.#r = null, this.#a || this.#l.detach());
+	}
+	#m(e) {
+		let t = e?.item;
+		if (!e || !t || t.disabled) {
+			this.target.close();
 			return;
 		}
-		this.#f(e), this.#a = null, e.activate();
+		if (this.#g(), t.submenu) {
+			e.menu.expand(t);
+			return;
+		}
+		this.#h(e), this.#o = !0, t.activate();
+	}
+	#h(e) {
+		let n = e && !e.title ? {
+			menu: e.menu,
+			row: e.item && !e.item.disabled ? e.item : null
+		} : null, r = this.#s;
+		if (r?.menu === n?.menu && r?.row === n?.row) return;
+		this.#s = n;
+		for (let e of this.target.menus()) if (e.open) for (let r of t(e)) r.pointerOver(r === n?.menu ? n.row : void 0);
+		if (this.#g(), !n) return;
+		let { menu: i, row: a } = n, o = i.expandedItem;
+		(a === null || a !== o) && (o ? this.#c = window.setTimeout(() => i.expand(a?.submenu ? a : null), 300) : a?.submenu && (this.#c = window.setTimeout(() => i.expand(a), 150)));
 	}
-	#f(e) {
-		let t = e && !e.disabled ? e : null;
-		t !== this.#a && (this.#a && (this.#a.active = !1), this.#a = t, t && (t.active = !0));
+	#g() {
+		this.#c !== void 0 && window.clearTimeout(this.#c), this.#c = void 0;
 	}
-	#p(e, t) {
-		let r = this.target.menus(), i = r.find((e) => e.open);
-		if (i) {
-			for (let r of i.allItems) if (n(r.getBoundingClientRect(), e, t)) return {
+	#_(e, n) {
+		let i = this.target.menus(), a = i.find((e) => e.open);
+		if (a) for (let i of t(a).reverse()) {
+			let t = i.panelRect;
+			if (!(!t || !r(t, e, n))) return {
 				menu: i,
-				item: r
+				title: !1,
+				item: i.allItems.find((t) => r(t.getBoundingClientRect(), e, n)) ?? null
 			};
 		}
-		for (let i of r) {
-			let r = i.labelRect;
-			if (r && n(r, e, t)) return {
-				menu: i,
+		for (let t of i) {
+			let i = t.labelRect;
+			if (i && r(i, e, n)) return {
+				menu: t,
+				title: !0,
 				item: null
 			};
 		}
 		return null;
 	}
 };
-function n(e, t, n) {
+function r(e, t, n) {
 	return t >= e.left && t < e.right && n >= e.top && n < e.bottom;
 }
 //#endregion
-export { t as MenuPressController };
+export { n as MenuPressController };

package/dist/motion.d.ts

@@ -19,6 +19,16 @@ export declare function prefersReducedMotion(): boolean;
  * drag-pick regardless of duration.
  */
 export declare const PRESS_HOLD_MS = 200;
+/**
+ * How long (ms) the pointer rests on a menu item before its submenu opens,
+ * and how long it may stray onto another row of the same menu before an open
+ * submenu closes. The second is the longer, so a diagonal slide from an item
+ * into its submenu can cross the rows between. Not gated on
+ * `prefers-reduced-motion`: they are the interaction, not decoration, the
+ * reasoning {@link MENU_SCROLL_INTERVAL_MS} gives. Provisional, tuned by hand.
+ */
+export declare const SUBMENU_OPEN_MS = 150;
+export declare const SUBMENU_CLOSE_MS = 300;
 /**
  * How long (ms) a press on a selected icon's name waits before it opens the
  * rename box — long enough that a double-click has already declared itself.

package/dist/shell/app-file.d.ts

@@ -5,13 +5,21 @@
  * the chunks and any decoder skips them.
  *
  * This is the reading half: the reader, checking a version against a range,
- * putting versions in order, and the scale every box is drawn at. It is
- * pure and runs the same under Node and in a page, through the platform's
- * compression streams. Writing an app file, and the box, are
- * `vintage-frames/build`'s.
+ * putting versions in order, the app API levels and whether this kit runs an
+ * application, and the scale every box is drawn at. It is pure and runs the
+ * same under Node and in a page, through the platform's compression streams.
+ * Writing an app file, and the box, are `vintage-frames/build`'s.
  */
 /** The app file format this kit reads and writes. */
 export declare const APP_FILE_FORMAT = 1;
+/**
+ * The app API this kit provides: the level of what a built application can
+ * use of it. It goes up when something in it changes or goes away, and never
+ * for an addition. app-api.json lists what it covers.
+ */
+export declare const APP_API = 2;
+/** The oldest app API this kit still runs. */
+export declare const APP_API_OLDEST = 2;
 /**
  * One system px of an app file's box, in its picture's px: every box of
  * this format is drawn at 3×, each system px a 3 × 3 block.
@@ -29,6 +37,8 @@ export interface AppManifest {
     version: string;
     /** The kit range the code was built and checked against: `^0.17.0`. */
     requires: string;
+    /** The app API the code was built against, {@link APP_API}. A file from before levels has none. */
+    api?: number;
     author: string;
     /** What the application is, in a sentence or two of plain text. */
     description?: string;
@@ -97,3 +107,9 @@ export declare function compareVersions(a: string, b: string): number;
  * false.
  */
 export declare function satisfies(version: string, range: string): boolean;
+/**
+ * Whether this kit runs the application a manifest describes: one built at
+ * an app API from {@link APP_API_OLDEST} to {@link APP_API}, or, for a file
+ * from before levels, one whose `requires` this kit's version meets.
+ */
+export declare function appRuns(manifest: Pick<AppManifest, 'requires' | 'api'>): boolean;

package/dist/shell/app-file.js

@@ -1,28 +1,30 @@
+import { VERSION as e } from "./version.js";
 //#region src/shell/app-file.ts
-var e = 1, t = 3, n = "vintage-frames.app", r = "vintage-frames.code", i = [
+var t = 1, n = 2, r = 2, i = 3, a = "vintage-frames.app", o = "vintage-frames.code", s = [
 	"id",
 	"name",
 	"version",
 	"requires",
+	"api",
 	"author",
 	"description",
 	"icon"
-], a = Uint8Array.of(137, 80, 78, 71, 13, 10, 26, 10), o = Uint32Array.from({ length: 256 }, (e, t) => {
+], c = Uint8Array.of(137, 80, 78, 71, 13, 10, 26, 10), l = Uint32Array.from({ length: 256 }, (e, t) => {
 	let n = t;
 	for (let e = 0; e < 8; e++) n = n & 1 ? 3988292384 ^ n >>> 1 : n >>> 1;
 	return n >>> 0;
 });
-function s(e) {
+function u(e) {
 	let t = 4294967295;
-	for (let n of e) t = o[(t ^ n) & 255] ^ t >>> 8;
+	for (let n of e) t = l[(t ^ n) & 255] ^ t >>> 8;
 	return (t ^ 4294967295) >>> 0;
 }
-function c(e) {
-	if (e.length < 8 || a.some((t, n) => e[n] !== t)) return null;
+function d(e) {
+	if (e.length < 8 || c.some((t, n) => e[n] !== t)) return null;
 	let t = new DataView(e.buffer, e.byteOffset, e.byteLength), n = [], r = 8;
 	for (; r + 12 <= e.length;) {
 		let i = r + 12 + t.getUint32(r);
-		if (i > e.length || s(e.subarray(r + 4, i - 4)) !== t.getUint32(i - 4)) return null;
+		if (i > e.length || u(e.subarray(r + 4, i - 4)) !== t.getUint32(i - 4)) return null;
 		let a = String.fromCharCode(...e.subarray(r + 4, r + 8));
 		if (n.push({
 			type: a,
@@ -34,85 +36,91 @@ function c(e) {
 	}
 	return null;
 }
-function l(e) {
+function f(e) {
 	let t = e.indexOf(0);
 	return t > 0 ? String.fromCharCode(...e.subarray(0, t)) : "";
 }
-var u = new TextDecoder("utf-8", { fatal: !0 });
-async function d(e) {
+var p = new TextDecoder("utf-8", { fatal: !0 });
+async function m(e) {
 	let t = e.indexOf(0), n = e[t + 1], r = e[t + 2], i = e.indexOf(0, t + 3), a = i < 0 ? -1 : e.indexOf(0, i + 1);
 	if (t < 1 || a < 0 || n > 1 || r !== 0) throw Error("a broken iTXt chunk");
 	let o = e.subarray(a + 1);
-	return u.decode(n ? await f(o) : o);
+	return p.decode(n ? await h(o) : o);
 }
-async function f(e) {
+async function h(e) {
 	let t = new Blob([e.slice()]).stream().pipeThrough(new DecompressionStream("deflate"));
 	return new Uint8Array(await new Response(t).arrayBuffer());
 }
-async function p(e) {
+async function g(e) {
 	let t = new Blob([e.slice()]).stream().pipeThrough(new CompressionStream("deflate"));
 	return new Uint8Array(await new Response(t).arrayBuffer());
 }
-function m(e) {
+function _(e) {
 	if (!e || typeof e != "object") return "its manifest is not an object";
 	let t = e;
 	if (t.format !== 1) return typeof t.format == "number" ? `it is format ${t.format}, and this kit reads format 1` : "its manifest has no format";
 	let n = { format: 1 };
-	for (let e of i) {
+	for (let e of s) {
 		let r = t[e];
+		if (e === "api") {
+			if (r === void 0) continue;
+			if (!Number.isInteger(r) || r < 1) return `its api, ${JSON.stringify(r)}, is not a level`;
+			n.api = r;
+			continue;
+		}
 		if (e === "description") {
 			if (r !== void 0 && typeof r != "string") return "its description is not text";
 			typeof r == "string" && r.trim() && (n.description = r);
 			continue;
 		}
 		if (typeof r != "string" || !r) return `its manifest has no ${e}`;
-		if (e === "version" && !y(r)) return `its version, ${r}, is not a version`;
-		if (e === "requires" && !b(r)) return `its requires, ${r}, is not a range`;
+		if (e === "version" && !S(r)) return `its version, ${r}, is not a version`;
+		if (e === "requires" && !C(r)) return `its requires, ${r}, is not a range`;
 		n[e] = r;
 	}
 	return n;
 }
-async function h(e) {
-	let t = c(e);
+async function v(e) {
+	let t = d(e);
 	if (!t) return "it is not a whole PNG";
-	let i = /* @__PURE__ */ new Map();
-	for (let { type: e, data: n } of t) {
+	let n = /* @__PURE__ */ new Map();
+	for (let { type: e, data: r } of t) {
 		if (e !== "iTXt") continue;
-		let t = l(n);
+		let t = f(r);
 		if (t === "vintage-frames.app" || t === "vintage-frames.code") {
-			if (i.has(t)) return `it has two ${t} chunks`;
-			i.set(t, n);
+			if (n.has(t)) return `it has two ${t} chunks`;
+			n.set(t, r);
 		}
 	}
-	let a = i.get(n), o = i.get(r);
-	if (!a && !o) return "it carries no application";
-	if (!a) return "its manifest is missing";
-	if (!o) return "its code is missing";
+	let r = n.get(a), i = n.get(o);
+	if (!r && !i) return "it carries no application";
+	if (!r) return "its manifest is missing";
+	if (!i) return "its code is missing";
 	let s;
 	try {
-		s = JSON.parse(await d(a));
+		s = JSON.parse(await m(r));
 	} catch {
 		return "its manifest does not read";
 	}
-	let u = m(s);
-	if (typeof u == "string") return u;
+	let c = _(s);
+	if (typeof c == "string") return c;
 	try {
 		return {
-			manifest: u,
-			code: await d(o)
+			manifest: c,
+			code: await m(i)
 		};
 	} catch {
 		return "its code does not inflate";
 	}
 }
-async function g(e) {
-	let t = await h(e);
+async function y(e) {
+	let t = await v(e);
 	return typeof t == "string" ? null : t;
 }
-var _ = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
-function v(e) {
+var b = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
+function x(e) {
 	if (typeof e != "string") return null;
-	let t = _.exec(e.trim().replace(/^v/, ""));
+	let t = b.exec(e.trim().replace(/^v/, ""));
 	return t ? {
 		core: [
 			Number(t[1]),
@@ -122,18 +130,18 @@ function v(e) {
 		pre: t[4] ? t[4].split(".") : []
 	} : null;
 }
-function y(e) {
-	return _.test(e);
+function S(e) {
+	return b.test(e);
 }
-function b(e) {
-	return y(e.startsWith("^") ? e.slice(1) : e);
+function C(e) {
+	return S(e.startsWith("^") ? e.slice(1) : e);
 }
-function x(e) {
+function w(e) {
 	if (typeof e != "string") return null;
 	let t = e.trim();
-	return v(t.startsWith("^") ? t.slice(1) : t);
+	return x(t.startsWith("^") ? t.slice(1) : t);
 }
-function S(e, t) {
+function T(e, t) {
 	for (let n = 0; n < 3; n++) if (e.core[n] !== t.core[n]) return e.core[n] - t.core[n];
 	if (!e.pre.length || !t.pre.length) return t.pre.length - e.pre.length;
 	for (let n = 0; n < Math.max(e.pre.length, t.pre.length); n++) {
@@ -146,14 +154,14 @@ function S(e, t) {
 	}
 	return 0;
 }
-function C(e, t) {
-	let n = v(e), r = v(t);
-	return n && r ? S(n, r) : !!n - +!!r;
+function E(e, t) {
+	let n = x(e), r = x(t);
+	return n && r ? T(n, r) : !!n - +!!r;
 }
-function w(e, t) {
-	let n = v(e), r = x(t);
+function D(e, t) {
+	let n = x(e), r = w(t);
 	if (!n || !r) return !1;
-	if (!t.trim().startsWith("^")) return S(n, r) === 0;
+	if (!t.trim().startsWith("^")) return T(n, r) === 0;
 	if (n.pre.length && !(r.pre.length && n.core.every((e, t) => e === r.core[t]))) return !1;
 	let [i, a, o] = r.core, s = {
 		core: i ? [
@@ -171,7 +179,11 @@ function w(e, t) {
 		],
 		pre: []
 	};
-	return S(n, r) >= 0 && S(n, s) < 0;
+	return T(n, r) >= 0 && T(n, s) < 0;
+}
+function O(t) {
+	let { api: n } = t;
+	return n === void 0 ? D(e, t.requires) : Number.isInteger(n) && n >= 2 && n <= 2;
 }
 //#endregion
-export { e as APP_FILE_FORMAT, t as BOX_SCALE, r as CODE_KEYWORD, n as MANIFEST_KEYWORD, a as PNG_SIGNATURE, C as compareVersions, s as crc32, p as deflate, f as inflate, h as inspectAppFile, y as isVersion, l as itxtKeyword, m as manifestOf, c as pngChunks, g as readAppFile, w as satisfies };
+export { n as APP_API, r as APP_API_OLDEST, t as APP_FILE_FORMAT, i as BOX_SCALE, o as CODE_KEYWORD, a as MANIFEST_KEYWORD, c as PNG_SIGNATURE, O as appRuns, E as compareVersions, u as crc32, g as deflate, h as inflate, v as inspectAppFile, S as isVersion, f as itxtKeyword, _ as manifestOf, d as pngChunks, y as readAppFile, D as satisfies };

package/dist/shell/catalog.d.ts

@@ -13,6 +13,14 @@
  *   never renamed, moved, copied or removed; nothing is made in the Trash.
  *   Deleting is a move into the Trash, and only Empty Trash removes. A
  *   volume's position is stored on a record of its own id.
+ * - The System Folder is kept the same way when the site names it: a folder
+ *   on the startup disk (the desktop without one) holding Apple Menu Items
+ *   and Startup Items, listed after the volumes. What they hold is anyone's,
+ *   and the shell reads it: the Apple menu, and what opens at startup.
+ * - An alias stands for another item: its data names the original's id and
+ *   kind, and `resolve` finds the original wherever it moved, until it is
+ *   removed. An alias of a container takes a drop for its original, and
+ *   keeps taking one, to say so, once the original is gone.
  * - A folder never goes into itself or a folder inside it. A parent with no
  *   record reads as the desktop.
  * - An item whose kind no application registers is left out of the listing
@@ -30,17 +38,25 @@ import type { Point } from './geometry.js';
 export declare const TRASH = "trash";
 /** The startup disk's id. */
 export declare const DISK = "disk";
+/** The System Folder's id: kept on the startup disk when the site names it. */
+export declare const SYSTEM_FOLDER = "system-folder";
+/** Apple Menu Items' id, in the System Folder: what it holds is the Apple menu. */
+export declare const APPLE_MENU_ITEMS = "apple-menu-items";
+/** Startup Items' id, in the System Folder: what it holds opens at startup. */
+export declare const STARTUP_ITEMS = "startup-items";
 /** A folder's kind. */
 export declare const FOLDER = "folder";
 /** An application's icon: the kind the shell registers, whose data names the application it opens. */
 export declare const APP_KIND = "app";
+/** An alias: the kind the shell registers, whose data names the item it stands for. */
+export declare const ALIAS_KIND = "alias";
 /** The name a new folder takes, counted up where it is taken. */
 export declare const UNTITLED_FOLDER = "untitled folder";
 /** One item of the catalog. */
 export interface Item {
     id: string;
     name: string;
-    /** `folder`, a volume's (`trash`, `disk`), the shell's `app`, or a kind an application registers. */
+    /** `folder`, a volume's (`trash`, `disk`), the shell's `app` or `alias`, or a kind an application registers. */
     kind: string;
     /** A folder's id, a volume's, or null for the desktop. */
     parent: string | null;
@@ -78,9 +94,17 @@ export interface Volumes {
     trash?: string | false;
     disk?: string | false;
 }
+/** The System Folder and its two folders, by name. A site that names them has them. */
+export interface SystemFolders {
+    folder: string;
+    appleMenu: string;
+    startup: string;
+}
 export interface CatalogOptions {
     storage: CatalogStorage | null;
     volumes?: Volumes;
+    /** The System Folder, on the startup disk. Unset, none. */
+    system?: SystemFolders;
     /** Whether an application registers `kind`. Folders are always listed. Default: every kind. */
     listed?(kind: string): boolean;
     /** A kind's payload hooks. */
@@ -109,10 +133,22 @@ export interface CatalogArchive {
 export declare const isContainerKind: (kind: string) => boolean;
 /** Whether `id` names a volume. */
 export declare const isVolume: (id: string | null | undefined) => boolean;
+/**
+ * Whether `id` names a container the catalog keeps, never renamed, moved,
+ * copied or removed: a volume, the System Folder or a folder in it.
+ */
+export declare const isKept: (id: string | null | undefined) => boolean;
 /** The application an `app` item stands for: its `data.app`, or null. */
 export declare function appIdOf(item: Item): string | null;
+/** The id of the item an alias stands for: its `data.original`, or null for anything but an alias. */
+export declare function originalOf(item: Item): string | null;
 /** The item with `id`, or null. */
 export declare function itemOf(state: CatalogState, id: string | null | undefined): Item | null;
+/**
+ * The item `id` names, or the original an alias stands for, through an alias
+ * of an alias too. Null once the original is gone, and for a chain that loops.
+ */
+export declare function resolve(state: CatalogState, id: string | null | undefined): Item | null;
 /** The container `parent` resolves to: that container while it is listed, else the desktop (null). */
 export declare function containerOf(state: CatalogState, parent: string | null | undefined): string | null;
 /** The items directly in a container (null: the desktop), in listing order. */
@@ -132,6 +168,26 @@ export declare function isInside(state: CatalogState, id: string, ancestor: stri
 export declare function enclosingFolders(state: CatalogState, id: string | null | undefined): string[];
 /** Whether `id` is the Trash or anything inside it. */
 export declare function isTrashed(state: CatalogState, id: string | null | undefined): boolean;
+/**
+ * Whether Make Alias takes item `id`: an application, a document, a folder
+ * or the startup disk, or an alias of one, outside the Trash. Never the
+ * Trash itself, and never an alias whose original is gone.
+ */
+export declare function canAlias(state: CatalogState, id: string | null | undefined): boolean;
+/** What a drop onto an item files into: a container's id, or the alias of a container whose original is gone. */
+export type DropTarget = {
+    folder: string;
+} | {
+    missing: Item;
+};
+/**
+ * What a drop onto item `id` files into. A container takes it itself, and
+ * an alias of one passes it to the original, so filing judges the original:
+ * a folder never goes into itself through an alias either. An alias of a
+ * container whose original is gone still takes the drop and files nothing:
+ * `missing`, the alias. Anything else takes none: null.
+ */
+export declare function dropTargetOf(state: CatalogState, id: string | null | undefined): DropTarget | null;
 /** Everything under a container, each container before what it holds; a loop is walked once. */
 export declare function descendantsOf(state: CatalogState, parent: string | null): Item[];
 /** The first free folder name in a container: "untitled folder", "untitled folder 2", … */
@@ -142,6 +198,28 @@ export declare function nextFolderName(state: CatalogState, parent: string | nul
  * then " copy 2", " copy 3", …
  */
 export declare function copyName(state: CatalogState, parent: string | null, name: string, kind: string): string;
+/** The name for an alias of `name` in a container: "name alias", then "name alias 2", … while an alias there has it. */
+export declare function aliasName(state: CatalogState, parent: string | null, name: string): string;
+/** What Apple Menu Items holds, by name: the Apple menu's entries. None without the System Folder. */
+export declare const appleMenuItemsOf: (state: CatalogState) => Item[];
+/** What Startup Items holds, by name: what opens at startup. None without the System Folder. */
+export declare const startupItemsOf: (state: CatalogState) => Item[];
+/** One entry of the Apple menu, and what it holds when it is a folder's. */
+export interface AppleMenuEntry {
+    /** The entry's own item: an alias stays the alias. */
+    item: Item;
+    /** What the folder holds, or the folder an alias stands for, by name. */
+    entries?: AppleMenuEntry[];
+}
+/**
+ * The Apple menu as a tree: what Apple Menu Items holds, by name, and for a
+ * folder in it, or an alias of one, what that folder holds, the same way,
+ * down to five levels below the menu. A folder already on the way down
+ * (Apple Menu Items starts it), an empty folder and a folder past the fifth
+ * level have no entries, so the tree never loops. None without the System
+ * Folder.
+ */
+export declare function appleMenuOf(state: CatalogState): AppleMenuEntry[];
 /** The catalog's operations, over its listing. */
 export interface Catalog {
     get(): CatalogState;