@rcarls/rc-textarea 0.1.0 → 0.3.0

package/dist/custom-elements.json

@@ -86,7 +86,7 @@
         },
         {
           "kind": "function",
-          "name": "mapOrClear",
+          "name": "remapDecorations",
           "return": {
             "type": {
               "text": "Decoration[]"
@@ -119,7 +119,7 @@
           "name": "addDecoration",
           "return": {
             "type": {
-              "text": "string"
+              "text": ""
             }
           },
           "parameters": [
@@ -136,7 +136,7 @@
               }
             }
           ],
-          "description": "Add a single decoration to `map`, assigning it a fresh UUID as its `id`.\nReturns the assigned ID."
+          "description": "Add a single decoration to `map`, assigning it a fresh UUID as its `id`."
         },
         {
           "kind": "function",
@@ -198,9 +198,9 @@
         },
         {
           "kind": "js",
-          "name": "mapOrClear",
+          "name": "remapDecorations",
           "declaration": {
-            "name": "mapOrClear",
+            "name": "remapDecorations",
             "module": "src/decoration.ts"
           }
         },
@@ -268,17 +268,17 @@
         {
           "kind": "class",
           "description": "",
-          "name": "V2Document",
+          "name": "RCDocument",
           "members": [
             {
               "kind": "field",
               "name": "scroll",
               "type": {
-                "text": "V2ScrollBlot"
+                "text": "RCScrollBlot"
               },
               "privacy": "private",
               "readonly": true,
-              "default": "new V2ScrollBlot(registry, editorEl)"
+              "default": "new RCScrollBlot(registry, $documentRoot)"
             },
             {
               "kind": "method",
@@ -302,7 +302,7 @@
                   }
                 }
               ],
-              "description": "Rebuild the document tree from `value` + `decorations`.\nReuses existing `.v2-line` elements in place to preserve DOM identity\nacross renders (fixes DevTools node tracking and mouse gesture continuity).\nOnly the children of each line are replaced; the line element itself survives."
+              "description": "Rebuild the document tree.\n\nReuses existing `.line` elements in place to preserve DOM identity\nacross renders (fixes DevTools node tracking and mouse gesture continuity)."
             },
             {
               "kind": "method",
@@ -317,7 +317,7 @@
         },
         {
           "kind": "function",
-          "name": "extractEditorText",
+          "name": "getText",
           "return": {
             "type": {
               "text": "string"
@@ -325,29 +325,29 @@
           },
           "parameters": [
             {
-              "name": "editorEl",
+              "name": "$editorEl",
               "type": {
                 "text": "HTMLElement"
               }
             }
           ],
-          "description": "Extracts plain text directly from the editor's contenteditable DOM.\nHandles our structured .v2-line divs as well as browser-inserted markup\nfrom edits that happen between render frames."
+          "description": "Extracts plain text directly from the contenteditable DOM."
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "V2Document",
+          "name": "RCDocument",
           "declaration": {
-            "name": "V2Document",
+            "name": "RCDocument",
             "module": "src/document.ts"
           }
         },
         {
           "kind": "js",
-          "name": "extractEditorText",
+          "name": "getText",
           "declaration": {
-            "name": "extractEditorText",
+            "name": "getText",
             "module": "src/document.ts"
           }
         }
@@ -772,7 +772,7 @@
               }
             }
           ],
-          "description": "Factory that wraps a `LineDecoratorPlugin` in a full `RCTextareaPlugin`.\n\nHandles the boilerplate that every per-line decorator needs:\n- CSS injection via `api.adoptStyleSheet` on mount\n- `lineStart` offset bookkeeping when converting line-relative offsets to\n  absolute document offsets\n- Subscribing to external change signals and calling `api.scheduleUpdate()`\n- Cleanup of subscribers on destroy"
+          "description": "Factory that wraps a `LineDecoratorPlugin` in a full `RCTextareaPlugin`.\n\nHandles the boilerplate that every per-line decorator needs:\n\n- CSS injection via `api.adoptStyleSheet` on mount\n- `lineStart` offset bookkeeping when converting line-relative offsets to\n  absolute document offsets\n- Subscribing to external change signals and calling `api.scheduleUpdate()`\n- Cleanup of subscribers on destroy"
         }
       ],
       "exports": [
@@ -795,7 +795,7 @@
           "name": "matchPatternResults",
           "return": {
             "type": {
-              "text": "{ markDecorations: Omit<MarkDecoration, 'id'>[]; lineDecorations: Omit<LineDecoration, 'id'>[] }"
+              "text": "{\n  markDecorations: Omit<MarkDecoration, 'id'>[];\n  lineDecorations: Omit<LineDecoration, 'id'>[];\n}"
             }
           },
           "parameters": [
@@ -812,7 +812,7 @@
               }
             }
           ],
-          "description": "Run all `patterns` against `value` and collect every match as decorations.\n\nFor each pattern:\n- If `captureGroups` is set, one `MarkDecoration` is emitted **per named\n  capture group** instead of one for the whole match. Unmatched optional\n  groups are silently skipped. The `d` flag (match indices) is added to\n  the regex automatically.\n- Otherwise, one `MarkDecoration` covering the entire match is emitted,\n  using the styling fields copied directly from the pattern.\n- If `createLineDecoration` is provided, it is called for every match\n  (regardless of `captureGroups`) and may produce a paired `LineDecoration`.\n\nThe global flag is added automatically if missing to ensure all occurrences\nare found and to avoid stateful `lastIndex` bugs on the caller's regex.\nZero-length matches are skipped to prevent infinite loops."
+          "description": "Run all `patterns` against `value` and collect every match as decorations.\n\nFor each pattern:\n\n- If `captureGroups` is set, one `MarkDecoration` is emitted per named\n  capture group instead of one for the whole match. Unmatched optional\n  groups are silently skipped. The `d` flag (match indices) is added to\n  the regex automatically.\n- Otherwise, one `MarkDecoration` covering the entire match is emitted,\n  using the styling fields copied directly from the pattern.\n- If `createLineDecoration` is provided, it is called for every match\n  (regardless of `captureGroups`) and may produce a paired `LineDecoration`.\n\nThe global flag is added automatically if missing to ensure all occurrences\nare found and to avoid stateful `lastIndex` bugs on the caller's regex.\n\nZero-length matches are skipped to prevent infinite loops."
         }
       ],
       "exports": [
@@ -840,21 +840,21 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Enhanced textarea with line decorations, gutter, and plugin API.",
+          "description": "Textarea wrapper with line decorations, gutter rendering, inline widgets, and plugin hooks.\n\nProvide a native `<textarea>` as the direct child when the component is\neditable. Read-only displays may be driven from `value` or `defaultValue`.",
           "name": "RCTextarea",
           "cssProperties": [
             {
-              "description": "Border around the editor",
+              "description": "Border around the field",
               "name": "--rc-textarea-border",
               "default": "1px solid ButtonBorder"
             },
             {
-              "description": "Border radius of the editor",
+              "description": "Border radius of the field",
               "name": "--rc-textarea-border-radius",
               "default": "2px"
             },
             {
-              "description": "Background color of the editor",
+              "description": "Background color of the field",
               "name": "--rc-textarea-background",
               "default": "Field"
             },
@@ -879,7 +879,7 @@
               "default": "1.5"
             },
             {
-              "description": "Padding inside the editor area",
+              "description": "Padding inside the field area",
               "name": "--rc-textarea-padding",
               "default": "0.5em"
             },
@@ -916,7 +916,7 @@
           ],
           "slots": [
             {
-              "description": "Accepts a native `<textarea>` element for form wiring and progressive enhancement.",
+              "description": "Accepts a native `<textarea>` element for form wiring.",
               "name": ""
             }
           ],
@@ -937,6 +937,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Show sequential line numbers in the gutter. Enables the gutter implicitly.",
               "attribute": "line-numbers",
               "reflects": true
             },
@@ -946,10 +947,19 @@
               "type": {
                 "text": "boolean"
               },
-              "default": "false",
+              "deprecated": "Use a plugin with `LineDecoration.gutterContent` to implement\nsparse line numbering. This property will be removed before v1.0.",
               "attribute": "list-numbers",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "_listNumbers",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
             {
               "kind": "field",
               "name": "gutter",
@@ -957,6 +967,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Enable the gutter column without any built-in content.\n\nPlugins can populate individual cells via `LineDecoration.gutterContent`.\nFor sequential line numbers use `lineNumbers` / `line-numbers` instead.",
               "attribute": "gutter",
               "reflects": true
             },
@@ -967,6 +978,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Wrap long lines within the field to prevent horizontal overflow.",
               "attribute": "word-wrap",
               "reflects": true
             },
@@ -977,6 +989,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Allow the field to grow vertically with content to prevent vertical overflow.",
               "attribute": "auto-grow",
               "reflects": true
             },
@@ -987,6 +1000,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Disable editing. The field renders as a styled read-only display.",
               "attribute": "read-only",
               "reflects": true
             },
@@ -996,9 +1010,18 @@
               "type": {
                 "text": "string | null"
               },
-              "default": "null",
+              "deprecated": "Set `aria-label` on the slotted `<textarea>` instead, or\nassociate a `<label>` element via its `for`/`id` pair. This property\nwill be removed before v1.0.",
               "attribute": "label"
             },
+            {
+              "kind": "field",
+              "name": "_label",
+              "type": {
+                "text": "string | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
             {
               "kind": "field",
               "name": "plugin",
@@ -1013,7 +1036,31 @@
               "type": {
                 "text": "DecorationInput[]"
               },
-              "description": "Reactive decorations — set from outside the component without registering a plugin.\nIdeal for reactive frameworks (Solid, React 19+, Vue 3) where decorations are\ncomputed as reactive state and passed directly as a property:\n\n```tsx\n// Solid\n<rc-textarea decorations={decorations()} />\n\n// React 19+\n<rc-textarea decorations={decorations} />\n```\n\nMerges with plugin decorations and pattern decorations on every render.\nSetting this property triggers a new render; setting it to `undefined` or `[]`\nclears any previously set external decorations."
+              "description": "Imperatively set an external layer of decorations. Ideal for reactive frameworks.\n\n```tsx\n// Solid\n<rc-textarea decorations={decorations()} />\n\n// React 19+\n<rc-textarea decorations={decorations} />\n```\n\nMerges with plugin decorations and pattern decorations on every render.\nSetting this property triggers a new render; setting it to `undefined` or `[]`\nclears any previously set external decorations."
+            },
+            {
+              "kind": "field",
+              "name": "_$editor",
+              "type": {
+                "text": "HTMLElement"
+              },
+              "privacy": "protected"
+            },
+            {
+              "kind": "field",
+              "name": "_$gutterCells",
+              "type": {
+                "text": "HTMLElement"
+              },
+              "privacy": "protected"
+            },
+            {
+              "kind": "field",
+              "name": "_$slot",
+              "type": {
+                "text": "HTMLSlotElement"
+              },
+              "privacy": "protected"
             },
             {
               "kind": "field",
@@ -1054,26 +1101,33 @@
               "kind": "field",
               "name": "_document",
               "type": {
-                "text": "V2Document | null"
+                "text": "RCDocument | null"
               },
               "privacy": "private",
               "default": "null"
             },
             {
               "kind": "field",
-              "name": "_textareaRef",
+              "name": "_$textareaRef",
               "type": {
                 "text": "WeakRef<HTMLTextAreaElement> | null"
               },
               "privacy": "private",
               "default": "null"
             },
+            {
+              "kind": "field",
+              "name": "_textareaController",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new NativeChildController<HTMLTextAreaElement>(this, { selector: ':scope > textarea', observe: true, onChange: ($textarea, $previousTextarea) => this._setupTextarea($textarea, $previousTextarea), onMissing: () => { if (import.meta.env.DEV && !this.readOnly) { warnMissingDirectChild(this, { selector: ':scope > textarea', message: '[rc-textarea] No direct child <textarea> found. Place a native <textarea> inside <rc-textarea>.', }); } }, })"
+            },
             {
               "kind": "field",
               "name": "_pluginDecorations",
               "privacy": "protected",
               "default": "new Map<string, Decoration>()",
-              "description": "Plugin-owned decorations (set via PluginAPI.setDecorations / addDecoration)."
+              "description": "Plugin-owned decorations"
             },
             {
               "kind": "field",
@@ -1093,7 +1147,7 @@
               },
               "privacy": "private",
               "default": "[]",
-              "description": "Decorations set directly via the `decorations` property (reactive-framework-friendly)."
+              "description": "Imperative decorations (set directly via the `decorations` property)"
             },
             {
               "kind": "field",
@@ -1184,13 +1238,13 @@
             },
             {
               "kind": "field",
-              "name": "_activeLine",
+              "name": "_$activeLine",
               "type": {
                 "text": "HTMLElement | null"
               },
               "privacy": "private",
               "default": "null",
-              "description": "The currently highlighted `.v2-line` element (active line)."
+              "description": "The currently highlighted `.line` element (active line)."
             },
             {
               "kind": "field",
@@ -1212,7 +1266,7 @@
               },
               "privacy": "private",
               "default": "[]",
-              "description": "Undo/redo stack — necessary because DOM rebuilds invalidate browser's native undo."
+              "description": "Synthetic undo/redo stack (DOM rebuilds invalidate native undo)"
             },
             {
               "kind": "field",
@@ -1248,6 +1302,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "The current field value.\n\nSetting this property puts the component into\ncontrolled mode (host owns the value, changes are reflected\nimmediately, no change events dispatched)",
               "attribute": "value"
             },
             {
@@ -1256,7 +1311,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Initial uncontrolled editor value.",
+              "description": "Initial uncontrolled value.",
               "attribute": "defaultValue"
             },
             {
@@ -1269,6 +1324,36 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "_setupTextarea",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "$textarea",
+                  "type": {
+                    "text": "HTMLTextAreaElement | null"
+                  }
+                },
+                {
+                  "name": "$previousTextarea",
+                  "optional": true,
+                  "type": {
+                    "text": "HTMLTextAreaElement | null"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "_onTextareaInvalid",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "_bindEditorEvents",
@@ -1280,7 +1365,7 @@
               },
               "parameters": [
                 {
-                  "name": "editorEl",
+                  "name": "$editor",
                   "type": {
                     "text": "HTMLElement"
                   }
@@ -1405,7 +1490,7 @@
                   "text": "void"
                 }
               },
-              "description": "Reset the undo/redo history. Call when the editor receives entirely new content."
+              "description": "Reset the undo/redo history. Call when the field receives entirely new content."
             },
             {
               "kind": "method",
@@ -1478,7 +1563,8 @@
                     "text": "RCTextareaPlugin"
                   }
                 }
-              ]
+              ],
+              "description": "Register and mount a plugin imperatively.\nReplaces any currently active plugin. Prefer the `plugin` property for\nreactive-framework integrations."
             },
             {
               "kind": "method",
@@ -1487,7 +1573,8 @@
                 "type": {
                   "text": "void"
                 }
-              }
+              },
+              "description": "Unmount the active plugin, clear its decorations, and release its stylesheets."
             },
             {
               "kind": "method",
@@ -1525,7 +1612,8 @@
                     "text": "Omit<TextPattern, 'id'>"
                   }
                 }
-              ]
+              ],
+              "description": "Register a text pattern that generates decorations on every render pass.\nReturns the pattern ID, which can be passed to `removePattern` to unregister it."
             },
             {
               "kind": "method",
@@ -1542,7 +1630,8 @@
                     "text": "string"
                   }
                 }
-              ]
+              ],
+              "description": "Remove a previously registered pattern by the ID returned from `addPattern`."
             },
             {
               "kind": "method",
@@ -1551,7 +1640,8 @@
                 "type": {
                   "text": "void"
                 }
-              }
+              },
+              "description": "Remove all registered patterns and trigger a re-render."
             },
             {
               "kind": "method",
@@ -1594,7 +1684,7 @@
                   "default": "this._value"
                 }
               ],
-              "description": "Compute the label string for each gutter cell based on the current gutter\nmode (`lineNumbers`, `listNumbers`, `gutter`) and any\n`LineDecoration.gutterContent` overrides in `allDecorations`.\n\nReturns one entry per line (same length as `value.split('\\n')`):\n- `string` — the label to display\n- `null`   — render an empty cell"
+              "description": "Compute the label string for each gutter cell based on the current gutter\nmode (`lineNumbers`, `listNumbers` (deprecated), `gutter`) and any\n`LineDecoration.gutterContent` overrides in `allDecorations`.\n\nReturns one entry per line (same length as `value.split('\\n')`):\n- `string` — the label to display\n- `null`   — render an empty cell"
             },
             {
               "kind": "method",
@@ -1605,7 +1695,7 @@
                   "text": "void"
                 }
               },
-              "description": "Synchronize the pixel height of each gutter cell to match the\ncorresponding `.v2-line` element in the editor.\n\nIn non-word-wrap mode the gutter uses a uniform `line-height` mirrored\nfrom the editor's first line. In word-wrap mode each cell gets an explicit\n`height` so wrapped lines stay vertically aligned with their gutter label.\nAlso copies the editor's computed `paddingTop`/`paddingBottom` to the\ngutter to compensate for browser UA overrides on contenteditable."
+              "description": "Synchronize the pixel height of each gutter cell to match the\ncorresponding `.line` element in the editor.\n\nIn non-word-wrap mode the gutter uses a uniform `line-height` mirrored\nfrom the editor's first line. In word-wrap mode each cell gets an explicit\n`height` so wrapped lines stay vertically aligned with their gutter label.\nAlso copies the editor's computed `paddingTop`/`paddingBottom` to the\ngutter to compensate for browser UA overrides on contenteditable."
             },
             {
               "kind": "method",
@@ -1627,6 +1717,16 @@
               ],
               "description": "Add, remove, or update `.gutter-cell` spans so their count and text\ncontent match `labels`. When `labels` is provided the cached\n`_gutterLabels` is updated first; otherwise the cached labels are reused\n(called by the `ResizeObserver` without a new render pass)."
             },
+            {
+              "kind": "method",
+              "name": "_syncLabel",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "_syncTypography",
@@ -1638,7 +1738,7 @@
               },
               "parameters": [
                 {
-                  "name": "textarea",
+                  "name": "$textarea",
                   "type": {
                     "text": "HTMLTextAreaElement"
                   }
@@ -1678,16 +1778,6 @@
                   }
                 }
               ]
-            },
-            {
-              "kind": "method",
-              "name": "_getEditorEl",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "HTMLElement | null"
-                }
-              }
             }
           ],
           "events": [
@@ -1702,14 +1792,14 @@
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired when the editor loses focus"
+              "description": "Fired when the field loses focus"
             },
             {
               "name": "rc-textarea-change",
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired when the editor value changes"
+              "description": "Fired when the field value changes"
             }
           ],
           "attributes": [
@@ -1719,6 +1809,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Show sequential line numbers in the gutter. Enables the gutter implicitly.",
               "fieldName": "lineNumbers"
             },
             {
@@ -1726,7 +1817,7 @@
               "type": {
                 "text": "boolean"
               },
-              "default": "false",
+              "deprecated": "Use a plugin with `LineDecoration.gutterContent` to implement\nsparse line numbering. This property will be removed before v1.0.",
               "fieldName": "listNumbers"
             },
             {
@@ -1735,6 +1826,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Enable the gutter column without any built-in content.\n\nPlugins can populate individual cells via `LineDecoration.gutterContent`.\nFor sequential line numbers use `lineNumbers` / `line-numbers` instead.",
               "fieldName": "gutter"
             },
             {
@@ -1743,6 +1835,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Wrap long lines within the field to prevent horizontal overflow.",
               "fieldName": "wordWrap"
             },
             {
@@ -1751,6 +1844,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Allow the field to grow vertically with content to prevent vertical overflow.",
               "fieldName": "autoGrow"
             },
             {
@@ -1759,6 +1853,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Disable editing. The field renders as a styled read-only display.",
               "fieldName": "readOnly"
             },
             {
@@ -1766,7 +1861,7 @@
               "type": {
                 "text": "string | null"
               },
-              "default": "null",
+              "deprecated": "Set `aria-label` on the slotted `<textarea>` instead, or\nassociate a `<label>` element via its `for`/`id` pair. This property\nwill be removed before v1.0.",
               "fieldName": "label"
             },
             {
@@ -1774,6 +1869,7 @@
               "type": {
                 "text": "string"
               },
+              "description": "The current field value.\n\nSetting this property puts the component into\ncontrolled mode (host owns the value, changes are reflected\nimmediately, no change events dispatched)",
               "fieldName": "value"
             },
             {
@@ -1781,7 +1877,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Initial uncontrolled editor value.",
+              "description": "Initial uncontrolled value.",
               "fieldName": "defaultValue"
             }
           ],
@@ -1818,13 +1914,13 @@
           },
           "parameters": [
             {
-              "name": "root",
+              "name": "$root",
               "type": {
                 "text": "Element"
               }
             },
             {
-              "name": "targetNode",
+              "name": "$targetNode",
               "type": {
                 "text": "Node"
               }
@@ -1836,7 +1932,7 @@
               }
             }
           ],
-          "description": "Converts a DOM (node, nodeOffset) pair inside `root` to a plain-text offset.\nReturns -1 if the target was not found inside root."
+          "description": "Converts a DOM (node, nodeOffset) pair inside `$root` to a plain-text offset.\nReturns the end-of-content offset if the target was not found inside `$root`."
         },
         {
           "kind": "function",
@@ -1848,7 +1944,7 @@
           },
           "parameters": [
             {
-              "name": "root",
+              "name": "$root",
               "type": {
                 "text": "Element"
               }
@@ -1860,7 +1956,7 @@
               }
             }
           ],
-          "description": "Converts a plain-text offset to a (node, nodeOffset) DOM position inside `root`.\nReturns null if offset is out of range."
+          "description": "Converts a plain-text offset to a (node, nodeOffset) DOM position inside `$root`.\n\nReturns null if offset is out of range."
         },
         {
           "kind": "function",
@@ -1872,13 +1968,13 @@
           },
           "parameters": [
             {
-              "name": "root",
+              "name": "$root",
               "type": {
                 "text": "Element"
               }
             }
           ],
-          "description": "Captures the current browser selection as plain-text offsets relative to `root`.\nReturns null if there is no selection or the selection is outside `root`."
+          "description": "Captures the current browser selection as plain-text offsets relative to `$root`.\n\nReturns null if there is no selection or the selection is outside `$root`."
         },
         {
           "kind": "function",
@@ -1890,7 +1986,7 @@
           },
           "parameters": [
             {
-              "name": "root",
+              "name": "$root",
               "type": {
                 "text": "Element"
               }
@@ -1902,7 +1998,7 @@
               }
             }
           ],
-          "description": "Restores a previously saved selection inside `root`.\nSilently does nothing if the saved offsets are out of range."
+          "description": "Restores a previously saved selection inside `$root`.\n\nSilently does nothing if the saved offsets are out of range."
         }
       ],
       "exports": [
@@ -2015,7 +2111,7 @@
           },
           "parameters": [
             {
-              "name": "editor",
+              "name": "$editor",
               "type": {
                 "text": "HTMLElement"
               }
@@ -2027,7 +2123,7 @@
               }
             }
           ],
-          "description": "Dispatches a synthetic paste event carrying plain text onto `editor`.\n\nUsing a plain Event + manual clipboardData override because `new ClipboardEvent`\nwith a DataTransfer in the init dict is not reliable across browsers (Firefox\nignores the init's clipboardData). The paste handler only calls\n`e.clipboardData?.getData('text/plain')`, so a minimal duck-typed mock is enough."
+          "description": "Dispatches a synthetic paste event carrying plain text onto `$editor`.\n\nUsing a plain Event + manual clipboardData override because `new ClipboardEvent`\nwith a DataTransfer in the init dict is not reliable across browsers (Firefox\nignores the init's clipboardData).\n\nThe paste handler only calls `e.clipboardData?.getData('text/plain')`, so\na minimal duck-typed mock is enough."
         }
       ],
       "exports": [