@tscaps/engine 0.1.1 → 0.3.0

package/dist/modules/rendering/types/ElementRenderOverrides.js

@@ -0,0 +1,52 @@
+/**
+ * Render-time overrides indexed by element id.
+ * The bitmap renderer looks up each element by
+ * id and layers the resolved override over the style's root defaults.
+ */
+export class ElementRenderOverrides {
+    entries;
+    static empty() {
+        return new ElementRenderOverrides(new Map());
+    }
+    static fromEntries(entries) {
+        return new ElementRenderOverrides(new Map(entries));
+    }
+    constructor(entries) {
+        this.entries = entries;
+    }
+    isEmpty() {
+        return this.entries.size === 0;
+    }
+    get(elementId) {
+        return this.entries.get(elementId);
+    }
+    /**
+     * A new instance layering `other` over this one: elements present in
+     * only one side keep their entry; for elements present in both,
+     * `other`'s inline styles merge key-by-key over this one's, and its
+     * alignment and classes replace them when present.
+     */
+    mergedWith(other) {
+        if (other.isEmpty())
+            return this;
+        if (this.isEmpty())
+            return other;
+        const merged = new Map(this.entries);
+        for (const [elementId, override] of other.entries) {
+            const base = merged.get(elementId);
+            merged.set(elementId, base ? this.mergeOverride(base, override) : override);
+        }
+        return new ElementRenderOverrides(merged);
+    }
+    mergeOverride(base, layer) {
+        const inlineStyles = base.inlineStyles || layer.inlineStyles
+            ? { ...base.inlineStyles, ...layer.inlineStyles }
+            : undefined;
+        return {
+            ...(inlineStyles ? { inlineStyles } : {}),
+            ...((layer.alignment ?? base.alignment) ? { alignment: layer.alignment ?? base.alignment } : {}),
+            ...((layer.classes ?? base.classes) ? { classes: layer.classes ?? base.classes } : {}),
+        };
+    }
+}
+//# sourceMappingURL=ElementRenderOverrides.js.map

package/dist/modules/rendering/types/ElementRenderOverrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElementRenderOverrides.js","sourceRoot":"","sources":["../../../../src/modules/rendering/types/ElementRenderOverrides.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,sBAAsB;IAYd;IAXnB,MAAM,CAAC,KAAK;QACV,OAAO,IAAI,sBAAsB,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,CAAC,WAAW,CAChB,OAA+D;QAE/D,OAAO,IAAI,sBAAsB,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,YACmB,OAAkD;QAAlD,YAAO,GAAP,OAAO,CAA2C;IAClE,CAAC;IAEJ,OAAO;QACL,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,KAA6B;QACtC,IAAI,KAAK,CAAC,OAAO,EAAE;YAAE,OAAO,IAAI,CAAC;QACjC,IAAI,IAAI,CAAC,OAAO,EAAE;YAAE,OAAO,KAAK,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrC,KAAK,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACnC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAEO,aAAa,CAAC,IAA0B,EAAE,KAA2B;QAC3E,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,KAAK,CAAC,YAAY;YAC1D,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE,GAAG,KAAK,CAAC,YAAY,EAAE;YACjD,CAAC,CAAC,SAAS,CAAC;QACd,OAAO;YACL,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzC,GAAG,CAAC,CAAC,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvF,CAAC;IACJ,CAAC;CACF"}

package/dist/modules/rendering/types/InlineStyleMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InlineStyleMap.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/types/InlineStyleMap.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC"}

package/dist/modules/rendering/types/InlineStyleMap.js.map

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

package/dist/modules/rendering/{RenderingConfig.d.ts → types/RenderingConfig.d.ts}

@@ -1,4 +1,5 @@
-import type { BoxEdges } from '../rendering/BoxEdges';
+import type { BoxEdges } from '../../rendering/types/BoxEdges';
+import type { TextDirection } from '../../bidi/TextDirection';
 /**
  * Whether a style consumes the underlying video frame as part of
  * its visuals, and — when it does — at what JPEG quality the frame
@@ -18,5 +19,11 @@ export interface RenderingConfig {
     readonly videoFrame: VideoFrameRequirement;
     /** Extra space around the segment box, per side. `null` when not declared. */
     readonly padding: BoxEdges | null;
+    /**
+     * Paragraph direction the bidirectional algorithm resolves each line
+     * against. It decides where every word lands, so it must describe the
+     * language of the text rather than a visual preference.
+     */
+    readonly textDirection: TextDirection;
 }
 //# sourceMappingURL=RenderingConfig.d.ts.map

package/dist/modules/rendering/types/RenderingConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderingConfig.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/types/RenderingConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC;IAC3C,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;CACvC"}

package/dist/modules/rendering/types/RenderingConfig.js.map

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

package/dist/modules/rendering/types/ScopedRenderOverride.d.ts

@@ -0,0 +1,24 @@
+import type { AlignmentConfig } from '../../rendering/types/AlignmentConfig';
+import type { InlineStyleMap } from '../../rendering/types/InlineStyleMap';
+/**
+ * Render-time overrides for one element (segment or word), layered on
+ * top of the style's root-level defaults. The fields are independent
+ * and optional; an entry where all are absent is equivalent to the
+ * absence of the entry and should be omitted by builders.
+ *
+ * `inlineStyles` lands on the element's `style="..."` attribute (CSS
+ * custom properties and direct properties coexist transparently);
+ * `alignment` is partial and merges over the style's root alignment to
+ * yield the element's effective anchor point and box-edge selection;
+ * `classes` are appended to the element's class list, so stylesheets
+ * can select on consumer-driven state. Segment-scope classes apply to
+ * the main segment subtree only — positioned sibling subtrees (a word
+ * pinned at its own anchor) hold their exact spot and must not pick
+ * up state-driven styling.
+ */
+export interface ScopedRenderOverride {
+    readonly inlineStyles?: InlineStyleMap;
+    readonly alignment?: Partial<AlignmentConfig>;
+    readonly classes?: ReadonlyArray<string>;
+}
+//# sourceMappingURL=ScopedRenderOverride.d.ts.map

package/dist/modules/rendering/types/ScopedRenderOverride.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScopedRenderOverride.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/types/ScopedRenderOverride.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAE9E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,cAAc,CAAC;IACvC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC1C"}

package/dist/modules/rendering/types/ScopedRenderOverride.js.map

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

package/dist/modules/rendering/types/VideoFrameSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoFrameSource.d.ts","sourceRoot":"","sources":["../../../../src/modules/rendering/types/VideoFrameSource.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;OASG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAClG"}

package/dist/modules/rendering/types/VideoFrameSource.js.map

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

package/dist/modules/splitting/BoundaryScoreLimitByCharsSegmentSplitter.d.ts

@@ -0,0 +1,33 @@
+import type { SegmentSplitter } from '../splitting/SegmentSplitter';
+import { Segment } from '../document/Segment';
+export interface BoundaryScoreLimitByCharsConfig {
+    maxChars: number;
+    minChars: number;
+}
+/**
+ * Splits segments by character count, keeping each chunk between
+ * `minChars` and `maxChars` when possible. Among the cut positions
+ * that satisfy both bounds, the one after the word with the highest
+ * `boundaryScore` wins — cuts land where an external scorer marked a
+ * strong boundary. When no word in the valid range carries a score,
+ * the splitter falls back to the greedy behaviour: grow the chunk to
+ * the maximum and retreat only enough to keep the tail above
+ * `minChars`.
+ *
+ * When the residual tail is too short to satisfy both bounds on its
+ * own, its words are absorbed into the current chunk as a last
+ * resort.
+ */
+export declare class BoundaryScoreLimitByCharsSegmentSplitter implements SegmentSplitter {
+    private readonly _config;
+    constructor(_config: BoundaryScoreLimitByCharsConfig);
+    split(segments: ReadonlyArray<Segment>): Segment[];
+    private splitSegment;
+    private pickCut;
+    private largestCutWithinMax;
+    private smallestCutMeetingMin;
+    private cutsPreservingTail;
+    private highestScoredCut;
+    private weight;
+}
+//# sourceMappingURL=BoundaryScoreLimitByCharsSegmentSplitter.d.ts.map

package/dist/modules/splitting/BoundaryScoreLimitByCharsSegmentSplitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoundaryScoreLimitByCharsSegmentSplitter.d.ts","sourceRoot":"","sources":["../../../src/modules/splitting/BoundaryScoreLimitByCharsSegmentSplitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAIpD,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,wCAAyC,YAAW,eAAe;IAClE,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,+BAA+B;IAErE,KAAK,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,EAAE;IAIlD,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,OAAO;IAcf,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,MAAM;CAMf"}

package/dist/modules/splitting/BoundaryScoreLimitByCharsSegmentSplitter.js

@@ -0,0 +1,100 @@
+import { Segment } from '../document/Segment';
+import { Line } from '../document/Line';
+/**
+ * Splits segments by character count, keeping each chunk between
+ * `minChars` and `maxChars` when possible. Among the cut positions
+ * that satisfy both bounds, the one after the word with the highest
+ * `boundaryScore` wins — cuts land where an external scorer marked a
+ * strong boundary. When no word in the valid range carries a score,
+ * the splitter falls back to the greedy behaviour: grow the chunk to
+ * the maximum and retreat only enough to keep the tail above
+ * `minChars`.
+ *
+ * When the residual tail is too short to satisfy both bounds on its
+ * own, its words are absorbed into the current chunk as a last
+ * resort.
+ */
+export class BoundaryScoreLimitByCharsSegmentSplitter {
+    _config;
+    constructor(_config) {
+        this._config = _config;
+    }
+    split(segments) {
+        return segments.flatMap((segment) => this.splitSegment(segment));
+    }
+    splitSegment(segment) {
+        const words = segment.getWords();
+        const n = words.length;
+        if (n === 0)
+            return [];
+        const result = [];
+        let start = 0;
+        while (start < n) {
+            const end = this.pickCut(words, start);
+            result.push(new Segment({ lines: [new Line({ words: words.slice(start, end) })] }));
+            start = end;
+        }
+        return result;
+    }
+    pickCut(words, start) {
+        const n = words.length;
+        const kHigh = this.largestCutWithinMax(words, start);
+        if (kHigh === n)
+            return n;
+        const kLow = this.smallestCutMeetingMin(words, start, kHigh);
+        if (kLow > kHigh)
+            return kHigh;
+        const candidates = this.cutsPreservingTail(words, kLow, kHigh);
+        if (candidates.length === 0)
+            return n;
+        return this.highestScoredCut(words, candidates);
+    }
+    largestCutWithinMax(words, start) {
+        const { maxChars } = this._config;
+        const n = words.length;
+        let end = start + 1;
+        while (end < n && this.weight(words, start, end + 1) <= maxChars)
+            end++;
+        return end;
+    }
+    smallestCutMeetingMin(words, start, upperBound) {
+        const { minChars } = this._config;
+        let k = start + 1;
+        while (k <= upperBound && this.weight(words, start, k) < minChars)
+            k++;
+        return k;
+    }
+    cutsPreservingTail(words, kLow, kHigh) {
+        const { minChars } = this._config;
+        const n = words.length;
+        const candidates = [];
+        for (let k = kLow; k <= kHigh; k++) {
+            if (this.weight(words, k, n) >= minChars)
+                candidates.push(k);
+        }
+        return candidates;
+    }
+    highestScoredCut(words, candidates) {
+        let best = candidates[candidates.length - 1];
+        let bestScore = -Infinity;
+        for (const k of candidates) {
+            const score = words[k - 1].boundaryScore;
+            if (score === null)
+                continue;
+            if (score > bestScore || (score === bestScore && k > best)) {
+                bestScore = score;
+                best = k;
+            }
+        }
+        return best;
+    }
+    weight(words, from, to) {
+        if (to <= from)
+            return 0;
+        let chars = to - from - 1;
+        for (let k = from; k < to; k++)
+            chars += words[k].text.length;
+        return chars;
+    }
+}
+//# sourceMappingURL=BoundaryScoreLimitByCharsSegmentSplitter.js.map

package/dist/modules/splitting/BoundaryScoreLimitByCharsSegmentSplitter.js.map

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

package/dist/modules/splitting/FixedTailLineSplitter.d.ts

@@ -0,0 +1,29 @@
+import type { LineSplitter } from '../splitting/LineSplitter';
+import { Segment } from '../document/Segment';
+export interface FixedTailLineSplitterConfig {
+    /**
+     * Word count reserved for the second (tail) line. Honored only when the
+     * segment carries strictly more words than this value; otherwise the
+     * splitter falls back to a one-word head and a tail with the rest, so
+     * neither line is empty.
+     */
+    readonly tailWordCount: number;
+}
+/**
+ * Splits each segment into exactly two lines when possible: the head line
+ * receives every word except the last `tailWordCount`, and the tail line
+ * receives those final words. Segments with one or two words stay on a
+ * single line; segments with three or more words but fewer than
+ * `tailWordCount + 1` fall back to one word on the head and the remainder
+ * on the tail, so neither line ends up empty.
+ */
+export declare class FixedTailLineSplitter implements LineSplitter {
+    private readonly _config;
+    private static readonly MIN_WORDS_TO_SPLIT;
+    constructor(_config: FixedTailLineSplitterConfig);
+    split(segments: ReadonlyArray<Segment>): Segment[];
+    private splitSegment;
+    private buildLines;
+    private headSize;
+}
+//# sourceMappingURL=FixedTailLineSplitter.d.ts.map

package/dist/modules/splitting/FixedTailLineSplitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FixedTailLineSplitter.d.ts","sourceRoot":"","sources":["../../../src/modules/splitting/FixedTailLineSplitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAIpD,MAAM,WAAW,2BAA2B;IAC1C;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,qBAAa,qBAAsB,YAAW,YAAY;IAG5C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAK;gBAElB,OAAO,EAAE,2BAA2B;IAEjE,KAAK,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,EAAE;IAIlD,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,QAAQ;CAMjB"}

package/dist/modules/splitting/FixedTailLineSplitter.js

@@ -0,0 +1,43 @@
+import { Line } from '../document/Line';
+/**
+ * Splits each segment into exactly two lines when possible: the head line
+ * receives every word except the last `tailWordCount`, and the tail line
+ * receives those final words. Segments with one or two words stay on a
+ * single line; segments with three or more words but fewer than
+ * `tailWordCount + 1` fall back to one word on the head and the remainder
+ * on the tail, so neither line ends up empty.
+ */
+export class FixedTailLineSplitter {
+    _config;
+    static MIN_WORDS_TO_SPLIT = 3;
+    constructor(_config) {
+        this._config = _config;
+    }
+    split(segments) {
+        return segments.map((segment) => this.splitSegment(segment));
+    }
+    splitSegment(segment) {
+        const words = segment.getWords();
+        if (words.length === 0)
+            return segment;
+        const lines = this.buildLines(words);
+        return segment.with({ lines });
+    }
+    buildLines(words) {
+        if (words.length < FixedTailLineSplitter.MIN_WORDS_TO_SPLIT) {
+            return [new Line({ words })];
+        }
+        const splitAt = this.headSize(words.length);
+        return [
+            new Line({ words: words.slice(0, splitAt) }),
+            new Line({ words: words.slice(splitAt) }),
+        ];
+    }
+    headSize(totalWords) {
+        if (totalWords > this._config.tailWordCount) {
+            return totalWords - this._config.tailWordCount;
+        }
+        return 1;
+    }
+}
+//# sourceMappingURL=FixedTailLineSplitter.js.map

package/dist/modules/splitting/FixedTailLineSplitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FixedTailLineSplitter.js","sourceRoot":"","sources":["../../../src/modules/splitting/FixedTailLineSplitter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAa9C;;;;;;;GAOG;AACH,MAAM,OAAO,qBAAqB;IAGH;IAFrB,MAAM,CAAU,kBAAkB,GAAG,CAAC,CAAC;IAE/C,YAA6B,OAAoC;QAApC,YAAO,GAAP,OAAO,CAA6B;IAAG,CAAC;IAErE,KAAK,CAAC,QAAgC;QACpC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,CAAC;IAEO,YAAY,CAAC,OAAgB;QACnC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACrC,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACjC,CAAC;IAEO,UAAU,CAAC,KAAa;QAC9B,IAAI,KAAK,CAAC,MAAM,GAAG,qBAAqB,CAAC,kBAAkB,EAAE,CAAC;YAC5D,OAAO,CAAC,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC/B,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5C,OAAO;YACL,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC;YAC5C,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;SAC1C,CAAC;IACJ,CAAC;IAEO,QAAQ,CAAC,UAAkB;QACjC,IAAI,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;YAC5C,OAAO,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;QACjD,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC"}

package/dist/modules/splitting/index.d.ts

@@ -6,6 +6,8 @@ export { LimitByCharsSegmentSplitter } from '../splitting/LimitByCharsSegmentSpl
 export type { LimitByCharsConfig } from '../splitting/LimitByCharsSegmentSplitter';
 export { LimitByScaledCharsSegmentSplitter } from '../splitting/LimitByScaledCharsSegmentSplitter';
 export type { LimitByScaledCharsConfig } from '../splitting/LimitByScaledCharsSegmentSplitter';
+export { BoundaryScoreLimitByCharsSegmentSplitter } from '../splitting/BoundaryScoreLimitByCharsSegmentSplitter';
+export type { BoundaryScoreLimitByCharsConfig } from '../splitting/BoundaryScoreLimitByCharsSegmentSplitter';
 export { BoundarySegmentSplitter } from '../splitting/BoundarySegmentSplitter';
 export type { BoundaryConfig } from '../splitting/BoundarySegmentSplitter';
 export { PauseBasedSegmentSplitter } from '../splitting/PauseBasedSegmentSplitter';
@@ -16,6 +18,8 @@ export { BalancedLineSplitter } from '../splitting/BalancedLineSplitter';
 export type { BalancedLineSplitterConfig } from '../splitting/BalancedLineSplitter';
 export { BalancedPixelWidthLineSplitter } from '../splitting/BalancedPixelWidthLineSplitter';
 export type { BalancedPixelWidthLineSplitterConfig } from '../splitting/BalancedPixelWidthLineSplitter';
+export { FixedTailLineSplitter } from '../splitting/FixedTailLineSplitter';
+export type { FixedTailLineSplitterConfig } from '../splitting/FixedTailLineSplitter';
 export type { TextMeasurer } from '../splitting/TextMeasurer';
 export { DomProbeCanvasTextMeasurer } from '../splitting/DomProbeCanvasTextMeasurer';
 export type { DomProbeCanvasTextMeasurerParams } from '../splitting/DomProbeCanvasTextMeasurer';

package/dist/modules/splitting/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/splitting/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,6CAA6C,CAAC;AACvF,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAC7F,YAAY,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AACzF,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAC7F,YAAY,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AACzF,OAAO,EAAE,iCAAiC,EAAE,MAAM,sDAAsD,CAAC;AACzG,YAAY,EAAE,wBAAwB,EAAE,MAAM,sDAAsD,CAAC;AACrG,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,YAAY,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AACzF,YAAY,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,EAAE,4BAA4B,EAAE,MAAM,iDAAiD,CAAC;AAC/F,YAAY,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,YAAY,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAC1F,OAAO,EAAE,8BAA8B,EAAE,MAAM,mDAAmD,CAAC;AACnG,YAAY,EAAE,oCAAoC,EAAE,MAAM,mDAAmD,CAAC;AAC9G,YAAY,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAC3F,YAAY,EAAE,gCAAgC,EAAE,MAAM,+CAA+C,CAAC;AACtG,YAAY,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/splitting/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,6CAA6C,CAAC;AACvF,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAC7F,YAAY,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AACzF,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAC7F,YAAY,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AACzF,OAAO,EAAE,iCAAiC,EAAE,MAAM,sDAAsD,CAAC;AACzG,YAAY,EAAE,wBAAwB,EAAE,MAAM,sDAAsD,CAAC;AACrG,OAAO,EAAE,wCAAwC,EAAE,MAAM,6DAA6D,CAAC;AACvH,YAAY,EAAE,+BAA+B,EAAE,MAAM,6DAA6D,CAAC;AACnH,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,YAAY,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AACzF,YAAY,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,EAAE,4BAA4B,EAAE,MAAM,iDAAiD,CAAC;AAC/F,YAAY,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,YAAY,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAC1F,OAAO,EAAE,8BAA8B,EAAE,MAAM,mDAAmD,CAAC;AACnG,YAAY,EAAE,oCAAoC,EAAE,MAAM,mDAAmD,CAAC;AAC9G,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACjF,YAAY,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAC5F,YAAY,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAC3F,YAAY,EAAE,gCAAgC,EAAE,MAAM,+CAA+C,CAAC;AACtG,YAAY,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC"}

package/dist/modules/splitting/index.js

@@ -2,11 +2,13 @@ export { CompositeSegmentSplitter } from '../splitting/CompositeSegmentSplitter'
 export { LimitByWordsSegmentSplitter } from '../splitting/LimitByWordsSegmentSplitter';
 export { LimitByCharsSegmentSplitter } from '../splitting/LimitByCharsSegmentSplitter';
 export { LimitByScaledCharsSegmentSplitter } from '../splitting/LimitByScaledCharsSegmentSplitter';
+export { BoundaryScoreLimitByCharsSegmentSplitter } from '../splitting/BoundaryScoreLimitByCharsSegmentSplitter';
 export { BoundarySegmentSplitter } from '../splitting/BoundarySegmentSplitter';
 export { PauseBasedSegmentSplitter } from '../splitting/PauseBasedSegmentSplitter';
 export { SpeakerChangeSegmentSplitter } from '../splitting/SpeakerChangeSegmentSplitter';
 export { BalancedLineSplitter } from '../splitting/BalancedLineSplitter';
 export { BalancedPixelWidthLineSplitter } from '../splitting/BalancedPixelWidthLineSplitter';
+export { FixedTailLineSplitter } from '../splitting/FixedTailLineSplitter';
 export { DomProbeCanvasTextMeasurer } from '../splitting/DomProbeCanvasTextMeasurer';
 export { GraphemeWordSplitter } from '../splitting/GraphemeWordSplitter';
 //# sourceMappingURL=index.js.map

package/dist/modules/splitting/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/splitting/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,6CAA6C,CAAC;AACvF,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAE7F,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAE7F,OAAO,EAAE,iCAAiC,EAAE,MAAM,sDAAsD,CAAC;AAEzG,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAErF,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AAEzF,OAAO,EAAE,4BAA4B,EAAE,MAAM,iDAAiD,CAAC;AAE/F,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAE/E,OAAO,EAAE,8BAA8B,EAAE,MAAM,mDAAmD,CAAC;AAGnG,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAG3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/splitting/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,6CAA6C,CAAC;AACvF,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAE7F,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAE7F,OAAO,EAAE,iCAAiC,EAAE,MAAM,sDAAsD,CAAC;AAEzG,OAAO,EAAE,wCAAwC,EAAE,MAAM,6DAA6D,CAAC;AAEvH,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAErF,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AAEzF,OAAO,EAAE,4BAA4B,EAAE,MAAM,iDAAiD,CAAC;AAE/F,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAE/E,OAAO,EAAE,8BAA8B,EAAE,MAAM,mDAAmD,CAAC;AAEnG,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAGjF,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAG3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC"}

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

@@ -0,0 +1,53 @@
+import type { SubtitleCue } from '../subtitle-file/SubtitleCue';
+import { SubtitleFileSerializer } from '../subtitle-file/SubtitleFileSerializer';
+import type { SubtitleGranularity } from '../subtitle-file/SubtitleGranularity';
+/**
+ * Writes Advanced SubStation Alpha (`.ass`), the format karaoke, anime
+ * and fansub tooling is built around.
+ *
+ * Word granularity is what this format exists for: a `\k` tag before
+ * each word states how long it is held, and a renderer walks the line
+ * word by word without the entry ever being split. The file stays the
+ * same length as at entry granularity, which no plain-cue format can
+ * manage.
+ *
+ * Styling does not travel. See the note on the default style for why
+ * carrying part of it would be worse than carrying none.
+ */
+export declare class AssSubtitleFileSerializer extends SubtitleFileSerializer {
+    readonly mediaType = "text/x-ssa";
+    readonly fileExtension = "ass";
+    protected write(cues: ReadonlyArray<SubtitleCue>, granularity: SubtitleGranularity): string;
+    private writeCue;
+    private writePlainBody;
+    /**
+     * A `\k` states how long the syllable before the next one is held, so
+     * the tags run back to back and nothing addresses the timeline
+     * directly. Silence between two words therefore has to be spent
+     * somewhere or every word after it starts early, and the drift adds
+     * up across the line.
+     *
+     * Each word is held until the next one is spoken, which spends the
+     * silence on the word already sung and leaves the highlight where the
+     * ear left it. Silence before the first word has no word to fall to,
+     * so it becomes an empty syllable. The syllables then tile the entry
+     * exactly.
+     */
+    private writeSungBody;
+    /**
+     * Where each word starts and where the entry ends, in hundredths from
+     * the entry's own start. Rounding positions rather than durations
+     * keeps the syllables from drifting out of the entry they belong to.
+     */
+    private syllableBoundaries;
+    private leadIn;
+    /** Braces open and close override blocks, so text has to disclaim them. */
+    private escape;
+    private centiseconds;
+    /**
+     * Rounding to hundredths before splitting the position keeps a value
+     * a hair under a whole second from printing as a hundredth too many.
+     */
+    private timecode;
+}
+//# sourceMappingURL=AssSubtitleFileSerializer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AssSubtitleFileSerializer.d.ts","sourceRoot":"","sources":["../../../src/modules/subtitle-file/AssSubtitleFileSerializer.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;AAkDtF;;;;;;;;;;;;GAYG;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;IAM3F,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,cAAc;IAItB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,aAAa;IAgBrB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,MAAM;IAId,2EAA2E;IAC3E,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,YAAY;IAIpB;;;OAGG;IACH,OAAO,CAAC,QAAQ;CAKjB"}

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

@@ -0,0 +1,133 @@
+import { SubtitleFileSerializer } from '../subtitle-file/SubtitleFileSerializer';
+import { Timecode } from '../subtitle-file/Timecode';
+const NEW_LINE = '\r\n';
+const ROW_BREAK = '\\N';
+/**
+ * The reference frame the style's sizes and margins are read against.
+ * A renderer scales the whole script from it to whatever the video
+ * actually measures, so the numbers stay sensible on any footage.
+ */
+const REFERENCE_WIDTH = 1920;
+const REFERENCE_HEIGHT = 1080;
+/**
+ * A deliberately plain style. The design a project carries cannot
+ * survive the trip — the format addresses fonts by name and expects
+ * them installed on the machine that plays the file, and it has no way
+ * to express per-word animation, narration highlighting or any of the
+ * effects a template is built from. A partial likeness would read as a
+ * broken export rather than as the limit of the format, so the file
+ * states plainly that it carries text and timing.
+ *
+ * Fields, in the order the format declares them: name, font, size, the
+ * four colours (ABGR, leading pair is alpha), the four toggles, scale,
+ * spacing, angle, border style, outline, shadow, alignment, the three
+ * margins, encoding.
+ */
+const DEFAULT_STYLE = 'Style: Default,Arial,48,&H00FFFFFF,&H00A0A0A0,&H00000000,&H00000000,'
+    + '0,0,0,0,100,100,0,0,1,3,0,2,60,60,60,1';
+const HEADER = [
+    '[Script Info]',
+    'ScriptType: v4.00+',
+    'WrapStyle: 0',
+    'ScaledBorderAndShadow: yes',
+    `PlayResX: ${REFERENCE_WIDTH}`,
+    `PlayResY: ${REFERENCE_HEIGHT}`,
+    '',
+    '[V4+ Styles]',
+    'Format: Name, Fontname, Fontsize, PrimaryColour, SecondaryColour, OutlineColour, BackColour,'
+        + ' Bold, Italic, Underline, StrikeOut, ScaleX, ScaleY, Spacing, Angle, BorderStyle, Outline,'
+        + ' Shadow, Alignment, MarginL, MarginR, MarginV, Encoding',
+    DEFAULT_STYLE,
+    '',
+    '[Events]',
+    'Format: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text',
+].join(NEW_LINE);
+/**
+ * Writes Advanced SubStation Alpha (`.ass`), the format karaoke, anime
+ * and fansub tooling is built around.
+ *
+ * Word granularity is what this format exists for: a `\k` tag before
+ * each word states how long it is held, and a renderer walks the line
+ * word by word without the entry ever being split. The file stays the
+ * same length as at entry granularity, which no plain-cue format can
+ * manage.
+ *
+ * Styling does not travel. See the note on the default style for why
+ * carrying part of it would be worse than carrying none.
+ */
+export class AssSubtitleFileSerializer extends SubtitleFileSerializer {
+    mediaType = 'text/x-ssa';
+    fileExtension = 'ass';
+    write(cues, granularity) {
+        const events = cues.map((cue) => this.writeCue(cue, granularity)).join(NEW_LINE);
+        const separator = events.length > 0 ? NEW_LINE : '';
+        return `${HEADER}${separator}${events}${NEW_LINE}`;
+    }
+    writeCue(cue, granularity) {
+        const start = this.timecode(cue.time.start);
+        const end = this.timecode(cue.time.end);
+        const body = granularity === 'word' ? this.writeSungBody(cue) : this.writePlainBody(cue);
+        return `Dialogue: 0,${start},${end},Default,,0,0,0,,${body}`;
+    }
+    writePlainBody(cue) {
+        return cue.rows.map((row) => this.escape(row.text())).join(ROW_BREAK);
+    }
+    /**
+     * A `\k` states how long the syllable before the next one is held, so
+     * the tags run back to back and nothing addresses the timeline
+     * directly. Silence between two words therefore has to be spent
+     * somewhere or every word after it starts early, and the drift adds
+     * up across the line.
+     *
+     * Each word is held until the next one is spoken, which spends the
+     * silence on the word already sung and leaves the highlight where the
+     * ear left it. Silence before the first word has no word to fall to,
+     * so it becomes an empty syllable. The syllables then tile the entry
+     * exactly.
+     */
+    writeSungBody(cue) {
+        const boundaries = this.syllableBoundaries(cue);
+        const rows = [];
+        let spoken = 0;
+        for (const row of cue.rows) {
+            const syllables = row.tokens.map((token) => {
+                const held = boundaries[spoken + 1] - boundaries[spoken];
+                const silence = spoken === 0 ? this.leadIn(boundaries[0]) : '';
+                spoken += 1;
+                return `${silence}{\\k${held}}${this.escape(token.text)}`;
+            });
+            rows.push(syllables.join(' '));
+        }
+        return rows.join(ROW_BREAK);
+    }
+    /**
+     * Where each word starts and where the entry ends, in hundredths from
+     * the entry's own start. Rounding positions rather than durations
+     * keeps the syllables from drifting out of the entry they belong to.
+     */
+    syllableBoundaries(cue) {
+        const origin = cue.time.start;
+        const starts = cue.tokens().map((token) => this.centiseconds(token.time.start - origin));
+        return [...starts, this.centiseconds(cue.time.end - origin)];
+    }
+    leadIn(firstWordAt) {
+        return firstWordAt > 0 ? `{\\k${firstWordAt}}` : '';
+    }
+    /** Braces open and close override blocks, so text has to disclaim them. */
+    escape(text) {
+        return text.replace(/\{/g, '\\{').replace(/\}/g, '\\}');
+    }
+    centiseconds(seconds) {
+        return Math.max(0, Math.round(seconds * 100));
+    }
+    /**
+     * Rounding to hundredths before splitting the position keeps a value
+     * a hair under a whole second from printing as a hundredth too many.
+     */
+    timecode(position) {
+        const at = new Timecode(Math.round(position * 100) / 100);
+        return `${at.hours}:${at.padded(at.minutes, 2)}:${at.padded(at.seconds, 2)}`
+            + `.${at.padded(at.centiseconds(), 2)}`;
+    }
+}
+//# sourceMappingURL=AssSubtitleFileSerializer.js.map

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

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

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

@@ -0,0 +1,20 @@
+import type { SubtitleCue } from '../subtitle-file/SubtitleCue';
+import { SubtitleFileSerializer } from '../subtitle-file/SubtitleFileSerializer';
+import type { SubtitleGranularity } from '../subtitle-file/SubtitleGranularity';
+/**
+ * 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 declare class SbvSubtitleFileSerializer extends SubtitleFileSerializer {
+    readonly mediaType = "text/plain";
+    readonly fileExtension = "sbv";
+    protected write(cues: ReadonlyArray<SubtitleCue>, granularity: SubtitleGranularity): string;
+    private writeCue;
+    private timecode;
+}
+//# sourceMappingURL=SbvSubtitleFileSerializer.d.ts.map