@tscaps/engine 0.1.1

package/dist/modules/effect/RemovePunctuationEffect.d.ts

@@ -0,0 +1,21 @@
+import type { Effect } from '../effect/Effect';
+import type { Document } from '../document/Document';
+import type { Segment } from '../document/Segment';
+/**
+ * Strips trailing punctuation from each matching word's `displayText`,
+ * leaving the original `text` (the transcription source of truth)
+ * untouched. Only punctuation at the end of the word is removed, so
+ * tokens like `google.com` or `15:30` keep their inner symbols. The
+ * deriver re-runs splitters and taggers from `text`, so toggling this
+ * effect off naturally restores the punctuated rendering on the next
+ * derivation.
+ */
+export declare class RemovePunctuationEffect implements Effect {
+    private readonly segmentFilter;
+    private static readonly PUNCTUATION;
+    private static readonly TRAILING_PUNCTUATION;
+    private static buildTrailingRegex;
+    constructor(segmentFilter?: (segment: Segment) => boolean);
+    apply(document: Document): Document;
+}
+//# sourceMappingURL=RemovePunctuationEffect.d.ts.map

package/dist/modules/effect/RemovePunctuationEffect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemovePunctuationEffect.d.ts","sourceRoot":"","sources":["../../../src/modules/effect/RemovePunctuationEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEzD;;;;;;;;GAQG;AACH,qBAAa,uBAAwB,YAAW,MAAM;IAqBlD,OAAO,CAAC,QAAQ,CAAC,aAAa;IApBhC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAOjC;IAEF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAgD;IAE5F,OAAO,CAAC,MAAM,CAAC,kBAAkB;gBASd,aAAa,GAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAoB;IAG5E,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;CAkBpC"}

package/dist/modules/effect/RemovePunctuationEffect.js

@@ -0,0 +1,52 @@
+/**
+ * Strips trailing punctuation from each matching word's `displayText`,
+ * leaving the original `text` (the transcription source of truth)
+ * untouched. Only punctuation at the end of the word is removed, so
+ * tokens like `google.com` or `15:30` keep their inner symbols. The
+ * deriver re-runs splitters and taggers from `text`, so toggling this
+ * effect off naturally restores the punctuated rendering on the next
+ * derivation.
+ */
+export class RemovePunctuationEffect {
+    segmentFilter;
+    static PUNCTUATION = [
+        '...',
+        '.',
+        ',',
+        ';',
+        ':',
+        '…',
+    ];
+    static TRAILING_PUNCTUATION = RemovePunctuationEffect.buildTrailingRegex();
+    static buildTrailingRegex() {
+        const alternatives = [...RemovePunctuationEffect.PUNCTUATION]
+            .sort((a, b) => b.length - a.length)
+            .map((p) => p.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'))
+            .join('|');
+        return new RegExp(`(?:${alternatives})+$`, 'u');
+    }
+    constructor(segmentFilter = () => true) {
+        this.segmentFilter = segmentFilter;
+    }
+    apply(document) {
+        const newSections = document.sections.map((section) => {
+            const newSegments = section.segments.map((segment) => {
+                if (!this.segmentFilter(segment))
+                    return segment;
+                const newLines = segment.lines.map((line) => {
+                    const newWords = line.words.map((word) => {
+                        const stripped = word.text.replace(RemovePunctuationEffect.TRAILING_PUNCTUATION, '');
+                        if (stripped === word.displayText)
+                            return word;
+                        return word.with({ displayText: stripped });
+                    });
+                    return line.with({ words: newWords });
+                });
+                return segment.with({ lines: newLines });
+            });
+            return section.with({ segments: newSegments });
+        });
+        return document.with({ sections: newSections });
+    }
+}
+//# sourceMappingURL=RemovePunctuationEffect.js.map

package/dist/modules/effect/RemovePunctuationEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemovePunctuationEffect.js","sourceRoot":"","sources":["../../../src/modules/effect/RemovePunctuationEffect.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,MAAM,OAAO,uBAAuB;IAqBf;IApBX,MAAM,CAAU,WAAW,GAAsB;QACvD,KAAK;QACL,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;QACH,GAAG;KACJ,CAAC;IAEM,MAAM,CAAU,oBAAoB,GAAG,uBAAuB,CAAC,kBAAkB,EAAE,CAAC;IAEpF,MAAM,CAAC,kBAAkB;QAC/B,MAAM,YAAY,GAAG,CAAC,GAAG,uBAAuB,CAAC,WAAW,CAAC;aAC1D,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;aACnC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;aACpD,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,OAAO,IAAI,MAAM,CAAC,MAAM,YAAY,KAAK,EAAE,GAAG,CAAC,CAAC;IAClD,CAAC;IAED,YACmB,gBAA+C,GAAG,EAAE,CAAC,IAAI;QAAzD,kBAAa,GAAb,aAAa,CAA4C;IACzE,CAAC;IAEJ,KAAK,CAAC,QAAkB;QACtB,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YACpD,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;gBACnD,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;oBAAE,OAAO,OAAO,CAAC;gBACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;oBAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;wBACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,uBAAuB,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;wBACrF,IAAI,QAAQ,KAAK,IAAI,CAAC,WAAW;4BAAE,OAAO,IAAI,CAAC;wBAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC;oBAC9C,CAAC,CAAC,CAAC;oBACH,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;gBACxC,CAAC,CAAC,CAAC;gBACH,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC3C,CAAC,CAAC,CAAC;YACH,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;IAClD,CAAC"}

package/dist/modules/effect/SmartLowercaseEffect.d.ts

@@ -0,0 +1,21 @@
+import type { Effect } from '../effect/Effect';
+import type { Document } from '../document/Document';
+import type { Segment } from '../document/Segment';
+/**
+ * Lowercases each matching word's `displayText`, preserving only words
+ * tagged as `entity` (proper nouns) and the English pronoun "I"
+ * (including contractions like "I'm", "I'll"). Targets the casual
+ * "all-lowercase" caption aesthetic where even sentence starts stay
+ * lowercased.
+ */
+export declare class SmartLowercaseEffect implements Effect {
+    private readonly segmentFilter;
+    private static readonly I_PRONOUN;
+    constructor(segmentFilter?: (segment: Segment) => boolean);
+    apply(document: Document): Document;
+    private rewriteSegment;
+    private rewriteLine;
+    private rewriteWord;
+    private isPreserved;
+}
+//# sourceMappingURL=SmartLowercaseEffect.d.ts.map

package/dist/modules/effect/SmartLowercaseEffect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmartLowercaseEffect.d.ts","sourceRoot":"","sources":["../../../src/modules/effect/SmartLowercaseEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAIzD;;;;;;GAMG;AACH,qBAAa,oBAAqB,YAAW,MAAM;IAK/C,OAAO,CAAC,QAAQ,CAAC,aAAa;IAHhC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAkB;gBAGhC,aAAa,GAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAoB;IAG5E,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;IAUnC,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,WAAW;CAGpB"}

package/dist/modules/effect/SmartLowercaseEffect.js

@@ -0,0 +1,45 @@
+/**
+ * Lowercases each matching word's `displayText`, preserving only words
+ * tagged as `entity` (proper nouns) and the English pronoun "I"
+ * (including contractions like "I'm", "I'll"). Targets the casual
+ * "all-lowercase" caption aesthetic where even sentence starts stay
+ * lowercased.
+ */
+export class SmartLowercaseEffect {
+    segmentFilter;
+    static I_PRONOUN = /^I(?:$|['’])/;
+    constructor(segmentFilter = () => true) {
+        this.segmentFilter = segmentFilter;
+    }
+    apply(document) {
+        return document.with({
+            sections: document.sections.map((section) => section.with({
+                segments: section.segments.map((segment) => this.rewriteSegment(segment)),
+            })),
+        });
+    }
+    rewriteSegment(segment) {
+        if (!this.segmentFilter(segment))
+            return segment;
+        return segment.with({
+            lines: segment.lines.map((line) => this.rewriteLine(line)),
+        });
+    }
+    rewriteLine(line) {
+        return line.with({
+            words: line.words.map((word) => this.rewriteWord(word)),
+        });
+    }
+    rewriteWord(word) {
+        if (this.isPreserved(word))
+            return word;
+        const lowered = word.displayText.toLowerCase();
+        if (lowered === word.displayText)
+            return word;
+        return word.with({ displayText: lowered });
+    }
+    isPreserved(word) {
+        return word.hasTagName('entity') || SmartLowercaseEffect.I_PRONOUN.test(word.text);
+    }
+}
+//# sourceMappingURL=SmartLowercaseEffect.js.map

package/dist/modules/effect/SmartLowercaseEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmartLowercaseEffect.js","sourceRoot":"","sources":["../../../src/modules/effect/SmartLowercaseEffect.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,MAAM,OAAO,oBAAoB;IAKZ;IAHX,MAAM,CAAU,SAAS,GAAG,cAAc,CAAC;IAEnD,YACmB,gBAA+C,GAAG,EAAE,CAAC,IAAI;QAAzD,kBAAa,GAAb,aAAa,CAA4C;IACzE,CAAC;IAEJ,KAAK,CAAC,QAAkB;QACtB,OAAO,QAAQ,CAAC,IAAI,CAAC;YACnB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAC1C,OAAO,CAAC,IAAI,CAAC;gBACX,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;aAC1E,CAAC,CACH;SACF,CAAC,CAAC;IACL,CAAC;IAEO,cAAc,CAAC,OAAgB;QACrC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC;QACjD,OAAO,OAAO,CAAC,IAAI,CAAC;YAClB,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;SAC3D,CAAC,CAAC;IACL,CAAC;IAEO,WAAW,CAAC,IAAU;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC;YACf,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;SACxD,CAAC,CAAC;IACL,CAAC;IAEO,WAAW,CAAC,IAAU;QAC5B,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;QAC/C,IAAI,OAAO,KAAK,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC;QAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;IAC7C,CAAC;IAEO,WAAW,CAAC,IAAU;QAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,oBAAoB,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrF,CAAC"}

package/dist/modules/effect/SmartPunctuationEffect.d.ts

@@ -0,0 +1,25 @@
+import type { Effect } from '../effect/Effect';
+import type { Document } from '../document/Document';
+import type { Segment } from '../document/Segment';
+/**
+ * Replaces ASCII punctuation with typographic equivalents in each
+ * matching word's `displayText`. Reads `displayText` (not `text`) so
+ * the substitution composes with other display-text effects in the
+ * pipeline order.
+ *
+ * Substitutions per word:
+ *   - `"` followed by a letter or digit → `“`; otherwise → `”`
+ *   - `'` always → `’` (typographic apostrophe)
+ *   - `--` → `—` (em dash)
+ *   - `...` → `…` (ellipsis)
+ */
+export declare class SmartPunctuationEffect implements Effect {
+    private readonly segmentFilter;
+    constructor(segmentFilter?: (segment: Segment) => boolean);
+    apply(document: Document): Document;
+    private smartify;
+    private replaceMultiCharGlyphs;
+    private replaceQuotes;
+    private opensAQuotation;
+}
+//# sourceMappingURL=SmartPunctuationEffect.d.ts.map

package/dist/modules/effect/SmartPunctuationEffect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmartPunctuationEffect.d.ts","sourceRoot":"","sources":["../../../src/modules/effect/SmartPunctuationEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEzD;;;;;;;;;;;GAWG;AACH,qBAAa,sBAAuB,YAAW,MAAM;IAGjD,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,GAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAoB;IAG5E,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;IAmBnC,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,eAAe;CAIxB"}

package/dist/modules/effect/SmartPunctuationEffect.js

@@ -0,0 +1,68 @@
+/**
+ * Replaces ASCII punctuation with typographic equivalents in each
+ * matching word's `displayText`. Reads `displayText` (not `text`) so
+ * the substitution composes with other display-text effects in the
+ * pipeline order.
+ *
+ * Substitutions per word:
+ *   - `"` followed by a letter or digit → `“`; otherwise → `”`
+ *   - `'` always → `’` (typographic apostrophe)
+ *   - `--` → `—` (em dash)
+ *   - `...` → `…` (ellipsis)
+ */
+export class SmartPunctuationEffect {
+    segmentFilter;
+    constructor(segmentFilter = () => true) {
+        this.segmentFilter = segmentFilter;
+    }
+    apply(document) {
+        const newSections = document.sections.map((section) => {
+            const newSegments = section.segments.map((segment) => {
+                if (!this.segmentFilter(segment))
+                    return segment;
+                const newLines = segment.lines.map((line) => {
+                    const newWords = line.words.map((word) => {
+                        const styled = this.smartify(word.displayText);
+                        if (styled === word.displayText)
+                            return word;
+                        return word.with({ displayText: styled });
+                    });
+                    return line.with({ words: newWords });
+                });
+                return segment.with({ lines: newLines });
+            });
+            return section.with({ segments: newSegments });
+        });
+        return document.with({ sections: newSections });
+    }
+    smartify(text) {
+        const expanded = this.replaceMultiCharGlyphs(text);
+        return this.replaceQuotes(expanded);
+    }
+    replaceMultiCharGlyphs(text) {
+        return text
+            .replace(/\.{3}/g, '…')
+            .replace(/--/g, '—');
+    }
+    replaceQuotes(text) {
+        let result = '';
+        for (let i = 0; i < text.length; i++) {
+            const ch = text[i];
+            if (ch === '"') {
+                result += this.opensAQuotation(text, i) ? '“' : '”';
+            }
+            else if (ch === "'") {
+                result += '’';
+            }
+            else {
+                result += ch;
+            }
+        }
+        return result;
+    }
+    opensAQuotation(text, index) {
+        const next = text[index + 1] ?? '';
+        return /[\p{L}\p{N}]/u.test(next);
+    }
+}
+//# sourceMappingURL=SmartPunctuationEffect.js.map

package/dist/modules/effect/SmartPunctuationEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmartPunctuationEffect.js","sourceRoot":"","sources":["../../../src/modules/effect/SmartPunctuationEffect.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,sBAAsB;IAGd;IADnB,YACmB,gBAA+C,GAAG,EAAE,CAAC,IAAI;QAAzD,kBAAa,GAAb,aAAa,CAA4C;IACzE,CAAC;IAEJ,KAAK,CAAC,QAAkB;QACtB,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YACpD,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;gBACnD,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;oBAAE,OAAO,OAAO,CAAC;gBACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;oBAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;wBACvC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;wBAC/C,IAAI,MAAM,KAAK,IAAI,CAAC,WAAW;4BAAE,OAAO,IAAI,CAAC;wBAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;oBAC5C,CAAC,CAAC,CAAC;oBACH,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;gBACxC,CAAC,CAAC,CAAC;gBACH,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC3C,CAAC,CAAC,CAAC;YACH,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;IAClD,CAAC;IAEO,QAAQ,CAAC,IAAY;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAEO,sBAAsB,CAAC,IAAY;QACzC,OAAO,IAAI;aACR,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;aACtB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACzB,CAAC;IAEO,aAAa,CAAC,IAAY;QAChC,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACnB,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACf,MAAM,IAAI,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YACtD,CAAC;iBAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;gBACtB,MAAM,IAAI,GAAG,CAAC;YAChB,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,EAAE,CAAC;YACf,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,eAAe,CAAC,IAAY,EAAE,KAAa;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACnC,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CACF"}

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

@@ -0,0 +1,7 @@
+export type { Effect } from '../effect/Effect';
+export { GapFreeEffect } from '../effect/GapFreeEffect';
+export { RemovePunctuationEffect } from '../effect/RemovePunctuationEffect';
+export { SmartPunctuationEffect } from '../effect/SmartPunctuationEffect';
+export { SmartLowercaseEffect } from '../effect/SmartLowercaseEffect';
+export { CarryQuotesEffect } from '../effect/CarryQuotesEffect';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/effect/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/modules/effect/index.js

@@ -0,0 +1,6 @@
+export { GapFreeEffect } from '../effect/GapFreeEffect';
+export { RemovePunctuationEffect } from '../effect/RemovePunctuationEffect';
+export { SmartPunctuationEffect } from '../effect/SmartPunctuationEffect';
+export { SmartLowercaseEffect } from '../effect/SmartLowercaseEffect';
+export { CarryQuotesEffect } from '../effect/CarryQuotesEffect';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/effect/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/modules/pipeline/PipelineProgress.d.ts

@@ -0,0 +1,30 @@
+import type { TranscriberProgressEvent } from '../transcription/Transcriber';
+import type { RenderProgress } from '../video/RenderJob';
+/**
+ * One step of the render pipeline reporting status. `transcribing` and
+ * `rendering` wrap the underlying stage event so listeners get the full
+ * progress payload of the work being done; the structural steps in the
+ * middle (`splitting`, tagging, effects) emit a `started`/`completed`
+ * boundary because they finish in a single synchronous pass.
+ */
+export type PipelineProgressEvent = {
+    stage: 'transcribing';
+    inner: TranscriberProgressEvent;
+} | {
+    stage: 'splitting';
+    status: 'started' | 'completed';
+} | {
+    stage: 'tagging-structural';
+    status: 'started' | 'completed';
+} | {
+    stage: 'tagging-semantic';
+    status: 'started' | 'completed';
+} | {
+    stage: 'applying-effects';
+    status: 'started' | 'completed';
+} | {
+    stage: 'rendering';
+    inner: RenderProgress;
+};
+export type PipelineProgressListener = (event: PipelineProgressEvent) => void;
+//# sourceMappingURL=PipelineProgress.d.ts.map

package/dist/modules/pipeline/PipelineProgress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PipelineProgress.d.ts","sourceRoot":"","sources":["../../../src/modules/pipeline/PipelineProgress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,wBAAwB,CAAA;CAAE,GAC1D;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,WAAW,CAAA;CAAE,GACvD;IAAE,KAAK,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,WAAW,CAAA;CAAE,GAChE;IAAE,KAAK,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,WAAW,CAAA;CAAE,GAC9D;IAAE,KAAK,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,WAAW,CAAA;CAAE,GAC9D;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC;AAElD,MAAM,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC"}

package/dist/modules/pipeline/PipelineProgress.js

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

package/dist/modules/pipeline/PipelineProgress.js.map

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

package/dist/modules/pipeline/RenderPipeline.d.ts

@@ -0,0 +1,105 @@
+import type { Document } from '../document/Document';
+import type { Transcriber, TranscriberOptions } from '../transcription/Transcriber';
+import type { SegmentSplitter } from '../splitting/SegmentSplitter';
+import type { LineSplitter } from '../splitting/LineSplitter';
+import type { Tagger } from '../tagging/Tagger';
+import type { Effect } from '../effect/Effect';
+import type { SubtitleStyle } from '../rendering/SubtitleFrameRenderer';
+import type { VideoRenderer } from '../video/VideoRenderer';
+import type { RenderResult, OutputFormat, RenderQuality, RenderOutputChunk, AudioDiscardReason, FallbackDecoderInfo } from '../video/RenderJob';
+import type { PipelineProgressListener } from '../pipeline/PipelineProgress';
+/** Px resolution; either supplied up front or probed from the input video. */
+export interface OutputResolution {
+    readonly width: number;
+    readonly height: number;
+}
+/**
+ * Knobs that influence the lazily-built default line splitter. Honoured
+ * only when no explicit `LineSplitter` was supplied to the pipeline.
+ */
+export interface DefaultLineSplitterRuntimeConfig {
+    readonly maxLines: number;
+    readonly minLines: number;
+    readonly maxWidthRatio: number;
+}
+export interface RenderPipelineConfig {
+    readonly video: File | Blob;
+    readonly transcriber: Transcriber;
+    readonly transcriberOptions: TranscriberOptions | undefined;
+    readonly segmentSplitter: SegmentSplitter;
+    /** Explicit line splitter; when `null`, a default is built lazily once the resolved css and output dimensions are known. */
+    readonly lineSplitter: LineSplitter | null;
+    readonly defaultLineSplitterConfig: DefaultLineSplitterRuntimeConfig;
+    readonly structureTagger: Tagger;
+    readonly semanticTaggers: ReadonlyArray<Tagger>;
+    readonly effects: ReadonlyArray<Effect>;
+    /** Applied to every `Section.kind` found in the document unless `explicitStyles` is set. */
+    readonly defaultStyle: SubtitleStyle;
+    /** When set, takes over from `defaultStyle` and is passed as-is to the video renderer. */
+    readonly explicitStyles: Readonly<Record<string, SubtitleStyle>> | null;
+    readonly videoRenderer: VideoRenderer;
+    readonly outputFormat: OutputFormat | undefined;
+    readonly quality: RenderQuality | undefined;
+    readonly outputResolution: OutputResolution | undefined;
+    readonly outputStream: WritableStream<RenderOutputChunk> | undefined;
+    readonly overlayHtml: string | undefined;
+    readonly onAudioDiscarded: ((reason: AudioDiscardReason) => void) | undefined;
+    readonly confirmFallbackDecoder: ((info: FallbackDecoderInfo) => Promise<boolean>) | undefined;
+}
+/**
+ * Orchestrates the end-to-end render flow over the components supplied
+ * by `RenderPipelineBuilder`: transcribe → split → tag (structural and
+ * semantic) → apply effects → render. Each step is also exposed
+ * individually so callers can inspect or mutate the current `Document`
+ * between stages.
+ *
+ * The pipeline owns the current `Document`. After a step it stores the
+ * result and feeds it to the next step; `getDocument`/`setDocument`
+ * give callers a read/replace handle for that state. `run` short-
+ * circuits through every step in order; if a Document is already
+ * loaded (whether from a previous step or via `setDocument`), it skips
+ * the transcription step and starts from splitting.
+ *
+ * Instances are built by `RenderPipelineBuilder.build` — the builder
+ * is the supported construction surface.
+ */
+export declare class RenderPipeline {
+    private readonly config;
+    private currentDocument;
+    private cachedVideoDimensions;
+    private cachedVideoFile;
+    constructor(config: RenderPipelineConfig);
+    /** Current document state; `null` before transcription runs. */
+    getDocument(): Document | null;
+    /** Replaces the current document — typical after a manual edit between steps. */
+    setDocument(document: Document): void;
+    /**
+     * Runs every step in order and returns the final render result.
+     * Skips transcription when a document is already loaded.
+     */
+    run(onProgress?: PipelineProgressListener): Promise<RenderResult>;
+    runTranscriptionStep(onProgress?: PipelineProgressListener): Promise<Document>;
+    private restoreTranscriberProgressHandler;
+    runSplittingStep(onProgress?: PipelineProgressListener): Promise<Document>;
+    runStructuralTaggingStep(onProgress?: PipelineProgressListener): Document;
+    runSemanticTaggingStep(onProgress?: PipelineProgressListener): Promise<Document>;
+    runEffectsStep(onProgress?: PipelineProgressListener): Document;
+    runRenderingStep(onProgress?: PipelineProgressListener): Promise<RenderResult>;
+    private requireDocument;
+    private applySegmentSplitterToSections;
+    private applyLineSplittingToSections;
+    private resolveLineSplitter;
+    private buildDefaultLineSplitter;
+    private extractCssVariablesFromInlineStyles;
+    private resolveOutputDimensions;
+    private probeVideoNaturalDimensions;
+    private resolveStylesForDocument;
+    private buildRenderJob;
+    /**
+     * The video renderer's job expects a `File`. Inputs that arrive as a
+     * raw `Blob` are wrapped once and reused across runs so the same
+     * underlying bytes back every render call.
+     */
+    private resolveVideoAsFile;
+}
+//# sourceMappingURL=RenderPipeline.d.ts.map

package/dist/modules/pipeline/RenderPipeline.d.ts.map

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