@tscaps/engine 0.1.1

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

@@ -0,0 +1,31 @@
+import { TimeFragment } from '../document/TimeFragment';
+import { Tag } from '../document/Tag';
+import { LineState } from '../document/LineState';
+import { Word } from '../document/Word';
+import type { Segment } from '../document/Segment';
+export interface LineProps<M = unknown> {
+    readonly words: ReadonlyArray<Word>;
+    readonly structureTags?: ReadonlySet<Tag> | undefined;
+    readonly id?: string | undefined;
+    readonly metadata?: M | undefined;
+}
+export declare class Line<M = unknown> {
+    static readonly CSS_CLASS = "line";
+    readonly words: ReadonlyArray<Word>;
+    readonly structureTags: ReadonlySet<Tag>;
+    readonly id: string;
+    readonly metadata: M | undefined;
+    private _parent;
+    constructor(props: LineProps<M>);
+    get time(): TimeFragment;
+    getState(currentTime: number): LineState;
+    getCssClasses(currentTime: number): string[];
+    getCssVariables(currentTime: number): Record<string, string>;
+    getText(): string;
+    with(changes: Partial<LineProps<M>>): Line<M>;
+    withMetadata<N>(metadata: N): Line<N>;
+    setParent(segment: Segment): void;
+    getSegment(): Segment;
+    getDocument(): import("./Document").Document<unknown>;
+}
+//# sourceMappingURL=Line.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Line.d.ts","sourceRoot":"","sources":["../../../src/modules/document/Line.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,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEzD,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO;IACpC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,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,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,SAAS,CAAC;IAEjC,OAAO,CAAC,OAAO,CAAwB;gBAE3B,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IAU/B,IAAI,IAAI,IAAI,YAAY,CAKvB;IAED,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS;IAMxC,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IAQ5C,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAoB5D,OAAO,IAAI,MAAM;IAIjB,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAY7C,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAWrC,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIjC,UAAU,IAAI,OAAO;IAKrB,WAAW;CAGZ"}

package/dist/modules/document/Line.js

@@ -0,0 +1,94 @@
+import { TimeFragment } from '../document/TimeFragment';
+import { LineState } from '../document/LineState';
+import { CssVariable } from '../document/CssVariable';
+export class Line {
+    static CSS_CLASS = 'line';
+    words;
+    structureTags;
+    id;
+    metadata;
+    _parent = null;
+    constructor(props) {
+        this.words = props.words;
+        this.structureTags = props.structureTags ?? new Set();
+        this.id = props.id ?? crypto.randomUUID();
+        this.metadata = props.metadata;
+        for (const word of this.words) {
+            word.setParent(this);
+        }
+    }
+    get time() {
+        const first = this.words[0];
+        const last = this.words[this.words.length - 1];
+        if (!first || !last)
+            throw new Error('Line has no words');
+        return new TimeFragment(first.time.start, last.time.end);
+    }
+    getState(currentTime) {
+        if (this.time.isAfter(currentTime))
+            return LineState.NOT_NARRATED_YET;
+        if (this.time.contains(currentTime))
+            return LineState.BEING_NARRATED;
+        return LineState.ALREADY_NARRATED;
+    }
+    getCssClasses(currentTime) {
+        const classes = [Line.CSS_CLASS, this.getState(currentTime)];
+        for (const tag of this.structureTags) {
+            classes.push(tag.toCssClass());
+        }
+        return classes;
+    }
+    getCssVariables(currentTime) {
+        const segStart = this.getSegment().time.start;
+        const segEnd = this.getSegment().time.end;
+        const lineStart = this.time.start;
+        const lineEnd = this.time.end;
+        return {
+            [CssVariable.LINE_NOT_NARRATED_YET_STARTS]: `${(segStart - currentTime).toFixed(3)}s`,
+            [CssVariable.LINE_NOT_NARRATED_YET_ENDS]: `${(lineStart - currentTime).toFixed(3)}s`,
+            [CssVariable.LINE_NOT_NARRATED_YET_DURATION]: `${(lineStart - segStart).toFixed(3)}s`,
+            [CssVariable.LINE_BEING_NARRATED_STARTS]: `${(lineStart - currentTime).toFixed(3)}s`,
+            [CssVariable.LINE_BEING_NARRATED_ENDS]: `${(lineEnd - currentTime).toFixed(3)}s`,
+            [CssVariable.LINE_BEING_NARRATED_DURATION]: `${(lineEnd - lineStart).toFixed(3)}s`,
+            [CssVariable.LINE_ALREADY_NARRATED_STARTS]: `${(lineEnd - currentTime).toFixed(3)}s`,
+            [CssVariable.LINE_ALREADY_NARRATED_ENDS]: `${(segEnd - currentTime).toFixed(3)}s`,
+            [CssVariable.LINE_ALREADY_NARRATED_DURATION]: `${(segEnd - lineEnd).toFixed(3)}s`,
+        };
+    }
+    getText() {
+        return this.words.map((w) => w.text).join(' ');
+    }
+    with(changes) {
+        const line = new Line({
+            words: this.words,
+            structureTags: this.structureTags,
+            id: this.id,
+            metadata: this.metadata,
+            ...changes,
+        });
+        line._parent = this._parent;
+        return line;
+    }
+    withMetadata(metadata) {
+        const line = new Line({
+            words: this.words,
+            structureTags: this.structureTags,
+            id: this.id,
+            metadata,
+        });
+        line._parent = this._parent;
+        return line;
+    }
+    setParent(segment) {
+        this._parent = segment;
+    }
+    getSegment() {
+        if (!this._parent)
+            throw new Error('Line has no parent Segment');
+        return this._parent;
+    }
+    getDocument() {
+        return this.getSegment().getDocument();
+    }
+}
+//# sourceMappingURL=Line.js.map

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

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

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

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

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

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

package/dist/modules/document/LineState.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"LineState.js","sourceRoot":"","sources":["../../../src/modules/document/LineState.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/NarrationPace.d.ts

@@ -0,0 +1,20 @@
+import type { Word } from '../document/Word';
+/**
+ * Per-speaker narration speed in chars-per-second, sampled from the
+ * source words. `charsPerSecond` returns the speaker-specific rate when
+ * known, the mean across speakers otherwise, and a conservative default
+ * when the pace was never captured.
+ */
+export declare class NarrationPace {
+    static readonly DEFAULT_CHARS_PER_SECOND = 15;
+    private readonly _bySpeaker;
+    private readonly _mean;
+    constructor(bySpeaker: ReadonlyMap<string, number>);
+    static empty(): NarrationPace;
+    static fromWords(words: ReadonlyArray<Word>): NarrationPace;
+    charsPerSecond(speakerId: string | null): number;
+    isEmpty(): boolean;
+    toRecord(): Record<string, number>;
+    static fromRecord(record: Record<string, number>): NarrationPace;
+}
+//# sourceMappingURL=NarrationPace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NarrationPace.d.ts","sourceRoot":"","sources":["../../../src/modules/document/NarrationPace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAEnD;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,wBAAwB,MAAM;IAE9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;gBAE1B,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;IAalD,MAAM,CAAC,KAAK,IAAI,aAAa;IAI7B,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,aAAa;IAkB3D,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM;IAMhD,OAAO,IAAI,OAAO;IAIlB,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAIlC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa;CAGjE"}

package/dist/modules/document/NarrationPace.js

@@ -0,0 +1,60 @@
+/**
+ * Per-speaker narration speed in chars-per-second, sampled from the
+ * source words. `charsPerSecond` returns the speaker-specific rate when
+ * known, the mean across speakers otherwise, and a conservative default
+ * when the pace was never captured.
+ */
+export class NarrationPace {
+    static DEFAULT_CHARS_PER_SECOND = 15;
+    _bySpeaker;
+    _mean;
+    constructor(bySpeaker) {
+        this._bySpeaker = bySpeaker;
+        let sum = 0;
+        let count = 0;
+        for (const value of bySpeaker.values()) {
+            if (value > 0) {
+                sum += value;
+                count++;
+            }
+        }
+        this._mean = count > 0 ? sum / count : null;
+    }
+    static empty() {
+        return new NarrationPace(new Map());
+    }
+    static fromWords(words) {
+        const totals = new Map();
+        for (const word of words) {
+            const duration = word.time.end - word.time.start;
+            if (duration <= 0 || word.text.length === 0)
+                continue;
+            const key = word.speakerId ?? '';
+            const acc = totals.get(key) ?? { chars: 0, seconds: 0 };
+            acc.chars += word.text.length;
+            acc.seconds += duration;
+            totals.set(key, acc);
+        }
+        const rates = new Map();
+        for (const [key, { chars, seconds }] of totals) {
+            rates.set(key, chars / seconds);
+        }
+        return new NarrationPace(rates);
+    }
+    charsPerSecond(speakerId) {
+        const direct = this._bySpeaker.get(speakerId ?? '');
+        if (direct !== undefined && direct > 0)
+            return direct;
+        return this._mean ?? NarrationPace.DEFAULT_CHARS_PER_SECOND;
+    }
+    isEmpty() {
+        return this._bySpeaker.size === 0;
+    }
+    toRecord() {
+        return Object.fromEntries(this._bySpeaker);
+    }
+    static fromRecord(record) {
+        return new NarrationPace(new Map(Object.entries(record)));
+    }
+}
+//# sourceMappingURL=NarrationPace.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NarrationPace.js","sourceRoot":"","sources":["../../../src/modules/document/NarrationPace.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IACxB,MAAM,CAAU,wBAAwB,GAAG,EAAE,CAAC;IAE7B,UAAU,CAA8B;IACxC,KAAK,CAAgB;IAEtC,YAAY,SAAsC;QAChD,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACd,GAAG,IAAI,KAAK,CAAC;gBACb,KAAK,EAAE,CAAC;YACV,CAAC;QACH,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,KAAK;QACV,OAAO,IAAI,aAAa,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,KAA0B;QACzC,MAAM,MAAM,GAAG,IAAI,GAAG,EAA8C,CAAC;QACrE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YACjD,IAAI,QAAQ,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YACtD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;YACjC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;YACxD,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;YAC9B,GAAG,CAAC,OAAO,IAAI,QAAQ,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACvB,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;QACxC,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC;YAC/C,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,cAAc,CAAC,SAAwB;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QACpD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,GAAG,CAAC;YAAE,OAAO,MAAM,CAAC;QACtD,OAAO,IAAI,CAAC,KAAK,IAAI,aAAa,CAAC,wBAAwB,CAAC;IAC9D,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,QAAQ;QACN,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,MAA8B;QAC9C,OAAO,IAAI,aAAa,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC"}

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

@@ -0,0 +1,45 @@
+import { TimeFragment } from '../document/TimeFragment';
+import { Tag } from '../document/Tag';
+import { Segment } from '../document/Segment';
+import { Line } from '../document/Line';
+import { Word } from '../document/Word';
+import type { Document } from '../document/Document';
+export interface SectionProps<M = unknown> {
+    readonly segments: ReadonlyArray<Segment>;
+    readonly kind: string;
+    readonly structureTags?: ReadonlySet<Tag> | undefined;
+    readonly id?: string | undefined;
+    readonly metadata?: M | undefined;
+}
+/**
+ * A Section is a contiguous run of Segments inside a Document. It is the unit
+ * at which the structural pipeline (segment/line splitters, taggers) is
+ * intended to operate: each Section can carry an independent layout rationale.
+ *
+ * Sits between Document and Segment in the hierarchy. Identity is unique
+ * (`id`); a separate opaque `kind` is the grouping discriminator —
+ * adjacent Sections that share `kind` are kept merged into one. Consumers
+ * give `kind` whatever semantics they need (e.g., styling lookup); the
+ * engine treats it as an opaque string.
+ */
+export declare class Section<M = unknown> {
+    static readonly CSS_CLASS = "section";
+    readonly segments: ReadonlyArray<Segment>;
+    readonly kind: string;
+    readonly structureTags: ReadonlySet<Tag>;
+    readonly id: string;
+    readonly metadata: M | undefined;
+    private _parent;
+    constructor(props: SectionProps<M>);
+    get time(): TimeFragment;
+    getCssClasses(_currentTime: number): string[];
+    getCssVariables(currentTime: number): Record<string, string>;
+    getWords(): Word[];
+    getLines(): Line[];
+    getText(): string;
+    with(changes: Partial<SectionProps<M>>): Section<M>;
+    withMetadata<N>(metadata: N): Section<N>;
+    setParent(document: Document): void;
+    getDocument(): Document;
+}
+//# sourceMappingURL=Section.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Section.d.ts","sourceRoot":"","sources":["../../../src/modules/document/Section.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAE5C,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,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAE3D,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,CAAC,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC;CACnC;AAED;;;;;;;;;;GAUG;AACH,qBAAa,OAAO,CAAC,CAAC,GAAG,OAAO;IAC9B,MAAM,CAAC,QAAQ,CAAC,SAAS,aAAa;IAEtC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,SAAS,CAAC;IAEjC,OAAO,CAAC,OAAO,CAAyB;gBAE5B,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC;IAWlC,IAAI,IAAI,IAAI,YAAY,CAKvB;IAED,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE;IAQ7C,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAQ5D,QAAQ,IAAI,IAAI,EAAE;IAIlB,QAAQ,IAAI,IAAI,EAAE;IAIlB,OAAO,IAAI,MAAM;IAIjB,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAanD,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAYxC,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAInC,WAAW,IAAI,QAAQ;CAIxB"}

package/dist/modules/document/Section.js

@@ -0,0 +1,94 @@
+import { TimeFragment } from '../document/TimeFragment';
+import { CssVariable } from '../document/CssVariable';
+/**
+ * A Section is a contiguous run of Segments inside a Document. It is the unit
+ * at which the structural pipeline (segment/line splitters, taggers) is
+ * intended to operate: each Section can carry an independent layout rationale.
+ *
+ * Sits between Document and Segment in the hierarchy. Identity is unique
+ * (`id`); a separate opaque `kind` is the grouping discriminator —
+ * adjacent Sections that share `kind` are kept merged into one. Consumers
+ * give `kind` whatever semantics they need (e.g., styling lookup); the
+ * engine treats it as an opaque string.
+ */
+export class Section {
+    static CSS_CLASS = 'section';
+    segments;
+    kind;
+    structureTags;
+    id;
+    metadata;
+    _parent = null;
+    constructor(props) {
+        this.segments = props.segments;
+        this.kind = props.kind;
+        this.structureTags = props.structureTags ?? new Set();
+        this.id = props.id ?? crypto.randomUUID();
+        this.metadata = props.metadata;
+        for (const segment of this.segments) {
+            segment.setParent(this);
+        }
+    }
+    get time() {
+        const first = this.segments[0];
+        const last = this.segments[this.segments.length - 1];
+        if (!first || !last)
+            throw new Error('Section has no segments');
+        return new TimeFragment(first.time.start, last.time.end);
+    }
+    getCssClasses(_currentTime) {
+        const classes = [Section.CSS_CLASS];
+        for (const tag of this.structureTags) {
+            classes.push(tag.toCssClass());
+        }
+        return classes;
+    }
+    getCssVariables(currentTime) {
+        return {
+            [CssVariable.SECTION_STARTS]: `${(this.time.start - currentTime).toFixed(3)}s`,
+            [CssVariable.SECTION_ENDS]: `${(this.time.end - currentTime).toFixed(3)}s`,
+            [CssVariable.SECTION_DURATION]: `${(this.time.end - this.time.start).toFixed(3)}s`,
+        };
+    }
+    getWords() {
+        return this.segments.flatMap((segment) => segment.getWords());
+    }
+    getLines() {
+        return this.segments.flatMap((segment) => [...segment.lines]);
+    }
+    getText() {
+        return this.segments.map((segment) => segment.getText()).join(' ');
+    }
+    with(changes) {
+        const section = new Section({
+            segments: this.segments,
+            kind: this.kind,
+            structureTags: this.structureTags,
+            id: this.id,
+            metadata: this.metadata,
+            ...changes,
+        });
+        section._parent = this._parent;
+        return section;
+    }
+    withMetadata(metadata) {
+        const section = new Section({
+            segments: this.segments,
+            kind: this.kind,
+            structureTags: this.structureTags,
+            id: this.id,
+            metadata,
+        });
+        section._parent = this._parent;
+        return section;
+    }
+    setParent(document) {
+        this._parent = document;
+    }
+    getDocument() {
+        if (!this._parent)
+            throw new Error('Section has no parent Document');
+        return this._parent;
+    }
+}
+//# sourceMappingURL=Section.js.map

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

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

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

@@ -0,0 +1,40 @@
+import { TimeFragment } from '../document/TimeFragment';
+import { Tag } from '../document/Tag';
+import { Line } from '../document/Line';
+import { Word } from '../document/Word';
+import type { Section } from '../document/Section';
+import type { Document } from '../document/Document';
+export interface SegmentProps<M = unknown> {
+    readonly lines: ReadonlyArray<Line>;
+    readonly structureTags?: ReadonlySet<Tag> | undefined;
+    readonly id?: string | undefined;
+    /**
+     * Optional explicit time. When present, `time` returns this verbatim;
+     * otherwise `time` is derived from the segment's words. Lets a caller
+     * decouple the segment's time window from its word boundaries (e.g.
+     * to hold a segment on screen past its narration end).
+     */
+    readonly customTime?: TimeFragment | null | undefined;
+    readonly metadata?: M | undefined;
+}
+export declare class Segment<M = unknown> {
+    static readonly CSS_CLASS = "segment";
+    readonly lines: ReadonlyArray<Line>;
+    readonly structureTags: ReadonlySet<Tag>;
+    readonly id: string;
+    readonly customTime: TimeFragment | null;
+    readonly metadata: M | undefined;
+    private _parent;
+    constructor(props: SegmentProps<M>);
+    get time(): TimeFragment;
+    getCssClasses(_currentTime: number): string[];
+    getCssVariables(currentTime: number): Record<string, string>;
+    getWords(): Word[];
+    getText(): string;
+    with(changes: Partial<SegmentProps<M>>): Segment<M>;
+    withMetadata<N>(metadata: N): Segment<N>;
+    setParent(section: Section): void;
+    getSection(): Section;
+    getDocument(): Document;
+}
+//# sourceMappingURL=Segment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Segment.d.ts","sourceRoot":"","sources":["../../../src/modules/document/Segment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAE5C,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAE3D,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC;CACnC;AAED,qBAAa,OAAO,CAAC,CAAC,GAAG,OAAO;IAC9B,MAAM,CAAC,QAAQ,CAAC,SAAS,aAAa;IAEtC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,YAAY,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,SAAS,CAAC;IAEjC,OAAO,CAAC,OAAO,CAAwB;gBAE3B,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC;IAWlC,IAAI,IAAI,IAAI,YAAY,CAMvB;IAED,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE;IAQ7C,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAQ5D,QAAQ,IAAI,IAAI,EAAE;IAIlB,OAAO,IAAI,MAAM;IAIjB,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAanD,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAYxC,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIjC,UAAU,IAAI,OAAO;IAKrB,WAAW,IAAI,QAAQ;CAGxB"}

package/dist/modules/document/Segment.js

@@ -0,0 +1,85 @@
+import { TimeFragment } from '../document/TimeFragment';
+import { CssVariable } from '../document/CssVariable';
+export class Segment {
+    static CSS_CLASS = 'segment';
+    lines;
+    structureTags;
+    id;
+    customTime;
+    metadata;
+    _parent = null;
+    constructor(props) {
+        this.lines = props.lines;
+        this.structureTags = props.structureTags ?? new Set();
+        this.id = props.id ?? crypto.randomUUID();
+        this.customTime = props.customTime ?? null;
+        this.metadata = props.metadata;
+        for (const line of this.lines) {
+            line.setParent(this);
+        }
+    }
+    get time() {
+        if (this.customTime)
+            return this.customTime;
+        const first = this.lines[0];
+        const last = this.lines[this.lines.length - 1];
+        if (!first || !last)
+            throw new Error('Segment has no lines');
+        return new TimeFragment(first.time.start, last.time.end);
+    }
+    getCssClasses(_currentTime) {
+        const classes = [Segment.CSS_CLASS];
+        for (const tag of this.structureTags) {
+            classes.push(tag.toCssClass());
+        }
+        return classes;
+    }
+    getCssVariables(currentTime) {
+        return {
+            [CssVariable.SEGMENT_STARTS]: `${(this.time.start - currentTime).toFixed(3)}s`,
+            [CssVariable.SEGMENT_ENDS]: `${(this.time.end - currentTime).toFixed(3)}s`,
+            [CssVariable.SEGMENT_DURATION]: `${(this.time.end - this.time.start).toFixed(3)}s`,
+        };
+    }
+    getWords() {
+        return this.lines.flatMap((line) => [...line.words]);
+    }
+    getText() {
+        return this.lines.map((line) => line.getText()).join(' ');
+    }
+    with(changes) {
+        const segment = new Segment({
+            lines: this.lines,
+            structureTags: this.structureTags,
+            id: this.id,
+            customTime: this.customTime,
+            metadata: this.metadata,
+            ...changes,
+        });
+        segment._parent = this._parent;
+        return segment;
+    }
+    withMetadata(metadata) {
+        const segment = new Segment({
+            lines: this.lines,
+            structureTags: this.structureTags,
+            id: this.id,
+            customTime: this.customTime,
+            metadata,
+        });
+        segment._parent = this._parent;
+        return segment;
+    }
+    setParent(section) {
+        this._parent = section;
+    }
+    getSection() {
+        if (!this._parent)
+            throw new Error('Segment has no parent Section');
+        return this._parent;
+    }
+    getDocument() {
+        return this.getSection().getDocument();
+    }
+}
+//# sourceMappingURL=Segment.js.map

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

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

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

@@ -0,0 +1,24 @@
+export declare class Tag {
+    readonly name: string;
+    constructor(name: string);
+    equals(other: Tag): boolean;
+    toCssClass(): string;
+    static of(name: string): Tag;
+}
+export declare enum StructureTag {
+    FIRST_WORD_IN_SECTION = "first-word-in-section",
+    LAST_WORD_IN_SECTION = "last-word-in-section",
+    FIRST_WORD_IN_SEGMENT = "first-word-in-segment",
+    LAST_WORD_IN_SEGMENT = "last-word-in-segment",
+    FIRST_WORD_IN_LINE = "first-word-in-line",
+    LAST_WORD_IN_LINE = "last-word-in-line",
+    FIRST_LINE_IN_SECTION = "first-line-in-section",
+    LAST_LINE_IN_SECTION = "last-line-in-section",
+    FIRST_LINE_IN_SEGMENT = "first-line-in-segment",
+    LAST_LINE_IN_SEGMENT = "last-line-in-segment",
+    FIRST_SEGMENT_IN_SECTION = "first-segment-in-section",
+    LAST_SEGMENT_IN_SECTION = "last-segment-in-section",
+    FIRST_SECTION_IN_DOCUMENT = "first-section-in-document",
+    LAST_SECTION_IN_DOCUMENT = "last-section-in-document"
+}
+//# sourceMappingURL=Tag.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Tag.d.ts","sourceRoot":"","sources":["../../../src/modules/document/Tag.ts"],"names":[],"mappings":"AAAA,qBAAa,GAAG;IACF,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;IAEjC,MAAM,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IAI3B,UAAU,IAAI,MAAM;IAIpB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG;CAG7B;AAED,oBAAY,YAAY;IAEtB,qBAAqB,0BAA0B;IAC/C,oBAAoB,yBAAyB;IAC7C,qBAAqB,0BAA0B;IAC/C,oBAAoB,yBAAyB;IAC7C,kBAAkB,uBAAuB;IACzC,iBAAiB,sBAAsB;IAGvC,qBAAqB,0BAA0B;IAC/C,oBAAoB,yBAAyB;IAC7C,qBAAqB,0BAA0B;IAC/C,oBAAoB,yBAAyB;IAG7C,wBAAwB,6BAA6B;IACrD,uBAAuB,4BAA4B;IAGnD,yBAAyB,8BAA8B;IACvD,wBAAwB,6BAA6B;CACtD"}

package/dist/modules/document/Tag.js

@@ -0,0 +1,37 @@
+export class Tag {
+    name;
+    constructor(name) {
+        this.name = name;
+    }
+    equals(other) {
+        return this.name === other.name;
+    }
+    toCssClass() {
+        return this.name;
+    }
+    static of(name) {
+        return new Tag(name);
+    }
+}
+export var StructureTag;
+(function (StructureTag) {
+    // Word-level
+    StructureTag["FIRST_WORD_IN_SECTION"] = "first-word-in-section";
+    StructureTag["LAST_WORD_IN_SECTION"] = "last-word-in-section";
+    StructureTag["FIRST_WORD_IN_SEGMENT"] = "first-word-in-segment";
+    StructureTag["LAST_WORD_IN_SEGMENT"] = "last-word-in-segment";
+    StructureTag["FIRST_WORD_IN_LINE"] = "first-word-in-line";
+    StructureTag["LAST_WORD_IN_LINE"] = "last-word-in-line";
+    // Line-level
+    StructureTag["FIRST_LINE_IN_SECTION"] = "first-line-in-section";
+    StructureTag["LAST_LINE_IN_SECTION"] = "last-line-in-section";
+    StructureTag["FIRST_LINE_IN_SEGMENT"] = "first-line-in-segment";
+    StructureTag["LAST_LINE_IN_SEGMENT"] = "last-line-in-segment";
+    // Segment-level
+    StructureTag["FIRST_SEGMENT_IN_SECTION"] = "first-segment-in-section";
+    StructureTag["LAST_SEGMENT_IN_SECTION"] = "last-segment-in-section";
+    // Section-level
+    StructureTag["FIRST_SECTION_IN_DOCUMENT"] = "first-section-in-document";
+    StructureTag["LAST_SECTION_IN_DOCUMENT"] = "last-section-in-document";
+})(StructureTag || (StructureTag = {}));
+//# sourceMappingURL=Tag.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Tag.js","sourceRoot":"","sources":["../../../src/modules/document/Tag.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,GAAG;IACO;IAArB,YAAqB,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;IAErC,MAAM,CAAC,KAAU;QACf,OAAO,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC;IAClC,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,EAAE,CAAC,IAAY;QACpB,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;CACF;AAED,MAAM,CAAN,IAAY,YAsBX;AAtBD,WAAY,YAAY;IACtB,aAAa;IACb,+DAA+C,CAAA;IAC/C,6DAA6C,CAAA;IAC7C,+DAA+C,CAAA;IAC/C,6DAA6C,CAAA;IAC7C,yDAAyC,CAAA;IACzC,uDAAuC,CAAA;IAEvC,aAAa;IACb,+DAA+C,CAAA;IAC/C,6DAA6C,CAAA;IAC7C,+DAA+C,CAAA;IAC/C,6DAA6C,CAAA;IAE7C,gBAAgB;IAChB,qEAAqD,CAAA;IACrD,mEAAmD,CAAA;IAEnD,gBAAgB;IAChB,uEAAuD,CAAA;IACvD,qEAAqD,CAAA;AACvD,CAAC,EAtBW,YAAY,KAAZ,YAAY,QAsBvB"}

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

@@ -0,0 +1,11 @@
+export declare class TimeFragment {
+    readonly start: number;
+    readonly end: number;
+    constructor(start: number, end: number);
+    contains(time: number): boolean;
+    isAfter(time: number): boolean;
+    isBefore(time: number): boolean;
+    get duration(): number;
+    get midpoint(): number;
+}
+//# sourceMappingURL=TimeFragment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TimeFragment.d.ts","sourceRoot":"","sources":["../../../src/modules/document/TimeFragment.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAY;IAErB,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM;gBADX,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM;IAQtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/B,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;CACF"}