brave · fallaciousreasoning · Dec 16, 2024 · Dec 16, 2024
diff --git a/examples/ssr/package-lock.json b/examples/ssr/package-lock.json
diff --git a/examples/ssr/package.json b/examples/ssr/package.json
@@ -0,0 +1,17 @@
+{
+  "name": "ssr",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@types/express": "^5.0.0",
+    "express": "^4.21.2",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  }
+}
@@ -0,0 +1,31 @@
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="theme-color" content="#000000" />
+    <meta
+      name="description"
+      content="Web site created using HTML & Web Components"
+    />
+    <link href="variables.css" rel="stylesheet" />
+    <title>Web Components</title>
+    <style>
+      body {
+        background: var(--leo-color-page-background);
+        color: var(--leo-color-text-primary);
+        font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto',
+          'Oxygen', 'Ubuntu', 'Cantarell', 'Fira Sans', 'Droid Sans',
+          'Helvetica Neue', sans-serif;
+      }
+    </style>
+  </head>
+
+  <body>
+    <leo-button>Click Me</leo-button>
+    <leo-button href="https://brave.com" kind="outline"
+      >External link</leo-button
+    >
+    <leo-input placeholder="Input"> Custom Label for Input </leo-input>
+    <leo-checkbox checked>Checkbox</leo-checkbox>
+  </body>
+</html>
@@ -0,0 +1,33 @@
+import express from 'express'
+import { render } from '../../src/ssr/render'
+import fs from 'fs/promises'
+
+const app = express()
+
+app.get('/icons/:name', async (req, res) => {
+  const icon = await fs.readFile(`../../icons/${req.params.name}`, 'utf-8')
+  res.type('svg')
+  res.send(icon)
+})
+
+app.get('/variables.css', async (req, res) => {
+  const css = await fs.readFile('../../tokens/css/variables.css', 'utf-8')
+  res.type('css')
+  res.send(css)
+})
+
+app.get('/', async (req, res) => {
+  const rawHtml = await fs.readFile('./raw.html', 'utf-8')
+
+  const html = await render(rawHtml, [
+    () => import('../../web-components/button'),
+    () => import('../../web-components/checkbox'),
+    () => import('../../web-components/input')
+  ])
+  res.type('html')
+  res.send(html)
+})
+
+app.listen(3000, () => {
+  console.log('Server is running on port 3000')
+})
@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "target": "es2016" /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */,
+    "module": "commonjs" /* Specify what module code is generated. */,
+    "esModuleInterop": true /* Emit additional JavaScript to ease support for importing CommonJS modules. This enables 'allowSyntheticDefaultImports' for type compatibility. */,
+    "forceConsistentCasingInFileNames": true /* Ensure that casing is correct in imports. */,
+    "strict": true /* Enable all strict type-checking options. */,
+    "skipDefaultLibCheck": true
+  }
+}
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -66,13 +66,17 @@
   },
   "peerDependencies": {
     "@material/material-color-utilities": ">= 0.2.7",
+    "happy-dom": ">= 15.11.7",
     "react": ">= 16.0.0",
     "typescript": ">= 4.7.0"
   },
   "peerDependenciesMeta": {
     "@material/material-color-utilities": {
       "optional": true
     },
+    "happy-dom": {
+      "optional": true
+    },
     "typescript": {
       "optional": true
     },

@@ -224,7 +224,8 @@ export default function registerWebComponent(
       // we need to also clear the contents of the node, to ensure we don't
       // duplicate content.
       const shadow =
-        this.shadowRoot ?? this.attachShadow({ mode, delegatesFocus: true })
+        this.shadowRoot ??
+        this.attachShadow({ mode, serializable: true, delegatesFocus: true })
       shadow.replaceChildren()
 
       // Unfortunately we need a DOMMutationObserver to let us know when

@@ -0,0 +1,32 @@
+import { Window } from 'happy-dom'
+
+const globals = new Window()
+
+global.window = globals.window as any
+global.document = globals.document as any
+global.customElements = globals.customElements as any
+global.HTMLElement = globals.HTMLElement as any
+global.MutationObserver = globals.MutationObserver as any
+
+/**
+ * Renders custom elements to the DOM, so they render before JavaScript is
+ * loaded. Elements which require JavaScript for interactivity will **NOT**
+ * work until the JavaScript loads.
+ * @param html The HTML to render
+ * @param imports The custom elements to load - these must be imported
+ * dynamically so HappyDOM can load before they are imported.
+ * @returns The rendered HTML
+ */
+export async function render(
+  html: string,
+  imports: (() => Promise<unknown>)[] = []
+) {
+  await Promise.all(imports.map((init) => init()))
+
+  const document = globals.document
+  document.documentElement.innerHTML = html
+
+  await globals.happyDOM.waitUntilComplete()
+
+  return document.documentElement.getHTML({ serializableShadowRoots: true })
+}