vintage-frames 0.19.0 → 0.20.0

package/editor/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "vintage-frames",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -1799,7 +1799,7 @@
         },
         {
           "name": "vf-menu-bar",
-          "description": "`<vf-menu-bar>` — the System 7 menu bar: white strip, 1px black bottom\nrule, slotted `<vf-menu>` children laid out from the left. `rounded` adds\nthe classic screen-corner mask to the top corners.\n\nCoordinates its menus: pressing a label opens that menu (and inverts the\nlabel); while any menu is open, hovering another label switches to it;\nEscape, an outside click, or item selection closes. ArrowLeft/ArrowRight\nmove between menus while one is open; ArrowDown/ArrowUp move focus through\nthe open menu's items, Home/End jump to its first/last, and typed letters\nrun the shared Finder first-letter type-ahead (src/type-ahead.ts).\n\nThe bar also owns the **press-drag-release** gesture (see src/menu-press.ts)\n— press a title, slide onto a command, release over it — because one press\nmay travel across several of its menus. `vf-select` drives its popup by the\nsame mechanic.\n---\n\n\n### **Slots:**\n - _default_ - `vf-menu` elements.\n- **end** - The bar's right end: a clock, say. Held 9px in from the end, and a `vf-label` there rides the bar's line, so its baseline is the menu titles'.\n\n### **CSS Properties:**\n - **--vf-menubar-height** - `vf-menu-bar` _(default: 20px)_\n\n### **CSS Parts:**\n - **bar** - The horizontal layout container.",
+          "description": "`<vf-menu-bar>` — the System 7 menu bar: white strip, 1px black bottom\nrule, slotted `<vf-menu>` children laid out from the left. `rounded` adds\nthe classic screen-corner mask to the top corners.\n\nCoordinates its menus: pressing a label opens that menu (and inverts the\nlabel); while any menu is open, hovering another label switches to it;\nEscape, an outside click, or item selection closes. While a menu is open\nthe keyboard is src/menu-navigation.ts's: ArrowDown/ArrowUp move focus\nthrough the open menu's items, Home/End jump to its first/last, typed\nletters run the shared Finder first-letter type-ahead (src/type-ahead.ts),\nArrowRight opens an item's submenu and ArrowLeft closes it, and at the top\nlevel ArrowLeft/ArrowRight move between menus.\n\nThe bar also owns the **press-drag-release** gesture (see src/menu-press.ts)\n— press a title, slide onto a command, release over it — because one press\nmay travel across several of its menus. `vf-select` drives its popup by the\nsame mechanic.\n---\n\n\n### **Slots:**\n - _default_ - `vf-menu` elements.\n- **end** - The bar's right end: a clock, say. Held 9px in from the end, and a `vf-label` there rides the bar's line, so its baseline is the menu titles'.\n\n### **CSS Properties:**\n - **--vf-menubar-height** - `vf-menu-bar` _(default: 20px)_\n\n### **CSS Parts:**\n - **bar** - The horizontal layout container.",
           "doc-url": "",
           "attributes": [
             {
@@ -1889,7 +1889,7 @@
         },
         {
           "name": "vf-menu-item",
-          "description": "`<vf-menu-item>` — a single command inside a `<vf-menu>` panel.\n\nRenders the classic System 7 menu row: optional ✓ check in the\n`--vf-select-gutter` left column (16px, shared with vf-select/vf-option),\nlabel, and the keyboard shortcut left-aligned in a right-anchored column,\nso every ⌘ lands at the same x. On activation the item performs the classic\n3-blink inversion (~250ms), then dispatches `vf-menu-select` and asks its\nancestors to close the menu.\n\nTakes `top`/`left` like every other element (VfPositioned), for the\nconsumer who wants a row somewhere other than a pulldown. Inside its parent\n`<vf-menu>` the panel is as wide as its widest row and stacks them in flow,\nso stating an origin takes that row out of both: it no longer contributes to\nthe panel's width and the rows below close the gap. The placement doing what\nit says — but not how a pulldown is laid out.\n---\n\n\n### **Events:**\n - **vf-menu-select** - After the blink completes. `detail: { value, item }`. Named for the menu rather than plain `vf-select`, which would collide with the `<vf-select>` popup on any delegated ancestor listener (that component commits with `vf-change`).\n\n### **Slots:**\n - _default_ - The item label.\n\n### **CSS Properties:**\n - **--vf-menu-row-height** - `vf-menu-item` row pitch (`Menus.png`; kept separate from `--vf-popup-height` so re-theming the popup pill doesn't move pulldown rows) _(default: 16px)_\n- **--vf-menu-shortcut-column** - `vf-menu-item` shortcut slot, right-anchored with the text left-aligned in it so every ⌘ lands at the same x (`Menus.png`) — the MDEF reserve, ⌘'s 11px advance + the face's widest letter (M/W, 12px); widen it to line up longer shortcuts (\"⌘⇧S\") _(default: 23px)_\n- **--vf-select-gutter** - checkmark column: `vf-select` left inset / `vf-option` + `vf-menu-item` ✓ column (shared so the value doesn't shift on open) _(default: 16px)_\n\n### **CSS Parts:**\n - **item** - The row container.\n- **check** - The ✓ checkmark glyph (rendered when `checked`).\n- **label** - The label wrapper around the default slot.\n- **shortcut** - The shortcut text, left-aligned in the shared column.",
+          "description": "`<vf-menu-item>` — a single command inside a `<vf-menu>` panel.\n\nRenders the classic System 7 menu row: optional ✓ check in the\n`--vf-select-gutter` left column (16px, shared with vf-select/vf-option),\nlabel, and the keyboard shortcut left-aligned in a right-anchored column,\nso every ⌘ lands at the same x. On activation the item performs the classic\n3-blink inversion (~250ms), then dispatches `vf-menu-select` and asks its\nancestors to close the menu.\n\nA `<vf-menu>` in the `submenu` slot makes the item open a submenu: it ends\nin ▶ where a shortcut would go, and choosing it opens the submenu beside\nit rather than firing `vf-menu-select`. The item stays highlighted while\nits submenu is open.\n\nTakes `top`/`left` like every other element (VfPositioned), for the\nconsumer who wants a row somewhere other than a pulldown. Inside its parent\n`<vf-menu>` the panel is as wide as its widest row and stacks them in flow,\nso stating an origin takes that row out of both: it no longer contributes to\nthe panel's width and the rows below close the gap. The placement doing what\nit says — but not how a pulldown is laid out.\n---\n\n\n### **Events:**\n - **vf-menu-select** - After the blink completes. `detail: { value, item }`. Named for the menu rather than plain `vf-select`, which would collide with the `<vf-select>` popup on any delegated ancestor listener (that component commits with `vf-change`).\n\n### **Slots:**\n - _default_ - The item label.\n- **submenu** - A `vf-menu`, the submenu the item opens.\n\n### **CSS Properties:**\n - **--vf-menu-row-height** - `vf-menu-item` row pitch (`Menus.png`; kept separate from `--vf-popup-height` so re-theming the popup pill doesn't move pulldown rows) _(default: 16px)_\n- **--vf-menu-shortcut-column** - `vf-menu-item` shortcut slot, right-anchored with the text left-aligned in it so every ⌘ lands at the same x (`Menus.png`) — the MDEF reserve, ⌘'s 11px advance + the face's widest letter (M/W, 12px); widen it to line up longer shortcuts (\"⌘⇧S\") _(default: 23px)_\n- **--vf-select-gutter** - checkmark column: `vf-select` left inset / `vf-option` + `vf-menu-item` ✓ column (shared so the value doesn't shift on open) _(default: 16px)_\n\n### **CSS Parts:**\n - **item** - The row container.\n- **check** - The ✓ checkmark glyph (rendered when `checked`).\n- **label** - The label wrapper around the default slot.\n- **shortcut** - The shortcut text, left-aligned in the shared column.\n- **arrow** - The ▶ of an item that opens a submenu.",
           "doc-url": "",
           "attributes": [
             {
@@ -1904,7 +1904,12 @@
             },
             {
               "name": "active",
-              "description": "Transient highlight — the full-row inversion the press-drag gesture paints\non the row under the pointer (`:hover` can't: under touch the pointer is\ncaptured by the title the press started on). Managed by the menu, mirroring\n`vf-option[active]`; not part of the authoring API.",
+              "description": "Transient highlight — the full-row inversion on the row under the pointer\nwhile its menu is open, button down or not (`:hover` can't: under touch\nthe pointer is captured by the title the press started on), or on the\nitem whose submenu is open while the pointer is elsewhere. Managed by the\nmenu, mirroring `vf-option[active]`; not part of the authoring API.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "expanded",
+              "description": "Whether this item's submenu is open. Reflected, and announced as\n`aria-expanded`. Managed by the menu (VfMenu.expand), like\nactive; not part of the authoring API.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
@@ -1919,7 +1924,7 @@
             },
             {
               "name": "value",
-              "description": "Value reported in the `vf-menu-select` event detail. Defaults to the item's\ntrimmed text content when unset.",
+              "description": "Value reported in the `vf-menu-select` event detail. Defaults to the item's\nlabelText when unset.",
               "value": { "type": "string | undefined" }
             },
             {
@@ -1943,7 +1948,13 @@
               "value": { "type": "PlacementOrigin | null | undefined" }
             }
           ],
-          "slots": [{ "name": "", "description": "The item label." }],
+          "slots": [
+            { "name": "", "description": "The item label." },
+            {
+              "name": "submenu",
+              "description": "A `vf-menu`, the submenu the item opens."
+            }
+          ],
           "events": [
             {
               "name": "vf-menu-select",
@@ -1964,7 +1975,12 @@
               },
               {
                 "name": "active",
-                "description": "Transient highlight — the full-row inversion the press-drag gesture paints\non the row under the pointer (`:hover` can't: under touch the pointer is\ncaptured by the title the press started on). Managed by the menu, mirroring\n`vf-option[active]`; not part of the authoring API.",
+                "description": "Transient highlight — the full-row inversion on the row under the pointer\nwhile its menu is open, button down or not (`:hover` can't: under touch\nthe pointer is captured by the title the press started on), or on the\nitem whose submenu is open while the pointer is elsewhere. Managed by the\nmenu, mirroring `vf-option[active]`; not part of the authoring API.",
+                "type": "boolean"
+              },
+              {
+                "name": "expanded",
+                "description": "Whether this item's submenu is open. Reflected, and announced as\n`aria-expanded`. Managed by the menu (VfMenu.expand), like\nactive; not part of the authoring API.",
                 "type": "boolean"
               },
               {
@@ -1979,9 +1995,19 @@
               },
               {
                 "name": "value",
-                "description": "Value reported in the `vf-menu-select` event detail. Defaults to the item's\ntrimmed text content when unset.",
+                "description": "Value reported in the `vf-menu-select` event detail. Defaults to the item's\nlabelText when unset.",
                 "type": "string | undefined"
               },
+              {
+                "name": "submenu",
+                "description": "The submenu this item opens: the `vf-menu` in its `submenu` slot, or null.",
+                "type": "VfMenu | null"
+              },
+              {
+                "name": "labelText",
+                "description": "The item's label as text: what its default slot holds, trimmed, without\nthe rows of a submenu. The default value and the menus'\ntype-ahead read it, and it names an item that opens a submenu.",
+                "type": "string"
+              },
               {
                 "name": "top",
                 "description": "Offset from the top of the positioning parent, in whole system px.\nSetting this (or `left`) absolutely positions the element within its\nparent; the coordinate left unset is 0. Remove both to return the\nelement to normal flow.",
@@ -2013,7 +2039,7 @@
         },
         {
           "name": "vf-menu",
-          "description": "`<vf-menu>` — a pull-down menu: a bar label plus a dropped panel of\n`<vf-menu-item>` / `<vf-separator>` children.\n\nInside a `<vf-menu-bar>` the bar coordinates open state (only one menu open,\nhover-switching, outside-click/Escape dismissal) and owns the pointer\ngesture, which may travel between its menus. Used standalone, the menu\ntoggles itself on label click and manages its own dismissal, its own press\ngesture and item keyboard navigation (ArrowUp/ArrowDown, Home/End, and the\nshared first-letter type-ahead — src/type-ahead.ts) while open.\n\nPointer — the two styles `vf-select` supports, on the same terms (see\nsrc/menu-press.ts): the System 7 press-drag-release (press the title, slide\nonto a command, release over it) and a modern quick tap that leaves the menu\ndropped for a second click.\n\nTakes `top`/`left` like every other element (VfPositioned) — the\nnatural fit being a standalone menu, which is a free-standing menu button and\nplaces like any other control. The panel is anchored to the host's own box\n(`top: 100%`), so it follows a placed menu down without any further work.\nInside a `<vf-menu-bar>`, the bar lays its titles out in flow — placing one\nlifts it off the bar and the titles beside it close the gap. Slotted straight\ninto a `<vf-desktop>`, a free-standing menu sits on the desktop's menu tier\nabove every window, palettes included, as a bar does.\n---\n\n\n### **Slots:**\n - _default_ - Menu contents: `vf-menu-item` and `vf-separator` elements.\n- **label** - Replaces the `label` text in the bar — e.g. a `vf-img` apple icon for the Apple menu. An icon (`vf-img`, `img`, `svg`, `picture` or `canvas`) is drawn in a 16×16 cell and placed for one: 6 system px into its plate, 6 short of the plate's end, on the plate's top row. Text keeps the text title's place. Keep the `label` attribute set too: it stays the menu's accessible name (the bar item's `aria-label` and the panel's) when the visible title is an image.\n\n### **CSS Properties:**\n - **--vf-menubar-height** - `vf-menu-bar` _(default: 20px)_\n- **--vf-menu-row-height** - `vf-menu-item` row pitch; the panel also spends one of these on every slotted `vf-separator`, the full row the MDEF gave a divider (rule 8px into it — see the panel CSS) _(default: 16px)_\n\n### **CSS Parts:**\n - **label** - The menu title in the bar (inverts while open; flashes when a closed menu's item is activated by its key equivalent).\n- **panel** - The dropped `.vf-panel` containing the items.",
+          "description": "`<vf-menu>` — a pull-down menu: a bar label plus a dropped panel of\n`<vf-menu-item>` / `<vf-separator>` children.\n\nInside a `<vf-menu-bar>` the bar coordinates open state (only one menu open,\nhover-switching, outside-click/Escape dismissal) and owns the pointer\ngesture, which may travel between its menus. Used standalone, the menu\ntoggles itself on label click and manages its own dismissal, its own press\ngesture and item keyboard navigation (ArrowUp/ArrowDown, Home/End, and the\nshared first-letter type-ahead — src/type-ahead.ts) while open.\n\nPointer — the two styles `vf-select` supports, on the same terms (see\nsrc/menu-press.ts): the System 7 press-drag-release (press the title, slide\nonto a command, release over it) and a modern quick tap that leaves the menu\ndropped for a second click.\n\nA `vf-menu` in a `vf-menu-item`'s `submenu` slot is a **submenu**: no title,\nonly its panel, opened beside its item by the menu holding the item\n(expand). The pointer resting on the item opens it in either style,\nand so do a click or tap on the item, →, Enter and Space. It overlaps its\nparent as System 7.5's did: its first row level with its item, its frame\n5px inside the parent's right edge, covering the parent's frame and\nshadow. It opens on the side its parent opened toward, the right first,\nflips where that side has no room, and moves up to fit the screen. Menus\nnest to any depth.\n\nTakes `top`/`left` like every other element (VfPositioned) — the\nnatural fit being a standalone menu, which is a free-standing menu button and\nplaces like any other control. The panel is anchored to the host's own box\n(`top: 100%`), so it follows a placed menu down without any further work.\nInside a `<vf-menu-bar>`, the bar lays its titles out in flow — placing one\nlifts it off the bar and the titles beside it close the gap. Slotted straight\ninto a `<vf-desktop>`, a free-standing menu sits on the desktop's menu tier\nabove every window, palettes included, as a bar does.\n---\n\n\n### **Slots:**\n - _default_ - Menu contents: `vf-menu-item` and `vf-separator` elements.\n- **label** - Replaces the `label` text in the bar — e.g. a `vf-img` apple icon for the Apple menu. An icon (`vf-img`, `img`, `svg`, `picture` or `canvas`) is drawn in a 16×16 cell and placed for one: 6 system px into its plate, 6 short of the plate's end, on the plate's top row. Text keeps the text title's place. Keep the `label` attribute set too: it stays the menu's accessible name (the bar item's `aria-label` and the panel's) when the visible title is an image.\n\n### **CSS Properties:**\n - **--vf-menubar-height** - `vf-menu-bar` _(default: 20px)_\n- **--vf-menu-row-height** - `vf-menu-item` row pitch; the panel also spends one of these on every slotted `vf-separator`, the full row the MDEF gave a divider (rule 8px into it — see the panel CSS) _(default: 16px)_\n\n### **CSS Parts:**\n - **label** - The menu title in the bar (inverts while open; flashes when a closed menu's item is activated by its key equivalent).\n- **panel** - The dropped `.vf-panel` containing the items.",
           "doc-url": "",
           "attributes": [
             {
@@ -2100,6 +2126,16 @@
                 "description": "Viewport rect of the bar title, or `null` before the first render. The\npress gesture hit-tests by coordinates rather than by event target (see\nsrc/menu-press.ts), so it wants the box, not the element.",
                 "type": "DOMRect | null"
               },
+              {
+                "name": "panelRect",
+                "description": "Viewport rect of the dropped panel, or `null` while closed. The press\ngesture hit-tests the open menus by their panels, deepest first.",
+                "type": "DOMRect | null"
+              },
+              {
+                "name": "expandedItem",
+                "description": "The item in this menu whose submenu is open, or `null`.",
+                "type": "VfMenuItem | null"
+              },
               {
                 "name": "top",
                 "description": "Offset from the top of the positioning parent, in whole system px.\nSetting this (or `left`) absolutely positions the element within its\nparent; the coordinate left unset is 0. Remove both to return the\nelement to normal flow.",
@@ -2181,7 +2217,7 @@
             },
             {
               "name": "autoselect",
-              "description": "Opens with the whole text selected, so typing replaces it. Implies\n`autofocus`: the first control carrying either takes the opening focus of\nits `vf-dialog`, or of a window the shell's window manager opens. A dialog\nselects the text on every open, a window on its first open only. A click\nstill places the caret.",
+              "description": "Opens with the whole text selected, so typing replaces it. Implies\n`autofocus`: the first control carrying either takes the opening focus of\nits `vf-dialog`, or of a window system-online-sdk's window manager opens.\nA dialog selects the text on every open, a window on its first open only.\nA click still places the caret.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
@@ -2282,7 +2318,7 @@
               },
               {
                 "name": "autoselect",
-                "description": "Opens with the whole text selected, so typing replaces it. Implies\n`autofocus`: the first control carrying either takes the opening focus of\nits `vf-dialog`, or of a window the shell's window manager opens. A dialog\nselects the text on every open, a window on its first open only. A click\nstill places the caret.",
+                "description": "Opens with the whole text selected, so typing replaces it. Implies\n`autofocus`: the first control carrying either takes the opening focus of\nits `vf-dialog`, or of a window system-online-sdk's window manager opens.\nA dialog selects the text on every open, a window on its first open only.\nA click still places the caret.",
                 "type": "boolean"
               },
               {
@@ -3754,7 +3790,7 @@
             },
             {
               "name": "autoselect",
-              "description": "Opens with the whole text selected, so typing replaces it. Implies\n`autofocus`: the first control carrying either takes the opening focus of\nits `vf-dialog`, or of a window the shell's window manager opens. A dialog\nselects the text on every open, a window on its first open only. A click\nstill places the caret.",
+              "description": "Opens with the whole text selected, so typing replaces it. Implies\n`autofocus`: the first control carrying either takes the opening focus of\nits `vf-dialog`, or of a window system-online-sdk's window manager opens.\nA dialog selects the text on every open, a window on its first open only.\nA click still places the caret.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
@@ -3845,7 +3881,7 @@
               },
               {
                 "name": "autoselect",
-                "description": "Opens with the whole text selected, so typing replaces it. Implies\n`autofocus`: the first control carrying either takes the opening focus of\nits `vf-dialog`, or of a window the shell's window manager opens. A dialog\nselects the text on every open, a window on its first open only. A click\nstill places the caret.",
+                "description": "Opens with the whole text selected, so typing replaces it. Implies\n`autofocus`: the first control carrying either takes the opening focus of\nits `vf-dialog`, or of a window system-online-sdk's window manager opens.\nA dialog selects the text on every open, a window on its first open only.\nA click still places the caret.",
                 "type": "boolean"
               },
               {
@@ -3961,7 +3997,7 @@
             },
             {
               "name": "autoselect",
-              "description": "Opens with the whole text selected, so typing replaces it. Implies\n`autofocus`: the first control carrying either takes the opening focus of\nits `vf-dialog`, or of a window the shell's window manager opens. A dialog\nselects the text on every open, a window on its first open only. A click\nstill places the caret.",
+              "description": "Opens with the whole text selected, so typing replaces it. Implies\n`autofocus`: the first control carrying either takes the opening focus of\nits `vf-dialog`, or of a window system-online-sdk's window manager opens.\nA dialog selects the text on every open, a window on its first open only.\nA click still places the caret.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
@@ -4052,7 +4088,7 @@
               },
               {
                 "name": "autoselect",
-                "description": "Opens with the whole text selected, so typing replaces it. Implies\n`autofocus`: the first control carrying either takes the opening focus of\nits `vf-dialog`, or of a window the shell's window manager opens. A dialog\nselects the text on every open, a window on its first open only. A click\nstill places the caret.",
+                "description": "Opens with the whole text selected, so typing replaces it. Implies\n`autofocus`: the first control carrying either takes the opening focus of\nits `vf-dialog`, or of a window system-online-sdk's window manager opens.\nA dialog selects the text on every open, a window on its first open only.\nA click still places the caret.",
                 "type": "boolean"
               },
               {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vintage-frames",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "Lit web components that emulate the look and feel of classic Mac OS System 7",
   "type": "module",
   "license": "MIT",
@@ -38,21 +38,6 @@
       "types": "./dist/components/vf-*.d.ts",
       "import": "./dist/components/vf-*.js"
     },
-    "./shell": {
-      "types": "./dist/shell/index.d.ts",
-      "import": "./dist/shell/index.js"
-    },
-    "./shell/pure": {
-      "types": "./dist/shell/pure.d.ts",
-      "import": "./dist/shell/pure.js"
-    },
-    "./build": {
-      "types": "./dist/build/index.d.ts",
-      "import": "./dist/build/index.js"
-    },
-    "./build/client": {
-      "types": "./dist/build/client.d.ts"
-    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -76,15 +61,12 @@
     "build:pages": "vite build --config vite.pages.config.ts",
     "preview:pages": "vite preview --config vite.pages.config.ts",
     "prepack": "npm run build && npm run verify:manifest",
-    "preversion": "npm run check:app-api",
-    "version": "npm run analyze && node scripts/write-version.mjs && git add custom-elements.json editor app-api.json src/shell/version.ts",
-    "analyze": "cem analyze && node scripts/app-api.mjs",
-    "check:app-api": "npm run analyze && node scripts/check-app-api.mjs",
+    "version": "npm run analyze && git add custom-elements.json editor",
+    "analyze": "cem analyze",
     "verify:manifest": "node scripts/verify-manifest.mjs",
     "typecheck": "tsc --noEmit",
     "preview": "vite preview",
     "embed:cursors": "node scripts/embed-cursor-art.mjs",
-    "embed:frame": "node scripts/embed-frame.mjs",
     "verify:buttons": "tsc src/pixel-frame.ts --outDir scripts/.tmp --target es2022 --module esnext --moduleResolution bundler --skipLibCheck && node scripts/emit-clips.mjs && python3 scripts/verify-button-clips.py",
     "shot:buttons": "npx playwright screenshot --wait-for-timeout=2000 http://localhost:5173/pixel-test.html shots/buttons.png",
     "shot:verify": "python3 scripts/verify-button-screenshot.py shots/buttons.png",
@@ -128,23 +110,11 @@
     "verify:snap": "node scripts/verify-snap.mjs",
     "verify:contract": "node scripts/verify-contract.mjs",
     "verify:names": "node scripts/verify-names.mjs",
-    "verify:forced-colors": "node scripts/verify-forced-colors.mjs",
-    "verify:shell-unit": "tsc -p tsconfig.unit.json && node --test --test-reporter=tap \"test/*.test.mjs\"",
-    "verify:shell-front": "node scripts/verify-shell-front.mjs",
-    "verify:shell-windows": "node scripts/verify-shell-windows.mjs",
-    "verify:shell-finder": "node scripts/verify-shell-finder.mjs"
+    "verify:forced-colors": "node scripts/verify-forced-colors.mjs"
   },
   "dependencies": {
     "lit": "^3.2.0"
   },
-  "peerDependencies": {
-    "vite": ">=8.0.0"
-  },
-  "peerDependenciesMeta": {
-    "vite": {
-      "optional": true
-    }
-  },
   "devDependencies": {
     "@custom-elements-manifest/analyzer": "^0.11.0",
     "@types/node": "^24.19.1",

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

@@ -1,21 +0,0 @@
-/**
- * Writing app files. The box's own chunks are copied as they are, so the
- * picture is never re-encoded; any app chunks already there are dropped,
- * and the manifest's and the code's go in before IEND.
- */
-import type { AppManifest } from '../shell/app-file.js';
-/** What {@link packApp} packs. */
-export interface PackAppInput {
-    /** 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. */
-    code: string;
-    /** The artwork's PNG, for the box. Without it the icon is stamped there. */
-    artwork?: Uint8Array;
-}
-/** `box` with `manifest` and `code` in its chunks. */
-export declare function writeAppFile(box: Uint8Array, manifest: AppManifest, code: string): Promise<Uint8Array>;
-/** The whole app file: the box in the kit's frame, then the manifest and the code. */
-export declare function packApp({ manifest, icon, code, artwork }: PackAppInput): Promise<Uint8Array>;

package/dist/build/app-file.js

@@ -1,42 +0,0 @@
-import { CODE_KEYWORD as e, MANIFEST_KEYWORD as t, PNG_SIGNATURE as n, deflate as r, itxtKeyword as i, manifestOf as a, pngChunks as o } from "../shell/app-file.js";
-import { concat as s, pngChunk as c } from "./png.js";
-import { composeBox as l } from "./box.js";
-//#region src/build/app-file.ts
-var u = new TextEncoder();
-function d(e, t, n) {
-	let r = Uint8Array.from([...e].map((e) => e.charCodeAt(0)));
-	return c("iTXt", s([
-		r,
-		Uint8Array.of(0, +!!n, 0, 0, 0),
-		t
-	]));
-}
-async function f(c, l, f) {
-	let p = o(c);
-	if (!p) throw Error("vintage-frames/build: the box is not a whole PNG");
-	let m = a(l);
-	if (typeof m == "string") throw Error(`vintage-frames/build: the manifest won't read back: ${m}`);
-	let h = [d(t, u.encode(JSON.stringify(m)), !1), d(e, await r(u.encode(f)), !0)], g = [n];
-	for (let e of p) e.type === "iTXt" && ["vintage-frames.app", "vintage-frames.code"].includes(i(e.data)) || (e.type === "IEND" && g.push(...h), g.push(c.subarray(e.start, e.end)));
-	return s(g);
-}
-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({
-		manifest: i,
-		icon: t,
-		artwork: r
-	}), i, n);
-}
-function m(e) {
-	let t = "";
-	for (let n = 0; n < e.length; n += 32768) t += String.fromCharCode(...e.subarray(n, n + 32768));
-	return btoa(t);
-}
-//#endregion
-export { p as packApp, f as writeAppFile };

package/dist/build/box.d.ts

@@ -1,57 +0,0 @@
-/**
- * The box: the picture an app file shows. The kit's frame, with the
- * application's artwork in the artwork slot, or its icon stamped large on
- * the slot's backdrop when there is none, and lines of text set from the
- * kit's strikes with the manifest's fields in them. Artwork and the stamp
- * are pasted by their alpha. Nothing is drawn outside the slots.
- */
-import type { AppManifest } from '../shell/app-file.js';
-import type { Strike } from '../styles/strike.js';
-import type { Pixels } from './png.js';
-/** A box in a frame's picture, in its px. */
-export interface Slot {
-    left: number;
-    top: number;
-    width: number;
-    height: number;
-}
-/** A frame: a picture with everything fixed drawn in, and its slots. */
-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;
-    };
-    /** The lines of text. */
-    text: readonly TextSlot[];
-}
-/** A line of text on the box. */
-export interface TextSlot {
-    /** The top-left of its em box, and the width it fits in. */
-    left: number;
-    top: number;
-    width: number;
-    strike: Strike;
-    /** Picture px per design px. */
-    scale: number;
-    /** `#rrggbb`. */
-    ink: string;
-    align?: 'left' | 'center' | 'right';
-    /** The line, with manifest fields in braces: `{name}`, `Version {version}`, `by {author}`, or fixed text. */
-    text: string;
-}
-/** What a box is composed from. */
-export interface BoxInput {
-    manifest: AppManifest;
-    /** The icon's PNG, 32 × 32. */
-    icon: Uint8Array;
-    /** 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. */
-export declare function composeBox(input: BoxInput): Promise<Uint8Array>;
-/** The box in `frame`, as pixels. */
-export declare function drawBox(frame: BoxFrame, { manifest, icon, artwork }: BoxInput): Promise<Pixels>;

package/dist/build/box.js

@@ -1,93 +0,0 @@
-import { FRAME as e } from "./frame.js";
-import { decodePng as t, encodePng as n } from "./png.js";
-//#region src/build/box.ts
-var r = [
-	"id",
-	"name",
-	"version",
-	"requires",
-	"author"
-];
-async function i(t) {
-	return n(await a(e, t));
-}
-async function a(e, { manifest: n, icon: r, artwork: i }) {
-	let a = await t(e.picture, "the frame"), c = await t(r, "the icon");
-	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 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);
-	}
-	for (let t of e.text) p(a, t, l(t.text, n));
-	return a;
-}
-function o({ width: e, height: t }) {
-	let n = [];
-	for (let r = 2; r <= e && n.length < 3; r++) e % r === 0 && t % r === 0 && n.push(`${e / r} × ${t / r}`);
-	return [...n, "…"].join(", ");
-}
-function s(e, t, n, r, i, a) {
-	let o = Math.max(n, a.left, 0), s = Math.max(r, a.top, 0), l = Math.min(n + t.width * i, a.left + a.width, e.width), u = Math.min(r + t.height * i, a.top + a.height, e.height);
-	for (let a = s; a < u; a++) for (let s = o; s < l; s++) {
-		let o = (Math.floor((a - r) / i) * t.width + Math.floor((s - n) / i)) * 4;
-		c(e, s, a, t.data.subarray(o, o + 4));
-	}
-}
-function c(e, t, n, [r, i, a, o]) {
-	if (!o) return;
-	let s = e.data, c = (n * e.width + t) * 4;
-	if (o === 255) {
-		s[c] = r, s[c + 1] = i, s[c + 2] = a, s[c + 3] = 255;
-		return;
-	}
-	let l = s[c + 3] * (255 - o) / 255, u = o + l;
-	s[c] = Math.round((r * o + s[c] * l) / u), s[c + 1] = Math.round((i * o + s[c + 1] * l) / u), s[c + 2] = Math.round((a * o + s[c + 2] * l) / u), s[c + 3] = Math.round(u);
-}
-function l(e, t) {
-	return e.replace(/\{(\w+)\}/g, (n, i) => {
-		let a = r.find((e) => e === i);
-		if (!a) throw Error(`the frame's line "${e}" names {${i}}, which a manifest doesn't have`);
-		return t[a];
-	});
-}
-var u = (e) => `"${e}" (U+${e.codePointAt(0).toString(16).toUpperCase().padStart(4, "0")})`, d = (e, t) => [...t].reduce((t, n) => t + e.glyphs[n].advance, 0);
-function f(e, t, n) {
-	if (d(e, t) <= n) return t;
-	if (!e.glyphs["…"]) throw Error(`${e.family} has no ${u("…")} to shorten "${t}" with`);
-	let r = [...t];
-	for (; r.length && d(e, r.join("").trimEnd() + "…") > n;) r.pop();
-	return r.join("").trimEnd() + "…";
-}
-function p(e, t, n) {
-	let { strike: r, scale: i } = t;
-	for (let e of n) if (!r.glyphs[e]) throw Error(`${r.family} has no ${u(e)}, in "${n}"`);
-	let a = /^#([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})$/i.exec(t.ink);
-	if (!a) throw Error(`the frame's ink "${t.ink}" is not #rrggbb`);
-	let o = Uint8Array.of(parseInt(a[1], 16), parseInt(a[2], 16), parseInt(a[3], 16), 255), s = f(r, n, t.width / i), l = d(r, s) * i, p = t.align === "center" ? Math.floor((t.width - l) / 2 / i) * i : t.align === "right" ? t.width - l : 0, m = {
-		left: t.left,
-		top: t.top,
-		width: t.width,
-		height: (r.ascent + r.descent) * i
-	}, h = t.top + r.ascent * i, g = t.left + p;
-	for (let t of s) {
-		let n = r.glyphs[t];
-		n.rows.forEach((t, r) => {
-			let a = h - (n.y0 + n.height - r) * i;
-			for (let r = 0; r < t.length; r++) {
-				if (t[r] !== "#") continue;
-				let s = g + (n.x0 + r) * i;
-				for (let t = Math.max(a, m.top, 0); t < Math.min(a + i, m.top + m.height, e.height); t++) for (let n = Math.max(s, m.left, 0); n < Math.min(s + i, m.left + m.width, e.width); n++) c(e, n, t, o);
-			}
-		}), g += n.advance * i;
-	}
-}
-//#endregion
-export { i as composeBox, a as drawBox };

package/dist/build/client.d.ts

@@ -1,12 +0,0 @@
-/**
- * `vintage-frames/build/client`: the types of a `*.png?app` import, which
- * `appFiles()` serves. A site adds it to tsconfig's `types` beside
- * `vite/client`.
- */
-declare module '*.png?app' {
-    /** The application's factory: its definition, given the manifest's icon. */
-    const app: (...args: any[]) => import('../shell/index.js').AppDefinition<any>;
-    export default app;
-    /** The app file's manifest. */
-    export const manifest: import('../shell/pure.js').AppManifest;
-}

package/dist/build/frame-picture.d.ts

@@ -1,6 +0,0 @@
-/**
- * The kit's frame's picture: box/frame.png, 480 × 615, 3095 bytes.
- * GENERATED by `npm run embed:frame`: redraw box/frame.png and re-run rather
- * than editing this file. Its slots are src/build/frame.ts's.
- */
-export declare const FRAME_PNG: Uint8Array;

package/dist/build/frame-picture.js

@@ -1,4 +0,0 @@
-//#region src/build/frame-picture.ts
-var e = Uint8Array.from(atob("iVBORw0KGgoAAAANSUhEUgAAAeAAAAJnCAYAAABPiYBoAAAL3klEQVR42u3VwQkAIAwEwfRfW3rSBnwJBuFmYQpQAldVtQCAcT4BAAwwAKQNsCRJepcBliTJAEuSZIAlSZIBliTJAEuSJAMsSZIBliRJBliSJAMsSZIMsCRJBliSJAMsSZIMsCRJBliSJBlgSZIMsCRJMsCSJBlgSZJkgCVJMsCSJBlgAyxJkgGWJMkAS5IkAyxJkgGWJEkGWJIkAyxJkgywJEkGWJIkA2yAJUkywJIkGWBJkmSAJUkywJIkyQBLkmSAJUmSAZYkyQBLkmSADbAkSQZYkiQDLEmSDPDxAQCEM8AGGAADbIABMMAG+NEDuhuAQAbYAANggA0wAAbYABtgAAywAQbAABtgAwyAATbAABhgA2yAATDABhgAA2yADTAABtgAA2CADTAABtgAG2AADLABBsAAG2ADDIABNsAAGGADbIABMMAGGAADbIANMAAG2AADYIANMAAG2AAbYAAMsAEGwAAbYAMMgAE2wAAYYANsgAEwwAYYAANsgA0wAAbYAANggA0wAAbYABtgAAywAQbAABtgAwyAATbAABhgA2yAATDABhgAA2yADTAABtgAA2CADTAABtgAG2AADLABBsAAG2ADDIABNsAAGGADbIABMMAGGAADbIANMAAG2AADYIANsCMEMMAG2AADYIANMAAG2AAbYAAMsAEGwAAbYAMMgAE2wAAYYANsgAEwwAYYAANsgA0wgAE2wAYYAANsgAEwwAbYAANggA0wAAbYABtgAAywAQbAABtgAwyAATbAABhgA2yAAQywATbAABhgAwyAATbABhgAA2yAATDABtgAA2CADTAABtgAG2AADLABBsAAG2ADDGCADbABBsAAG2AADLABNsAAGGADDIABNsAGGAADbIABMMAG2AADYIANMAAG2AAbYAADbIANMAAG2AADYIANsAEGwAAbYAAMsAE2wAAYYAMMgAE2wAYYAANsgAEwwAbYAANggA0wAAbYAANggA2wAQbAABtgAAywATbAABhgAwyAATbABhgAA2yAATDABtgAA2CADTAABtgAA2CADbABBsAAG2AADLABNsAAGGADDIABNsAGGAADbIABMMAG2AADYIANMAAG2AADYIANsAEGwAAbYAAMsAE2wAAYYAMMgAE2wAYYAANsgAEwwAbYAANggA0wAAbYAANggA2wAQbAABtgAAywATbAABhgAwyAATbABhgAA2yAATDABtgAA2CADTAABtgAO0IAA2yADTAABtgAA2CADbABBsAAG2AADLABNsAAGGADDIABNsAGGAADbIABMMAG2BECGGADbIABMMAGGAADbIANMAAG2AADYIANsAEGwAAbYAAMsAE2wAAYYAMMgAE2wAYYwAAbYAMMgAE2wAAYYANsgAEwwAYYAANsgA0wAAbYAANggA2wAQbAABtgAAywATbAAAbYABtgAAywAQbAABtgAwyAATbAABhgA2yAATDABhgAA2yADTAABtgAA2CADbABBjDABtgAA2CADTAABtgAG2AADLABBsAAG2ADDIABNsAAGGADbIABMMAGGAADbIANMAAG2AADYIANMAAG2AAbYAAMsAEGwAAbYAMMgAE2wAAYYANsgAEwwAYYAANsgA0wAAbYAANggA0wAAbYABtgAAywAQbAABtgAwyAATbAABhgA2yAATDABhgAA2yADTAABtgAA2CADTAABtgAG2AADLABBsAAG2ADDIABNsAAGGADbIABMMAGGAADbIANMAAG2AADYIANMAAG2AAbYAAMsAEGwAAbYAMMgAE2wAAYYANsgAEwwAYYAANsgA0wAAbYAANggA0wAAbYABtgAAywAQbAABtgAwyAATbAABhgA2yAATDABhgAA2yADTAABtgAA2CADbAjBDDABtgAA2CADTAABtgAG2AADLABBsAAG2ADDIABNsAAGGADbIABMMAGGAADbIANMIABNsAGGAADbIABMMAG2AADYIANMAAG2AAbYAAMsAEGwAAbYAMMgAE2wAAYYANsgAEMsAE2wAAYYAMMgAE2wAYYAANsgAEwwAbYAANggA0wAAbYABtgAAywAQbAABtgAwxggA2wAQbAABtgAAywATbAABhgAwyAATbABhgAA2yAATDABtgAA2CADTAABtgAG2AADLABBsAAG2AADLABNsAAGGADDIABNsAGGAADbIABMMAG2AADYIANMAAG2AAbYAAMsAEGwAAbYAAMsAE2wAAYYAMMgAE2wAYYAANsgAEwwAbYAANggA0wAAbYABtgAAywAQbAABtgAAywATbAABhgAwyAATbABhgAA2yAATDABtgAA2CADTAABtgAG2AADLABBsAAG2AADLABNsAAGGADDIABNsAGGAADbIABMMAG2AADYIANMAAG2AAbYAAMsAEGwAAbYAAMsAE2wAAYYAMMgAE2wAYYAANsgAEwwAbYAANggA0wAAbYABtgAAywAQbAABtgRwhggA2wAQbAABtgAAywATbAABhgAwyAATbABhgAA2yAATDABtgAA2CADTAABtgAG2AAA2yADTAABtgAA2CADbABBsAAG2AADLABNsAAGGADDIABNsAGGAADbIABMMAG2AADGGADbIABMMAGGAADbIANMAAG2AADYIANsAEGwAAbYAAMsAE2wAAYYAMMgAE2wAYYwAAbYAMMgAE2wAAYYANsgAEwwAYYAANsgA0wAAbYAANggA2wAQbAABtgAAywATbAAAbYABtgAAywAQbAABtgAwyAATbAABhgA2yAATDABhgAA2yADTAABtgAA2CADbABBsAAG2AADLABBsAAG2ADDIABNsAAGGADbIABMMAGGAADbIANMAAG2AADYIANsAEGwAAbYAAMsAEGwAAbYAMMgAE2wAAYYANsgAEwwAYYAANsgA0wAAbYAANggA2wAQbAABtgAAywAQbAABtgAwyAATbAABhgA2yAATDABhgAA2yADTAABtgAA2CADbABBsAAG2AADLABBsAAG2ADDIABNsAAGGADbIABMMAGGAADbICvHwBAOANsgAEwwAYYAANsgCVJCs8AS5JkgCVJMsCSJMkAS5JkgCVJkgGWJMkAS5IkAyxJkgGWJEkGWJIkAyxJkgGWJEkGWJIkAyxJkgywJEkGWJIkGWBJkgywJEkywJIkGWBJkgywAZYkyQBLkmSAJUmSAZYkyQBLkiQDLEmSAZYkSQZYkiQDLEmSATbAkiQZYEmSDLAkSTLAkiQZYEmSZIAlSTLAkiTJAEuSZIAlSTLABliSJAMsSZIBliRJBliSJAMsSZIMsCRJBliSJBlgSZIMsCRJBtgAS5JkgCVJMsCSJMkAS5JkgCVJkgGWJMkAS5IkAyxJkgGWJMkAG2BJkgywJEkGWJIkGWBJkgywJEkywJIkGWBJkmSAJUkywJIkGWADLEmSAZYkyQBLkiQDLEmSAZYkSQZYkiQDLEmSDLAkSQZYkiQDbIAlSTLAkiQZYEmSZIAlSTLAkiTJAEuSZIAlSZIBliTJAEuSZIANsCRJBliSJAMsSZIMsCRJBliSJBlgSZIMsCRJMsCSJBlgSZJkgCVJMsCSJBlgSZJkgCVJMsCSJMkAS5JkgCVJkgGWJMkAS5IkAyxJkgGWJMkAG2BJkgywJEkGWJIkGWBJkgywJEkywJIkGWBJkmSAJUkywJIkGWADLEmSAZYkyQBLkiQDLEmSAZYkSQZYkiQDLEmSDLAkSQZYkiQDbIAlSTLAkiQZYEmSZIAlSTLAkiTJAEuSZIAlSZIBliTJAEuSZIANsCRJBliSJAMsSZIMsCRJBliSJBlgSZIMsCRJMsCSJBlgSZIMsAGWJMkAS5JkgCVJkgGWJMkAS5IkAyxJkgGWJEkGWJIkAyxJkgE2wJIkGWBJkgywJEkywJIkGWBJkmSAJUkywJIkyQBLkmSAJUkywAZYkiQDLEmSAZYkSQZYkiQDLEmSDLAkSQZYkiQZYEmSDLAkSQbYAEuSZIAlSTLAkiTJAEuSZIAlSZIBliTJAEuSJAMsSZIBliRJBliSpK8GGAAY4xMAwAADQIANOM+x56UXUawAAAAASUVORK5CYII="), (e) => e.charCodeAt(0));
-//#endregion
-export { e as FRAME_PNG };

package/dist/build/frame.d.ts

@@ -1,11 +0,0 @@
-/**
- * The kit's frame: the picture every app file's box is drawn on, and its
- * slots, in the picture's px. A placeholder: a white card on 160 × 205
- * system px drawn at 3×, the artwork's slot on a gray backdrop inside a
- * black rule, then the name, the version and the author, centered.
- *
- * The picture is box/frame.png (`npm run embed:frame`). A redrawn picture
- * moves its slots here.
- */
-import type { BoxFrame } from './box.js';
-export declare const FRAME: BoxFrame;

package/dist/build/frame.js

@@ -1,44 +0,0 @@
-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 = 3, i = {
-	left: 16 * r,
-	width: 128 * r,
-	scale: r,
-	ink: "#000000",
-	align: "center"
-}, a = {
-	picture: n,
-	scale: r,
-	artwork: {
-		left: 16 * r,
-		top: 16 * r,
-		width: 128 * r,
-		height: 128 * r,
-		stamp: 3 * r
-	},
-	text: [
-		{
-			...i,
-			top: 152 * r,
-			strike: t,
-			text: "{name}"
-		},
-		{
-			...i,
-			top: 170 * r,
-			strike: e,
-			text: "Version {version}"
-		},
-		{
-			...i,
-			top: 182 * r,
-			strike: e,
-			text: "by {author}"
-		}
-	]
-};
-//#endregion
-export { a as FRAME };

package/dist/build/index.d.ts

@@ -1,14 +0,0 @@
-/**
- * `vintage-frames/build` — app files, written: the Vite plugin that makes an
- * application's build write its app file, the one that builds app files
- * into a site, and the pieces under them: the packer, the writer and the box
- * in the kit's frame. Build-only: it runs under Node, and no page imports
- * it. Reading an app file is `vintage-frames/shell/pure`'s.
- * docs/APP-FILES.md is the guide.
- */
-export { appFile, appFiles } from './plugins.js';
-export type { AppFileOptions } from './plugins.js';
-export { packApp, writeAppFile } from './app-file.js';
-export type { PackAppInput } from './app-file.js';
-export { composeBox } from './box.js';
-export type { BoxInput } from './box.js';

package/dist/build/index.js

@@ -1,4 +0,0 @@
-import { composeBox as e } from "./box.js";
-import { packApp as t, writeAppFile as n } from "./app-file.js";
-import { appFile as r, appFiles as i } from "./plugins.js";
-export { r as appFile, i as appFiles, e as composeBox, t as packApp, n as writeAppFile };