@jokerized/decksmith 0.1.3 → 0.1.4

package/dist/cli.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];
@@ -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];

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

@@ -1057,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];
@@ -5132,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 = {
@@ -5142,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];

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/package.json

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