@kubex/zinc 1.1.79 → 1.1.81

package/dist/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@kubex/zinc",
-  "version": "1.1.79",
+  "version": "1.1.81",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -4571,6 +4571,26 @@
               }
             },
             { "name": "textarea-rows", "value": { "type": "1" } },
+            {
+              "name": "slash-items",
+              "description": "Quick insertions offered by the slash menu of a `text` or `textarea` input. Accepts a JSON array of items, or\nthe shorthand `Brand name={{BRAND_NAME}}, Support email={{SUPPORT_EMAIL}}`.",
+              "value": { "type": "SlashMenuItem[]", "default": "[]" }
+            },
+            {
+              "name": "slash-preset",
+              "description": "Names of item sets registered with `registerSlashMenuPreset`, comma separated.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "slash-trigger",
+              "description": "The characters that open the slash menu.",
+              "value": { "type": "string", "default": "'/'" }
+            },
+            {
+              "name": "slash-heading",
+              "description": "The heading shown above the slash menu's items.",
+              "value": { "type": "string", "default": "'Insert'" }
+            },
             {
               "name": "options",
               "value": { "type": "{ [key: string]: string }", "default": "{}" }
@@ -4666,6 +4686,31 @@
                 "type": "'select' | 'text' | 'data-select' | 'number' | 'textarea'"
               },
               { "name": "textareaRows", "type": "1" },
+              {
+                "name": "slashItems",
+                "description": "Quick insertions offered by the slash menu of a `text` or `textarea` input. Accepts a JSON array of items, or\nthe shorthand `Brand name={{BRAND_NAME}}, Support email={{SUPPORT_EMAIL}}`.",
+                "type": "SlashMenuItem[]"
+              },
+              {
+                "name": "slashPreset",
+                "description": "Names of item sets registered with `registerSlashMenuPreset`, comma separated.",
+                "type": "string"
+              },
+              {
+                "name": "slashTrigger",
+                "description": "The characters that open the slash menu.",
+                "type": "string"
+              },
+              {
+                "name": "slashHeading",
+                "description": "The heading shown above the slash menu's items.",
+                "type": "string"
+              },
+              {
+                "name": "slashItemsProvider",
+                "description": "Resolves additional slash menu items each time the menu opens. JavaScript only.",
+                "type": "(query: string) => SlashMenuItem[] | Promise<SlashMenuItem[]> | undefined"
+              },
               { "name": "options", "type": "{ [key: string]: string }" },
               { "name": "selectProvider", "type": "string" },
               { "name": "iconPosition", "type": "'start' | 'end' | 'none'" },
@@ -4730,7 +4775,7 @@
         },
         {
           "name": "zn-input",
-          "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-blur** - Emitted when the control loses focus.\n- **zn-change** - Emitted when an alteration to the control's value is committed by the user.\n- **zn-clear** - Emitted when the clear button is activated.\n- **zn-focus** - Emitted when the control gains focus.\n- **zn-input** - Emitted when the control receives input.\n- **zn-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the input.\n- **blur()** - Removes focus from the input.\n- **select()** - Selects all the text in the input.\n- **setSelectionRange(selectionStart: _number_, selectionEnd: _number_, selectionDirection: _'forward' | 'backward' | 'none'_)** - Sets the start and end positions of the text selection (0-based).\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectMode: _'select' | 'start' | 'end' | 'preserve'_)** - Replaces a range of text with a new string.\n- **showPicker()** - Displays the browser picker for an input element (only works if the browser supports it for the input type).\n- **stepUp()** - Increments the value of a numeric input type by the value of the step attribute.\n- **stepDown()** - Decrements the value of a numeric input type by the value of the step attribute.\n- **checkValidity(): _boolean_** - Checks the validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The input's label. Alternatively, you can use the `label` attribute.\n- **label-tooltip** - Used to add text that is displayed in a tooltip next to the label. Alternatively, you can use the `label-tooltip` attribute.\n- **context-note** - Used to add contextual text that is displayed above the input, on the right. Alternatively, you can use the `context-note` attribute. Range inputs display their live value here unless this is set.\n- **prefix** - Used to prepend a presentational icon or similar element to the input.\n- **suffix** - Used to append a presentational icon or similar element to the input.\n- **clear-icon** - An icon to use in lieu of the default clear icon.\n- **show-password-icon** - An icon to use in lieu of the default show password icon.\n- **hide-password-icon** - An icon to use in lieu of the default hide password icon.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Properties:**\n - **--zn-range-track-height** - The height of a range input's track. _(default: undefined)_\n- **--zn-range-track-color** - The color of a range input's track. _(default: undefined)_\n- **--zn-range-thumb-size** - The diameter of a range input's thumb. _(default: undefined)_\n- **--zn-range-thumb-color** - The color of a range input's thumb. _(default: undefined)_\n- **--zn-range-thumb-ring-width** - The width of the ring drawn around a range input's thumb. _(default: undefined)_\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **base** - The component's base wrapper.\n- **input** - The internal `<input>` control.\n- **prefix** - The container that wraps the prefix.\n- **clear-button** - The clear button.\n- **password-toggle-button** - The password toggle button.\n- **suffix** - The container that wraps the suffix.",
+          "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-blur** - Emitted when the control loses focus.\n- **zn-change** - Emitted when an alteration to the control's value is committed by the user.\n- **zn-clear** - Emitted when the clear button is activated.\n- **zn-focus** - Emitted when the control gains focus.\n- **zn-input** - Emitted when the control receives input.\n- **zn-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n- **zn-slash-select** - Emitted when a slash menu item is chosen. Cancelable — call `preventDefault()` to suppress the insertion and handle the item yourself.\n- **zn-slash-insert** - Emitted after a slash menu item's value has been inserted.\n\n### **Methods:**\n - **resolveSlashItems(search): _Promise<SlashMenuItem[]>_** - The insertions the slash menu offers, gathered from every source, in the order they were declared.\n- **showSlashMenu()** - Opens the slash menu at the caret, inserting the trigger if it isn't already there.\n- **hideSlashMenu()** - Closes the slash menu.\n- **focus(options: _FocusOptions_)** - Sets focus on the input.\n- **blur()** - Removes focus from the input.\n- **select()** - Selects all the text in the input.\n- **setSelectionRange(selectionStart: _number_, selectionEnd: _number_, selectionDirection: _'forward' | 'backward' | 'none'_)** - Sets the start and end positions of the text selection (0-based).\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectMode: _'select' | 'start' | 'end' | 'preserve'_)** - Replaces a range of text with a new string.\n- **showPicker()** - Displays the browser picker for an input element (only works if the browser supports it for the input type).\n- **stepUp()** - Increments the value of a numeric input type by the value of the step attribute.\n- **stepDown()** - Decrements the value of a numeric input type by the value of the step attribute.\n- **checkValidity(): _boolean_** - Checks the validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The input's label. Alternatively, you can use the `label` attribute.\n- **label-tooltip** - Used to add text that is displayed in a tooltip next to the label. Alternatively, you can use the `label-tooltip` attribute.\n- **context-note** - Used to add contextual text that is displayed above the input, on the right. Alternatively, you can use the `context-note` attribute. Range inputs display their live value here unless this is set.\n- **prefix** - Used to prepend a presentational icon or similar element to the input.\n- **suffix** - Used to append a presentational icon or similar element to the input.\n- **clear-icon** - An icon to use in lieu of the default clear icon.\n- **show-password-icon** - An icon to use in lieu of the default show password icon.\n- **hide-password-icon** - An icon to use in lieu of the default hide password icon.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n- **slash-items** - `<zn-slash-item>` elements describing the insertions offered by the slash menu. Items are picked up wherever they sit inside the input, so this slot name is optional.\n- **slash-menu** - A `<zn-slash-menu>` to use instead of the built-in one, so its heading, sizing and styling can be set in markup. Any `<zn-slash-item>` children of it become the menu's items.\n\n### **CSS Properties:**\n - **--zn-range-track-height** - The height of a range input's track. _(default: undefined)_\n- **--zn-range-track-color** - The color of a range input's track. _(default: undefined)_\n- **--zn-range-thumb-size** - The diameter of a range input's thumb. _(default: undefined)_\n- **--zn-range-thumb-color** - The color of a range input's thumb. _(default: undefined)_\n- **--zn-range-thumb-ring-width** - The width of the ring drawn around a range input's thumb. _(default: undefined)_\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **slash-menu** - The slash menu shown at the caret.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **base** - The component's base wrapper.\n- **input** - The internal `<input>` control.\n- **prefix** - The container that wraps the prefix.\n- **clear-button** - The clear button.\n- **password-toggle-button** - The password toggle button.\n- **suffix** - The container that wraps the suffix.",
           "doc-url": "",
           "attributes": [
             {
@@ -4927,6 +4972,26 @@
                 "type": "'none' | 'text' | 'decimal' | 'numeric' | 'tel' | 'search' | 'email' | 'url'"
               }
             },
+            {
+              "name": "slash-items",
+              "description": "Quick insertions offered by the slash menu. Accepts a JSON array of items, or the shorthand\n`Brand name={{BRAND_NAME}}, Support email={{SUPPORT_EMAIL}}`. Can also be set as an array of\n`SlashMenuItem` objects in JavaScript.",
+              "value": { "type": "SlashMenuItem[]", "default": "[]" }
+            },
+            {
+              "name": "slash-preset",
+              "description": "Names of item sets registered with `registerSlashMenuPreset`, comma separated.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "slash-trigger",
+              "description": "The characters that open the slash menu.",
+              "value": { "type": "string", "default": "'/'" }
+            },
+            {
+              "name": "slash-heading",
+              "description": "The heading shown above the slash menu's items.",
+              "value": { "type": "string", "default": "'Insert'" }
+            },
             {
               "name": "trigger-submit",
               "description": "When enabled, pressing enter will always submit the surrounding form, even when the form uses\nenter-navigation to move between fields.",
@@ -4969,6 +5034,14 @@
             {
               "name": "help-text",
               "description": "Text that describes how to use the input. Alternatively, you can use the `help-text` attribute."
+            },
+            {
+              "name": "slash-items",
+              "description": "`<zn-slash-item>` elements describing the insertions offered by the slash menu. Items are picked up wherever they sit inside the input, so this slot name is optional."
+            },
+            {
+              "name": "slash-menu",
+              "description": "A `<zn-slash-menu>` to use instead of the built-in one, so its heading, sizing and styling can be set in markup. Any `<zn-slash-item>` children of it become the menu's items."
             }
           ],
           "events": [
@@ -4995,12 +5068,21 @@
             {
               "name": "zn-invalid",
               "description": "Emitted when the form control has been checked for validity and its constraints aren't satisfied."
+            },
+            {
+              "name": "zn-slash-select",
+              "description": "Emitted when a slash menu item is chosen. Cancelable — call `preventDefault()` to suppress the insertion and handle the item yourself."
+            },
+            {
+              "name": "zn-slash-insert",
+              "description": "Emitted after a slash menu item's value has been inserted."
             }
           ],
           "js": {
             "properties": [
               { "name": "input", "type": "HTMLInputElement" },
               { "name": "colorPicker", "type": "HTMLInputElement" },
+              { "name": "slashMenuElement", "type": "ZnSlashMenu | null" },
               { "name": "title", "type": "string" },
               {
                 "name": "type",
@@ -5182,6 +5264,31 @@
                 "description": "Tells the browser what type of data will be entered by the user, allowing it to display the appropriate virtual\nkeyboard on supportive devices.",
                 "type": "'none' | 'text' | 'decimal' | 'numeric' | 'tel' | 'search' | 'email' | 'url'"
               },
+              {
+                "name": "slashItems",
+                "description": "Quick insertions offered by the slash menu. Accepts a JSON array of items, or the shorthand\n`Brand name={{BRAND_NAME}}, Support email={{SUPPORT_EMAIL}}`. Can also be set as an array of\n`SlashMenuItem` objects in JavaScript.",
+                "type": "SlashMenuItem[]"
+              },
+              {
+                "name": "slashPreset",
+                "description": "Names of item sets registered with `registerSlashMenuPreset`, comma separated.",
+                "type": "string"
+              },
+              {
+                "name": "slashTrigger",
+                "description": "The characters that open the slash menu.",
+                "type": "string"
+              },
+              {
+                "name": "slashHeading",
+                "description": "The heading shown above the slash menu's items.",
+                "type": "string"
+              },
+              {
+                "name": "slashItemsProvider",
+                "description": "Resolves additional items each time the menu opens, for lists that come from elsewhere (e.g. an\nAPI). Receives the current query and may return a promise. JavaScript only.",
+                "type": "(query: string) => SlashMenuItem[] | Promise<SlashMenuItem[]> | undefined"
+              },
               {
                 "name": "triggerSubmit",
                 "description": "When enabled, pressing enter will always submit the surrounding form, even when the form uses\nenter-navigation to move between fields.",
@@ -5228,6 +5335,14 @@
               {
                 "name": "zn-invalid",
                 "description": "Emitted when the form control has been checked for validity and its constraints aren't satisfied."
+              },
+              {
+                "name": "zn-slash-select",
+                "description": "Emitted when a slash menu item is chosen. Cancelable — call `preventDefault()` to suppress the insertion and handle the item yourself."
+              },
+              {
+                "name": "zn-slash-insert",
+                "description": "Emitted after a slash menu item's value has been inserted."
               }
             ]
           }
@@ -7803,7 +7918,7 @@
         },
         {
           "name": "zn-remarkd-editor",
-          "description": "A Notion-style block editor for remarkd content. Blocks render inline; click one to edit its source.\n---\n\n\n### **Events:**\n - **zn-input** - Emitted on each keystroke while editing a block.\n- **zn-change** - Emitted when a block edit is committed and the value changes.\n\n### **Methods:**\n - **focus()** - Starts editing the first block, or a new block if the document is empty.\n- **blur()** - Commits any in-progress block edit.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **toolbar** - The always-visible block-insert toolbar.\n- **block** - A rendered block wrapper.\n- **rendered** - The rendered remarkd output of a block.\n- **input** - The textarea shown while editing a block.\n- **slash-menu** - The context menu opened by typing \"/\" in a block.\n- **image-controls** - The caption / alignment / size panel shown when an image block is clicked.",
+          "description": "A Notion-style block editor for remarkd content. Blocks render inline; click one to edit its source.\n---\n\n\n### **Events:**\n - **zn-input** - Emitted on each keystroke while editing a block.\n- **zn-change** - Emitted when a block edit is committed and the value changes.\n\n### **Methods:**\n - **focus()** - Starts editing the first block, or a new block if the document is empty.\n- **blur()** - Commits any in-progress block or raw edit.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **toolbar** - The always-visible block-insert toolbar.\n- **raw-toggle** - The button that switches between the block view and the raw source view.\n- **block** - A rendered block wrapper.\n- **rendered** - The rendered remarkd output of a block.\n- **input** - The textarea shown while editing a block.\n- **raw** - The full-document textarea shown in raw source mode.\n- **slash-menu** - The `zn-slash-menu` opened by typing \"/\" in an empty block.\n- **image-controls** - The caption / alignment / size panel shown when an image block is clicked.",
           "doc-url": "",
           "attributes": [
             {
@@ -7826,6 +7941,11 @@
               "description": "Endpoint for image uploads — required for image support. Posting the file\nmetadata here must return `{uploadPath, uploadUrl}`; the file is then PUT\nto `uploadUrl` and the returned `uploadPath` is embedded as the image URL.",
               "value": { "type": "string", "default": "''" }
             },
+            {
+              "name": "allow-raw",
+              "description": "Adds a toolbar toggle that swaps the block view for the full remarkd source.",
+              "value": { "type": "boolean", "default": "false" }
+            },
             {
               "name": "required",
               "description": "Makes the editor required for form submission.",
@@ -7879,6 +7999,11 @@
                 "description": "Endpoint for image uploads — required for image support. Posting the file\nmetadata here must return `{uploadPath, uploadUrl}`; the file is then PUT\nto `uploadUrl` and the returned `uploadPath` is embedded as the image URL.",
                 "type": "string"
               },
+              {
+                "name": "allowRaw",
+                "description": "Adds a toolbar toggle that swaps the block view for the full remarkd source.",
+                "type": "boolean"
+              },
               {
                 "name": "required",
                 "description": "Makes the editor required for form submission.",
@@ -8670,6 +8795,240 @@
             "events": []
           }
         },
+        {
+          "name": "zn-slash-item",
+          "description": "Declares a single insertion for a slash menu. Renders nothing itself — it describes an\nentry for the component it is slotted into, e.g. `<zn-textarea>`'s `slash-items` slot.\n---\n\n\n### **Methods:**\n - **toSlashMenuItem(): _SlashMenuItem_** - The item as the slash menu consumes it.\n\n### **Slots:**\n - _default_ - The text to insert, for values that are long or span multiple lines. Ignored when the `value` attribute is set.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "label",
+              "description": "The text shown in the menu.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "value",
+              "description": "The text inserted into the field. Falls back to this element's text content.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "icon",
+              "description": "Icon shown against the item, e.g. `tag@lu`.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "description",
+              "description": "Supporting text shown under the label.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "keywords",
+              "description": "Extra terms the item can be found by, comma separated.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "group",
+              "description": "Heading the item is listed under.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "order",
+              "description": "Overrides the item's position in the menu. Lower sorts first.",
+              "value": { "type": "number" }
+            },
+            {
+              "name": "caret-offset",
+              "description": "Where the caret lands after insertion, as an offset into the inserted value.",
+              "value": { "type": "number" }
+            },
+            {
+              "name": "action",
+              "description": "Identifier passed through on `zn-slash-select`, for items that do something other than insert.",
+              "value": { "type": "string" }
+            },
+            {
+              "name": "disabled",
+              "description": "Listed, but not selectable.",
+              "value": { "type": "boolean", "default": "false" }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "The text to insert, for values that are long or span multiple lines. Ignored when the `value` attribute is set."
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              {
+                "name": "label",
+                "description": "The text shown in the menu.",
+                "type": "string"
+              },
+              {
+                "name": "value",
+                "description": "The text inserted into the field. Falls back to this element's text content.",
+                "type": "string"
+              },
+              {
+                "name": "icon",
+                "description": "Icon shown against the item, e.g. `tag@lu`.",
+                "type": "string"
+              },
+              {
+                "name": "description",
+                "description": "Supporting text shown under the label.",
+                "type": "string"
+              },
+              {
+                "name": "keywords",
+                "description": "Extra terms the item can be found by, comma separated.",
+                "type": "string"
+              },
+              {
+                "name": "group",
+                "description": "Heading the item is listed under.",
+                "type": "string"
+              },
+              {
+                "name": "order",
+                "description": "Overrides the item's position in the menu. Lower sorts first.",
+                "type": "number"
+              },
+              {
+                "name": "caretOffset",
+                "description": "Where the caret lands after insertion, as an offset into the inserted value.",
+                "type": "number"
+              },
+              {
+                "name": "action",
+                "description": "Identifier passed through on `zn-slash-select`, for items that do something other than insert.",
+                "type": "string"
+              },
+              {
+                "name": "disabled",
+                "description": "Listed, but not selectable.",
+                "type": "boolean"
+              }
+            ],
+            "events": []
+          }
+        },
+        {
+          "name": "zn-slash-menu",
+          "description": "A keyboard-driven list of insertions, anchored to the caret of the field that opened it.\n---\n\n\n### **Events:**\n - **SLASH_ITEM_SELECT**\n- **zn-slash-item-select** - Emitted when an item is chosen. Does not cross shadow boundaries; the component driving the menu (e.g. `zn-textarea`) re-emits it as `zn-slash-select`.\n\n### **Methods:**\n - **setActiveIndex(index: _number_)** - Sets the active item by index, wrapping at both ends and skipping disabled items.\n- **moveActive(delta: _number_)** - Moves the active item by `delta` places.\n- **selectActive()** - Chooses the active item, as pressing Enter would.\n- **reposition()** - Recalculates the panel's position against its anchor.\n\n### **CSS Properties:**\n - **--slash-menu-width** - The width of the panel. _(default: undefined)_\n- **--slash-menu-max-height** - The maximum height of the panel before it scrolls. _(default: undefined)_\n\n### **CSS Parts:**\n - **panel** - The floating panel that holds the list.\n- **heading** - The panel's heading.\n- **item** - An item in the list.\n- **group-heading** - A group heading between items.\n- **footer** - The truncation footer, shown when not every match fits.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "open",
+              "description": "Whether the menu is showing.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "items",
+              "description": "The items to list. Already filtered — the menu displays what it is given.",
+              "value": { "type": "SlashMenuItem[]", "default": "[]" }
+            },
+            {
+              "name": "query",
+              "description": "The query the items were matched against, shown in the heading.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "heading",
+              "description": "The heading shown when there is no query.",
+              "value": { "type": "string", "default": "'Insert'" }
+            },
+            {
+              "name": "empty-text",
+              "description": "Shown in place of the list when there are no items.",
+              "value": { "type": "string", "default": "'No matches'" }
+            },
+            {
+              "name": "max-items",
+              "description": "The most items to render at once. Remaining matches are reported in the footer.",
+              "value": { "type": "number", "default": "25" }
+            },
+            {
+              "name": "placement",
+              "description": "The preferred placement of the panel.",
+              "value": { "type": "Placement", "default": "'bottom-start'" }
+            },
+            {
+              "name": "distance",
+              "description": "The gap between the caret and the panel.",
+              "value": { "type": "number", "default": "4" }
+            }
+          ],
+          "events": [
+            { "name": "SLASH_ITEM_SELECT", "type": "CustomEvent" },
+            {
+              "name": "zn-slash-item-select",
+              "description": "Emitted when an item is chosen. Does not cross shadow boundaries; the component driving the menu (e.g. `zn-textarea`) re-emits it as `zn-slash-select`."
+            }
+          ],
+          "js": {
+            "properties": [
+              {
+                "name": "open",
+                "description": "Whether the menu is showing.",
+                "type": "boolean"
+              },
+              {
+                "name": "items",
+                "description": "The items to list. Already filtered — the menu displays what it is given.",
+                "type": "SlashMenuItem[]"
+              },
+              {
+                "name": "query",
+                "description": "The query the items were matched against, shown in the heading.",
+                "type": "string"
+              },
+              {
+                "name": "heading",
+                "description": "The heading shown when there is no query.",
+                "type": "string"
+              },
+              {
+                "name": "emptyText",
+                "description": "Shown in place of the list when there are no items.",
+                "type": "string"
+              },
+              {
+                "name": "maxItems",
+                "description": "The most items to render at once. Remaining matches are reported in the footer.",
+                "type": "number"
+              },
+              {
+                "name": "anchor",
+                "description": "The element or caret rect the panel is positioned against.",
+                "type": "Element | VirtualElement | null"
+              },
+              {
+                "name": "placement",
+                "description": "The preferred placement of the panel.",
+                "type": "Placement"
+              },
+              {
+                "name": "distance",
+                "description": "The gap between the caret and the panel.",
+                "type": "number"
+              },
+              {
+                "name": "activeItem",
+                "description": "The item that Enter would insert.",
+                "type": "SlashMenuItem | undefined"
+              }
+            ],
+            "events": [
+              { "name": "SLASH_ITEM_SELECT", "type": "CustomEvent" },
+              {
+                "name": "zn-slash-item-select",
+                "description": "Emitted when an item is chosen. Does not cross shadow boundaries; the component driving the menu (e.g. `zn-textarea`) re-emits it as `zn-slash-select`."
+              }
+            ]
+          }
+        },
         {
           "name": "zn-slideout",
           "description": "Short summary of the component's intended use.\n---\n\n\n### **Events:**\n - **zn-show** - Emitted when the slideout is opens.\n- **zn-close** - Emitted when the slideout is closed.\n- **zn-request-close** - Emitted when the user attempts to close the slideout by clicking the close button, clicking the overlay, or pressing escape. Calling `event.preventDefault()` will keep the slideout open. Avoid using this unless closing the slideout will result in destructive behavior such as data loss.\n\n### **Methods:**\n - **show()** - Shows the slideout.\n- **hide()** - Hides the slideout.\n\n### **Slots:**\n - _default_ - The default slot.\n- **label** - The slideout's label. Alternatively you can use the `label` attribute.\n\n### **CSS Properties:**\n - **--width** - The preferred width of the slideout. Note the slideout will shrink to accommodate smaller screens. _(default: undefined)_\n- **--header-spacing** - The amount of padding to use for the header. _(default: undefined)_\n- **--body-spacing** - The amount of padding to use for the body. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **header** - The slideout's header. This element wraps the title and header actions.\n- **close-button** - The slideout's close button.\n- **close-button__base** - The close buttons exported `base` part.\n- **body** - The slideout's body.",
@@ -9495,7 +9854,7 @@
         },
         {
           "name": "zn-textarea",
-          "description": "Textareas collect data from the user and allow multiple lines of text.\n---\n\n\n### **Events:**\n - **zn-blur** - Emitted when the control loses focus.\n- **zn-change** - Emitted when an alteration to the control's value is committed by the user.\n- **zn-focus** - Emitted when the control gains focus.\n- **zn-input** - Emitted when the control receives input.\n- **zn-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the textarea.\n- **blur()** - Removes focus from the textarea.\n- **select()** - Selects all the text in the textarea.\n- **scrollPosition(position: _{ top?: number; left?: number }_): _{ top: number; left: number } | undefined_** - Gets or sets the textarea scroll position.\n- **setSelectionRange(selectionStart: _number_, selectionEnd: _number_, selectionDirection: _'forward' | 'backward' | 'none'_)** - Sets the start and end positions of the text selection (0-based).\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectMode: _'select' | 'start' | 'end' | 'preserve'_)** - Replaces a range of text with a new string.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The textareas label. Alternatively, you can use the `label` attribute.\n- **label-tooltip** - Used to add text that is displayed in a tooltip next to the label. Alternatively, you can use the `label-tooltip` attribute.\n- **context-note** - Used to add contextual text that is displayed above the textarea, on the right. Alternatively, you can use the `context-note` attribute.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **base** - The component's base wrapper.\n- **textarea** - The internal `<textarea>` control.",
+          "description": "Textareas collect data from the user and allow multiple lines of text.\n---\n\n\n### **Events:**\n - **zn-blur** - Emitted when the control loses focus.\n- **zn-change** - Emitted when an alteration to the control's value is committed by the user.\n- **zn-focus** - Emitted when the control gains focus.\n- **zn-input** - Emitted when the control receives input.\n- **zn-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n- **zn-slash-select** - Emitted when a slash menu item is chosen. Cancelable — call `preventDefault()` to suppress the insertion and handle the item yourself.\n- **zn-slash-insert** - Emitted after a slash menu item's value has been inserted.\n\n### **Methods:**\n - **resolveSlashItems(search): _Promise<SlashMenuItem[]>_** - The insertions the slash menu offers, gathered from every source, in the order they were declared.\n- **showSlashMenu()** - Opens the slash menu at the caret, inserting the trigger if it isn't already there.\n- **hideSlashMenu()** - Closes the slash menu.\n- **focus(options: _FocusOptions_)** - Sets focus on the textarea.\n- **blur()** - Removes focus from the textarea.\n- **select()** - Selects all the text in the textarea.\n- **scrollPosition(position: _{ top?: number; left?: number }_): _{ top: number; left: number } | undefined_** - Gets or sets the textarea scroll position.\n- **setSelectionRange(selectionStart: _number_, selectionEnd: _number_, selectionDirection: _'forward' | 'backward' | 'none'_)** - Sets the start and end positions of the text selection (0-based).\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectMode: _'select' | 'start' | 'end' | 'preserve'_)** - Replaces a range of text with a new string.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The textareas label. Alternatively, you can use the `label` attribute.\n- **label-tooltip** - Used to add text that is displayed in a tooltip next to the label. Alternatively, you can use the `label-tooltip` attribute.\n- **context-note** - Used to add contextual text that is displayed above the textarea, on the right. Alternatively, you can use the `context-note` attribute.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n- **slash-items** - `<zn-slash-item>` elements describing the insertions offered by the slash menu. Items are picked up wherever they sit inside the textarea, so this slot name is optional.\n- **slash-menu** - A `<zn-slash-menu>` to use instead of the built-in one, so its heading, sizing and styling can be set in markup. Any `<zn-slash-item>` children of it become the menu's items.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **base** - The component's base wrapper.\n- **textarea** - The internal `<textarea>` control.\n- **slash-menu** - The slash menu shown at the caret.",
           "doc-url": "",
           "attributes": [
             { "name": "title", "value": { "type": "string", "default": "''" } },
@@ -9630,6 +9989,26 @@
                 "type": "'none' | 'text' | 'decimal' | 'numeric' | 'tel' | 'search' | 'email' | 'url'"
               }
             },
+            {
+              "name": "slash-items",
+              "description": "Quick insertions offered by the slash menu. Accepts a JSON array of items, or the shorthand\n`Brand name={{BRAND_NAME}}, Support email={{SUPPORT_EMAIL}}`. Can also be set as an array of\n`SlashMenuItem` objects in JavaScript.",
+              "value": { "type": "SlashMenuItem[]", "default": "[]" }
+            },
+            {
+              "name": "slash-preset",
+              "description": "Names of item sets registered with `registerSlashMenuPreset`, comma separated.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "slash-trigger",
+              "description": "The characters that open the slash menu.",
+              "value": { "type": "string", "default": "'/'" }
+            },
+            {
+              "name": "slash-heading",
+              "description": "The heading shown above the slash menu's items.",
+              "value": { "type": "string", "default": "'Insert'" }
+            },
             {
               "name": "transparent",
               "value": { "type": "boolean", "default": "false" }
@@ -9651,6 +10030,14 @@
             {
               "name": "help-text",
               "description": "Text that describes how to use the input. Alternatively, you can use the `help-text` attribute."
+            },
+            {
+              "name": "slash-items",
+              "description": "`<zn-slash-item>` elements describing the insertions offered by the slash menu. Items are picked up wherever they sit inside the textarea, so this slot name is optional."
+            },
+            {
+              "name": "slash-menu",
+              "description": "A `<zn-slash-menu>` to use instead of the built-in one, so its heading, sizing and styling can be set in markup. Any `<zn-slash-item>` children of it become the menu's items."
             }
           ],
           "events": [
@@ -9673,12 +10060,21 @@
             {
               "name": "zn-invalid",
               "description": "Emitted when the form control has been checked for validity and its constraints aren't satisfied."
+            },
+            {
+              "name": "zn-slash-select",
+              "description": "Emitted when a slash menu item is chosen. Cancelable — call `preventDefault()` to suppress the insertion and handle the item yourself."
+            },
+            {
+              "name": "zn-slash-insert",
+              "description": "Emitted after a slash menu item's value has been inserted."
             }
           ],
           "js": {
             "properties": [
               { "name": "formControl", "type": "HTMLElement" },
               { "name": "input", "type": "HTMLTextAreaElement" },
+              { "name": "slashMenuElement", "type": "ZnSlashMenu | null" },
               { "name": "hasFocus", "type": "boolean" },
               { "name": "title", "type": "string" },
               {
@@ -9797,6 +10193,31 @@
                 "description": "Tells the browser what type of data will be entered by the user, allowing it to display the appropriate virtual\nkeyboard on supportive devices.",
                 "type": "'none' | 'text' | 'decimal' | 'numeric' | 'tel' | 'search' | 'email' | 'url'"
               },
+              {
+                "name": "slashItems",
+                "description": "Quick insertions offered by the slash menu. Accepts a JSON array of items, or the shorthand\n`Brand name={{BRAND_NAME}}, Support email={{SUPPORT_EMAIL}}`. Can also be set as an array of\n`SlashMenuItem` objects in JavaScript.",
+                "type": "SlashMenuItem[]"
+              },
+              {
+                "name": "slashPreset",
+                "description": "Names of item sets registered with `registerSlashMenuPreset`, comma separated.",
+                "type": "string"
+              },
+              {
+                "name": "slashTrigger",
+                "description": "The characters that open the slash menu.",
+                "type": "string"
+              },
+              {
+                "name": "slashHeading",
+                "description": "The heading shown above the slash menu's items.",
+                "type": "string"
+              },
+              {
+                "name": "slashItemsProvider",
+                "description": "Resolves additional items each time the menu opens, for lists that come from elsewhere (e.g. an\nAPI). Receives the current query and may return a promise. JavaScript only.",
+                "type": "(query: string) => SlashMenuItem[] | Promise<SlashMenuItem[]> | undefined"
+              },
               {
                 "name": "defaultValue",
                 "description": "The default value of the form control. Primarily used for resetting the form control.",
@@ -9832,6 +10253,14 @@
               {
                 "name": "zn-invalid",
                 "description": "Emitted when the form control has been checked for validity and its constraints aren't satisfied."
+              },
+              {
+                "name": "zn-slash-select",
+                "description": "Emitted when a slash menu item is chosen. Cancelable — call `preventDefault()` to suppress the insertion and handle the item yourself."
+              },
+              {
+                "name": "zn-slash-insert",
+                "description": "Emitted after a slash menu item's value has been inserted."
               }
             ]
           }
@@ -10582,6 +11011,26 @@
               "name": "textarea-rows",
               "value": { "type": "number | undefined" }
             },
+            {
+              "name": "slash-items",
+              "description": "Quick insertions offered by the slash menu on `text` and `textarea` inputs. Accepts a JSON array of items, or\nthe shorthand `Brand name={{BRAND_NAME}}, Support email={{SUPPORT_EMAIL}}`. Every language shares the list.",
+              "value": { "type": "SlashMenuItem[]", "default": "[]" }
+            },
+            {
+              "name": "slash-preset",
+              "description": "Names of item sets registered with `registerSlashMenuPreset`, comma separated.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "slash-trigger",
+              "description": "The characters that open the slash menu.",
+              "value": { "type": "string", "default": "'/'" }
+            },
+            {
+              "name": "slash-heading",
+              "description": "The heading shown above the slash menu's items.",
+              "value": { "type": "string", "default": "'Insert'" }
+            },
             {
               "name": "grouped",
               "description": "When true, hides the individual language navbar and defers language control to a parent zn-translation-group.",
@@ -10613,6 +11062,31 @@
                 "type": "'select' | 'text' | 'number' | 'textarea'"
               },
               { "name": "textareaRows", "type": "number | undefined" },
+              {
+                "name": "slashItems",
+                "description": "Quick insertions offered by the slash menu on `text` and `textarea` inputs. Accepts a JSON array of items, or\nthe shorthand `Brand name={{BRAND_NAME}}, Support email={{SUPPORT_EMAIL}}`. Every language shares the list.",
+                "type": "SlashMenuItem[]"
+              },
+              {
+                "name": "slashPreset",
+                "description": "Names of item sets registered with `registerSlashMenuPreset`, comma separated.",
+                "type": "string"
+              },
+              {
+                "name": "slashTrigger",
+                "description": "The characters that open the slash menu.",
+                "type": "string"
+              },
+              {
+                "name": "slashHeading",
+                "description": "The heading shown above the slash menu's items.",
+                "type": "string"
+              },
+              {
+                "name": "slashItemsProvider",
+                "description": "Resolves additional slash menu items each time the menu opens. JavaScript only.",
+                "type": "(query: string) => SlashMenuItem[] | Promise<SlashMenuItem[]> | undefined"
+              },
               {
                 "name": "grouped",
                 "description": "When true, hides the individual language navbar and defers language control to a parent zn-translation-group.",