vintage-frames 0.16.2 → 0.17.0

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

@@ -0,0 +1,77 @@
+/**
+ * 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, and checking a version against a range. 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 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;
+    author: 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 code that doesn't inflate.
+ */
+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 `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;

package/dist/shell/app-file.js

@@ -0,0 +1,161 @@
+//#region src/shell/app-file.ts
+var e = 1, t = "vintage-frames.app", n = "vintage-frames.code", r = [
+	"id",
+	"name",
+	"version",
+	"requires",
+	"author",
+	"icon"
+], i = Uint8Array.of(137, 80, 78, 71, 13, 10, 26, 10), a = 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 o(e) {
+	let t = 4294967295;
+	for (let n of e) t = a[(t ^ n) & 255] ^ t >>> 8;
+	return (t ^ 4294967295) >>> 0;
+}
+function s(e) {
+	if (e.length < 8 || i.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 || o(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 c(e) {
+	let t = e.indexOf(0);
+	return t > 0 ? String.fromCharCode(...e.subarray(0, t)) : "";
+}
+var l = new TextDecoder("utf-8", { fatal: !0 });
+async function u(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 l.decode(n ? await d(o) : o);
+}
+async function d(e) {
+	let t = new Blob([e.slice()]).stream().pipeThrough(new DecompressionStream("deflate"));
+	return new Uint8Array(await new Response(t).arrayBuffer());
+}
+async function f(e) {
+	let t = new Blob([e.slice()]).stream().pipeThrough(new CompressionStream("deflate"));
+	return new Uint8Array(await new Response(t).arrayBuffer());
+}
+function p(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,
+		id: "",
+		name: "",
+		version: "",
+		requires: "",
+		author: "",
+		icon: ""
+	};
+	for (let e of r) {
+		let r = t[e];
+		if (typeof r != "string" || !r) return `its manifest has no ${e}`;
+		n[e] = r;
+	}
+	return n;
+}
+async function m(e) {
+	let r = s(e);
+	if (!r) return "it is not a whole PNG";
+	let i = /* @__PURE__ */ new Map();
+	for (let { type: e, data: t } of r) {
+		if (e !== "iTXt") continue;
+		let n = c(t);
+		if (n === "vintage-frames.app" || n === "vintage-frames.code") {
+			if (i.has(n)) return `it has two ${n} chunks`;
+			i.set(n, t);
+		}
+	}
+	let a = i.get(t), o = i.get(n);
+	if (!a && !o) return "it carries no application";
+	if (!a) return "its manifest is missing";
+	if (!o) return "its code is missing";
+	let l;
+	try {
+		l = JSON.parse(await u(a));
+	} catch {
+		return "its manifest does not read";
+	}
+	let d = p(l);
+	if (typeof d == "string") return d;
+	try {
+		return {
+			manifest: d,
+			code: await u(o)
+		};
+	} catch {
+		return "its code does not inflate";
+	}
+}
+async function h(e) {
+	let t = await m(e);
+	return typeof t == "string" ? null : t;
+}
+var g = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z.-]+)?$/;
+function _(e) {
+	let t = g.exec(e.trim());
+	return t ? {
+		core: [
+			Number(t[1]),
+			Number(t[2]),
+			Number(t[3])
+		],
+		pre: t[4] ? t[4].split(".") : []
+	} : null;
+}
+function v(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 y(e, t) {
+	let n = t.trim().startsWith("^"), r = _(e), i = _(n ? t.trim().slice(1) : t);
+	if (!r || !i) return !1;
+	if (!n) return v(r, i) === 0;
+	if (r.pre.length && !(i.pre.length && r.core.every((e, t) => e === i.core[t]))) return !1;
+	let [a, o, s] = i.core, c = {
+		core: a ? [
+			a + 1,
+			0,
+			0
+		] : o ? [
+			0,
+			o + 1,
+			0
+		] : [
+			0,
+			0,
+			s + 1
+		],
+		pre: []
+	};
+	return v(r, i) >= 0 && v(r, c) < 0;
+}
+//#endregion
+export { e as APP_FILE_FORMAT, n as CODE_KEYWORD, t as MANIFEST_KEYWORD, i as PNG_SIGNATURE, o as crc32, f as deflate, d as inflate, m as inspectAppFile, c as itxtKeyword, p as manifestOf, s as pngChunks, h as readAppFile, y as satisfies };

package/dist/shell/index.d.ts

@@ -25,3 +25,6 @@ export type { LocalStorageStateOptions, SavedSession, SavedWindow, SessionSnapsh
 export { BAND, CASCADE_SLOTS, CASCADE_STEP, ICON_CELL, ICON_COLUMN, ICON_INSET, ICON_ROW, NEAR, WINDOW_ORIGIN, cascadedBox, cascadeFrom, cascadeSlot, centeredBox, cleanUp, collisions, desktopLattice, fieldExtent, fillOrder, folderLattice, frameOf, isPin, latticeCell, latticeSlot, nearBox, nextFreeCell, pinOf, pinTo, trashCell, windowOrigin, } from './geometry.js';
 export type { Bands, Box, CascadeOptions, EdgePin, Frame, Lattice, LatticeOptions, Pin, Point, Policy, Size, } from './geometry.js';
 export { startClock, formatDate, formatTime, DATE_HOLD_MS } from './clock.js';
+export { APP_FILE_FORMAT, readAppFile, satisfies } from './app-file.js';
+export type { AppFile, AppManifest } from './app-file.js';
+export { VERSION } from './version.js';

package/dist/shell/index.js

@@ -7,4 +7,6 @@ import { createShell as ae, defineApp as oe } from "./shell.js";
 import { fileByDrag as se } from "./filing.js";
 import { FINDER as ce, finder as le } from "./finder.js";
 import { indexedDbStorage as ue } from "./storage.js";
-export { e as APP_KIND, b as BAND, x as CASCADE_SLOTS, S as CASCADE_STEP, te as DATE_HOLD_MS, t as DISK, ce as FINDER, n as FOLDER, C as ICON_CELL, w as ICON_COLUMN, T as ICON_INSET, E as ICON_ROW, D as NEAR, r as TRASH, i as UNTITLED_FOLDER, O as WINDOW_ORIGIN, a as appIdOf, k as cascadeFrom, A as cascadeSlot, j as cascadedBox, M as centeredBox, o as childrenOf, N as cleanUp, P as collisions, s as containerOf, c as copyName, l as createCatalog, ae as createShell, Y as createWindowManager, oe as defineApp, u as descendantsOf, F as desktopLattice, d as enclosingFolders, I as fieldExtent, se as fileByDrag, L as fillOrder, le as finder, X as focusInto, R as folderLattice, ne as formatDate, re as formatTime, z as frameOf, ue as indexedDbStorage, f as isContainerKind, p as isInside, B as isPin, m as isTrashed, h as isVolume, g as itemCount, _ as itemOf, V as latticeCell, H as latticeSlot, Z as localStorageState, v as memoryStorage, Q as mergeSession, U as nearBox, y as nextFolderName, W as nextFreeCell, $ as openWindowsOf, G as pinOf, K as pinTo, ee as readSession, ie as startClock, q as trashCell, J as windowOrigin };
+import { APP_FILE_FORMAT as de, readAppFile as fe, satisfies as pe } from "./app-file.js";
+import { VERSION as me } from "./version.js";
+export { de as APP_FILE_FORMAT, e as APP_KIND, b as BAND, x as CASCADE_SLOTS, S as CASCADE_STEP, te as DATE_HOLD_MS, t as DISK, ce as FINDER, n as FOLDER, C as ICON_CELL, w as ICON_COLUMN, T as ICON_INSET, E as ICON_ROW, D as NEAR, r as TRASH, i as UNTITLED_FOLDER, me as VERSION, O as WINDOW_ORIGIN, a as appIdOf, k as cascadeFrom, A as cascadeSlot, j as cascadedBox, M as centeredBox, o as childrenOf, N as cleanUp, P as collisions, s as containerOf, c as copyName, l as createCatalog, ae as createShell, Y as createWindowManager, oe as defineApp, u as descendantsOf, F as desktopLattice, d as enclosingFolders, I as fieldExtent, se as fileByDrag, L as fillOrder, le as finder, X as focusInto, R as folderLattice, ne as formatDate, re as formatTime, z as frameOf, ue as indexedDbStorage, f as isContainerKind, p as isInside, B as isPin, m as isTrashed, h as isVolume, g as itemCount, _ as itemOf, V as latticeCell, H as latticeSlot, Z as localStorageState, v as memoryStorage, Q as mergeSession, U as nearBox, y as nextFolderName, W as nextFreeCell, $ as openWindowsOf, G as pinOf, K as pinTo, fe as readAppFile, ee as readSession, pe as satisfies, ie as startClock, q as trashCell, J as windowOrigin };

package/dist/shell/pure.d.ts

@@ -1,10 +1,13 @@
 /**
  * `vintage-frames/shell/pure` — the shell's pure modules on their own: the
- * catalog, the geometry and the saved session. They import nothing from the
- * kit and touch no DOM at import, so a site's own pure modules and their
- * tests import them under Node. `vintage-frames/shell` exports the same
- * names.
+ * catalog, the geometry, the saved session, the app file reader and the
+ * kit's version. They import nothing from the kit and touch no DOM at
+ * import, so a site's own pure modules and their tests import them under
+ * Node. `vintage-frames/shell` exports the same names.
  */
 export * from './catalog.js';
 export * from './geometry.js';
 export * from './state.js';
+export { APP_FILE_FORMAT, readAppFile, satisfies } from './app-file.js';
+export type { AppFile, AppManifest } from './app-file.js';
+export { VERSION } from './version.js';

package/dist/shell/pure.js

@@ -1,4 +1,6 @@
 import { APP_KIND as e, DISK as t, FOLDER as n, TRASH as r, UNTITLED_FOLDER as i, appIdOf as a, childrenOf as o, containerOf as s, copyName as c, createCatalog as l, descendantsOf as u, enclosingFolders as d, isContainerKind as f, isInside as p, isTrashed as m, isVolume as h, itemCount as g, itemOf as _, memoryStorage as v, nextFolderName as y } from "./catalog.js";
 import { BAND as b, CASCADE_SLOTS as x, CASCADE_STEP as S, ICON_CELL as C, ICON_COLUMN as w, ICON_INSET as T, ICON_ROW as E, NEAR as D, WINDOW_ORIGIN as O, cascadeFrom as k, cascadeSlot as A, cascadedBox as j, centeredBox as M, cleanUp as N, collisions as P, desktopLattice as F, fieldExtent as I, fillOrder as L, folderLattice as R, frameOf as z, isPin as B, latticeCell as V, latticeSlot as H, nearBox as U, nextFreeCell as W, pinOf as G, pinTo as K, trashCell as q, windowOrigin as J } from "./geometry.js";
 import { localStorageState as Y, mergeSession as X, openWindowsOf as Z, readSession as Q } from "./state.js";
-export { e as APP_KIND, b as BAND, x as CASCADE_SLOTS, S as CASCADE_STEP, t as DISK, n as FOLDER, C as ICON_CELL, w as ICON_COLUMN, T as ICON_INSET, E as ICON_ROW, D as NEAR, r as TRASH, i as UNTITLED_FOLDER, O as WINDOW_ORIGIN, a as appIdOf, k as cascadeFrom, A as cascadeSlot, j as cascadedBox, M as centeredBox, o as childrenOf, N as cleanUp, P as collisions, s as containerOf, c as copyName, l as createCatalog, u as descendantsOf, F as desktopLattice, d as enclosingFolders, I as fieldExtent, L as fillOrder, R as folderLattice, z as frameOf, f as isContainerKind, p as isInside, B as isPin, m as isTrashed, h as isVolume, g as itemCount, _ as itemOf, V as latticeCell, H as latticeSlot, Y as localStorageState, v as memoryStorage, X as mergeSession, U as nearBox, y as nextFolderName, W as nextFreeCell, Z as openWindowsOf, G as pinOf, K as pinTo, Q as readSession, q as trashCell, J as windowOrigin };
+import { APP_FILE_FORMAT as $, readAppFile as ee, satisfies as te } from "./app-file.js";
+import { VERSION as ne } from "./version.js";
+export { $ as APP_FILE_FORMAT, e as APP_KIND, b as BAND, x as CASCADE_SLOTS, S as CASCADE_STEP, t as DISK, n as FOLDER, C as ICON_CELL, w as ICON_COLUMN, T as ICON_INSET, E as ICON_ROW, D as NEAR, r as TRASH, i as UNTITLED_FOLDER, ne as VERSION, O as WINDOW_ORIGIN, a as appIdOf, k as cascadeFrom, A as cascadeSlot, j as cascadedBox, M as centeredBox, o as childrenOf, N as cleanUp, P as collisions, s as containerOf, c as copyName, l as createCatalog, u as descendantsOf, F as desktopLattice, d as enclosingFolders, I as fieldExtent, L as fillOrder, R as folderLattice, z as frameOf, f as isContainerKind, p as isInside, B as isPin, m as isTrashed, h as isVolume, g as itemCount, _ as itemOf, V as latticeCell, H as latticeSlot, Y as localStorageState, v as memoryStorage, X as mergeSession, U as nearBox, y as nextFolderName, W as nextFreeCell, Z as openWindowsOf, G as pinOf, K as pinTo, ee as readAppFile, Q as readSession, te as satisfies, q as trashCell, J as windowOrigin };

package/dist/shell/version.d.ts

@@ -0,0 +1,2 @@
+/** The kit's version, as published: package.json's `version`. `npm version` rewrites it (the `version` script). */
+export declare const VERSION = "0.17.0";

package/dist/shell/version.js

@@ -0,0 +1,4 @@
+//#region src/shell/version.ts
+var e = "0.17.0";
+//#endregion
+export { e as VERSION };

package/dist/styles/body-strike.d.ts

@@ -0,0 +1,12 @@
+/**
+ * VF Body as data. GENERATED by fonts/manifest-to-font.py from
+ * fonts/VF-Body.glyphs.txt: edit the manifest and rebuild, never this file.
+ *
+ * Each character's advance, placement and ink, in whole design px, for
+ * drawing the kit's type without a browser. The ink is the kit's own
+ * re-drawn strike in the style of Geneva 9pt, the design Susan Kare
+ * created for Apple's original Macintosh, and the same artwork the face's
+ * woff2 is built from (fonts/README.md).
+ */
+import type { Strike } from './strike.js';
+export declare const VF_BODY_STRIKE: Strike;