@jokerized/decksmith 0.3.0 → 0.3.2

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

@@ -242,6 +242,70 @@ export declare function scanUnusedFigures(storyboard: Storyboard, source: Source
  * decision cannot be made by accident.
  */
 export declare function scanBeatCount(storyboard: Storyboard, prefs: Prefs): Finding[];
+/**
+ * Where a paper-shaped deck missed the shape it was asked for.
+ *
+ * SILENT UNLESS THE ARC WAS DECLARED. `prefs.genre` defaults to `general`, so
+ * every deck built before this existed, and every deck whose author did not say
+ * `--genre paper`, gets exactly nothing from this scan. That is not timidity: a
+ * ten-role heading lexicon over all 351 markdown files in this repository found
+ * 345 with zero hits, so there is no honest way to infer the genre, and a scan
+ * that guessed would mislabel the Korean fixture and every hypepaper analysis
+ * the tool actually ingests.
+ *
+ * REPORTED, NEVER REPAIRED, and a WARNING. It joins the four scans that already
+ * take that shape, and `scanBeatCount`'s header settles the class: `build`
+ * prints every content loss and fails on none of them, because the alternative
+ * is re-asking, and the only possible second instruction — "return more" — is a
+ * padding request with extra steps. Promoting this one is a decision about all
+ * of them.
+ *
+ * WHAT IT CANNOT DO. It cannot tell whether a beat labelled `limitations` really
+ * discusses one; `role` is the plan's own declaration, and a declaration can be
+ * false. What it checks instead is the part that is mechanical and that no
+ * committed plan has ever got right on its own: that the roles exist, that they
+ * are unique, that the ending is in the right ORDER, and that the closing pair
+ * does not collapse into two of the same picture. A rule about wording would be
+ * met cosmetically, exactly as `scanHeadlines` records a sharpened rule being
+ * answered by swapping one verb.
+ */
+export declare function scanPaperArc(storyboard: Storyboard, prefs: Prefs): Finding[];
+/**
+ * Narration that belongs to a different version of this storyboard.
+ *
+ * `narration.json` is keyed by BEAT ID and carries nothing that ties it to the
+ * plan it was made for, so an id that still exists is an id `build` will happily
+ * speak — even when the beat behind it has been replaced. Renumbering is the way
+ * in: inserting one beat and shifting the ids after it leaves every later id
+ * pointing at its neighbour's voice.
+ *
+ * FOUND IN THE SHIPPED DEMO, and it is the seventh green-gate case this project
+ * has recorded. A thirteenth beat was inserted at position six and the rest
+ * renumbered; the audio on disk predated it, so beats six through twelve each
+ * spoke the slide after them and the thirteenth spoke nothing. `build` reported
+ * `PASS — 0 error(s), 0 warning(s)`, because every id it looked for was present
+ * and nothing compared what was SAID against what the beat says it says.
+ *
+ * AN ERROR, NOT A WARNING, and it is the one member of this family that earns
+ * it. The other storyboard scans are editorial judgements only an author can
+ * settle; this is a string comparison between two authored fields that must
+ * agree, and the artifact it lets through is a video whose voice describes the
+ * wrong pictures. Missing narration audio is already an error here, and audio
+ * that is present and wrong is not the better failure.
+ *
+ * NARROW ON PURPOSE. It compares only beats that have BOTH a narration text and
+ * segments, so a deck narrated at a lower density — where some beats are
+ * deliberately silent — says nothing, and the existing missing-audio error keeps
+ * its own case. Whitespace is normalised because the splitter re-joins sentences
+ * at stop boundaries; on the demo's thirteen beats the concatenation reproduces
+ * the authored text exactly, which is what makes the comparison safe to make
+ * fatal.
+ */
+export declare function scanNarrationDrift(storyboard: Storyboard, narration: {
+    beats: Record<string, {
+        text: string;
+    }[]>;
+}): Finding[];
 /**
  * How far a name may precede the thing it names before a viewer notices.
  *

package/package.json

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