@rcarls/rc-textarea 0.1.0

package/dist/custom-elements.json

@@ -0,0 +1,2103 @@
+{
+  "schemaVersion": "1.0.0",
+  "readme": "",
+  "modules": [
+    {
+      "kind": "javascript-module",
+      "path": "src/decoration.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "findEdit",
+          "return": {
+            "type": {
+              "text": "Edit"
+            }
+          },
+          "parameters": [
+            {
+              "name": "oldValue",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "newValue",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Find the single contiguous edit region that transforms `oldValue` into\n`newValue` by trimming equal prefix and suffix.\n\nThis is a heuristic (\"longest common prefix/suffix\"), not a full LCS diff.\nIt assumes the browser makes one contiguous edit per input event, which holds\ntrue for normal typing, deletion, and paste."
+        },
+        {
+          "kind": "function",
+          "name": "mapDecorationsThroughChange",
+          "return": {
+            "type": {
+              "text": "Decoration[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "decorations",
+              "type": {
+                "text": "Decoration[]"
+              }
+            },
+            {
+              "name": "oldValue",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "newValue",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Remap all decorations in `decorations` from positions in `oldValue` to\npositions in `newValue`, assuming a single contiguous edit.\n\n- `MarkDecoration`: remapped via `remapMarkRange`; dropped if collapsed.\n- `LineDecoration`: dropped if its line falls within the deleted region;\n  otherwise shifted by the line delta.\n- `WidgetDecoration`: treated like a zero-width mark at its offset.\n\nReturns a new array. The input array and its elements are not mutated."
+        },
+        {
+          "kind": "function",
+          "name": "isLargeChange",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "oldValue",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "edit",
+              "type": {
+                "text": "Edit"
+              }
+            }
+          ],
+          "description": "Heuristic: returns `true` when an edit is large enough that remapping\ndecorations would likely produce incorrect results and it's better to\nclear them entirely.\n\nThreshold: the change affects > 50 characters **and** > 50% of the document.\nThis covers paste of large blocks, select-all + type, and programmatic value\nsets with substantially different content. It deliberately ignores inserts\ninto an empty document (no existing decorations to preserve)."
+        },
+        {
+          "kind": "function",
+          "name": "mapOrClear",
+          "return": {
+            "type": {
+              "text": "Decoration[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "decorations",
+              "type": {
+                "text": "Decoration[]"
+              }
+            },
+            {
+              "name": "oldValue",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "newValue",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Map decorations through a text change, or clear them entirely if the change\nis classified as \"large\" (see `isLargeChange`).\n\nThis is the primary entry point used by the component on each input event."
+        },
+        {
+          "kind": "function",
+          "name": "addDecoration",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "map",
+              "type": {
+                "text": "Map<string, Decoration>"
+              }
+            },
+            {
+              "name": "input",
+              "type": {
+                "text": "DecorationInput"
+              }
+            }
+          ],
+          "description": "Add a single decoration to `map`, assigning it a fresh UUID as its `id`.\nReturns the assigned ID."
+        },
+        {
+          "kind": "function",
+          "name": "setDecorations",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "map",
+              "type": {
+                "text": "Map<string, Decoration>"
+              }
+            },
+            {
+              "name": "inputs",
+              "type": {
+                "text": "DecorationInput[]"
+              }
+            }
+          ],
+          "description": "Replace all decorations in `map` with a new set derived from `inputs`.\nEach input is assigned a fresh UUID."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "generateId",
+          "declaration": {
+            "name": "generateId",
+            "module": "./types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "findEdit",
+          "declaration": {
+            "name": "findEdit",
+            "module": "src/decoration.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "mapDecorationsThroughChange",
+          "declaration": {
+            "name": "mapDecorationsThroughChange",
+            "module": "src/decoration.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "isLargeChange",
+          "declaration": {
+            "name": "isLargeChange",
+            "module": "src/decoration.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "mapOrClear",
+          "declaration": {
+            "name": "mapOrClear",
+            "module": "src/decoration.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "addDecoration",
+          "declaration": {
+            "name": "addDecoration",
+            "module": "src/decoration.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "setDecorations",
+          "declaration": {
+            "name": "setDecorations",
+            "module": "src/decoration.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "MarkDecoration",
+          "declaration": {
+            "name": "MarkDecoration",
+            "module": "src/decoration.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "LineDecoration",
+          "declaration": {
+            "name": "LineDecoration",
+            "module": "src/decoration.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/define.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "rc-textarea",
+          "declaration": {
+            "name": "RCTextarea",
+            "module": "/src/index.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "src/index.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/document.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "V2Document",
+          "members": [
+            {
+              "kind": "field",
+              "name": "scroll",
+              "type": {
+                "text": "V2ScrollBlot"
+              },
+              "privacy": "private",
+              "readonly": true,
+              "default": "new V2ScrollBlot(registry, editorEl)"
+            },
+            {
+              "kind": "method",
+              "name": "build",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "decorations",
+                  "type": {
+                    "text": "Decoration[]"
+                  }
+                }
+              ],
+              "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."
+            },
+            {
+              "kind": "method",
+              "name": "destroy",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "extractEditorText",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "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."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "V2Document",
+          "declaration": {
+            "name": "V2Document",
+            "module": "src/document.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "extractEditorText",
+          "declaration": {
+            "name": "extractEditorText",
+            "module": "src/document.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "RCTextarea",
+          "declaration": {
+            "name": "RCTextarea",
+            "module": "./rc-textarea.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "Decoration",
+          "declaration": {
+            "name": "Decoration",
+            "module": "./types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "DecorationInput",
+          "declaration": {
+            "name": "DecorationInput",
+            "module": "./types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "MarkDecoration",
+          "declaration": {
+            "name": "MarkDecoration",
+            "module": "./types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "MarkDecorationStyle",
+          "declaration": {
+            "name": "MarkDecorationStyle",
+            "module": "./types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "LineDecoration",
+          "declaration": {
+            "name": "LineDecoration",
+            "module": "./types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "WidgetDecoration",
+          "declaration": {
+            "name": "WidgetDecoration",
+            "module": "./types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "RCTextareaPlugin",
+          "declaration": {
+            "name": "RCTextareaPlugin",
+            "module": "./types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "RCTextareaPluginAPI",
+          "declaration": {
+            "name": "RCTextareaPluginAPI",
+            "module": "./types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "TextPattern",
+          "declaration": {
+            "name": "TextPattern",
+            "module": "./types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "LineDecoratorPlugin",
+          "declaration": {
+            "name": "LineDecoratorPlugin",
+            "module": "./types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "Token",
+          "declaration": {
+            "name": "Token",
+            "module": "./types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "matchPatternResults",
+          "declaration": {
+            "name": "matchPatternResults",
+            "module": "./pattern-matcher.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "createLineDecoratorPlugin",
+          "declaration": {
+            "name": "createLineDecoratorPlugin",
+            "module": "./line-decorator.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "LineDecoratorPluginOptions",
+          "declaration": {
+            "name": "LineDecoratorPluginOptions",
+            "module": "./line-decorator.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "LineActionsController",
+          "declaration": {
+            "name": "LineActionsController",
+            "module": "./line-actions-controller.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "LineAction",
+          "declaration": {
+            "name": "LineAction",
+            "module": "./line-actions-controller.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "LineActionsOptions",
+          "declaration": {
+            "name": "LineActionsOptions",
+            "module": "./line-actions-controller.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/line-actions-controller.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Helper class for plugins that need to show inline action buttons next to a\nline, or a floating popover panel anchored to the active line.\n\nInstantiate in `mount()`, call `getDecorations()` / `getDecorationsForLines()`\nfrom `update()`, and call `destroy()` from the plugin's `destroy()`.",
+          "name": "LineActionsController",
+          "members": [
+            {
+              "kind": "field",
+              "name": "_api",
+              "type": {
+                "text": "RCTextareaPluginAPI"
+              },
+              "privacy": "private",
+              "readonly": true,
+              "default": "api"
+            },
+            {
+              "kind": "field",
+              "name": "_options",
+              "type": {
+                "text": "LineActionsOptions"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "_popover",
+              "type": {
+                "text": "HTMLDivElement | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_lastActionsKey",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''"
+            },
+            {
+              "kind": "field",
+              "name": "_blurHandler",
+              "type": {
+                "text": "() => void"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "getDecorations",
+              "return": {
+                "type": {
+                  "text": "DecorationInput[]"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "lineIndex",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "actions",
+                  "type": {
+                    "text": "LineAction[]"
+                  }
+                },
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "renderMode",
+                  "type": {
+                    "text": "'inline' | 'popover'"
+                  }
+                }
+              ],
+              "description": "Call from plugin's `update()`. Pass the line index, its actions, the full\nvalue, and the current render mode.\n\n- `'inline'`: returns a `WidgetDecoration[]` to merge into `setDecorations()`.\n- `'popover'`: returns `[]` and manages a floating panel as a side effect.\n\nPassing an empty actions array hides the popover and returns `[]`."
+            },
+            {
+              "kind": "method",
+              "name": "getDecorationsForLines",
+              "return": {
+                "type": {
+                  "text": "DecorationInput[]"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "lineActions",
+                  "type": {
+                    "text": "Map<number, LineAction[]>"
+                  }
+                },
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "renderMode",
+                  "type": {
+                    "text": "'inline' | 'popover'"
+                  }
+                },
+                {
+                  "name": "activeLineIndex",
+                  "optional": true,
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Variant for `showOn: 'always'` — one entry per line with actions.\n\nIn popover mode only the `activeLineIndex` line is shown; in inline mode\nevery line with non-empty actions gets a widget."
+            },
+            {
+              "kind": "method",
+              "name": "destroy",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Remove the floating panel and detach all listeners. Call from plugin `destroy()`."
+            },
+            {
+              "kind": "method",
+              "name": "getActiveLineIndex",
+              "static": true,
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "selectionStart",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Derive the 0-based line index from a plain-text character offset."
+            },
+            {
+              "kind": "method",
+              "name": "_lineEndOffset",
+              "privacy": "private",
+              "static": true,
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "lineIndex",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Character offset of the end of the given 0-based line (points at the\nnewline character, or end-of-string for the last line)."
+            },
+            {
+              "kind": "method",
+              "name": "_showPopover",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "actions",
+                  "type": {
+                    "text": "LineAction[]"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_positionPopover",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_hidePopover",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "LineActionsController",
+          "declaration": {
+            "name": "LineActionsController",
+            "module": "src/line-actions-controller.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/line-decorator.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "createLineDecoratorPlugin",
+          "return": {
+            "type": {
+              "text": "RCTextareaPlugin"
+            }
+          },
+          "parameters": [
+            {
+              "name": "decorator",
+              "type": {
+                "text": "LineDecoratorPlugin"
+              }
+            },
+            {
+              "name": "options",
+              "default": "{}",
+              "type": {
+                "text": "LineDecoratorPluginOptions"
+              }
+            }
+          ],
+          "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"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "createLineDecoratorPlugin",
+          "declaration": {
+            "name": "createLineDecoratorPlugin",
+            "module": "src/line-decorator.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/pattern-matcher.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "matchPatternResults",
+          "return": {
+            "type": {
+              "text": "{ markDecorations: Omit<MarkDecoration, 'id'>[]; lineDecorations: Omit<LineDecoration, 'id'>[] }"
+            }
+          },
+          "parameters": [
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "patterns",
+              "type": {
+                "text": "TextPattern[]"
+              }
+            }
+          ],
+          "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."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "TextPattern",
+          "declaration": {
+            "name": "TextPattern",
+            "module": "src/pattern-matcher.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "matchPatternResults",
+          "declaration": {
+            "name": "matchPatternResults",
+            "module": "src/pattern-matcher.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/rc-textarea.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Enhanced textarea with line decorations, gutter, and plugin API.",
+          "name": "RCTextarea",
+          "cssProperties": [
+            {
+              "description": "Border around the editor",
+              "name": "--rc-textarea-border",
+              "default": "1px solid ButtonBorder"
+            },
+            {
+              "description": "Border radius of the editor",
+              "name": "--rc-textarea-border-radius",
+              "default": "2px"
+            },
+            {
+              "description": "Background color of the editor",
+              "name": "--rc-textarea-background",
+              "default": "Field"
+            },
+            {
+              "description": "Text color; falls back through --rc-text",
+              "name": "--rc-textarea-color",
+              "default": "FieldText"
+            },
+            {
+              "description": "Font family",
+              "name": "--rc-textarea-font-family",
+              "default": "monospace"
+            },
+            {
+              "description": "Font size",
+              "name": "--rc-textarea-font-size",
+              "default": "1em"
+            },
+            {
+              "description": "Line height",
+              "name": "--rc-textarea-line-height",
+              "default": "1.5"
+            },
+            {
+              "description": "Padding inside the editor area",
+              "name": "--rc-textarea-padding",
+              "default": "0.5em"
+            },
+            {
+              "description": "Focus ring outline",
+              "name": "--rc-textarea-focus-outline",
+              "default": "2px solid Highlight"
+            },
+            {
+              "description": "Caret color",
+              "name": "--rc-textarea-caret-color",
+              "default": "FieldText"
+            },
+            {
+              "description": "Active line highlight color",
+              "name": "--rc-textarea-active-line-bg",
+              "default": "transparent"
+            },
+            {
+              "description": "Gutter background color",
+              "name": "--rc-textarea-gutter-bg",
+              "default": "Canvas"
+            },
+            {
+              "description": "Gutter text color",
+              "name": "--rc-textarea-gutter-color",
+              "default": "GrayText"
+            },
+            {
+              "description": "Gutter right border",
+              "name": "--rc-textarea-gutter-border",
+              "default": "1px solid ButtonBorder"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Accepts a native `<textarea>` element for form wiring and progressive enhancement.",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "shadowRootOptions",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }"
+            },
+            {
+              "kind": "field",
+              "name": "lineNumbers",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "line-numbers",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "listNumbers",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "list-numbers",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "gutter",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "gutter",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "wordWrap",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "word-wrap",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "autoGrow",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "auto-grow",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "readOnly",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "read-only",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string | null"
+              },
+              "default": "null",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "plugin",
+              "type": {
+                "text": "RCTextareaPlugin | null"
+              },
+              "description": "Declarative plugin hook for framework integrations."
+            },
+            {
+              "kind": "field",
+              "name": "decorations",
+              "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."
+            },
+            {
+              "kind": "field",
+              "name": "_value",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''"
+            },
+            {
+              "kind": "field",
+              "name": "_defaultValue",
+              "type": {
+                "text": "string | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_initialValueResolved",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_valueSetByHost",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_document",
+              "type": {
+                "text": "V2Document | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_textareaRef",
+              "type": {
+                "text": "WeakRef<HTMLTextAreaElement> | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_pluginDecorations",
+              "privacy": "protected",
+              "default": "new Map<string, Decoration>()",
+              "description": "Plugin-owned decorations (set via PluginAPI.setDecorations / addDecoration)."
+            },
+            {
+              "kind": "field",
+              "name": "_patternDecorations",
+              "type": {
+                "text": "Decoration[]"
+              },
+              "privacy": "private",
+              "default": "[]",
+              "description": "Pattern-generated decorations (rebuilt on each value change)."
+            },
+            {
+              "kind": "field",
+              "name": "_externalDecorations",
+              "type": {
+                "text": "DecorationInput[]"
+              },
+              "privacy": "private",
+              "default": "[]",
+              "description": "Decorations set directly via the `decorations` property (reactive-framework-friendly)."
+            },
+            {
+              "kind": "field",
+              "name": "_patterns",
+              "privacy": "private",
+              "default": "new Map<string, TextPattern>()",
+              "description": "Registered patterns."
+            },
+            {
+              "kind": "field",
+              "name": "_plugin",
+              "type": {
+                "text": "RCTextareaPlugin | null"
+              },
+              "privacy": "protected",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_pluginProperty",
+              "type": {
+                "text": "RCTextareaPlugin | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_pluginApi",
+              "type": {
+                "text": "RCTextareaPluginAPI | null"
+              },
+              "privacy": "protected",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_pluginSeq",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "description": "Sequence counter for async plugin safety (discard stale results)."
+            },
+            {
+              "kind": "field",
+              "name": "_pluginSheets",
+              "privacy": "private",
+              "default": "new Set<CSSStyleSheet>()",
+              "description": "Stylesheets adopted into the shadow root by the active plugin."
+            },
+            {
+              "kind": "field",
+              "name": "_savedSelection",
+              "type": {
+                "text": "SavedSelection | null"
+              },
+              "privacy": "protected",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_rafHandle",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_composing",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_isRendering",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_activeLine",
+              "type": {
+                "text": "HTMLElement | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "The currently highlighted `.v2-line` element (active line)."
+            },
+            {
+              "kind": "field",
+              "name": "_cursorCallbacks",
+              "privacy": "private",
+              "default": "new Set<(start: number, end: number) => void>()",
+              "description": "Callbacks registered via PluginAPI.onCursorMove()."
+            },
+            {
+              "kind": "field",
+              "name": "_docSelectionChangeHandler",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_undoStack",
+              "type": {
+                "text": "UndoEntry[]"
+              },
+              "privacy": "private",
+              "default": "[]",
+              "description": "Undo/redo stack — necessary because DOM rebuilds invalidate browser's native undo."
+            },
+            {
+              "kind": "field",
+              "name": "_undoIndex",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "-1"
+            },
+            {
+              "kind": "field",
+              "name": "_resizeObserver",
+              "type": {
+                "text": "ResizeObserver | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_gutterLabels",
+              "type": {
+                "text": "(string | null)[]"
+              },
+              "privacy": "private",
+              "default": "[]",
+              "description": "Cached per-line gutter labels from the last render — reused by ResizeObserver."
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "attribute": "value"
+            },
+            {
+              "kind": "field",
+              "name": "defaultValue",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Initial uncontrolled editor value.",
+              "attribute": "defaultValue"
+            },
+            {
+              "kind": "method",
+              "name": "_onSlotChange",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_bindEditorEvents",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "editorEl",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "_onInputEvent",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_onInput",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_onSelectionChange",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_updateActiveLine",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_updateActiveGutterCell",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_onKeyDown",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_insertText",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "text",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "wrapSelection",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "prefix",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "suffix",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Wrap the current selection with `prefix` and `suffix`.\nNo-op when the selection is collapsed (no text selected).\n\nUses the model path directly (not `execCommand`) because callers such as\ntoolbar buttons move focus away from the editor before this fires, which\nclears the DOM selection. `_savedSelection` retains the last model-level\nanchor/focus offsets."
+            },
+            {
+              "kind": "method",
+              "name": "replaceSelection",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "text",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Replace the current selection with `text`.\nWhen the selection is collapsed this is equivalent to `insertText`."
+            },
+            {
+              "kind": "field",
+              "name": "_onPaste",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "clearHistory",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Reset the undo/redo history. Call when the editor receives entirely new content."
+            },
+            {
+              "kind": "method",
+              "name": "_pushUndo",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "sel",
+                  "type": {
+                    "text": "SavedSelection | null"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_undo",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_redo",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_applyUndoEntry",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "entry",
+                  "type": {
+                    "text": "UndoEntry"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "usePlugin",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "plugin",
+                  "type": {
+                    "text": "RCTextareaPlugin"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "removePlugin",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_buildPluginApi",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "RCTextareaPluginAPI"
+                }
+              },
+              "description": "Build the `RCTextareaPluginAPI` object passed to the active plugin's\n`mount()` call. Each getter delegates to the component's live state so the\nAPI stays accurate across render frames without needing to be rebuilt."
+            },
+            {
+              "kind": "method",
+              "name": "_clearPluginSheets",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "addPattern",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "pattern",
+                  "type": {
+                    "text": "Omit<TextPattern, 'id'>"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "removePattern",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "clearPatterns",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_scheduleRender",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_performRender",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_computeGutterLabels",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "(string | null)[]"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "allDecorations",
+                  "type": {
+                    "text": "Decoration[]"
+                  }
+                },
+                {
+                  "name": "value",
+                  "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"
+            },
+            {
+              "kind": "method",
+              "name": "_syncGutterHeights",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "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."
+            },
+            {
+              "kind": "method",
+              "name": "_syncGutter",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "labels",
+                  "optional": true,
+                  "type": {
+                    "text": "(string | null)[]"
+                  }
+                }
+              ],
+              "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": "_syncTypography",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "textarea",
+                  "type": {
+                    "text": "HTMLTextAreaElement"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_syncTextareaValue",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "fromUser",
+                  "default": "false"
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_dispatchChange",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_getEditorEl",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | null"
+                }
+              }
+            }
+          ],
+          "events": [
+            {
+              "name": "rc-textarea-focus",
+              "type": {
+                "text": "CustomEvent"
+              }
+            },
+            {
+              "name": "rc-textarea-blur",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired when the editor loses focus"
+            },
+            {
+              "name": "rc-textarea-change",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired when the editor value changes"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "line-numbers",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "lineNumbers"
+            },
+            {
+              "name": "list-numbers",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "listNumbers"
+            },
+            {
+              "name": "gutter",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "gutter"
+            },
+            {
+              "name": "word-wrap",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "wordWrap"
+            },
+            {
+              "name": "auto-grow",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "autoGrow"
+            },
+            {
+              "name": "read-only",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "readOnly"
+            },
+            {
+              "name": "label",
+              "type": {
+                "text": "string | null"
+              },
+              "default": "null",
+              "fieldName": "label"
+            },
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "value"
+            },
+            {
+              "name": "defaultValue",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Initial uncontrolled editor value.",
+              "fieldName": "defaultValue"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "rc-textarea",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "RCTextarea",
+          "declaration": {
+            "name": "RCTextarea",
+            "module": "src/rc-textarea.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/selection.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "domToTextOffset",
+          "return": {
+            "type": {
+              "text": "number"
+            }
+          },
+          "parameters": [
+            {
+              "name": "root",
+              "type": {
+                "text": "Element"
+              }
+            },
+            {
+              "name": "targetNode",
+              "type": {
+                "text": "Node"
+              }
+            },
+            {
+              "name": "targetNodeOffset",
+              "type": {
+                "text": "number"
+              }
+            }
+          ],
+          "description": "Converts a DOM (node, nodeOffset) pair inside `root` to a plain-text offset.\nReturns -1 if the target was not found inside root."
+        },
+        {
+          "kind": "function",
+          "name": "textOffsetToDom",
+          "return": {
+            "type": {
+              "text": "DomPosition | null"
+            }
+          },
+          "parameters": [
+            {
+              "name": "root",
+              "type": {
+                "text": "Element"
+              }
+            },
+            {
+              "name": "targetOffset",
+              "type": {
+                "text": "number"
+              }
+            }
+          ],
+          "description": "Converts a plain-text offset to a (node, nodeOffset) DOM position inside `root`.\nReturns null if offset is out of range."
+        },
+        {
+          "kind": "function",
+          "name": "saveSelection",
+          "return": {
+            "type": {
+              "text": "SavedSelection | null"
+            }
+          },
+          "parameters": [
+            {
+              "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`."
+        },
+        {
+          "kind": "function",
+          "name": "restoreSelection",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "root",
+              "type": {
+                "text": "Element"
+              }
+            },
+            {
+              "name": "saved",
+              "type": {
+                "text": "SavedSelection"
+              }
+            }
+          ],
+          "description": "Restores a previously saved selection inside `root`.\nSilently does nothing if the saved offsets are out of range."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "domToTextOffset",
+          "declaration": {
+            "name": "domToTextOffset",
+            "module": "src/selection.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "textOffsetToDom",
+          "declaration": {
+            "name": "textOffsetToDom",
+            "module": "src/selection.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "saveSelection",
+          "declaration": {
+            "name": "saveSelection",
+            "module": "src/selection.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "restoreSelection",
+          "declaration": {
+            "name": "restoreSelection",
+            "module": "src/selection.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/test-helpers.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "getEditor",
+          "return": {
+            "type": {
+              "text": "HTMLDivElement"
+            }
+          },
+          "parameters": [
+            {
+              "name": "host",
+              "type": {
+                "text": "RCTextarea"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "getGutterCells",
+          "return": {
+            "type": {
+              "text": "HTMLDivElement"
+            }
+          },
+          "parameters": [
+            {
+              "name": "host",
+              "type": {
+                "text": "RCTextarea"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "getSlottedTextarea",
+          "return": {
+            "type": {
+              "text": "HTMLTextAreaElement"
+            }
+          },
+          "parameters": [
+            {
+              "name": "host",
+              "type": {
+                "text": "RCTextarea"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "waitRender",
+          "return": {
+            "type": {
+              "text": "Promise<void>"
+            }
+          },
+          "description": "Wait one animation frame for _performRender to start, then flush one microtask\ntick so that synchronous plugin `update()` calls complete before the test asserts."
+        },
+        {
+          "kind": "function",
+          "name": "simulatePaste",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "editor",
+              "type": {
+                "text": "HTMLElement"
+              }
+            },
+            {
+              "name": "text",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "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."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "getEditor",
+          "declaration": {
+            "name": "getEditor",
+            "module": "src/test-helpers.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getGutterCells",
+          "declaration": {
+            "name": "getGutterCells",
+            "module": "src/test-helpers.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getSlottedTextarea",
+          "declaration": {
+            "name": "getSlottedTextarea",
+            "module": "src/test-helpers.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "waitRender",
+          "declaration": {
+            "name": "waitRender",
+            "module": "src/test-helpers.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "simulatePaste",
+          "declaration": {
+            "name": "simulatePaste",
+            "module": "src/test-helpers.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/types.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "generateId",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "description": "Generate a unique decoration ID (UUID v4)."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "generateId",
+          "declaration": {
+            "name": "generateId",
+            "module": "src/types.ts"
+          }
+        }
+      ]
+    }
+  ]
+}