vintage-frames 0.18.0 → 0.19.0

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,12 @@
  *   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
+ *   `resolve` finds the original wherever it moved, until it is removed.
  * - 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 +36,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 +92,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 +131,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. */
@@ -142,6 +176,12 @@ 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[];
 /** The catalog's operations, over its listing. */
 export interface Catalog {
     get(): CatalogState;