vintage-frames 0.17.0 → 0.19.0

package/README.md

@@ -25,7 +25,7 @@ There is no need to import a stylesheet. The components carry their styles with
 
 ## The shell
 
-`vintage-frames/shell` is an experimental second entry point that runs applications over one desktop: a window manager, a menu bar that shows the front application's menus, and a Finder with folders, filing, Clean Up and the Trash.
+`vintage-frames/shell` is an experimental second entry point that runs applications over one desktop: a window manager, a menu bar that shows the front application's menus, and a Finder with folders, aliases, filing, Clean Up and the Trash. A System Folder's contents set the Apple menu and what opens at startup.
 
 ```ts
 import 'vintage-frames'

package/custom-elements.json

@@ -3908,6 +3908,20 @@
                 "module": "src/modal-dialog.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "#opened",
+              "privacy": "private",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the modal has opened since its last close was funneled: true from\nan open until `#funnelClose` runs for the close that ends it, which can be\nafter the native `<dialog>` has closed, while its `close` event is queued.",
+              "inheritedFrom": {
+                "name": "VfModalDialog",
+                "module": "src/modal-dialog.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "show",
@@ -4095,7 +4109,7 @@
                   "text": "void"
                 }
               },
-              "description": "Reconcile the native `<dialog>` with `open`. Opening states the origin —\nthe author's, or the centered one — onto the top-layer box; the UA's own\n`margin: auto` centering lands on a half pixel whenever viewport minus\ndialog is odd, which fringes all the 1-bit chrome inside. Closing just\ncalls `dialog.close()`, routing teardown through the native `close` event\nso _onNativeClose is the one place placement is cleared and\n`vf-close` is fired.",
+              "description": "Reconcile the native `<dialog>` with `open`. Opening states the origin —\nthe author's, or the centered one — onto the top-layer box; the UA's own\n`margin: auto` centering lands on a half pixel whenever viewport minus\ndialog is odd, which fringes all the 1-bit chrome inside. Closing just\ncalls `dialog.close()`, and the native `close` event runs the close funnel,\n`#funnelClose`, the one place placement is cleared and `vf-close` is\nfired.",
               "inheritedFrom": {
                 "name": "VfModalDialog",
                 "module": "src/modal-dialog.ts"
@@ -4152,7 +4166,7 @@
                   }
                 }
               ],
-              "description": "While open, watch everything that invalidates the placement: the dialog's\nown box changing (content upgrade/growth, and `--vf-scale` moving under a\nzoom or density change, since every metric resizes with it), the viewport\nresizing, and the scale itself — which the box alone would miss on a page\nthat pins `--vf-scale`, where a zoom moves the lattice without resizing\nanything. Undone in _onNativeClose / `disconnectedCallback`.",
+              "description": "While open, watch everything that invalidates the placement: the dialog's\nown box changing (content upgrade/growth, and `--vf-scale` moving under a\nzoom or density change, since every metric resizes with it), the viewport\nresizing, and the scale itself — which the box alone would miss on a page\nthat pins `--vf-scale`, where a zoom moves the lattice without resizing\nanything. Undone by the close funnel and `disconnectedCallback`.",
               "inheritedFrom": {
                 "name": "VfModalDialog",
                 "module": "src/modal-dialog.ts"
@@ -4196,7 +4210,22 @@
                   "text": "void"
                 }
               },
-              "description": "Native `close` — the single teardown funnel for every close path. Drops\nthe written origin so the next open re-derives it from the box it will\nactually have (a stated `top`/`left` is the author's or the user's and\nsurvives, and is re-applied by that open), syncs `open`, and fires\n`vf-close` with the reason and the value the close carried.",
+              "description": "Native `close`, which every close path ends in: syncs `open` and runs the\nclose funnel. An open that came before the event has run the funnel for\nthis close already, and the event passes.",
+              "inheritedFrom": {
+                "name": "VfModalDialog",
+                "module": "src/modal-dialog.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "#funnelClose",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "The close funnel, the single teardown for every close path. Drops the\nwritten origin so the next open re-derives it from the box it will\nactually have (a stated `top`/`left` is the author's or the user's and\nsurvives, and is re-applied by that open), and fires `vf-close` with the\nreason and the value the close carried.",
               "inheritedFrom": {
                 "name": "VfModalDialog",
                 "module": "src/modal-dialog.ts"
@@ -5652,6 +5681,17 @@
               "attribute": "open",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "alias",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "The icon is an alias, an item standing for another: its name is set in\nitalics, the body face's own, and the plate widens to the slant's last\npixel.",
+              "attribute": "alias",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "movable",
@@ -6243,6 +6283,25 @@
               },
               "description": "Size the plate to a whole, EVEN number of system pixels.\n\nThis is the whole alignment argument, so it is worth stating plainly. The\nframe centers two things over one axis — the art cell and the name — and a\ncentered child's offset is `(box − child) / 2`. That is a whole number\nexactly when the box and the child have the SAME PARITY. The cell is 32 or\n16 and a declared `width` is required even, so if the plate is even too,\nevery offset in the component is whole by construction: no correction, no\nsnapping, nothing for the compositor to round.\n\nThe text is measured rather than the plate, with a Range over its own\ncontents — the plate already carries the width this computed last time, so\nreading the element back would just return it. The measurement is in\nsystem px and so is scale-invariant: the same name is the same number of\nart pixels wide at every display density, which is why nothing here\nre-runs when the scale changes.\n\nRounding UP to even (never down) means the plate never clips the run it\nwas measured from; the leftover is at most one system pixel of extra plate\nafter the text, since the embedded faces advance in whole pixels and only\na fallback face measures fractionally."
             },
+            {
+              "kind": "method",
+              "name": "#lean",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "plate",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ],
+              "description": "How far an alias's italic name runs past its advance, in whole system px:\nthe slant leans the tops of the last letters right, by up to 5. Read off\nthe glyphs' ink, in a canvas set in the plate's own font."
+            },
             {
               "kind": "field",
               "name": "#plateWidthCss",
@@ -6740,6 +6799,15 @@
               "description": "The icon's window is on screen, so the art paints as the Finder's open\nghost — outline held, interior re-filled with the kit's loose dither —\nderived in the client from the slotted art itself (see the class doc).\nSet it when handling `vf-open`, clear it when the window goes away.\nSelection inverts the ghost exactly as it inverts the art.",
               "fieldName": "open"
             },
+            {
+              "name": "alias",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "The icon is an alias, an item standing for another: its name is set in\nitalics, the body face's own, and the plate widens to the slant's last\npixel.",
+              "fieldName": "alias"
+            },
             {
               "name": "movable",
               "type": {
@@ -24316,7 +24384,7 @@
         },
         {
           "kind": "class",
-          "description": "Base class for the modal shell `vf-dialog` — and for a consumer's own\nmodal (an alert box, say) authored against the kit.\n\nOwns the native `<dialog>` lifecycle every modal shares: `open` sync, `show()` /\n`close()`, the top/left placement (stated or centered) and the\nsingle `close` funnel that drops the written origin and fires `vf-close` with\nthe reason. Because every close path — Escape, `close()`, the opt-in\nlightDismiss click outside — routes through the native `close`\nevent, an Escape-close no longer leaves a stale origin behind, so the next\nopen re-derives it.\n\nIt also owns the two keyboard rules every classic dialog followed (see\ndefaultButton and initialFocusTarget): Return or Enter\nactivates the default button from anywhere in the dialog, and the box opens\nwith the insertion point in its first text field — or, with none, focus on\nthe default button. A field marked `autoselect` takes the focus with its\ntext selected, on every open.\n\nRemoving an open modal from the DOM is a close path too. HTML's dialog\n*removing steps* take the element out of the top layer **without** running\nthe close algorithm — no `close` event, no focus restoration — which is\nexactly what the standard framework pattern of unmounting a dialog instead\nof calling `close()` does. `disconnectedCallback` routes that path through\nthe same funnel: the removed element still fires `vf-close` (heard by\nlisteners on the element itself — it has left the tree, so nothing\nbubbles), `open` and the pinned margins reconcile so a re-append mounts it\nclosed and re-centered, and focus returns to the element that was focused\nwhen the modal opened.\n\nA `<form method=\"dialog\">` inside the modal closes it with the submitting\nbutton's `value` as returnValue, as a form inside a native\n`<dialog>` does. The platform's own rule looks for a `<dialog>` around the\nform, and this one is in the shadow root, so the modal listens for the\nsubmit itself.\n\nSubclasses supply only the frame chrome: a `render()` returning\n`<dialog",
+          "description": "Base class for the modal shell `vf-dialog` — and for a consumer's own\nmodal (an alert box, say) authored against the kit.\n\nOwns the native `<dialog>` lifecycle every modal shares: `open` sync, `show()` /\n`close()`, the top/left placement (stated or centered) and the\nsingle `close` funnel that drops the written origin and fires `vf-close` with\nthe reason. Because every close path — Escape, `close()`, the opt-in\nlightDismiss click outside — routes through the native `close`\nevent, an Escape-close no longer leaves a stale origin behind, so the next\nopen re-derives it. That event is queued: a modal opened again before it\ncomes (`close()` then `show()` in one turn) runs the funnel at the open,\ninside `show()`, so the close's `vf-close` still comes before the open's\n`vf-show`, and the late event changes nothing.\n\nIt also owns the two keyboard rules every classic dialog followed (see\ndefaultButton and initialFocusTarget): Return or Enter\nactivates the default button from anywhere in the dialog, and the box opens\nwith the insertion point in its first text field — or, with none, focus on\nthe default button. A field marked `autoselect` takes the focus with its\ntext selected, on every open.\n\nRemoving an open modal from the DOM is a close path too. HTML's dialog\n*removing steps* take the element out of the top layer **without** running\nthe close algorithm — no `close` event, no focus restoration — which is\nexactly what the standard framework pattern of unmounting a dialog instead\nof calling `close()` does. `disconnectedCallback` routes that path through\nthe same funnel: the removed element still fires `vf-close` (heard by\nlisteners on the element itself — it has left the tree, so nothing\nbubbles), `open` and the pinned margins reconcile so a re-append mounts it\nclosed and re-centered, and focus returns to the element that was focused\nwhen the modal opened.\n\nA `<form method=\"dialog\">` inside the modal closes it with the submitting\nbutton's `value` as returnValue, as a form inside a native\n`<dialog>` does. The platform's own rule looks for a `<dialog>` around the\nform, and this one is in the shadow root, so the modal listens for the\nsubmit itself.\n\nSubclasses supply only the frame chrome: a `render()` returning\n`<dialog",
           "name": "VfModalDialog",
           "members": [
             {
@@ -24551,6 +24619,16 @@
               "default": "null",
               "description": "The element that was focused when the modal opened. The normal close path\nrestores focus natively, but the removal path (see the class doc) skips\nthe close algorithm, and by the time `disconnectedCallback` runs, focus\nhas already fallen to `<body>` — so we keep our own record."
             },
+            {
+              "kind": "field",
+              "name": "#opened",
+              "privacy": "private",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the modal has opened since its last close was funneled: true from\nan open until `#funnelClose` runs for the close that ends it, which can be\nafter the native `<dialog>` has closed, while its `close` event is queued."
+            },
             {
               "kind": "method",
               "name": "show",
@@ -24702,7 +24780,7 @@
                   "text": "void"
                 }
               },
-              "description": "Reconcile the native `<dialog>` with `open`. Opening states the origin —\nthe author's, or the centered one — onto the top-layer box; the UA's own\n`margin: auto` centering lands on a half pixel whenever viewport minus\ndialog is odd, which fringes all the 1-bit chrome inside. Closing just\ncalls `dialog.close()`, routing teardown through the native `close` event\nso _onNativeClose is the one place placement is cleared and\n`vf-close` is fired."
+              "description": "Reconcile the native `<dialog>` with `open`. Opening states the origin —\nthe author's, or the centered one — onto the top-layer box; the UA's own\n`margin: auto` centering lands on a half pixel whenever viewport minus\ndialog is odd, which fringes all the 1-bit chrome inside. Closing just\ncalls `dialog.close()`, and the native `close` event runs the close funnel,\n`#funnelClose`, the one place placement is cleared and `vf-close` is\nfired."
             },
             {
               "kind": "field",
@@ -24743,7 +24821,7 @@
                   }
                 }
               ],
-              "description": "While open, watch everything that invalidates the placement: the dialog's\nown box changing (content upgrade/growth, and `--vf-scale` moving under a\nzoom or density change, since every metric resizes with it), the viewport\nresizing, and the scale itself — which the box alone would miss on a page\nthat pins `--vf-scale`, where a zoom moves the lattice without resizing\nanything. Undone in _onNativeClose / `disconnectedCallback`."
+              "description": "While open, watch everything that invalidates the placement: the dialog's\nown box changing (content upgrade/growth, and `--vf-scale` moving under a\nzoom or density change, since every metric resizes with it), the viewport\nresizing, and the scale itself — which the box alone would miss on a page\nthat pins `--vf-scale`, where a zoom moves the lattice without resizing\nanything. Undone by the close funnel and `disconnectedCallback`."
             },
             {
               "kind": "method",
@@ -24775,7 +24853,18 @@
                   "text": "void"
                 }
               },
-              "description": "Native `close` — the single teardown funnel for every close path. Drops\nthe written origin so the next open re-derives it from the box it will\nactually have (a stated `top`/`left` is the author's or the user's and\nsurvives, and is re-applied by that open), syncs `open`, and fires\n`vf-close` with the reason and the value the close carried."
+              "description": "Native `close`, which every close path ends in: syncs `open` and runs the\nclose funnel. An open that came before the event has run the funnel for\nthis close already, and the event passes."
+            },
+            {
+              "kind": "method",
+              "name": "#funnelClose",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "The close funnel, the single teardown for every close path. Drops the\nwritten origin so the next open re-derives it from the box it will\nactually have (a stated `top`/`left` is the author's or the user's and\nsurvives, and is re-applied by that open), and fires `vf-close` with the\nreason and the value the close carried."
             }
           ],
           "events": [

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

@@ -6,8 +6,8 @@
 import type { AppManifest } from '../shell/app-file.js';
 /** What {@link packApp} packs. */
 export interface PackAppInput {
-    /** The manifest's fields but its format and icon, which the packer fills in. */
-    manifest: Omit<AppManifest, 'format' | 'icon'>;
+    /** The manifest's fields but its format, app API and icon, which the packer fills in. */
+    manifest: Omit<AppManifest, 'format' | 'api' | 'icon'>;
     /** The icon's PNG, 32 × 32. */
     icon: Uint8Array;
     /** The application's code: one ES module whose default export is its factory. */

package/dist/build/app-file.js

@@ -24,6 +24,7 @@ async function p({ manifest: e, icon: t, code: n, artwork: r }) {
 	let i = {
 		...e,
 		format: 1,
+		api: 2,
 		icon: `data:image/png;base64,${m(t)}`
 	};
 	return f(await l({

package/dist/build/box.d.ts

@@ -19,6 +19,8 @@ export interface Slot {
 export interface BoxFrame {
     /** The picture, a PNG. */
     picture: Uint8Array;
+    /** One system px, in the picture's px. Each of the artwork's px is a whole number of them. */
+    scale: number;
     /** Where the artwork goes. Without artwork the icon goes there, `stamp` times its size and centered. */
     artwork: Slot & {
         stamp: number;
@@ -46,7 +48,7 @@ export interface BoxInput {
     manifest: AppManifest;
     /** The icon's PNG, 32 × 32. */
     icon: Uint8Array;
-    /** The artwork's PNG: the artwork slot's size, or that divided by a whole number. */
+    /** The artwork's PNG: the artwork slot's size in system px, or that divided by a whole number. */
     artwork?: Uint8Array;
 }
 /** The box in the kit's frame, as a PNG. */

package/dist/build/box.js

@@ -16,9 +16,12 @@ async function a(e, { manifest: n, icon: r, artwork: i }) {
 	if (c.width !== 32 || c.height !== 32) throw Error(`the icon is ${c.width} × ${c.height}, and an icon is 32 × 32`);
 	let u = e.artwork;
 	if (i) {
-		let e = await t(i, "the artwork"), n = u.width / e.width;
-		if (!Number.isInteger(n) || e.height * n !== u.height) throw Error(`the artwork is ${e.width} × ${e.height}: draw it at ${u.width} × ${u.height}, or that divided by a whole number (${o(u)})`);
-		s(a, e, u.left, u.top, n, u);
+		let n = await t(i, "the artwork"), r = {
+			width: u.width / e.scale,
+			height: u.height / e.scale
+		}, c = r.width / n.width;
+		if (!Number.isInteger(c) || n.height * c !== r.height) throw Error(`the artwork is ${n.width} × ${n.height}: draw it at ${r.width} × ${r.height}, or that divided by a whole number (${o(r)})`);
+		s(a, n, u.left, u.top, c * e.scale, u);
 	} else {
 		let e = 32 * u.stamp;
 		s(a, c, u.left + Math.floor((u.width - e) / 2), u.top + Math.floor((u.height - e) / 2), u.stamp, u);

package/dist/build/frame.js

@@ -1,42 +1,44 @@
+import "../shell/app-file.js";
 import { VF_BODY_STRIKE as e } from "../styles/body-strike.js";
 import { VF_DISPLAY_STRIKE as t } from "../styles/display-strike.js";
 import { FRAME_PNG as n } from "./frame-picture.js";
 //#region src/build/frame.ts
-var r = {
-	left: 48,
-	width: 384,
-	scale: 3,
+var r = 3, i = {
+	left: 16 * r,
+	width: 128 * r,
+	scale: r,
 	ink: "#000000",
 	align: "center"
-}, i = {
+}, a = {
 	picture: n,
+	scale: r,
 	artwork: {
-		left: 48,
-		top: 48,
-		width: 384,
-		height: 384,
-		stamp: 8
+		left: 16 * r,
+		top: 16 * r,
+		width: 128 * r,
+		height: 128 * r,
+		stamp: 3 * r
 	},
 	text: [
 		{
-			...r,
-			top: 456,
+			...i,
+			top: 152 * r,
 			strike: t,
 			text: "{name}"
 		},
 		{
-			...r,
-			top: 510,
+			...i,
+			top: 170 * r,
 			strike: e,
 			text: "Version {version}"
 		},
 		{
-			...r,
-			top: 546,
+			...i,
+			top: 182 * r,
 			strike: e,
 			text: "by {author}"
 		}
 	]
 };
 //#endregion
-export { i as FRAME };
+export { a as FRAME };

package/dist/build/plugins.d.ts

@@ -4,18 +4,19 @@
  */
 import type { Plugin } from 'vite';
 export interface AppFileOptions {
-    /** The application's id, name, version and author: its `app.ts`. */
+    /** The application's id, name, version and author, and its description if it has one: its `app.ts`. */
     app: {
         id: string;
         name: string;
         version: string;
         author: string;
+        description?: string;
     };
     /** The module whose default export is the application's factory. */
     entry: string;
     /** Its 32 × 32 icon, a PNG. */
     icon: string;
-    /** Its artwork for the box: a PNG at the artwork slot's size, or that divided by a whole number. */
+    /** Its artwork for the box: a 128 × 128 PNG, or that divided by a whole number. */
     artwork?: string;
     /** A directory to write the app file to as well, such as a site's `apps/`. */
     copyTo?: string;
@@ -31,8 +32,8 @@ export interface AppFileOptions {
 export declare function appFile(options: AppFileOptions): Plugin;
 /**
  * Builds app files into a site. An import of `*.png?app` reads the file and
- * refuses one that isn't an app file, or whose `requires` this kit's
- * version doesn't meet. Its default export is the application's factory,
+ * refuses one that isn't an app file, or one this kit doesn't run
+ * (`appRuns`). Its default export is the application's factory,
  * its definition given the manifest's icon, and `manifest` is the manifest.
  * The code imports the kit by name, so the page keeps one copy of it. A new
  * file reloads the dev server's page.

package/dist/build/plugins.js

@@ -1,40 +1,41 @@
-import { inspectAppFile as e, satisfies as t } from "../shell/app-file.js";
-import { VERSION as n } from "../shell/version.js";
-import { packApp as r } from "./app-file.js";
-import { mkdir as i, readFile as a, writeFile as o } from "node:fs/promises";
-import { join as s, relative as c, resolve as l } from "node:path";
+import { VERSION as e } from "../shell/version.js";
+import { appRuns as t, inspectAppFile as n, isVersion as r, satisfies as i } from "../shell/app-file.js";
+import { packApp as a } from "./app-file.js";
+import { mkdir as o, readFile as s, writeFile as c } from "node:fs/promises";
+import { join as l, relative as u, resolve as d } from "node:path";
 //#region src/build/plugins.ts
-var u = [
+var f = [
 	"vintage-frames",
 	"vintage-frames/shell",
 	"vintage-frames/shell/pure"
-], d = "app-code";
-function f(e) {
+], p = "app-code";
+function m(e) {
 	let t = e.match(/(?<=[\\/]node_modules[\\/])(?:@[^\\/]+[\\/])?[^\\/]+/g)?.at(-1)?.replace("\\", "/");
 	return t === "vintage-frames" ? "a copy of vintage-frames" : t && /^(?:lit|lit-html|lit-element|@lit\/.+|@lit-labs\/.+)$/.test(t) ? `Lit (${t})` : null;
 }
-async function p(e) {
-	let t = JSON.parse(await a(s(e, "package.json"), "utf8")), r = t.devDependencies?.["vintage-frames"] ?? t.dependencies?.["vintage-frames"];
-	if (typeof r != "string") throw Error("package.json has no vintage-frames dev dependency");
-	if (!/^\^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(r)) throw Error(`package.json's vintage-frames range is "${r}", and an app file requires a caret range: ^${n}`);
-	return r;
+async function h(t) {
+	let n = JSON.parse(await s(l(t, "package.json"), "utf8")), i = n.devDependencies?.["vintage-frames"] ?? n.dependencies?.["vintage-frames"];
+	if (typeof i != "string") throw Error("package.json has no vintage-frames dev dependency");
+	if (!i.startsWith("^") || !r(i.slice(1))) throw Error(`package.json's vintage-frames range is "${i}", and an app file requires a caret range: ^${e}`);
+	return i;
 }
-function m(e) {
-	let { app: c, entry: d, icon: m, artwork: h, copyTo: g } = e;
+function g(t) {
+	let { app: n, entry: u, icon: p, artwork: g, copyTo: _ } = t;
 	for (let e of [
 		"id",
 		"name",
 		"version",
 		"author"
-	]) if (typeof c?.[e] != "string" || !c[e]) throw Error(`vintage-frames appFile(): app.${e} is missing`);
-	if (!d || !m) throw Error(`vintage-frames appFile(): ${d ? "icon" : "entry"} is missing`);
-	let _ = `${c.name.replace(/[\\/:*?"<>|]/g, "-")}.png`, v = "", y = null;
+	]) if (typeof n?.[e] != "string" || !n[e]) throw Error(`vintage-frames appFile(): app.${e} is missing`);
+	if (!r(n.version)) throw Error(`vintage-frames appFile(): app.version, ${n.version}, is not a version`);
+	if (!u || !p) throw Error(`vintage-frames appFile(): ${u ? "icon" : "entry"} is missing`);
+	let v = `${n.name.replace(/[\\/:*?"<>|]/g, "-")}.png`, y = "", b = null;
 	return {
 		name: "vintage-frames:app-file",
 		apply: "build",
 		config: () => ({ build: {
 			lib: {
-				entry: d,
+				entry: u,
 				formats: ["es"],
 				fileName: "app"
 			},
@@ -45,61 +46,65 @@ function m(e) {
 			}
 		} }),
 		configResolved(e) {
-			v = e.root;
+			y = e.root;
 		},
 		buildStart() {
 			for (let e of [
-				m,
-				h,
+				p,
+				g,
 				"package.json"
-			]) e && this.addWatchFile(l(v, e));
+			]) e && this.addWatchFile(d(y, e));
 		},
 		generateBundle: {
 			order: "post",
-			async handler(e, i) {
-				let o = Object.values(i), s = o.filter((e) => e.type === "chunk"), d = o.filter((e) => e.type === "asset").map((e) => e.fileName);
-				d.length && this.error(`${c.name} emits ${d.join(", ")} beside its code, and an app file holds one module: no CSS import, no source map file, its art inlined.`);
-				let [g] = s;
-				(!g || s.length > 1) && this.error(`${c.name} builds to ${s.length} modules, and an app file holds one.`);
-				for (let e of Object.keys(g.modules)) {
-					let t = f(e);
-					t && this.error(`${c.name} bundles ${t}. It composes the page's kit and brings none of its own.`);
+			async handler(t, r) {
+				let o = Object.values(r), c = o.filter((e) => e.type === "chunk"), l = o.filter((e) => e.type === "asset").map((e) => e.fileName);
+				l.length && this.error(`${n.name} emits ${l.join(", ")} beside its code, and an app file holds one module: no CSS import, no source map file, its art inlined.`);
+				let [u] = c;
+				(!u || c.length > 1) && this.error(`${n.name} builds to ${c.length} modules, and an app file holds one.`);
+				for (let e of Object.keys(u.modules)) {
+					let t = m(e);
+					t && this.error(`${n.name} bundles ${t}. It composes the page's kit and brings none of its own.`);
 				}
-				let b = [...g.imports, ...g.dynamicImports].filter((e) => !u.includes(e));
-				b.length && this.error(`${c.name} imports ${b.join(", ")}. An application imports ${u.join(", ")} and its own files.`);
+				let _ = [...u.imports, ...u.dynamicImports].filter((e) => !f.includes(e));
+				_.length && this.error(`${n.name} imports ${_.join(", ")}. An application imports ${f.join(", ")} and its own files.`);
 				try {
-					let e = await p(v);
-					if (!t("0.17.0", e)) throw Error(`package.json requires vintage-frames ${e}, and the build is on ${n}: move the range`);
-					y = await r({
+					let t = await h(y);
+					if (!i("0.19.0", t)) throw Error(`package.json requires vintage-frames ${t}, and the build is on ${e}: move the range`);
+					b = await a({
 						manifest: {
-							id: c.id,
-							name: c.name,
-							version: c.version,
-							requires: e,
-							author: c.author
+							id: n.id,
+							name: n.name,
+							version: n.version,
+							requires: t,
+							author: n.author,
+							description: n.description
 						},
-						icon: new Uint8Array(await a(l(v, m))),
-						code: g.code,
-						artwork: h ? new Uint8Array(await a(l(v, h))) : void 0
+						icon: new Uint8Array(await s(d(y, p))),
+						code: u.code,
+						artwork: g ? new Uint8Array(await s(d(y, g))) : void 0
 					});
 				} catch (e) {
-					this.error(`${c.name}: ${e.message}`);
+					this.error(`${n.name}: ${e.message}`);
 				}
-				delete i[g.fileName], this.emitFile({
+				delete r[u.fileName], this.emitFile({
 					type: "asset",
-					fileName: _,
-					source: y
+					fileName: v,
+					source: b
 				});
 			}
 		},
 		async writeBundle() {
-			if (!g || !y) return;
-			let e = l(v, g);
-			await i(e, { recursive: !0 }), await o(s(e, _), y);
+			if (!_ || !b) return;
+			let e = d(y, _);
+			await o(e, { recursive: !0 }), await c(l(e, v), b);
 		}
 	};
 }
-function h() {
+function _(t) {
+	return t.api === void 0 ? `requires vintage-frames ${t.requires}, and this site has ${e}` : `is built for app API ${t.api}, and this site's kit runs app API 2`;
+}
+function v() {
 	let r = "";
 	return {
 		name: "vintage-frames:app-files",
@@ -108,17 +113,17 @@ function h() {
 			r = e.root;
 		},
 		async load(i) {
-			let o = i.indexOf("?");
-			if (o < 0) return null;
-			let s = i.slice(0, o), l = new URLSearchParams(i.slice(o + 1));
-			if (!s.endsWith(".png") || !(l.has("app") || l.has(d))) return null;
-			this.addWatchFile(s);
-			let u = c(r, s), f = await e(new Uint8Array(await a(s)));
-			typeof f == "string" && this.error(`${u} is not an app file: ${f}.`);
-			let { manifest: p, code: m } = f;
-			return l.has(d) ? m : (t("0.17.0", p.requires) || this.error(`${u}: ${p.name} ${p.version} requires vintage-frames ${p.requires}, and this site has ${n}. Build ${p.name} on ${n} and copy its app file in.`), [
-				`import factory from ${JSON.stringify(`${s}?${d}`)}`,
-				`export const manifest = ${JSON.stringify(p)}`,
+			let a = i.indexOf("?");
+			if (a < 0) return null;
+			let o = i.slice(0, a), c = new URLSearchParams(i.slice(a + 1));
+			if (!o.endsWith(".png") || !(c.has("app") || c.has(p))) return null;
+			this.addWatchFile(o);
+			let l = u(r, o), d = await n(new Uint8Array(await s(o)));
+			typeof d == "string" && this.error(`${l} is not an app file: ${d}.`);
+			let { manifest: f, code: m } = d;
+			return c.has(p) ? m : (t(f) || this.error(`${l}: ${f.name} ${f.version} ${_(f)}. Build ${f.name} on ${e} and copy its app file in.`), [
+				`import factory from ${JSON.stringify(`${o}?${p}`)}`,
+				`export const manifest = ${JSON.stringify(f)}`,
 				"export default (...args) => ({ ...factory(...args), icon: manifest.icon })",
 				""
 			].join("\n"));
@@ -126,4 +131,4 @@ function h() {
 	};
 }
 //#endregion
-export { m as appFile, h as appFiles };
+export { g as appFile, v as appFiles };

package/dist/components/vf-icon.d.ts

@@ -1,4 +1,5 @@
 import { LitElement } from 'lit';
+import '../styles/body-italic-font.js';
 /** Which member of the icon family paints — the two System 7 resource sizes. */
 export type VfIconSize = 'large' | 'small';
 /**
@@ -523,6 +524,12 @@ export declare class VfIcon extends VfIcon_base {
      * Selection inverts the ghost exactly as it inverts the art.
      */
     open: boolean;
+    /**
+     * The icon is an alias, an item standing for another: its name is set in
+     * italics, the body face's own, and the plate widens to the slant's last
+     * pixel.
+     */
+    alias: boolean;
     /**
      * Drag to move — `movable`, never `draggable`, which is a platform attribute
      * and accessor (see the class doc). Arrow keys move a focused icon too, which