@jokerized/decksmith 0.1.2 → 0.1.4

package/dist/cli.js

@@ -2,7 +2,7 @@
 
 // src/cli.ts
 import { cp, mkdir as mkdir7, readdir as readdir3, readFile as readFile13, stat, writeFile as writeFile8 } from "node:fs/promises";
-import { createRequire as createRequire2 } from "node:module";
+import { createRequire as createRequire3 } from "node:module";
 import { dirname as dirname4, join as join12, relative as relative2, resolve as resolve3 } from "node:path";
 import { fileURLToPath } from "node:url";
 import { Command } from "commander";
@@ -1053,24 +1053,55 @@ var ADVANCE = {
 var KERN_SLACK = 1.007;
 var TABULAR_FIGURE = 0.649;
 var TABULAR_SEPARATOR = 0.269;
+var BLOCK_ADVANCE = [
+  [12288, 12351, 1],
+  // CJK symbols and punctuation
+  [12352, 12447, 1],
+  // hiragana
+  [12448, 12543, 1],
+  // katakana
+  [12592, 12687, 0.92],
+  // Hangul compatibility jamo
+  [13312, 19903, 1],
+  // CJK unified ideographs, extension A
+  [19968, 40959, 1],
+  // CJK unified ideographs
+  [44032, 55203, 0.92],
+  // Hangul syllables
+  [63744, 64255, 1],
+  // CJK compatibility ideographs
+  [65281, 65376, 1]
+  // full-width forms
+];
+var UNMEASURED = 1.02;
 function charUnits(c, tabular) {
   if (tabular) {
-    if (c >= "0" && c <= "9") return TABULAR_FIGURE;
-    if (c === "." || c === ",") return TABULAR_SEPARATOR;
+    if (c >= "0" && c <= "9") return [TABULAR_FIGURE, true];
+    if (c === "." || c === ",") return [TABULAR_SEPARATOR, true];
   }
-  return ADVANCE[c] ?? 1.02;
+  const measured = ADVANCE[c];
+  if (measured !== void 0) return [measured, true];
+  const cp2 = c.codePointAt(0) ?? 0;
+  for (const [lo, hi, units] of BLOCK_ADVANCE) if (cp2 >= lo && cp2 <= hi) return [units, false];
+  return [UNMEASURED, true];
 }
 function weightFactor(weight) {
   return weight >= 700 ? 1.045 : weight >= 600 ? 1.03 : weight >= 500 ? 1.015 : 1;
 }
 function textWidth(text2, fontSize, weight = 400, tracking = 0, tabular = false) {
-  let units = 0;
+  let weighted = 0;
+  let emGrid = 0;
   let chars = 0;
   for (const c of text2) {
-    units += charUnits(c, tabular);
+    const [units, scalesWithWeight] = charUnits(c, tabular);
+    if (scalesWithWeight) weighted += units;
+    else emGrid += units;
     chars++;
   }
-  return units * KERN_SLACK * fontSize * weightFactor(weight) + tracking * fontSize * chars;
+  if (emGrid === 0) {
+    return weighted * KERN_SLACK * fontSize * weightFactor(weight) + tracking * fontSize * chars;
+  }
+  return (weighted * weightFactor(weight) + emGrid) * KERN_SLACK * fontSize + tracking * fontSize * chars;
 }
 function wrap(text2, fontSize, maxWidth, weight = 400, tracking = 0) {
   if (maxWidth <= 0) return [text2];
@@ -4620,7 +4651,7 @@ var SENTENCES_PER_BEAT = 2;
 var FF_BEAT_SECONDS = 8;
 var MIN_BEAT_SECONDS = 4;
 var SHORT_FORM_CPS = 22;
-var CUE_OVERHEAD = 1.28;
+var CUE_OVERHEAD = 1.3;
 var COMFORTABLE_CPS = 17;
 var MAX_PLAYBACK = 1.25;
 var SPEAKING_STOPS = {
@@ -4630,10 +4661,10 @@ var SPEAKING_STOPS = {
 };
 var RATE_STEPS = [
   ["+0%", 1],
-  ["+10%", 1.187],
-  ["+20%", 1.252],
-  ["+30%", 1.394],
-  ["+40%", 1.533]
+  ["+10%", 1.086],
+  ["+20%", 1.182],
+  ["+30%", 1.278],
+  ["+40%", 1.393]
 ];
 function durationPlan(prefs) {
   const speakingStops = SPEAKING_STOPS[prefs.narration.density];
@@ -8340,6 +8371,10 @@ async function readCompositions(dir) {
   );
 }
 
+// src/version.ts
+import { createRequire as createRequire2 } from "node:module";
+var VERSION = createRequire2(import.meta.url)("../package.json").version;
+
 // src/cli.ts
 var AUDIO_DIR = "audio";
 var NARRATION_FILE = "narration.json";
@@ -8353,7 +8388,7 @@ async function deckRuntime() {
   }
 }
 function playerBundle() {
-  const require2 = createRequire2(import.meta.url);
+  const require2 = createRequire3(import.meta.url);
   try {
     return join12(dirname4(require2.resolve("hyperframes/package.json")), "dist", PLAYER_FILE);
   } catch {
@@ -8361,7 +8396,7 @@ function playerBundle() {
   }
 }
 async function vendorKatex(out) {
-  const require2 = createRequire2(import.meta.url);
+  const require2 = createRequire3(import.meta.url);
   const dist = join12(dirname4(require2.resolve("katex/package.json")), "dist");
   const css = await readFile13(join12(dist, "katex.min.css"), "utf8");
   await mkdir7(join12(out, "katex/fonts"), { recursive: true });
@@ -8376,7 +8411,7 @@ async function vendorKatex(out) {
   await writeFile8(join12(out, "katex/katex.min.css"), woff2Only);
 }
 async function vendorScripts(out) {
-  const require2 = createRequire2(import.meta.url);
+  const require2 = createRequire3(import.meta.url);
   await mkdir7(join12(out, "vendor"), { recursive: true });
   for (const [pkg, rel, name] of [
     ["gsap/package.json", "dist/gsap.min.js", "gsap.min.js"],
@@ -8435,7 +8470,7 @@ function stated(prefs, key) {
   return prefs[key] === DEFAULTS[key] ? void 0 : prefs[key];
 }
 var program = new Command();
-program.name("decksmith").description("Turn a source document into an animated explanation deck.").version("0.1.0");
+program.name("decksmith").description("Turn a source document into an animated explanation deck.").version(VERSION);
 program.command("ingest").description("Parse a document into source.json, localising its figures and font.").argument("<input>", "source document (markdown)").requiredOption("-o, --out <file>", "where to write source.json").option("--lang <bcp47>", "override the sniffed language").action(async (input, o) => {
   const md = await readFile13(resolve3(input), "utf8").catch(() => {
     throw new Error(`Cannot read ${input}.`);

package/dist/index.js

@@ -1053,24 +1053,55 @@ var ADVANCE = {
 var KERN_SLACK = 1.007;
 var TABULAR_FIGURE = 0.649;
 var TABULAR_SEPARATOR = 0.269;
+var BLOCK_ADVANCE = [
+  [12288, 12351, 1],
+  // CJK symbols and punctuation
+  [12352, 12447, 1],
+  // hiragana
+  [12448, 12543, 1],
+  // katakana
+  [12592, 12687, 0.92],
+  // Hangul compatibility jamo
+  [13312, 19903, 1],
+  // CJK unified ideographs, extension A
+  [19968, 40959, 1],
+  // CJK unified ideographs
+  [44032, 55203, 0.92],
+  // Hangul syllables
+  [63744, 64255, 1],
+  // CJK compatibility ideographs
+  [65281, 65376, 1]
+  // full-width forms
+];
+var UNMEASURED = 1.02;
 function charUnits(c, tabular) {
   if (tabular) {
-    if (c >= "0" && c <= "9") return TABULAR_FIGURE;
-    if (c === "." || c === ",") return TABULAR_SEPARATOR;
+    if (c >= "0" && c <= "9") return [TABULAR_FIGURE, true];
+    if (c === "." || c === ",") return [TABULAR_SEPARATOR, true];
   }
-  return ADVANCE[c] ?? 1.02;
+  const measured = ADVANCE[c];
+  if (measured !== void 0) return [measured, true];
+  const cp2 = c.codePointAt(0) ?? 0;
+  for (const [lo, hi, units] of BLOCK_ADVANCE) if (cp2 >= lo && cp2 <= hi) return [units, false];
+  return [UNMEASURED, true];
 }
 function weightFactor(weight) {
   return weight >= 700 ? 1.045 : weight >= 600 ? 1.03 : weight >= 500 ? 1.015 : 1;
 }
 function textWidth(text2, fontSize, weight = 400, tracking = 0, tabular = false) {
-  let units = 0;
+  let weighted = 0;
+  let emGrid = 0;
   let chars = 0;
   for (const c of text2) {
-    units += charUnits(c, tabular);
+    const [units, scalesWithWeight] = charUnits(c, tabular);
+    if (scalesWithWeight) weighted += units;
+    else emGrid += units;
     chars++;
   }
-  return units * KERN_SLACK * fontSize * weightFactor(weight) + tracking * fontSize * chars;
+  if (emGrid === 0) {
+    return weighted * KERN_SLACK * fontSize * weightFactor(weight) + tracking * fontSize * chars;
+  }
+  return (weighted * weightFactor(weight) + emGrid) * KERN_SLACK * fontSize + tracking * fontSize * chars;
 }
 function wrap(text2, fontSize, maxWidth, weight = 400, tracking = 0) {
   if (maxWidth <= 0) return [text2];
@@ -5131,7 +5162,7 @@ var SENTENCES_PER_BEAT = 2;
 var FF_BEAT_SECONDS = 8;
 var MIN_BEAT_SECONDS = 4;
 var SHORT_FORM_CPS = 22;
-var CUE_OVERHEAD = 1.28;
+var CUE_OVERHEAD = 1.3;
 var COMFORTABLE_CPS = 17;
 var MAX_PLAYBACK = 1.25;
 var SPEAKING_STOPS = {
@@ -5141,10 +5172,10 @@ var SPEAKING_STOPS = {
 };
 var RATE_STEPS = [
   ["+0%", 1],
-  ["+10%", 1.187],
-  ["+20%", 1.252],
-  ["+30%", 1.394],
-  ["+40%", 1.533]
+  ["+10%", 1.086],
+  ["+20%", 1.182],
+  ["+30%", 1.278],
+  ["+40%", 1.393]
 ];
 function durationPlan(prefs) {
   const speakingStops = SPEAKING_STOPS[prefs.narration.density];

package/dist/mcp.js

@@ -7,6 +7,10 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import { z as z4 } from "zod";
 
+// src/version.ts
+import { createRequire } from "node:module";
+var VERSION = createRequire(import.meta.url)("../package.json").version;
+
 // src/mcp/tools.ts
 import { randomBytes } from "node:crypto";
 import { mkdir as mkdir9, readFile as readFile10 } from "node:fs/promises";
@@ -16,7 +20,7 @@ import { z as z3 } from "zod";
 
 // src/index.ts
 import { cp, mkdir as mkdir7, readdir, readFile as readFile8, stat, writeFile as writeFile8 } from "node:fs/promises";
-import { createRequire } from "node:module";
+import { createRequire as createRequire2 } from "node:module";
 import { dirname as dirname3, join as join7, resolve as resolve2 } from "node:path";
 import { fileURLToPath } from "node:url";
 
@@ -1053,24 +1057,55 @@ var ADVANCE = {
 var KERN_SLACK = 1.007;
 var TABULAR_FIGURE = 0.649;
 var TABULAR_SEPARATOR = 0.269;
+var BLOCK_ADVANCE = [
+  [12288, 12351, 1],
+  // CJK symbols and punctuation
+  [12352, 12447, 1],
+  // hiragana
+  [12448, 12543, 1],
+  // katakana
+  [12592, 12687, 0.92],
+  // Hangul compatibility jamo
+  [13312, 19903, 1],
+  // CJK unified ideographs, extension A
+  [19968, 40959, 1],
+  // CJK unified ideographs
+  [44032, 55203, 0.92],
+  // Hangul syllables
+  [63744, 64255, 1],
+  // CJK compatibility ideographs
+  [65281, 65376, 1]
+  // full-width forms
+];
+var UNMEASURED = 1.02;
 function charUnits(c, tabular) {
   if (tabular) {
-    if (c >= "0" && c <= "9") return TABULAR_FIGURE;
-    if (c === "." || c === ",") return TABULAR_SEPARATOR;
+    if (c >= "0" && c <= "9") return [TABULAR_FIGURE, true];
+    if (c === "." || c === ",") return [TABULAR_SEPARATOR, true];
   }
-  return ADVANCE[c] ?? 1.02;
+  const measured = ADVANCE[c];
+  if (measured !== void 0) return [measured, true];
+  const cp2 = c.codePointAt(0) ?? 0;
+  for (const [lo, hi, units] of BLOCK_ADVANCE) if (cp2 >= lo && cp2 <= hi) return [units, false];
+  return [UNMEASURED, true];
 }
 function weightFactor(weight) {
   return weight >= 700 ? 1.045 : weight >= 600 ? 1.03 : weight >= 500 ? 1.015 : 1;
 }
 function textWidth(text2, fontSize, weight = 400, tracking = 0, tabular = false) {
-  let units = 0;
+  let weighted = 0;
+  let emGrid = 0;
   let chars = 0;
   for (const c of text2) {
-    units += charUnits(c, tabular);
+    const [units, scalesWithWeight] = charUnits(c, tabular);
+    if (scalesWithWeight) weighted += units;
+    else emGrid += units;
     chars++;
   }
-  return units * KERN_SLACK * fontSize * weightFactor(weight) + tracking * fontSize * chars;
+  if (emGrid === 0) {
+    return weighted * KERN_SLACK * fontSize * weightFactor(weight) + tracking * fontSize * chars;
+  }
+  return (weighted * weightFactor(weight) + emGrid) * KERN_SLACK * fontSize + tracking * fontSize * chars;
 }
 function wrap(text2, fontSize, maxWidth, weight = 400, tracking = 0) {
   if (maxWidth <= 0) return [text2];
@@ -5128,7 +5163,7 @@ var SENTENCES_PER_BEAT = 2;
 var FF_BEAT_SECONDS = 8;
 var MIN_BEAT_SECONDS = 4;
 var SHORT_FORM_CPS = 22;
-var CUE_OVERHEAD = 1.28;
+var CUE_OVERHEAD = 1.3;
 var COMFORTABLE_CPS = 17;
 var MAX_PLAYBACK = 1.25;
 var SPEAKING_STOPS = {
@@ -5138,10 +5173,10 @@ var SPEAKING_STOPS = {
 };
 var RATE_STEPS = [
   ["+0%", 1],
-  ["+10%", 1.187],
-  ["+20%", 1.252],
-  ["+30%", 1.394],
-  ["+40%", 1.533]
+  ["+10%", 1.086],
+  ["+20%", 1.182],
+  ["+30%", 1.278],
+  ["+40%", 1.393]
 ];
 function durationPlan(prefs) {
   const speakingStops = SPEAKING_STOPS[prefs.narration.density];
@@ -6906,7 +6941,7 @@ async function deckRuntime() {
   }
 }
 function playerBundle() {
-  const require2 = createRequire(import.meta.url);
+  const require2 = createRequire2(import.meta.url);
   try {
     return join7(dirname3(require2.resolve("hyperframes/package.json")), "dist", PLAYER_FILE);
   } catch {
@@ -6914,7 +6949,7 @@ function playerBundle() {
   }
 }
 async function vendorKatex(out) {
-  const require2 = createRequire(import.meta.url);
+  const require2 = createRequire2(import.meta.url);
   const dist = join7(dirname3(require2.resolve("katex/package.json")), "dist");
   const css = await readFile8(join7(dist, "katex.min.css"), "utf8");
   const written = [];
@@ -8168,7 +8203,7 @@ var TOOLS = [
     inputSchema: schema(statusSchema)
   }
 ];
-var server = new Server({ name: "decksmith", version: "0.1.0" }, { capabilities: { tools: {} } });
+var server = new Server({ name: "decksmith", version: VERSION }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
 server.setRequestHandler(CallToolRequestSchema, async (req) => {
   const args = req.params.arguments ?? {};

package/dist/types/plan/duration.d.ts

@@ -212,13 +212,49 @@ export declare const SHORT_FORM_CPS = 22;
  * takes `+10%` and lands at 21.9. Wrong in the OUTPUT, not in a gate — no gate
  * looks at this, which is why it survived.
  *
- * SCALE-INVARIANCE IS ASSUMED, and is the one thing here not measured: the ratio
- * is taken at `+0%` and applied at every step, on the reasoning that speeding the
- * voice up shrinks the cue windows and the breaths between them together.
- * Measuring it at `+10%` and `+20%` means synthesising the demo again at those
- * rates. `test/duration.test.ts` pins the `+0%` end against the artifact.
+ * SCALE-INVARIANCE IS MEASURED, and it holds. The ratio is taken at `+0%` and
+ * applied at every step, on the reasoning that speeding the voice up shrinks the
+ * cue windows and the breaths between them together. `scripts/measure-cue-rate.mjs`
+ * re-synthesised all 37 segments at all five steps — `+0%` included, in one
+ * session, because edge-tts does not repeat itself and a fresh rate judged
+ * against a stored baseline measures the drift instead:
+ *
+ * ```
+ *   rate    meanCps   p95 cue   p95/mean   median/mean
+ *   +0%      14.509    18.089     1.2467        1.0601
+ *   +10%     15.752    20.392     1.2945        1.0653
+ *   +20%     17.148    21.321     1.2434        1.0567
+ *   +30%     18.540    23.263     1.2548        1.0572
+ *   +40%     20.205    25.515     1.2628        1.0663
+ * ```
+ *
+ * No trend in rate — so this stays a constant rather than becoming a function of
+ * the step. The p95 column wobbles because p95 over 39 cues IS THE SECOND-HIGHEST
+ * CUE, one window wide; `median/mean` is flat to within a percent, and it is the
+ * honest read on whether the distribution's shape moves. It does not.
+ *
+ * IT AND `RATE_STEPS` ARE ONE UNIT, and they moved together — 2026-08-02, from
+ * the run above. Read that table's `speedup` note before changing either.
+ *
+ * WHY 1.30 AND NOT 1.2945. It has to sit above EVERY ratio the run observed,
+ * because the number it feeds is a ceiling on caption readability and being
+ * under it means shipping captions faster than `SHORT_FORM_CPS`. The old 1.28
+ * was below the `+10%` reading and got away with it only because the speedups
+ * beside it were inflated by more — two errors cancelling, which is not a margin
+ * anyone can reason about. Correcting the speedups removed that cover, so this
+ * had to rise with them.
+ *
+ * IT COSTS A STEP, KNOWINGLY. The demo's real p95 cue at `+20%` is 21.321,
+ * inside the ceiling of 22 — but this predicts 22.13 for that step and refuses
+ * it, so the deck takes `+10%` and speaks slower than the artifact proves it
+ * could. A central estimate of ~1.26 would admit `+20%` and track the artifact
+ * to within 0.6%; it would also under-predict on about half of future runs. The
+ * trade was made deliberately in favour of never being under, on a statistic
+ * measured once over 39 cues.
+ *
+ * `test/duration.test.ts` pins the `+0%` end against the artifact.
  */
-export declare const CUE_OVERHEAD = 1.28;
+export declare const CUE_OVERHEAD = 1.3;
 /** Broadcast subtitle practice. Past this the captions stop being readable. */
 export declare const COMFORTABLE_CPS = 17;
 /** How far playback may be sped up before the captions are the problem. */
@@ -261,6 +297,29 @@ export declare const SPEAKING_STOPS: Record<Prefs["narration"]["density"], numbe
  * `+60%` it is 28.5 and the caption is gone before it is read. `+50%` is
  * excluded for measuring slower than the step below it.
  *
+ * THE SPEEDUPS BELOW ARE NOT FROM THAT TABLE. They were, and they were too high
+ * at every step. The table above times ONE 72-character sentence, and a short
+ * sentence carries proportionally more silence at its ends, so dividing its
+ * total duration overstates what the prosody rate does to speech itself.
+ * Re-measured over the anchor deck's 37 segments and 196 seconds:
+ *
+ * ```
+ *   step    was      is    from
+ *   +10%  1.187   1.086    meanCps 15.752 / 14.509
+ *   +20%  1.252   1.182    meanCps 17.148 / 14.509
+ *   +30%  1.394   1.278    meanCps 18.540 / 14.509
+ *   +40%  1.533   1.393    meanCps 20.205 / 14.509
+ * ```
+ *
+ * `CUE_OVERHEAD` rose from 1.28 to 1.30 in the same commit and for this reason:
+ * it was below the cue ratio measured at `+10%` and only safe because these
+ * numbers were inflated by more. Neither is a safe edit alone — see the
+ * paragraph there. One run of `scripts/measure-cue-rate.mjs` produces both.
+ *
+ * THE TABLE ABOVE STILL EARNS ITS PLACE, because it is the only measurement of
+ * `+50%` and `+60%` anyone has taken, and what it says about them is why this
+ * list stops at `+40%`. The re-measurement covered these five steps only.
+ *
  * Latin-measured. A CJK deck gets the same steps, which is a guess of the same
  * kind `SPEECH_CPS.cjk` already is — replace it the first time one is narrated.
  */

package/dist/types/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jokerized/decksmith",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Turn a source document into an animated explanation deck.",
   "type": "module",
   "license": "MIT",