@jokerized/decksmith 0.7.0 → 0.9.0

package/dist/types/verify/index.d.ts

@@ -171,6 +171,23 @@ export declare function scanRepeatedObject(storyboard: Storyboard): Finding[];
  * citing it in evidence is a different defect, and not this scan's to report.
  */
 export declare function scanUnusedFigures(storyboard: Storyboard, source: Source): Finding[];
+/**
+ * Every equation a walk or a morph will draw, parsed now by the KaTeX the deck
+ * vendors, with what `build` will do about each one said in words.
+ *
+ * Run at `plan` because that is when the storyboard is in front of the author
+ * and the cheapest moment to change a beat. Before this, a bad formula was first
+ * parsed by a browser at `verify`, after a deck had been built and narrated
+ * around it: 26 of 92 HypePaper build failures in the week to 2026-10-07.
+ *
+ * It calls the SAME preparation the emitters call (`prepareWalk`,
+ * `prepareMorph`), so what it reports is what `build` will do, not a second
+ * opinion that can drift from it. A WARNING throughout: a repaired formula, a
+ * formula shown as plain source and a dropped term are all drawn without
+ * throwing — and a beat that will be left out is reported again, by name, when
+ * `build` leaves it out.
+ */
+export declare function scanMath(storyboard: Storyboard, source: Source): Finding[];
 /**
  * Warn when the plan came back with fewer beats than were asked for.
  *

package/dist/types/verify/motion.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Motion variety, measured off a built composition — the M4 exit metrics.
+ *
+ * Read from the emitted `index.html` rather than from the in-memory plan, so the
+ * number is about what ships: a plan that said "push" and an emitter that wrote
+ * a dissolve would read as a dissolve here. The three numbers are the ones the
+ * redesign plan set against v0.8.0's audit of 124 HypePaper scenes:
+ *
+ * | metric                         | v0.8.0 | v2 target |
+ * |--------------------------------|--------|-----------|
+ * | modal entrance (share)         | 92%    | ≤ 40%     |
+ * | seam kinds (deck of 10+ beats) | 1      | ≥ 3       |
+ * | top-2 ease share of tweens     | 85%    | ≤ 60%     |
+ *
+ * MODAL is deliberately generous to the old look: a scene "opens modal" when its
+ * headline enters as a bare opacity + y fade-up, whatever the ease. v2's `rise`
+ * verb therefore counts as modal, which is why `planMotion` caps it.
+ */
+export interface MotionStats {
+    scenes: number;
+    /** Scenes whose headline (`#sN-h`, or the title's `#sN-t`) enters as opacity + y only. */
+    modalScenes: number;
+    /** Scenes with at least one emphasis (glow, underline, or a sine-eased pulse) after the build. */
+    emphasisScenes: number;
+    /** Seam kind per handoff, in scene order. */
+    seams: string[];
+    /** Tween count per ease name; a tween naming none is `"default"`. */
+    eases: Record<string, number>;
+    tweens: number;
+}
+export declare function motionStats(composition: string): MotionStats;
+/** The share of tweens carried by the two most common eases. */
+export declare function topTwoEaseShare(stats: MotionStats): number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jokerized/decksmith",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Turn a source document into an animated explanation deck.",
   "type": "module",
   "license": "MIT",
@@ -58,7 +58,10 @@
     "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/ibm-plex-sans": "5.3.0",
     "@fontsource-variable/inter": "5.3.0",
+    "@fontsource-variable/source-serif-4": "5.3.0",
+    "@fontsource-variable/space-grotesk": "5.3.0",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "@puppeteer/browsers": "^3.0.6",
     "commander": "^14.0.1",