gooseworks 0.5.8 → 0.5.9-dev.56.eca9486d

package/dist/kit/maker/parts/html-frames/src/part.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"part.d.ts","sourceRoot":"","sources":["../../../../../../src/kit/maker/parts/html-frames/src/part.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAG1D,eAAO,MAAM,GAAG,EAAE,OAGjB,CAAC"}
+{"version":3,"file":"part.d.ts","sourceRoot":"","sources":["../../../../../../src/kit/maker/parts/html-frames/src/part.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAG1D,eAAO,MAAM,GAAG,EAAE,OAKjB,CAAC"}

package/dist/kit/maker/parts/html-frames/src/part.js

@@ -3,7 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.run = void 0;
 const make_1 = require("../../../make");
 const run = async (inputs, ctx) => {
-    const made = await (0, make_1.makeVideo)(inputs, ctx);
+    const made = await (0, make_1.makeOrSkip)(inputs, ctx);
+    // skip_blank with no text anywhere: no outputs at all.
+    if (!made)
+        return {};
     return { video: made.video, seconds: made.seconds, timeline: made.timeline };
 };
 exports.run = run;

package/dist/kit/maker/parts/html-frames/src/part.js.map

@@ -1 +1 @@
-{"version":3,"file":"part.js","sourceRoot":"","sources":["../../../../../../src/kit/maker/parts/html-frames/src/part.ts"],"names":[],"mappings":";;;AAIA,wCAA0C;AAEnC,MAAM,GAAG,GAAY,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;IAChD,MAAM,IAAI,GAAG,MAAM,IAAA,gBAAS,EAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1C,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;AAC/E,CAAC,CAAC;AAHW,QAAA,GAAG,OAGd"}
+{"version":3,"file":"part.js","sourceRoot":"","sources":["../../../../../../src/kit/maker/parts/html-frames/src/part.ts"],"names":[],"mappings":";;;AAIA,wCAA2C;AAEpC,MAAM,GAAG,GAAY,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;IAChD,MAAM,IAAI,GAAG,MAAM,IAAA,iBAAU,EAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3C,uDAAuD;IACvD,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;AAC/E,CAAC,CAAC;AALW,QAAA,GAAG,OAKd"}

package/dist/kit/maker/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/kit/maker/runtime.ts"],"names":[],"mappings":"AAsCA,iEAAiE;AACjE,eAAO,MAAM,aAAa,gBAAgB,CAAC;AAkoB3C,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMjD;AAED,+CAA+C;AAC/C,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAEnD"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/kit/maker/runtime.ts"],"names":[],"mappings":"AAwCA,iEAAiE;AACjE,eAAO,MAAM,aAAa,gBAAgB,CAAC;AA8qB3C,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMjD;AAED,+CAA+C;AAC/C,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAInD"}

package/dist/kit/maker/runtime.js

@@ -1,4 +1,8 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PAGE_EPOCH_MS = void 0;
+exports.scriptJson = scriptJson;
+exports.runtimeScript = runtimeScript;
 // The script the maker puts first in every frame page, before any of the
 // page's own code. It gives the page its data (window.kit) and replaces every
 // clock and source of chance the page could read, at the prototype level so
@@ -34,12 +38,9 @@
 //   case on a case-insensitive disk; the zip comes only from the pinned,
 //   checksummed browser download, so it is first-party too.
 //
+const cues_1 = require("./cues");
 // Plain ES2020 in a string: nothing here is compiled, so the page runs exactly
 // this text. Keep it free of backticks and "${".
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PAGE_EPOCH_MS = void 0;
-exports.scriptJson = scriptJson;
-exports.runtimeScript = runtimeScript;
 /** Fixed wall-clock start for the page: 2026-01-01T00:00:00Z. */
 exports.PAGE_EPOCH_MS = 1767225600000;
 const RUNTIME = String.raw `(function () {
@@ -367,6 +368,39 @@ const RUNTIME = String.raw `(function () {
   // Frame data for the page.
   var renderers = [];
   var waits = [];
+  // 1.2.0 sound cues: marked before the page is ready, mixed by the maker at their frames.
+  var SOUNDS = __KIT_SOUNDS__;
+  var cues = [];
+  var cuesClosed = false;
+  function cue(name, at_s, options) {
+    if (cuesClosed) {
+      report('The frame page marks a sound cue after it got ready. Mark every cue before kit.ready settles.');
+      return;
+    }
+    if (typeof name !== 'string' || SOUNDS.indexOf(name) < 0) {
+      report('The frame page asks for the sound "' + String(name).slice(0, 40) + '"; the sounds are ' + SOUNDS.join(', ') + '.');
+      return;
+    }
+    if (typeof at_s !== 'number' || !isFinite(at_s) || at_s < 0 || at_s >= DATA.duration_s) {
+      report('The frame page marks a sound cue at ' + String(at_s).slice(0, 40) + ' s, outside the video (0 to ' + DATA.duration_s + ' s).');
+      return;
+    }
+    var gain = 1;
+    var max_s = null;
+    if (options !== undefined && options !== null) {
+      if (typeof options !== 'object') { report('The frame page gives sound cue options that are not an object.'); return; }
+      if (options.gain !== undefined) {
+        if (typeof options.gain !== 'number' || !isFinite(options.gain) || options.gain < 0 || options.gain > 4) { report('The frame page gives a sound cue a gain outside 0 to 4.'); return; }
+        gain = options.gain;
+      }
+      if (options.max_s !== undefined && options.max_s !== null) {
+        if (typeof options.max_s !== 'number' || !isFinite(options.max_s) || options.max_s <= 0 || options.max_s > 10) { report('The frame page gives a sound cue a max_s outside 0 to 10 seconds.'); return; }
+        max_s = options.max_s;
+      }
+    }
+    if (cues.length >= 500) { report('The frame page marks more than 500 sound cues.'); return; }
+    cues.push({ sound: name, at_s: at_s, gain: gain, max_s: max_s });
+  }
   function sceneAt(t) {
     var scenes = DATA.scenes;
     for (var i = scenes.length - 1; i >= 0; i--) {
@@ -397,9 +431,16 @@ const RUNTIME = String.raw `(function () {
     brand: DATA.brand,
     fonts: DATA.fonts,
     values: DATA.values,
+    // 1.2.0: the video drawn over (quiet bands), the voice track, extra pictures and picture facts.
+    under: DATA.under || null,
+    speech: DATA.speech || [],
+    media: DATA.media || [],
+    facts: DATA.facts || {},
+    footage: DATA.footage || [],
     sceneAt: sceneAt,
     render: function (fn) { if (typeof fn === 'function') renderers.push(fn); },
-    ready: function (promise) { waits.push(Promise.resolve(promise)); }
+    ready: function (promise) { waits.push(Promise.resolve(promise)); },
+    cue: cue
   });
   window.kit = kit;
 
@@ -641,7 +682,11 @@ const RUNTIME = String.raw `(function () {
       syncAnimations();
       await settle();
       syncAnimations();
-      return take();
+      // Cues are a pure function of the page's data: none may be marked once it is ready.
+      cuesClosed = true;
+      var started = await take();
+      started.cues = cues.slice();
+      return started;
     },
     frame: async function (index) {
       findRoots();
@@ -691,6 +736,8 @@ function scriptJson(value) {
 }
 /** The runtime with this page's data in it. */
 function runtimeScript(data) {
-    return RUNTIME.replace('__KIT_DATA__', () => scriptJson(data)).replace('__KIT_EPOCH__', String(exports.PAGE_EPOCH_MS));
+    return RUNTIME.replace('__KIT_DATA__', () => scriptJson(data))
+        .replace('__KIT_EPOCH__', String(exports.PAGE_EPOCH_MS))
+        .replace('__KIT_SOUNDS__', () => scriptJson(cues_1.CUE_SOUNDS));
 }
 //# sourceMappingURL=runtime.js.map

package/dist/kit/maker/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/kit/maker/runtime.ts"],"names":[],"mappings":";AAAA,yEAAyE;AACzE,8EAA8E;AAC9E,4EAA4E;AAC5E,6EAA6E;AAC7E,8BAA8B;AAC9B,6EAA6E;AAC7E,0EAA0E;AAC1E,2EAA2E;AAC3E,+EAA+E;AAC/E,+EAA+E;AAC/E,6EAA6E;AAC7E,0EAA0E;AAC1E,wEAAwE;AACxE,EAAE;AACF,+EAA+E;AAC/E,uEAAuE;AACvE,EAAE;AACF,kCAAkC;AAClC,iFAAiF;AACjF,gFAAgF;AAChF,yEAAyE;AACzE,gFAAgF;AAChF,mCAAmC;AACnC,+EAA+E;AAC/E,wBAAwB;AACxB,8EAA8E;AAC9E,6EAA6E;AAC7E,mEAAmE;AACnE,kEAAkE;AAClE,4EAA4E;AAC5E,0DAA0D;AAC1D,6EAA6E;AAC7E,yEAAyE;AACzE,4DAA4D;AAC5D,EAAE;AACF,+EAA+E;AAC/E,iDAAiD;;;AAsoBjD,gCAMC;AAGD,sCAEC;AA/oBD,iEAAiE;AACpD,QAAA,aAAa,GAAG,aAAa,CAAC;AAE3C,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA8nBpB,CAAC;AAEP,wEAAwE;AACxE,SAAgB,UAAU,CAAC,KAAc;IACvC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;SACzB,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;SACxB,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;SACxB,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;SAClD,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACxD,CAAC;AAED,+CAA+C;AAC/C,SAAgB,aAAa,CAAC,IAAa;IACzC,OAAO,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,qBAAa,CAAC,CAAC,CAAC;AACjH,CAAC"}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/kit/maker/runtime.ts"],"names":[],"mappings":";;;AAwtBA,gCAMC;AAGD,sCAIC;AAruBD,yEAAyE;AACzE,8EAA8E;AAC9E,4EAA4E;AAC5E,6EAA6E;AAC7E,8BAA8B;AAC9B,6EAA6E;AAC7E,0EAA0E;AAC1E,2EAA2E;AAC3E,+EAA+E;AAC/E,+EAA+E;AAC/E,6EAA6E;AAC7E,0EAA0E;AAC1E,wEAAwE;AACxE,EAAE;AACF,+EAA+E;AAC/E,uEAAuE;AACvE,EAAE;AACF,kCAAkC;AAClC,iFAAiF;AACjF,gFAAgF;AAChF,yEAAyE;AACzE,gFAAgF;AAChF,mCAAmC;AACnC,+EAA+E;AAC/E,wBAAwB;AACxB,8EAA8E;AAC9E,6EAA6E;AAC7E,mEAAmE;AACnE,kEAAkE;AAClE,4EAA4E;AAC5E,0DAA0D;AAC1D,6EAA6E;AAC7E,yEAAyE;AACzE,4DAA4D;AAC5D,EAAE;AACF,iCAAoC;AAEpC,+EAA+E;AAC/E,iDAAiD;AAEjD,iEAAiE;AACpD,QAAA,aAAa,GAAG,aAAa,CAAC;AAE3C,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA0qBpB,CAAC;AAEP,wEAAwE;AACxE,SAAgB,UAAU,CAAC,KAAc;IACvC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;SACzB,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;SACxB,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;SACxB,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;SAClD,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACxD,CAAC;AAED,+CAA+C;AAC/C,SAAgB,aAAa,CAAC,IAAa;IACzC,OAAO,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;SAC3D,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,qBAAa,CAAC,CAAC;SAC/C,OAAO,CAAC,gBAAgB,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,iBAAU,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/kit/maker/timing.d.ts

@@ -0,0 +1,74 @@
+import type { Timeline } from '../part-interface';
+export type SpeechEntry = Timeline['speech'][number];
+export type SpokenWord = {
+    text: string;
+    start_s: number;
+    end_s: number;
+};
+export interface PaceSpec {
+    base_s: number;
+    per_word_s: number;
+    min_s?: number;
+    max_s?: number;
+    last_min_s?: number;
+}
+export interface Zone {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/** Words as a reader counts them: runs of letters or digits, joined by ' or -. */
+export declare function countWords(text: string | null): number;
+/** A scene with neither on-screen text nor a line (skip_blank looks for these). */
+export declare function isBlankScene(scene: {
+    line: string | null;
+    on_screen: string | null;
+}): boolean;
+/**
+ * Which speech entries belong to which scene. Entries that name a scene_id go
+ * to that scene (entries with none are left out of the timing). When no entry
+ * names a scene, entries pair with scenes in order, which needs the same count.
+ * Returns the reason in plain words when they cannot be paired.
+ */
+export declare function speechByScene(ids: string[], speech: SpeechEntry[]): SpeechEntry[][] | string;
+/**
+ * Scene start times from a voice track. The first scene starts at 0; a scene
+ * with speech starts at its first entry. Scenes with no speech share the time
+ * between the speech before them and the next scene's start (or the end) evenly.
+ * The video lasts until the last entry ends, plus tail_s.
+ */
+export declare function speechTimes(ids: string[], speech: SpeechEntry[], tailS: number): {
+    starts: number[];
+    seconds: number;
+} | string;
+/** How long each scene holds under `pace`: base_s plus per_word_s a word, kept between min_s and max_s; the last at least last_min_s. */
+export declare function paceHolds(scenes: Array<{
+    line: string | null;
+    on_screen: string | null;
+}>, pace: PaceSpec): number[] | string;
+/** Start times from holds, plus the whole length. */
+export declare function startsOfHolds(holds: number[]): {
+    starts: number[];
+    seconds: number;
+};
+/**
+ * Scene start frames from start times, with the end appended. Returns the
+ * index of the first scene that would get no frame, or the frames.
+ */
+export declare function framesOfStarts(starts: number[], fps: number, frameCount: number): number[] | {
+    empty: number;
+};
+/** Each scene's spoken words, by when each word starts (on the video's frames); words after the end go to the last scene. */
+export declare function wordsByScene(speech: SpeechEntry[], sceneFrames: number[], fps: number): SpokenWord[][];
+/** The caption zone kept to the page; null when none of it is on the page. */
+export declare function clipZone(zone: Zone, page: {
+    width: number;
+    height: number;
+}): Zone | null;
+/** A zone in the page's CSS pixels as video pixels, rounded inward so captions stay inside it. */
+export declare function zoneOnVideo(zone: Zone, scale: number, size: {
+    width: number;
+    height: number;
+}): Zone | null;
+//# sourceMappingURL=timing.d.ts.map

package/dist/kit/maker/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../../src/kit/maker/timing.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AACrD,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAGtD;AAED,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,OAAO,CAE9F;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,EAAE,GAAG,MAAM,CAiB5F;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAsB/H;AAED,yIAAyI;AACzI,wBAAgB,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,GAAG,MAAM,CAU7H;AAED,qDAAqD;AACrD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAQpF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAK9G;AAED,6HAA6H;AAC7H,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,EAAE,EAAE,CAWtG;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,IAAI,CAOzF;AAED,kGAAkG;AAClG,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,IAAI,CAO3G"}

package/dist/kit/maker/timing.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.countWords = countWords;
+exports.isBlankScene = isBlankScene;
+exports.speechByScene = speechByScene;
+exports.speechTimes = speechTimes;
+exports.paceHolds = paceHolds;
+exports.startsOfHolds = startsOfHolds;
+exports.framesOfStarts = framesOfStarts;
+exports.wordsByScene = wordsByScene;
+exports.clipZone = clipZone;
+exports.zoneOnVideo = zoneOnVideo;
+/** Words as a reader counts them: runs of letters or digits, joined by ' or -. */
+function countWords(text) {
+    if (!text)
+        return 0;
+    return text.split(/\s+/u).filter((token) => /[\p{L}\p{N}]/u.test(token)).length;
+}
+/** A scene with neither on-screen text nor a line (skip_blank looks for these). */
+function isBlankScene(scene) {
+    return !scene.on_screen?.trim() && !scene.line?.trim();
+}
+/**
+ * Which speech entries belong to which scene. Entries that name a scene_id go
+ * to that scene (entries with none are left out of the timing). When no entry
+ * names a scene, entries pair with scenes in order, which needs the same count.
+ * Returns the reason in plain words when they cannot be paired.
+ */
+function speechByScene(ids, speech) {
+    const byScene = ids.map(() => []);
+    if (speech.some((entry) => typeof entry.scene_id === 'string')) {
+        const index = new Map(ids.map((id, i) => [id, i]));
+        for (const entry of speech) {
+            if (typeof entry.scene_id !== 'string')
+                continue;
+            const i = index.get(entry.scene_id);
+            if (i === undefined)
+                return `speech names scene "${entry.scene_id}", which is not one of the scenes`;
+            byScene[i].push(entry);
+        }
+        return byScene;
+    }
+    if (speech.length !== ids.length) {
+        return `speech has ${speech.length} entries without scene ids, so they cannot be paired with ${ids.length} scenes`;
+    }
+    speech.forEach((entry, i) => byScene[i].push(entry));
+    return byScene;
+}
+/**
+ * Scene start times from a voice track. The first scene starts at 0; a scene
+ * with speech starts at its first entry. Scenes with no speech share the time
+ * between the speech before them and the next scene's start (or the end) evenly.
+ * The video lasts until the last entry ends, plus tail_s.
+ */
+function speechTimes(ids, speech, tailS) {
+    for (const [k, entry] of speech.entries()) {
+        if (entry.end_s < entry.start_s)
+            return `speech entry ${k + 1} ends (${entry.end_s} s) before it starts (${entry.start_s} s)`;
+    }
+    const byScene = speechByScene(ids, speech);
+    if (typeof byScene === 'string')
+        return byScene;
+    const seconds = Math.max(...speech.map((entry) => entry.end_s)) + tailS;
+    const first = byScene.map((entries) => (entries.length ? Math.min(...entries.map((e) => e.start_s)) : null));
+    const last = byScene.map((entries) => (entries.length ? Math.max(...entries.map((e) => e.end_s)) : null));
+    const starts = ids.map((_, i) => (i === 0 ? 0 : first[i]));
+    for (let a = 1; a < ids.length; a++) {
+        if (starts[a] !== null)
+            continue;
+        let b = a;
+        while (b + 1 < ids.length && starts[b + 1] === null)
+            b++;
+        const to = b + 1 < ids.length ? starts[b + 1] : seconds;
+        const spoken = last.slice(0, a).filter((v) => v !== null);
+        const from = Math.min(to, Math.max(starts[a - 1], ...spoken));
+        const count = b - a + 1;
+        for (let k = 0; k < count; k++)
+            starts[a + k] = from + ((to - from) * k) / count;
+        a = b;
+    }
+    return { starts: starts, seconds };
+}
+/** How long each scene holds under `pace`: base_s plus per_word_s a word, kept between min_s and max_s; the last at least last_min_s. */
+function paceHolds(scenes, pace) {
+    const min = pace.min_s ?? 0;
+    const max = pace.max_s ?? Infinity;
+    if (min > max)
+        return `pace.min_s (${min}) is more than pace.max_s (${max})`;
+    const holds = scenes.map((scene) => {
+        const words = countWords(scene.on_screen) || countWords(scene.line);
+        return Math.min(max, Math.max(min, pace.base_s + pace.per_word_s * words));
+    });
+    holds[holds.length - 1] = Math.max(holds[holds.length - 1], pace.last_min_s ?? 0);
+    return holds;
+}
+/** Start times from holds, plus the whole length. */
+function startsOfHolds(holds) {
+    const starts = [];
+    let at = 0;
+    for (const hold of holds) {
+        starts.push(at);
+        at += hold;
+    }
+    return { starts, seconds: at };
+}
+/**
+ * Scene start frames from start times, with the end appended. Returns the
+ * index of the first scene that would get no frame, or the frames.
+ */
+function framesOfStarts(starts, fps, frameCount) {
+    const frames = starts.map((s, i) => (i === 0 ? 0 : Math.min(frameCount, Math.max(0, Math.round(s * fps)))));
+    frames.push(frameCount);
+    for (let i = 0; i + 1 < frames.length; i++)
+        if (frames[i + 1] <= frames[i])
+            return { empty: i };
+    return frames;
+}
+/** Each scene's spoken words, by when each word starts (on the video's frames); words after the end go to the last scene. */
+function wordsByScene(speech, sceneFrames, fps) {
+    const scenes = sceneFrames.length - 1;
+    const out = Array.from({ length: scenes }, () => []);
+    const words = speech.flatMap((entry) => entry.words ?? []).slice().sort((a, b) => a.start_s - b.start_s);
+    for (const word of words) {
+        const frame = Math.round(word.start_s * fps);
+        let i = scenes - 1;
+        while (i > 0 && frame < sceneFrames[i])
+            i--;
+        out[i].push({ text: word.text, start_s: word.start_s, end_s: word.end_s });
+    }
+    return out;
+}
+/** The caption zone kept to the page; null when none of it is on the page. */
+function clipZone(zone, page) {
+    const x0 = Math.max(0, zone.x);
+    const y0 = Math.max(0, zone.y);
+    const x1 = Math.min(page.width, zone.x + zone.w);
+    const y1 = Math.min(page.height, zone.y + zone.h);
+    if (x1 - x0 < 1 || y1 - y0 < 1)
+        return null;
+    return { x: x0, y: y0, w: x1 - x0, h: y1 - y0 };
+}
+/** A zone in the page's CSS pixels as video pixels, rounded inward so captions stay inside it. */
+function zoneOnVideo(zone, scale, size) {
+    const x0 = Math.max(0, Math.ceil(zone.x * scale - 1e-6));
+    const y0 = Math.max(0, Math.ceil(zone.y * scale - 1e-6));
+    const x1 = Math.min(size.width, Math.floor((zone.x + zone.w) * scale + 1e-6));
+    const y1 = Math.min(size.height, Math.floor((zone.y + zone.h) * scale + 1e-6));
+    if (x1 - x0 < 1 || y1 - y0 < 1)
+        return null;
+    return { x: x0, y: y0, w: x1 - x0, h: y1 - y0 };
+}
+//# sourceMappingURL=timing.js.map

package/dist/kit/maker/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../../src/kit/maker/timing.ts"],"names":[],"mappings":";;AAyBA,gCAGC;AAGD,oCAEC;AAQD,sCAiBC;AAQD,kCAsBC;AAGD,8BAUC;AAGD,sCAQC;AAMD,wCAKC;AAGD,oCAWC;AAGD,4BAOC;AAGD,kCAOC;AArID,kFAAkF;AAClF,SAAgB,UAAU,CAAC,IAAmB;IAC5C,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;AAClF,CAAC;AAED,mFAAmF;AACnF,SAAgB,YAAY,CAAC,KAAwD;IACnF,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,GAAa,EAAE,MAAqB;IAChE,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAmB,CAAC,CAAC;IACnD,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,EAAE,CAAC;QAC/D,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;gBAAE,SAAS;YACjD,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACpC,IAAI,CAAC,KAAK,SAAS;gBAAE,OAAO,uBAAuB,KAAK,CAAC,QAAQ,mCAAmC,CAAC;YACrG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC;QACjC,OAAO,cAAc,MAAM,CAAC,MAAM,6DAA6D,GAAG,CAAC,MAAM,SAAS,CAAC;IACrH,CAAC;IACD,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACrD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,GAAa,EAAE,MAAqB,EAAE,KAAa;IAC7E,KAAK,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QAC1C,IAAI,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,OAAO;YAAE,OAAO,gBAAgB,CAAC,GAAG,CAAC,UAAU,KAAK,CAAC,KAAK,yBAAyB,KAAK,CAAC,OAAO,KAAK,CAAC;IAChI,CAAC;IACD,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC3C,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC;IACxE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7G,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1G,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,SAAS;QACjC,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI;YAAE,CAAC,EAAE,CAAC;QACzD,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAY,CAAC,CAAC,CAAC,OAAO,CAAC;QACpE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QACvE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAW,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC;QACxE,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE;YAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;QACjF,CAAC,GAAG,CAAC,CAAC;IACR,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAkB,EAAE,OAAO,EAAE,CAAC;AACjD,CAAC;AAED,yIAAyI;AACzI,SAAgB,SAAS,CAAC,MAAgE,EAAE,IAAc;IACxG,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC;IACnC,IAAI,GAAG,GAAG,GAAG;QAAE,OAAO,eAAe,GAAG,8BAA8B,GAAG,GAAG,CAAC;IAC7E,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACjC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC;IAClF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,qDAAqD;AACrD,SAAgB,aAAa,CAAC,KAAe;IAC3C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChB,EAAE,IAAI,IAAI,CAAC;IACb,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAAC,MAAgB,EAAE,GAAW,EAAE,UAAkB;IAC9E,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5G,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,IAAI,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAChG,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,6HAA6H;AAC7H,SAAgB,YAAY,CAAC,MAAqB,EAAE,WAAqB,EAAE,GAAW;IACpF,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IACtC,MAAM,GAAG,GAAmB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;IACzG,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC;QAC7C,IAAI,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC;YAAE,CAAC,EAAE,CAAC;QAC5C,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,8EAA8E;AAC9E,SAAgB,QAAQ,CAAC,IAAU,EAAE,IAAuC;IAC1E,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACjD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAClD,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC;AAClD,CAAC;AAED,kGAAkG;AAClG,SAAgB,WAAW,CAAC,IAAU,EAAE,KAAa,EAAE,IAAuC;IAC5F,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;IACzD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;IACzD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;IAC9E,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC;IAC/E,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC;AAClD,CAAC"}

package/dist/kit/maker/under.d.ts

@@ -0,0 +1,126 @@
+import type { FileRef, KitTools, Timeline } from '../part-interface';
+/** What the maker measures of the video it draws over. */
+export interface UnderInfo {
+    /** Length of its picture, in seconds. */
+    seconds: number;
+    width: number;
+    height: number;
+    fps: number | null;
+    hasAudio: boolean;
+}
+/** A band of rows, as fractions of the height (0 at the top). */
+export interface QuietBand {
+    y0: number;
+    y1: number;
+}
+/** The band a quiet band is looked for in, and its height, as fractions of the height. */
+export declare const QUIET_SAFE: {
+    readonly top: 0.15;
+    readonly bottom: 0.85;
+    readonly height: 0.15;
+};
+/** Reads the video's picture length, size, frame rate and whether it has sound, with ffprobe. */
+export declare function probeUnder(tools: Pick<KitTools, 'exec'>, file: string): Promise<UnderInfo | null>;
+/** How the video is fitted to the page: scaled to cover it, then cropped to the middle. */
+export interface CoverFit {
+    scale: number;
+    offsetX: number;
+    offsetY: number;
+}
+export declare function coverFit(from: {
+    width: number;
+    height: number;
+}, to: {
+    width: number;
+    height: number;
+}): CoverFit;
+/** The ffmpeg filter that fits the video to the page: cover, centre crop, square pixels. */
+export declare function coverFilter(size: {
+    width: number;
+    height: number;
+}): string;
+/**
+ * The emptiest band of a grey picture: rows are scored by how much the picture
+ * changes along and down them (the per-row gradient), and the band of
+ * QUIET_SAFE.height whose rows change least, inside QUIET_SAFE, wins. Ties go
+ * to the band nearer the bottom, where captions usually sit.
+ */
+export declare function quietBandOf(gray: Uint8Array, width: number, height: number): QuietBand;
+/**
+ * Each scene's quiet band, from the video's frame at the middle of the scene,
+ * fitted to the page the way the last pass fits it (cover, centre crop), so the
+ * band describes what shows. Frames are read one at a time as raw grey pixels into `dir`.
+ */
+export declare function quietBands(tools: Pick<KitTools, 'exec'>, file: string, info: UnderInfo, times: Array<{
+    start_s: number;
+    end_s: number;
+}>, dir: string, page: {
+    width: number;
+    height: number;
+}): Promise<QuietBand[]>;
+/**
+ * True when the plan's scenes share the video drawn over evenly: that video is
+ * one scene (one clip, say) and the plan has several.
+ */
+export declare function underIsShared(ids: string[], timeline: Pick<Timeline, 'scenes'>): boolean;
+/**
+ * Scene start frames from the timeline of the video drawn over. Each plan scene
+ * takes the time of the timeline scene with its id; when ids do not match and
+ * both list the same number of scenes, they pair in order. When that video is
+ * one scene and the plan has several, the plan's scenes share it evenly on
+ * whole frames, as they share a video of a given length. Returns null when the
+ * scenes cannot be paired.
+ */
+export declare function underSceneFrames(ids: string[], timeline: Pick<Timeline, 'scenes'>, fps: number, frameCount: number): number[] | null;
+/** One segment of transparent page frames, kept with their alpha (PNG in MOV), to be laid over the video later. */
+export declare function alphaSegmentArgs(opts: {
+    framesDir: string;
+    framePattern: string;
+    start: number;
+    count: number;
+    fps: number;
+    out: string;
+}): string[];
+/**
+ * The last pass: the video fitted to the page, the page's frames laid over it,
+ * encoded like every html-frames video, with the video's sound kept as AAC.
+ */
+export declare function compositeArgs(opts: {
+    tools: Pick<KitTools, 'encodeArgs'>;
+    under: string;
+    list: string;
+    size: {
+        width: number;
+        height: number;
+    };
+    fps: number;
+    frames: number;
+    hasAudio: boolean;
+    out: string;
+}): string[];
+/**
+ * The timeline of a video drawn over: the video's own scenes, speech, end card
+ * and safe zones carried through (cut to the new length, zones moved to the
+ * new picture), with this video's length, size and frame rate. When the plan's
+ * scenes shared a one-scene video (`scenes` given), they are the scenes, and a
+ * speech entry that names a scene names the one it starts in.
+ */
+export declare function passThroughTimeline(under: Timeline, out: {
+    duration_s: number;
+    width: number;
+    height: number;
+    fps: number;
+}, scenes?: Array<{
+    id: string;
+    start_s: number;
+    end_s: number;
+}>): Timeline;
+/** The under video as the part takes it: the file and its timeline. */
+export interface UnderSpec {
+    file: FileRef;
+    timeline: Timeline;
+    info: UnderInfo;
+    /** Each plan scene's quiet band, measured before the page is built (kit.under.quiet_band). */
+    quietBands?: QuietBand[];
+}
+//# sourceMappingURL=under.d.ts.map

package/dist/kit/maker/under.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"under.d.ts","sourceRoot":"","sources":["../../../src/kit/maker/under.ts"],"names":[],"mappings":"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"}