@aparte/plugin-diff 0.0.0-stage → 1.8.0

package/dist/custom-elements.json

@@ -0,0 +1,1650 @@
+{
+  "schemaVersion": "1.0.0",
+  "readme": "",
+  "modules": [
+    {
+      "kind": "javascript-module",
+      "path": "src/aparte-diff.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A change, as a reviewer reads it: each file under a header with its path and its counts\n(`+3 −1`), each line with its old and new numbers and a `+` or `−` (said as a word to a\nscreen reader), the unchanged runs between hunks folded behind \"Show 24 unchanged lines\".\nSet `diff` to a unified diff's text, to a file's two texts (`{ path, before, after }`: every\nunchanged line can then be shown), or to a list of files.\n\nWith `commentable`, a reader comments on a line or a range: a click on a line number (Shift+click\nto stretch it), or from the keyboard — the numbers of a file are one tab stop, the arrows move,\nShift+arrows stretch, Enter or Space open the field, Escape lets go. Sending it fires\n`aparte-diff-comment`; keeping the comments and sending them on is the app's, and the ones it\nhands back through `comments` are shown under their lines with where each stands.\n\nThe lines are coloured by the chat's highlighter when one is installed (`@aparte/plugin-shiki`),\nin the language the path's extension names. The code reads left to right in a right-to-left page.",
+          "name": "AparteDiff",
+          "cssProperties": [
+            {
+              "description": "The background of an added line.",
+              "name": "--aparte-diff-added-bg",
+              "default": "var(--aparte-success-surface)"
+            },
+            {
+              "description": "The background of a removed line.",
+              "name": "--aparte-diff-removed-bg",
+              "default": "var(--aparte-error-surface)"
+            },
+            {
+              "description": "The `+` of an added line, and the count of added lines.",
+              "name": "--aparte-diff-added-ink",
+              "default": "var(--aparte-success-ink)"
+            },
+            {
+              "description": "The `−` of a removed line, and the count of removed lines.",
+              "name": "--aparte-diff-removed-ink",
+              "default": "var(--aparte-error-ink)"
+            },
+            {
+              "description": "The background of the lines picked for a comment.",
+              "name": "--aparte-diff-selected-bg",
+              "default": "var(--aparte-surface-hover)"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "_input",
+              "type": {
+                "text": "AparteDiffInput | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_shown",
+              "type": {
+                "text": "Shown[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "_files",
+              "type": {
+                "text": "HTMLElement[]"
+              },
+              "privacy": "private",
+              "default": "[]",
+              "description": "Each file's element, as last drawn."
+            },
+            {
+              "kind": "field",
+              "name": "_comments",
+              "type": {
+                "text": "AparteDiffComment[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "_id",
+              "privacy": "private",
+              "readonly": true,
+              "default": "`aparte-diff-${++instances}`"
+            },
+            {
+              "kind": "field",
+              "name": "_generation",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0"
+            },
+            {
+              "kind": "field",
+              "name": "_stopConfig",
+              "type": {
+                "text": "(() => void) | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_selection",
+              "type": {
+                "text": "Selection | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_form",
+              "type": {
+                "text": "CommentForm | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_writing",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether the reader opened the field (it then follows the selection through a redraw)."
+            },
+            {
+              "kind": "field",
+              "name": "_lineOf",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new WeakMap<Element, AparteDiffLine>()",
+              "description": "Each line row's line."
+            },
+            {
+              "kind": "field",
+              "name": "diff",
+              "type": {
+                "text": "AparteDiffInput | null"
+              },
+              "description": "The change to show: a unified diff's text, `{ path, before, after }`, or a list of files (`AparteDiffFile` or texts)."
+            },
+            {
+              "kind": "field",
+              "name": "comments",
+              "type": {
+                "text": "AparteDiffComment[]"
+              },
+              "description": "The comments to show under their lines, with their state. The element only shows them."
+            },
+            {
+              "kind": "field",
+              "name": "commentable",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether a reader can comment on a line. Reflects the `commentable` attribute."
+            },
+            {
+              "kind": "field",
+              "name": "_config",
+              "type": {
+                "text": "AparteConfig"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "_word",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "WordKey"
+                  }
+                },
+                {
+                  "name": "vars",
+                  "optional": true,
+                  "type": {
+                    "text": "Record<string, string | number>"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_onConfigChange",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_render",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Draw every file again from the state, the reader's selection, field and focus kept."
+            },
+            {
+              "kind": "method",
+              "name": "_renderFile",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_message",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "className",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "WordKey"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_fillLines",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "lines",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                },
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "The rows of file `index`, its comments under their lines."
+            },
+            {
+              "kind": "method",
+              "name": "_gapRow",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "gap",
+                  "type": {
+                    "text": "Gap"
+                  }
+                },
+                {
+                  "name": "file",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "expandable",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_lineRow",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "line",
+                  "type": {
+                    "text": "AparteDiffLine"
+                  }
+                },
+                {
+                  "name": "file",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "commentable",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_colour",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "code",
+                  "type": {
+                    "text": "Element"
+                  }
+                },
+                {
+                  "name": "shown",
+                  "type": {
+                    "text": "Shown"
+                  }
+                },
+                {
+                  "name": "line",
+                  "type": {
+                    "text": "AparteDiffLine"
+                  }
+                }
+              ],
+              "description": "Put the highlighter's colours in a line's code, with its block's classes; `false` when it has none for it."
+            },
+            {
+              "kind": "method",
+              "name": "_number",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "side",
+                  "type": {
+                    "text": "AparteDiffSide"
+                  }
+                },
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "number | undefined"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_htmlOf",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "shown",
+                  "type": {
+                    "text": "Shown"
+                  }
+                },
+                {
+                  "name": "line",
+                  "type": {
+                    "text": "AparteDiffLine"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_placeComments",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "lines",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                },
+                {
+                  "name": "shown",
+                  "type": {
+                    "text": "Shown"
+                  }
+                },
+                {
+                  "name": "rows",
+                  "type": {
+                    "text": "HTMLElement[]"
+                  }
+                }
+              ],
+              "description": "The comments the app handed back, each under the line it ends on, or at the end of its file when that line is folded."
+            },
+            {
+              "kind": "method",
+              "name": "_commentNode",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "comment",
+                  "type": {
+                    "text": "AparteDiffComment"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_rangeWords",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "side",
+                  "type": {
+                    "text": "AparteDiffSide"
+                  }
+                },
+                {
+                  "name": "start",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "end",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "\"Line 12\", \"Lines 12–14\", \"Removed line 5\"."
+            },
+            {
+              "kind": "method",
+              "name": "_highlight",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "again",
+                  "default": "false"
+                }
+              ],
+              "description": "Colour each file not coloured yet — or, `again`, every file — each side as one text, and\nput the colours in the lines on screen. A file is coloured only once its highlighter\nanswered: one that failed (still loading its grammars) leaves it plain, to be tried again."
+            },
+            {
+              "kind": "method",
+              "name": "_paintColours",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_linesOf",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | null"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_rowOf",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "The line row of file `index` with the key `key`, if it is drawn."
+            },
+            {
+              "kind": "field",
+              "name": "_onClick",
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "_onKeydown",
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "_onKeyup",
+              "privacy": "private",
+              "readonly": true,
+              "description": "A button acts on Space's keyup: the keydown already did."
+            },
+            {
+              "kind": "method",
+              "name": "_rowsAround",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement[]"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "row",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ],
+              "description": "The line rows of the file `row` is in."
+            },
+            {
+              "kind": "method",
+              "name": "_fileOf",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "row",
+                  "type": {
+                    "text": "Element"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_focusRow",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "row",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ],
+              "description": "Move the file's tab stop to `row`'s number, and the focus with it."
+            },
+            {
+              "kind": "method",
+              "name": "_stretch",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "from",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                },
+                {
+                  "name": "to",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ],
+              "description": "Shift+arrow: the selection runs from where it started (or from `from`) to `to`."
+            },
+            {
+              "kind": "method",
+              "name": "_pick",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "row",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                },
+                {
+                  "name": "stretch",
+                  "type": {
+                    "text": "boolean"
+                  }
+                },
+                {
+                  "name": "keyboard",
+                  "default": "false"
+                }
+              ],
+              "description": "A click (or Enter, Space) on a line number: that line, or the selection stretched to it; then the field."
+            },
+            {
+              "kind": "method",
+              "name": "_selectedRows",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement[]"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_paintSelection",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_range",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Omit<AparteDiffCommentEventDetail, 'text'> | null"
+                }
+              },
+              "description": "What the selection covers: its side, its first and last line there, and those lines' text."
+            },
+            {
+              "kind": "method",
+              "name": "_placeForm",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "focus",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "The field, under the selection's last line, named for what it covers."
+            },
+            {
+              "kind": "method",
+              "name": "_buildForm",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "CommentForm"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_send",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_letGo",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "returnFocus",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Close the field and drop the selection; the focus goes back to the line it ended on."
+            },
+            {
+              "kind": "method",
+              "name": "_expand",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "gap",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "Show the unchanged run `gap` of file `index`, and carry on from its first line."
+            },
+            {
+              "kind": "method",
+              "name": "_focusKey",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string | null"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "active",
+                  "type": {
+                    "text": "Element"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_restoreFocus",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            }
+          ],
+          "events": [
+            {
+              "name": "aparte-diff-comment",
+              "type": {
+                "text": "CustomEvent<AparteDiffCommentEventDetail>"
+              },
+              "description": "A comment was written and sent: `{ path, side, startLine, endLine, text, code }`. Bubbles out of the chat; cancel it to keep the field open with its text."
+            }
+          ],
+          "attributes": [
+            {
+              "name": "commentable",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Let the reader pick a line or a range and write a comment on it. Off by default: without it nothing is clickable."
+            }
+          ],
+          "superclass": {
+            "name": "ElementBase",
+            "module": "src/aparte-diff.ts"
+          },
+          "tagName": "aparte-diff",
+          "customElement": true,
+          "examples": [
+            "A file's two texts, open to comments\n```html\n<aparte-diff commentable></aparte-diff>\n<script type=\"module\">\nimport '@aparte/plugin-diff';\n\nconst diff = document.querySelector('aparte-diff');\ndiff.diff = { path: 'src/parse.ts', before: oldText, after: newText };\nconst comments = [];\ndiff.addEventListener('aparte-diff-comment', (event) => {\ncomments.push({ ...event.detail, state: 'pending' });\ndiff.comments = comments;\n});\n</script>\n```"
+          ]
+        },
+        {
+          "kind": "variable",
+          "name": "text"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AparteDiff",
+          "declaration": {
+            "name": "AparteDiff",
+            "module": "src/aparte-diff.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "aparte-diff",
+          "declaration": {
+            "name": "AparteDiff",
+            "module": "src/aparte-diff.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/compute.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "diffLines",
+          "return": {
+            "type": {
+              "text": "Edit[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "a",
+              "type": {
+                "text": "readonly string[]"
+              }
+            },
+            {
+              "name": "b",
+              "type": {
+                "text": "readonly string[]"
+              }
+            }
+          ],
+          "description": "The edit that turns `a` into `b`, one step per line, removals before additions inside a\nrun of changes."
+        },
+        {
+          "kind": "function",
+          "name": "splitLines",
+          "return": {
+            "type": {
+              "text": "{ lines: string[]; endsWithNewline: boolean }"
+            }
+          },
+          "parameters": [
+            {
+              "name": "text",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "A text's lines, without their endings, and whether its last line ends with one."
+        },
+        {
+          "kind": "function",
+          "name": "diffTexts",
+          "return": {
+            "type": {
+              "text": "AparteDiffFile"
+            }
+          },
+          "parameters": [
+            {
+              "name": "before",
+              "type": {
+                "text": "string | null"
+              }
+            },
+            {
+              "name": "after",
+              "type": {
+                "text": "string | null"
+              }
+            },
+            {
+              "name": "options",
+              "default": "{}",
+              "type": {
+                "text": "DiffTextsOptions"
+              }
+            }
+          ],
+          "description": "The diff of two texts, as one file's hunks with their line numbers. Lines are compared\nwithout their endings, so a file saved with Windows line endings reads the same; a last\nline that gains or loses its newline is shown changed, marked `noNewline`.\n\nA side that does not exist is `null`: `before: null` is a file created (`added`),\n`after: null` a file deleted (`deleted`). `''` is a file that exists and is empty, so\n`diffTexts('', text)` is that file filled in (`modified`). `formatUnifiedDiff` writes each\nas git does, so the patch applies."
+        },
+        {
+          "kind": "function",
+          "name": "hunksOf",
+          "return": {
+            "type": {
+              "text": "AparteDiffHunk[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "lines",
+              "type": {
+                "text": "readonly AparteDiffLine[]"
+              }
+            },
+            {
+              "name": "context",
+              "type": {
+                "text": "number"
+              }
+            }
+          ],
+          "description": "The changed lines with `context` unchanged ones around them, two hunks joined when their context touches."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "diffLines",
+          "declaration": {
+            "name": "diffLines",
+            "module": "src/compute.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "splitLines",
+          "declaration": {
+            "name": "splitLines",
+            "module": "src/compute.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "diffTexts",
+          "declaration": {
+            "name": "diffTexts",
+            "module": "src/compute.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "hunksOf",
+          "declaration": {
+            "name": "hunksOf",
+            "module": "src/compute.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/highlight.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "languageOfPath",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "path",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "The language of a file, from its path: `src/parse.ts` → `typescript`; `''` when there is none to read."
+        },
+        {
+          "kind": "function",
+          "name": "highlightLines",
+          "return": {
+            "type": {
+              "text": "Promise<HighlightedLines | null>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "config",
+              "type": {
+                "text": "AparteConfig"
+              }
+            },
+            {
+              "name": "lines",
+              "type": {
+                "text": "readonly string[]"
+              }
+            },
+            {
+              "name": "language",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "`lines` coloured as one text, cut back into one HTML string per line; `null` when there is\nno highlighter, or what it returned cannot be cut line for line. The HTML went through the\nconfig's sanitizer (`highlightCode` runs it)."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "languageOfPath",
+          "declaration": {
+            "name": "languageOfPath",
+            "module": "src/highlight.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "highlightLines",
+          "declaration": {
+            "name": "highlightLines",
+            "module": "src/highlight.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/index.node.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "diffTexts",
+          "declaration": {
+            "name": "diffTexts",
+            "module": "./compute.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "DiffTextsOptions",
+          "declaration": {
+            "name": "DiffTextsOptions",
+            "module": "./compute.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "parseUnifiedDiff",
+          "declaration": {
+            "name": "parseUnifiedDiff",
+            "module": "./parse.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "formatUnifiedDiff",
+          "declaration": {
+            "name": "formatUnifiedDiff",
+            "module": "./parse.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "setupDiff",
+          "declaration": {
+            "name": "setupDiff",
+            "module": "./setup.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "DiffSetupOptions",
+          "declaration": {
+            "name": "DiffSetupOptions",
+            "module": "./setup.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteDiff",
+          "declaration": {
+            "name": "AparteDiff",
+            "module": "./aparte-diff.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteDiffComment",
+          "declaration": {
+            "name": "AparteDiffComment",
+            "module": "./types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteDiffCommentEventDetail",
+          "declaration": {
+            "name": "AparteDiffCommentEventDetail",
+            "module": "./types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteDiffFile",
+          "declaration": {
+            "name": "AparteDiffFile",
+            "module": "./types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteDiffFileStatus",
+          "declaration": {
+            "name": "AparteDiffFileStatus",
+            "module": "./types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteDiffHunk",
+          "declaration": {
+            "name": "AparteDiffHunk",
+            "module": "./types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteDiffInput",
+          "declaration": {
+            "name": "AparteDiffInput",
+            "module": "./types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteDiffLine",
+          "declaration": {
+            "name": "AparteDiffLine",
+            "module": "./types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteDiffLineKind",
+          "declaration": {
+            "name": "AparteDiffLineKind",
+            "module": "./types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteDiffSide",
+          "declaration": {
+            "name": "AparteDiffSide",
+            "module": "./types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteDiffSource",
+          "declaration": {
+            "name": "AparteDiffSource",
+            "module": "./types.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "AparteDiff",
+          "declaration": {
+            "name": "AparteDiff",
+            "module": "./aparte-diff.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "setupDiff",
+          "declaration": {
+            "name": "setupDiff",
+            "module": "./setup.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "DiffSetupOptions",
+          "declaration": {
+            "name": "DiffSetupOptions",
+            "module": "./setup.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "diffTexts",
+          "declaration": {
+            "name": "diffTexts",
+            "module": "./compute.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "DiffTextsOptions",
+          "declaration": {
+            "name": "DiffTextsOptions",
+            "module": "./compute.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "parseUnifiedDiff",
+          "declaration": {
+            "name": "parseUnifiedDiff",
+            "module": "./parse.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "formatUnifiedDiff",
+          "declaration": {
+            "name": "formatUnifiedDiff",
+            "module": "./parse.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteDiffComment",
+          "declaration": {
+            "name": "AparteDiffComment",
+            "module": "./types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteDiffCommentEventDetail",
+          "declaration": {
+            "name": "AparteDiffCommentEventDetail",
+            "module": "./types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteDiffFile",
+          "declaration": {
+            "name": "AparteDiffFile",
+            "module": "./types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteDiffFileStatus",
+          "declaration": {
+            "name": "AparteDiffFileStatus",
+            "module": "./types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteDiffHunk",
+          "declaration": {
+            "name": "AparteDiffHunk",
+            "module": "./types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteDiffInput",
+          "declaration": {
+            "name": "AparteDiffInput",
+            "module": "./types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteDiffLine",
+          "declaration": {
+            "name": "AparteDiffLine",
+            "module": "./types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteDiffLineKind",
+          "declaration": {
+            "name": "AparteDiffLineKind",
+            "module": "./types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteDiffSide",
+          "declaration": {
+            "name": "AparteDiffSide",
+            "module": "./types.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AparteDiffSource",
+          "declaration": {
+            "name": "AparteDiffSource",
+            "module": "./types.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/parse.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "parseUnifiedDiff",
+          "return": {
+            "type": {
+              "text": "AparteDiffFile[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "text",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "The files of a unified diff, in the order it lists them. A text that holds no diff gives\nan empty list. Windows line endings read the same as Unix ones."
+        },
+        {
+          "kind": "function",
+          "name": "formatUnifiedDiff",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "files",
+              "type": {
+                "text": "AparteDiffFile | readonly AparteDiffFile[]"
+              }
+            }
+          ],
+          "description": "Files as a unified diff, the way `git diff` writes it: what `parseUnifiedDiff` reads back,\nand what `git apply` takes. With `diffTexts`, a server can send a patch as text. A file\ncreated or deleted carries git's `new file mode` / `deleted file mode` header (as a regular\nfile, `100644`), which `git apply` needs to create one; a rename carries `rename from` and\n`rename to`."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "parseUnifiedDiff",
+          "declaration": {
+            "name": "parseUnifiedDiff",
+            "module": "src/parse.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "formatUnifiedDiff",
+          "declaration": {
+            "name": "formatUnifiedDiff",
+            "module": "src/parse.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/setup.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "setupDiff",
+          "return": {
+            "type": {
+              "text": "() => void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "options",
+              "type": {
+                "text": "DiffSetupOptions"
+              }
+            },
+            {
+              "name": "config",
+              "default": "aparteGlobalConfig",
+              "type": {
+                "text": "AparteConfig"
+              }
+            }
+          ],
+          "description": "Show a tool's result as a diff, under the tool's line in the reply. Returns the function that\ntakes it off again.\n\nThe rest of the tool's display (its label, its summary, its icon) stays the app's: set it\nwith `registerToolDisplay` before or after. Taking the setup off gives back what the tool\nshowed behind its line before."
+        },
+        {
+          "kind": "function",
+          "name": "details",
+          "return": {
+            "type": {
+              "text": "HTMLElement | string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "segment",
+              "type": {
+                "text": "AparteToolCallSegment"
+              }
+            },
+            {
+              "name": "held",
+              "optional": true,
+              "type": {
+                "text": "HTMLElement"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "setupDiff",
+          "declaration": {
+            "name": "setupDiff",
+            "module": "src/setup.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/styles.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "DIFF_STYLES",
+          "default": "styles",
+          "description": "The sheet, as the element puts it on the page."
+        },
+        {
+          "kind": "function",
+          "name": "ensureStyles",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "doc",
+              "default": "document",
+              "type": {
+                "text": "Document"
+              }
+            }
+          ],
+          "description": "Put the sheet on the page, unless it is there already."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "DIFF_STYLES",
+          "declaration": {
+            "name": "DIFF_STYLES",
+            "module": "src/styles.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ensureStyles",
+          "declaration": {
+            "name": "ensureStyles",
+            "module": "src/styles.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/types.ts",
+      "declarations": [],
+      "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/words.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "WORDS",
+          "default": "{ /** A file's added lines, said to a screen reader beside the `+3` it shows. */ diffAdded: { en: 'one:{n} line added|other:{n} lines added', fr: 'one:{n} ligne ajoutée|other:{n} lignes ajoutées', de: 'one:{n} Zeile hinzugefügt|other:{n} Zeilen hinzugefügt', es: 'one:{n} línea añadida|other:{n} líneas añadidas', it: 'one:{n} riga aggiunta|other:{n} righe aggiunte', ja: 'other:{n} 行追加', ko: 'other:{n}줄 추가됨', pt: 'one:{n} linha adicionada|other:{n} linhas adicionadas', ru: 'one:{n} строка добавлена|few:{n} строки добавлены|many:{n} строк добавлено|other:{n} строки добавлено', zh: 'other:新增 {n} 行', }, /** A file's removed lines, said to a screen reader beside the `−1` it shows. */ diffRemoved: { en: 'one:{n} line removed|other:{n} lines removed', fr: 'one:{n} ligne supprimée|other:{n} lignes supprimées', de: 'one:{n} Zeile entfernt|other:{n} Zeilen entfernt', es: 'one:{n} línea eliminada|other:{n} líneas eliminadas', it: 'one:{n} riga rimossa|other:{n} righe rimosse', ja: 'other:{n} 行削除', ko: 'other:{n}줄 삭제됨', pt: 'one:{n} linha removida|other:{n} linhas removidas', ru: 'one:{n} строка удалена|few:{n} строки удалены|many:{n} строк удалено|other:{n} строки удалено', zh: 'other:删除 {n} 行', }, /** What the `+` of an added line says to a screen reader. */ diffMarkerAdded: { en: 'added', fr: 'ajoutée', de: 'hinzugefügt', es: 'añadida', it: 'aggiunta', ja: '追加', ko: '추가됨', pt: 'adicionada', ru: 'добавлена', zh: '新增', }, /** What the `−` of a removed line says to a screen reader. */ diffMarkerRemoved: { en: 'removed', fr: 'supprimée', de: 'entfernt', es: 'eliminada', it: 'rimossa', ja: '削除', ko: '삭제됨', pt: 'removida', ru: 'удалена', zh: '删除', }, /** The button over a run of unchanged lines the element can show. */ diffShowUnchanged: { en: 'one:Show {n} unchanged line|other:Show {n} unchanged lines', fr: 'one:Afficher {n} ligne inchangée|other:Afficher {n} lignes inchangées', de: 'one:{n} unveränderte Zeile anzeigen|other:{n} unveränderte Zeilen anzeigen', es: 'one:Mostrar {n} línea sin cambios|other:Mostrar {n} líneas sin cambios', it: 'one:Mostra {n} riga invariata|other:Mostra {n} righe invariate', ja: 'other:変更のない {n} 行を表示', ko: 'other:변경되지 않은 {n}줄 표시', pt: 'one:Mostrar {n} linha inalterada|other:Mostrar {n} linhas inalteradas', ru: 'one:Показать {n} неизменённую строку|few:Показать {n} неизменённые строки|many:Показать {n} неизменённых строк|other:Показать {n} неизменённой строки', zh: 'other:显示 {n} 行未更改的内容', }, /** A run of unchanged lines the diff does not hold (a unified diff's text), between two hunks. */ diffUnchanged: { en: 'one:{n} unchanged line|other:{n} unchanged lines', fr: 'one:{n} ligne inchangée|other:{n} lignes inchangées', de: 'one:{n} unveränderte Zeile|other:{n} unveränderte Zeilen', es: 'one:{n} línea sin cambios|other:{n} líneas sin cambios', it: 'one:{n} riga invariata|other:{n} righe invariate', ja: 'other:変更のない {n} 行', ko: 'other:변경되지 않은 {n}줄', pt: 'one:{n} linha inalterada|other:{n} linhas inalteradas', ru: 'one:{n} неизменённая строка|few:{n} неизменённые строки|many:{n} неизменённых строк|other:{n} неизменённой строки', zh: 'other:{n} 行未更改', }, /** A new file's tag, beside its path. */ diffStatusAdded: { en: 'Added', fr: 'Ajouté', de: 'Neu', es: 'Añadido', it: 'Aggiunto', ja: '追加', ko: '추가됨', pt: 'Adicionado', ru: 'Добавлен', zh: '新增', }, /** A deleted file's tag, beside its path. */ diffStatusDeleted: { en: 'Deleted', fr: 'Supprimé', de: 'Gelöscht', es: 'Eliminado', it: 'Eliminato', ja: '削除', ko: '삭제됨', pt: 'Excluído', ru: 'Удалён', zh: '已删除', }, /** A renamed file's tag, beside its paths. */ diffStatusRenamed: { en: 'Renamed', fr: 'Renommé', de: 'Umbenannt', es: 'Renombrado', it: 'Rinominato', ja: '名前変更', ko: '이름 변경됨', pt: 'Renomeado', ru: 'Переименован', zh: '已重命名', }, /** Where a binary file's lines would be. */ diffBinary: { en: 'Binary file, no lines to show', fr: 'Fichier binaire, aucune ligne à afficher', de: 'Binärdatei, keine Zeilen anzuzeigen', es: 'Archivo binario, no hay líneas que mostrar', it: 'File binario, nessuna riga da mostrare', ja: 'バイナリファイルのため表示する行はありません', ko: '바이너리 파일이라 표시할 줄이 없습니다', pt: 'Arquivo binário, nenhuma linha para mostrar', ru: 'Двоичный файл, строк для показа нет', zh: '二进制文件，没有可显示的行', }, /** Under the last line of a file that ends without a newline. */ diffNoNewline: { en: 'No newline at end of file', fr: 'Pas de saut de ligne à la fin du fichier', de: 'Kein Zeilenumbruch am Dateiende', es: 'Sin salto de línea al final del archivo', it: 'Nessun a capo alla fine del file', ja: 'ファイル末尾に改行がありません', ko: '파일 끝에 줄바꿈 없음', pt: 'Sem quebra de linha no fim do arquivo', ru: 'Нет перевода строки в конце файла', zh: '文件末尾没有换行符', }, /** An unchanged line's number, as its button and a comment name it. */ diffLine: { en: 'Line {n}', fr: 'Ligne {n}', de: 'Zeile {n}', es: 'Línea {n}', it: 'Riga {n}', ja: '{n} 行目', ko: '{n}번째 줄', pt: 'Linha {n}', ru: 'Строка {n}', zh: '第 {n} 行', }, /** An added line's number, as its button names it. */ diffLineAdded: { en: 'Added line {n}', fr: 'Ligne ajoutée {n}', de: 'Hinzugefügte Zeile {n}', es: 'Línea añadida {n}', it: 'Riga aggiunta {n}', ja: '追加された {n} 行目', ko: '추가된 {n}번째 줄', pt: 'Linha adicionada {n}', ru: 'Добавленная строка {n}', zh: '新增的第 {n} 行', }, /** A removed line's number, as its button and a comment name it. */ diffLineRemoved: { en: 'Removed line {n}', fr: 'Ligne supprimée {n}', de: 'Entfernte Zeile {n}', es: 'Línea eliminada {n}', it: 'Riga rimossa {n}', ja: '削除された {n} 行目', ko: '삭제된 {n}번째 줄', pt: 'Linha removida {n}', ru: 'Удалённая строка {n}', zh: '删除的第 {n} 行', }, /** A range a comment is on. */ diffLines: { en: 'Lines {start}–{end}', fr: 'Lignes {start} à {end}', de: 'Zeilen {start}–{end}', es: 'Líneas {start}–{end}', it: 'Righe {start}–{end}', ja: '{start}〜{end} 行目', ko: '{start}~{end}번째 줄', pt: 'Linhas {start}–{end}', ru: 'Строки {start}–{end}', zh: '第 {start}–{end} 行', }, /** A range of removed lines a comment is on. */ diffLinesRemoved: { en: 'Removed lines {start}–{end}', fr: 'Lignes supprimées {start} à {end}', de: 'Entfernte Zeilen {start}–{end}', es: 'Líneas eliminadas {start}–{end}', it: 'Righe rimosse {start}–{end}', ja: '削除された {start}〜{end} 行目', ko: '삭제된 {start}~{end}번째 줄', pt: 'Linhas removidas {start}–{end}', ru: 'Удалённые строки {start}–{end}', zh: '删除的第 {start}–{end} 行', }, /** The comment field's name, on one line. */ diffCommentLine: { en: 'Comment on line {n}', fr: 'Commenter la ligne {n}', de: 'Zeile {n} kommentieren', es: 'Comentar la línea {n}', it: 'Commenta la riga {n}', ja: '{n} 行目にコメント', ko: '{n}번째 줄에 댓글', pt: 'Comentar a linha {n}', ru: 'Комментарий к строке {n}', zh: '评论第 {n} 行', }, /** The comment field's name, on a range. */ diffCommentLines: { en: 'Comment on lines {start}–{end}', fr: 'Commenter les lignes {start} à {end}', de: 'Zeilen {start}–{end} kommentieren', es: 'Comentar las líneas {start}–{end}', it: 'Commenta le righe {start}–{end}', ja: '{start}〜{end} 行目にコメント', ko: '{start}~{end}번째 줄에 댓글', pt: 'Comentar as linhas {start}–{end}', ru: 'Комментарий к строкам {start}–{end}', zh: '评论第 {start}–{end} 行', }, /** What the empty comment field shows. */ diffCommentPlaceholder: { en: 'Leave a comment', fr: 'Laisser un commentaire', de: 'Kommentar schreiben', es: 'Deja un comentario', it: 'Lascia un commento', ja: 'コメントを入力', ko: '댓글 남기기', pt: 'Deixe um comentário', ru: 'Оставьте комментарий', zh: '留下评论', }, /** The button that sends the comment. */ diffCommentSubmit: { en: 'Comment', fr: 'Commenter', de: 'Kommentieren', es: 'Comentar', it: 'Commenta', ja: 'コメント', ko: '댓글 달기', pt: 'Comentar', ru: 'Комментировать', zh: '评论', }, /** The button that closes the comment field. */ diffCommentCancel: { en: 'Cancel', fr: 'Annuler', de: 'Abbrechen', es: 'Cancelar', it: 'Annulla', ja: 'キャンセル', ko: '취소', pt: 'Cancelar', ru: 'Отмена', zh: '取消', }, /** A comment kept to be sent. */ diffCommentPending: { en: 'Pending', fr: 'En attente', de: 'Ausstehend', es: 'Pendiente', it: 'In attesa', ja: '保留中', ko: '대기 중', pt: 'Pendente', ru: 'Ожидает', zh: '待发送', }, /** A comment that was sent. */ diffCommentSent: { en: 'Sent', fr: 'Envoyé', de: 'Gesendet', es: 'Enviado', it: 'Inviato', ja: '送信済み', ko: '보냄', pt: 'Enviado', ru: 'Отправлен', zh: '已发送', }, /** A diff with no change in it. */ diffEmpty: { en: 'No changes', fr: 'Aucun changement', de: 'Keine Änderungen', es: 'Sin cambios', it: 'Nessuna modifica', ja: '変更はありません', ko: '변경 사항 없음', pt: 'Nenhuma alteração', ru: 'Изменений нет', zh: '没有更改', }, } satisfies Record<string, Word>"
+        },
+        {
+          "kind": "function",
+          "name": "word",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "config",
+              "type": {
+                "text": "AparteConfig"
+              }
+            },
+            {
+              "name": "key",
+              "type": {
+                "text": "WordKey"
+              }
+            },
+            {
+              "name": "vars",
+              "default": "{}",
+              "type": {
+                "text": "Record<string, string | number>"
+              }
+            }
+          ],
+          "description": "The word for `key`: the app's locale, else this table in the chat's language, else English;\n`{name}` slots filled from `vars`, and a count's plural form chosen when `vars.n` is a number."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "WORDS",
+          "declaration": {
+            "name": "WORDS",
+            "module": "src/words.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "word",
+          "declaration": {
+            "name": "word",
+            "module": "src/words.ts"
+          }
+        }
+      ]
+    }
+  ]
+}