@tscaps/engine 0.1.1 → 0.3.0

package/dist/modules/subtitle-file/SbvSubtitleFileSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SbvSubtitleFileSerializer.d.ts","sourceRoot":"","sources":["../../../src/modules/subtitle-file/SbvSubtitleFileSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AAKtF;;;;;;;;GAQG;AACH,qBAAa,yBAA0B,SAAQ,sBAAsB;IACnE,QAAQ,CAAC,SAAS,gBAAgB;IAClC,QAAQ,CAAC,aAAa,SAAS;IAE/B,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,mBAAmB,GAAG,MAAM;IAK3F,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,QAAQ;CAKjB"}

package/dist/modules/subtitle-file/SbvSubtitleFileSerializer.js

@@ -0,0 +1,31 @@
+import { SubtitleFileSerializer } from '../subtitle-file/SubtitleFileSerializer';
+import { Timecode } from '../subtitle-file/Timecode';
+const NEW_LINE = '\n';
+/**
+ * Writes SubViewer (`.sbv`), one of the two shapes YouTube hands back
+ * when captions are downloaded: a `H:MM:SS.mmm,H:MM:SS.mmm` range on
+ * its own line, the rows beneath it, and a blank line between entries.
+ * There is no counter and the hour is not padded.
+ *
+ * Like SubRip, the format cannot time anything below an entry, so word
+ * granularity means one entry per word.
+ */
+export class SbvSubtitleFileSerializer extends SubtitleFileSerializer {
+    mediaType = 'text/plain';
+    fileExtension = 'sbv';
+    write(cues, granularity) {
+        const entries = granularity === 'word' ? this.perWordCues(cues) : cues;
+        return entries.map((cue) => this.writeCue(cue)).join(NEW_LINE);
+    }
+    writeCue(cue) {
+        const range = `${this.timecode(cue.time.start)},${this.timecode(cue.time.end)}`;
+        const body = cue.rows.map((row) => row.text()).join(NEW_LINE);
+        return `${range}${NEW_LINE}${body}${NEW_LINE}`;
+    }
+    timecode(position) {
+        const at = new Timecode(position);
+        return `${at.hours}:${at.padded(at.minutes, 2)}:${at.padded(at.seconds, 2)}`
+            + `.${at.padded(at.milliseconds, 3)}`;
+    }
+}
+//# sourceMappingURL=SbvSubtitleFileSerializer.js.map

package/dist/modules/subtitle-file/SbvSubtitleFileSerializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SbvSubtitleFileSerializer.js","sourceRoot":"","sources":["../../../src/modules/subtitle-file/SbvSubtitleFileSerializer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AAEvF,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAE3D,MAAM,QAAQ,GAAG,IAAI,CAAC;AAEtB;;;;;;;;GAQG;AACH,MAAM,OAAO,yBAA0B,SAAQ,sBAAsB;IAC1D,SAAS,GAAG,YAAY,CAAC;IACzB,aAAa,GAAG,KAAK,CAAC;IAErB,KAAK,CAAC,IAAgC,EAAE,WAAgC;QAChF,MAAM,OAAO,GAAG,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACvE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjE,CAAC;IAEO,QAAQ,CAAC,GAAgB;QAC/B,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAChF,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9D,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,IAAI,GAAG,QAAQ,EAAE,CAAC;IACjD,CAAC;IAEO,QAAQ,CAAC,QAAgB;QAC/B,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAClC,OAAO,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE;cACxE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC;IAC1C,CAAC;CACF"}

package/dist/modules/subtitle-file/SrtSubtitleFileSerializer.d.ts

@@ -0,0 +1,21 @@
+import type { SubtitleCue } from '../subtitle-file/SubtitleCue';
+import { SubtitleFileSerializer } from '../subtitle-file/SubtitleFileSerializer';
+import type { SubtitleGranularity } from '../subtitle-file/SubtitleGranularity';
+/**
+ * Writes SubRip (`.srt`): a one-based counter, a
+ * `HH:MM:SS,mmm --> HH:MM:SS,mmm` range, and the entry's rows, with a
+ * blank line between blocks.
+ *
+ * The format has no way to time anything below an entry, so word
+ * granularity is paid for in entries: one per word, which multiplies
+ * the file's length several times over. Every player understands the
+ * result, which is the reason to accept the cost.
+ */
+export declare class SrtSubtitleFileSerializer extends SubtitleFileSerializer {
+    readonly mediaType = "application/x-subrip";
+    readonly fileExtension = "srt";
+    protected write(cues: ReadonlyArray<SubtitleCue>, granularity: SubtitleGranularity): string;
+    private writeCue;
+    private timecode;
+}
+//# sourceMappingURL=SrtSubtitleFileSerializer.d.ts.map

package/dist/modules/subtitle-file/SrtSubtitleFileSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SrtSubtitleFileSerializer.d.ts","sourceRoot":"","sources":["../../../src/modules/subtitle-file/SrtSubtitleFileSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AAMtF;;;;;;;;;GASG;AACH,qBAAa,yBAA0B,SAAQ,sBAAsB;IACnE,QAAQ,CAAC,SAAS,0BAA0B;IAC5C,QAAQ,CAAC,aAAa,SAAS;IAE/B,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,mBAAmB,GAAG,MAAM;IAK3F,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,QAAQ;CAKjB"}

package/dist/modules/subtitle-file/SrtSubtitleFileSerializer.js

@@ -0,0 +1,33 @@
+import { SubtitleFileSerializer } from '../subtitle-file/SubtitleFileSerializer';
+import { Timecode } from '../subtitle-file/Timecode';
+/** SubRip separates rows and blocks with CRLF, and readers are strict about it. */
+const NEW_LINE = '\r\n';
+/**
+ * Writes SubRip (`.srt`): a one-based counter, a
+ * `HH:MM:SS,mmm --> HH:MM:SS,mmm` range, and the entry's rows, with a
+ * blank line between blocks.
+ *
+ * The format has no way to time anything below an entry, so word
+ * granularity is paid for in entries: one per word, which multiplies
+ * the file's length several times over. Every player understands the
+ * result, which is the reason to accept the cost.
+ */
+export class SrtSubtitleFileSerializer extends SubtitleFileSerializer {
+    mediaType = 'application/x-subrip';
+    fileExtension = 'srt';
+    write(cues, granularity) {
+        const entries = granularity === 'word' ? this.perWordCues(cues) : cues;
+        return entries.map((cue, index) => this.writeCue(cue, index + 1)).join(NEW_LINE);
+    }
+    writeCue(cue, position) {
+        const range = `${this.timecode(cue.time.start)} --> ${this.timecode(cue.time.end)}`;
+        const body = cue.rows.map((row) => row.text()).join(NEW_LINE);
+        return `${position}${NEW_LINE}${range}${NEW_LINE}${body}${NEW_LINE}`;
+    }
+    timecode(position) {
+        const at = new Timecode(position);
+        return `${at.padded(at.hours, 2)}:${at.padded(at.minutes, 2)}:${at.padded(at.seconds, 2)}`
+            + `,${at.padded(at.milliseconds, 3)}`;
+    }
+}
+//# sourceMappingURL=SrtSubtitleFileSerializer.js.map

package/dist/modules/subtitle-file/SrtSubtitleFileSerializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SrtSubtitleFileSerializer.js","sourceRoot":"","sources":["../../../src/modules/subtitle-file/SrtSubtitleFileSerializer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AAEvF,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAE3D,mFAAmF;AACnF,MAAM,QAAQ,GAAG,MAAM,CAAC;AAExB;;;;;;;;;GASG;AACH,MAAM,OAAO,yBAA0B,SAAQ,sBAAsB;IAC1D,SAAS,GAAG,sBAAsB,CAAC;IACnC,aAAa,GAAG,KAAK,CAAC;IAErB,KAAK,CAAC,IAAgC,EAAE,WAAgC;QAChF,MAAM,OAAO,GAAG,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACvE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnF,CAAC;IAEO,QAAQ,CAAC,GAAgB,EAAE,QAAgB;QACjD,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACpF,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9D,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,IAAI,GAAG,QAAQ,EAAE,CAAC;IACvE,CAAC;IAEO,QAAQ,CAAC,QAAgB;QAC/B,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAClC,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE;cACtF,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC;IAC1C,CAAC;CACF"}

package/dist/modules/subtitle-file/SubtitleCue.d.ts

@@ -0,0 +1,18 @@
+import type { TimeFragment } from '../document/TimeFragment';
+import type { SubtitleRow } from '../subtitle-file/SubtitleRow';
+import type { SubtitleToken } from '../subtitle-file/SubtitleToken';
+/**
+ * One timed entry of a subtitle file: the window it occupies and the
+ * rows shown inside it.
+ *
+ * A cue always covers a window of positive length and holds at least
+ * one row. Text carries no markup — escaping and joining are format
+ * concerns.
+ */
+export declare class SubtitleCue {
+    readonly time: TimeFragment;
+    readonly rows: ReadonlyArray<SubtitleRow>;
+    constructor(time: TimeFragment, rows: ReadonlyArray<SubtitleRow>);
+    tokens(): ReadonlyArray<SubtitleToken>;
+}
+//# sourceMappingURL=SubtitleCue.d.ts.map

package/dist/modules/subtitle-file/SubtitleCue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubtitleCue.d.ts","sourceRoot":"","sources":["../../../src/modules/subtitle-file/SubtitleCue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAE1E;;;;;;;GAOG;AACH,qBAAa,WAAW;IAEpB,QAAQ,CAAC,IAAI,EAAE,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,WAAW,CAAC;gBADhC,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,aAAa,CAAC,WAAW,CAAC;IAG3C,MAAM,IAAI,aAAa,CAAC,aAAa,CAAC;CAGvC"}

package/dist/modules/subtitle-file/SubtitleCue.js

@@ -0,0 +1,20 @@
+/**
+ * One timed entry of a subtitle file: the window it occupies and the
+ * rows shown inside it.
+ *
+ * A cue always covers a window of positive length and holds at least
+ * one row. Text carries no markup — escaping and joining are format
+ * concerns.
+ */
+export class SubtitleCue {
+    time;
+    rows;
+    constructor(time, rows) {
+        this.time = time;
+        this.rows = rows;
+    }
+    tokens() {
+        return this.rows.flatMap((row) => [...row.tokens]);
+    }
+}
+//# sourceMappingURL=SubtitleCue.js.map

package/dist/modules/subtitle-file/SubtitleCue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubtitleCue.js","sourceRoot":"","sources":["../../../src/modules/subtitle-file/SubtitleCue.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,MAAM,OAAO,WAAW;IAEX;IACA;IAFX,YACW,IAAkB,EAClB,IAAgC;QADhC,SAAI,GAAJ,IAAI,CAAc;QAClB,SAAI,GAAJ,IAAI,CAA4B;IACxC,CAAC;IAEJ,MAAM;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,CAAC;CACF"}

package/dist/modules/subtitle-file/SubtitleCueBuilder.d.ts

@@ -0,0 +1,38 @@
+import type { Document } from '../document/Document';
+import { type TimeRange } from '../video/RenderTimeMap';
+import { SubtitleCue } from '../subtitle-file/SubtitleCue';
+/**
+ * Turns a document into the ordered, self-consistent cue list every
+ * subtitle format is written from, so no format has to rediscover the
+ * same corrections:
+ *
+ * - Cues come out sorted by start, because document order is not time
+ *   order and segments may overlap.
+ * - A segment holding an explicit time keeps it, so a phrase held on
+ *   screen past its narration lasts as long in the file.
+ * - Words with no text drop out, and so does anything left covering an
+ *   empty window — a window of no length never becomes current during
+ *   playback, so an entry for it is one no player would ever show.
+ * - Excluded windows rebase every time, cue and token alike, onto the
+ *   timeline a render leaves behind.
+ *
+ * Text comes from each word's `text` rather than its `displayText`: a
+ * subtitle file is read back as content, and the styling passes that
+ * rewrite `displayText` state a look rather than a correction.
+ */
+export declare class SubtitleCueBuilder {
+    build(document: Document, skipRanges: ReadonlyArray<TimeRange>): ReadonlyArray<SubtitleCue>;
+    private buildCue;
+    private buildRows;
+    private buildTokens;
+    private resolveTime;
+    /**
+     * Word windows are not guaranteed to be sorted or contiguous, so the
+     * span is the outer envelope rather than the first and last entries.
+     */
+    private spanOf;
+    private rebase;
+    private rebaseRows;
+    private rebaseFragment;
+}
+//# sourceMappingURL=SubtitleCueBuilder.d.ts.map

package/dist/modules/subtitle-file/SubtitleCueBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubtitleCueBuilder.d.ts","sourceRoot":"","sources":["../../../src/modules/subtitle-file/SubtitleCueBuilder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAG3D,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAIjE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,kBAAkB;IAE7B,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,CAAC,SAAS,CAAC,GAAG,aAAa,CAAC,WAAW,CAAC;IAW3F,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,WAAW;IAMnB;;;OAGG;IACH,OAAO,CAAC,MAAM;IAYd,OAAO,CAAC,MAAM;IAad,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,cAAc;CAMvB"}

package/dist/modules/subtitle-file/SubtitleCueBuilder.js

@@ -0,0 +1,106 @@
+import { TimeFragment } from '../document/TimeFragment';
+import { RenderTimeMap } from '../video/RenderTimeMap';
+import { SubtitleCue } from '../subtitle-file/SubtitleCue';
+import { SubtitleRow } from '../subtitle-file/SubtitleRow';
+import { SubtitleToken } from '../subtitle-file/SubtitleToken';
+/**
+ * Turns a document into the ordered, self-consistent cue list every
+ * subtitle format is written from, so no format has to rediscover the
+ * same corrections:
+ *
+ * - Cues come out sorted by start, because document order is not time
+ *   order and segments may overlap.
+ * - A segment holding an explicit time keeps it, so a phrase held on
+ *   screen past its narration lasts as long in the file.
+ * - Words with no text drop out, and so does anything left covering an
+ *   empty window — a window of no length never becomes current during
+ *   playback, so an entry for it is one no player would ever show.
+ * - Excluded windows rebase every time, cue and token alike, onto the
+ *   timeline a render leaves behind.
+ *
+ * Text comes from each word's `text` rather than its `displayText`: a
+ * subtitle file is read back as content, and the styling passes that
+ * rewrite `displayText` state a look rather than a correction.
+ */
+export class SubtitleCueBuilder {
+    build(document, skipRanges) {
+        const cues = [];
+        for (const segment of document.getSegments()) {
+            const cue = this.buildCue(segment);
+            if (cue)
+                cues.push(cue);
+        }
+        const ordered = cues.sort((a, b) => a.time.start - b.time.start);
+        if (skipRanges.length === 0)
+            return ordered;
+        return this.rebase(ordered, new RenderTimeMap(skipRanges));
+    }
+    buildCue(segment) {
+        const rows = this.buildRows(segment);
+        if (rows.length === 0)
+            return null;
+        const time = this.resolveTime(segment, rows);
+        if (time.duration <= 0)
+            return null;
+        return new SubtitleCue(time, rows);
+    }
+    buildRows(segment) {
+        const rows = [];
+        for (const line of segment.lines) {
+            const tokens = this.buildTokens(line);
+            if (tokens.length > 0)
+                rows.push(new SubtitleRow(tokens));
+        }
+        return rows;
+    }
+    buildTokens(line) {
+        const tokens = [];
+        for (const word of line.words) {
+            const text = word.text.trim();
+            if (text.length > 0)
+                tokens.push(new SubtitleToken(text, word.time));
+        }
+        return tokens;
+    }
+    resolveTime(segment, rows) {
+        if (segment.customTime)
+            return segment.customTime;
+        if (segment.effectTime)
+            return segment.effectTime;
+        return this.spanOf(rows);
+    }
+    /**
+     * Word windows are not guaranteed to be sorted or contiguous, so the
+     * span is the outer envelope rather than the first and last entries.
+     */
+    spanOf(rows) {
+        let start = Number.POSITIVE_INFINITY;
+        let end = Number.NEGATIVE_INFINITY;
+        for (const row of rows) {
+            for (const token of row.tokens) {
+                if (token.time.start < start)
+                    start = token.time.start;
+                if (token.time.end > end)
+                    end = token.time.end;
+            }
+        }
+        return new TimeFragment(start, end);
+    }
+    rebase(cues, timeMap) {
+        const rebased = [];
+        for (const cue of cues) {
+            const time = this.rebaseFragment(cue.time, timeMap);
+            if (time.duration <= 0)
+                continue;
+            rebased.push(new SubtitleCue(time, this.rebaseRows(cue.rows, timeMap)));
+        }
+        return rebased;
+    }
+    rebaseRows(rows, timeMap) {
+        return rows.map((row) => new SubtitleRow(row.tokens.map((token) => new SubtitleToken(token.text, this.rebaseFragment(token.time, timeMap)))));
+    }
+    rebaseFragment(fragment, timeMap) {
+        return new TimeFragment(timeMap.toOutputTime(fragment.start), timeMap.toOutputTime(fragment.end));
+    }
+}
+//# sourceMappingURL=SubtitleCueBuilder.js.map

package/dist/modules/subtitle-file/SubtitleCueBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubtitleCueBuilder.js","sourceRoot":"","sources":["../../../src/modules/subtitle-file/SubtitleCueBuilder.ts"],"names":[],"mappings":"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"}

package/dist/modules/subtitle-file/SubtitleFileJob.d.ts

@@ -0,0 +1,17 @@
+import type { Document } from '../document/Document';
+import type { TimeRange } from '../video/RenderTimeMap';
+import type { SubtitleGranularity } from '../subtitle-file/SubtitleGranularity';
+/**
+ * Everything a subtitle file is written from.
+ *
+ * `skipRanges` names the windows a render of the same document leaves
+ * out, and must match the ones handed to the renderer. The file is
+ * written on the timeline those exclusions produce, so both outputs
+ * line up against the same footage; omit it when nothing is excluded.
+ */
+export interface SubtitleFileJob {
+    readonly document: Document;
+    readonly granularity: SubtitleGranularity;
+    readonly skipRanges?: ReadonlyArray<TimeRange>;
+}
+//# sourceMappingURL=SubtitleFileJob.d.ts.map

package/dist/modules/subtitle-file/SubtitleFileJob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubtitleFileJob.d.ts","sourceRoot":"","sources":["../../../src/modules/subtitle-file/SubtitleFileJob.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AAEtF;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;CAChD"}

package/dist/modules/subtitle-file/SubtitleFileJob.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SubtitleFileJob.js.map

package/dist/modules/subtitle-file/SubtitleFileJob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubtitleFileJob.js","sourceRoot":"","sources":["../../../src/modules/subtitle-file/SubtitleFileJob.ts"],"names":[],"mappings":""}

package/dist/modules/subtitle-file/SubtitleFileSerializer.d.ts

@@ -0,0 +1,36 @@
+import { SubtitleCue } from '../subtitle-file/SubtitleCue';
+import type { SubtitleFileJob } from '../subtitle-file/SubtitleFileJob';
+import type { SubtitleGranularity } from '../subtitle-file/SubtitleGranularity';
+/**
+ * Writes a document out as one subtitle file format.
+ *
+ * The declared media type and extension travel with the serializer, so
+ * everything a caller needs in order to hand the result to a user comes
+ * from the object that produced it.
+ *
+ * Every format is written from the same corrected view of the document,
+ * which is why the shared preparation lives here and subclasses are
+ * left with nothing but their own syntax. What differs is how far a
+ * format can honour `granularity`: some carry word timing inside a
+ * normal entry, some can only reach it by emitting one entry per word,
+ * and some carry no timing at all.
+ *
+ * A document with nothing to show yields an empty body rather than an
+ * error.
+ */
+export declare abstract class SubtitleFileSerializer {
+    private readonly cueBuilder;
+    /** Media type of the produced text. */
+    abstract readonly mediaType: string;
+    /** Filename extension, without the leading dot. */
+    abstract readonly fileExtension: string;
+    serialize(job: SubtitleFileJob): string;
+    protected abstract write(cues: ReadonlyArray<SubtitleCue>, granularity: SubtitleGranularity): string;
+    /**
+     * The same content cut down to one entry per word, for a format whose
+     * only way to express word timing is to multiply its entries. Words
+     * covering an empty window drop out, since no player would show them.
+     */
+    protected perWordCues(cues: ReadonlyArray<SubtitleCue>): ReadonlyArray<SubtitleCue>;
+}
+//# sourceMappingURL=SubtitleFileSerializer.d.ts.map

package/dist/modules/subtitle-file/SubtitleFileSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubtitleFileSerializer.d.ts","sourceRoot":"","sources":["../../../src/modules/subtitle-file/SubtitleFileSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAGjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AAEtF;;;;;;;;;;;;;;;;GAgBG;AACH,8BAAsB,sBAAsB;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;IAEvD,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAEpC,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAExC,SAAS,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM;IAKvC,SAAS,CAAC,QAAQ,CAAC,KAAK,CACtB,IAAI,EAAE,aAAa,CAAC,WAAW,CAAC,EAChC,WAAW,EAAE,mBAAmB,GAC/B,MAAM;IAET;;;;OAIG;IACH,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,aAAa,CAAC,WAAW,CAAC;CAUpF"}

package/dist/modules/subtitle-file/SubtitleFileSerializer.js

@@ -0,0 +1,44 @@
+import { SubtitleCue } from '../subtitle-file/SubtitleCue';
+import { SubtitleCueBuilder } from '../subtitle-file/SubtitleCueBuilder';
+import { SubtitleRow } from '../subtitle-file/SubtitleRow';
+/**
+ * Writes a document out as one subtitle file format.
+ *
+ * The declared media type and extension travel with the serializer, so
+ * everything a caller needs in order to hand the result to a user comes
+ * from the object that produced it.
+ *
+ * Every format is written from the same corrected view of the document,
+ * which is why the shared preparation lives here and subclasses are
+ * left with nothing but their own syntax. What differs is how far a
+ * format can honour `granularity`: some carry word timing inside a
+ * normal entry, some can only reach it by emitting one entry per word,
+ * and some carry no timing at all.
+ *
+ * A document with nothing to show yields an empty body rather than an
+ * error.
+ */
+export class SubtitleFileSerializer {
+    cueBuilder = new SubtitleCueBuilder();
+    serialize(job) {
+        const cues = this.cueBuilder.build(job.document, job.skipRanges ?? []);
+        return this.write(cues, job.granularity);
+    }
+    /**
+     * The same content cut down to one entry per word, for a format whose
+     * only way to express word timing is to multiply its entries. Words
+     * covering an empty window drop out, since no player would show them.
+     */
+    perWordCues(cues) {
+        const perWord = [];
+        for (const cue of cues) {
+            for (const token of cue.tokens()) {
+                if (token.time.duration <= 0)
+                    continue;
+                perWord.push(new SubtitleCue(token.time, [new SubtitleRow([token])]));
+            }
+        }
+        return perWord;
+    }
+}
+//# sourceMappingURL=SubtitleFileSerializer.js.map

package/dist/modules/subtitle-file/SubtitleFileSerializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubtitleFileSerializer.js","sourceRoot":"","sources":["../../../src/modules/subtitle-file/SubtitleFileSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAIjE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAgB,sBAAsB;IACzB,UAAU,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAQvD,SAAS,CAAC,GAAoB;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;IAC3C,CAAC;IAOD;;;;OAIG;IACO,WAAW,CAAC,IAAgC;QACpD,MAAM,OAAO,GAAkB,EAAE,CAAC;QAClC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;gBACjC,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC;oBAAE,SAAS;gBACvC,OAAO,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/modules/subtitle-file/SubtitleGranularity.d.ts

@@ -0,0 +1,11 @@
+/**
+ * How precisely the caller wants timing represented in the file.
+ *
+ * `segment` times whole phrases, the shape every player expects.
+ * `word` asks for timing down to each word; a format satisfies that
+ * however it can, so the cost differs sharply between formats — some
+ * carry word timing inside a normal entry, others can only reach it by
+ * emitting one entry per word.
+ */
+export type SubtitleGranularity = 'segment' | 'word';
+//# sourceMappingURL=SubtitleGranularity.d.ts.map

package/dist/modules/subtitle-file/SubtitleGranularity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubtitleGranularity.d.ts","sourceRoot":"","sources":["../../../src/modules/subtitle-file/SubtitleGranularity.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,MAAM,CAAC"}

package/dist/modules/subtitle-file/SubtitleGranularity.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SubtitleGranularity.js.map

package/dist/modules/subtitle-file/SubtitleGranularity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubtitleGranularity.js","sourceRoot":"","sources":["../../../src/modules/subtitle-file/SubtitleGranularity.ts"],"names":[],"mappings":""}

package/dist/modules/subtitle-file/SubtitleRow.d.ts

@@ -0,0 +1,11 @@
+import type { SubtitleToken } from '../subtitle-file/SubtitleToken';
+/**
+ * One visual line inside a subtitle entry. Always holds at least one
+ * token, and its tokens are in reading order.
+ */
+export declare class SubtitleRow {
+    readonly tokens: ReadonlyArray<SubtitleToken>;
+    constructor(tokens: ReadonlyArray<SubtitleToken>);
+    text(): string;
+}
+//# sourceMappingURL=SubtitleRow.d.ts.map

package/dist/modules/subtitle-file/SubtitleRow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubtitleRow.d.ts","sourceRoot":"","sources":["../../../src/modules/subtitle-file/SubtitleRow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAE1E;;;GAGG;AACH,qBAAa,WAAW;IACV,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC;gBAApC,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC;IAEzD,IAAI,IAAI,MAAM;CAGf"}

package/dist/modules/subtitle-file/SubtitleRow.js

@@ -0,0 +1,14 @@
+/**
+ * One visual line inside a subtitle entry. Always holds at least one
+ * token, and its tokens are in reading order.
+ */
+export class SubtitleRow {
+    tokens;
+    constructor(tokens) {
+        this.tokens = tokens;
+    }
+    text() {
+        return this.tokens.map((token) => token.text).join(' ');
+    }
+}
+//# sourceMappingURL=SubtitleRow.js.map

package/dist/modules/subtitle-file/SubtitleRow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubtitleRow.js","sourceRoot":"","sources":["../../../src/modules/subtitle-file/SubtitleRow.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,WAAW;IACD;IAArB,YAAqB,MAAoC;QAApC,WAAM,GAAN,MAAM,CAA8B;IAAG,CAAC;IAE7D,IAAI;QACF,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/modules/subtitle-file/SubtitleToken.d.ts

@@ -0,0 +1,13 @@
+import type { TimeFragment } from '../document/TimeFragment';
+/**
+ * One spoken word inside a subtitle entry, with the window it occupies.
+ *
+ * Formats that can express timing below the entry level read the
+ * windows; the rest read only the text.
+ */
+export declare class SubtitleToken {
+    readonly text: string;
+    readonly time: TimeFragment;
+    constructor(text: string, time: TimeFragment);
+}
+//# sourceMappingURL=SubtitleToken.d.ts.map

package/dist/modules/subtitle-file/SubtitleToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubtitleToken.d.ts","sourceRoot":"","sources":["../../../src/modules/subtitle-file/SubtitleToken.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAEnE;;;;;GAKG;AACH,qBAAa,aAAa;IAEtB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,YAAY;gBADlB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,YAAY;CAE9B"}

package/dist/modules/subtitle-file/SubtitleToken.js

@@ -0,0 +1,15 @@
+/**
+ * One spoken word inside a subtitle entry, with the window it occupies.
+ *
+ * Formats that can express timing below the entry level read the
+ * windows; the rest read only the text.
+ */
+export class SubtitleToken {
+    text;
+    time;
+    constructor(text, time) {
+        this.text = text;
+        this.time = time;
+    }
+}
+//# sourceMappingURL=SubtitleToken.js.map

package/dist/modules/subtitle-file/SubtitleToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubtitleToken.js","sourceRoot":"","sources":["../../../src/modules/subtitle-file/SubtitleToken.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IAEb;IACA;IAFX,YACW,IAAY,EACZ,IAAkB;QADlB,SAAI,GAAJ,IAAI,CAAQ;QACZ,SAAI,GAAJ,IAAI,CAAc;IAC1B,CAAC;CACL"}

package/dist/modules/subtitle-file/TextSubtitleFileSerializer.d.ts

@@ -0,0 +1,19 @@
+import type { SubtitleCue } from '../subtitle-file/SubtitleCue';
+import { SubtitleFileSerializer } from '../subtitle-file/SubtitleFileSerializer';
+import type { SubtitleGranularity } from '../subtitle-file/SubtitleGranularity';
+/**
+ * Writes the plain transcript (`.txt`): one line per entry, no timing
+ * at all. For the reader whose errand is the words themselves — notes,
+ * an article, a translation pass — rather than anything played back.
+ *
+ * Rows are joined with a space rather than kept apart, because where a
+ * caption wrapped on screen says nothing about the text. Granularity is
+ * ignored: a file with no timing has no timing to make finer.
+ */
+export declare class TextSubtitleFileSerializer extends SubtitleFileSerializer {
+    readonly mediaType = "text/plain";
+    readonly fileExtension = "txt";
+    protected write(cues: ReadonlyArray<SubtitleCue>, _granularity: SubtitleGranularity): string;
+    private writeCue;
+}
+//# sourceMappingURL=TextSubtitleFileSerializer.d.ts.map

package/dist/modules/subtitle-file/TextSubtitleFileSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextSubtitleFileSerializer.d.ts","sourceRoot":"","sources":["../../../src/modules/subtitle-file/TextSubtitleFileSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AAItF;;;;;;;;GAQG;AACH,qBAAa,0BAA2B,SAAQ,sBAAsB;IACpE,QAAQ,CAAC,SAAS,gBAAgB;IAClC,QAAQ,CAAC,aAAa,SAAS;IAE/B,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,WAAW,CAAC,EAAE,YAAY,EAAE,mBAAmB,GAAG,MAAM;IAK5F,OAAO,CAAC,QAAQ;CAGjB"}

package/dist/modules/subtitle-file/TextSubtitleFileSerializer.js

@@ -0,0 +1,24 @@
+import { SubtitleFileSerializer } from '../subtitle-file/SubtitleFileSerializer';
+const NEW_LINE = '\n';
+/**
+ * Writes the plain transcript (`.txt`): one line per entry, no timing
+ * at all. For the reader whose errand is the words themselves — notes,
+ * an article, a translation pass — rather than anything played back.
+ *
+ * Rows are joined with a space rather than kept apart, because where a
+ * caption wrapped on screen says nothing about the text. Granularity is
+ * ignored: a file with no timing has no timing to make finer.
+ */
+export class TextSubtitleFileSerializer extends SubtitleFileSerializer {
+    mediaType = 'text/plain';
+    fileExtension = 'txt';
+    write(cues, _granularity) {
+        if (cues.length === 0)
+            return '';
+        return `${cues.map((cue) => this.writeCue(cue)).join(NEW_LINE)}${NEW_LINE}`;
+    }
+    writeCue(cue) {
+        return cue.rows.map((row) => row.text()).join(' ');
+    }
+}
+//# sourceMappingURL=TextSubtitleFileSerializer.js.map

package/dist/modules/subtitle-file/TextSubtitleFileSerializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextSubtitleFileSerializer.js","sourceRoot":"","sources":["../../../src/modules/subtitle-file/TextSubtitleFileSerializer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AAGvF,MAAM,QAAQ,GAAG,IAAI,CAAC;AAEtB;;;;;;;;GAQG;AACH,MAAM,OAAO,0BAA2B,SAAQ,sBAAsB;IAC3D,SAAS,GAAG,YAAY,CAAC;IACzB,aAAa,GAAG,KAAK,CAAC;IAErB,KAAK,CAAC,IAAgC,EAAE,YAAiC;QACjF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACjC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,QAAQ,EAAE,CAAC;IAC9E,CAAC;IAEO,QAAQ,CAAC,GAAgB;QAC/B,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrD,CAAC;CACF"}

package/dist/modules/subtitle-file/Timecode.d.ts

@@ -0,0 +1,20 @@
+/**
+ * A position on the timeline broken into the parts a subtitle timecode
+ * is written from. Formats differ in separators, padding and precision,
+ * so the decomposition is shared and the assembly is not.
+ *
+ * A position before the start of the timeline clamps to zero, and the
+ * fractional part is rounded to whole milliseconds — finer detail than
+ * any of these formats can hold.
+ */
+export declare class Timecode {
+    readonly hours: number;
+    readonly minutes: number;
+    readonly seconds: number;
+    readonly milliseconds: number;
+    constructor(positionSeconds: number);
+    /** Hundredths of a second, for formats that stop at that precision. */
+    centiseconds(): number;
+    padded(value: number, width: number): string;
+}
+//# sourceMappingURL=Timecode.d.ts.map

package/dist/modules/subtitle-file/Timecode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Timecode.d.ts","sourceRoot":"","sources":["../../../src/modules/subtitle-file/Timecode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,qBAAa,QAAQ;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAElB,eAAe,EAAE,MAAM;IAUnC,uEAAuE;IACvE,YAAY,IAAI,MAAM;IAItB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;CAG7C"}