update vitepress, fix a build crash, add a sitemap (#1809)

* - upgrade vitepress
- fix a crash with docs:build and figure.append / el.append
- generate a sitemap at ./docs/.vitepress/dist/sitemap.xml

* yarn upgrade

* append coerces to text

---------

Co-authored-by: Mike Bostock <[email protected]>

Author: Fil

docs/.vitepress/config.ts

@@ -29,6 +29,9 @@ export default defineConfig({
     ["script", {async: "", src: "https://www.googletagmanager.com/gtag/js?id=G-9B88TP6PKQ"}],
     ["script", {}, "window.dataLayer=window.dataLayer||[];\nfunction gtag(){dataLayer.push(arguments);}\ngtag('js',new Date());\ngtag('config','G-9B88TP6PKQ');"]
   ],
+  sitemap: {
+    hostname: 'https://observablehq.com/plot'
+  },
   themeConfig: {
     // https://vitepress.dev/reference/default-theme-config
     // Theme related configurations.

docs/components/PlotRender.js

@@ -69,6 +69,11 @@ class Element {
   dispatchEvent() {
     // ignored; interaction needs real DOM
   }
+  append(...children) {
+    for (const child of children) {
+      this.appendChild(child?.ownerDocument ? child : this.ownerDocument.createTextNode(child));
+    }
+  }
   appendChild(child) {
     this.children.push(child);
     child.parentNode = this;

package.json

@@ -72,7 +72,7 @@
     "ts-morph": "^19.0.0",
     "typescript": "^5.0.2",
     "vite": "^4.0.0",
-    "vitepress": "^1.0.0-beta.2"
+    "vitepress": "^1.0.0-rc.4"
   },
   "dependencies": {
     "d3": "^7.8.0",

src/plot.js

@@ -356,13 +356,13 @@ export function plot(options = {}) {
 function createTitleElement(document, contents, tag) {
   if (contents.ownerDocument) return contents;
   const e = document.createElement(tag);
-  e.append(document.createTextNode(contents));
+  e.append(contents);
   return e;
 }
 
 function createFigcaption(document, caption) {
   const e = document.createElement("figcaption");
-  e.append(caption.ownerDocument ? caption : document.createTextNode(caption));
+  e.append(caption);
   return e;
 }