vintage-frames 0.19.1 → 0.20.1

package/dist/shell/alert.js

@@ -1,41 +0,0 @@
-import { effectiveScale as e } from "../scale.js";
-import "../index.js";
-//#region src/shell/alert.ts
-var t = 10, n = 16, r = 32, i = 28;
-function a(a, o = {}) {
-	let { buttons: s = [{
-		label: "OK",
-		value: "ok",
-		default: !0
-	}], width: c = 400, art: l = null, label: u = "Alert" } = o, d = document.createElement("vf-dialog");
-	d.frame = "plain", d.label = u, d.width = c, d.height = 120;
-	let f = document.createElement("form");
-	f.method = "dialog", f.noValidate = !0;
-	let p = l ? 64 : n;
-	if (l) {
-		let e = document.createElement("vf-img");
-		e.width = r, e.height = r, e.left = n, e.top = n;
-		let t = document.createElement("img");
-		t.src = l, t.alt = "", e.append(t), f.append(e);
-	}
-	let m = document.createElement("vf-paragraph");
-	m.face = "display", m.width = c - t - p - n, m.left = p, m.top = n, m.textContent = a, f.append(m);
-	let h = document.createElement("vf-button-group");
-	return h.origin = "bottom right", h.append(...s.map((e) => {
-		let t = document.createElement("vf-button");
-		return t.textContent = e.label, t.type = "submit", t.value = e.value, e.default && (t.variant = "default"), t;
-	})), f.append(h), d.append(f), {
-		dialog: d,
-		rendered: () => Promise.all([
-			d.updateComplete,
-			m.updateComplete,
-			h.updateComplete
-		]),
-		fit() {
-			let r = Math.ceil(m.getBoundingClientRect().height / e(m)), a = Math.max(l ? 48 : 0, n + r) + n + i + n;
-			d.height = a + t, h.left = c - t - n, h.top = a - n;
-		}
-	};
-}
-//#endregion
-export { a as composeAlert };

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

@@ -1,115 +0,0 @@
-/**
- * App files: an application on the shell as one PNG. The picture is the
- * application's box; two iTXt chunks before IEND carry its manifest, as
- * JSON, and its code, one ES module compressed with zlib. Any PNG tool reads
- * the chunks and any decoder skips them.
- *
- * This is the reading half: the reader, checking a version against a range,
- * 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.
- */
-export declare const BOX_SCALE = 3;
-/** The iTXt keywords of the manifest's chunk and the code's. */
-export declare const MANIFEST_KEYWORD = "vintage-frames.app";
-export declare const CODE_KEYWORD = "vintage-frames.code";
-/** What an app file says about its application. */
-export interface AppManifest {
-    /** The app file's own format, {@link APP_FILE_FORMAT}. */
-    format: number;
-    id: string;
-    name: string;
-    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;
-    /** Its 32 × 32 icon: its PNG as a `data:` URL. */
-    icon: string;
-}
-/** An application, read from its app file. */
-export interface AppFile {
-    manifest: AppManifest;
-    /** One ES module. Its default export is the application's factory. */
-    code: string;
-}
-/** The eight bytes every PNG starts with. */
-export declare const PNG_SIGNATURE: Uint8Array<ArrayBuffer>;
-/** The CRC-32 a PNG chunk ends with, over its type and data. */
-export declare function crc32(bytes: Uint8Array): number;
-/** One chunk of a PNG. */
-export interface PngChunk {
-    type: string;
-    data: Uint8Array;
-    /** Where it sits in the file: its length's first byte, and the byte after its CRC. */
-    start: number;
-    end: number;
-}
-/**
- * A PNG's chunks, IEND last, or null when it isn't a whole PNG: the
- * signature is wrong, a chunk runs past the end, a CRC doesn't match, or
- * there is no IEND. Anything after IEND is left out.
- */
-export declare function pngChunks(bytes: Uint8Array): PngChunk[] | null;
-/** An iTXt chunk's keyword. */
-export declare function itxtKeyword(data: Uint8Array): string;
-/** zlib data, inflated. */
-export declare function inflate(bytes: Uint8Array): Promise<Uint8Array>;
-/** zlib data, deflated. */
-export declare function deflate(bytes: Uint8Array): Promise<Uint8Array>;
-/** A parsed manifest as one this kit reads, or what is wrong with it. */
-export declare function manifestOf(json: unknown): AppManifest | string;
-/**
- * The manifest and code an app file carries, or why it isn't one: not a
- * whole PNG, a chunk missing or doubled, a format this kit doesn't read, a
- * field missing or unreadable, or code that doesn't inflate. The reason ends
- * a sentence such as "Meteors.png is not an app file: …", and is for people:
- * its wording can change in any release, so match on nothing in it.
- */
-export declare function inspectAppFile(bytes: Uint8Array): Promise<AppFile | string>;
-/** The manifest and code an app file carries, or null for any other PNG. */
-export declare function readAppFile(bytes: Uint8Array): Promise<AppFile | null>;
-/**
- * Whether `text` is a version exactly as semver writes one: `0.1.0`,
- * `1.0.0-rc.1`, but not `v0.1.0`, ` 0.1.0` or `01.2.3`.
- */
-export declare function isVersion(text: string): boolean;
-/**
- * Below zero, zero or above as version `a` comes before, with or after `b`,
- * in semver's order: a release after its prereleases, build metadata
- * ignored. Anything that isn't a version, a string or not, comes before
- * every version, so a sort never throws.
- */
-export declare function compareVersions(a: string, b: string): number;
-/**
- * Whether `version` meets `range`: an exact version, or a caret range as
- * npm reads it. `^1.2.3` takes 1.x from 1.2.3 on, `^0.2.3` takes 0.2.x from
- * 0.2.3 on, and `^0.0.3` takes 0.0.3 alone. A prerelease meets a range only
- * when the range names a prerelease of the same version. Anything else is
- * 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,189 +0,0 @@
-import { VERSION as e } from "./version.js";
-//#region src/shell/app-file.ts
-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"
-], 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 u(e) {
-	let t = 4294967295;
-	for (let n of e) t = l[(t ^ n) & 255] ^ t >>> 8;
-	return (t ^ 4294967295) >>> 0;
-}
-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 || 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,
-			data: e.subarray(r + 8, i - 4),
-			start: r,
-			end: i
-		}), a === "IEND") return n;
-		r = i;
-	}
-	return null;
-}
-function f(e) {
-	let t = e.indexOf(0);
-	return t > 0 ? String.fromCharCode(...e.subarray(0, t)) : "";
-}
-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 p.decode(n ? await h(o) : o);
-}
-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 g(e) {
-	let t = new Blob([e.slice()]).stream().pipeThrough(new CompressionStream("deflate"));
-	return new Uint8Array(await new Response(t).arrayBuffer());
-}
-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 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" && !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 v(e) {
-	let t = d(e);
-	if (!t) return "it is not a whole PNG";
-	let n = /* @__PURE__ */ new Map();
-	for (let { type: e, data: r } of t) {
-		if (e !== "iTXt") continue;
-		let t = f(r);
-		if (t === "vintage-frames.app" || t === "vintage-frames.code") {
-			if (n.has(t)) return `it has two ${t} chunks`;
-			n.set(t, r);
-		}
-	}
-	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 m(r));
-	} catch {
-		return "its manifest does not read";
-	}
-	let c = _(s);
-	if (typeof c == "string") return c;
-	try {
-		return {
-			manifest: c,
-			code: await m(i)
-		};
-	} catch {
-		return "its code does not inflate";
-	}
-}
-async function y(e) {
-	let t = await v(e);
-	return typeof t == "string" ? null : t;
-}
-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 = b.exec(e.trim().replace(/^v/, ""));
-	return t ? {
-		core: [
-			Number(t[1]),
-			Number(t[2]),
-			Number(t[3])
-		],
-		pre: t[4] ? t[4].split(".") : []
-	} : null;
-}
-function S(e) {
-	return b.test(e);
-}
-function C(e) {
-	return S(e.startsWith("^") ? e.slice(1) : e);
-}
-function w(e) {
-	if (typeof e != "string") return null;
-	let t = e.trim();
-	return x(t.startsWith("^") ? t.slice(1) : 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++) {
-		let r = e.pre[n], i = t.pre[n];
-		if (r === void 0) return -1;
-		if (i === void 0) return 1;
-		if (r === i) continue;
-		let a = /^\d+$/.test(r), o = /^\d+$/.test(i);
-		return a && o ? Number(r) - Number(i) : a === o ? r < i ? -1 : 1 : a ? -1 : 1;
-	}
-	return 0;
-}
-function E(e, t) {
-	let n = x(e), r = x(t);
-	return n && r ? T(n, r) : !!n - +!!r;
-}
-function D(e, t) {
-	let n = x(e), r = w(t);
-	if (!n || !r) return !1;
-	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 ? [
-			i + 1,
-			0,
-			0
-		] : a ? [
-			0,
-			a + 1,
-			0
-		] : [
-			0,
-			0,
-			o + 1
-		],
-		pre: []
-	};
-	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 { 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

@@ -1,250 +0,0 @@
-/**
- * The catalog: what is where. Pure and DOM-free — it runs under Node — and
- * the source of truth for what a folder holds; the Finder renders it.
- *
- * - An item is a small record: a name, a kind, the container it sits in
- *   (`parent`, a folder's id, or null for the desktop) and, once placed, its
- *   position there in whole system px. A kind keeps small data of its own in
- *   `data`; a large payload stays in its application's own store, keyed by
- *   the item's id, and the kind's `copy` and `onRemove` keep that store in
- *   step.
- * - Volumes are containers no one made: the Trash and a startup disk, each
- *   if the page wants one. They lead the listing, keep their names, and are
- *   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
- *   and kept in storage.
- * - Storage is three calls over item records (list, put, remove). The
- *   catalog holds every record in memory, writes through to storage, and
- *   lists from memory; a position change writes after a short delay, since
- *   the resize rule moves every desktop icon on each resize event.
- * - A seed runs once per storage: a persistent one stores a marker record
- *   (`#seeded`), so a site that starts in memory and switches its storage
- *   seeds once there.
- */
-import type { Point } from './geometry.js';
-/** The Trash's id. */
-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 `alias`, or a kind an application registers. */
-    kind: string;
-    /** A folder's id, a volume's, or null for the desktop. */
-    parent: string | null;
-    /** Its place in its container, whole system px; unset, the next free cell. */
-    left?: number;
-    top?: number;
-    createdAt: number;
-    modifiedAt: number;
-    /** The kind's own, small and serializable. */
-    data?: unknown;
-}
-/** The listing: volumes first, then every listed item by creation. */
-export interface CatalogState {
-    /** Whether storage answers. Without it the catalog lists the volumes alone. */
-    available: boolean;
-    items: readonly Item[];
-}
-/** Where item records live. Any object with these three calls will do. */
-export interface CatalogStorage {
-    list(): Promise<Item[]>;
-    put(item: Item): Promise<unknown>;
-    remove(id: string): Promise<unknown>;
-}
-/** What a kind tells the catalog about its items' payloads. */
-export interface KindHooks {
-    /** Bytes, for Empty Trash's alert. */
-    size?(item: Item): number;
-    /** Copy `from`'s payload to `to`, a fresh copy of it. */
-    copy?(from: Item, to: Item): void | Promise<void>;
-    /** Empty Trash removed the item: drop its payload. */
-    onRemove?(item: Item): void | Promise<void>;
-}
-/** The volumes a page wants, by name; `false` or unset is none (the Trash defaults on). */
-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. */
-    hooks?(kind: string): KindHooks | undefined;
-    now?(): number;
-    newId?(): string;
-    /** How long a position change waits before it is written, ms. Default 400. */
-    placeDelay?: number;
-}
-/** What an operation makes: the new item, or null where it was refused. */
-export interface NewItem {
-    name?: string;
-    kind?: string;
-    parent?: string | null;
-    left?: number;
-    top?: number;
-    data?: unknown;
-    /** The creation time, for a batch made in order. Default now. */
-    at?: number;
-}
-/** A catalog dumped or restored: its item records. */
-export interface CatalogArchive {
-    items: Item[];
-}
-/** Whether `kind` holds other items: a folder or a volume. */
-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. */
-export declare function childrenOf(state: CatalogState, parent: string | null): Item[];
-/** How many items a container holds directly. */
-export declare function itemCount(state: CatalogState, parent: string | null): number;
-/**
- * Whether `ancestor` is on `id`'s chain of containers. An item is not inside
- * itself; a looping chain stops at its first repeat.
- */
-export declare function isInside(state: CatalogState, id: string, ancestor: string): boolean;
-/**
- * Container `id` and the containers around it, innermost first. The desktop
- * ends the chain, and so does an id with no container; a loop stops at its
- * first repeat.
- */
-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", … */
-export declare function nextFolderName(state: CatalogState, parent: string | null): string;
-/**
- * The name for a copy in a container: `name` itself while no item of its
- * kind there has it, else its base (less " copy" and " copy N") plus " copy",
- * 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;
-    subscribe(fn: (state: CatalogState) => void): () => void;
-    item(id: string | null | undefined): Item | null;
-    refresh(): Promise<void>;
-    seed(fn: (catalog: Catalog) => void | Promise<void>): Promise<boolean>;
-    create(input?: NewItem): Promise<Item | null>;
-    rename(id: string, name: string): Promise<boolean>;
-    update(id: string, data: unknown): Promise<boolean>;
-    move(ids: readonly string[], parent: string | null, landings?: ReadonlyMap<string, Point | null>): Promise<string[]>;
-    place(positions: ReadonlyMap<string, Point>): void;
-    flush(): Promise<void>;
-    copy(ids: readonly string[], parent: string | null): Promise<Item[]>;
-    emptyTrash(): Promise<Item[]>;
-    trashSize(): number;
-    dump(): CatalogArchive;
-    clear(): Promise<void>;
-    import(archive: CatalogArchive, options?: {
-        mode?: 'merge' | 'replace';
-    }): Promise<Map<string, Item>>;
-    dispose(): Promise<void>;
-}
-export declare function createCatalog(options: CatalogOptions): Catalog;
-/** Storage that forgets everything on a reload. Its map is exposed for tests. */
-export declare function memoryStorage(initial?: readonly Item[]): CatalogStorage & {
-    records: Map<string, Item>;
-};