@jokerized/decksmith 0.6.0 → 0.7.0

package/README.md

@@ -850,8 +850,8 @@ Three, each a position rather than a hue.
 
 `mono`'s four tones are a grey ladder plus one red rather than four hues, because value is
 what survives a bad projector and hue is not; four hues would have collapsed into one
-grey. All three keep the Inter stack — font families auto-resolve from a fixed allowlist,
-and a serif naming a family the bundle does not declare falls back silently.
+grey. All three keep the Inter stack — `build` ships Inter beside every deck, and a serif
+naming a family the deck does not declare falls back silently.
 
 A theme is a name and a palette, and that is the whole extension point: a new one is a
 file in `src/emit/themes/` plus a line in `THEMES`. No archetype learns it exists.
@@ -1204,8 +1204,10 @@ mechanically rather than free-hand.
   presented, never rendered, and its subtitle loop legitimately reads a clock.
 - `deck.html` never contains the string `data-composition-id`. A root-level HTML file that
   does trips lint's `multiple_root_compositions`, and the deck stops being navigable.
-- Fonts auto-resolve only from a fixed allowlist. Inter is on it, Noto Sans KR is not, so
-  every CJK deck ships its own subsetted `@font-face` or the text silently falls back.
+- Every deck declares the face its stack names. A CJK deck ships a subsetted Noto; every
+  other deck ships Inter from `@fontsource-variable/inter`. HyperFrames resolves Inter from
+  its own allowlist, but only inside a render: the gates' page and `deck.html` never run its
+  compiler, and without the deck's own face they drew SF on a Mac and DejaVu on Linux.
 - Audience text never goes below 40px at 1920x1080, display equations sit at 60–76px. A
   30px equation passes every automated gate and is unreadable from row six.
 - **No archetype declares its own content width.** The box comes from

package/dist/cli.js

@@ -157,6 +157,11 @@ async function copyAudio(from, narration, out, step2) {
   return names.map((n3) => join2(dir, n3));
 }
 async function refreshFont(storyboard, source, out, step2) {
+  if (familyFor(storyboard.lang) === null) {
+    const css = await vendorInter(join2(out, "assets", "fonts"));
+    step2("build: vendored Inter beside the deck");
+    return css;
+  }
   try {
     const bundle = await bundleFont(
       storyboard.lang,
@@ -172,6 +177,21 @@ async function refreshFont(storyboard, source, out, step2) {
     return void 0;
   }
 }
+async function vendorInter(dir) {
+  const pkg = dirname(createRequire(import.meta.url).resolve("@fontsource-variable/inter"));
+  const css = await readFile2(join2(pkg, "index.css"), "utf8");
+  await mkdir2(dir, { recursive: true });
+  for (const [, name] of css.matchAll(/url\(\.\/files\/([^)]+)\)/g)) {
+    await cp(join2(pkg, "files", name ?? ""), join2(dir, name ?? ""));
+  }
+  const ours = css.replaceAll("font-family: 'Inter Variable'", "font-family: 'Inter'").replaceAll("font-display: swap", "font-display: block").replace(/url\(\.\/files\/([^)]+)\) format\('woff2-variations'\)/g, "url($1) format('woff2')");
+  if (/Inter Variable|\.\/files\/|swap/.test(ours) || !ours.includes("font-family: 'Inter';")) {
+    throw new Error(
+      `@fontsource-variable/inter's index.css changed shape; update vendorInter (${pkg})`
+    );
+  }
+  return ours;
+}
 
 // src/emit/kit.ts
 var PAD_X = 110;

package/dist/index.js

@@ -152,6 +152,11 @@ async function copyAudio(from, narration, out, step) {
   return names.map((n3) => join2(dir, n3));
 }
 async function refreshFont(storyboard, source, out, step) {
+  if (familyFor(storyboard.lang) === null) {
+    const css = await vendorInter(join2(out, "assets", "fonts"));
+    step("build: vendored Inter beside the deck");
+    return css;
+  }
   try {
     const bundle = await bundleFont(
       storyboard.lang,
@@ -167,6 +172,21 @@ async function refreshFont(storyboard, source, out, step) {
     return void 0;
   }
 }
+async function vendorInter(dir) {
+  const pkg = dirname(createRequire(import.meta.url).resolve("@fontsource-variable/inter"));
+  const css = await readFile2(join2(pkg, "index.css"), "utf8");
+  await mkdir2(dir, { recursive: true });
+  for (const [, name] of css.matchAll(/url\(\.\/files\/([^)]+)\)/g)) {
+    await cp(join2(pkg, "files", name ?? ""), join2(dir, name ?? ""));
+  }
+  const ours = css.replaceAll("font-family: 'Inter Variable'", "font-family: 'Inter'").replaceAll("font-display: swap", "font-display: block").replace(/url\(\.\/files\/([^)]+)\) format\('woff2-variations'\)/g, "url($1) format('woff2')");
+  if (/Inter Variable|\.\/files\/|swap/.test(ours) || !ours.includes("font-family: 'Inter';")) {
+    throw new Error(
+      `@fontsource-variable/inter's index.css changed shape; update vendorInter (${pkg})`
+    );
+  }
+  return ours;
+}
 
 // src/emit/kit.ts
 var PAD_X = 110;

package/dist/mcp.js

@@ -218,6 +218,11 @@ async function copyAudio(from, narration, out, step) {
   return names.map((n3) => join3(dir, n3));
 }
 async function refreshFont(storyboard, source, out, step) {
+  if (familyFor(storyboard.lang) === null) {
+    const css = await vendorInter(join3(out, "assets", "fonts"));
+    step("build: vendored Inter beside the deck");
+    return css;
+  }
   try {
     const bundle = await bundleFont(
       storyboard.lang,
@@ -233,6 +238,21 @@ async function refreshFont(storyboard, source, out, step) {
     return void 0;
   }
 }
+async function vendorInter(dir) {
+  const pkg = dirname2(createRequire3(import.meta.url).resolve("@fontsource-variable/inter"));
+  const css = await readFile2(join3(pkg, "index.css"), "utf8");
+  await mkdir2(dir, { recursive: true });
+  for (const [, name] of css.matchAll(/url\(\.\/files\/([^)]+)\)/g)) {
+    await cp(join3(pkg, "files", name ?? ""), join3(dir, name ?? ""));
+  }
+  const ours = css.replaceAll("font-family: 'Inter Variable'", "font-family: 'Inter'").replaceAll("font-display: swap", "font-display: block").replace(/url\(\.\/files\/([^)]+)\) format\('woff2-variations'\)/g, "url($1) format('woff2')");
+  if (/Inter Variable|\.\/files\/|swap/.test(ours) || !ours.includes("font-family: 'Inter';")) {
+    throw new Error(
+      `@fontsource-variable/inter's index.css changed shape; update vendorInter (${pkg})`
+    );
+  }
+  return ours;
+}
 
 // src/emit/kit.ts
 var PAD_X = 110;

package/dist/types/build/files.d.ts

@@ -97,6 +97,8 @@ export declare function copyAudio(from: string, narration: DeckNarration, out: s
  * Every glyph a document or plan can put on screen: serializing the whole object
  * over-collects ids and TeX, but those are ASCII and the bundle only exists for
  * CJK — over-collecting costs a few bytes, under-collecting costs a tofu box.
+ *
+ * A Latin deck gets `vendorInter` instead: nothing to subset, nothing to fetch.
  */
 export declare function refreshFont(storyboard: Storyboard, source: Source, out: string, step: Step): Promise<string | undefined>;
 export {};

package/dist/types/emit/composition.d.ts

@@ -102,8 +102,9 @@ export interface DeckOptions {
      * naming a family the bundle does not declare falls back silently.
      *
      * Passed in rather than read here because this function does no I/O. Absent,
-     * the link is emitted as before, so a caller that has no bundle is unchanged
-     * and every non-CJK deck is byte-identical either way.
+     * the link is emitted as before, so a caller that has no bundle is unchanged.
+     * `build` passes one for every deck: a Latin deck's is the vendored Inter
+     * (`vendorInter` in src/build/files.ts), for the same reason.
      */
     fontCss?: string;
 }

package/dist/types/source/fonts.d.ts

@@ -6,7 +6,7 @@ export interface FontBundle {
     /** The woff2 basenames written into `dir`, beside `fonts.css`. */
     files: string[];
 }
-/** The family a language needs shipped, or null when the renderer supplies one. */
+/** The CJK family a language needs subset, or null: the deck ships Inter (`vendorInter`). */
 export declare function familyFor(lang: string): string | null;
 /**
  * Write `dir/fonts.css` plus its woff2 for `lang`, covering `glyphs`. Returns

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jokerized/decksmith",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Turn a source document into an animated explanation deck.",
   "type": "module",
   "license": "MIT",
@@ -58,6 +58,7 @@
     "demo": "node demo/build.mjs && node dist/cli.js build demo/storyboard.json --source demo/source.json -o demo/deck && python3 -m http.server 8080 --directory demo/deck --bind 127.0.0.1"
   },
   "dependencies": {
+    "@fontsource-variable/inter": "5.3.0",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "@puppeteer/browsers": "^3.0.6",
     "commander": "^14.0.1",