Add app-shell partial (todo §1); sidebar + topbar + content/nav slots, reuses mockup classes + icon sprite

src/shell.test.ts

@@ -0,0 +1,44 @@
+import assert from "node:assert/strict";
+import { dirname, join } from "node:path";
+import { test } from "node:test";
+import { fileURLToPath } from "node:url";
+import * as ejs from "ejs";
+
+const shell = join(dirname(fileURLToPath(import.meta.url)), "..", "views", "partials", "shell.ejs");
+const render = (data: Record<string, unknown> = {}): Promise<string> => ejs.renderFile(shell, data);
+
+test("app shell renders sidebar, topbar and the content slot", async () => {
+  const html = await render({
+    title: "People",
+    brand: { name: "Acme Console", sub: "v2" },
+    nav: '<a id="nav-marker" href="/x">Overview</a>',
+    body: '<section id="body-marker">page</section>',
+    actions: '<button id="action-marker">Add</button>',
+  });
+
+  // Three structural landmarks of the shell.
+  assert.match(html, /<aside class="sidebar"/);
+  assert.match(html, /<header class="topbar"/);
+  assert.match(html, /<main class="content"/);
+
+  // Slots render their raw HTML where the page injects it.
+  assert.match(html, /<a id="nav-marker"/); // sidebar nav slot
+  assert.match(html, /<section id="body-marker">page<\/section>/); // content slot
+  assert.match(html, /<button id="action-marker"/); // topbar actions slot
+
+  // Branding, document title, and the inlined icon sprite (so <use> resolves).
+  assert.match(html, /Acme Console/);
+  assert.match(html, /<title>People<\/title>/);
+  assert.match(html, /<symbol id="i-menu"/);
+  assert.match(html, /<use href="#i-menu"\s*\/?>/); // hamburger references the menu icon
+});
+
+test("app shell escapes text but passes slot HTML through, and renders with defaults", async () => {
+  const escaped = await render({ title: "<x>", body: "<p>raw</p>" });
+  assert.match(escaped, /<title>&lt;x&gt;<\/title>/); // user text is escaped
+  assert.match(escaped, /<p>raw<\/p>/); // slot HTML is not
+
+  const bare = await render(); // no locals → defaults, must not throw
+  assert.match(bare, /<aside class="sidebar"/);
+  assert.match(bare, /<main class="content"/);
+});