@kubex/zinc 1.1.64 → 1.1.65

package/dist/custom-elements.json

@@ -24847,6 +24847,34 @@
               "static": true,
               "default": "{ 'zn-collapsible': ZnCollapsible, 'zn-icon': ZnIcon, 'zn-input': ZnInput, 'zn-page-palette-item': ZnPagePaletteItem, 'zn-page-section-card': ZnPageSectionCard, }"
             },
+            {
+              "kind": "field",
+              "name": "formControlController",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new FormControlController(this)"
+            },
+            {
+              "kind": "field",
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The name of the control, submitted as a name/value pair with form data.",
+              "attribute": "name"
+            },
+            {
+              "kind": "field",
+              "name": "form",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Associates the control with a form by id. The form must be in the same document or shadow root.",
+              "attribute": "form",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "config",
@@ -24973,7 +25001,7 @@
               "kind": "field",
               "name": "_slotDragOver",
               "type": {
-                "text": "{containerId: string; index: number} | null"
+                "text": "{ containerId: string; index: number } | null"
               },
               "privacy": "private",
               "default": "null",
@@ -24983,7 +25011,7 @@
               "kind": "field",
               "name": "_slotPicker",
               "type": {
-                "text": "{containerId: string; index: number} | null"
+                "text": "{ containerId: string; index: number } | null"
               },
               "privacy": "private",
               "default": "null",
@@ -25032,6 +25060,78 @@
               },
               "description": "Replaces the page state wholesale (does not emit zn-page-change)."
             },
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "description": "Replaces the page state from a JSON string (does not emit zn-page-change)."
+            },
+            {
+              "kind": "field",
+              "name": "defaultValue",
+              "description": "The serialised state of the last externally loaded page — restored on form reset."
+            },
+            {
+              "kind": "field",
+              "name": "validity",
+              "type": {
+                "text": "ValidityState"
+              },
+              "description": "Gets the validity state object.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "validationMessage",
+              "type": {
+                "text": "string"
+              },
+              "description": "Gets the validation message.",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "checkValidity",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "description": "Checks for validity but does not show a validation message."
+            },
+            {
+              "kind": "method",
+              "name": "getForm",
+              "return": {
+                "type": {
+                  "text": "HTMLFormElement | null"
+                }
+              },
+              "description": "Gets the associated form, if one exists."
+            },
+            {
+              "kind": "method",
+              "name": "reportValidity",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "description": "Checks for validity and shows the browser's validation message if the control is invalid."
+            },
+            {
+              "kind": "method",
+              "name": "setCustomValidity",
+              "parameters": [
+                {
+                  "name": "_message",
+                  "default": "''"
+                }
+              ],
+              "description": "Sets a custom validation message. Pass an empty string to restore validity."
+            },
             {
               "kind": "method",
               "name": "handleConfigChange"
@@ -25157,7 +25257,7 @@
               "kind": "field",
               "name": "_restorePrompt",
               "type": {
-                "text": "{savedAt: number} | null"
+                "text": "{ savedAt: number } | null"
               },
               "privacy": "private",
               "default": "null",
@@ -25195,7 +25295,7 @@
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "{savedAt: number; state: PageState} | null"
+                  "text": "{ savedAt: number; state: PageState } | null"
                 }
               },
               "description": "The stored auto-save, purging it when past its TTL (or unreadable)."
@@ -25690,7 +25790,7 @@
                 {
                   "name": "drop",
                   "type": {
-                    "text": "{over: (e: DragEvent) => void; drop: (e: DragEvent) => void}"
+                    "text": "{ over: (e: DragEvent) => void; drop: (e: DragEvent) => void }"
                   }
                 },
                 {
@@ -25887,6 +25987,24 @@
             }
           ],
           "attributes": [
+            {
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The name of the control, submitted as a name/value pair with form data.",
+              "fieldName": "name"
+            },
+            {
+              "name": "form",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Associates the control with a form by id. The form must be in the same document or shadow root.",
+              "fieldName": "form"
+            },
             {
               "name": "config",
               "type": {
@@ -31582,6 +31700,10 @@
             {
               "description": "The context menu opened by typing \"/\" in a block.",
               "name": "slash-menu"
+            },
+            {
+              "description": "The caption / alignment / size panel shown when an image block is clicked.",
+              "name": "image-controls"
             }
           ],
           "members": [
@@ -31674,25 +31796,25 @@
             },
             {
               "kind": "field",
-              "name": "imageDialogOpen",
+              "name": "imagePickerIndex",
               "type": {
-                "text": "boolean"
+                "text": "number | null"
               },
               "privacy": "private",
-              "default": "false"
+              "default": "null"
             },
             {
               "kind": "field",
-              "name": "dropIndicator",
+              "name": "imageEdit",
               "type": {
-                "text": "number | null"
+                "text": "ImageBlockData | null"
               },
               "privacy": "private",
               "default": "null"
             },
             {
               "kind": "field",
-              "name": "dragIndex",
+              "name": "dropIndicator",
               "type": {
                 "text": "number | null"
               },
@@ -31701,21 +31823,21 @@
             },
             {
               "kind": "field",
-              "name": "editShell",
+              "name": "dragIndex",
               "type": {
-                "text": "string"
+                "text": "number | null"
               },
               "privacy": "private",
-              "default": "''"
+              "default": "null"
             },
             {
               "kind": "field",
-              "name": "imageInsertIndex",
+              "name": "editShell",
               "type": {
-                "text": "number"
+                "text": "string"
               },
               "privacy": "private",
-              "default": "0"
+              "default": "''"
             },
             {
               "kind": "field",
@@ -31799,7 +31921,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Endpoint for image uploads. Posting the file metadata here must return\n`{uploadPath, uploadUrl}`; the file is then PUT to `uploadUrl` and\n`uploadPath` is inserted into the document. When unset, adding an image\nprompts for a URL instead.",
+              "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.",
               "attribute": "attachment-url"
             },
             {
@@ -32002,6 +32124,43 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "parseImageBlock",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "ImageBlockData | null"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "block",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Parses a block that is purely an image (with optional caption/align lines)."
+            },
+            {
+              "kind": "method",
+              "name": "serializeImageBlock",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "data",
+                  "type": {
+                    "text": "ImageBlockData"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "toggleCheckbox",
@@ -32041,6 +32200,44 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "updateImageEdit",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "patch",
+                  "type": {
+                    "text": "Partial<ImageBlockData>"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "saveImageEdit",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "closeImageEdit",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "deleteImageBlock",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "editImageSource",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "handleImageControlsKeydown",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "computeEditShell",
@@ -32084,6 +32281,19 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "deleteBlock",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "insertDraftBlock",
@@ -32247,12 +32457,12 @@
             },
             {
               "kind": "field",
-              "name": "handleImageDialogClose",
+              "name": "closeImagePicker",
               "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "handleImageInsert",
+              "name": "handleImagePicked",
               "privacy": "private"
             },
             {
@@ -32323,6 +32533,11 @@
               "name": "renderSlashMenu",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "renderImageControls",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "renderBlock",
@@ -32344,7 +32559,13 @@
             },
             {
               "kind": "method",
-              "name": "renderImageDialog",
+              "name": "renderBody",
+              "privacy": "private",
+              "description": "The block views, with the inline image picker spliced in when active."
+            },
+            {
+              "kind": "method",
+              "name": "renderImagePicker",
               "privacy": "private"
             }
           ],
@@ -32392,7 +32613,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Endpoint for image uploads. Posting the file metadata here must return\n`{uploadPath, uploadUrl}`; the file is then PUT to `uploadUrl` and\n`uploadPath` is inserted into the document. When unset, adding an image\nprompts for a URL instead.",
+              "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.",
               "fieldName": "attachmentUrl"
             },
             {
@@ -32431,7 +32652,7 @@
           "tagNameWithoutPrefix": "remarkd-editor",
           "tagName": "zn-remarkd-editor",
           "customElement": true,
-          "jsDoc": "/**\n * @summary A Notion-style block editor for remarkd content. Blocks render inline; click one to edit its source.\n * @documentation https://zinc.style/components/remarkd-editor\n * @status experimental\n * @since 1.0\n *\n * @dependency zn-button\n * @dependency zn-button-group\n * @dependency zn-icon\n * @dependency zn-dialog\n * @dependency zn-file\n * @dependency zn-input\n *\n * @event zn-input - Emitted on each keystroke while editing a block.\n * @event zn-change - Emitted when a block edit is committed and the value changes.\n *\n * @csspart base - The component's base wrapper.\n * @csspart toolbar - The always-visible block-insert toolbar.\n * @csspart block - A rendered block wrapper.\n * @csspart rendered - The rendered remarkd output of a block.\n * @csspart input - The textarea shown while editing a block.\n * @csspart slash-menu - The context menu opened by typing \"/\" in a block.\n */",
+          "jsDoc": "/**\n * @summary A Notion-style block editor for remarkd content. Blocks render inline; click one to edit its source.\n * @documentation https://zinc.style/components/remarkd-editor\n * @status experimental\n * @since 1.0\n *\n * @dependency zn-button\n * @dependency zn-button-group\n * @dependency zn-icon\n * @dependency zn-file\n *\n * @event zn-input - Emitted on each keystroke while editing a block.\n * @event zn-change - Emitted when a block edit is committed and the value changes.\n *\n * @csspart base - The component's base wrapper.\n * @csspart toolbar - The always-visible block-insert toolbar.\n * @csspart block - A rendered block wrapper.\n * @csspart rendered - The rendered remarkd output of a block.\n * @csspart input - The textarea shown while editing a block.\n * @csspart slash-menu - The context menu opened by typing \"/\" in a block.\n * @csspart image-controls - The caption / alignment / size panel shown when an image block is clicked.\n */",
           "documentation": "https://zinc.style/components/remarkd-editor",
           "status": "experimental",
           "since": "1.0",
@@ -32439,9 +32660,7 @@
             "zn-button",
             "zn-button-group",
             "zn-icon",
-            "zn-dialog",
-            "zn-file",
-            "zn-input"
+            "zn-file"
           ]
         }
       ],
@@ -42082,7 +42301,7 @@
   "package": {
     "name": "@kubex/zinc",
     "description": "A collection of web components for building web applications based off of @shoelace-style/Shoelace",
-    "version": "1.1.64",
+    "version": "1.1.65",
     "author": "",
     "license": "MIT"
   }

package/dist/vscode.html-custom-data.json

@@ -2646,8 +2646,18 @@
     },
     {
       "name": "zn-page-builder",
-      "description": "A config-driven page composer: a palette of predefined section types, a linear\ncanvas of section cards, and an inspector for editing each section's content.\n---\n\n\n### **Events:**\n - **zn-page-change** - Emitted whenever the page state changes. `event.detail.state` is the new PageState.\n- **zn-page-selection-change** - Emitted when the selected section changes. `event.detail.sectionId`.\n\n### **Methods:**\n - **addSection(type: _string_, index: _number_): _PageSection | null_** - Adds a section of a registered type at `index` (default: end). Returns null for unknown types.\n- **addSectionToSlot(type: _string_, containerId: _string_, slotIndex: _number_): _PageSection | null_** - Adds a new section of a registered type into a container's slot. Returns null if not allowed.\n\n### **Slots:**\n - **config** - `<template type=\"…\">` declarations; never displayed. Each template's attributes (type, label, icon, icon-library, color, category, description, slots, accepts) declare a palette entry and its content declares the inspector form for that type. `slots` makes the section a container with that many child slots; `accepts` is a comma-separated list of the type keys its slots allow.\n- **header-left** - Actions shown on the left of the header bar.\n- **header-right** - Actions shown on the right of the header bar.\n\n### **CSS Parts:**\n - **base** - The grid wrapper.\n- **header** - The full-width header action bar (only rendered when header slots are filled).\n- **palette** - The left palette panel.\n- **canvas** - The centre section-card canvas.\n- **inspector** - The right panel while a section is selected.",
+      "description": "A config-driven page composer: a palette of predefined section types, a linear\ncanvas of section cards, and an inspector for editing each section's content.\n---\n\n\n### **Events:**\n - **zn-page-change** - Emitted whenever the page state changes. `event.detail.state` is the new PageState.\n- **zn-page-selection-change** - Emitted when the selected section changes. `event.detail.sectionId`.\n\n### **Methods:**\n - **checkValidity(): _boolean_** - Checks for validity but does not show a validation message.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity(): _boolean_** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(_message)** - Sets a custom validation message. Pass an empty string to restore validity.\n- **addSection(type: _string_, index: _number_): _PageSection | null_** - Adds a section of a registered type at `index` (default: end). Returns null for unknown types.\n- **addSectionToSlot(type: _string_, containerId: _string_, slotIndex: _number_): _PageSection | null_** - Adds a new section of a registered type into a container's slot. Returns null if not allowed.\n\n### **Slots:**\n - **config** - `<template type=\"…\">` declarations; never displayed. Each template's attributes (type, label, icon, icon-library, color, category, description, slots, accepts) declare a palette entry and its content declares the inspector form for that type. `slots` makes the section a container with that many child slots; `accepts` is a comma-separated list of the type keys its slots allow.\n- **header-left** - Actions shown on the left of the header bar.\n- **header-right** - Actions shown on the right of the header bar.\n\n### **CSS Parts:**\n - **base** - The grid wrapper.\n- **header** - The full-width header action bar (only rendered when header slots are filled).\n- **palette** - The left palette panel.\n- **canvas** - The centre section-card canvas.\n- **inspector** - The right panel while a section is selected.",
       "attributes": [
+        {
+          "name": "name",
+          "description": "The name of the control, submitted as a name/value pair with form data.",
+          "values": []
+        },
+        {
+          "name": "form",
+          "description": "Associates the control with a form by id. The form must be in the same document or shadow root.",
+          "values": []
+        },
         {
           "name": "config",
           "description": "The page state as a JSON string. Parsed on set; invalid JSON is ignored with a warning.",
@@ -3255,7 +3265,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.",
+      "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.",
       "attributes": [
         {
           "name": "name",
@@ -3274,7 +3284,7 @@
         },
         {
           "name": "attachment-url",
-          "description": "Endpoint for image uploads. Posting the file metadata here must return\n`{uploadPath, uploadUrl}`; the file is then PUT to `uploadUrl` and\n`uploadPath` is inserted into the document. When unset, adding an image\nprompts for a URL instead.",
+          "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.",
           "values": []
         },
         {

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.64",
+  "version": "1.1.65",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -6234,9 +6234,19 @@
         },
         {
           "name": "zn-page-builder",
-          "description": "A config-driven page composer: a palette of predefined section types, a linear\ncanvas of section cards, and an inspector for editing each section's content.\n---\n\n\n### **Events:**\n - **zn-page-change** - Emitted whenever the page state changes. `event.detail.state` is the new PageState.\n- **zn-page-selection-change** - Emitted when the selected section changes. `event.detail.sectionId`.\n\n### **Methods:**\n - **addSection(type: _string_, index: _number_): _PageSection | null_** - Adds a section of a registered type at `index` (default: end). Returns null for unknown types.\n- **addSectionToSlot(type: _string_, containerId: _string_, slotIndex: _number_): _PageSection | null_** - Adds a new section of a registered type into a container's slot. Returns null if not allowed.\n\n### **Slots:**\n - **config** - `<template type=\"…\">` declarations; never displayed. Each template's attributes (type, label, icon, icon-library, color, category, description, slots, accepts) declare a palette entry and its content declares the inspector form for that type. `slots` makes the section a container with that many child slots; `accepts` is a comma-separated list of the type keys its slots allow.\n- **header-left** - Actions shown on the left of the header bar.\n- **header-right** - Actions shown on the right of the header bar.\n\n### **CSS Parts:**\n - **base** - The grid wrapper.\n- **header** - The full-width header action bar (only rendered when header slots are filled).\n- **palette** - The left palette panel.\n- **canvas** - The centre section-card canvas.\n- **inspector** - The right panel while a section is selected.",
+          "description": "A config-driven page composer: a palette of predefined section types, a linear\ncanvas of section cards, and an inspector for editing each section's content.\n---\n\n\n### **Events:**\n - **zn-page-change** - Emitted whenever the page state changes. `event.detail.state` is the new PageState.\n- **zn-page-selection-change** - Emitted when the selected section changes. `event.detail.sectionId`.\n\n### **Methods:**\n - **checkValidity(): _boolean_** - Checks for validity but does not show a validation message.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity(): _boolean_** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(_message)** - Sets a custom validation message. Pass an empty string to restore validity.\n- **addSection(type: _string_, index: _number_): _PageSection | null_** - Adds a section of a registered type at `index` (default: end). Returns null for unknown types.\n- **addSectionToSlot(type: _string_, containerId: _string_, slotIndex: _number_): _PageSection | null_** - Adds a new section of a registered type into a container's slot. Returns null if not allowed.\n\n### **Slots:**\n - **config** - `<template type=\"…\">` declarations; never displayed. Each template's attributes (type, label, icon, icon-library, color, category, description, slots, accepts) declare a palette entry and its content declares the inspector form for that type. `slots` makes the section a container with that many child slots; `accepts` is a comma-separated list of the type keys its slots allow.\n- **header-left** - Actions shown on the left of the header bar.\n- **header-right** - Actions shown on the right of the header bar.\n\n### **CSS Parts:**\n - **base** - The grid wrapper.\n- **header** - The full-width header action bar (only rendered when header slots are filled).\n- **palette** - The left palette panel.\n- **canvas** - The centre section-card canvas.\n- **inspector** - The right panel while a section is selected.",
           "doc-url": "",
           "attributes": [
+            {
+              "name": "name",
+              "description": "The name of the control, submitted as a name/value pair with form data.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "form",
+              "description": "Associates the control with a form by id. The form must be in the same document or shadow root.",
+              "value": { "type": "string", "default": "''" }
+            },
             {
               "name": "config",
               "description": "The page state as a JSON string. Parsed on set; invalid JSON is ignored with a warning.",
@@ -6292,6 +6302,16 @@
           ],
           "js": {
             "properties": [
+              {
+                "name": "name",
+                "description": "The name of the control, submitted as a name/value pair with form data.",
+                "type": "string"
+              },
+              {
+                "name": "form",
+                "description": "Associates the control with a form by id. The form must be in the same document or shadow root.",
+                "type": "string"
+              },
               {
                 "name": "config",
                 "description": "The page state as a JSON string. Parsed on set; invalid JSON is ignored with a warning.",
@@ -6324,6 +6344,25 @@
                 "description": "Replaces the page state wholesale (does not emit zn-page-change).",
                 "type": "PageState"
               },
+              {
+                "name": "value",
+                "description": "Replaces the page state from a JSON string (does not emit zn-page-change).",
+                "type": "string"
+              },
+              {
+                "name": "defaultValue",
+                "description": "The serialised state of the last externally loaded page — restored on form reset."
+              },
+              {
+                "name": "validity",
+                "description": "Gets the validity state object.",
+                "type": "ValidityState"
+              },
+              {
+                "name": "validationMessage",
+                "description": "Gets the validation message.",
+                "type": "string"
+              },
               {
                 "name": "restoreAutoSave",
                 "description": "Load the auto-saved page, if one exists within the 1-day TTL."
@@ -7591,7 +7630,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.",
+          "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.",
           "doc-url": "",
           "attributes": [
             {
@@ -7611,7 +7650,7 @@
             },
             {
               "name": "attachment-url",
-              "description": "Endpoint for image uploads. Posting the file metadata here must return\n`{uploadPath, uploadUrl}`; the file is then PUT to `uploadUrl` and\n`uploadPath` is inserted into the document. When unset, adding an image\nprompts for a URL instead.",
+              "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": "''" }
             },
             {
@@ -7664,7 +7703,7 @@
               },
               {
                 "name": "attachmentUrl",
-                "description": "Endpoint for image uploads. Posting the file metadata here must return\n`{uploadPath, uploadUrl}`; the file is then PUT to `uploadUrl` and\n`uploadPath` is inserted into the document. When unset, adding an image\nprompts for a URL instead.",
+                "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"
               },
               {