@velumo/theme-show-engine 0.1.0-beta.0

package/scripts/embed-fonts.mjs

@@ -0,0 +1,81 @@
+// Embeds the show-engine theme's woff2 fonts into `src/fonts.generated.ts` as
+// base64 data-URIs, so the theme is self-contained and the DOM renderer can
+// inject `@font-face` rules that reach every surface (deck, presenter, overview,
+// CLI-default) without any font-serving plumbing.
+//
+// Usage:
+//   node scripts/embed-fonts.mjs            # (re)generate src/fonts.generated.ts
+//   node scripts/embed-fonts.mjs --check    # fail if the committed file is stale
+//
+// The fonts are read from the show-engine example's public/fonts directory,
+// which remains the source of truth for the binary woff2 files.
+
+import { readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const scriptDir = dirname(fileURLToPath(import.meta.url));
+const packageDir = join(scriptDir, "..");
+const repoRoot = join(packageDir, "..", "..");
+const fontsDir = join(repoRoot, "examples", "show-engine", "public", "fonts");
+const outFile = join(packageDir, "src", "fonts.generated.ts");
+
+// file (in fontsDir) -> face metadata. The typography tokens name these
+// families/weights; font-display: swap matches the example's prior fonts.css.
+const FACES = [
+  { file: "bebas-neue-latin-400-normal.woff2", family: "Bebas Neue", weight: 400 },
+  { file: "inter-latin-400-normal.woff2", family: "Inter", weight: 400 },
+  { file: "inter-latin-500-normal.woff2", family: "Inter", weight: 500 },
+  { file: "inter-latin-600-normal.woff2", family: "Inter", weight: 600 },
+  { file: "inter-latin-700-normal.woff2", family: "Inter", weight: 700 },
+  { file: "jetbrains-mono-latin-400-normal.woff2", family: "JetBrains Mono", weight: 400 },
+  { file: "jetbrains-mono-latin-500-normal.woff2", family: "JetBrains Mono", weight: 500 },
+  { file: "jetbrains-mono-latin-700-normal.woff2", family: "JetBrains Mono", weight: 700 },
+];
+
+async function render() {
+  const entries = [];
+  for (const face of FACES) {
+    const bytes = await readFile(join(fontsDir, face.file));
+    if (bytes.subarray(0, 4).toString("latin1") !== "wOF2") {
+      throw new Error(`${face.file} is not a woff2 file (missing wOF2 signature)`);
+    }
+    const source = `data:font/woff2;base64,${bytes.toString("base64")}`;
+    entries.push(
+      `  {\n` +
+        `    family: ${JSON.stringify(face.family)},\n` +
+        `    weight: ${face.weight},\n` +
+        `    style: "normal",\n` +
+        `    display: "swap",\n` +
+        `    source: ${JSON.stringify(source)},\n` +
+        `  },`,
+    );
+  }
+
+  return (
+    `// AUTO-GENERATED by scripts/embed-fonts.mjs — do not edit by hand.\n` +
+    `// Regenerate with: node scripts/embed-fonts.mjs\n` +
+    `// The woff2 bytes are OFL-licensed; see OFL.txt and README.md.\n` +
+    `import type { ThemeFontFace } from "@velumo/core";\n\n` +
+    `export const showEngineFonts: readonly ThemeFontFace[] = [\n` +
+    `${entries.join("\n")}\n` +
+    `];\n`
+  );
+}
+
+const check = process.argv.includes("--check");
+const rendered = await render();
+
+if (check) {
+  const existing = await readFile(outFile, "utf8").catch(() => "");
+  if (existing !== rendered) {
+    console.error(
+      "fonts.generated.ts is stale — run `node scripts/embed-fonts.mjs`.",
+    );
+    process.exit(1);
+  }
+  console.log("fonts.generated.ts is up to date.");
+} else {
+  await writeFile(outFile, rendered);
+  console.log(`Wrote ${outFile} (${FACES.length} faces).`);
+}