vintage-frames 0.18.0 → 0.19.1

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, appleMenuOf, canAlias, childrenOf, containerOf, copyName, descendantsOf, dropTargetOf, 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 { AppleMenuEntry, Catalog, CatalogArchive, CatalogOptions, CatalogState, CatalogStorage, DropTarget, 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, BOX_SCALE, compareVersions, inspectAppFile, 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, 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 };
+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, appleMenuOf as f, canAlias as p, childrenOf as m, containerOf as h, copyName as g, createCatalog as _, descendantsOf as v, dropTargetOf as y, enclosingFolders as b, isContainerKind as x, isInside as S, isKept as C, isTrashed as w, isVolume as T, itemCount as E, itemOf as D, memoryStorage as O, nextFolderName as k, originalOf as A, resolve as j, startupItemsOf as M } from "./catalog.js";
+import { BAND as N, CASCADE_SLOTS as P, CASCADE_STEP as F, ICON_CELL as I, ICON_COLUMN as L, ICON_INSET as R, ICON_ROW as z, NEAR as B, WINDOW_ORIGIN as V, cascadeFrom as H, cascadeSlot as U, cascadedBox as W, centeredBox as G, cleanUp as K, collisions as q, desktopLattice as J, fieldExtent as Y, fillOrder as X, folderLattice as Z, frameOf as Q, freeCellNear as $, isPin as ee, latticeCell as te, latticeSlot as ne, nearBox as re, nextFreeCell as ie, pinOf as ae, pinTo as oe, trashCell as se, windowOrigin as ce } from "./geometry.js";
+import { createWindowManager as le, focusInto as ue } from "./windows.js";
+import { localStorageState as de, mergeSession as fe, openWindowsOf as pe, readSession as me } from "./state.js";
+import { DATE_HOLD_MS as he, formatDate as ge, formatTime as _e, startClock as ve } from "./clock.js";
+import { createShell as ye, defineApp as be } from "./shell.js";
+import { fileByDrag as xe } from "./filing.js";
+import { FINDER as Se, finder as Ce } from "./finder.js";
+import { indexedDbStorage as we } from "./storage.js";
+import { VERSION as Te } from "./version.js";
+import { APP_API as Ee, APP_API_OLDEST as De, APP_FILE_FORMAT as Oe, BOX_SCALE as ke, appRuns as Ae, compareVersions as je, inspectAppFile as Me, readAppFile as Ne, satisfies as Pe } from "./app-file.js";
+export { e as ALIAS_KIND, t as APPLE_MENU_ITEMS, Ee as APP_API, De as APP_API_OLDEST, Oe as APP_FILE_FORMAT, n as APP_KIND, N as BAND, ke as BOX_SCALE, P as CASCADE_SLOTS, F as CASCADE_STEP, he as DATE_HOLD_MS, r as DISK, Se as FINDER, i as FOLDER, I as ICON_CELL, L as ICON_COLUMN, R as ICON_INSET, z as ICON_ROW, B as NEAR, a as STARTUP_ITEMS, o as SYSTEM_FOLDER, s as TRASH, c as UNTITLED_FOLDER, Te as VERSION, V as WINDOW_ORIGIN, l as aliasName, u as appIdOf, Ae as appRuns, d as appleMenuItemsOf, f as appleMenuOf, p as canAlias, H as cascadeFrom, U as cascadeSlot, W as cascadedBox, G as centeredBox, m as childrenOf, K as cleanUp, q as collisions, je as compareVersions, h as containerOf, g as copyName, _ as createCatalog, ye as createShell, le as createWindowManager, be as defineApp, v as descendantsOf, J as desktopLattice, y as dropTargetOf, b as enclosingFolders, Y as fieldExtent, xe as fileByDrag, X as fillOrder, Ce as finder, ue as focusInto, Z as folderLattice, ge as formatDate, _e as formatTime, Q as frameOf, $ as freeCellNear, we as indexedDbStorage, Me as inspectAppFile, x as isContainerKind, S as isInside, C as isKept, ee as isPin, w as isTrashed, T as isVolume, E as itemCount, D as itemOf, te as latticeCell, ne as latticeSlot, de as localStorageState, O as memoryStorage, fe as mergeSession, re as nearBox, k as nextFolderName, ie as nextFreeCell, pe as openWindowsOf, A as originalOf, ae as pinOf, oe as pinTo, Ne as readAppFile, me as readSession, j as resolve, Pe as satisfies, ve as startClock, M as startupItemsOf, se as trashCell, ce 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, BOX_SCALE, compareVersions, inspectAppFile, 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 $, 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 };
+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, appleMenuOf as f, canAlias as p, childrenOf as m, containerOf as h, copyName as g, createCatalog as _, descendantsOf as v, dropTargetOf as y, enclosingFolders as b, isContainerKind as x, isInside as S, isKept as C, isTrashed as w, isVolume as T, itemCount as E, itemOf as D, memoryStorage as O, nextFolderName as k, originalOf as A, resolve as j, startupItemsOf as M } from "./catalog.js";
+import { BAND as N, CASCADE_SLOTS as P, CASCADE_STEP as F, ICON_CELL as I, ICON_COLUMN as L, ICON_INSET as R, ICON_ROW as z, NEAR as B, WINDOW_ORIGIN as V, cascadeFrom as H, cascadeSlot as U, cascadedBox as W, centeredBox as G, cleanUp as K, collisions as q, desktopLattice as J, fieldExtent as Y, fillOrder as X, folderLattice as Z, frameOf as Q, freeCellNear as $, isPin as ee, latticeCell as te, latticeSlot as ne, nearBox as re, nextFreeCell as ie, pinOf as ae, pinTo as oe, trashCell as se, windowOrigin as ce } from "./geometry.js";
+import { localStorageState as le, mergeSession as ue, openWindowsOf as de, readSession as fe } from "./state.js";
+import { VERSION as pe } from "./version.js";
+import { APP_API as me, APP_API_OLDEST as he, APP_FILE_FORMAT as ge, BOX_SCALE as _e, appRuns as ve, compareVersions as ye, inspectAppFile as be, readAppFile as xe, satisfies as Se } from "./app-file.js";
+export { e as ALIAS_KIND, t as APPLE_MENU_ITEMS, me as APP_API, he as APP_API_OLDEST, ge as APP_FILE_FORMAT, n as APP_KIND, N as BAND, _e as BOX_SCALE, P as CASCADE_SLOTS, F as CASCADE_STEP, r as DISK, i as FOLDER, I as ICON_CELL, L as ICON_COLUMN, R as ICON_INSET, z as ICON_ROW, B as NEAR, a as STARTUP_ITEMS, o as SYSTEM_FOLDER, s as TRASH, c as UNTITLED_FOLDER, pe as VERSION, V as WINDOW_ORIGIN, l as aliasName, u as appIdOf, ve as appRuns, d as appleMenuItemsOf, f as appleMenuOf, p as canAlias, H as cascadeFrom, U as cascadeSlot, W as cascadedBox, G as centeredBox, m as childrenOf, K as cleanUp, q as collisions, ye as compareVersions, h as containerOf, g as copyName, _ as createCatalog, v as descendantsOf, J as desktopLattice, y as dropTargetOf, b as enclosingFolders, Y as fieldExtent, X as fillOrder, Z as folderLattice, Q as frameOf, $ as freeCellNear, be as inspectAppFile, x as isContainerKind, S as isInside, C as isKept, ee as isPin, w as isTrashed, T as isVolume, E as itemCount, D as itemOf, te as latticeCell, ne as latticeSlot, le as localStorageState, O as memoryStorage, ue as mergeSession, re as nearBox, k as nextFolderName, ie as nextFreeCell, de as openWindowsOf, A as originalOf, ae as pinOf, oe as pinTo, xe as readAppFile, fe as readSession, j as resolve, Se as satisfies, M as startupItemsOf, se as trashCell, ce 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, appleMenuOf 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,13 +136,13 @@ 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));
@@ -148,14 +151,14 @@ function d(l, d) {
 				});
 			},
 			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,111 @@ 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 = [], U = "", W = (e) => e.map((e) => e.entries ? `${e.item.id}(${W(e.entries)})` : e.item.id).join(","), G = (e) => e.flatMap((e) => [e.item, ...e.entries ? G(e.entries) : []]), K = (e, t) => {
+		for (let { item: n, entries: r } of e) {
+			let e = document.createElement("vf-menu-item");
+			if (e.setAttribute("value", n.id), e.append(n.name), t.append(e), V.set(e, n.id), H.push(e), r) {
+				let t = document.createElement("vf-menu");
+				t.slot = "submenu", e.append(t), K(r, t);
+			}
+		}
+	}, q = () => {
+		let e = j ? i(j.get()) : [], t = W(e);
+		if (t === U) {
+			G(e).forEach((e, t) => {
+				let n = H[t];
+				n.labelText !== e.name && n.firstChild.replaceWith(e.name);
+			});
+			return;
 		}
+		for (let [e] of V) e.remove();
+		V.clear(), H = [], U = t, K(e, C);
+	}, J = (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", J), x.push(() => {
+		C.removeEventListener("vf-menu-select", J);
+		for (let [e] of V) e.remove();
+		V.clear();
+	}), j && x.push(j.subscribe(q)), 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 Y = /* @__PURE__ */ new WeakSet(), X = () => {
+		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 ? (Y.add(e), e.heading !== r.name && (e.heading = r.name)) : Y.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(X), E.onWindows(X)), 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.18.0";
+export declare const VERSION = "0.19.1";

package/dist/shell/version.js

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