@kgdiff/viewer 0.4.0 → 0.6.0

package/vscode.html-custom-data.json

@@ -0,0 +1,726 @@
+{
+  "version": 1.1,
+  "tags": [
+    {
+      "name": "kgdiff-viewer",
+      "description": {
+        "kind": "markdown",
+        "value": "The drop-in viewer: a root (`KgdiffRootElement`) with the default layout, the canvas with its chrome, the change list, the search, the filters and the detail panel.\n\n`header=\"compact\"` leaves the brand and the compared names out of the canvas, for hosts that show their own (such as the playground): the preset `panels=\"title:hidden\"`. `sidebar=\"closed\"` starts with the sidebar folded (`\\` and the sidebar button open it).\n\nA small looping replay for another page: `mode=\"replay\" chrome=\"none\" loop` (with a height of your choosing, such as 320px).\n\nThe canvas has the slots of `<kgdiff-stage>` (`top-start`, `top-end`, `bottom-start`, `bottom-center`, `bottom-end`; the top ones under the title and the actions while those show): a child with `slot=\"top-end\"` goes over the canvas, kept clear of fits and flights. A chrome element slotted in replaces the built-in region of its kind, the title and the actions included; `<kgdiff-zoom>` and `<kgdiff-minimap>` inside the viewer act on its canvas."
+      },
+      "attributes": [
+        {
+          "name": "mode",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflected to the `mode` attribute. Default `overlay`."
+          },
+          "values": [
+            {
+              "name": "overlay"
+            },
+            {
+              "name": "swipe"
+            },
+            {
+              "name": "replay"
+            }
+          ]
+        },
+        {
+          "name": "scope",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflected to the `scope` attribute. Default `all` (`changes` for large graphs). Fixed to `changes` when the layout covers only the changes."
+          },
+          "values": [
+            {
+              "name": "all"
+            },
+            {
+              "name": "changes"
+            }
+          ]
+        },
+        {
+          "name": "theme",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflected to the `theme` attribute. Default `auto`."
+          },
+          "values": [
+            {
+              "name": "auto"
+            },
+            {
+              "name": "light"
+            },
+            {
+              "name": "dark"
+            }
+          ]
+        },
+        {
+          "name": "palette",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflected to the `palette` attribute. Default `default`."
+          },
+          "values": [
+            {
+              "name": "default"
+            },
+            {
+              "name": "colorblind"
+            }
+          ]
+        },
+        {
+          "name": "locale",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflected to the `locale` attribute. Default from `navigator.language`."
+          },
+          "values": [
+            {
+              "name": "en"
+            },
+            {
+              "name": "zh-CN"
+            }
+          ]
+        },
+        {
+          "name": "sync-hash",
+          "description": {
+            "kind": "markdown",
+            "value": "Keep the selection, mode and scope in the page's URL hash (`#kgdiff=hunk:<id>;mode:<mode>;scope:<scope>`) and follow it: deep links."
+          },
+          "valueSet": "v"
+        },
+        {
+          "name": "loop",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflected to the boolean `loop` attribute. In `replay` mode the replay plays by itself and starts again `loopDelay` ms after it ends. `pause()` stops it until `play()`. Default false."
+          },
+          "valueSet": "v"
+        },
+        {
+          "name": "loop-delay",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflected to `loop-delay`: ms between the end of a looping replay and its restart. Default 1200."
+          }
+        },
+        {
+          "name": "pause-on-hover",
+          "description": {
+            "kind": "markdown",
+            "value": "With `loop`, the replay pauses while the pointer is over the graph and continues when it leaves (a mouse or pen; not touch). Reflected as `pause-on-hover=\"false\"` when off. Default true."
+          },
+          "valueSet": "v"
+        },
+        {
+          "name": "shortcuts",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflected to the `shortcuts` attribute: where the keyboard shortcuts apply. `scoped` (the default): while focus is inside the root, or in an element bound to it with `for` (those forward their keys). `global`: also when nothing on the page has focus (for full-page viewers such as HTML reports), for the first such root, except the keys pages scroll with (arrows, Home / End, Page Up / Down, Space); the boolean `global-shortcuts` attribute is an alias. `none`: no shortcuts (a focused change list keeps its arrow keys, Home / End and Enter)."
+          },
+          "values": [
+            {
+              "name": "scoped"
+            },
+            {
+              "name": "global"
+            },
+            {
+              "name": "none"
+            }
+          ]
+        },
+        {
+          "name": "keymap",
+          "description": {
+            "kind": "markdown",
+            "value": "**Experimental:** The shortcut names (`ShortcutName`) are new in 0.6. Single keys of the keyboard map bound to another shortcut, or unbound with `null`: `{ x: null, r: 'review' }`. The `keymap` attribute takes the same as text, `\"x:none r:review\"` (`Space` names the space bar). Keys are `KeyboardEvent.key` values; a letter stands for both its cases unless the other case is named too; keys not named keep the default map; entries naming no shortcut are ignored with a warning."
+          }
+        },
+        {
+          "name": "sidebar",
+          "description": {
+            "kind": "markdown",
+            "value": "A preset: `closed` starts with the sidebar folded (`\\` and the sidebar button open it), `open` with its four regions open. Reflects the sidebar's state once the user toggles it."
+          },
+          "values": [
+            {
+              "name": "open"
+            },
+            {
+              "name": "closed"
+            }
+          ]
+        },
+        {
+          "name": "header",
+          "description": {
+            "kind": "markdown",
+            "value": "A preset: `compact` leaves the brand and the compared names out of the canvas, for hosts that show their own (`panels=\"title:hidden\"`)."
+          },
+          "values": [
+            {
+              "name": "compact"
+            }
+          ]
+        },
+        {
+          "name": "chrome",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflected to the `chrome` attribute. `none` shows the graph alone: no title, actions, view dock (with the step caption and playback bar), change list, zoom buttons, minimap or legend card; the hover tooltip and a one-line legend stay. Clicks and keyboard shortcuts do nothing, the minimum height drops from 420px to 120px, and the view stays fitted: when the canvas is resized (unless the user panned or zoomed since) and at the start of every loop. Labels are never cut at the edge: one pushed from its spot by a neighbour moves inside or is left out. Default `full`."
+          },
+          "values": [
+            {
+              "name": "full"
+            },
+            {
+              "name": "none"
+            }
+          ]
+        },
+        {
+          "name": "legend",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflected to the `legend` attribute: `full` (the card), `mini` (one line: the families this diff has, then unchanged), `none`. Default `auto`: `full`, or `mini` with `chrome=\"none\"`."
+          },
+          "values": [
+            {
+              "name": "auto"
+            },
+            {
+              "name": "full"
+            },
+            {
+              "name": "mini"
+            },
+            {
+              "name": "none"
+            }
+          ]
+        },
+        {
+          "name": "panels",
+          "description": {
+            "kind": "markdown",
+            "value": "The page's declaration of panel states, reflected to the `panels` attribute: a string (`\"detail:collapsed minimap:hidden\"`) or an object (`{ detail: 'collapsed' }`); reading it gives the object. Regions not named keep their state; entries that name no region or state are ignored with a warning. It wins over what the user chose before (remembered) and a report's `view.panels`; the user can still open and close collapsed regions, and declaring the same again keeps what they did. The presets `sidebar=\"closed\"` (list, detail, search and filters collapsed), `header=\"compact\"` (title hidden) and `chrome=\"none\"` (everything but the canvas and the legend hidden) are panel states too; `panels` wins over them for the regions it names. The states every region has now are in `layout`."
+          }
+        },
+        {
+          "name": "persist",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflected to the `persist` attribute. `local` (the default): the layout remembers the user's panel states, sizes, theme, palette and language in `localStorage` (under `persistKey`, shared by the viewers of the origin with the same key). `none`: it remembers nothing."
+          },
+          "values": [
+            {
+              "name": "local"
+            },
+            {
+              "name": "none"
+            }
+          ]
+        },
+        {
+          "name": "persist-key",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflected to the `persist-key` attribute: the `localStorage` key the layout remembers under. Viewers with the same key share what they remember; give each app on a shared origin (a GitHub Pages user site, say) a key of its own. Default `kgdiff:viewer`."
+          }
+        },
+        {
+          "name": "global-shortcuts",
+          "description": {
+            "kind": "markdown",
+            "value": "The same as `shortcuts=\"global\"`."
+          },
+          "valueSet": "v"
+        }
+      ],
+      "references": [
+        {
+          "name": "Reference",
+          "url": "https://github.com/iiwish/kgdiff/blob/main/docs/viewer-elements.md#kgdiff-viewer"
+        }
+      ]
+    },
+    {
+      "name": "kgdiff-root",
+      "description": {
+        "kind": "markdown",
+        "value": "**Experimental:** In 0.6; stable from 0.7 (RFC 0001, decision 7). A root without visuals. It owns the session and provides it to the elements inside it (`<kgdiff-stage>`, `<kgdiff-change-list>`, …) or naming it with `for`, and owns what they share: the keyboard map, the live region announcing navigation, the events and the theme tokens. It has the attributes, properties, methods and events of `<kgdiff-viewer>` except the layout's (`panels`, `sidebar`, `header`, `chrome`, `legend`, `persist`): the page lays the elements out, and nothing is remembered.\n\nIt renders as `display: contents`, so its children are laid out by the page as if it were not there."
+      },
+      "attributes": [
+        {
+          "name": "mode",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflected to the `mode` attribute. Default `overlay`."
+          },
+          "values": [
+            {
+              "name": "overlay"
+            },
+            {
+              "name": "swipe"
+            },
+            {
+              "name": "replay"
+            }
+          ]
+        },
+        {
+          "name": "scope",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflected to the `scope` attribute. Default `all` (`changes` for large graphs). Fixed to `changes` when the layout covers only the changes."
+          },
+          "values": [
+            {
+              "name": "all"
+            },
+            {
+              "name": "changes"
+            }
+          ]
+        },
+        {
+          "name": "theme",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflected to the `theme` attribute. Default `auto`."
+          },
+          "values": [
+            {
+              "name": "auto"
+            },
+            {
+              "name": "light"
+            },
+            {
+              "name": "dark"
+            }
+          ]
+        },
+        {
+          "name": "palette",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflected to the `palette` attribute. Default `default`."
+          },
+          "values": [
+            {
+              "name": "default"
+            },
+            {
+              "name": "colorblind"
+            }
+          ]
+        },
+        {
+          "name": "locale",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflected to the `locale` attribute. Default from `navigator.language`."
+          },
+          "values": [
+            {
+              "name": "en"
+            },
+            {
+              "name": "zh-CN"
+            }
+          ]
+        },
+        {
+          "name": "sync-hash",
+          "description": {
+            "kind": "markdown",
+            "value": "Keep the selection, mode and scope in the page's URL hash (`#kgdiff=hunk:<id>;mode:<mode>;scope:<scope>`) and follow it: deep links."
+          },
+          "valueSet": "v"
+        },
+        {
+          "name": "loop",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflected to the boolean `loop` attribute. In `replay` mode the replay plays by itself and starts again `loopDelay` ms after it ends. `pause()` stops it until `play()`. Default false."
+          },
+          "valueSet": "v"
+        },
+        {
+          "name": "loop-delay",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflected to `loop-delay`: ms between the end of a looping replay and its restart. Default 1200."
+          }
+        },
+        {
+          "name": "pause-on-hover",
+          "description": {
+            "kind": "markdown",
+            "value": "With `loop`, the replay pauses while the pointer is over the graph and continues when it leaves (a mouse or pen; not touch). Reflected as `pause-on-hover=\"false\"` when off. Default true."
+          },
+          "valueSet": "v"
+        },
+        {
+          "name": "shortcuts",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflected to the `shortcuts` attribute: where the keyboard shortcuts apply. `scoped` (the default): while focus is inside the root, or in an element bound to it with `for` (those forward their keys). `global`: also when nothing on the page has focus (for full-page viewers such as HTML reports), for the first such root, except the keys pages scroll with (arrows, Home / End, Page Up / Down, Space); the boolean `global-shortcuts` attribute is an alias. `none`: no shortcuts (a focused change list keeps its arrow keys, Home / End and Enter)."
+          },
+          "values": [
+            {
+              "name": "scoped"
+            },
+            {
+              "name": "global"
+            },
+            {
+              "name": "none"
+            }
+          ]
+        },
+        {
+          "name": "keymap",
+          "description": {
+            "kind": "markdown",
+            "value": "**Experimental:** The shortcut names (`ShortcutName`) are new in 0.6. Single keys of the keyboard map bound to another shortcut, or unbound with `null`: `{ x: null, r: 'review' }`. The `keymap` attribute takes the same as text, `\"x:none r:review\"` (`Space` names the space bar). Keys are `KeyboardEvent.key` values; a letter stands for both its cases unless the other case is named too; keys not named keep the default map; entries naming no shortcut are ignored with a warning."
+          }
+        },
+        {
+          "name": "global-shortcuts",
+          "description": {
+            "kind": "markdown",
+            "value": "The same as `shortcuts=\"global\"`."
+          },
+          "valueSet": "v"
+        }
+      ],
+      "references": [
+        {
+          "name": "Reference",
+          "url": "https://github.com/iiwish/kgdiff/blob/main/docs/viewer-elements.md#kgdiff-root"
+        }
+      ]
+    },
+    {
+      "name": "kgdiff-stage",
+      "description": {
+        "kind": "markdown",
+        "value": "**Experimental:** In 0.6; stable from 0.7 (RFC 0001, decision 7). The canvas of the root it is bound to: the graph, the hover tooltip, the swipe divider, the replay caption and the canvas chrome (view dock, replay transport, legend, zoom buttons and minimap). Each stage is a view of its own: a root draws every stage bound to it, each with its own camera, sharing the selection, the hover, the filters and the search; `version` pins one to a version.\n\nFive named slots take the page's content over the canvas. The stage positions it (12–16 px from the edges, stacked further from the corner than the chrome there), and every slotted element is an obstacle: fits and flights frame the graph in the free part of the canvas. A chrome element slotted in replaces the built-in region of its kind; `panels` keeps applying to the rest. Content positioned some other way registers itself with `registerObstacle`, on the element or on the stage context (`kgdiff.stage/1`) it provides to its descendants."
+      },
+      "attributes": [
+        {
+          "name": "for",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflects the `for` attribute, as on `<label>` and `<output>`: the id of the root to show, or '' (no attribute; setting '' removes it) for the nearest one around the element. Changing it binds again."
+          }
+        },
+        {
+          "name": "panels",
+          "description": {
+            "kind": "markdown",
+            "value": "The states of the built-in chrome (`dock`, `transport`, `legend`, `zoom`, `minimap`), reflected to the `panels` attribute, in the syntax of `<kgdiff-viewer>`'s `panels`: `\"minimap:hidden zoom:hidden\"` or `{ minimap: 'hidden' }`; reading it gives the object. Other regions are ignored with a warning. Default: all open, the legend collapsed."
+          }
+        },
+        {
+          "name": "version",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflected to the `version` attribute: the version this stage draws whatever the root's mode, `before` or `after` (two stages of one root side by side), or null to follow the mode. Another value is ignored with a warning. Each stage has its own camera; the selection, hover, filters and search are the root's, so both bring the same change into view."
+          },
+          "values": [
+            {
+              "name": "before"
+            },
+            {
+              "name": "after"
+            }
+          ]
+        }
+      ],
+      "references": [
+        {
+          "name": "Reference",
+          "url": "https://github.com/iiwish/kgdiff/blob/main/docs/viewer-elements.md#kgdiff-stage"
+        }
+      ]
+    },
+    {
+      "name": "kgdiff-change-list",
+      "description": {
+        "kind": "markdown",
+        "value": "**Experimental:** In 0.6; stable from 0.7 (RFC 0001, decision 7). The \"Changes\" title with the count and review progress, and the changes grouped by phase (a virtualized listbox; `j` / `k` / `x`, Enter, Home / End). A labelled region. While a search is active (the session's query is not blank) its rows step aside. Registers itself as the root's `list` focus target (choosing a search result moves focus here)."
+      },
+      "attributes": [
+        {
+          "name": "for",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflects the `for` attribute, as on `<label>` and `<output>`: the id of the root to show, or '' (no attribute; setting '' removes it) for the nearest one around the element. Changing it binds again."
+          }
+        }
+      ],
+      "references": [
+        {
+          "name": "Reference",
+          "url": "https://github.com/iiwish/kgdiff/blob/main/docs/viewer-elements.md#kgdiff-change-list"
+        }
+      ]
+    },
+    {
+      "name": "kgdiff-change-detail",
+      "description": {
+        "kind": "markdown",
+        "value": "**Experimental:** In 0.6; stable from 0.7 (RFC 0001, decision 7). The selected change, or the selected node: what changed first, then the unchanged rest; prev / next and the reviewed toggle. A labelled region."
+      },
+      "attributes": [
+        {
+          "name": "for",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflects the `for` attribute, as on `<label>` and `<output>`: the id of the root to show, or '' (no attribute; setting '' removes it) for the nearest one around the element. Changing it binds again."
+          }
+        }
+      ],
+      "references": [
+        {
+          "name": "Reference",
+          "url": "https://github.com/iiwish/kgdiff/blob/main/docs/viewer-elements.md#kgdiff-change-detail"
+        }
+      ]
+    },
+    {
+      "name": "kgdiff-search",
+      "description": {
+        "kind": "markdown",
+        "value": "**Experimental:** In 0.6; stable from 0.7 (RFC 0001, decision 7). Node search, a combobox and the results list it owns (its `aria-controls` and `aria-activedescendant` stay inside the element). The results open below the box while the query is not blank; ↑ / ↓ move through them, Enter chooses one (its node and change are selected, and focus moves to the change list), Esc clears. The query lives in the session, so a change list bound to the same root steps aside meanwhile. Registers itself as the root's `search` focus target: `/` focuses the one registered last that is shown."
+      },
+      "attributes": [
+        {
+          "name": "for",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflects the `for` attribute, as on `<label>` and `<output>`: the id of the root to show, or '' (no attribute; setting '' removes it) for the nearest one around the element. Changing it binds again."
+          }
+        }
+      ],
+      "references": [
+        {
+          "name": "Reference",
+          "url": "https://github.com/iiwish/kgdiff/blob/main/docs/viewer-elements.md#kgdiff-search"
+        }
+      ]
+    },
+    {
+      "name": "kgdiff-filters",
+      "description": {
+        "kind": "markdown",
+        "value": "**Experimental:** In 0.6; stable from 0.7 (RFC 0001, decision 7). One chip per kind of change the diff has, with its count and the legend's swatch, toggling the session's family filter, and \"Show all\" while a filter is on."
+      },
+      "attributes": [
+        {
+          "name": "for",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflects the `for` attribute, as on `<label>` and `<output>`: the id of the root to show, or '' (no attribute; setting '' removes it) for the nearest one around the element. Changing it binds again."
+          }
+        }
+      ],
+      "references": [
+        {
+          "name": "Reference",
+          "url": "https://github.com/iiwish/kgdiff/blob/main/docs/viewer-elements.md#kgdiff-filters"
+        }
+      ]
+    },
+    {
+      "name": "kgdiff-view-dock",
+      "description": {
+        "kind": "markdown",
+        "value": "**Experimental:** In 0.6; stable from 0.7 (RFC 0001, decision 7). How the root's diff is viewed. The mode (overlay, swipe, replay; keys `1`–`3`) and \"Changes only\" (key `4`) with its context hops and the nearest \"+N\" expansion. Binds to a root like the other elements (`for`, `htmlFor`, `rootElement`). Slotted into a `<kgdiff-stage>` it replaces the stage's built-in dock; placed anywhere else it is not kept clear of fits and flights unless registered (`stage.registerObstacle`)."
+      },
+      "attributes": [
+        {
+          "name": "for",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflects the `for` attribute, as on `<label>` and `<output>`: the id of the root to show, or '' (no attribute; setting '' removes it) for the nearest one around the element. Changing it binds again."
+          }
+        }
+      ],
+      "references": [
+        {
+          "name": "Reference",
+          "url": "https://github.com/iiwish/kgdiff/blob/main/docs/viewer-elements.md#kgdiff-view-dock"
+        }
+      ]
+    },
+    {
+      "name": "kgdiff-transport",
+      "description": {
+        "kind": "markdown",
+        "value": "**Experimental:** In 0.6; stable from 0.7 (RFC 0001, decision 7). The replay transport of the root's diff. Previous, play / pause, next, the scrubber with one tick per change, the position and the speed; at the end, \"Replay finished · Restart\" above it. Shown in replay mode only. Binds to a root (`for`, `htmlFor`, `rootElement`). Slotted into a `<kgdiff-stage>` (`slot=\"bottom-center\"`, say) it replaces the stage's built-in transport; placed anywhere else it is not kept clear of fits and flights unless registered. Importing this module defines it."
+      },
+      "attributes": [
+        {
+          "name": "for",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflects the `for` attribute, as on `<label>` and `<output>`: the id of the root to show, or '' (no attribute; setting '' removes it) for the nearest one around the element. Changing it binds again."
+          }
+        }
+      ],
+      "references": [
+        {
+          "name": "Reference",
+          "url": "https://github.com/iiwish/kgdiff/blob/main/docs/viewer-elements.md#kgdiff-transport"
+        }
+      ]
+    },
+    {
+      "name": "kgdiff-legend",
+      "description": {
+        "kind": "markdown",
+        "value": "**Experimental:** In 0.6; stable from 0.7 (RFC 0001, decision 7). What the colors mean. `variant=\"full\"` (the default): a card of every family's swatch and name, folded to its head until opened; `open` reflects whether it is (the user's toggle included, as on `<details>`). `variant=\"mini\"`: one line of dots for the families the root's diff has, then the unchanged context. Binds to a root (`for`, `htmlFor`, `rootElement`). Slotted into a `<kgdiff-stage>` it replaces the stage's built-in legend; placed anywhere else it is not kept clear of fits and flights unless registered."
+      },
+      "attributes": [
+        {
+          "name": "for",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflects the `for` attribute, as on `<label>` and `<output>`: the id of the root to show, or '' (no attribute; setting '' removes it) for the nearest one around the element. Changing it binds again."
+          }
+        },
+        {
+          "name": "variant",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflected to `variant`: `full` (default) or `mini`; another value reads `full`."
+          },
+          "values": [
+            {
+              "name": "full"
+            },
+            {
+              "name": "mini"
+            }
+          ]
+        },
+        {
+          "name": "open",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflected to the boolean `open`: whether the card is open (the user's toggle too)."
+          },
+          "valueSet": "v"
+        }
+      ],
+      "references": [
+        {
+          "name": "Reference",
+          "url": "https://github.com/iiwish/kgdiff/blob/main/docs/viewer-elements.md#kgdiff-legend"
+        }
+      ]
+    },
+    {
+      "name": "kgdiff-zoom",
+      "description": {
+        "kind": "markdown",
+        "value": "**Experimental:** In 0.6; stable from 0.7 (RFC 0001, decision 7). Zoom in, zoom out and fit, for one stage's view (the `+` / `−` / `f` keys act on every stage of the root). Binds to the nearest `<kgdiff-stage>` around it, or to the one `stage=\"<id>\"` names (`stage`, `stageElement`, `rootElement`). Slotted into a stage it replaces the stage's built-in zoom buttons; placed anywhere else it is not kept clear of fits and flights unless registered."
+      },
+      "attributes": [
+        {
+          "name": "stage",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflects the `stage` attribute: the id of the stage to act on, or '' (no attribute; setting '' removes it) for the nearest one around the element. Changing it binds again."
+          }
+        }
+      ],
+      "references": [
+        {
+          "name": "Reference",
+          "url": "https://github.com/iiwish/kgdiff/blob/main/docs/viewer-elements.md#kgdiff-zoom"
+        }
+      ]
+    },
+    {
+      "name": "kgdiff-minimap",
+      "description": {
+        "kind": "markdown",
+        "value": "**Experimental:** In 0.6; stable from 0.7 (RFC 0001, decision 7). An overview of one stage's view, with the part in view outlined. While the whole graph is in view it has nothing to add: it is in the custom state `overview` then (`:state(overview)`, and the read-only `overview` property). A minimap the page places stays shown (`kgdiff-minimap:state(overview) { visibility: hidden }` hides it without moving the layout); one slotted into a stage replaces the stage's own and hides as it did. Binds to the nearest `<kgdiff-stage>` around it, or to the one `stage=\"<id>\"` names (`stage`, `stageElement`, `rootElement`). Slotted into a stage it replaces the stage's built-in minimap; placed anywhere else it is not kept clear of fits and flights unless registered."
+      },
+      "attributes": [
+        {
+          "name": "stage",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflects the `stage` attribute: the id of the stage to act on, or '' (no attribute; setting '' removes it) for the nearest one around the element. Changing it binds again."
+          }
+        }
+      ],
+      "references": [
+        {
+          "name": "Reference",
+          "url": "https://github.com/iiwish/kgdiff/blob/main/docs/viewer-elements.md#kgdiff-minimap"
+        }
+      ]
+    },
+    {
+      "name": "kgdiff-title",
+      "description": {
+        "kind": "markdown",
+        "value": "**Experimental:** In 0.6; stable from 0.7 (RFC 0001, decision 7). The kgdiff mark and the root's compared names and versions. Binds to a root (`for`, `htmlFor`, `rootElement`). Slotted into a `<kgdiff-viewer>` it replaces the title over its canvas."
+      },
+      "attributes": [
+        {
+          "name": "for",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflects the `for` attribute, as on `<label>` and `<output>`: the id of the root to show, or '' (no attribute; setting '' removes it) for the nearest one around the element. Changing it binds again."
+          }
+        }
+      ],
+      "references": [
+        {
+          "name": "Reference",
+          "url": "https://github.com/iiwish/kgdiff/blob/main/docs/viewer-elements.md#kgdiff-title"
+        }
+      ]
+    },
+    {
+      "name": "kgdiff-actions",
+      "description": {
+        "kind": "markdown",
+        "value": "**Experimental:** In 0.6; stable from 0.7 (RFC 0001, decision 7). The appearance menu (theme, color palette, language: the root's `theme`, `palette` and `locale`) and the keyboard shortcuts dialog, which `?` opens too. Binds to a root (`for`, `htmlFor`, `rootElement`); bound to a `<kgdiff-viewer>` it has the sidebar toggle too (a composed root has no sidebar). Slotted into a viewer it replaces the actions over its canvas."
+      },
+      "attributes": [
+        {
+          "name": "for",
+          "description": {
+            "kind": "markdown",
+            "value": "Reflects the `for` attribute, as on `<label>` and `<output>`: the id of the root to show, or '' (no attribute; setting '' removes it) for the nearest one around the element. Changing it binds again."
+          }
+        }
+      ],
+      "references": [
+        {
+          "name": "Reference",
+          "url": "https://github.com/iiwish/kgdiff/blob/main/docs/viewer-elements.md#kgdiff-actions"
+        }
+      ]
+    }
+  ]
+}