@tscaps/engine 0.1.1

package/dist/modules/document/TimeFragment.js

@@ -0,0 +1,29 @@
+export class TimeFragment {
+    start;
+    end;
+    constructor(start, end) {
+        this.start = start;
+        this.end = end;
+    }
+    // Interval is half-open: [start, end).
+    // A word "contains" the current time only while start <= t < end.
+    // This ensures that at the exact shared boundary between two adjacent words
+    // (wordA.end === wordB.start), wordA is already ALREADY_NARRATED and wordB
+    // becomes BEING_NARRATED — never both at once.
+    contains(time) {
+        return time >= this.start && time < this.end;
+    }
+    isAfter(time) {
+        return time < this.start;
+    }
+    isBefore(time) {
+        return time >= this.end;
+    }
+    get duration() {
+        return this.end - this.start;
+    }
+    get midpoint() {
+        return (this.start + this.end) / 2;
+    }
+}
+//# sourceMappingURL=TimeFragment.js.map

package/dist/modules/document/TimeFragment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeFragment.js","sourceRoot":"","sources":["../../../src/modules/document/TimeFragment.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAY;IAEZ;IACA;IAFX,YACW,KAAa,EACb,GAAW;QADX,UAAK,GAAL,KAAK,CAAQ;QACb,QAAG,GAAH,GAAG,CAAQ;IACnB,CAAC;IAEJ,uCAAuC;IACvC,kEAAkE;IAClE,4EAA4E;IAC5E,2EAA2E;IAC3E,+CAA+C;IAC/C,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC;IAC/C,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;IAC3B,CAAC;IAED,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC;IAC1B,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC;IAC/B,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/modules/document/Word.d.ts

@@ -0,0 +1,40 @@
+import { TimeFragment } from '../document/TimeFragment';
+import { Tag } from '../document/Tag';
+import { WordState } from '../document/WordState';
+import type { Line } from '../document/Line';
+export interface WordProps<M = unknown> {
+    readonly text: string;
+    readonly time: TimeFragment;
+    readonly structureTags?: ReadonlySet<Tag> | undefined;
+    readonly semanticTags?: ReadonlySet<Tag> | undefined;
+    readonly id?: string | undefined;
+    readonly displayText?: string | undefined;
+    readonly speakerId?: string | null | undefined;
+    readonly metadata?: M | undefined;
+}
+export declare class Word<M = unknown> {
+    static readonly CSS_CLASS = "word";
+    readonly text: string;
+    readonly time: TimeFragment;
+    readonly structureTags: ReadonlySet<Tag>;
+    readonly semanticTags: ReadonlySet<Tag>;
+    readonly id: string;
+    readonly displayText: string;
+    readonly speakerId: string | null;
+    readonly metadata: M | undefined;
+    private _parent;
+    constructor(props: WordProps<M>);
+    getState(currentTime: number): WordState;
+    getCssClasses(currentTime: number): string[];
+    getCssVariables(currentTime: number): Record<string, string>;
+    getAllTags(): ReadonlySet<Tag>;
+    hasTag(tag: Tag): boolean;
+    hasTagName(name: string): boolean;
+    with(changes: Partial<WordProps<M>>): Word<M>;
+    withMetadata<N>(metadata: N): Word<N>;
+    setParent(line: Line): void;
+    getLine(): Line;
+    getSegment(): import("./Segment").Segment<unknown>;
+    getDocument(): import("./Document").Document<unknown>;
+}
+//# sourceMappingURL=Word.d.ts.map

package/dist/modules/document/Word.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Word.d.ts","sourceRoot":"","sources":["../../../src/modules/document/Word.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAExD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC;CACnC;AAED,qBAAa,IAAI,CAAC,CAAC,GAAG,OAAO;IAC3B,MAAM,CAAC,QAAQ,CAAC,SAAS,UAAU;IAEnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,SAAS,CAAC;IAEjC,OAAO,CAAC,OAAO,CAAqB;gBAExB,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IAY/B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS;IAMxC,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IAgB5C,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAoB5D,UAAU,IAAI,WAAW,CAAC,GAAG,CAAC;IAI9B,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO;IAIzB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAgB7C,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAerC,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAI3B,OAAO,IAAI,IAAI;IAKf,UAAU;IAIV,WAAW;CAGZ"}

package/dist/modules/document/Word.js

@@ -0,0 +1,114 @@
+import { Tag } from '../document/Tag';
+import { WordState } from '../document/WordState';
+import { CssVariable } from '../document/CssVariable';
+export class Word {
+    static CSS_CLASS = 'word';
+    text;
+    time;
+    structureTags;
+    semanticTags;
+    id;
+    displayText;
+    speakerId;
+    metadata;
+    _parent = null;
+    constructor(props) {
+        this.text = props.text;
+        this.time = props.time;
+        this.structureTags = props.structureTags ?? new Set();
+        this.semanticTags = props.semanticTags ?? new Set();
+        this.id = props.id ?? crypto.randomUUID();
+        this.displayText = props.displayText ?? props.text;
+        this.speakerId = props.speakerId ?? null;
+        this.metadata = props.metadata;
+    }
+    // Pure function — state is never stored, always computed
+    getState(currentTime) {
+        if (this.time.isAfter(currentTime))
+            return WordState.NOT_NARRATED_YET;
+        if (this.time.contains(currentTime))
+            return WordState.BEING_NARRATED;
+        return WordState.ALREADY_NARRATED;
+    }
+    getCssClasses(currentTime) {
+        const classes = [Word.CSS_CLASS];
+        classes.push(this.getState(currentTime));
+        for (const tag of this.structureTags) {
+            classes.push(tag.toCssClass());
+        }
+        for (const tag of this.semanticTags) {
+            classes.push(tag.toCssClass());
+        }
+        return classes;
+    }
+    getCssVariables(currentTime) {
+        const segStart = this.getSegment().time.start;
+        const segEnd = this.getSegment().time.end;
+        const wordStart = this.time.start;
+        const wordEnd = this.time.end;
+        return {
+            [CssVariable.WORD_NOT_NARRATED_YET_STARTS]: `${(segStart - currentTime).toFixed(3)}s`,
+            [CssVariable.WORD_NOT_NARRATED_YET_ENDS]: `${(wordStart - currentTime).toFixed(3)}s`,
+            [CssVariable.WORD_NOT_NARRATED_YET_DURATION]: `${(wordStart - segStart).toFixed(3)}s`,
+            [CssVariable.WORD_BEING_NARRATED_STARTS]: `${(wordStart - currentTime).toFixed(3)}s`,
+            [CssVariable.WORD_BEING_NARRATED_ENDS]: `${(wordEnd - currentTime).toFixed(3)}s`,
+            [CssVariable.WORD_BEING_NARRATED_DURATION]: `${(wordEnd - wordStart).toFixed(3)}s`,
+            [CssVariable.WORD_ALREADY_NARRATED_STARTS]: `${(wordEnd - currentTime).toFixed(3)}s`,
+            [CssVariable.WORD_ALREADY_NARRATED_ENDS]: `${(segEnd - currentTime).toFixed(3)}s`,
+            [CssVariable.WORD_ALREADY_NARRATED_DURATION]: `${(segEnd - wordEnd).toFixed(3)}s`,
+        };
+    }
+    getAllTags() {
+        return new Set([...this.structureTags, ...this.semanticTags]);
+    }
+    hasTag(tag) {
+        return this.structureTags.has(tag) || this.semanticTags.has(tag);
+    }
+    hasTagName(name) {
+        return this.hasTag(Tag.of(name));
+    }
+    with(changes) {
+        const word = new Word({
+            text: this.text,
+            time: this.time,
+            structureTags: this.structureTags,
+            semanticTags: this.semanticTags,
+            id: this.id,
+            displayText: this.displayText,
+            speakerId: this.speakerId,
+            metadata: this.metadata,
+            ...changes,
+        });
+        word._parent = this._parent;
+        return word;
+    }
+    withMetadata(metadata) {
+        const word = new Word({
+            text: this.text,
+            time: this.time,
+            structureTags: this.structureTags,
+            semanticTags: this.semanticTags,
+            id: this.id,
+            displayText: this.displayText,
+            speakerId: this.speakerId,
+            metadata,
+        });
+        word._parent = this._parent;
+        return word;
+    }
+    setParent(line) {
+        this._parent = line;
+    }
+    getLine() {
+        if (!this._parent)
+            throw new Error('Word has no parent Line');
+        return this._parent;
+    }
+    getSegment() {
+        return this.getLine().getSegment();
+    }
+    getDocument() {
+        return this.getLine().getDocument();
+    }
+}
+//# sourceMappingURL=Word.js.map

package/dist/modules/document/Word.js.map

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

package/dist/modules/document/WordState.d.ts

@@ -0,0 +1,6 @@
+export declare enum WordState {
+    NOT_NARRATED_YET = "word-not-narrated-yet",
+    BEING_NARRATED = "word-being-narrated",
+    ALREADY_NARRATED = "word-already-narrated"
+}
+//# sourceMappingURL=WordState.d.ts.map

package/dist/modules/document/WordState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WordState.d.ts","sourceRoot":"","sources":["../../../src/modules/document/WordState.ts"],"names":[],"mappings":"AAAA,oBAAY,SAAS;IACnB,gBAAgB,0BAA0B;IAC1C,cAAc,wBAAwB;IACtC,gBAAgB,0BAA0B;CAC3C"}

package/dist/modules/document/WordState.js

@@ -0,0 +1,7 @@
+export var WordState;
+(function (WordState) {
+    WordState["NOT_NARRATED_YET"] = "word-not-narrated-yet";
+    WordState["BEING_NARRATED"] = "word-being-narrated";
+    WordState["ALREADY_NARRATED"] = "word-already-narrated";
+})(WordState || (WordState = {}));
+//# sourceMappingURL=WordState.js.map

package/dist/modules/document/WordState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WordState.js","sourceRoot":"","sources":["../../../src/modules/document/WordState.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,SAIX;AAJD,WAAY,SAAS;IACnB,uDAA0C,CAAA;IAC1C,mDAAsC,CAAA;IACtC,uDAA0C,CAAA;AAC5C,CAAC,EAJW,SAAS,KAAT,SAAS,QAIpB"}

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

@@ -0,0 +1,14 @@
+export { Document } from '../document/Document';
+export { Section } from '../document/Section';
+export { Segment } from '../document/Segment';
+export { Line } from '../document/Line';
+export { Word } from '../document/Word';
+export { Letter } from '../document/Letter';
+export { TimeFragment } from '../document/TimeFragment';
+export { Tag, StructureTag } from '../document/Tag';
+export { WordState } from '../document/WordState';
+export { LineState } from '../document/LineState';
+export { CssVariable } from '../document/CssVariable';
+export { DocumentEditor } from '../document/DocumentEditor';
+export { NarrationPace } from '../document/NarrationPace';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/document/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/modules/document/index.js

@@ -0,0 +1,14 @@
+export { Document } from '../document/Document';
+export { Section } from '../document/Section';
+export { Segment } from '../document/Segment';
+export { Line } from '../document/Line';
+export { Word } from '../document/Word';
+export { Letter } from '../document/Letter';
+export { TimeFragment } from '../document/TimeFragment';
+export { Tag, StructureTag } from '../document/Tag';
+export { WordState } from '../document/WordState';
+export { LineState } from '../document/LineState';
+export { CssVariable } from '../document/CssVariable';
+export { DocumentEditor } from '../document/DocumentEditor';
+export { NarrationPace } from '../document/NarrationPace';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/document/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC"}

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

@@ -0,0 +1,47 @@
+import type { Effect } from '../effect/Effect';
+import type { Document } from '../document/Document';
+import type { Segment } from '../document/Segment';
+/**
+ * Repeats the surrounding quotes on every segment of a long quotation
+ * that the splitter has broken across boundaries. The opening quote
+ * gets prepended to each segment that starts already inside the quote,
+ * and the closing quote gets appended to each segment that ends still
+ * inside it. A viewer reading one segment at a time keeps the
+ * quotation cue visible across the whole span.
+ *
+ * Only fires when the quoted run:
+ *   - crosses two or more segments, AND
+ *   - contains at least one sentence-terminating mark (`.`, `?`, `!`, `…`).
+ *
+ * Short mid-sentence quotes (e.g. he said "yes" today) are left alone.
+ *
+ * Quote boundaries are detected directly from `word.text` — no
+ * dependency on any tagger. Supports straight (`"` / `"`), curly
+ * (`“` / `”`), and angled (`«` / `»`) pairs; the added quotes mirror
+ * the pair the original quotation used.
+ */
+export declare class CarryQuotesEffect implements Effect {
+    private readonly segmentFilter;
+    private static readonly QUOTE_PAIRS;
+    private static readonly SENTENCE_TERMINATORS;
+    constructor(segmentFilter?: (segment: Segment) => boolean);
+    apply(document: Document): Document;
+    private collectEdits;
+    private collectQuoteRuns;
+    private flattenWords;
+    private openingCharOf;
+    private closingCharFor;
+    private endsWithCloseOf;
+    private qualifiesForCarrying;
+    private runCrossesMultipleSegments;
+    private runContainsSentenceTerminator;
+    private scheduleEditsForRun;
+    private groupWordsBySegment;
+    private schedulePrepend;
+    private scheduleAppend;
+    private rebuildWithEdits;
+    private rebuildSegment;
+    private rebuildLine;
+    private applyEditTo;
+}
+//# sourceMappingURL=CarryQuotesEffect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CarryQuotesEffect.d.ts","sourceRoot":"","sources":["../../../src/modules/effect/CarryQuotesEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAezD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,iBAAkB,YAAW,MAAM;IAW5C,OAAO,CAAC,QAAQ,CAAC,aAAa;IAThC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAIhC;IAEH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAY;gBAGrC,aAAa,GAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAoB;IAG5E,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;IAMnC,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,gBAAgB;IA2BxB,OAAO,CAAE,YAAY;IAUrB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,0BAA0B;IAQlC,OAAO,CAAC,6BAA6B;IAOrC,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,WAAW;CAQpB"}

package/dist/modules/effect/CarryQuotesEffect.js

@@ -0,0 +1,181 @@
+/**
+ * Repeats the surrounding quotes on every segment of a long quotation
+ * that the splitter has broken across boundaries. The opening quote
+ * gets prepended to each segment that starts already inside the quote,
+ * and the closing quote gets appended to each segment that ends still
+ * inside it. A viewer reading one segment at a time keeps the
+ * quotation cue visible across the whole span.
+ *
+ * Only fires when the quoted run:
+ *   - crosses two or more segments, AND
+ *   - contains at least one sentence-terminating mark (`.`, `?`, `!`, `…`).
+ *
+ * Short mid-sentence quotes (e.g. he said "yes" today) are left alone.
+ *
+ * Quote boundaries are detected directly from `word.text` — no
+ * dependency on any tagger. Supports straight (`"` / `"`), curly
+ * (`“` / `”`), and angled (`«` / `»`) pairs; the added quotes mirror
+ * the pair the original quotation used.
+ */
+export class CarryQuotesEffect {
+    segmentFilter;
+    static QUOTE_PAIRS = new Map([
+        ['"', '"'],
+        ['“', '”'],
+        ['«', '»'],
+    ]);
+    static SENTENCE_TERMINATORS = /[.?!…]/;
+    constructor(segmentFilter = () => true) {
+        this.segmentFilter = segmentFilter;
+    }
+    apply(document) {
+        const edits = this.collectEdits(document);
+        if (edits.size === 0)
+            return document;
+        return this.rebuildWithEdits(document, edits);
+    }
+    collectEdits(document) {
+        const edits = new Map();
+        for (const section of document.sections) {
+            for (const run of this.collectQuoteRuns(section)) {
+                if (!this.qualifiesForCarrying(run))
+                    continue;
+                this.scheduleEditsForRun(run, edits);
+            }
+        }
+        return edits;
+    }
+    collectQuoteRuns(section) {
+        const runs = [];
+        let openWords = [];
+        let openingChar = null;
+        for (const word of this.flattenWords(section)) {
+            if (openingChar === null) {
+                const opener = this.openingCharOf(word.text);
+                if (opener === null)
+                    continue;
+                openWords = [word];
+                openingChar = opener;
+                if (this.endsWithCloseOf(word.text, opener)) {
+                    runs.push({ words: openWords, openingChar, closingChar: this.closingCharFor(opener) });
+                    openWords = [];
+                    openingChar = null;
+                }
+                continue;
+            }
+            openWords.push(word);
+            if (this.endsWithCloseOf(word.text, openingChar)) {
+                runs.push({ words: openWords, openingChar, closingChar: this.closingCharFor(openingChar) });
+                openWords = [];
+                openingChar = null;
+            }
+        }
+        return runs;
+    }
+    *flattenWords(section) {
+        for (const segment of section.segments) {
+            for (const line of segment.lines) {
+                for (const word of line.words) {
+                    yield word;
+                }
+            }
+        }
+    }
+    openingCharOf(text) {
+        const first = text[0];
+        if (first !== undefined && CarryQuotesEffect.QUOTE_PAIRS.has(first))
+            return first;
+        return null;
+    }
+    closingCharFor(openingChar) {
+        return CarryQuotesEffect.QUOTE_PAIRS.get(openingChar);
+    }
+    endsWithCloseOf(text, openingChar) {
+        return text.endsWith(this.closingCharFor(openingChar));
+    }
+    qualifiesForCarrying(run) {
+        return this.runCrossesMultipleSegments(run) && this.runContainsSentenceTerminator(run);
+    }
+    runCrossesMultipleSegments(run) {
+        const firstSegmentId = run.words[0].getSegment().id;
+        for (const word of run.words) {
+            if (word.getSegment().id !== firstSegmentId)
+                return true;
+        }
+        return false;
+    }
+    runContainsSentenceTerminator(run) {
+        for (const word of run.words) {
+            if (CarryQuotesEffect.SENTENCE_TERMINATORS.test(word.text))
+                return true;
+        }
+        return false;
+    }
+    scheduleEditsForRun(run, edits) {
+        const segments = this.groupWordsBySegment(run.words);
+        let index = 0;
+        for (const words of segments.values()) {
+            const isFirst = index === 0;
+            const isLast = index === segments.size - 1;
+            if (!isFirst)
+                this.schedulePrepend(words[0].id, run.openingChar, edits);
+            if (!isLast)
+                this.scheduleAppend(words[words.length - 1].id, run.closingChar, edits);
+            index++;
+        }
+    }
+    groupWordsBySegment(words) {
+        const groups = new Map();
+        for (const word of words) {
+            const segmentId = word.getSegment().id;
+            const list = groups.get(segmentId);
+            if (list) {
+                list.push(word);
+            }
+            else {
+                groups.set(segmentId, [word]);
+            }
+        }
+        return groups;
+    }
+    schedulePrepend(wordId, char, edits) {
+        const edit = edits.get(wordId) ?? {};
+        edit.prepend = char;
+        edits.set(wordId, edit);
+    }
+    scheduleAppend(wordId, char, edits) {
+        const edit = edits.get(wordId) ?? {};
+        edit.append = char;
+        edits.set(wordId, edit);
+    }
+    rebuildWithEdits(document, edits) {
+        return document.with({
+            sections: document.sections.map((section) => section.with({
+                segments: section.segments.map((segment) => this.rebuildSegment(segment, edits)),
+            })),
+        });
+    }
+    rebuildSegment(segment, edits) {
+        if (!this.segmentFilter(segment))
+            return segment;
+        return segment.with({
+            lines: segment.lines.map((line) => this.rebuildLine(line, edits)),
+        });
+    }
+    rebuildLine(line, edits) {
+        return line.with({
+            words: line.words.map((word) => this.applyEditTo(word, edits)),
+        });
+    }
+    applyEditTo(word, edits) {
+        const edit = edits.get(word.id);
+        if (!edit)
+            return word;
+        const prepend = edit.prepend ?? '';
+        const append = edit.append ?? '';
+        if (prepend === '' && append === '')
+            return word;
+        return word.with({ displayText: prepend + word.displayText + append });
+    }
+}
+//# sourceMappingURL=CarryQuotesEffect.js.map

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

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

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

@@ -0,0 +1,16 @@
+import type { Document } from '../document/Document';
+/**
+ * A document-transforming pipeline stage. Effects are pure and
+ * self-contained: each takes the current Document and returns a new one
+ * with its transformation applied. They run after the splitter/tagger
+ * stages, so they see the final structure of segments, lines, and words.
+ *
+ * Implementations are configured via constructor parameters; the engine
+ * holds no notion of how those parameters might be serialized or surfaced
+ * in a UI — that translation lives in the consumer (e.g. a web app's
+ * registry of descriptors).
+ */
+export interface Effect {
+    apply(document: Document): Document;
+}
+//# sourceMappingURL=Effect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Effect.d.ts","sourceRoot":"","sources":["../../../src/modules/effect/Effect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAE3D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC;CACrC"}

package/dist/modules/effect/Effect.js

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

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

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

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

@@ -0,0 +1,24 @@
+import type { Effect } from '../effect/Effect';
+import { Document } from '../document/Document';
+import { Segment } from '../document/Segment';
+/**
+ * Extends each matching segment's end time so it does not snap shut at its
+ * last word. When the next matching segment begins within `maxGapMs` the
+ * segment is stretched all the way to that boundary, eliminating the
+ * micro-gap. When the gap is larger (or there is no next segment at all)
+ * the segment is still padded by `maxGapMs` so its tail does not feel
+ * abrupt — for the final segment that extension is clamped to
+ * `videoDurationSeconds` so it never spills past the end of the video.
+ * `segmentFilter` scopes which segments get extended; non-matching
+ * segments are still treated as barriers when looking for the next
+ * boundary.
+ */
+export declare class GapFreeEffect implements Effect {
+    private readonly segmentFilter;
+    private readonly maxGapMs;
+    private readonly videoDurationSeconds;
+    constructor(segmentFilter?: (segment: Segment) => boolean, maxGapMs?: number, videoDurationSeconds?: number);
+    apply(document: Document): Document;
+    private computeNewEnd;
+}
+//# sourceMappingURL=GapFreeEffect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GapFreeEffect.d.ts","sourceRoot":"","sources":["../../../src/modules/effect/GapFreeEffect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAGpD;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,YAAW,MAAM;IAExC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,oBAAoB;gBAFpB,aAAa,GAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAoB,EACzD,QAAQ,GAAE,MAAa,EACvB,oBAAoB,GAAE,MAAiB;IAG1D,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;IAgCnC,OAAO,CAAC,aAAa;CAWtB"}

package/dist/modules/effect/GapFreeEffect.js

@@ -0,0 +1,67 @@
+import { TimeFragment } from '../document/TimeFragment';
+/**
+ * Extends each matching segment's end time so it does not snap shut at its
+ * last word. When the next matching segment begins within `maxGapMs` the
+ * segment is stretched all the way to that boundary, eliminating the
+ * micro-gap. When the gap is larger (or there is no next segment at all)
+ * the segment is still padded by `maxGapMs` so its tail does not feel
+ * abrupt — for the final segment that extension is clamped to
+ * `videoDurationSeconds` so it never spills past the end of the video.
+ * `segmentFilter` scopes which segments get extended; non-matching
+ * segments are still treated as barriers when looking for the next
+ * boundary.
+ */
+export class GapFreeEffect {
+    segmentFilter;
+    maxGapMs;
+    videoDurationSeconds;
+    constructor(segmentFilter = () => true, maxGapMs = 1000, videoDurationSeconds = Infinity) {
+        this.segmentFilter = segmentFilter;
+        this.maxGapMs = maxGapMs;
+        this.videoDurationSeconds = videoDurationSeconds;
+    }
+    apply(document) {
+        // Document/array order is not guaranteed to match time order
+        // (sections group segments independently of when they play, and
+        // manual time edits can reshuffle within a section), so we sort
+        // by start time first. The "next" segment is then literally the
+        // next one in temporal order. `segmentFilter` only decides which
+        // segments we *extend*; every segment still counts as a barrier
+        // because we take the immediate neighbor.
+        const ordered = document.getSegments()
+            .slice()
+            .sort((a, b) => a.time.start - b.time.start || a.time.end - b.time.end);
+        const replacements = new Map();
+        const maxGapSeconds = this.maxGapMs / 1000;
+        for (let i = 0; i < ordered.length; i++) {
+            const seg = ordered[i];
+            if (!this.segmentFilter(seg))
+                continue;
+            const next = ordered[i + 1];
+            const newEnd = this.computeNewEnd(seg.time.end, next?.time.start, maxGapSeconds);
+            if (newEnd === null)
+                continue;
+            replacements.set(seg.id, seg.with({ customTime: new TimeFragment(seg.time.start, newEnd) }));
+        }
+        if (replacements.size === 0)
+            return document;
+        const newSections = document.sections.map((section) => {
+            const newSegments = section.segments.map((seg) => replacements.get(seg.id) ?? seg);
+            return section.with({ segments: newSegments });
+        });
+        return document.with({ sections: newSections });
+    }
+    computeNewEnd(segEnd, nextStart, maxGapSeconds) {
+        if (nextStart !== undefined) {
+            const gap = nextStart - segEnd;
+            if (gap <= 0)
+                return null;
+            return gap <= maxGapSeconds ? nextStart : segEnd + maxGapSeconds;
+        }
+        // No next segment — pad by maxGap but never past the end of the video.
+        const padded = segEnd + maxGapSeconds;
+        const capped = Math.min(padded, this.videoDurationSeconds);
+        return capped > segEnd ? capped : null;
+    }
+}
+//# sourceMappingURL=GapFreeEffect.js.map

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

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