vintage-frames 0.16.2 → 0.18.0

package/dist/build/png.d.ts

@@ -0,0 +1,24 @@
+/**
+ * PNG pixels, with no canvas and no dependency: a decoder for the forms art
+ * comes in, and an encoder for the box.
+ *
+ * - Decoding takes 8-bit gray, RGB, gray with alpha and RGBA, and indexed
+ *   or gray at 1, 2, 4 or 8 bits, non-interlaced, with their transparency.
+ *   16-bit and interlaced files are refused, naming what to save them as.
+ * - Encoding writes 8-bit RGBA, each row filtered the way that compresses
+ *   it best.
+ */
+/** Straight RGBA, 8 bits a channel, rows top first. */
+export interface Pixels {
+    width: number;
+    height: number;
+    data: Uint8Array;
+}
+/** `parts`, end to end. */
+export declare function concat(parts: readonly Uint8Array[]): Uint8Array;
+/** One chunk, with its length and CRC. */
+export declare function pngChunk(type: string, data: Uint8Array): Uint8Array;
+/** A PNG's pixels. `what` names it in an error: "the artwork". */
+export declare function decodePng(bytes: Uint8Array, what?: string): Promise<Pixels>;
+/** Pixels as an 8-bit RGBA PNG. */
+export declare function encodePng({ width, height, data }: Pixels): Promise<Uint8Array>;

package/dist/build/png.js

@@ -0,0 +1,116 @@
+import { PNG_SIGNATURE as e, crc32 as t, deflate as n, inflate as r, pngChunks as i } from "../shell/app-file.js";
+//#region src/build/png.ts
+var a = {
+	0: 1,
+	2: 3,
+	3: 1,
+	4: 2,
+	6: 4
+};
+function o(e) {
+	let t = new Uint8Array(e.reduce((e, t) => e + t.length, 0)), n = 0;
+	for (let r of e) t.set(r, n), n += r.length;
+	return t;
+}
+function s(e, n) {
+	let r = new Uint8Array(12 + n.length), i = new DataView(r.buffer);
+	i.setUint32(0, n.length);
+	for (let t = 0; t < 4; t++) r[4 + t] = e.charCodeAt(t);
+	return r.set(n, 8), i.setUint32(8 + n.length, t(r.subarray(4, 8 + n.length))), r;
+}
+async function c(e, t = "the PNG") {
+	let n = i(e), s = n?.[0];
+	if (!n || s?.type !== "IHDR" || s.data.length !== 13) throw Error(`${t} is not a whole PNG`);
+	let c = new DataView(s.data.buffer, s.data.byteOffset, 13), l = c.getUint32(0), u = c.getUint32(4), [f, p, m, h, g] = s.data.subarray(8);
+	if (f === 16) throw Error(`${t} is a 16-bit PNG: save it as an 8-bit PNG`);
+	if (g) throw Error(`${t} is interlaced: save it as a non-interlaced PNG`);
+	let _ = a[p], v = p === 0 || p === 3 ? [
+		1,
+		2,
+		4,
+		8
+	].includes(f) : f === 8;
+	if (!_ || !v || m || h) throw Error(`${t} is a kind of PNG this kit doesn't read (color type ${p}, ${f} bits): save it as an 8-bit PNG`);
+	let y = null, b = null, x = [];
+	for (let { type: e, data: t } of n) e === "PLTE" ? y = t : e === "tRNS" ? b = t : e === "IDAT" && x.push(t);
+	if (p === 3 && !y) throw Error(`${t} is indexed and has no palette`);
+	let S = _ * f, C = Math.ceil(l * S / 8), w = await r(o(x)).catch(() => {
+		throw Error(`${t} is not a whole PNG`);
+	});
+	if (w.length < u * (C + 1)) throw Error(`${t} is not a whole PNG`);
+	let T = d(w, u, C, Math.max(1, S >> 3), t), E = (1 << f) - 1, D = (e, t) => {
+		let n = t * f;
+		return T[e + (n >> 3)] >> 8 - f - (n & 7) & E;
+	}, O = (e) => b && b.length >= e * 2 + 2 ? b[e * 2] << 8 | b[e * 2 + 1] : -1, k = new Uint8Array(l * u * 4);
+	for (let e = 0; e < u; e++) {
+		let n = e * C;
+		for (let r = 0; r < l; r++) {
+			let i = (e * l + r) * 4;
+			if (p === 0) {
+				let e = f === 8 ? T[n + r] : D(n, r);
+				k[i] = k[i + 1] = k[i + 2] = Math.round(e * 255 / E), k[i + 3] = e === O(0) ? 0 : 255;
+			} else if (p === 3) {
+				let e = f === 8 ? T[n + r] : D(n, r);
+				if (e * 3 + 2 >= y.length) throw Error(`${t} uses a color its palette lacks`);
+				k[i] = y[e * 3], k[i + 1] = y[e * 3 + 1], k[i + 2] = y[e * 3 + 2], k[i + 3] = b?.[e] ?? 255;
+			} else if (p === 2) {
+				let e = n + r * 3;
+				k.set(T.subarray(e, e + 3), i);
+				let t = T[e] !== O(0) || T[e + 1] !== O(1) || T[e + 2] !== O(2);
+				k[i + 3] = t ? 255 : 0;
+			} else if (p === 4) {
+				let e = n + r * 2;
+				k[i] = k[i + 1] = k[i + 2] = T[e], k[i + 3] = T[e + 1];
+			} else k.set(T.subarray(n + r * 4, n + r * 4 + 4), i);
+		}
+	}
+	return {
+		width: l,
+		height: u,
+		data: k
+	};
+}
+function l(e, t, n) {
+	let r = e + t - n, i = Math.abs(r - e), a = Math.abs(r - t), o = Math.abs(r - n);
+	return i <= a && i <= o ? e : a <= o ? t : n;
+}
+function u(e, t, n, r) {
+	return e === 1 ? t : e === 2 ? n : e === 3 ? t + n >> 1 : e === 4 ? l(t, n, r) : 0;
+}
+function d(e, t, n, r, i) {
+	let a = new Uint8Array(t * n);
+	for (let o = 0; o < t; o++) {
+		let t = e[o * (n + 1)];
+		if (t > 4) throw Error(`${i} is not a whole PNG`);
+		let s = o * (n + 1) + 1, c = o * n;
+		for (let i = 0; i < n; i++) {
+			let l = i >= r ? a[c + i - r] : 0, d = o ? a[c - n + i] : 0, f = i >= r && o ? a[c - n + i - r] : 0;
+			a[c + i] = e[s + i] + u(t, l, d, f) & 255;
+		}
+	}
+	return a;
+}
+async function f({ width: t, height: r, data: i }) {
+	let a = t * 4, c = new Uint8Array(r * (a + 1)), l = Array.from({ length: 5 }, () => new Uint8Array(a));
+	for (let e = 0; e < r; e++) {
+		let t = e * a, n = 0, r = Infinity;
+		for (let o = 0; o < 5; o++) {
+			let s = l[o], c = 0;
+			for (let n = 0; n < a; n++) {
+				let r = n >= 4 ? i[t + n - 4] : 0, l = e ? i[t - a + n] : 0, d = n >= 4 && e ? i[t - a + n - 4] : 0, f = i[t + n] - u(o, r, l, d) & 255;
+				s[n] = f, c += f < 128 ? f : 256 - f;
+			}
+			c < r && (r = c, n = o);
+		}
+		c[e * (a + 1)] = n, c.set(l[n], e * (a + 1) + 1);
+	}
+	let d = /* @__PURE__ */ new Uint8Array(13), f = new DataView(d.buffer);
+	return f.setUint32(0, t), f.setUint32(4, r), d[8] = 8, d[9] = 6, o([
+		e,
+		s("IHDR", d),
+		s("IDAT", await n(c)),
+		s("IEND", /* @__PURE__ */ new Uint8Array())
+	]);
+}
+//#endregion
+export { o as concat, c as decodePng, f as encodePng, s as pngChunk };

package/dist/modal-dialog.d.ts

@@ -51,7 +51,10 @@ export declare const modalDialogStyles: import("lit").CSSResult;
  * the reason. Because every close path — Escape, `close()`, the opt-in
  * {@link lightDismiss} click outside — routes through the native `close`
  * event, an Escape-close no longer leaves a stale origin behind, so the next
- * open re-derives it.
+ * open re-derives it. That event is queued: a modal opened again before it
+ * comes (`close()` then `show()` in one turn) runs the funnel at the open,
+ * inside `show()`, so the close's `vf-close` still comes before the open's
+ * `vf-show`, and the late event changes nothing.
  *
  * It also owns the two keyboard rules every classic dialog followed (see
  * {@link defaultButton} and {@link initialFocusTarget}): Return or Enter
@@ -242,11 +245,9 @@ export declare class VfModalDialog extends LitElement {
     /** Native `cancel` (Escape): remember the reason; `close` follows. */
     protected _onNativeCancel(): void;
     /**
-     * Native `close` — the single teardown funnel for every close path. Drops
-     * the written origin so the next open re-derives it from the box it will
-     * actually have (a stated `top`/`left` is the author's or the user's and
-     * survives, and is re-applied by that open), syncs `open`, and fires
-     * `vf-close` with the reason and the value the close carried.
+     * Native `close`, which every close path ends in: syncs `open` and runs the
+     * close funnel. An open that came before the event has run the funnel for
+     * this close already, and the event passes.
      */
     protected _onNativeClose(): void;
 }

package/dist/modal-dialog.js

@@ -112,7 +112,7 @@ var p = 24, m = /* @__PURE__ */ new Set([
 			this.#o = null, !(!t || e.target !== this._dialog || !this.lightDismiss) && (this.#n = "outside", this.close());
 		}, this.#f = () => {
 			this.#o = null;
-		}, this.#p = null, this.#y = () => this.settle(), this.addEventListener("submit", this.#a);
+		}, this.#p = null, this.#m = !1, this.#b = () => this.settle(), this.addEventListener("submit", this.#a);
 	}
 	#a;
 	#o;
@@ -133,41 +133,42 @@ var p = 24, m = /* @__PURE__ */ new Set([
 	#d;
 	#f;
 	#p;
+	#m;
 	show() {
-		this.open = !0, this.hasUpdated && this.#v();
+		this.open = !0, this.hasUpdated && this.#y();
 	}
 	close(e) {
-		this.open && e !== void 0 && (this.#r = e), this.open = !1, this.hasUpdated && this.#v();
+		this.open && e !== void 0 && (this.#r = e), this.open = !1, this.hasUpdated && this.#y();
 	}
 	closeFromBox(e) {
 		this.open && (this.#i = e), this.close();
 	}
 	updated(e) {
-		e.has("open") && this.#v(), (e.has("top") || e.has("left")) && this.settle(), this.#t();
+		e.has("open") && this.#y(), (e.has("top") || e.has("left")) && this.settle(), this.#t();
 	}
-	#m() {
+	#h() {
 		let e = document.documentElement;
 		return {
 			width: o(e.clientWidth || window.innerWidth, this),
 			height: o(e.clientHeight || window.innerHeight, this)
 		};
 	}
-	#h(e, t) {
-		let n = this.#m(), r = o(this._dialog?.offsetWidth ?? 0, this);
+	#g(e, t) {
+		let n = this.#h(), r = o(this._dialog?.offsetWidth ?? 0, this);
 		return {
 			x: Math.min(Math.max(e, p - r), n.width - p),
 			y: Math.min(Math.max(t, 0), Math.max(0, n.height - p))
 		};
 	}
-	#g() {
-		let e = this.#m(), t = this._dialog?.getBoundingClientRect();
+	#_() {
+		let e = this.#h(), t = this._dialog?.getBoundingClientRect();
 		return {
 			x: (e.width - o(t?.width ?? 0, this)) / 2,
 			y: (e.height - o(t?.height ?? 0, this)) / 2
 		};
 	}
 	placeAt(e, t) {
-		let n = this.#h(e, t);
+		let n = this.#g(e, t);
 		this.left = i(n.x, this), this.top = i(n.y, this);
 	}
 	settle() {
@@ -176,10 +177,10 @@ var p = 24, m = /* @__PURE__ */ new Set([
 		let t = this.left != null || this.top != null ? {
 			x: this.left ?? 0,
 			y: this.top ?? 0
-		} : this.#g(), n = this.#h(t.x, t.y);
+		} : this.#_(), n = this.#g(t.x, t.y);
 		e.style.left = a(i(n.x, this)), e.style.top = a(i(n.y, this)), e.style.right = "auto", e.style.bottom = "auto", e.style.margin = "0";
 	}
-	#_() {
+	#v() {
 		let e = this._dialog?.style;
 		if (e) for (let t of [
 			"left",
@@ -189,27 +190,31 @@ var p = 24, m = /* @__PURE__ */ new Set([
 			"margin"
 		]) e.removeProperty(t);
 	}
-	#v() {
+	#y() {
 		let e = this._dialog;
 		if (e) {
 			if (this.open && !e.open) {
-				this.#p = document.activeElement, this.returnValue = "", e.showModal();
+				if (this.#m) {
+					this.#T(), this.#y();
+					return;
+				}
+				this.#p = document.activeElement, this.returnValue = "", this.#n = null, this.#r = null, this.#i = null, e.showModal(), this.#m = !0;
 				let n = this.#c();
-				this.settle(), this.#S(e), this.#s.attach(), t(this, "vf-show", { focus: n }), n && _(n) && n.select?.();
+				this.settle(), this.#C(e), this.#s.attach(), t(this, "vf-show", { focus: n }), n && _(n) && n.select?.();
 			} else !this.open && e.open && e.close();
 		}
 	}
-	#y;
 	#b;
 	#x;
-	#S(e) {
-		typeof ResizeObserver < "u" && !this.#b && (this.#b = new ResizeObserver(this.#y), this.#b.observe(e)), window.addEventListener("resize", this.#y), this.#x ??= r(this.#y);
+	#S;
+	#C(e) {
+		typeof ResizeObserver < "u" && !this.#x && (this.#x = new ResizeObserver(this.#b), this.#x.observe(e)), window.addEventListener("resize", this.#b), this.#S ??= r(this.#b);
 	}
-	#C() {
-		this.#b?.disconnect(), this.#b = void 0, window.removeEventListener("resize", this.#y), this.#x?.(), this.#x = void 0;
+	#w() {
+		this.#x?.disconnect(), this.#x = void 0, window.removeEventListener("resize", this.#b), this.#S?.(), this.#S = void 0;
 	}
 	disconnectedCallback() {
-		super.disconnectedCallback(), this.#C();
+		super.disconnectedCallback(), this.#w();
 		let e = this._dialog;
 		if (e?.open) {
 			e.close();
@@ -222,8 +227,11 @@ var p = 24, m = /* @__PURE__ */ new Set([
 		this.#n = "escape";
 	}
 	_onNativeClose() {
+		!this.#m || this._dialog?.open || (this.open = !1, this.#T());
+	}
+	#T() {
 		let e = this.#n ?? "close", n = this.#r, r = this.#i;
-		this.#n = null, this.#r = null, this.#i = null, n !== null && (this.returnValue = n), this.#p = null, this.#o = null, this.#s.detach(), this.#C(), this.open = !1, this.#_(), t(this, "vf-close", {
+		this.#n = null, this.#r = null, this.#i = null, this.#m = !1, n !== null && (this.returnValue = n), this.#p = null, this.#o = null, this.#s.detach(), this.#w(), this.#v(), t(this, "vf-close", {
 			reason: e,
 			returnValue: n,
 			...r

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

@@ -0,0 +1,99 @@
+/**
+ * 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, 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;
+/**
+ * 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;
+    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;

package/dist/shell/app-file.js

@@ -0,0 +1,177 @@
+//#region src/shell/app-file.ts
+var e = 1, t = 3, n = "vintage-frames.app", r = "vintage-frames.code", i = [
+	"id",
+	"name",
+	"version",
+	"requires",
+	"author",
+	"description",
+	"icon"
+], a = Uint8Array.of(137, 80, 78, 71, 13, 10, 26, 10), o = 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) {
+	let t = 4294967295;
+	for (let n of e) t = o[(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;
+	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;
+		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 l(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) {
+	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);
+}
+async function f(e) {
+	let t = new Blob([e.slice()]).stream().pipeThrough(new DecompressionStream("deflate"));
+	return new Uint8Array(await new Response(t).arrayBuffer());
+}
+async function p(e) {
+	let t = new Blob([e.slice()]).stream().pipeThrough(new CompressionStream("deflate"));
+	return new Uint8Array(await new Response(t).arrayBuffer());
+}
+function m(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) {
+		let r = t[e];
+		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`;
+		n[e] = r;
+	}
+	return n;
+}
+async function h(e) {
+	let t = c(e);
+	if (!t) return "it is not a whole PNG";
+	let i = /* @__PURE__ */ new Map();
+	for (let { type: e, data: n } of t) {
+		if (e !== "iTXt") continue;
+		let t = l(n);
+		if (t === "vintage-frames.app" || t === "vintage-frames.code") {
+			if (i.has(t)) return `it has two ${t} chunks`;
+			i.set(t, n);
+		}
+	}
+	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 s;
+	try {
+		s = JSON.parse(await d(a));
+	} catch {
+		return "its manifest does not read";
+	}
+	let u = m(s);
+	if (typeof u == "string") return u;
+	try {
+		return {
+			manifest: u,
+			code: await d(o)
+		};
+	} catch {
+		return "its code does not inflate";
+	}
+}
+async function g(e) {
+	let t = await h(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) {
+	if (typeof e != "string") return null;
+	let t = _.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 y(e) {
+	return _.test(e);
+}
+function b(e) {
+	return y(e.startsWith("^") ? e.slice(1) : e);
+}
+function x(e) {
+	if (typeof e != "string") return null;
+	let t = e.trim();
+	return v(t.startsWith("^") ? t.slice(1) : t);
+}
+function S(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 C(e, t) {
+	let n = v(e), r = v(t);
+	return n && r ? S(n, r) : !!n - +!!r;
+}
+function w(e, t) {
+	let n = v(e), r = x(t);
+	if (!n || !r) return !1;
+	if (!t.trim().startsWith("^")) return S(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 S(n, r) >= 0 && S(n, s) < 0;
+}
+//#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 };

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, BOX_SCALE, compareVersions, inspectAppFile, 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, BOX_SCALE as fe, compareVersions as pe, inspectAppFile as me, readAppFile as he, satisfies as ge } from "./app-file.js";
+import { VERSION as _e } from "./version.js";
+export { de as APP_FILE_FORMAT, e as APP_KIND, b as BAND, fe as BOX_SCALE, 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, _e 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, pe as compareVersions, 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, me as inspectAppFile, 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, he as readAppFile, ee as readSession, ge 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, BOX_SCALE, compareVersions, inspectAppFile, 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 $, BOX_SCALE as ee, compareVersions as te, inspectAppFile as ne, readAppFile as re, satisfies as ie } from "./app-file.js";
+import { VERSION as ae } from "./version.js";
+export { $ as APP_FILE_FORMAT, e as APP_KIND, b as BAND, ee as BOX_SCALE, 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, ae 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, te as compareVersions, 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, ne as inspectAppFile, 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, re as readAppFile, Q as readSession, ie as satisfies, q as trashCell, J as windowOrigin };

package/dist/shell/shell.js

@@ -144,7 +144,7 @@ function d(l, d) {
 					let n = (r) => {
 						r.target === t && (t.removeEventListener("vf-close", n), e(r.detail.returnValue));
 					};
-					t.addEventListener("vf-close", n), t.show();
+					t.show(), t.addEventListener("vf-close", n);
 				});
 			},
 			gate(e, t) {

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.18.0";

package/dist/shell/version.js

@@ -0,0 +1,4 @@
+//#region src/shell/version.ts
+var e = "0.18.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;