@rcarls/rc-textarea 0.6.0 → 0.7.0

package/dist/custom-elements.json

@@ -58,7 +58,7 @@
               }
             }
           ],
-          "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."
+          "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- `FoldDecoration`: dropped; the owning plugin recalculates source ranges.\n\nReturns a new array. The input array and its elements are not mutated."
         },
         {
           "kind": "function",
@@ -280,6 +280,13 @@
               "readonly": true,
               "default": "new RCScrollBlot(registry, $documentRoot)"
             },
+            {
+              "kind": "field",
+              "name": "lineSignatures",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new WeakMap<HTMLElement, string>()"
+            },
             {
               "kind": "method",
               "name": "build",
@@ -353,6 +360,206 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/folding-action-controller.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Reconcile independent, accessible folding actions without owning their content.",
+          "name": "FoldingActionController",
+          "members": [
+            {
+              "kind": "field",
+              "name": "entries",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new Map<string, Entry>()"
+            },
+            {
+              "kind": "field",
+              "name": "gutterGroupElements",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new Map<number, HTMLElement>()"
+            },
+            {
+              "kind": "field",
+              "name": "api",
+              "type": {
+                "text": "RCTextareaPluginAPI"
+              },
+              "privacy": "private",
+              "readonly": true,
+              "default": "api"
+            },
+            {
+              "kind": "field",
+              "name": "options",
+              "type": {
+                "text": "FoldingActionControllerOptions"
+              },
+              "privacy": "private",
+              "readonly": true,
+              "default": "options"
+            },
+            {
+              "kind": "method",
+              "name": "updateIcon",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "entry",
+                  "type": {
+                    "text": "Entry"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "applyState",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "entry",
+                  "type": {
+                    "text": "Entry"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "getDecorations",
+              "return": {
+                "type": {
+                  "text": "DecorationInput[]"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "actions",
+                  "type": {
+                    "text": "readonly FoldingAction[]"
+                  }
+                }
+              ],
+              "description": "Return trigger and collapsed-range decorations; callers provide any panel widget."
+            },
+            {
+              "kind": "method",
+              "name": "isExpanded",
+              "return": {
+                "type": {
+                  "text": "boolean | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Get expansion state for an existing key."
+            },
+            {
+              "kind": "method",
+              "name": "clear",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Discard expansion state and return focus before removing a focused control."
+            },
+            {
+              "kind": "method",
+              "name": "release",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "entry",
+                  "type": {
+                    "text": "Entry"
+                  }
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "kind": "variable",
+          "name": "$button"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "FoldingActionController",
+          "declaration": {
+            "name": "FoldingActionController",
+            "module": "src/folding-action-controller.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/folding.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "FoldingActionController",
+          "declaration": {
+            "name": "FoldingActionController",
+            "module": "./folding-action-controller.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "FoldingAction",
+          "declaration": {
+            "name": "FoldingAction",
+            "module": "./folding-action-controller.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "FoldingActionControllerOptions",
+          "declaration": {
+            "name": "FoldingActionControllerOptions",
+            "module": "./folding-action-controller.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SourceFoldRange",
+          "declaration": {
+            "name": "SourceFoldRange",
+            "module": "./folding-action-controller.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/index.ts",
@@ -414,6 +621,14 @@
             "module": "./types.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "FoldDecoration",
+          "declaration": {
+            "name": "FoldDecoration",
+            "module": "./types.js"
+          }
+        },
         {
           "kind": "js",
           "name": "RCTextareaPlugin",
@@ -840,7 +1055,7 @@
       "declarations": [
         {
           "kind": "class",
-          "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`.",
+          "description": "Textarea wrapper with line decorations, gutter rendering, folding actions, 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": [
             {
@@ -859,9 +1074,9 @@
               "default": "Field"
             },
             {
-              "description": "Text color; falls back through --rc-text",
+              "description": "Text color",
               "name": "--rc-textarea-color",
-              "default": "FieldText"
+              "default": "var(--rc-field-text, FieldText)"
             },
             {
               "description": "Font family",
@@ -879,10 +1094,25 @@
               "default": "1.5"
             },
             {
-              "description": "Padding inside the field area",
-              "name": "--rc-textarea-padding",
+              "description": "Block padding of the editor and gutter; any `padding-block` value",
+              "name": "--rc-textarea-padding-block",
+              "default": "0.5em"
+            },
+            {
+              "description": "Inline padding on both sides of the editor and before the gutter; one length, which the active line highlight bleeds through",
+              "name": "--rc-textarea-padding-inline",
               "default": "0.5em"
             },
+            {
+              "description": "Minimum width of the gutter, including its padding",
+              "name": "--rc-textarea-gutter-min-inline-size",
+              "default": "24px"
+            },
+            {
+              "description": "Reserved inline space and minimum block size for trailing controls",
+              "name": "--rc-textarea-trailing-size",
+              "default": "2.5em"
+            },
             {
               "description": "Focus ring outline",
               "name": "--rc-textarea-focus-outline",
@@ -894,7 +1124,7 @@
               "default": "FieldText"
             },
             {
-              "description": "Active line highlight color",
+              "description": "Active line highlight color, including editor and gutter padding",
               "name": "--rc-textarea-active-line-bg",
               "default": "transparent"
             },
@@ -918,10 +1148,80 @@
               "name": "--rc-textarea-gutter-font-family",
               "default": "var(--rc-textarea-font-family, monospace)"
             },
+            {
+              "description": "Gap between a retained line number and custom gutter content",
+              "name": "--rc-textarea-gutter-content-gap",
+              "default": "0.25em"
+            },
             {
               "description": "Space between gutter labels and text",
               "name": "--rc-textarea-gutter-padding-inline-end",
               "default": "0.75em"
+            },
+            {
+              "description": "Gap between inline line actions; popover actions default to 4px",
+              "name": "--rc-line-actions-gap",
+              "default": "2px"
+            },
+            {
+              "description": "Inline-start margin before line actions",
+              "name": "--rc-line-actions-margin-start",
+              "default": "6px"
+            },
+            {
+              "description": "Inline line-action padding; popover actions default to 4px 6px",
+              "name": "--rc-line-action-padding",
+              "default": "1px"
+            },
+            {
+              "description": "Line-action border; the popover surface defaults to 1px solid ButtonBorder",
+              "name": "--rc-line-action-border",
+              "default": "none"
+            },
+            {
+              "description": "Line-action border radius; the popover surface defaults to 4px",
+              "name": "--rc-line-action-border-radius",
+              "default": "3px"
+            },
+            {
+              "description": "Line-action background; the popover surface defaults to Canvas",
+              "name": "--rc-line-action-bg",
+              "default": "transparent"
+            },
+            {
+              "description": "Line-action color; popover actions default to ButtonText",
+              "name": "--rc-line-action-color",
+              "default": "inherit"
+            },
+            {
+              "description": "Inline line-action font size; popover actions default to 0.85em",
+              "name": "--rc-line-action-font-size",
+              "default": "1em"
+            },
+            {
+              "description": "Resting opacity of inline line actions",
+              "name": "--rc-line-action-opacity",
+              "default": "0.4"
+            },
+            {
+              "description": "Hover and focus opacity of inline line actions",
+              "name": "--rc-line-action-hover-opacity",
+              "default": "1"
+            },
+            {
+              "description": "Hover and focus background; popover actions default to ButtonFace",
+              "name": "--rc-line-action-hover-bg",
+              "default": "transparent"
+            },
+            {
+              "description": "Hover and focus text color",
+              "name": "--rc-line-action-hover-color",
+              "default": "inherit"
+            },
+            {
+              "description": "Line-action popover shadow",
+              "name": "--rc-line-action-shadow",
+              "default": "0 2px 8px color-mix(in srgb, CanvasText 15%, transparent)"
             }
           ],
           "cssParts": [
@@ -937,6 +1237,14 @@
               "description": "The gutter's line-label list.",
               "name": "gutter-cells"
             },
+            {
+              "description": "Native button created by a folding action; style its visual appearance without changing its target or keyboard behavior.",
+              "name": "fold-trigger"
+            },
+            {
+              "description": "Consumer-supplied icon inside a folding action button, when provided.",
+              "name": "fold-icon"
+            },
             {
               "description": "The container positioning the editor over the slotted textarea.",
               "name": "editor-area"
@@ -1006,16 +1314,43 @@
               "attribute": "auto-grow",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "lineDirection",
+              "type": {
+                "text": "'auto' | 'base'"
+              },
+              "default": "'base'",
+              "description": "How each line's direction is chosen. `base` gives every line the editor's\nbase direction, which suits code. `auto` gives a line with a letter the\ndirection of its first strong character, for prose that mixes scripts, and\nholds lines without one (empty, digits, punctuation) to the base direction.",
+              "attribute": "line-direction",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "readOnly",
               "type": {
                 "text": "boolean"
               },
-              "default": "false",
-              "description": "Disable editing. The field renders as a styled read-only display.",
-              "attribute": "read-only",
-              "reflects": true
+              "description": "Whether the slotted `<textarea>` is `readonly`. The native control is the\nsource of truth; set `readonly` on it to change this state.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "_readOnly",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_textareaAttributeObserver",
+              "type": {
+                "text": "MutationObserver | null"
+              },
+              "privacy": "private",
+              "default": "null"
             },
             {
               "kind": "field",
@@ -1115,7 +1450,22 @@
               "name": "_textareaController",
               "privacy": "protected",
               "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>.', }); } }, })"
+              "default": "new NativeChildController<HTMLTextAreaElement>(this, { selector: ':scope > textarea', observe: true, onChange: ($textarea, $previousTextarea) => this._setupTextarea($textarea, $previousTextarea), onMissing: () => { if (import.meta.env.DEV) { warnMissingDirectChild(this, { selector: ':scope > textarea', message: '[rc-textarea] No direct child <textarea> found. Place a native <textarea> inside <rc-textarea>.', }); } }, })"
+            },
+            {
+              "kind": "field",
+              "name": "_flowController",
+              "privacy": "protected",
+              "readonly": true,
+              "default": "new FlowController(this)"
+            },
+            {
+              "kind": "field",
+              "name": "_localeController",
+              "privacy": "protected",
+              "readonly": true,
+              "default": "new LocaleController(this, { onChange: () => this._scheduleRender(), })",
+              "description": "The interface locale, which formats line numbers."
             },
             {
               "kind": "field",
@@ -1222,6 +1572,25 @@
               "privacy": "protected",
               "default": "false"
             },
+            {
+              "kind": "field",
+              "name": "_contentAttributesPendingRender",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_tabMovesFocus",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Set by Escape: the next Tab moves focus instead of inserting `\\t`."
+            },
             {
               "kind": "field",
               "name": "_isRendering",
@@ -1281,16 +1650,57 @@
               "privacy": "protected",
               "default": "null"
             },
+            {
+              "kind": "field",
+              "name": "_gutterBlockAxis",
+              "type": {
+                "text": "'x' | 'y' | null"
+              },
+              "privacy": "protected",
+              "default": "null"
+            },
             {
               "kind": "field",
               "name": "_gutterLabels",
               "type": {
-                "text": "(string | null)[]"
+                "text": "(\n    | string\n    | HTMLElement\n    | null\n    | { number: string; content: string | HTMLElement }\n  )[]"
               },
               "privacy": "protected",
               "default": "[]",
               "description": "Cached per-line gutter labels from the last render — reused by ResizeObserver."
             },
+            {
+              "kind": "field",
+              "name": "_accessibleGutterLines",
+              "privacy": "protected",
+              "default": "new Set<number>()",
+              "description": "Gutter cells with explicitly accessible plugin controls."
+            },
+            {
+              "kind": "field",
+              "name": "_foldedRanges",
+              "type": {
+                "text": "FoldDecoration[]"
+              },
+              "privacy": "protected",
+              "default": "[]",
+              "description": "Collapsed source ranges from the most recent render."
+            },
+            {
+              "kind": "field",
+              "name": "_foldBounds",
+              "type": {
+                "text": "FoldBounds[]"
+              },
+              "privacy": "protected",
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "_hiddenGutterLines",
+              "privacy": "protected",
+              "default": "new Set<number>()"
+            },
             {
               "kind": "field",
               "name": "value",
@@ -1309,6 +1719,98 @@
               "description": "Initial uncontrolled value.",
               "attribute": "default-value"
             },
+            {
+              "kind": "method",
+              "name": "_observeTextarea",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "$textarea",
+                  "type": {
+                    "text": "HTMLTextAreaElement"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_syncContentAttributes",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Mirror the native textarea's content attributes onto the editor. `lang`\npicks glyphs, the spelling dictionary and word boundaries; `spellcheck`\nstays off unless the textarea sets it. The host's own `lang` is the\ninterface language and is never copied."
+            },
+            {
+              "kind": "method",
+              "name": "_syncContentDirection",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Set the editor's base direction from the textarea's `dir`. `auto` reads\nthe native control's directionality, including its LTR neutral fallback;\nwithout `dir` the editor inherits. Composition keeps the current direction\nso the IME session isn't disturbed."
+            },
+            {
+              "kind": "method",
+              "name": "_contentLang",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "description": "The textarea's `lang`, or `''` when it sets none."
+            },
+            {
+              "kind": "method",
+              "name": "_contentDirection",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "'ltr' | 'rtl'"
+                }
+              },
+              "description": "The editor's resolved base direction."
+            },
+            {
+              "kind": "method",
+              "name": "_syncLineDirections",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Mark lines with no strong character so `line-direction=\"auto\"` holds them\nto the base direction. Reads the model value, which composition text\ndoesn't reach until `compositionend`, so a composing line keeps its mark."
+            },
+            {
+              "kind": "method",
+              "name": "_syncReadOnly",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Mirror the native textarea's `readonly` attribute: the editor stays a\nfocusable, selectable textbox that announces `aria-readonly`, and edits\nare blocked by the existing input guards."
+            },
             {
               "kind": "method",
               "name": "_onSlotChange",
@@ -1377,6 +1879,42 @@
               "name": "_onBeforeInput",
               "privacy": "protected"
             },
+            {
+              "kind": "method",
+              "name": "_revealFoldAtOffset",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "offset",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_revealFoldForEdit",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "inputType",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "_onInput",
@@ -1417,6 +1955,24 @@
               "name": "_onKeyDown",
               "privacy": "protected"
             },
+            {
+              "kind": "method",
+              "name": "_isWidgetEvent",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "_insertText",
@@ -1477,6 +2033,11 @@
               ],
               "description": "Replace the current selection with `text`.\nWhen the selection is collapsed this is equivalent to `insertText`."
             },
+            {
+              "kind": "field",
+              "name": "_onCopy",
+              "privacy": "protected"
+            },
             {
               "kind": "field",
               "name": "_onPaste",
@@ -1669,7 +2230,7 @@
               "privacy": "protected",
               "return": {
                 "type": {
-                  "text": "(string | null)[]"
+                  "text": "(string | HTMLElement | null | { number: string; content: string | HTMLElement })[]"
                 }
               },
               "parameters": [
@@ -1695,7 +2256,7 @@
                   "text": "void"
                 }
               },
-              "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."
+              "description": "Synchronize the block size of each gutter cell to match the\ncorresponding `.line` element in the editor.\n\nIn non-word-wrap mode without block widgets the gutter uses a uniform\nline height. Wrapped lines and block widgets use per-line heights instead.\nAlso copies the editor's computed block padding to the\ngutter to compensate for browser UA overrides on contenteditable."
             },
             {
               "kind": "method",
@@ -1711,7 +2272,7 @@
                   "name": "labels",
                   "optional": true,
                   "type": {
-                    "text": "(string | null)[]"
+                    "text": "(string | HTMLElement | null | { number: string; content: string | HTMLElement })[]"
                   }
                 }
               ],
@@ -1845,13 +2406,17 @@
               "fieldName": "autoGrow"
             },
             {
-              "description": "Disable editing. The field renders as a styled read-only display.",
-              "name": "read-only",
+              "description": "How each line's direction is chosen. `base` gives every line the editor's\nbase direction, which suits code. `auto` gives a line with a letter the\ndirection of its first strong character, for prose that mixes scripts, and\nholds lines without one (empty, digits, punctuation) to the base direction.",
+              "name": "line-direction",
               "type": {
-                "text": "boolean"
+                "text": "'auto' | 'base'"
               },
-              "default": "false",
-              "fieldName": "readOnly"
+              "default": "'base'",
+              "fieldName": "lineDirection"
+            },
+            {
+              "description": "Reflected while the slotted `<textarea>` is `readonly`. The editor stays focusable and selectable, announces `aria-readonly`, and blocks edits.",
+              "name": "data-readonly"
             },
             {
               "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)",
@@ -1947,6 +2512,24 @@
           ],
           "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",
+          "name": "getSelectionFocusNode",
+          "return": {
+            "type": {
+              "text": "Node | null"
+            }
+          },
+          "parameters": [
+            {
+              "name": "$root",
+              "type": {
+                "text": "Element"
+              }
+            }
+          ],
+          "description": "Returns the current selection focus node when it belongs to `$root`."
+        },
         {
           "kind": "function",
           "name": "saveSelection",
@@ -2007,6 +2590,14 @@
             "module": "src/selection.ts"
           }
         },
+        {
+          "kind": "js",
+          "name": "getSelectionFocusNode",
+          "declaration": {
+            "name": "getSelectionFocusNode",
+            "module": "src/selection.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "saveSelection",