vintage-frames 0.19.1 → 0.20.1

package/README.md

@@ -23,24 +23,7 @@ import 'vintage-frames/vf-checkbox.js'
 
 There is no need to import a stylesheet. The components carry their styles with them.
 
-## The shell
-
-`vintage-frames/shell` is an experimental second entry point that runs applications over one desktop: a window manager, a menu bar that shows the front application's menus, and a Finder with folders, aliases, filing, Clean Up and the Trash. A System Folder's contents set the Apple menu and what opens at startup.
-
-```ts
-import 'vintage-frames'
-import { createShell, finder, memoryStorage } from 'vintage-frames/shell'
-
-createShell(document.querySelector('vf-desktop'), {
-  apps: [finder({ storage: memoryStorage(), seed: 'markup', art })],
-  fit: 'viewport',
-})
-```
-
-See [docs/SHELL.md](https://github.com/aportilla/vintage-frames/blob/main/docs/SHELL.md). Its API may change in any minor release while it is experimental.
-
-An application on the shell can ship as one PNG, its app file. `vintage-frames/build` holds the Vite plugins that write app files and build them into a site; it runs in the build only. See [docs/APP-FILES.md](https://github.com/aportilla/vintage-frames/blob/main/docs/APP-FILES.md).
-
+To run applications over a desktop of these elements, with a window manager, a menu bar and a Finder, see [system-online-sdk](https://github.com/aportilla/system-online-sdk).
 
 ## Sizing
 

package/custom-elements.json

@@ -2563,7 +2563,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<vf-desktop>` — the full-bleed classic desktop container.\n\nRenders the desktop pattern — the classic 50% dither by default, or any of\nthe standard patterns by name (`pattern`, System 7's General Controls\nsetting) — and manages the stacking order and `active` state of slotted\n`vf-window` children: a `pointerdown` or\n`focusin` (keyboard focus) anywhere inside a window brings it to the front\nand makes it the single active window. A press on a title bar with ⌘ held\nraises nothing, so a background window is dragged where it stands in the\nstack. The windows' light-DOM order is kept\nin step with the stacking order (bottom-most first, synced in a task once\nany pointer gesture has ended), so tabbing walks the stack the way the eye\ndoes and Shift+Tab is its exact mirror.\n\nUtility windows (`vf-window[variant=\"utility\"]`) stack in a floating tier\nabove every document-tier window, restack only among themselves, and stand\noutside the single-active invariant entirely — clicking a palette neither\ndeactivates the active document window nor greys the palette, exactly as\nSystem 7's floating windoids behaved while their application was frontmost.\nA slotted `vf-menu-bar` (or a free-standing `vf-menu`) sits on a tier\nabove both, so its dropped menus cover palettes and document windows\nalike; only the screen-corner mask is in front of it.\n\n**Deactivation.** On a real System 7 machine clicking the desktop clicked\nthe *Finder* — the frontmost application's windows lost their stripes.\nclearActive is that gesture's handler: it clears `active` from\nthe whole document tier, and **zero active windows is a legal state**,\nheld until a press or keyboard focus re-enters a document window (or a\nnew one is slotted, which activates it — opening a window brings its\napplication forward). The desktop never takes this decision itself: its\nfurniture is slotted light DOM (an icon layer, say), so only the page\nknows which of its children — or which presses on the bare dither — mean\n\"the Finder\", and it routes those through `clearActive()`. Left alone,\nthe classic always-one-active behavior is unchanged. activeWindow\nreads the current holder, and every change of holder — including to and\nfrom none — fires `vf-activate`.\n\n**Hidden windows.** A window with `hidden` — closed by a page that hides\nits windows rather than removing them, through `vf-window.hide()` or the\nattribute itself — never holds the active state. One slotted hidden waits\nto be shown; `bringToFront()` on one gives it its place in the stack and\nactivates nothing; the holder hiding hands the state to the topmost shown\ndocument window, or to none. A window shown into a tier where none is\nactive, unless the tier was deliberately deactivated, takes it.\nstackingOrder lists the windows as they stand, bottom-most first.\n\n**The work area.** A slotted `vf-menu-bar` along the top takes its band\noff the screen: workArea is what is left, and the gestures on the\nscreen stay in it — a window dragged up stops with its title bar under the\nbar, where it can still be grabbed, and an icon dropped, nudged or walked\non the desktop lands below the bar. `window-top` deepens the area for\nwindows alone (windowArea), for a page with a strip of its own\nunder the bar. A gesture asks for the box it is clamped into with\n`vf-placement-bounds-request` (bubbles, non-composed), the drag surface's\nhandshake, and the desktop answers for the hosts placed on its screen.\n\nThe desktop is a raster with an explicit size, always: **`width` and\n`height`**, in system px, the way a WIND resource declared a window's —\nthe host box renders at the declared screen plus `2 × bezel` per axis, a\nwhole number of system pixels by construction (default 512×342, the\ncompact Mac's screen). Pure CSS sizing is not supported; the page sets\nthe numbers — directly, or via VfDesktop.fitWithin on\n`resize`/`onScaleChange` for a viewport-filling desktop — and positions\nthe sized box with its own stylesheet, keeping any sub-system-pixel\nslack on its side. `bezel` (system px) draws the black screen surround —\nthe CRT's unlit margin — around the screen, rounding its four corners\nwith the classic corner mask.\n\n**`pattern`** names the desktop pattern — `gray-50` (the dither) by\ndefault, any of the 38 standard patterns (docs/PATTERNS.md), or sixteen\nhex digits stating a custom 8×8 pattern, as on `vf-container`. It is\npainted as the screen's own background: black ink on an opaque white\npaper, a repeating tile drawn at the display's resolution, 1-bit at every\ndensity and zoom (src/pattern-fill.ts).\n\n**The drag surface.** The Finder dragged an icon as a dotted outline drawn\non the *screen*, clipped at its edge and phase-locked to its raster, so\nthe screen hosts the layer that outline draws on: a full-bleed child of\nthe screen, `pointer-events: none` (never a hit for the page's\n`elementsFromPoint`), whose children paint one tier above the menu bar\nand under the corner mask — the layer itself is deliberately no stacking\ncontext, since a blend inside one would composite against nothing. An\nicon reaches it without an import, the menu-handshake idiom: on a drag's\nfirst step it dispatches `vf-drag-surface-request` (bubbles, non-composed,\n`detail.surface` null), and the nearest desktop on its light-DOM path\nfills the detail with the layer. A window asks the same way and draws\nthere with the same pen: its zoom rects when it opens from a rect\n(`vf-window.show({ from })`), its outline under an `outline-drag`. Not the\ntop layer: stable Safari cannot\nblend an element there against the page (src/cursor.ts), and a second\nkit entry in the top layer would need a re-promotion handshake.\n\nCustom properties:\n- `--vf-desktop-pattern` — a consumer's own tile art in place of the\n  pattern (the kit's default is a 1-bit 50% checker, opaque\n  black-on-white on a 30-system-px tile). Set, it wins over `pattern` and\n  renders as a placed tile grid at that same 30-px geometry\n  (src/tile-grid.ts); a token swapped at runtime without touching the\n  component wants a `requestUpdate()`.\n- `--vf-desktop` — base color painted *under* the pattern (default\n  `#808080`). The pattern's paper is opaque, so this only becomes visible\n  when `--vf-desktop-pattern` is overridden with a tile that has\n  transparent cells (or with `none`).",
+          "description": "`<vf-desktop>` — the full-bleed classic desktop container.\n\nRenders the desktop pattern — the classic 50% dither by default, or any of\nthe standard patterns by name (`pattern`, System 7's General Controls\nsetting) — and manages the stacking order and `active` state of slotted\n`vf-window` children: a `pointerdown` or\n`focusin` (keyboard focus) anywhere inside a window brings it to the front\nand makes it the single active window. A press on a title bar with ⌘ held\nraises nothing, so a background window is dragged where it stands in the\nstack. The windows' light-DOM order is kept\nin step with the stacking order (bottom-most first, synced in a task once\nany pointer gesture has ended), so tabbing walks the stack the way the eye\ndoes and Shift+Tab is its exact mirror.\n\nUtility windows (`vf-window[variant=\"utility\"]`) stack in a floating tier\nabove every document-tier window, restack only among themselves, and stand\noutside the single-active invariant entirely — clicking a palette neither\ndeactivates the active document window nor greys the palette, exactly as\nSystem 7's floating windoids behaved while their application was frontmost.\nA slotted `vf-menu-bar` (or a free-standing `vf-menu`) sits on a tier\nabove both, so its dropped menus cover palettes and document windows\nalike; only the drag outline, the full-screen tier and the screen-corner\nmask are in front of it.\n\n**The full-screen tier.** fullScreenWindow puts one slotted window\nabove everything else the screen shows — both window tiers, the menu bar\nand its dropped menus, the drag outline and the rects — and under the\ncorner mask alone: the tier a window takes the whole screen on. The page\nsets it and clears it, and sizes, draws and activates the window itself\n(`vf-window`'s `frameless`, the screen's `width` and `height`,\nbringToFront); cleared, the window goes back to its tier where it\nstood.\n\n**Deactivation.** On a real System 7 machine clicking the desktop clicked\nthe *Finder* — the frontmost application's windows lost their stripes.\nclearActive is that gesture's handler: it clears `active` from\nthe whole document tier, and **zero active windows is a legal state**,\nheld until a press or keyboard focus re-enters a document window (or a\nnew one is slotted, which activates it — opening a window brings its\napplication forward). The desktop never takes this decision itself: its\nfurniture is slotted light DOM (an icon layer, say), so only the page\nknows which of its children — or which presses on the bare dither — mean\n\"the Finder\", and it routes those through `clearActive()`. Left alone,\nthe classic always-one-active behavior is unchanged. activeWindow\nreads the current holder, and every change of holder — including to and\nfrom none — fires `vf-activate`.\n\n**Hidden windows.** A window with `hidden` — closed by a page that hides\nits windows rather than removing them, through `vf-window.hide()` or the\nattribute itself — never holds the active state. One slotted hidden waits\nto be shown; `bringToFront()` on one gives it its place in the stack and\nactivates nothing; the holder hiding hands the state to the topmost shown\ndocument window, or to none. A window shown into a tier where none is\nactive, unless the tier was deliberately deactivated, takes it.\nstackingOrder lists the windows as they stand, bottom-most first.\n\n**The work area.** A slotted `vf-menu-bar` along the top takes its band\noff the screen: workArea is what is left, and the gestures on the\nscreen stay in it — a window dragged up stops with its title bar under the\nbar, where it can still be grabbed, and an icon dropped, nudged or walked\non the desktop lands below the bar. `window-top` deepens the area for\nwindows alone (windowArea), for a page with a strip of its own\nunder the bar. A gesture asks for the box it is clamped into with\n`vf-placement-bounds-request` (bubbles, non-composed), the drag surface's\nhandshake, and the desktop answers for the hosts placed on its screen.\n\nThe desktop is a raster with an explicit size, always: **`width` and\n`height`**, in system px, the way a WIND resource declared a window's —\nthe host box renders at the declared screen plus `2 × bezel` per axis, a\nwhole number of system pixels by construction (default 512×342, the\ncompact Mac's screen). Pure CSS sizing is not supported; the page sets\nthe numbers — directly, or via VfDesktop.fitWithin on\n`resize`/`onScaleChange` for a viewport-filling desktop — and positions\nthe sized box with its own stylesheet, keeping any sub-system-pixel\nslack on its side. `bezel` (system px) draws the black screen surround —\nthe CRT's unlit margin — around the screen, rounding its four corners\nwith the classic corner mask.\n\n**`pattern`** names the desktop pattern — `gray-50` (the dither) by\ndefault, any of the 38 standard patterns (docs/PATTERNS.md), or sixteen\nhex digits stating a custom 8×8 pattern, as on `vf-container`. It is\npainted as the screen's own background: black ink on an opaque white\npaper, a repeating tile drawn at the display's resolution, 1-bit at every\ndensity and zoom (src/pattern-fill.ts).\n\n**The drag surface.** The Finder dragged an icon as a dotted outline drawn\non the *screen*, clipped at its edge and phase-locked to its raster, so\nthe screen hosts the layer that outline draws on: a full-bleed child of\nthe screen, `pointer-events: none` (never a hit for the page's\n`elementsFromPoint`), whose children paint one tier above the menu bar\nand under the corner mask — the layer itself is deliberately no stacking\ncontext, since a blend inside one would composite against nothing. An\nicon reaches it without an import, the menu-handshake idiom: on a drag's\nfirst step it dispatches `vf-drag-surface-request` (bubbles, non-composed,\n`detail.surface` null), and the nearest desktop on its light-DOM path\nfills the detail with the layer. A window asks the same way and draws\nthere with the same pen: its zoom rects when it opens from a rect\n(`vf-window.show({ from })`), its outline under an `outline-drag`. Not the\ntop layer: stable Safari cannot\nblend an element there against the page (src/cursor.ts), and a second\nkit entry in the top layer would need a re-promotion handshake.\n\nCustom properties:\n- `--vf-desktop-pattern` — a consumer's own tile art in place of the\n  pattern (the kit's default is a 1-bit 50% checker, opaque\n  black-on-white on a 30-system-px tile). Set, it wins over `pattern` and\n  renders as a placed tile grid at that same 30-px geometry\n  (src/tile-grid.ts); a token swapped at runtime without touching the\n  component wants a `requestUpdate()`.\n- `--vf-desktop` — base color painted *under* the pattern (default\n  `#808080`). The pattern's paper is opaque, so this only becomes visible\n  when `--vf-desktop-pattern` is overridden with a tile that has\n  transparent cells (or with `none`).",
           "name": "VfDesktop",
           "cssProperties": [
             {
@@ -2933,7 +2933,7 @@
               "type": {
                 "text": "HTMLElement[]"
               },
-              "description": "The slotted windows in stacking order, bottom-most first: the document\ntier, then the floating tier above it, each in the order its windows\nwere last raised. Hidden windows are included where they stand. This is\nthe order the eye sees; the windows' light-DOM order catches up with it\nonly once a gesture ends, and a raise by keyboard focus moves no node.",
+              "description": "The slotted windows in stacking order, bottom-most first: the document\ntier, then the floating tier above it, each in the order its windows\nwere last raised, and the window on the full-screen tier last. Hidden\nwindows are included where they stand. This is the order the eye sees;\nthe windows' light-DOM order catches up with it only once a gesture\nends, a raise by keyboard focus moves no node, and the full-screen\nwindow keeps the light-DOM place of where it stood.",
               "readonly": true
             },
             {
@@ -2946,6 +2946,45 @@
               },
               "description": "Deactivate the whole document tier — clear `active` from every document\nwindow, leaving none the holder. Pages route \"the user clicked the\nFinder\" presses — on the bare dither, on their own desktop furniture\n(an icon layer) — through here; the deactivated state holds until a\ndocument window is pressed, focused, brought to front, or newly\nslotted."
             },
+            {
+              "kind": "field",
+              "name": "fullScreenWindow",
+              "type": {
+                "text": "HTMLElement | null"
+              },
+              "description": "The window on the full-screen tier, or null. A slotted window set here\nstacks above everything else the screen shows — both window tiers, the\nmenu bar and any dropped menu, the drag outline and the window rects —\nand under the corner mask alone, so the screen keeps its rounded\ncorners: the tier for a window that takes the whole screen. Sizing it to\nthe screen and drawing it without chrome (`vf-window`'s `frameless`) are\nthe page's, and so is bringing it forward: setting this activates\nnothing. One window holds the tier at a time: setting another puts the\nfirst back, and null puts the holder back in its own tier where it\nstood — a raise meanwhile moves that place, as it would have moved the\nwindow. A holder that leaves the desktop gives the tier up. Anything but\na window slotted here warns and changes nothing."
+            },
+            {
+              "kind": "field",
+              "name": "#screenHolder",
+              "privacy": "private",
+              "type": {
+                "text": "HTMLElement | null"
+              },
+              "default": "null",
+              "description": "The window on the full-screen tier, or null (see fullScreenWindow)."
+            },
+            {
+              "kind": "field",
+              "name": "#screenPlace",
+              "privacy": "private",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The holder's z-index in its own tier: the place it goes back to."
+            },
+            {
+              "kind": "method",
+              "name": "#leaveScreenTier",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "The holder back in its own tier, where it stood."
+            },
             {
               "kind": "method",
               "name": "_restack",
@@ -2963,7 +3002,7 @@
                   }
                 }
               ],
-              "description": "The z/active half of a raise, shared by every path. A hidden window\ntakes its place in the stack and nothing else: it activates when it is\nshown and raised."
+              "description": "The z/active half of a raise, shared by every path. A hidden window\ntakes its place in the stack and nothing else: it activates when it is\nshown and raised. The full-screen window stays on its tier, and the\nraise moves the place it goes back to."
             },
             {
               "kind": "method",
@@ -3182,7 +3221,7 @@
                   "text": "void"
                 }
               },
-              "description": "Re-order the slotted windows in the light DOM to match their z-order\n(bottom-most first), so sequential focus navigation walks the stack the\nway the eye does — and Shift+Tab is its exact mirror. The utility band\nsorts the floating tier after every document window by construction.\n\nMinimal-move: windows already in relative order are never touched (the\ncommon case — after one raise, one window moves). Non-window siblings\n(a menu bar, page content) keep their positions; only a window that must\ncross the stack moves past them. `moveBefore()` keeps the focus inside a\nmoved window where the browser has it (_move); re-inserting a\nnode containing the focused element drops focus to `<body>`, so it is\nrestored afterwards — behind `_restoringFocus`, because the restore\nre-fires focusin (see _onFocusIn) on an element that may sit in a\nbackground window.\nReached only through _requestDomSync's task — after a pointer\ngesture or a programmatic raise, never from a focus-driven one (see\n_raise for why)."
+              "description": "Re-order the slotted windows in the light DOM to match their z-order\n(bottom-most first), so sequential focus navigation walks the stack the\nway the eye does — and Shift+Tab is its exact mirror. The utility band\nsorts the floating tier after every document window by construction.\n\nMinimal-move: windows already in relative order are never touched (the\ncommon case — after one raise, one window moves). Non-window siblings\n(a menu bar, page content) keep their positions; only a window that must\ncross the stack moves past them. `moveBefore()` keeps the focus inside a\nmoved window where the browser has it (_move); re-inserting a\nnode containing the focused element drops focus to `<body>`, so it is\nrestored afterwards — behind `_restoringFocus`, because the restore\nre-fires focusin (see _onFocusIn) on an element that may sit in a\nbackground window. The full-screen window is ordered by the place it\ngoes back to, so taking and leaving the tier move no node.\nReached only through _requestDomSync's task — after a pointer\ngesture or a programmatic raise, never from a focus-driven one (see\n_raise for why)."
             },
             {
               "kind": "method",
@@ -10567,7 +10606,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "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.",
               "attribute": "autoselect",
               "reflects": true,
               "inheritedFrom": {
@@ -11581,7 +11620,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "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.",
               "fieldName": "autoselect",
               "inheritedFrom": {
                 "name": "VfTextControlBase",
@@ -18667,7 +18706,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "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.",
               "attribute": "autoselect",
               "reflects": true,
               "inheritedFrom": {
@@ -19695,7 +19734,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "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.",
               "fieldName": "autoselect",
               "inheritedFrom": {
                 "name": "VfTextControlBase",
@@ -19997,7 +20036,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "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.",
               "attribute": "autoselect",
               "reflects": true,
               "inheritedFrom": {
@@ -21032,7 +21071,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "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.",
               "fieldName": "autoselect",
               "inheritedFrom": {
                 "name": "VfTextControlBase",
@@ -21144,7 +21183,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<vf-window>` — the System 7 desktop-window shell.\n\nStriped title bar with optional close box (left) and zoom box (right), a\nsolid-white frame with a hard offset shadow, an optional grow box for\nresizing, optional edge scroll rails (`scrollbars`), and the slim windoid\nchrome (`variant=\"utility\"`). The HIG's window archetypes are parameter\nrecipes over this shell rather than fixed anatomies — the component enables\nHIG compliance, it doesn't enforce it (see docs/LAYOUT.md \"Window archetypes\"):\nthe full document window is `closable zoomable movable resizable\nscrollbars=\"both\"`, a modeless dialog box is `closable movable`, a utility\nwindow is `variant=\"utility\" closable movable`. Place inside `<vf-desktop>` to get\nclick-to-front stacking and automatic `active` management (utility windows\nfloat above the document tier).\n\nEvery recipe also declares `width` AND `height` (VfSized), in whole\nsystem px — the art's own unit, so the window keeps its proportions to the\nchrome inside it at every display density (a CSS-px size stays put while\nthe components in it triple). A window is a fixed box in both axes, the way\nthe WIND resource carried it: left to layout it takes whatever its\ncontainer or content hands it, which is how a title bar ends up wider than\nthe screen or a dialog reflows as it moves — and a window that grows with\nits body is one the user can neither predict nor (via the grow box) own.\nContent taller than the declared box is clipped at the frame the way the\nclassic content region was; `scrollbars` lets the user reach the rest.\nUnset, the window still renders — normal block layout, as before — and\nsays so once in the console.\n\n**Opening from a rect.** show clears `hidden`, and given `from` — a\nbox in viewport CSS px, an icon's `cellRect()` or a button's rect — opens\nthe window from it: dotted rectangles grow from that box toward the\nwindow's frame, four on screen at a time, bunched at the box and opening\nout toward the window, drawn with the icon drag outline's XOR pen on the\ndesktop's drag surface; the window draws once they have drained, eighteen\nsteps later. Until then it matches `:state(opening)` and paints nothing —\nstill laid out, focusable and a hit target, so a page can place it, raise\nit and focus into it at once, and a press finishes the rects and lands on\nthe window. Under `prefers-reduced-motion`, with no `vf-desktop` on its\npath, or without `from`, the window shows at once.\n\n**Closing to a rect.** hide sets `hidden`, and given `to` closes\nthe window to it: the same rectangles run the other way, from where the\nframe was in toward the box, the window gone from the first step. A press\nfinishes them, and removing the window leaves them running. Under\n`prefers-reduced-motion`, with no `vf-desktop` on its path, or without\n`to`, the window hides at once. The window knows nothing about icons:\n`from` and `to` are any rect.\n\n**Dragging as an outline.** A `movable` window moves live under the\npointer. With `outline-drag` a press on the title bar draws a dotted\noutline around the window on the desktop's drag surface instead, with the\nsame pen; the drag moves the outline, held where the window can land, and\nthe window moves there on the release. Escape cancels.",
+          "description": "`<vf-window>` — the System 7 desktop-window shell.\n\nStriped title bar with optional close box (left) and zoom box (right), a\nsolid-white frame with a hard offset shadow, an optional grow box for\nresizing, optional edge scroll rails (`scrollbars`), and the slim windoid\nchrome (`variant=\"utility\"`). The HIG's window archetypes are parameter\nrecipes over this shell rather than fixed anatomies — the component enables\nHIG compliance, it doesn't enforce it (see docs/LAYOUT.md \"Window archetypes\"):\nthe full document window is `closable zoomable movable resizable\nscrollbars=\"both\"`, a modeless dialog box is `closable movable`, a utility\nwindow is `variant=\"utility\" closable movable`. Place inside `<vf-desktop>` to get\nclick-to-front stacking and automatic `active` management (utility windows\nfloat above the document tier).\n\nEvery recipe also declares `width` AND `height` (VfSized), in whole\nsystem px — the art's own unit, so the window keeps its proportions to the\nchrome inside it at every display density (a CSS-px size stays put while\nthe components in it triple). A window is a fixed box in both axes, the way\nthe WIND resource carried it: left to layout it takes whatever its\ncontainer or content hands it, which is how a title bar ends up wider than\nthe screen or a dialog reflows as it moves — and a window that grows with\nits body is one the user can neither predict nor (via the grow box) own.\nContent taller than the declared box is clipped at the frame the way the\nclassic content region was; `scrollbars` lets the user reach the rest.\nUnset, the window still renders — normal block layout, as before — and\nsays so once in the console.\n\n**Opening from a rect.** show clears `hidden`, and given `from` — a\nbox in viewport CSS px, an icon's `cellRect()` or a button's rect — opens\nthe window from it: dotted rectangles grow from that box toward the\nwindow's frame, four on screen at a time, bunched at the box and opening\nout toward the window, drawn with the icon drag outline's XOR pen on the\ndesktop's drag surface; the window draws once they have drained, eighteen\nsteps later. Until then it matches `:state(opening)` and paints nothing —\nstill laid out, focusable and a hit target, so a page can place it, raise\nit and focus into it at once, and a press finishes the rects and lands on\nthe window. Under `prefers-reduced-motion`, with no `vf-desktop` on its\npath, or without `from`, the window shows at once.\n\n**Closing to a rect.** hide sets `hidden`, and given `to` closes\nthe window to it: the same rectangles run the other way, from where the\nframe was in toward the box, the window gone from the first step. A press\nfinishes them, and removing the window leaves them running. Under\n`prefers-reduced-motion`, with no `vf-desktop` on its path, or without\n`to`, the window hides at once. The window knows nothing about icons:\n`from` and `to` are any rect.\n\n**Dragging as an outline.** A `movable` window moves live under the\npointer. With `outline-drag` a press on the title bar draws a dotted\noutline around the window on the desktop's drag surface instead, with the\nsame pen; the drag moves the outline, held where the window can land, and\nthe window moves there on the release. Escape cancels.\n\n**Frameless.** With `frameless` the window draws no chrome — no title bar\nor widgets, no frame or shadow, no grow box, no header or status strip —\nand the body is the whole box: a window that takes the whole screen, say,\non `vf-desktop`'s full-screen tier. The chrome is hidden, not torn down, so\nthe switch moves no node and the focus in the body stays where it is.",
           "name": "VfWindow",
           "cssProperties": [
             {
@@ -21238,6 +21277,17 @@
               "attribute": "variant",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "frameless",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Draw no chrome: no title bar, so no close or zoom box, no frame or\nshadow, no grow box, and no header or status strip, whatever their slots\nhold. The body is the whole box, `pattern` filling it and a placed child\nmeasured from its corner; under `scrollbars` the built-in scroll area\nfills the box, its own frame line on the box's edge. `heading` still\nnames the window. The chrome is hidden rather than left out of the\nrender, so switching this on a connected window moves no node and the\nfocus in the body stays where it is. In a `vf-desktop` the window keeps\nits tier for activation and `hidden`, and `show()` and `hide()` run\ntheir rects from and to its box.",
+              "attribute": "frameless",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "heading",
@@ -22154,6 +22204,15 @@
               "description": "Chrome variant. Omit for the standard 18px striped bar; `'utility'` for\nthe slim windoid bar (dot-grid dither, 7×7 widgets, no title patch — the\nheading still names the widgets). Inside a `vf-desktop`, utility windows\nfloat above the document tier and never take the single-active state.",
               "fieldName": "variant"
             },
+            {
+              "name": "frameless",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Draw no chrome: no title bar, so no close or zoom box, no frame or\nshadow, no grow box, and no header or status strip, whatever their slots\nhold. The body is the whole box, `pattern` filling it and a placed child\nmeasured from its corner; under `scrollbars` the built-in scroll area\nfills the box, its own frame line on the box's edge. `heading` still\nnames the window. The chrome is hidden rather than left out of the\nrender, so switching this on a connected window moves no node and the\nfocus in the body stays where it is. In a `vf-desktop` the window keeps\nits tier for activation and `hidden`, and `show()` and `hide()` run\ntheir rects from and to its box.",
+              "fieldName": "frameless"
+            },
             {
               "name": "heading",
               "type": {
@@ -23375,7 +23434,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "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.",
               "attribute": "autoselect",
               "reflects": true
             },
@@ -24250,7 +24309,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "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.",
               "fieldName": "autoselect"
             },
             {

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

@@ -22,7 +22,17 @@ declare const VfDesktop_base: (new (...args: any[]) => import("../position.js").
  * System 7's floating windoids behaved while their application was frontmost.
  * A slotted `vf-menu-bar` (or a free-standing `vf-menu`) sits on a tier
  * above both, so its dropped menus cover palettes and document windows
- * alike; only the screen-corner mask is in front of it.
+ * alike; only the drag outline, the full-screen tier and the screen-corner
+ * mask are in front of it.
+ *
+ * **The full-screen tier.** {@link fullScreenWindow} puts one slotted window
+ * above everything else the screen shows — both window tiers, the menu bar
+ * and its dropped menus, the drag outline and the rects — and under the
+ * corner mask alone: the tier a window takes the whole screen on. The page
+ * sets it and clears it, and sizes, draws and activates the window itself
+ * (`vf-window`'s `frameless`, the screen's `width` and `height`,
+ * {@link bringToFront}); cleared, the window goes back to its tier where it
+ * stood.
  *
  * **Deactivation.** On a real System 7 machine clicking the desktop clicked
  * the *Finder* — the frontmost application's windows lost their stripes.
@@ -310,9 +320,11 @@ export declare class VfDesktop extends VfDesktop_base {
     /**
      * The slotted windows in stacking order, bottom-most first: the document
      * tier, then the floating tier above it, each in the order its windows
-     * were last raised. Hidden windows are included where they stand. This is
-     * the order the eye sees; the windows' light-DOM order catches up with it
-     * only once a gesture ends, and a raise by keyboard focus moves no node.
+     * were last raised, and the window on the full-screen tier last. Hidden
+     * windows are included where they stand. This is the order the eye sees;
+     * the windows' light-DOM order catches up with it only once a gesture
+     * ends, a raise by keyboard focus moves no node, and the full-screen
+     * window keeps the light-DOM place of where it stood.
      */
     get stackingOrder(): HTMLElement[];
     /**
@@ -324,10 +336,27 @@ export declare class VfDesktop extends VfDesktop_base {
      * slotted.
      */
     clearActive(): void;
+    /**
+     * The window on the full-screen tier, or null. A slotted window set here
+     * stacks above everything else the screen shows — both window tiers, the
+     * menu bar and any dropped menu, the drag outline and the window rects —
+     * and under the corner mask alone, so the screen keeps its rounded
+     * corners: the tier for a window that takes the whole screen. Sizing it to
+     * the screen and drawing it without chrome (`vf-window`'s `frameless`) are
+     * the page's, and so is bringing it forward: setting this activates
+     * nothing. One window holds the tier at a time: setting another puts the
+     * first back, and null puts the holder back in its own tier where it
+     * stood — a raise meanwhile moves that place, as it would have moved the
+     * window. A holder that leaves the desktop gives the tier up. Anything but
+     * a window slotted here warns and changes nothing.
+     */
+    get fullScreenWindow(): HTMLElement | null;
+    set fullScreenWindow(win: HTMLElement | null);
     /**
      * The z/active half of a raise, shared by every path. A hidden window
      * takes its place in the stack and nothing else: it activates when it is
-     * shown and raised.
+     * shown and raised. The full-screen window stays on its tier, and the
+     * raise moves the place it goes back to.
      */
     private _restack;
     /**
@@ -466,7 +495,8 @@ export declare class VfDesktop extends VfDesktop_base {
      * node containing the focused element drops focus to `<body>`, so it is
      * restored afterwards — behind `_restoringFocus`, because the restore
      * re-fires focusin (see {@link _onFocusIn}) on an element that may sit in a
-     * background window.
+     * background window. The full-screen window is ordered by the place it
+     * goes back to, so taking and leaving the tier move no node.
      * Reached only through {@link _requestDomSync}'s task — after a pointer
      * gesture or a programmatic raise, never from a focus-driven one (see
      * {@link _raise} for why).

package/dist/components/vf-desktop.js

@@ -14,9 +14,9 @@ import { SCREEN_CORNER as C, steppedCornerClip as w } from "../pixel-frame.js";
 import { LitElement as T, css as E, html as D, unsafeCSS as O } from "lit";
 import { property as k, query as A, queryAssignedElements as j } from "lit/decorators.js";
 //#region src/components/vf-desktop.ts
-var M = 1e6, N = 2 * M, P = 2000001, F = 512, I = 342, L = "gray-50", R = v(g[L], "#000000", "#ffffff"), z = u(R.width, R.height, d(R.rects)), B = f(R.width), V = (e) => Number(e.style.zIndex) || 0, H = (e) => e.composedPath().some((e) => e instanceof Element && e.classList.contains("vf-title-bar")), U = class extends s(T) {
+var M = 1e6, N = 2 * M, P = 2000001, F = 3e6, I = 512, L = 342, R = "gray-50", z = v(g[R], "#000000", "#ffffff"), B = u(z.width, z.height, d(z.rects)), V = f(z.width), H = (e) => Number(e.style.zIndex) || 0, U = (e) => e.composedPath().some((e) => e instanceof Element && e.classList.contains("vf-title-bar")), W = class extends s(T) {
 	constructor(...e) {
-		super(...e), this.width = F, this.height = I, this.bezel = 0, this.pattern = L, this.scale = new n(this), this.gridSnap = new x(this), this._token = "", this._desktopPattern = g[L], this.#e = !1, this.patternFill = new y(this, {
+		super(...e), this.width = I, this.height = L, this.bezel = 0, this.pattern = R, this.scale = new n(this), this.gridSnap = new x(this), this._token = "", this._desktopPattern = g[R], this.#e = !1, this.patternFill = new y(this, {
 			getBox: () => this.screen,
 			getPattern: () => this._token ? null : this._desktopPattern
 		}), this._zCounter = 0, this._activeWindow = null, this._deactivated = !1, this._awaitingUpgrade = !1, this.#t = new MutationObserver(() => this._resolveActive()), this._pointerGesture = !1, this._restoringFocus = !1, this._domSyncTimer = 0, this._gestureEnd = new S(this, () => [[
@@ -29,10 +29,10 @@ var M = 1e6, N = 2 * M, P = 2000001, F = 512, I = 342, L = "gray-50", R = v(g[L]
 			"pointercancel",
 			this._onGestureEnd,
 			!0
-		]]), this._onPointerDown = (e) => {
+		]]), this.#n = null, this.#r = "", this._onPointerDown = (e) => {
 			this._pointerGesture || (this._pointerGesture = !0, this._gestureEnd.attach());
 			let t = this._windowFromEvent(e);
-			t && e.metaKey && H(e) || t && this._raise(t);
+			t && e.metaKey && U(e) || t && this._raise(t);
 		}, this._onGestureEnd = () => {
 			this._gestureEnd.detach(), this._pointerGesture = !1, this._requestDomSync();
 		}, this._onDragSurfaceRequest = (e) => {
@@ -119,7 +119,7 @@ var M = 1e6, N = 2 * M, P = 2000001, F = 512, I = 342, L = "gray-50", R = v(g[L]
         position: absolute;
         inset: 0;
         z-index: -1;
-        --_vf-tile-image: var(--vf-desktop-pattern, ${O(z)});
+        --_vf-tile-image: var(--vf-desktop-pattern, ${O(B)});
         /* Forced colors: hidden with the pattern, same posture. */
         @media (forced-colors: active) {
           display: none;
@@ -208,7 +208,7 @@ var M = 1e6, N = 2 * M, P = 2000001, F = 512, I = 342, L = "gray-50", R = v(g[L]
 		];
 	}
 	get workArea() {
-		let e = this.width ?? F, t = this.height ?? I, n = Math.min(t, this._menuBarFloor());
+		let e = this.width ?? I, t = this.height ?? L, n = Math.min(t, this._menuBarFloor());
 		return {
 			left: 0,
 			top: n,
@@ -252,14 +252,32 @@ var M = 1e6, N = 2 * M, P = 2000001, F = 512, I = 342, L = "gray-50", R = v(g[L]
 		return this._activeWindow;
 	}
 	get stackingOrder() {
-		return [...this._windows].sort((e, t) => V(e) - V(t));
+		return [...this._windows].sort((e, t) => H(e) - H(t));
 	}
 	clearActive() {
 		this._deactivated = !0, this._setActive(null);
 	}
+	get fullScreenWindow() {
+		return this.#n;
+	}
+	set fullScreenWindow(e) {
+		if (e !== this.#n) {
+			if (e && !this._windows.includes(e)) {
+				console.warn("vf-desktop: fullScreenWindow takes a window slotted in this desktop, or null.", e);
+				return;
+			}
+			this.#i(), e && (this.#n = e, this.#r = e.style.zIndex, e.style.zIndex = String(F));
+		}
+	}
+	#n;
+	#r;
+	#i() {
+		let e = this.#n;
+		e && (this.#n = null, e.style.zIndex = this.#r);
+	}
 	_restack(e) {
-		let t = this._isUtility(e);
-		e.style.zIndex = String(++this._zCounter + (t ? M : 0)), !t && !e.hidden && this._setActive(e);
+		let t = this._isUtility(e), n = String(++this._zCounter + (t ? M : 0));
+		e === this.#n ? this.#r = n : e.style.zIndex = n, !t && !e.hidden && this._setActive(e);
 	}
 	_requestDomSync() {
 		this._pointerGesture || this._domSyncTimer || (this._domSyncTimer = window.setTimeout(() => {
@@ -286,7 +304,7 @@ var M = 1e6, N = 2 * M, P = 2000001, F = 512, I = 342, L = "gray-50", R = v(g[L]
 	}
 	_onSlotChange() {
 		let e = this._windows;
-		this._observeWindows();
+		this.#n && !e.includes(this.#n) && this.#i(), this._observeWindows();
 		let t = null;
 		for (let n of e) if (!n.style.zIndex) {
 			let e = this._isUtility(n);
@@ -324,7 +342,7 @@ var M = 1e6, N = 2 * M, P = 2000001, F = 512, I = 342, L = "gray-50", R = v(g[L]
 	_topmost(e) {
 		let t = null, n = -Infinity;
 		for (let r of e) {
-			let e = V(r);
+			let e = H(r);
 			e >= n && (n = e, t = r);
 		}
 		return t;
@@ -338,9 +356,9 @@ var M = 1e6, N = 2 * M, P = 2000001, F = 512, I = 342, L = "gray-50", R = v(g[L]
 		if (!this.isConnected) return;
 		let e = this._windows;
 		if (e.length < 2) return;
-		let t = [...e].sort((e, t) => V(e) - V(t)), n = this._deepActiveElement(), r = !1, i = null;
-		for (let e of t) i && i.compareDocumentPosition(e) & Node.DOCUMENT_POSITION_PRECEDING && (this._move(e, i.nextSibling), r = !0), i = e;
-		r && n instanceof HTMLElement && n.isConnected && this._deepActiveElement() !== n && (this._restoringFocus = !0, n.focus({ preventScroll: !0 }), this._restoringFocus = !1);
+		let t = (e) => e === this.#n ? Number(this.#r) || 0 : H(e), n = [...e].sort((e, n) => t(e) - t(n)), r = this._deepActiveElement(), i = !1, a = null;
+		for (let e of n) a && a.compareDocumentPosition(e) & Node.DOCUMENT_POSITION_PRECEDING && (this._move(e, a.nextSibling), i = !0), a = e;
+		i && r instanceof HTMLElement && r.isConnected && this._deepActiveElement() !== r && (this._restoringFocus = !0, r.focus({ preventScroll: !0 }), this._restoringFocus = !1);
 	}
 	_move(e, t) {
 		let n = this;
@@ -353,21 +371,21 @@ var M = 1e6, N = 2 * M, P = 2000001, F = 512, I = 342, L = "gray-50", R = v(g[L]
 	willUpdate(e) {
 		if (super.willUpdate(e), this._token = p(this, "--vf-desktop-pattern"), e.has("pattern")) {
 			let e = _(this.pattern);
-			e === null && this.pattern?.trim() && !this.#e && (this.#e = !0, console.warn(`vf-desktop: unknown pattern "${this.pattern}" — a library name (docs/PATTERNS.md) or sixteen hex digits. Keeping ${L}.`)), this._desktopPattern = e ?? g[L];
+			e === null && this.pattern?.trim() && !this.#e && (this.#e = !0, console.warn(`vf-desktop: unknown pattern "${this.pattern}" — a library name (docs/PATTERNS.md) or sixteen hex digits. Keeping ${R}.`)), this._desktopPattern = e ?? g[R];
 		}
 	}
 	updated(e) {
 		if (e.has("bezel") && (this.bezel > 0 ? this.style.setProperty("--vf-desktop-bezel", i(this.bezel)) : this.style.removeProperty("--vf-desktop-bezel")), e.has("width") || e.has("height") || e.has("bezel")) {
-			let e = this.width ?? F, t = this.height ?? I;
+			let e = this.width ?? I, t = this.height ?? L;
 			this.style.width = i(e + 2 * this.bezel), this.style.height = i(t + 2 * this.bezel);
 		}
 	}
 	render() {
-		let e = this.width ?? F, t = this.height ?? I, n = this._token ? D`<div class="vf-tile-grid">
+		let e = this.width ?? I, t = this.height ?? L, n = this._token ? D`<div class="vf-tile-grid">
           ${m({
-			cols: Math.ceil(e / B),
-			rows: Math.ceil(t / B),
-			tile: B
+			cols: Math.ceil(e / V),
+			rows: Math.ceil(t / V),
+			tile: V
 		})}
         </div>` : null;
 		return D`
@@ -388,9 +406,9 @@ var M = 1e6, N = 2 * M, P = 2000001, F = 512, I = 342, L = "gray-50", R = v(g[L]
     `;
 	}
 };
-o([k({ type: Number })], U.prototype, "width", void 0), o([k({ type: Number })], U.prototype, "height", void 0), o([k({ type: Number })], U.prototype, "bezel", void 0), o([k({ reflect: !0 })], U.prototype, "pattern", void 0), o([k({
+o([k({ type: Number })], W.prototype, "width", void 0), o([k({ type: Number })], W.prototype, "height", void 0), o([k({ type: Number })], W.prototype, "bezel", void 0), o([k({ reflect: !0 })], W.prototype, "pattern", void 0), o([k({
 	type: Number,
 	attribute: "window-top"
-})], U.prototype, "windowTop", void 0), o([j({ selector: "vf-window" })], U.prototype, "_windows", void 0), o([A(".screen")], U.prototype, "screen", void 0), o([A(".drag-surface")], U.prototype, "dragSurface", void 0), U = o([t("vf-desktop")], U);
+})], W.prototype, "windowTop", void 0), o([j({ selector: "vf-window" })], W.prototype, "_windows", void 0), o([A(".screen")], W.prototype, "screen", void 0), o([A(".drag-surface")], W.prototype, "dragSurface", void 0), W = o([t("vf-desktop")], W);
 //#endregion
-export { U as VfDesktop };
+export { W as VfDesktop };

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

@@ -80,6 +80,12 @@ declare const VfWindow_base: (new (...args: any[]) => import("../size.js").VfSiz
  * same pen; the drag moves the outline, held where the window can land, and
  * the window moves there on the release. Escape cancels.
  *
+ * **Frameless.** With `frameless` the window draws no chrome — no title bar
+ * or widgets, no frame or shadow, no grow box, no header or status strip —
+ * and the body is the whole box: a window that takes the whole screen, say,
+ * on `vf-desktop`'s full-screen tier. The chrome is hidden, not torn down, so
+ * the switch moves no node and the focus in the body stays where it is.
+ *
  * @slot - Default slot: window body content.
  * @slot header - Optional header content — a band between the title bar and
  *   the body, the full width of the window (the Finder window's header
@@ -141,6 +147,19 @@ export declare class VfWindow extends VfWindow_base {
      * float above the document tier and never take the single-active state.
      */
     variant?: 'utility';
+    /**
+     * Draw no chrome: no title bar, so no close or zoom box, no frame or
+     * shadow, no grow box, and no header or status strip, whatever their slots
+     * hold. The body is the whole box, `pattern` filling it and a placed child
+     * measured from its corner; under `scrollbars` the built-in scroll area
+     * fills the box, its own frame line on the box's edge. `heading` still
+     * names the window. The chrome is hidden rather than left out of the
+     * render, so switching this on a connected window moves no node and the
+     * focus in the body stays where it is. In a `vf-desktop` the window keeps
+     * its tier for activation and `hidden`, and `show()` and `hide()` run
+     * their rects from and to its box.
+     */
+    frameless: boolean;
     /** Title text shown centered in the title bar. */
     heading: string;
     /**

package/dist/components/vf-window.js

@@ -32,7 +32,7 @@ function Z(e, t, n) {
 }
 var Q = 24, $ = class extends j(l(H)) {
 	constructor(...e) {
-		super(...e), this.heading = "", this.active = !0, this.closable = !1, this.zoomable = !1, this.movable = !1, this.outlineDrag = !1, this.resizable = !1, this._pattern = null, this.#e = !1, this._hasHeader = !1, this._hasStatus = !1, this.scale = new n(this), this.gridSnap = new k(this), this.titleCenter = new re(this), this._dotsPattern = "", this.#t = new p(this, {
+		super(...e), this.frameless = !1, this.heading = "", this.active = !0, this.closable = !1, this.zoomable = !1, this.movable = !1, this.outlineDrag = !1, this.resizable = !1, this._pattern = null, this.#e = !1, this._hasHeader = !1, this._hasStatus = !1, this.scale = new n(this), this.gridSnap = new k(this), this.titleCenter = new re(this), this._dotsPattern = "", this.#t = new p(this, {
 			getBox: () => this.renderRoot?.querySelector(".vf-dots"),
 			getArt: () => this.variant === "utility" && !this._dotsPattern ? _ : null,
 			property: "--_vf-dots-tile"
@@ -214,6 +214,33 @@ var Q = 24, $ = class extends j(l(H)) {
         height: calc(var(--vf-scale, 1) * 3px);
       }
 
+      /* --- Frameless ------------------------------------------------- */
+      /* No chrome: the frame's stroke and shadow go, and the bars and the
+         grow box with them, so the body is the whole box. Hidden rather than
+         left out of the render, so switching moves no node and the focus in
+         the body stays; the title patch stays in the tree to name the window
+         (AccName reads a hidden aria-labelledby target, as the utility
+         variant's does). The border is the stroke's forced-colors form. */
+      :host([frameless]) .vf-frame {
+        padding: 0;
+        border: 0;
+        box-shadow: none;
+      }
+      :host([frameless]) .vf-title-bar,
+      :host([frameless]) .header,
+      :host([frameless]) .status,
+      :host([frameless]) .grow {
+        display: none;
+      }
+      /* The edge rails' overhang lands the scroll area's frame on the
+         window's; with no frame to land on, the area fills the box instead,
+         its own frame line on the box's edge. */
+      :host([frameless]) .edge-scroll {
+        width: 100%;
+        height: 100%;
+        margin: 0;
+      }
+
       /* --- Body ------------------------------------------------------ */
       /* Clipped at the frame, the way the classic content region was: the
          window is a fixed box (width and height are both declared), so content
@@ -636,7 +663,7 @@ var Q = 24, $ = class extends j(l(H)) {
                 <vf-scroll-area
                   class="edge-scroll"
                   axis=${this.scrollbars}
-                  ?corner=${this.resizable && !this._hasStatus}
+                  ?corner=${this.resizable && !this._hasStatus && !this.frameless}
                   label=${this.heading || G}
                   pattern=${this._pattern ? this.pattern : G}
                   exportparts="viewport"
@@ -663,7 +690,10 @@ var Q = 24, $ = class extends j(l(H)) {
     `;
 	}
 };
-s([K({ reflect: !0 })], $.prototype, "variant", void 0), s([K()], $.prototype, "heading", void 0), s([K({
+s([K({ reflect: !0 })], $.prototype, "variant", void 0), s([K({
+	type: Boolean,
+	reflect: !0
+})], $.prototype, "frameless", void 0), s([K()], $.prototype, "heading", void 0), s([K({
 	type: Boolean,
 	reflect: !0
 })], $.prototype, "active", void 0), s([K({

package/dist/text-control.d.ts

@@ -33,9 +33,9 @@ export declare class VfTextControlBase extends VfShadowRoleControl {
     /**
      * Opens with the whole text selected, so typing replaces it. Implies
      * `autofocus`: the first control carrying either takes the opening focus of
-     * its `vf-dialog`, or of a window the shell's window manager opens. A dialog
-     * selects the text on every open, a window on its first open only. A click
-     * still places the caret.
+     * its `vf-dialog`, or of a window system-online-sdk's window manager opens.
+     * A dialog selects the text on every open, a window on its first open only.
+     * A click still places the caret.
      */
     autoselect: boolean;
     /** Form field name used when submitting the associated form. */