@tongue-core/ui 0.1.0-rc.4 → 0.1.0-rc.5

package/dist/timeline/index.d.ts

@@ -6,4 +6,5 @@ export { ruler, stepFor, minorFor, rulerLabel, timecode, LABEL_SPACING, MINOR_SP
 export { reduceSelection, emptySelection, type Selection, type SelectionAction } from "./selection.js";
 export { rowItems, rowTransitions, clipInRun, octaveOf, sameRowItems, MIN_CLIP_PX, type RowItem } from "./items.js";
 export { filmstrip, PreviewCache, type PreviewSource, type StripFrame } from "./previews.js";
+export { narration, wordAt, wordsIn, lastStartedBy, type NarrationWord } from "./narration.js";
 export { BUDGETS, type Budgets } from "../budgets.js";

package/dist/timeline/index.js

@@ -10,4 +10,5 @@ export { ruler, stepFor, minorFor, rulerLabel, timecode, LABEL_SPACING, MINOR_SP
 export { reduceSelection, emptySelection } from "./selection.js";
 export { rowItems, rowTransitions, clipInRun, octaveOf, sameRowItems, MIN_CLIP_PX } from "./items.js";
 export { filmstrip, PreviewCache } from "./previews.js";
+export { narration, wordAt, wordsIn, lastStartedBy } from "./narration.js";
 export { BUDGETS } from "../budgets.js";

package/dist/timeline/narration.d.ts

@@ -0,0 +1,18 @@
+import type { FilmDoc } from "@tongue-core/project/doc";
+export interface NarrationWord {
+    readonly text: string;
+    /** Film frames [start, end). */
+    readonly start: number;
+    readonly end: number;
+    /** The clip it is said in, and its row. */
+    readonly clip: string;
+    readonly row: string;
+}
+/** Every word of the film's narration on the film's clock, by start. Empty for a film with none. */
+export declare function narration(doc: FilmDoc): ReadonlyArray<NarrationWord>;
+/** The index of the last word that has started by `frame`; -1 before the first. */
+export declare function lastStartedBy(words: ReadonlyArray<NarrationWord>, frame: number): number;
+/** The word being said at `frame` (its start reached, its end not), or null between words. */
+export declare function wordAt(words: ReadonlyArray<NarrationWord>, frame: number): NarrationWord | null;
+/** The words said in `[from, to)`, in order. */
+export declare const wordsIn: (words: ReadonlyArray<NarrationWord>, from: number, to: number) => ReadonlyArray<NarrationWord>;

package/dist/timeline/narration.js

@@ -0,0 +1,42 @@
+/** Every word of the film's narration on the film's clock, by start. Empty for a film with none. */
+export function narration(doc) {
+    const out = [];
+    for (const track of doc.tracks) {
+        for (const clip of track.clips) {
+            if (clip.kind !== "audio" || clip.voice === undefined)
+                continue;
+            for (const word of clip.voice.words) {
+                const start = clip.start + word.start / clip.speed;
+                const end = clip.start + word.end / clip.speed;
+                if (start >= clip.end)
+                    continue;
+                out.push({ text: word.text, start, end: Math.min(end, clip.end), clip: clip.id, row: track.id });
+            }
+        }
+    }
+    return out.sort((a, b) => a.start - b.start || a.end - b.end);
+}
+/** The index of the last word that has started by `frame`; -1 before the first. */
+export function lastStartedBy(words, frame) {
+    let low = 0;
+    let high = words.length - 1;
+    let found = -1;
+    while (low <= high) {
+        const mid = (low + high) >>> 1;
+        if ((words[mid]?.start ?? Number.POSITIVE_INFINITY) <= frame) {
+            found = mid;
+            low = mid + 1;
+        }
+        else
+            high = mid - 1;
+    }
+    return found;
+}
+/** The word being said at `frame` (its start reached, its end not), or null between words. */
+export function wordAt(words, frame) {
+    const index = lastStartedBy(words, frame);
+    const word = words[index];
+    return word !== undefined && frame < word.end ? word : null;
+}
+/** The words said in `[from, to)`, in order. */
+export const wordsIn = (words, from, to) => words.filter((word) => word.end > from && word.start < to);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tongue-core/ui",
-  "version": "0.1.0-rc.4",
+  "version": "0.1.0-rc.5",
   "description": "The pieces of a film's interface: the player, the timeline's state and geometry, and unstyled React primitives. Build your own studio from them.",
   "type": "module",
   "license": "MIT",
@@ -36,9 +36,9 @@
     "README.md"
   ],
   "dependencies": {
-    "@tongue-core/engine": "0.1.0-rc.4",
-    "@tongue-core/film": "0.1.0-rc.4",
-    "@tongue-core/project": "0.1.0-rc.4"
+    "@tongue-core/engine": "0.1.0-rc.5",
+    "@tongue-core/film": "0.1.0-rc.5",
+    "@tongue-core/project": "0.1.0-rc.5"
   },
   "peerDependencies": {
     "@effect/atom-react": "^4.0.6",