vintage-frames 0.19.1 → 0.20.0

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>;
-};