vintage-frames 0.16.0 → 0.16.2

package/custom-elements.json

@@ -3399,7 +3399,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<vf-dialog>` — the System 7 modal dialog shell.\n\nTwo chromes, one modal lifecycle (native `<dialog>` for top-layer rendering\nand focus trapping, with a fully transparent backdrop — no dimming). Both\nare the same dBoxProc double frame — 1px outer rule, 2px gap, 2px inner\nband, no shadow (vfModalFrame):\n\n- **Default:** the movable modal (movableDBoxProc) — the striped title bar\n  set into the top of that frame, with a centered title over a white body.\n  Drag the title bar to move it. `closable` adds the standard close box\n  (left of the bar) — the HIG's own figures disagree on whether a movable\n  modal carries one (Figure 5-1 says yes, Figure 6-1 and the Chapter 6 text\n  say no), so the component enables either reading rather than enforcing\n  one.\n- **`frame=\"plain\"`:** the modal dialog box — the bare frame, no title bar —\n  and immovable, like the original. With no bar, `heading` only names the\n  dialog and `closable` is ignored.\n\nOpen it with `show()` (or set the `open` attribute/property); close with\n`close()`. Escape closes it and fires `vf-close` with\n`{ reason: 'escape' }`; the close box and programmatic closing fire\n`{ reason: 'close' }`. With `light-dismiss`, a click outside the frame\ncloses it too, with `{ reason: 'outside' }` — for the About box; off by\ndefault, since the classic modal ignored an outside click.\n\nAnswers: a `<form method=\"dialog\">` inside it closes it with the\nsubmitting button's `value` as `returnValue`, and `close(value)` does the\nsame. `vf-close` carries it as `detail.returnValue`, null when the close\ncarried none (Escape, a click outside, the close box).\n\nKeyboard, the classic Dialog Manager's two rules (VfModalDialog):\non open, focus goes to the first text-entry control — a slotted control\nwith `autofocus` first — or, with none, to the default button\n(`vf-button variant=\"default\"`). Return or Enter activates the default\nbutton from anywhere in the dialog, a focused Cancel included; Space\npresses the focused control. A link keeps its own Enter, and in a\nmulti-line editor Return inserts the newline while the keypad's Enter\nactivates the button.\n\nSlotted children placed with `top`/`left` measure from the content region's\ncorner — the frame's inner edge, below the title bar — and flow content\nstarts at the same corner.",
+          "description": "`<vf-dialog>` — the System 7 modal dialog shell.\n\nTwo chromes, one modal lifecycle (native `<dialog>` for top-layer rendering\nand focus trapping, with a fully transparent backdrop — no dimming). Both\nare the same dBoxProc double frame — 1px outer rule, 2px gap, 2px inner\nband, no shadow (vfModalFrame):\n\n- **Default:** the movable modal (movableDBoxProc) — the striped title bar\n  set into the top of that frame, with a centered title over a white body.\n  Drag the title bar to move it. `closable` adds the standard close box\n  (left of the bar) — the HIG's own figures disagree on whether a movable\n  modal carries one (Figure 5-1 says yes, Figure 6-1 and the Chapter 6 text\n  say no), so the component enables either reading rather than enforcing\n  one.\n- **`frame=\"plain\"`:** the modal dialog box — the bare frame, no title bar —\n  and immovable, like the original. With no bar, `heading` only names the\n  dialog and `closable` is ignored.\n\nOpen it with `show()` (or set the `open` attribute/property); close with\n`close()`. Escape closes it and fires `vf-close` with\n`{ reason: 'escape' }`; the close box and programmatic closing fire\n`{ reason: 'close' }`. With `light-dismiss`, a click outside the frame\ncloses it too, with `{ reason: 'outside' }` — for the About box; off by\ndefault, since the classic modal ignored an outside click.\n\nAnswers: a `<form method=\"dialog\">` inside it closes it with the\nsubmitting button's `value` as `returnValue`, and `close(value)` does the\nsame. `vf-close` carries it as `detail.returnValue`, null when the close\ncarried none (Escape, a click outside, the close box).\n\nKeyboard, the classic Dialog Manager's two rules (VfModalDialog):\non open, focus goes to the first text-entry control — a slotted control\nwith `autofocus` or `autoselect` first — or, with none, to the default\nbutton (`vf-button variant=\"default\"`). A field marked `autoselect` opens\nwith its whole text selected, on every open. Return or Enter activates\nthe default button from anywhere in the dialog, a focused Cancel\nincluded; Space presses the focused control. A link keeps its own Enter,\nand in a multi-line editor Return inserts the newline while the keypad's\nEnter activates the button.\n\nSlotted children placed with `top`/`left` measure from the content region's\ncorner — the frame's inner edge, below the title bar — and flow content\nstarts at the same corner.",
           "name": "VfDialog",
           "cssProperties": [
             {
@@ -3833,7 +3833,7 @@
                 "text": "HTMLElement | null"
               },
               "privacy": "protected",
-              "description": "Where focus lands on open. The classic Dialog Manager put the insertion\npoint in the first editable text item and gave nothing else focus at all;\nthe web needs a focused control for the keyboard to have anywhere to be,\nso with no text field the default button takes it (which is also what\nmakes Return and Space work there without a Tab). In order:\n\n1. a slotted control carrying `autofocus` — the author's say;\n2. the first enabled text-entry control (`vf-text-field`,\n   `vf-number-field`, `vf-text-area`, or a native text input/textarea);\n3. the defaultButton;\n4. null — leave the browser's own choice alone.\n\nLeft to itself, `showModal()` focuses the first focusable thing in flat\ntree order, which for a Cancel/OK row is Cancel, and for a body with a\nlink in it is the link — so Return did the one thing a classic dialog's\nReturn never did. Override to choose differently.",
+              "description": "Where focus lands on open. The classic Dialog Manager put the insertion\npoint in the first editable text item and gave nothing else focus at all;\nthe web needs a focused control for the keyboard to have anywhere to be,\nso with no text field the default button takes it (which is also what\nmakes Return and Space work there without a Tab). In order:\n\n1. the first slotted control carrying `autofocus` or `autoselect` — the\n   author's say;\n2. the first enabled text-entry control (`vf-text-field`,\n   `vf-number-field`, `vf-text-area`, or a native text input/textarea);\n3. the defaultButton;\n4. null — leave the browser's own choice alone.\n\nLeft to itself, `showModal()` focuses the first focusable thing in flat\ntree order, which for a Cancel/OK row is Cancel, and for a body with a\nlink in it is the link — so Return did the one thing a classic dialog's\nReturn never did. Override to choose differently. A target marked\n`autoselect` has its text selected once `vf-show` has fired.",
               "readonly": true,
               "inheritedFrom": {
                 "name": "VfModalDialog",
@@ -4205,7 +4205,7 @@
           ],
           "events": [
             {
-              "description": "Dialog opened, placed and given its initial focus. Detail `{ focus }`, the element focused: the moment to select a field's default text (`select()`) or measure copy that varies.",
+              "description": "Dialog opened, placed and given its initial focus. Detail `{ focus }`, the element focused: the moment to measure copy that varies. A field marked `autoselect` has its text selected after it.",
               "name": "vf-show",
               "inheritedFrom": {
                 "name": "VfModalDialog",
@@ -10304,6 +10304,21 @@
                 "module": "src/text-control.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "autoselect",
+              "type": {
+                "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.",
+              "attribute": "autoselect",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "VfTextControlBase",
+                "module": "src/text-control.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "name",
@@ -10464,6 +10479,29 @@
                 "module": "src/text-control.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "focus",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "FocusOptions"
+                  }
+                }
+              ],
+              "description": "Focuses the inner control, keeping its caret where it was. Chromium\nselects all of an input's text when the host hands the focus on, as a Tab\ndoes; `select()` and autoselect are how a field opens selected.",
+              "inheritedFrom": {
+                "name": "VfTextControlBase",
+                "module": "src/text-control.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "select",
@@ -10472,7 +10510,7 @@
                   "text": "void"
                 }
               },
-              "description": "Select all of the field's text, as a native field's `select()` does.",
+              "description": "Select all of the field's text, as a native field's `select()` does. With\na new value not yet rendered, once it has: writing the value into the\ninput drops its selection, so `field.value = x; field.select()` selects\n`x`, as on a native field.",
               "inheritedFrom": {
                 "name": "VfTextControlBase",
                 "module": "src/text-control.ts"
@@ -11281,6 +11319,19 @@
                 "module": "src/text-control.ts"
               }
             },
+            {
+              "name": "autoselect",
+              "type": {
+                "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.",
+              "fieldName": "autoselect",
+              "inheritedFrom": {
+                "name": "VfTextControlBase",
+                "module": "src/text-control.ts"
+              }
+            },
             {
               "name": "name",
               "type": {
@@ -18353,6 +18404,21 @@
                 "module": "src/text-control.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "autoselect",
+              "type": {
+                "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.",
+              "attribute": "autoselect",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "VfTextControlBase",
+                "module": "src/text-control.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "name",
@@ -18513,6 +18579,29 @@
                 "module": "src/text-control.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "focus",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "FocusOptions"
+                  }
+                }
+              ],
+              "description": "Focuses the inner control, keeping its caret where it was. Chromium\nselects all of an input's text when the host hands the focus on, as a Tab\ndoes; `select()` and autoselect are how a field opens selected.",
+              "inheritedFrom": {
+                "name": "VfTextControlBase",
+                "module": "src/text-control.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "select",
@@ -18521,7 +18610,7 @@
                   "text": "void"
                 }
               },
-              "description": "Select all of the field's text, as a native field's `select()` does.",
+              "description": "Select all of the field's text, as a native field's `select()` does. With\na new value not yet rendered, once it has: writing the value into the\ninput drops its selection, so `field.value = x; field.select()` selects\n`x`, as on a native field.",
               "inheritedFrom": {
                 "name": "VfTextControlBase",
                 "module": "src/text-control.ts"
@@ -19344,6 +19433,19 @@
                 "module": "src/text-control.ts"
               }
             },
+            {
+              "name": "autoselect",
+              "type": {
+                "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.",
+              "fieldName": "autoselect",
+              "inheritedFrom": {
+                "name": "VfTextControlBase",
+                "module": "src/text-control.ts"
+              }
+            },
             {
               "name": "name",
               "type": {
@@ -19632,6 +19734,21 @@
                 "module": "src/text-control.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "autoselect",
+              "type": {
+                "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.",
+              "attribute": "autoselect",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "VfTextControlBase",
+                "module": "src/text-control.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "name",
@@ -19776,6 +19893,29 @@
                 "module": "src/text-control.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "focus",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "FocusOptions"
+                  }
+                }
+              ],
+              "description": "Focuses the inner control, keeping its caret where it was. Chromium\nselects all of an input's text when the host hands the focus on, as a Tab\ndoes; `select()` and autoselect are how a field opens selected.",
+              "inheritedFrom": {
+                "name": "VfTextControlBase",
+                "module": "src/text-control.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "select",
@@ -19784,7 +19924,7 @@
                   "text": "void"
                 }
               },
-              "description": "Select all of the field's text, as a native field's `select()` does.",
+              "description": "Select all of the field's text, as a native field's `select()` does. With\na new value not yet rendered, once it has: writing the value into the\ninput drops its selection, so `field.value = x; field.select()` selects\n`x`, as on a native field.",
               "inheritedFrom": {
                 "name": "VfTextControlBase",
                 "module": "src/text-control.ts"
@@ -20630,6 +20770,19 @@
                 "module": "src/text-control.ts"
               }
             },
+            {
+              "name": "autoselect",
+              "type": {
+                "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.",
+              "fieldName": "autoselect",
+              "inheritedFrom": {
+                "name": "VfTextControlBase",
+                "module": "src/text-control.ts"
+              }
+            },
             {
               "name": "name",
               "type": {
@@ -22915,7 +23068,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Shared base for the kit's editable text fields — `vf-text-field`,\n`vf-text-area` and `vf-number-field`. Builds on\nVfShadowRoleControl (form association, the disabled-value guard and\nthe name/description bridge every field needs, its role sitting on the inner\nnative control) and adds the value/label scaffolding\nevery field repeated: the reflected `name`, the `value`/`placeholder`/\n`readonly`/`label` props, the captured default restored on form reset, the\n`updated()` → VfShadowRoleControl.syncFormValue funnel, and the display-\nscaling controller. Pairs with the `vfField` css fragment (the white-well\nskin) in styles/base.ts.\n\nSubclasses render their own native control (`<input>`/`<textarea>` plus any\nadornments), tag it `class=\"vf-field\"`, and may enrich the emitted event\ndetail via emitValue.",
+          "description": "Shared base for the kit's editable text fields — `vf-text-field`,\n`vf-text-area` and `vf-number-field`. Builds on\nVfShadowRoleControl (form association, the disabled-value guard and\nthe name/description bridge every field needs, its role sitting on the inner\nnative control) and adds the value/label scaffolding\nevery field repeated: the reflected `name`, the `value`/`placeholder`/\n`readonly`/`autoselect`/`label` props, the captured default restored on\nform reset, the `updated()` → VfShadowRoleControl.syncFormValue\nfunnel, `select()` and `focus()` on the inner control, and the display-\nscaling controller. Pairs with the `vfField` css fragment (the white-well\nskin) in styles/base.ts.\n\nSubclasses render their own native control (`<input>`/`<textarea>` plus any\nadornments), tag it `class=\"vf-field\"`, and may enrich the emitted event\ndetail via emitValue.",
           "name": "VfTextControlBase",
           "members": [
             {
@@ -22959,6 +23112,17 @@
               "attribute": "readonly",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "autoselect",
+              "type": {
+                "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.",
+              "attribute": "autoselect",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "name",
@@ -23079,6 +23243,25 @@
               "description": "The inner native control every field renders, tagged `vf-field`.",
               "readonly": true
             },
+            {
+              "kind": "method",
+              "name": "focus",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "FocusOptions"
+                  }
+                }
+              ],
+              "description": "Focuses the inner control, keeping its caret where it was. Chromium\nselects all of an input's text when the host hands the focus on, as a Tab\ndoes; `select()` and autoselect are how a field opens selected."
+            },
             {
               "kind": "method",
               "name": "select",
@@ -23087,7 +23270,7 @@
                   "text": "void"
                 }
               },
-              "description": "Select all of the field's text, as a native field's `select()` does."
+              "description": "Select all of the field's text, as a native field's `select()` does. With\na new value not yet rendered, once it has: writing the value into the\ninput drops its selection, so `field.value = x; field.select()` selects\n`x`, as on a native field."
             },
             {
               "kind": "method",
@@ -23805,6 +23988,15 @@
               "description": "Makes the field read-only (focusable, not editable).",
               "fieldName": "readonly"
             },
+            {
+              "name": "autoselect",
+              "type": {
+                "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.",
+              "fieldName": "autoselect"
+            },
             {
               "name": "name",
               "type": {
@@ -24124,7 +24316,7 @@
         },
         {
           "kind": "class",
-          "description": "Base class for the modal shell `vf-dialog` — and for a consumer's own\nmodal (an alert box, say) authored against the kit.\n\nOwns the native `<dialog>` lifecycle every modal shares: `open` sync, `show()` /\n`close()`, the top/left placement (stated or centered) and the\nsingle `close` funnel that drops the written origin and fires `vf-close` with\nthe reason. Because every close path — Escape, `close()`, the opt-in\nlightDismiss click outside — routes through the native `close`\nevent, an Escape-close no longer leaves a stale origin behind, so the next\nopen re-derives it.\n\nIt also owns the two keyboard rules every classic dialog followed (see\ndefaultButton and initialFocusTarget): Return or Enter\nactivates the default button from anywhere in the dialog, and the box opens\nwith the insertion point in its first text field — or, with none, focus on\nthe default button.\n\nRemoving an open modal from the DOM is a close path too. HTML's dialog\n*removing steps* take the element out of the top layer **without** running\nthe close algorithm — no `close` event, no focus restoration — which is\nexactly what the standard framework pattern of unmounting a dialog instead\nof calling `close()` does. `disconnectedCallback` routes that path through\nthe same funnel: the removed element still fires `vf-close` (heard by\nlisteners on the element itself — it has left the tree, so nothing\nbubbles), `open` and the pinned margins reconcile so a re-append mounts it\nclosed and re-centered, and focus returns to the element that was focused\nwhen the modal opened.\n\nA `<form method=\"dialog\">` inside the modal closes it with the submitting\nbutton's `value` as returnValue, as a form inside a native\n`<dialog>` does. The platform's own rule looks for a `<dialog>` around the\nform, and this one is in the shadow root, so the modal listens for the\nsubmit itself.\n\nSubclasses supply only the frame chrome: a `render()` returning\n`<dialog",
+          "description": "Base class for the modal shell `vf-dialog` — and for a consumer's own\nmodal (an alert box, say) authored against the kit.\n\nOwns the native `<dialog>` lifecycle every modal shares: `open` sync, `show()` /\n`close()`, the top/left placement (stated or centered) and the\nsingle `close` funnel that drops the written origin and fires `vf-close` with\nthe reason. Because every close path — Escape, `close()`, the opt-in\nlightDismiss click outside — routes through the native `close`\nevent, an Escape-close no longer leaves a stale origin behind, so the next\nopen re-derives it.\n\nIt also owns the two keyboard rules every classic dialog followed (see\ndefaultButton and initialFocusTarget): Return or Enter\nactivates the default button from anywhere in the dialog, and the box opens\nwith the insertion point in its first text field — or, with none, focus on\nthe default button. A field marked `autoselect` takes the focus with its\ntext selected, on every open.\n\nRemoving an open modal from the DOM is a close path too. HTML's dialog\n*removing steps* take the element out of the top layer **without** running\nthe close algorithm — no `close` event, no focus restoration — which is\nexactly what the standard framework pattern of unmounting a dialog instead\nof calling `close()` does. `disconnectedCallback` routes that path through\nthe same funnel: the removed element still fires `vf-close` (heard by\nlisteners on the element itself — it has left the tree, so nothing\nbubbles), `open` and the pinned margins reconcile so a re-append mounts it\nclosed and re-centered, and focus returns to the element that was focused\nwhen the modal opened.\n\nA `<form method=\"dialog\">` inside the modal closes it with the submitting\nbutton's `value` as returnValue, as a form inside a native\n`<dialog>` does. The platform's own rule looks for a `<dialog>` around the\nform, and this one is in the shadow root, so the modal listens for the\nsubmit itself.\n\nSubclasses supply only the frame chrome: a `render()` returning\n`<dialog",
           "name": "VfModalDialog",
           "members": [
             {
@@ -24312,7 +24504,7 @@
                 "text": "HTMLElement | null"
               },
               "privacy": "protected",
-              "description": "Where focus lands on open. The classic Dialog Manager put the insertion\npoint in the first editable text item and gave nothing else focus at all;\nthe web needs a focused control for the keyboard to have anywhere to be,\nso with no text field the default button takes it (which is also what\nmakes Return and Space work there without a Tab). In order:\n\n1. a slotted control carrying `autofocus` — the author's say;\n2. the first enabled text-entry control (`vf-text-field`,\n   `vf-number-field`, `vf-text-area`, or a native text input/textarea);\n3. the defaultButton;\n4. null — leave the browser's own choice alone.\n\nLeft to itself, `showModal()` focuses the first focusable thing in flat\ntree order, which for a Cancel/OK row is Cancel, and for a body with a\nlink in it is the link — so Return did the one thing a classic dialog's\nReturn never did. Override to choose differently.",
+              "description": "Where focus lands on open. The classic Dialog Manager put the insertion\npoint in the first editable text item and gave nothing else focus at all;\nthe web needs a focused control for the keyboard to have anywhere to be,\nso with no text field the default button takes it (which is also what\nmakes Return and Space work there without a Tab). In order:\n\n1. the first slotted control carrying `autofocus` or `autoselect` — the\n   author's say;\n2. the first enabled text-entry control (`vf-text-field`,\n   `vf-number-field`, `vf-text-area`, or a native text input/textarea);\n3. the defaultButton;\n4. null — leave the browser's own choice alone.\n\nLeft to itself, `showModal()` focuses the first focusable thing in flat\ntree order, which for a Cancel/OK row is Cancel, and for a body with a\nlink in it is the link — so Return did the one thing a classic dialog's\nReturn never did. Override to choose differently. A target marked\n`autoselect` has its text selected once `vf-show` has fired.",
               "readonly": true
             },
             {
@@ -24588,7 +24780,7 @@
           ],
           "events": [
             {
-              "description": "The modal opened: it is in the top layer, placed, and its initial focus is set. `detail: { focus }`, the element focused. The page's moment to finish composing it — select a field's default text, measure copy that varies. Fired inside `show()` once the modal has rendered, else at its first render.",
+              "description": "The modal opened: it is in the top layer, placed, and its initial focus is set. `detail: { focus }`, the element focused. The page's moment to finish composing it, such as measuring copy that varies. A field marked `autoselect` has its text selected after the event, so a value set in a handler is the one selected. Fired inside `show()` once the modal has rendered, else at its first render.",
               "name": "vf-show"
             },
             {

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

@@ -32,12 +32,13 @@ import { VfModalDialog } from '../modal-dialog.js';
  *
  * Keyboard, the classic Dialog Manager's two rules ({@link VfModalDialog}):
  * on open, focus goes to the first text-entry control — a slotted control
- * with `autofocus` first — or, with none, to the default button
- * (`vf-button variant="default"`). Return or Enter activates the default
- * button from anywhere in the dialog, a focused Cancel included; Space
- * presses the focused control. A link keeps its own Enter, and in a
- * multi-line editor Return inserts the newline while the keypad's Enter
- * activates the button.
+ * with `autofocus` or `autoselect` first — or, with none, to the default
+ * button (`vf-button variant="default"`). A field marked `autoselect` opens
+ * with its whole text selected, on every open. Return or Enter activates
+ * the default button from anywhere in the dialog, a focused Cancel
+ * included; Space presses the focused control. A link keeps its own Enter,
+ * and in a multi-line editor Return inserts the newline while the keypad's
+ * Enter activates the button.
  *
  * Slotted children placed with `top`/`left` measure from the content region's
  * corner — the frame's inner edge, below the title bar — and flow content
@@ -54,8 +55,8 @@ import { VfModalDialog } from '../modal-dialog.js';
  *   content). Inert while the content fits; over-stuffed, it scrolls under a
  *   System 7 rail and becomes a keyboard stop.
  * @fires vf-show - Dialog opened, placed and given its initial focus. Detail
- *   `{ focus }`, the element focused: the moment to select a field's default
- *   text (`select()`) or measure copy that varies.
+ *   `{ focus }`, the element focused: the moment to measure copy that
+ *   varies. A field marked `autoselect` has its text selected after it.
  * @fires vf-close - Dialog closed. Detail `{ reason: 'escape' | 'close' |
  *   'outside', returnValue: string | null }` — `'outside'` only under
  *   `light-dismiss` — plus `altKey`, `shiftKey`, `metaKey` and `ctrlKey`

package/dist/modal-dialog.d.ts

@@ -57,7 +57,8 @@ export declare const modalDialogStyles: import("lit").CSSResult;
  * {@link defaultButton} and {@link initialFocusTarget}): Return or Enter
  * activates the default button from anywhere in the dialog, and the box opens
  * with the insertion point in its first text field — or, with none, focus on
- * the default button.
+ * the default button. A field marked `autoselect` takes the focus with its
+ * text selected, on every open.
  *
  * Removing an open modal from the DOM is a close path too. HTML's dialog
  * *removing steps* take the element out of the top layer **without** running
@@ -82,9 +83,10 @@ export declare const modalDialogStyles: import("lit").CSSResult;
  *
  * @fires vf-show - The modal opened: it is in the top layer, placed, and its
  *   initial focus is set. `detail: { focus }`, the element focused. The page's
- *   moment to finish composing it — select a field's default text, measure
- *   copy that varies. Fired inside `show()` once the modal has rendered, else
- *   at its first render.
+ *   moment to finish composing it, such as measuring copy that varies. A
+ *   field marked `autoselect` has its text selected after the event, so a
+ *   value set in a handler is the one selected. Fired inside `show()` once
+ *   the modal has rendered, else at its first render.
  * @fires vf-close - The modal closed. `detail: { reason: 'escape' | 'close' |
  *   'outside', returnValue: string | null }`.
  */
@@ -185,7 +187,8 @@ export declare class VfModalDialog extends LitElement {
      * so with no text field the default button takes it (which is also what
      * makes Return and Space work there without a Tab). In order:
      *
-     * 1. a slotted control carrying `autofocus` — the author's say;
+     * 1. the first slotted control carrying `autofocus` or `autoselect` — the
+     *    author's say;
      * 2. the first enabled text-entry control (`vf-text-field`,
      *    `vf-number-field`, `vf-text-area`, or a native text input/textarea);
      * 3. the {@link defaultButton};
@@ -194,7 +197,8 @@ export declare class VfModalDialog extends LitElement {
      * Left to itself, `showModal()` focuses the first focusable thing in flat
      * tree order, which for a Cancel/OK row is Cancel, and for a body with a
      * link in it is the link — so Return did the one thing a classic dialog's
-     * Return never did. Override to choose differently.
+     * Return never did. Override to choose differently. A target marked
+     * `autoselect` has its text selected once `vf-show` has fired.
      */
     protected get initialFocusTarget(): HTMLElement | null;
     /** Open the modal (native `showModal()`), pinned onto the device grid. */

package/dist/modal-dialog.js

@@ -12,7 +12,7 @@ var p = 24, m = /* @__PURE__ */ new Set([
 	"email",
 	"password",
 	"number"
-]), h = (e) => e instanceof HTMLInputElement ? m.has(e.type) : !0, g = "vf-text-field, vf-number-field, vf-text-area, textarea, input", _ = u`
+]), h = (e) => e instanceof HTMLInputElement ? m.has(e.type) : !0, g = "vf-text-field, vf-number-field, vf-text-area, textarea, input", _ = (e) => e.autoselect ?? e.hasAttribute("autoselect"), v = u`
   dialog {
     padding: 0;
     margin: auto;
@@ -51,7 +51,7 @@ var p = 24, m = /* @__PURE__ */ new Set([
        the fallback is the arrow it always showed. */
     cursor: var(--vf-cursor, default);
   }
-`, v = class extends l {
+`, y = class extends l {
 	get dialogSize() {
 		return {
 			width: a(this.width ?? 260),
@@ -73,7 +73,7 @@ var p = 24, m = /* @__PURE__ */ new Set([
 	constructor() {
 		super(), this.scale = new n(this), this.open = !1, this.returnValue = "", this.lightDismiss = !1, this.#e = !1, this.#n = null, this.#r = null, this.#i = null, this.#a = (t) => {
 			let n = t.target;
-			if (!(n instanceof HTMLFormElement) || y(n) !== this) return;
+			if (!(n instanceof HTMLFormElement) || b(n) !== this) return;
 			let r = t.submitter;
 			if ((r?.hasAttribute("formmethod") ? r.getAttribute("formmethod") : n.getAttribute("method"))?.toLowerCase() !== "dialog") return;
 			let i = r instanceof HTMLButtonElement || r instanceof HTMLInputElement ? r.value : void 0;
@@ -122,7 +122,7 @@ var p = 24, m = /* @__PURE__ */ new Set([
 		return [...this.querySelectorAll(e), ...this.renderRoot.querySelectorAll(e)].find((e) => !e.matches(":disabled")) ?? null;
 	}
 	get initialFocusTarget() {
-		return this.querySelector("[autofocus]") || ([...this.querySelectorAll(g)].find((e) => h(e) && !e.matches(":disabled")) ?? this.defaultButton);
+		return [...this.querySelectorAll("*")].find((e) => e.hasAttribute("autofocus") || _(e)) || ([...this.querySelectorAll(g)].find((e) => h(e) && !e.matches(":disabled")) ?? this.defaultButton);
 	}
 	#c() {
 		let e = this.initialFocusTarget;
@@ -195,7 +195,7 @@ var p = 24, m = /* @__PURE__ */ new Set([
 			if (this.open && !e.open) {
 				this.#p = document.activeElement, this.returnValue = "", e.showModal();
 				let n = this.#c();
-				this.settle(), this.#S(e), this.#s.attach(), t(this, "vf-show", { focus: n });
+				this.settle(), this.#S(e), this.#s.attach(), t(this, "vf-show", { focus: n }), n && _(n) && n.select?.();
 			} else !this.open && e.open && e.close();
 		}
 	}
@@ -233,14 +233,14 @@ var p = 24, m = /* @__PURE__ */ new Set([
 s([d({
 	type: Boolean,
 	reflect: !0
-})], v.prototype, "open", void 0), s([d({ type: Number })], v.prototype, "width", void 0), s([d({ type: Number })], v.prototype, "height", void 0), s([d({ type: Number })], v.prototype, "top", void 0), s([d({ type: Number })], v.prototype, "left", void 0), s([d({
+})], y.prototype, "open", void 0), s([d({ type: Number })], y.prototype, "width", void 0), s([d({ type: Number })], y.prototype, "height", void 0), s([d({ type: Number })], y.prototype, "top", void 0), s([d({ type: Number })], y.prototype, "left", void 0), s([d({
 	type: Boolean,
 	reflect: !0,
 	attribute: "light-dismiss"
-})], v.prototype, "lightDismiss", void 0), s([f("dialog")], v.prototype, "_dialog", void 0);
-function y(e) {
-	for (let t = e.parentElement; t; t = t.parentElement) if (t instanceof v) return t;
+})], y.prototype, "lightDismiss", void 0), s([f("dialog")], y.prototype, "_dialog", void 0);
+function b(e) {
+	for (let t = e.parentElement; t; t = t.parentElement) if (t instanceof y) return t;
 	return null;
 }
 //#endregion
-export { v as VfModalDialog, _ as modalDialogStyles };
+export { y as VfModalDialog, v as modalDialogStyles };

package/dist/shell/catalog.d.ts

@@ -32,13 +32,15 @@ export declare const TRASH = "trash";
 export declare const DISK = "disk";
 /** A folder's kind. */
 export declare const FOLDER = "folder";
+/** An application's icon: the kind the shell registers, whose data names the application it opens. */
+export declare const APP_KIND = "app";
 /** The name a new folder takes, counted up where it is taken. */
 export declare const UNTITLED_FOLDER = "untitled folder";
 /** One item of the catalog. */
 export interface Item {
     id: string;
     name: string;
-    /** `folder`, a volume's (`trash`, `disk`), or a kind an application registers. */
+    /** `folder`, a volume's (`trash`, `disk`), the shell's `app`, or a kind an application registers. */
     kind: string;
     /** A folder's id, a volume's, or null for the desktop. */
     parent: string | null;
@@ -107,6 +109,8 @@ export interface CatalogArchive {
 export declare const isContainerKind: (kind: string) => boolean;
 /** Whether `id` names a volume. */
 export declare const isVolume: (id: string | null | undefined) => boolean;
+/** The application an `app` item stands for: its `data.app`, or null. */
+export declare function appIdOf(item: Item): string | null;
 /** The item with `id`, or null. */
 export declare function itemOf(state: CatalogState, id: string | null | undefined): Item | null;
 /** The container `parent` resolves to: that container while it is listed, else the desktop (null). */