vintage-frames 0.17.0 → 0.19.0

package/dist/shell/geometry.d.ts

@@ -183,6 +183,13 @@ export declare function cleanUp(grid: Lattice, positions: readonly Point[]): Poi
  * a bounded lattice is full.
  */
 export declare function nextFreeCell(grid: Lattice, taken: readonly Point[], cell?: number): Point;
+/**
+ * The free cell nearest `at`: square rings out from its rounded, clamped
+ * cell, as Clean Up searches, a cell free where no icon at `taken` overlaps
+ * it. Of two as near, the later in fill order. The next free cell when the
+ * rings find none.
+ */
+export declare function freeCellNear(grid: Lattice, at: Point, taken: readonly Point[], cell?: number): Point;
 /**
  * A folder's field: at least its viewport, grown to hold every icon at
  * `positions` (their top-lefts) plus the inset past it. The field's size is

package/dist/shell/geometry.js

@@ -221,7 +221,23 @@ function A(e, t, n = 64) {
 	}
 	return E(e, 0);
 }
-function j(e, t, { cell: n = 64, inset: r = 16 } = {}) {
+function j(e, t, n, r = 64) {
+	let i = {
+		col: O((t.left - e.left) / e.dx, e.cols),
+		row: O((t.top - e.top) / e.dy, e.rows)
+	}, a = (e) => !n.some((t) => Math.abs(t.left - e.left) < r && Math.abs(t.top - e.top) < r), o = Math.min(e.cols, 2 * n.length + 1) + Math.min(e.rows, 2 * n.length + 1);
+	for (let n = 0; n <= o; n++) {
+		let r = null, o = Infinity;
+		for (let s = i.col - n; s <= i.col + n; s++) for (let c = i.row - n; c <= i.row + n; c++) {
+			if (Math.max(Math.abs(s - i.col), Math.abs(c - i.row)) !== n || s < 0 || c < 0 || s >= e.cols || c >= e.rows) continue;
+			let l = T(e, s, c), u = (l.left - t.left) ** 2 + (l.top - t.top) ** 2;
+			(u < o || u === o && D(e, l, r) > 0) && a(l) && (o = u, r = l);
+		}
+		if (r) return r;
+	}
+	return A(e, n, r);
+}
+function M(e, t, { cell: n = 64, inset: r = 16 } = {}) {
 	let i = t.width, a = t.height;
 	for (let t of e) i = Math.max(i, t.left + n + r), a = Math.max(a, t.top + n + r);
 	return {
@@ -229,7 +245,7 @@ function j(e, t, { cell: n = 64, inset: r = 16 } = {}) {
 		height: a
 	};
 }
-function M(e) {
+function N(e) {
 	let t = /* @__PURE__ */ new Set();
 	for (let n = 0; n < e.length; n++) for (let r = n + 1; r < e.length; r++) {
 		let i = e[n], a = e[r];
@@ -238,4 +254,4 @@ function M(e) {
 	return t;
 }
 //#endregion
-export { u as BAND, t as CASCADE_SLOTS, e as CASCADE_STEP, v as ICON_CELL, b as ICON_COLUMN, x as ICON_INSET, y as ICON_ROW, c as NEAR, n as WINDOW_ORIGIN, a as cascadeFrom, i as cascadeSlot, s as cascadedBox, o as centeredBox, k as cleanUp, M as collisions, S as desktopLattice, j as fieldExtent, D as fillOrder, w as folderLattice, d as frameOf, f as isPin, T as latticeCell, E as latticeSlot, l as nearBox, A as nextFreeCell, g as pinOf, _ as pinTo, C as trashCell, r as windowOrigin };
+export { u as BAND, t as CASCADE_SLOTS, e as CASCADE_STEP, v as ICON_CELL, b as ICON_COLUMN, x as ICON_INSET, y as ICON_ROW, c as NEAR, n as WINDOW_ORIGIN, a as cascadeFrom, i as cascadeSlot, s as cascadedBox, o as centeredBox, k as cleanUp, N as collisions, S as desktopLattice, M as fieldExtent, D as fillOrder, w as folderLattice, d as frameOf, j as freeCellNear, f as isPin, T as latticeCell, E as latticeSlot, l as nearBox, A as nextFreeCell, g as pinOf, _ as pinTo, C as trashCell, r as windowOrigin };

package/dist/shell/index.d.ts

@@ -17,14 +17,14 @@ export { finder, FINDER } from './finder.js';
 export type { FinderAlert, FinderAlertHandler, FinderAlerts, FinderApi, FinderArt, FinderCommand, FinderCommandSpec, FinderFailedAction, FinderMenu, FinderOpen, FinderOptions, } from './finder.js';
 export { fileByDrag } from './filing.js';
 export type { FilingOptions } from './filing.js';
-export { createCatalog, memoryStorage, appIdOf, childrenOf, containerOf, copyName, descendantsOf, enclosingFolders, isContainerKind, isInside, isTrashed, isVolume, itemCount, itemOf, nextFolderName, APP_KIND, DISK, FOLDER, TRASH, UNTITLED_FOLDER, } from './catalog.js';
-export type { Catalog, CatalogArchive, CatalogOptions, CatalogState, CatalogStorage, Item, KindHooks, NewItem, Volumes, } from './catalog.js';
+export { createCatalog, memoryStorage, aliasName, appIdOf, appleMenuItemsOf, childrenOf, containerOf, copyName, descendantsOf, enclosingFolders, isContainerKind, isInside, isKept, isTrashed, isVolume, itemCount, itemOf, nextFolderName, originalOf, resolve, startupItemsOf, ALIAS_KIND, APPLE_MENU_ITEMS, APP_KIND, DISK, FOLDER, STARTUP_ITEMS, SYSTEM_FOLDER, TRASH, UNTITLED_FOLDER, } from './catalog.js';
+export type { Catalog, CatalogArchive, CatalogOptions, CatalogState, CatalogStorage, Item, KindHooks, NewItem, SystemFolders, Volumes, } from './catalog.js';
 export { indexedDbStorage } from './storage.js';
 export { localStorageState, mergeSession, openWindowsOf, readSession } from './state.js';
 export type { LocalStorageStateOptions, SavedSession, SavedWindow, SessionSnapshot, ShellState } from './state.js';
-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 { 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, freeCellNear, 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 { APP_API, APP_API_OLDEST, APP_FILE_FORMAT, BOX_SCALE, appRuns, 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

@@ -1,12 +1,12 @@
-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 { createWindowManager as Y, focusInto as X } from "./windows.js";
-import { localStorageState as Z, mergeSession as Q, openWindowsOf as $, readSession as ee } from "./state.js";
-import { DATE_HOLD_MS as te, formatDate as ne, formatTime as re, startClock as ie } from "./clock.js";
-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";
-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 };
+import { ALIAS_KIND as e, APPLE_MENU_ITEMS as t, APP_KIND as n, DISK as r, FOLDER as i, STARTUP_ITEMS as a, SYSTEM_FOLDER as o, TRASH as s, UNTITLED_FOLDER as c, aliasName as l, appIdOf as u, appleMenuItemsOf as d, childrenOf as f, containerOf as p, copyName as m, createCatalog as h, descendantsOf as g, enclosingFolders as _, isContainerKind as v, isInside as y, isKept as b, isTrashed as x, isVolume as S, itemCount as C, itemOf as w, memoryStorage as T, nextFolderName as E, originalOf as D, resolve as O, startupItemsOf as k } from "./catalog.js";
+import { BAND as A, CASCADE_SLOTS as j, CASCADE_STEP as M, ICON_CELL as N, ICON_COLUMN as P, ICON_INSET as F, ICON_ROW as I, NEAR as L, WINDOW_ORIGIN as R, cascadeFrom as z, cascadeSlot as B, cascadedBox as V, centeredBox as H, cleanUp as U, collisions as W, desktopLattice as G, fieldExtent as K, fillOrder as q, folderLattice as J, frameOf as Y, freeCellNear as X, isPin as Z, latticeCell as Q, latticeSlot as $, nearBox as ee, nextFreeCell as te, pinOf as ne, pinTo as re, trashCell as ie, windowOrigin as ae } from "./geometry.js";
+import { createWindowManager as oe, focusInto as se } from "./windows.js";
+import { localStorageState as ce, mergeSession as le, openWindowsOf as ue, readSession as de } from "./state.js";
+import { DATE_HOLD_MS as fe, formatDate as pe, formatTime as me, startClock as he } from "./clock.js";
+import { createShell as ge, defineApp as _e } from "./shell.js";
+import { fileByDrag as ve } from "./filing.js";
+import { FINDER as ye, finder as be } from "./finder.js";
+import { indexedDbStorage as xe } from "./storage.js";
+import { VERSION as Se } from "./version.js";
+import { APP_API as Ce, APP_API_OLDEST as we, APP_FILE_FORMAT as Te, BOX_SCALE as Ee, appRuns as De, compareVersions as Oe, inspectAppFile as ke, readAppFile as Ae, satisfies as je } from "./app-file.js";
+export { e as ALIAS_KIND, t as APPLE_MENU_ITEMS, Ce as APP_API, we as APP_API_OLDEST, Te as APP_FILE_FORMAT, n as APP_KIND, A as BAND, Ee as BOX_SCALE, j as CASCADE_SLOTS, M as CASCADE_STEP, fe as DATE_HOLD_MS, r as DISK, ye as FINDER, i as FOLDER, N as ICON_CELL, P as ICON_COLUMN, F as ICON_INSET, I as ICON_ROW, L as NEAR, a as STARTUP_ITEMS, o as SYSTEM_FOLDER, s as TRASH, c as UNTITLED_FOLDER, Se as VERSION, R as WINDOW_ORIGIN, l as aliasName, u as appIdOf, De as appRuns, d as appleMenuItemsOf, z as cascadeFrom, B as cascadeSlot, V as cascadedBox, H as centeredBox, f as childrenOf, U as cleanUp, W as collisions, Oe as compareVersions, p as containerOf, m as copyName, h as createCatalog, ge as createShell, oe as createWindowManager, _e as defineApp, g as descendantsOf, G as desktopLattice, _ as enclosingFolders, K as fieldExtent, ve as fileByDrag, q as fillOrder, be as finder, se as focusInto, J as folderLattice, pe as formatDate, me as formatTime, Y as frameOf, X as freeCellNear, xe as indexedDbStorage, ke as inspectAppFile, v as isContainerKind, y as isInside, b as isKept, Z as isPin, x as isTrashed, S as isVolume, C as itemCount, w as itemOf, Q as latticeCell, $ as latticeSlot, ce as localStorageState, T as memoryStorage, le as mergeSession, ee as nearBox, E as nextFolderName, te as nextFreeCell, ue as openWindowsOf, D as originalOf, ne as pinOf, re as pinTo, Ae as readAppFile, de as readSession, O as resolve, je as satisfies, he as startClock, k as startupItemsOf, ie as trashCell, ae as windowOrigin };

package/dist/shell/pure.d.ts

@@ -8,6 +8,6 @@
 export * from './catalog.js';
 export * from './geometry.js';
 export * from './state.js';
-export { APP_FILE_FORMAT, readAppFile, satisfies } from './app-file.js';
+export { APP_API, APP_API_OLDEST, APP_FILE_FORMAT, BOX_SCALE, appRuns, 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,6 +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";
-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 };
+import { ALIAS_KIND as e, APPLE_MENU_ITEMS as t, APP_KIND as n, DISK as r, FOLDER as i, STARTUP_ITEMS as a, SYSTEM_FOLDER as o, TRASH as s, UNTITLED_FOLDER as c, aliasName as l, appIdOf as u, appleMenuItemsOf as d, childrenOf as f, containerOf as p, copyName as m, createCatalog as h, descendantsOf as g, enclosingFolders as _, isContainerKind as v, isInside as y, isKept as b, isTrashed as x, isVolume as S, itemCount as C, itemOf as w, memoryStorage as T, nextFolderName as E, originalOf as D, resolve as O, startupItemsOf as k } from "./catalog.js";
+import { BAND as A, CASCADE_SLOTS as j, CASCADE_STEP as M, ICON_CELL as N, ICON_COLUMN as P, ICON_INSET as F, ICON_ROW as I, NEAR as L, WINDOW_ORIGIN as R, cascadeFrom as z, cascadeSlot as B, cascadedBox as V, centeredBox as H, cleanUp as U, collisions as W, desktopLattice as G, fieldExtent as K, fillOrder as q, folderLattice as J, frameOf as Y, freeCellNear as X, isPin as Z, latticeCell as Q, latticeSlot as $, nearBox as ee, nextFreeCell as te, pinOf as ne, pinTo as re, trashCell as ie, windowOrigin as ae } from "./geometry.js";
+import { localStorageState as oe, mergeSession as se, openWindowsOf as ce, readSession as le } from "./state.js";
+import { VERSION as ue } from "./version.js";
+import { APP_API as de, APP_API_OLDEST as fe, APP_FILE_FORMAT as pe, BOX_SCALE as me, appRuns as he, compareVersions as ge, inspectAppFile as _e, readAppFile as ve, satisfies as ye } from "./app-file.js";
+export { e as ALIAS_KIND, t as APPLE_MENU_ITEMS, de as APP_API, fe as APP_API_OLDEST, pe as APP_FILE_FORMAT, n as APP_KIND, A as BAND, me as BOX_SCALE, j as CASCADE_SLOTS, M as CASCADE_STEP, r as DISK, i as FOLDER, N as ICON_CELL, P as ICON_COLUMN, F as ICON_INSET, I as ICON_ROW, L as NEAR, a as STARTUP_ITEMS, o as SYSTEM_FOLDER, s as TRASH, c as UNTITLED_FOLDER, ue as VERSION, R as WINDOW_ORIGIN, l as aliasName, u as appIdOf, he as appRuns, d as appleMenuItemsOf, z as cascadeFrom, B as cascadeSlot, V as cascadedBox, H as centeredBox, f as childrenOf, U as cleanUp, W as collisions, ge as compareVersions, p as containerOf, m as copyName, h as createCatalog, g as descendantsOf, G as desktopLattice, _ as enclosingFolders, K as fieldExtent, q as fillOrder, J as folderLattice, Y as frameOf, X as freeCellNear, _e as inspectAppFile, v as isContainerKind, y as isInside, b as isKept, Z as isPin, x as isTrashed, S as isVolume, C as itemCount, w as itemOf, Q as latticeCell, $ as latticeSlot, oe as localStorageState, T as memoryStorage, se as mergeSession, ee as nearBox, E as nextFolderName, te as nextFreeCell, ce as openWindowsOf, D as originalOf, ne as pinOf, re as pinTo, ve as readAppFile, le as readSession, O as resolve, ye as satisfies, k as startupItemsOf, ie as trashCell, ae as windowOrigin };

package/dist/shell/shell.d.ts

@@ -7,10 +7,13 @@
  *   nodes come back each time it is front, so items keep their state. A menu
  *   off the bar has no key equivalents, so only the front application's fire.
  *   The bar's label is the front application's name.
+ * - The system menu is the page's own items, then what Apple Menu Items
+ *   holds, by name, following the folder as it changes. Choosing an entry
+ *   opens its item as a double-click would. No application adds to it.
  * - While an application's held dialog is open, the bar shows that
  *   application's name and menus instead; nothing else changes.
  * - Each application's `init(ctx)` gets the desktop, the window manager, its
- *   own menus, dialogs and window markup, the system menu, the other applications' actions
+ *   own menus, dialogs and window markup, the other applications' actions
  *   (read at the call), the catalog when a Finder runs, the site's services,
  *   `ask()`, `gate()`, `onFront()` and `onDispose()`. Everything it sets up
  *   comes down through `onDispose()`, and its dialogs with it, so a hot
@@ -19,11 +22,12 @@
  *   and it closes when the item is removed.
  * - The boot waits for the desktop and its menu bar to render, reads the
  *   catalog, seeds it once, reopens the last session's windows deepest
- *   first and the active one last, then starts saving.
+ *   first and the active one last, opens what Startup Items holds, then
+ *   starts saving.
  */
 import { VfWindow } from '../index.js';
 import type { VfDesktop, VfDialog, VfMenu, VfMenuItem, VfModalDialog, VfViewportBox } from '../index.js';
-import type { Catalog, CatalogStorage, Item, Volumes } from './catalog.js';
+import type { Catalog, CatalogStorage, Item, SystemFolders, Volumes } from './catalog.js';
 import type { WindowManager } from './windows.js';
 import type { ShellState } from './state.js';
 /** A kind of catalog item an application registers: how it looks and opens. */
@@ -45,10 +49,12 @@ export interface KindDefinition {
     /** The item on the system clipboard, as a file. */
     export?(item: Item): Promise<Blob | null>;
 }
-/** The catalog a Finder brings: where it is stored, its volumes and its seed. */
+/** The catalog a Finder brings: where it is stored, its volumes, its System Folder and its seed. */
 export interface CatalogSetup {
     storage: CatalogStorage | null;
     volumes?: Volumes;
+    /** The System Folder, named; its folders drive the Apple menu and what opens at startup. */
+    system?: SystemFolders;
     /** Run once per storage, to store the site's defaults. */
     seed?: (catalog: Catalog) => void | Promise<void>;
 }
@@ -88,17 +94,15 @@ export interface AppContext {
     readonly windows: WindowManager;
     /** Its own menus, parsed from `menus`. */
     readonly menus: VfMenu[];
-    /** The page's system menu, for the items applications install. */
-    readonly systemMenu: VfMenu;
     /** Every application's actions by id, read at the call. */
     readonly apps: Record<string, any>;
-    /** The catalog, when a Finder runs; read before the boot has refreshed it, it lists the volumes alone. */
+    /** The catalog, when a Finder runs; read before the boot has refreshed it, it lists the kept containers alone. */
     readonly catalog: Catalog | null;
     /** The site's own services. */
     readonly services: Record<string, any>;
     /** The saved session, or null. */
     readonly state: ShellState | null;
-    /** Every kind the applications register, the shell's `app` kind included, in registration order. */
+    /** Every kind the applications register, the shell's `app` and `alias` kinds included, in registration order. */
     readonly kinds: ReadonlyMap<string, KindDefinition>;
     /** A kind's definition, or undefined. */
     kind(kind: string): KindDefinition | undefined;
@@ -110,8 +114,6 @@ export interface AppContext {
     item(value: string): VfMenuItem;
     /** Every pick from its menus — never while a modal is open. */
     onMenu(fn: (value: string, item: VfMenuItem) => void): void;
-    /** Put an item in the system menu, which runs `fn` when picked. */
-    systemItem(value: string, label: string, fn: () => void): VfMenuItem;
     /** One of its dialogs by `data-dialog`; throws when the markup drifts. */
     dialog<T extends HTMLElement = VfDialog>(name: string): T;
     /**
@@ -158,6 +160,8 @@ export interface ShellOptions {
     services?: Record<string, unknown>;
     /** The clock in the menu bar's `end` slot. Default true. */
     clock?: boolean;
+    /** Open what Startup Items holds once the session is back. Default true; false skips it for this boot. */
+    startup?: boolean;
 }
 /** A running shell. */
 export interface Shell {

package/dist/shell/shell.js

@@ -1,101 +1,110 @@
 import { onScaleChange as e } from "../scale.js";
 import { VfWindow as t } from "../components/vf-window.js";
 import "../index.js";
-import { appIdOf as n, createCatalog as r } from "./catalog.js";
-import { createWindowManager as i, deepActiveElement as a, desktopRendered as o } from "./windows.js";
-import { openWindowsOf as s } from "./state.js";
-import { startClock as c } from "./clock.js";
+import { ALIAS_KIND as n, appIdOf as r, appleMenuItemsOf as i, createCatalog as a, resolve as o, startupItemsOf as s } from "./catalog.js";
+import { createWindowManager as c, deepActiveElement as l, desktopRendered as u } from "./windows.js";
+import { openWindowsOf as d } from "./state.js";
+import { startClock as f } from "./clock.js";
 //#region src/shell/shell.ts
-function l(e) {
+function p(e) {
 	return e;
 }
-var u = (e) => e instanceof HTMLInputElement || e instanceof HTMLTextAreaElement || e?.isContentEditable === !0;
-function d(l, d) {
-	let f = d.apps, p = f.find((e) => e.catalog), m = d.defaultApp ?? p?.id ?? f[0]?.id ?? "", h = d.state ?? null, g = d.services ?? {}, _ = [], v = l.querySelector(":scope > vf-menu-bar");
-	if (!v) throw Error("vintage-frames/shell: the desktop has no vf-menu-bar");
-	let y = v.querySelector(":scope > vf-menu");
-	if (!y) throw Error("vintage-frames/shell: the menu bar has no system menu");
-	v.shortcuts = !0;
-	let b = h?.saved?.pattern;
-	b && (l.pattern = b);
-	let x = null;
-	if (d.fit === "viewport") {
+var m = (e) => e instanceof HTMLInputElement || e instanceof HTMLTextAreaElement || e?.isContentEditable === !0;
+function h(p, h) {
+	let g = h.apps, _ = g.find((e) => e.catalog), v = h.defaultApp ?? _?.id ?? g[0]?.id ?? "", y = h.state ?? null, b = h.services ?? {}, x = [], S = p.querySelector(":scope > vf-menu-bar");
+	if (!S) throw Error("vintage-frames/shell: the desktop has no vf-menu-bar");
+	let C = S.querySelector(":scope > vf-menu");
+	if (!C) throw Error("vintage-frames/shell: the menu bar has no system menu");
+	S.shortcuts = !0;
+	let w = y?.saved?.pattern;
+	w && (p.pattern = w);
+	let T = null;
+	if (h.fit === "viewport") {
 		let t = () => {
 			let e = {
-				width: l.width,
-				height: l.height
+				width: p.width,
+				height: p.height
 			};
-			l.fitWithin(document.documentElement.clientWidth, document.documentElement.clientHeight), x?.resized(e);
+			p.fitWithin(document.documentElement.clientWidth, document.documentElement.clientHeight), T?.resized(e);
 		};
 		t(), window.addEventListener("resize", t);
 		let n = e(t);
-		_.push(() => {
+		x.push(() => {
 			window.removeEventListener("resize", t), n();
 		});
 	}
-	let S = i(l, {
-		defaultApp: m,
-		savedPin: (e) => h?.pin(e) ?? null
+	let E = c(p, {
+		defaultApp: v,
+		savedPin: (e) => y?.pin(e) ?? null
 	});
-	x = S;
-	let C = (e) => {
-		e.target === l && l.clearActive();
+	T = E;
+	let D = (e) => {
+		e.target === p && p.clearActive();
 	};
-	l.addEventListener("pointerdown", C), _.push(() => l.removeEventListener("pointerdown", C));
-	let w = {}, T = /* @__PURE__ */ new Map();
-	T.set("app", {
-		art: (e) => f.find((t) => t.id === n(e))?.icon ?? "",
-		open: (e, t) => void w[n(e) ?? ""]?.open?.({ from: t }),
+	p.addEventListener("pointerdown", D), x.push(() => p.removeEventListener("pointerdown", D));
+	let O = {}, k = (e, t = null) => O[_?.id ?? ""]?.open?.({
+		item: e,
+		from: t
+	}), A = /* @__PURE__ */ new Map();
+	A.set("app", {
+		art: (e) => g.find((t) => t.id === r(e))?.icon ?? "",
+		open: (e, t) => void O[r(e) ?? ""]?.open?.({ from: t }),
 		editable: !1
+	}), A.set(n, {
+		art: (e) => {
+			let t = j && o(j.get(), e.id), n = t && A.get(t.kind);
+			return !t || !n ? "" : typeof n.art == "function" ? n.art(t) : n.art;
+		},
+		open: (e, t) => void k(e.id, t)
 	});
-	for (let e of f) for (let [t, n] of Object.entries(e.kinds ?? {})) T.set(t, n);
-	let E = p?.catalog ? r({
-		storage: p.catalog.storage,
-		volumes: p.catalog.volumes,
-		listed: (e) => T.has(e),
-		hooks: (e) => T.get(e)
-	}) : null, D = () => !!document.querySelector("vf-dialog[open]"), O = () => u(a()), k = /* @__PURE__ */ new Map(), A = () => {
-		for (let [e, t] of k) {
+	for (let e of g) for (let [t, n] of Object.entries(e.kinds ?? {})) A.set(t, n);
+	let j = _?.catalog ? a({
+		storage: _.catalog.storage,
+		volumes: _.catalog.volumes,
+		system: _.catalog.system,
+		listed: (e) => A.has(e),
+		hooks: (e) => A.get(e)
+	}) : null, M = () => !!document.querySelector("vf-dialog[open]"), N = () => m(l()), P = /* @__PURE__ */ new Map(), F = () => {
+		for (let [e, t] of P) {
 			let n = !t();
 			e.disabled !== n && (e.disabled = n);
 		}
 	};
-	document.addEventListener("pointerdown", A, !0), document.addEventListener("keydown", A, !0), l.addEventListener("vf-select", A), l.addEventListener("vf-activate", A), _.push(() => document.removeEventListener("pointerdown", A, !0), () => document.removeEventListener("keydown", A, !0), () => l.removeEventListener("vf-select", A), () => l.removeEventListener("vf-activate", A), S.onWindows(A), S.onLayout(A)), E && _.push(E.subscribe(A));
-	let j = (e) => {
+	document.addEventListener("pointerdown", F, !0), document.addEventListener("keydown", F, !0), p.addEventListener("vf-select", F), p.addEventListener("vf-activate", F), x.push(() => document.removeEventListener("pointerdown", F, !0), () => document.removeEventListener("keydown", F, !0), () => p.removeEventListener("vf-select", F), () => p.removeEventListener("vf-activate", F), E.onWindows(F), E.onLayout(F)), j && x.push(j.subscribe(F));
+	let I = (e) => {
 		if (!e) return [];
 		let t = document.createElement("div");
 		t.innerHTML = e, customElements.upgrade(t);
 		let n = [...t.children].filter((e) => e instanceof HTMLElement);
 		for (let e of n) e.remove();
 		return n;
-	}, M = f.map((e) => ({
+	}, L = g.map((e) => ({
 		def: e,
-		menus: j(e.menus).filter((e) => e.localName === "vf-menu"),
-		dialogs: j(e.dialogs).filter((e) => e.dataset.dialog != null),
+		menus: I(e.menus).filter((e) => e.localName === "vf-menu"),
+		dialogs: I(e.dialogs).filter((e) => e.dataset.dialog != null),
 		windows: (() => {
 			let t = document.createElement("template");
 			return t.innerHTML = e.windows ?? "", t.content;
 		})()
-	})), N = [];
-	for (let { def: e, menus: t, dialogs: n, windows: r } of M) {
+	})), R = [];
+	for (let { def: e, menus: t, dialogs: n, windows: r } of L) {
 		let i = [], a = `vintage-frames/shell (${e.id})`, o = /* @__PURE__ */ new Set();
-		for (let t of n) S.holdDialog(t, { app: e.id }), o.add(t);
+		for (let t of n) E.holdDialog(t, { app: e.id }), o.add(t);
 		i.push(() => {
-			for (let e of o) S.releaseDialog(e), e.remove();
+			for (let e of o) E.releaseDialog(e), e.remove();
 			o.clear();
 		});
 		let s = {
-			desktop: l,
-			windows: S,
+			desktop: p,
+			windows: E,
 			menus: t,
-			systemMenu: y,
-			apps: w,
-			catalog: E,
-			services: g,
-			state: h,
-			kinds: T,
-			kind: (e) => T.get(e),
-			app: (e) => f.find((t) => t.id === e),
+			apps: O,
+			catalog: j,
+			services: b,
+			state: y,
+			kinds: A,
+			kind: (e) => A.get(e),
+			app: (e) => g.find((t) => t.id === e),
 			menu(e) {
 				let n = t.find((t) => t.dataset.menu === e);
 				if (!n) throw Error(`${a}: missing menu ${e}`);
@@ -110,17 +119,11 @@ function d(l, d) {
 			},
 			onMenu(e) {
 				for (let n of t) s.on(n, "vf-menu-select", (t) => {
-					if (D()) return;
+					if (M()) return;
 					let { value: n, item: r } = t.detail;
 					e(n, r);
 				});
 			},
-			systemItem(e, t, n) {
-				let r = document.createElement("vf-menu-item");
-				return r.setAttribute("value", e), r.textContent = t, y.append(r), s.on(y, "vf-menu-select", (t) => {
-					!D() && t.detail.value === e && n();
-				}), i.push(() => r.remove()), r;
-			},
 			dialog(e) {
 				let t = n.find((t) => t.dataset.dialog === e);
 				if (!t) throw Error(`${a}: missing dialog ${e}`);
@@ -133,29 +136,29 @@ function d(l, d) {
 				return customElements.upgrade(n), n;
 			},
 			hold(t) {
-				return S.holdDialog(t, { app: e.id }), o.add(t), t;
+				return E.holdDialog(t, { app: e.id }), o.add(t), t;
 			},
 			release(e) {
-				o.delete(e) && (S.releaseDialog(e), e.remove());
+				o.delete(e) && (E.releaseDialog(e), e.remove());
 			},
 			ask(t) {
-				if (S.appOf(t) !== e.id) throw Error(`${a}: ask() takes a dialog the application holds`);
+				if (E.appOf(t) !== e.id) throw Error(`${a}: ask() takes a dialog the application holds`);
 				return new Promise((e) => {
 					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) {
-				k.set(e, t), i.push(() => k.delete(e));
+				P.set(e, t), i.push(() => P.delete(e));
 				let n = !t();
 				e.disabled !== n && (e.disabled = n);
 			},
-			typing: O,
-			modalOpen: D,
+			typing: N,
+			modalOpen: M,
 			onFront(t) {
-				t(S.front === e.id), i.push(S.onFront((n) => t(n === e.id)));
+				t(E.front === e.id), i.push(E.onFront((n) => t(n === e.id)));
 			},
 			on(e, t, n, r) {
 				e.addEventListener(t, n, r), i.push(() => e.removeEventListener(t, n, r));
@@ -164,82 +167,106 @@ function d(l, d) {
 				i.push(e);
 			}
 		}, c = e.init(s);
-		c && (w[e.id] = c), N.push(() => {
+		c && (O[e.id] = c), R.push(() => {
 			for (let e of i.splice(0).reverse()) e();
 		});
 	}
-	let P = null, F = () => {
-		let e = S.asking ?? S.front, t = M.find((t) => t.def.id === e) ?? M.find((e) => e.def.id === m) ?? null;
-		if (!(!t || t === P)) {
-			if (P) for (let e of P.menus) e.remove();
-			y.after(...t.menus), v.label = t.def.name, P = t, A();
+	let z = null, B = () => {
+		let e = E.asking ?? E.front, t = L.find((t) => t.def.id === e) ?? L.find((e) => e.def.id === v) ?? null;
+		if (!(!t || t === z)) {
+			if (z) for (let e of z.menus) e.remove();
+			C.after(...t.menus), S.label = t.def.name, z = t, F();
+		}
+	};
+	x.push(E.onFront(B), E.onDialogs(B)), B();
+	let V = /* @__PURE__ */ new Map(), H = () => {
+		let e = j ? i(j.get()) : [], t = [...V];
+		if (t.length === e.length && t.every(([, t], n) => t === e[n].id)) {
+			t.forEach(([t], n) => {
+				t.textContent !== e[n].name && (t.textContent = e[n].name);
+			});
+			return;
+		}
+		for (let [e] of t) e.remove();
+		V.clear();
+		for (let t of e) {
+			let e = document.createElement("vf-menu-item");
+			e.setAttribute("value", t.id), e.textContent = t.name, C.append(e), V.set(e, t.id);
 		}
+	}, U = (e) => {
+		let t = V.get(e.detail.item);
+		t != null && !M() && k(t);
 	};
-	if (_.push(S.onFront(F), S.onDialogs(F)), F(), d.clock !== !1) {
-		let e = v.querySelector(":scope > [slot=\"end\"]"), t = !e;
-		e || (e = document.createElement("vf-label"), e.slot = "end", v.append(e));
-		let n = c(e);
-		_.push(() => {
+	if (C.addEventListener("vf-menu-select", U), x.push(() => {
+		C.removeEventListener("vf-menu-select", U);
+		for (let [e] of V) e.remove();
+		V.clear();
+	}), j && x.push(j.subscribe(H)), h.clock !== !1) {
+		let e = S.querySelector(":scope > [slot=\"end\"]"), t = !e;
+		e || (e = document.createElement("vf-label"), e.slot = "end", S.append(e));
+		let n = f(e);
+		x.push(() => {
 			n(), t && e.remove();
 		});
 	}
-	let I = /* @__PURE__ */ new WeakSet(), L = () => {
-		if (E) for (let e of l.stackingOrder) {
+	let W = /* @__PURE__ */ new WeakSet(), G = () => {
+		if (j) for (let e of p.stackingOrder) {
 			if (!(e instanceof t)) continue;
-			let n = S.itemOf(e);
+			let n = E.itemOf(e);
 			if (n == null) continue;
-			let r = E.item(n);
-			r ? (I.add(e), e.heading !== r.name && (e.heading = r.name)) : I.has(e) && E.get().available && S.close(e, { to: null });
+			let r = j.item(n);
+			r ? (W.add(e), e.heading !== r.name && (e.heading = r.name)) : W.has(e) && j.get().available && E.close(e, { to: null });
 		}
 	};
-	return E && _.push(E.subscribe(L), S.onWindows(L)), h?.hold(), {
-		desktop: l,
-		windows: S,
-		catalog: E,
-		apps: w,
+	return j && x.push(j.subscribe(G), E.onWindows(G)), y?.hold(), {
+		desktop: p,
+		windows: E,
+		catalog: j,
+		apps: O,
 		ready: (async () => {
 			try {
-				await o(l), E && (await E.refresh(), p?.catalog?.seed && await E.seed(p.catalog.seed));
-				for (let { item: e, app: t } of s(h?.saved ?? null)) await w[t]?.open?.({ item: e });
-				let e = h?.saved?.active;
+				await u(p), j && (await j.refresh(), _?.catalog?.seed && await j.seed(_.catalog.seed));
+				for (let { item: e, app: t } of d(y?.saved ?? null)) await O[t]?.open?.({ item: e });
+				let e = y?.saved?.active;
 				if (e) {
-					let t = S.windowFor(e);
-					t && l.bringToFront(t);
+					let t = E.windowFor(e);
+					t && p.bringToFront(t);
 				}
+				if (j && h.startup !== !1) for (let e of s(j.get())) await k(e.id);
 			} finally {
-				if (h) {
-					let e = h.start(() => ({
-						windows: S.snapshot(),
-						active: S.itemOf(l.activeWindow),
-						pattern: l.pattern ?? null
+				if (y) {
+					let e = y.start(() => ({
+						windows: E.snapshot(),
+						active: E.itemOf(p.activeWindow),
+						pattern: p.pattern ?? null
 					}), (e) => {
 						let t = [
-							S.onLayout(e),
-							S.onWindows(e),
-							...E ? [E.subscribe(e)] : []
+							E.onLayout(e),
+							E.onWindows(e),
+							...j ? [j.subscribe(e)] : []
 						];
-						l.addEventListener("vf-activate", e);
+						p.addEventListener("vf-activate", e);
 						let n = new MutationObserver(e);
-						return n.observe(l, {
+						return n.observe(p, {
 							attributes: !0,
 							attributeFilter: ["pattern"]
 						}), () => {
 							for (let e of t) e();
-							l.removeEventListener("vf-activate", e), n.disconnect();
+							p.removeEventListener("vf-activate", e), n.disconnect();
 						};
 					});
-					_.push(e), h.release();
+					x.push(e), y.release();
 				}
 			}
 		})(),
 		dispose() {
-			for (let e of N.splice(0).reverse()) e();
-			if (P) for (let e of P.menus) e.remove();
-			P = null;
-			for (let e of _.splice(0)) e();
-			S.dispose(), E?.dispose();
+			for (let e of R.splice(0).reverse()) e();
+			if (z) for (let e of z.menus) e.remove();
+			z = null;
+			for (let e of x.splice(0)) e();
+			E.dispose(), j?.dispose();
 		}
 	};
 }
 //#endregion
-export { d as createShell, l as defineApp };
+export { h as createShell, p as defineApp };

package/dist/shell/version.d.ts

@@ -1,2 +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";
+export declare const VERSION = "0.19.0";

package/dist/shell/version.js

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

package/dist/styles/body-italic-font.d.ts

@@ -0,0 +1,2 @@
+/** Register the body face's italic on the document once (idempotent). */
+export declare function registerBodyItalicFace(): void;