@contraagent/elements 0.1.0 → 0.2.0

package/custom-elements.json

@@ -754,97 +754,550 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/count/count.ts",
+      "path": "src/checks/check-table.ts",
       "declarations": [
+        {
+          "kind": "function",
+          "name": "verdict",
+          "return": {
+            "type": {
+              "text": "TemplateResult | typeof nothing"
+            }
+          },
+          "parameters": [
+            {
+              "name": "v",
+              "type": {
+                "text": "Verdict"
+              }
+            },
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "tip",
+              "default": "''"
+            }
+          ],
+          "description": "A verdict in words (`.verdict`, `data-verdict`; `verdictStyles`): ✓ before a\npass, ✕ before a failure, hidden from screen readers, which read the word.\nNothing for `none` without a word."
+        },
         {
           "kind": "class",
-          "description": "A number that counts up (or down) to its new value when it changes; at once\nfor a reader who asks for reduced motion.",
-          "name": "CaeCount",
+          "description": "Named values checked one by one: a row per name, with what it must be, what\nit is and the verdict. Without `showValues`, only the names and what each\nmust be (nothing to check them against).",
+          "name": "CaeCheckTable",
+          "cssParts": [
+            {
+              "description": "the `<table>`",
+              "name": "table"
+            },
+            {
+              "description": "each row of a name",
+              "name": "row"
+            },
+            {
+              "description": "each verdict",
+              "name": "verdict"
+            }
+          ],
           "members": [
             {
               "kind": "field",
-              "name": "value",
+              "name": "rows",
               "type": {
-                "text": "number"
+                "text": "readonly CheckRow[]"
               },
-              "default": "0",
-              "attribute": "value"
+              "default": "[]"
             },
             {
               "kind": "field",
-              "name": "shown",
+              "name": "showValues",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "privacy": "private",
-              "default": "0"
+              "default": "true",
+              "description": "Show the values and the verdicts.",
+              "attribute": "showValues"
             },
             {
               "kind": "field",
-              "name": "frame",
+              "name": "strings",
               "type": {
-                "text": "number"
+                "text": "Partial<CheckTableStrings>"
               },
-              "privacy": "private",
-              "default": "0"
+              "default": "{}"
             }
           ],
           "attributes": [
             {
-              "name": "value",
+              "name": "showValues",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "default": "0",
-              "fieldName": "value"
+              "default": "true",
+              "description": "Show the values and the verdicts.",
+              "fieldName": "showValues"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "cae-count",
+          "tagName": "cae-check-table",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "CaeCount",
+          "name": "verdict",
           "declaration": {
-            "name": "CaeCount",
-            "module": "src/count/count.ts"
+            "name": "verdict",
+            "module": "src/checks/check-table.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CaeCheckTable",
+          "declaration": {
+            "name": "CaeCheckTable",
+            "module": "src/checks/check-table.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/count/elapsed.ts",
+      "path": "src/code/code.ts",
       "declarations": [
+        {
+          "kind": "variable",
+          "name": "DEFAULT_CODE_STRINGS",
+          "type": {
+            "text": "Readonly<CodeStrings>"
+          },
+          "default": "{ copy: 'Copy', copied: 'Copied', wrap: 'Wrap lines', empty: 'No text', cut: (shown, total) => `First ${shown.toLocaleString('en')} of ${total.toLocaleString('en')} lines`, }"
+        },
+        {
+          "kind": "function",
+          "name": "shownText",
+          "return": {
+            "type": {
+              "text": "ShownText"
+            }
+          },
+          "parameters": [
+            {
+              "name": "text",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "maxLines",
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "name": "maxCharacters",
+              "type": {
+                "text": "number"
+              }
+            }
+          ],
+          "description": "The first lines of `text`: at most `maxLines` lines and `maxCharacters` characters, cut\nat the end of a line (a first line longer than that is cut inside it)."
+        },
+        {
+          "kind": "function",
+          "name": "isMarked",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "marks",
+              "type": {
+                "text": "readonly LineMark[]"
+              }
+            },
+            {
+              "name": "n",
+              "type": {
+                "text": "number"
+              }
+            }
+          ],
+          "description": "Whether line `n` is in one of `marks`."
+        },
         {
           "kind": "class",
-          "description": "Time since `since` (epoch ms), ticking every second: `42s`, `3m 05s`, `1h 02m`.",
-          "name": "CaeElapsed",
+          "description": "A text shown as code: highlighted by its `language` (`LANGUAGES`, another name of one\nor a file name; anything else is plain), each line numbered from `start`, the lines of\n`highlight` marked (a bar beside the number and a tint). Long lines scroll sideways,\nor wrap with `wrap` or the reader's switch. A text of more than `maxLines` lines or\n`maxCharacters` characters shows its first lines and says how many it has; the copy\nbutton copies the whole text. The line numbers are not part of a selection.",
+          "name": "CaeCode",
+          "cssParts": [
+            {
+              "description": "the path, the language and the buttons",
+              "name": "header"
+            },
+            {
+              "description": "the lines, which scroll",
+              "name": "code"
+            },
+            {
+              "description": "the note under a text cut short",
+              "name": "cut"
+            }
+          ],
           "members": [
             {
               "kind": "field",
-              "name": "since",
+              "name": "code",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The text.",
+              "attribute": "code"
+            },
+            {
+              "kind": "field",
+              "name": "language",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Its language: a name of `LANGUAGES`, another name of one, or a file name; anything else is plain text.",
+              "attribute": "language"
+            },
+            {
+              "kind": "field",
+              "name": "start",
               "type": {
                 "text": "number"
               },
-              "default": "0",
-              "attribute": "since"
-            }
-          ],
-          "attributes": [
+              "default": "1",
+              "description": "The number of the first line.",
+              "attribute": "start"
+            },
             {
-              "name": "since",
+              "kind": "field",
+              "name": "highlight",
+              "type": {
+                "text": "readonly LineMark[]"
+              },
+              "default": "[]",
+              "description": "The lines marked, in the numbers shown."
+            },
+            {
+              "kind": "field",
+              "name": "path",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The file the text is, named over it.",
+              "attribute": "path"
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "What the lines are named to a screen reader (default: the path).",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "wrap",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Long lines wrap at first; the reader's switch changes it.",
+              "attribute": "wrap"
+            },
+            {
+              "kind": "field",
+              "name": "maxLines",
               "type": {
                 "text": "number"
               },
-              "default": "0",
-              "fieldName": "since"
+              "default": "5000",
+              "description": "The most lines shown.",
+              "attribute": "maxLines"
+            },
+            {
+              "kind": "field",
+              "name": "maxCharacters",
+              "type": {
+                "text": "number"
+              },
+              "default": "500_000",
+              "description": "The most characters shown, at the end of a line.",
+              "attribute": "maxCharacters"
+            },
+            {
+              "kind": "field",
+              "name": "strings",
+              "type": {
+                "text": "Partial<CodeStrings>"
+              },
+              "default": "{}",
+              "description": "The visible words; English by default."
+            },
+            {
+              "kind": "field",
+              "name": "wrapped",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "copied",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "copiedTimer",
+              "type": {
+                "text": "ReturnType<typeof setTimeout> | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "copy",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              }
+            }
+          ],
+          "attributes": [
+            {
+              "name": "code",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The text.",
+              "fieldName": "code"
+            },
+            {
+              "name": "language",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Its language: a name of `LANGUAGES`, another name of one, or a file name; anything else is plain text.",
+              "fieldName": "language"
+            },
+            {
+              "name": "start",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "description": "The number of the first line.",
+              "fieldName": "start"
+            },
+            {
+              "name": "path",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The file the text is, named over it.",
+              "fieldName": "path"
+            },
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "What the lines are named to a screen reader (default: the path).",
+              "fieldName": "label"
+            },
+            {
+              "name": "wrap",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Long lines wrap at first; the reader's switch changes it.",
+              "fieldName": "wrap"
+            },
+            {
+              "name": "maxLines",
+              "type": {
+                "text": "number"
+              },
+              "default": "5000",
+              "description": "The most lines shown.",
+              "fieldName": "maxLines"
+            },
+            {
+              "name": "maxCharacters",
+              "type": {
+                "text": "number"
+              },
+              "default": "500_000",
+              "description": "The most characters shown, at the end of a line.",
+              "fieldName": "maxCharacters"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "cae-code",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "DEFAULT_CODE_STRINGS",
+          "declaration": {
+            "name": "DEFAULT_CODE_STRINGS",
+            "module": "src/code/code.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "shownText",
+          "declaration": {
+            "name": "shownText",
+            "module": "src/code/code.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "isMarked",
+          "declaration": {
+            "name": "isMarked",
+            "module": "src/code/code.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CaeCode",
+          "declaration": {
+            "name": "CaeCode",
+            "module": "src/code/code.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/count/count.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A number that counts up (or down) to its new value when it changes; at once\nfor a reader who asks for reduced motion.",
+          "name": "CaeCount",
+          "members": [
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "attribute": "value"
+            },
+            {
+              "kind": "field",
+              "name": "shown",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0"
+            },
+            {
+              "kind": "field",
+              "name": "frame",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "value",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "fieldName": "value"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "cae-count",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "CaeCount",
+          "declaration": {
+            "name": "CaeCount",
+            "module": "src/count/count.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/count/elapsed.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Time since `since` (epoch ms), ticking every second: `42s`, `3m 05s`, `1h 02m`.",
+          "name": "CaeElapsed",
+          "members": [
+            {
+              "kind": "field",
+              "name": "since",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "attribute": "since"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "since",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "fieldName": "since"
             }
           ],
           "superclass": {
@@ -889,6 +1342,29 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/define/code.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "CaeCode",
+          "declaration": {
+            "name": "CaeCode",
+            "module": "src/define/code.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CaeEventMap",
+          "declaration": {
+            "name": "CaeEventMap",
+            "module": "../core/events.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/define/count.ts",
@@ -1037,141 +1513,48 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/checks/check-table.ts",
+      "path": "src/define/tree.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "CaeTree",
+          "declaration": {
+            "name": "CaeTree",
+            "module": "src/define/tree.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CaeEventMap",
+          "declaration": {
+            "name": "CaeEventMap",
+            "module": "../core/events.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/graph/layered-graph.ts",
       "declarations": [
         {
-          "kind": "function",
-          "name": "verdict",
-          "return": {
-            "type": {
-              "text": "TemplateResult | typeof nothing"
-            }
+          "kind": "variable",
+          "name": "NARROW",
+          "type": {
+            "text": "number"
           },
-          "parameters": [
-            {
-              "name": "v",
-              "type": {
-                "text": "Verdict"
-              }
-            },
-            {
-              "name": "label",
-              "type": {
-                "text": "string"
-              }
-            },
-            {
-              "name": "tip",
-              "default": "''"
-            }
-          ],
-          "description": "A verdict in words (`.verdict`, `data-verdict`; `verdictStyles`): ✓ before a\npass, ✕ before a failure, hidden from screen readers, which read the word.\nNothing for `none` without a word."
+          "default": "640",
+          "description": "Below this width, `direction: 'auto'` draws top to bottom, without zoom."
         },
         {
           "kind": "class",
-          "description": "Named values checked one by one: a row per name, with what it must be, what\nit is and the verdict. Without `showValues`, only the names and what each\nmust be (nothing to check them against).",
-          "name": "CaeCheckTable",
+          "description": "A layered graph: each node in a layer by the longest path to it, edges bending only\nin the gaps between layers and never passing a node or a cluster's label; a cluster\nof nodes in a box (a cluster in a cluster: a box in a box), with, when it `cycle`s,\na dotted return from its last layer to its first; an edge from outside the graph\nfrom a named stub. Inside each node, one mark per series id, at the same place in\nevery node, so a series can be followed across the graph; a mark is drawn in its\nstate's look (`states`). Above `barAt` marks, a node shows a bar of its counts and\nlists its failed marks. The order depends on the structure only, and keeps a\nprevious `order`: nodes that appear later are added at the end of their layer.\n\nA click selects a mark, a node or a cluster (`cae-select`); a card beside it (the\nhost's content, in the `inspector` slot) moves with it as the graph pans and zooms,\nand hides while it is out of the frame; on a narrow screen it is a sheet under the\nframe. A double click or Enter is the item's action (`cae-activate`), or opens its\ninner view (`cae-drill`, for an item with `drill`). Hovering or focusing a mark\nhighlights its series and what `related` names. The frame first shows the whole\ngraph; Ctrl (or ⌘) and the wheel, or the buttons, zoom; dragging pans; \"Show all\"\ngoes back. \"Graph | Table\" changes the view (`cae-view-change`): the table is a row\nper node, with its status and the nodes it is joined to. With `matrix`, the frame\nshows that `<cae-mark-matrix>` as the table instead.\n\nSize: the element is as wide as its container. Without a height set on it, the\nframe is as tall as the whole drawing at that width (never scaled up), up to 70% of\nthe window's height or 360 px, whichever is more, and taller when the card needs\nit; top to bottom, as tall as the drawing. A height set on the element\n(or given it by a flex or grid container) is shared: the `crumbs` slot and the row\nunder the frame keep theirs, and the frame takes the rest, the drawing fitted in it.\n\nKeyboard: Tab moves between nodes; the arrow keys, Home and End move between a\nnode's marks, and a mark out of the frame is brought into it; Shift and an arrow\nkey move along an edge to an earlier or a later node, on the same series; what has\nthe focus is selected (Tab goes on to the card); Enter is the item's action; Escape\nclears the selection (and, with none, is left to the host).",
+          "name": "CaeLayeredGraph",
           "cssParts": [
             {
-              "description": "the `<table>`",
-              "name": "table"
-            },
-            {
-              "description": "each row of a name",
-              "name": "row"
-            },
-            {
-              "description": "each verdict",
-              "name": "verdict"
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "rows",
-              "type": {
-                "text": "readonly CheckRow[]"
-              },
-              "default": "[]"
-            },
-            {
-              "kind": "field",
-              "name": "showValues",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "true",
-              "description": "Show the values and the verdicts.",
-              "attribute": "showValues"
-            },
-            {
-              "kind": "field",
-              "name": "strings",
-              "type": {
-                "text": "Partial<CheckTableStrings>"
-              },
-              "default": "{}"
-            }
-          ],
-          "attributes": [
-            {
-              "name": "showValues",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "true",
-              "description": "Show the values and the verdicts.",
-              "fieldName": "showValues"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "cae-check-table",
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "verdict",
-          "declaration": {
-            "name": "verdict",
-            "module": "src/checks/check-table.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "CaeCheckTable",
-          "declaration": {
-            "name": "CaeCheckTable",
-            "module": "src/checks/check-table.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/graph/layered-graph.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "NARROW",
-          "type": {
-            "text": "number"
-          },
-          "default": "640",
-          "description": "Below this width, `direction: 'auto'` draws top to bottom, without zoom."
-        },
-        {
-          "kind": "class",
-          "description": "A layered graph: each node in a layer by the longest path to it, edges bending only\nin the gaps between layers and never passing a node or a cluster's label; a cluster\nof nodes in a box (a cluster in a cluster: a box in a box), with, when it `cycle`s,\na dotted return from its last layer to its first; an edge from outside the graph\nfrom a named stub. Inside each node, one mark per series id, at the same place in\nevery node, so a series can be followed across the graph; a mark is drawn in its\nstate's look (`states`). Above `barAt` marks, a node shows a bar of its counts and\nlists its failed marks. The order depends on the structure only, and keeps a\nprevious `order`: nodes that appear later are added at the end of their layer.\n\nA click selects a mark, a node or a cluster (`cae-select`); a card beside it (the\nhost's content, in the `inspector` slot) moves with it as the graph pans and zooms,\nand hides while it is out of the frame; on a narrow screen it is a sheet under the\nframe. A double click or Enter is the item's action (`cae-activate`), or opens its\ninner view (`cae-drill`, for an item with `drill`). Hovering or focusing a mark\nhighlights its series and what `related` names. The frame first shows the whole\ngraph; Ctrl (or ⌘) and the wheel, or the buttons, zoom; dragging pans; \"Show all\"\ngoes back. \"Graph | Table\" changes the view (`cae-view-change`): the table is a row\nper node, with its status and the nodes it is joined to. With `matrix`, the frame\nshows that `<cae-mark-matrix>` as the table instead.\n\nSize: the element is as wide as its container. Without a height set on it, the\nframe is as tall as the whole drawing at that width (never scaled up), up to 70% of\nthe window's height or 360 px, whichever is more, and taller when the card needs\nit; top to bottom, as tall as the drawing. A height set on the element\n(or given it by a flex or grid container) is shared: the `crumbs` slot and the row\nunder the frame keep theirs, and the frame takes the rest, the drawing fitted in it.\n\nKeyboard: Tab moves between nodes; the arrow keys, Home and End move between a\nnode's marks, and a mark out of the frame is brought into it; Shift and an arrow\nkey move along an edge to an earlier or a later node, on the same series; what has\nthe focus is selected (Tab goes on to the card); Enter is the item's action; Escape\nclears the selection (and, with none, is left to the host).",
-          "name": "CaeLayeredGraph",
-          "cssParts": [
-            {
-              "description": "the frame every view is drawn in",
-              "name": "frame"
+              "description": "the frame every view is drawn in",
+              "name": "frame"
             },
             {
               "description": "what pans and zooms",
@@ -3946,236 +4329,618 @@
                   "text": "Promise<void>"
                 }
               },
-              "description": "The first content is drawn without entry animations, then the reader is put back where they were."
+              "description": "The first content is drawn without entry animations, then the reader is put back where they were."
+            },
+            {
+              "kind": "method",
+              "name": "onScroll",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "pick",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "i",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "toLatest",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "loadEarlier",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderPicker",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "sections",
+                  "type": {
+                    "text": "readonly TranscriptSection[]"
+                  }
+                },
+                {
+                  "name": "shown",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "s",
+                  "type": {
+                    "text": "TranscriptStrings"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "renderSection",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "sec",
+                  "type": {
+                    "text": "TranscriptSection"
+                  }
+                },
+                {
+                  "name": "isLast",
+                  "type": {
+                    "text": "boolean"
+                  }
+                },
+                {
+                  "name": "s",
+                  "type": {
+                    "text": "TranscriptStrings"
+                  }
+                },
+                {
+                  "name": "cards",
+                  "type": {
+                    "text": "CardHost"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "renderHead",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "sec",
+                  "type": {
+                    "text": "TranscriptSection"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "renderProse",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "sec",
+                  "type": {
+                    "text": "TranscriptSection"
+                  }
+                },
+                {
+                  "name": "d",
+                  "type": {
+                    "text": "TranscriptDetail"
+                  }
+                }
+              ],
+              "description": "A prose detail is drawn only while it is open."
+            },
+            {
+              "kind": "method",
+              "name": "md",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "id",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "raw",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "bubble",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "av",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "avCls",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "head",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "body",
+                  "type": {
+                    "text": "TemplateResult | string"
+                  }
+                },
+                {
+                  "name": "title",
+                  "optional": true,
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "renderItem",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "it",
+                  "type": {
+                    "text": "TranscriptItem"
+                  }
+                },
+                {
+                  "name": "s",
+                  "type": {
+                    "text": "TranscriptStrings"
+                  }
+                },
+                {
+                  "name": "cards",
+                  "type": {
+                    "text": "CardHost"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "typing",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "s",
+                  "type": {
+                    "text": "TranscriptStrings"
+                  }
+                }
+              ]
+            }
+          ],
+          "events": [
+            {
+              "description": "`{index}`: the reader picked a section (null: the latest)",
+              "name": "cae-section-change"
+            },
+            {
+              "description": "`{index}`: the section on screen changed (-1: none)",
+              "name": "cae-section-shown"
+            },
+            {
+              "description": "the reader asked for the content before `earlier`",
+              "name": "cae-load-earlier"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "live",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "The transcript is still being written: it shows the agent working; a tool call with no result is running, not interrupted.",
+              "fieldName": "live"
+            },
+            {
+              "name": "earlier",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "Lines before the content that are not loaded: above 0, a button asks for them (`cae-load-earlier`).",
+              "fieldName": "earlier"
+            },
+            {
+              "name": "loading",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "The content has not arrived yet: the reader's position is restored once it has.",
+              "fieldName": "loading"
+            },
+            {
+              "name": "mode",
+              "type": {
+                "text": "'full' | 'tabs' | 'none'"
+              },
+              "default": "'full'",
+              "description": "`full`; `tabs`: only the section picker; `none`: hidden.",
+              "fieldName": "mode"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "cae-transcript",
+          "customElement": true
+        },
+        {
+          "kind": "variable",
+          "name": "s"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "CaeTranscript",
+          "declaration": {
+            "name": "CaeTranscript",
+            "module": "src/transcript/transcript.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/tree/tree.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "DEFAULT_TREE_STRINGS",
+          "type": {
+            "text": "Readonly<TreeStrings>"
+          },
+          "default": "{ empty: 'No items' }"
+        },
+        {
+          "kind": "function",
+          "name": "visibleRows",
+          "return": {
+            "type": {
+              "text": "TreeRow[]"
+            }
+          },
+          "parameters": [
+            {
+              "name": "items",
+              "type": {
+                "text": "readonly TreeItem[]"
+              }
+            },
+            {
+              "name": "isOpen",
+              "type": {
+                "text": "(t: TreeItem) => boolean"
+              }
+            }
+          ],
+          "description": "The items shown, top to bottom: every item whose ancestors are all open (`isOpen`)."
+        },
+        {
+          "kind": "function",
+          "name": "ancestorsOf",
+          "return": {
+            "type": {
+              "text": "string[] | null"
+            }
+          },
+          "parameters": [
+            {
+              "name": "items",
+              "type": {
+                "text": "readonly TreeItem[]"
+              }
+            },
+            {
+              "name": "id",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "The ids of the ancestors of item `id`, outermost first; null when no item has that id."
+        },
+        {
+          "kind": "function",
+          "name": "findItem",
+          "return": {
+            "type": {
+              "text": "TreeItem | null"
+            }
+          },
+          "parameters": [
+            {
+              "name": "items",
+              "type": {
+                "text": "readonly TreeItem[]"
+              }
+            },
+            {
+              "name": "match",
+              "type": {
+                "text": "(t: TreeItem) => boolean"
+              }
+            }
+          ],
+          "description": "The first item, depth first, that `match` accepts."
+        },
+        {
+          "kind": "class",
+          "description": "Items in a tree, the children of each under it, folded and opened by the reader: files\nand directories, say. It is one tab stop: Up and Down move between the items shown,\nRight opens an item (then moves to its first child), Left closes it (or moves to its\nparent), Home and End go to the first and the last, a letter to the next item of\nthat initial; Enter, Space or a click selects a selectable item (`cae-select`) and\nopens or closes any other. The toggle before an item with children opens and closes\nit (`cae-toggle`). The ancestors of `selected` are always open.",
+          "name": "CaeTree",
+          "cssParts": [
+            {
+              "description": "the list of items",
+              "name": "tree"
+            },
+            {
+              "description": "an item's row",
+              "name": "item"
+            },
+            {
+              "description": "what it shows with no items",
+              "name": "empty"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "items",
+              "type": {
+                "text": "readonly TreeItem[]"
+              },
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "selected",
+              "type": {
+                "text": "string | null"
+              },
+              "default": "null",
+              "description": "The selected item's id, or null."
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "What the tree is named to a screen reader.",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "strings",
+              "type": {
+                "text": "Partial<TreeStrings>"
+              },
+              "default": "{}",
+              "description": "The visible words; English by default."
+            },
+            {
+              "kind": "field",
+              "name": "opened",
+              "privacy": "private",
+              "default": "new Map<string, boolean>()",
+              "description": "The reader's choice of open and closed items, by id, over each item's `open`."
+            },
+            {
+              "kind": "field",
+              "name": "focusId",
+              "type": {
+                "text": "string | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "The item that holds the tab stop."
             },
             {
-              "kind": "method",
-              "name": "onScroll",
+              "kind": "field",
+              "name": "isOpen",
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
+              "readonly": true
             },
             {
               "kind": "method",
-              "name": "pick",
+              "name": "rowOf",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "HTMLElement | null"
                 }
               },
               "parameters": [
                 {
-                  "name": "i",
+                  "name": "id",
                   "type": {
-                    "text": "number"
+                    "text": "string"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "toLatest",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "loadEarlier",
+              "name": "setOpen",
               "privacy": "private",
               "return": {
                 "type": {
                   "text": "void"
                 }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "renderPicker",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "sections",
-                  "type": {
-                    "text": "readonly TranscriptSection[]"
-                  }
-                },
-                {
-                  "name": "shown",
-                  "type": {
-                    "text": "number"
-                  }
-                },
-                {
-                  "name": "s",
-                  "type": {
-                    "text": "TranscriptStrings"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "renderSection",
-              "privacy": "private",
+              },
               "parameters": [
                 {
-                  "name": "sec",
+                  "name": "t",
                   "type": {
-                    "text": "TranscriptSection"
+                    "text": "TreeItem"
                   }
                 },
                 {
-                  "name": "isLast",
+                  "name": "open",
                   "type": {
                     "text": "boolean"
                   }
-                },
-                {
-                  "name": "s",
-                  "type": {
-                    "text": "TranscriptStrings"
-                  }
-                },
-                {
-                  "name": "cards",
-                  "type": {
-                    "text": "CardHost"
-                  }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "renderHead",
+              "name": "choose",
               "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
               "parameters": [
                 {
-                  "name": "sec",
+                  "name": "t",
                   "type": {
-                    "text": "TranscriptSection"
+                    "text": "TreeItem"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "renderProse",
+              "name": "moveTo",
               "privacy": "private",
-              "parameters": [
-                {
-                  "name": "sec",
-                  "type": {
-                    "text": "TranscriptSection"
-                  }
-                },
-                {
-                  "name": "d",
-                  "type": {
-                    "text": "TranscriptDetail"
-                  }
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
                 }
-              ],
-              "description": "A prose detail is drawn only while it is open."
-            },
-            {
-              "kind": "method",
-              "name": "md",
-              "privacy": "private",
+              },
               "parameters": [
                 {
                   "name": "id",
                   "type": {
                     "text": "string"
                   }
-                },
-                {
-                  "name": "raw",
-                  "type": {
-                    "text": "string"
-                  }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "bubble",
+              "name": "onKey",
               "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
               "parameters": [
                 {
-                  "name": "av",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "avCls",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "head",
+                  "name": "e",
                   "type": {
-                    "text": "string"
+                    "text": "KeyboardEvent"
                   }
                 },
                 {
-                  "name": "body",
+                  "name": "rows",
                   "type": {
-                    "text": "TemplateResult | string"
+                    "text": "readonly TreeRow[]"
                   }
                 },
                 {
-                  "name": "title",
-                  "optional": true,
+                  "name": "i",
                   "type": {
-                    "text": "string"
+                    "text": "number"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "renderItem",
+              "name": "row",
               "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
               "parameters": [
                 {
-                  "name": "it",
+                  "name": "r",
                   "type": {
-                    "text": "TranscriptItem"
+                    "text": "TreeRow"
                   }
                 },
                 {
-                  "name": "s",
+                  "name": "i",
                   "type": {
-                    "text": "TranscriptStrings"
+                    "text": "number"
                   }
                 },
                 {
-                  "name": "cards",
+                  "name": "rows",
                   "type": {
-                    "text": "CardHost"
+                    "text": "readonly TreeRow[]"
                   }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "typing",
-              "privacy": "private",
-              "parameters": [
+                },
                 {
-                  "name": "s",
+                  "name": "stop",
                   "type": {
-                    "text": "TranscriptStrings"
+                    "text": "boolean"
                   }
                 }
               ]
@@ -4183,75 +4948,72 @@
           ],
           "events": [
             {
-              "description": "`{index}`: the reader picked a section (null: the latest)",
-              "name": "cae-section-change"
-            },
-            {
-              "description": "`{index}`: the section on screen changed (-1: none)",
-              "name": "cae-section-shown"
+              "description": "`{id}`: an item was chosen with a click, Enter or Space",
+              "name": "cae-select"
             },
             {
-              "description": "the reader asked for the content before `earlier`",
-              "name": "cae-load-earlier"
+              "description": "`{id, open}`: the reader opened or closed an item",
+              "name": "cae-toggle"
             }
           ],
           "attributes": [
             {
-              "name": "live",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "The transcript is still being written: it shows the agent working; a tool call with no result is running, not interrupted.",
-              "fieldName": "live"
-            },
-            {
-              "name": "earlier",
-              "type": {
-                "text": "number"
-              },
-              "default": "0",
-              "description": "Lines before the content that are not loaded: above 0, a button asks for them (`cae-load-earlier`).",
-              "fieldName": "earlier"
-            },
-            {
-              "name": "loading",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "The content has not arrived yet: the reader's position is restored once it has.",
-              "fieldName": "loading"
-            },
-            {
-              "name": "mode",
+              "name": "label",
               "type": {
-                "text": "'full' | 'tabs' | 'none'"
+                "text": "string"
               },
-              "default": "'full'",
-              "description": "`full`; `tabs`: only the section picker; `none`: hidden.",
-              "fieldName": "mode"
+              "default": "''",
+              "description": "What the tree is named to a screen reader.",
+              "fieldName": "label"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "cae-transcript",
+          "tagName": "cae-tree",
           "customElement": true
-        },
-        {
-          "kind": "variable",
-          "name": "s"
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "CaeTranscript",
+          "name": "DEFAULT_TREE_STRINGS",
           "declaration": {
-            "name": "CaeTranscript",
-            "module": "src/transcript/transcript.ts"
+            "name": "DEFAULT_TREE_STRINGS",
+            "module": "src/tree/tree.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "visibleRows",
+          "declaration": {
+            "name": "visibleRows",
+            "module": "src/tree/tree.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ancestorsOf",
+          "declaration": {
+            "name": "ancestorsOf",
+            "module": "src/tree/tree.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "findItem",
+          "declaration": {
+            "name": "findItem",
+            "module": "src/tree/tree.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CaeTree",
+          "declaration": {
+            "name": "CaeTree",
+            "module": "src/tree/tree.ts"
           }
         }
       ]