@tscaps/engine 0.1.1

package/dist/modules/pipeline/RenderPipeline.js

@@ -0,0 +1,232 @@
+import { BalancedPixelWidthLineSplitter } from '../splitting/BalancedPixelWidthLineSplitter';
+import { DomProbeCanvasTextMeasurer } from '../splitting/DomProbeCanvasTextMeasurer';
+/**
+ * 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 class RenderPipeline {
+    config;
+    currentDocument = null;
+    cachedVideoDimensions = null;
+    cachedVideoFile = null;
+    constructor(config) {
+        this.config = config;
+    }
+    /** Current document state; `null` before transcription runs. */
+    getDocument() {
+        return this.currentDocument;
+    }
+    /** Replaces the current document — typical after a manual edit between steps. */
+    setDocument(document) {
+        this.currentDocument = document;
+    }
+    /**
+     * Runs every step in order and returns the final render result.
+     * Skips transcription when a document is already loaded.
+     */
+    async run(onProgress) {
+        if (this.currentDocument === null) {
+            await this.runTranscriptionStep(onProgress);
+        }
+        await this.runSplittingStep(onProgress);
+        this.runStructuralTaggingStep(onProgress);
+        await this.runSemanticTaggingStep(onProgress);
+        this.runEffectsStep(onProgress);
+        return this.runRenderingStep(onProgress);
+    }
+    async runTranscriptionStep(onProgress) {
+        const transcriber = this.config.transcriber;
+        const previous = transcriber.onProgress;
+        transcriber.onProgress = (event) => onProgress?.({ stage: 'transcribing', inner: event });
+        try {
+            const document = await transcriber.transcribe(this.config.video, this.config.transcriberOptions);
+            this.currentDocument = document;
+            return document;
+        }
+        finally {
+            this.restoreTranscriberProgressHandler(transcriber, previous);
+        }
+    }
+    restoreTranscriberProgressHandler(transcriber, previous) {
+        if (previous === undefined) {
+            delete transcriber.onProgress;
+        }
+        else {
+            transcriber.onProgress = previous;
+        }
+    }
+    async runSplittingStep(onProgress) {
+        const document = this.requireDocument('splitting');
+        onProgress?.({ stage: 'splitting', status: 'started' });
+        const segmentSplit = this.applySegmentSplitterToSections(document);
+        const lineSplit = await this.applyLineSplittingToSections(segmentSplit);
+        this.currentDocument = lineSplit;
+        onProgress?.({ stage: 'splitting', status: 'completed' });
+        return lineSplit;
+    }
+    runStructuralTaggingStep(onProgress) {
+        const document = this.requireDocument('structural tagging');
+        onProgress?.({ stage: 'tagging-structural', status: 'started' });
+        const tagged = this.config.structureTagger.tag(document);
+        this.currentDocument = tagged;
+        onProgress?.({ stage: 'tagging-structural', status: 'completed' });
+        return tagged;
+    }
+    async runSemanticTaggingStep(onProgress) {
+        const document = this.requireDocument('semantic tagging');
+        onProgress?.({ stage: 'tagging-semantic', status: 'started' });
+        let result = document;
+        for (const tagger of this.config.semanticTaggers) {
+            result = await tagger.tag(result);
+        }
+        this.currentDocument = result;
+        onProgress?.({ stage: 'tagging-semantic', status: 'completed' });
+        return result;
+    }
+    runEffectsStep(onProgress) {
+        const document = this.requireDocument('effects');
+        onProgress?.({ stage: 'applying-effects', status: 'started' });
+        let result = document;
+        for (const effect of this.config.effects) {
+            result = effect.apply(result);
+        }
+        this.currentDocument = result;
+        onProgress?.({ stage: 'applying-effects', status: 'completed' });
+        return result;
+    }
+    async runRenderingStep(onProgress) {
+        const document = this.requireDocument('rendering');
+        const styles = this.resolveStylesForDocument(document);
+        const job = this.buildRenderJob(document, styles);
+        return this.config.videoRenderer.render(job, (progress) => {
+            onProgress?.({ stage: 'rendering', inner: progress });
+        });
+    }
+    requireDocument(stageName) {
+        if (this.currentDocument === null) {
+            throw new Error(`RenderPipeline: cannot run ${stageName} step — no document loaded yet`);
+        }
+        return this.currentDocument;
+    }
+    applySegmentSplitterToSections(document) {
+        const sections = document.sections.map((section) => section.with({ segments: this.config.segmentSplitter.split(section.segments) }));
+        return document.with({ sections });
+    }
+    async applyLineSplittingToSections(document) {
+        const lineSplitter = await this.resolveLineSplitter();
+        if (lineSplitter === null)
+            return document;
+        const sections = document.sections.map((section) => section.with({ segments: lineSplitter.split(section.segments) }));
+        return document.with({ sections });
+    }
+    async resolveLineSplitter() {
+        if (this.config.lineSplitter !== null)
+            return this.config.lineSplitter;
+        // The default measurer needs one resolved css + one output size to
+        // anchor its probe. With explicit per-kind styles the consumer has
+        // gone beyond a single visual rule, so the default doesn't fit;
+        // they must supply their own LineSplitter.
+        if (this.config.explicitStyles !== null)
+            return null;
+        return this.buildDefaultLineSplitter();
+    }
+    async buildDefaultLineSplitter() {
+        const dimensions = await this.resolveOutputDimensions();
+        const measurer = new DomProbeCanvasTextMeasurer({
+            css: this.config.defaultStyle.css,
+            cssVars: this.extractCssVariablesFromInlineStyles(this.config.defaultStyle.inlineStyles),
+            containerWidth: dimensions.width,
+            containerHeight: dimensions.height,
+        });
+        const { maxLines, minLines, maxWidthRatio } = this.config.defaultLineSplitterConfig;
+        return new BalancedPixelWidthLineSplitter({
+            maxLines,
+            minLines,
+            maxWidth: Math.round(dimensions.width * maxWidthRatio),
+        }, measurer);
+    }
+    extractCssVariablesFromInlineStyles(inlineStyles) {
+        const result = {};
+        for (const [key, value] of Object.entries(inlineStyles)) {
+            if (key.startsWith('--'))
+                result[key] = value;
+        }
+        return result;
+    }
+    async resolveOutputDimensions() {
+        if (this.config.outputResolution !== undefined)
+            return this.config.outputResolution;
+        if (this.cachedVideoDimensions !== null)
+            return this.cachedVideoDimensions;
+        this.cachedVideoDimensions = await this.probeVideoNaturalDimensions(this.config.video);
+        return this.cachedVideoDimensions;
+    }
+    probeVideoNaturalDimensions(video) {
+        return new Promise((resolve, reject) => {
+            const url = URL.createObjectURL(video);
+            const element = document.createElement('video');
+            element.preload = 'metadata';
+            element.muted = true;
+            element.onloadedmetadata = () => {
+                URL.revokeObjectURL(url);
+                resolve({ width: element.videoWidth, height: element.videoHeight });
+            };
+            element.onerror = () => {
+                URL.revokeObjectURL(url);
+                reject(new Error('Failed to read video metadata while probing natural dimensions'));
+            };
+            element.src = url;
+        });
+    }
+    resolveStylesForDocument(document) {
+        if (this.config.explicitStyles !== null)
+            return this.config.explicitStyles;
+        const styles = {};
+        for (const section of document.sections) {
+            styles[section.kind] = this.config.defaultStyle;
+        }
+        return styles;
+    }
+    buildRenderJob(document, styles) {
+        return {
+            video: this.resolveVideoAsFile(),
+            document,
+            styles,
+            ...(this.config.overlayHtml !== undefined && { overlayHtml: this.config.overlayHtml }),
+            ...(this.config.outputFormat !== undefined && { outputFormat: this.config.outputFormat }),
+            ...(this.config.quality !== undefined && { quality: this.config.quality }),
+            ...(this.config.outputResolution !== undefined && { outputResolution: this.config.outputResolution }),
+            ...(this.config.outputStream !== undefined && { outputStream: this.config.outputStream }),
+            ...(this.config.onAudioDiscarded !== undefined && { onAudioDiscarded: this.config.onAudioDiscarded }),
+            ...(this.config.confirmFallbackDecoder !== undefined && { confirmFallbackDecoder: this.config.confirmFallbackDecoder }),
+        };
+    }
+    /**
+     * 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.
+     */
+    resolveVideoAsFile() {
+        if (this.cachedVideoFile !== null)
+            return this.cachedVideoFile;
+        const source = this.config.video;
+        this.cachedVideoFile = source instanceof File
+            ? source
+            : new File([source], 'input', { type: source.type });
+        return this.cachedVideoFile;
+    }
+}
+//# sourceMappingURL=RenderPipeline.js.map

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

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

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

@@ -0,0 +1,143 @@
+import type { Transcriber, TranscriberOptions } from '../transcription/Transcriber';
+import type { SegmentSplitter } from '../splitting/SegmentSplitter';
+import type { LineSplitter } from '../splitting/LineSplitter';
+import type { WordSplitter } from '../splitting/WordSplitter';
+import type { Tagger } from '../tagging/Tagger';
+import type { Effect } from '../effect/Effect';
+import type { SubtitleFrameRenderer, SubtitleStyle } from '../rendering/SubtitleFrameRenderer';
+import type { OverlayFrameRenderer } from '../rendering/OverlayFrameRenderer';
+import type { AlignmentConfig } from '../rendering/AlignmentConfig';
+import type { RenderingConfig } from '../rendering/RenderingConfig';
+import type { InlineStyleMap } from '../rendering/InlineStyleMap';
+import type { CssResourceEmbedder } from '../css/CssResourceEmbedder';
+import type { VideoRenderer } from '../video/VideoRenderer';
+import type { OutputFormat, RenderQuality, RenderOutputChunk, AudioDiscardReason, FallbackDecoderInfo } from '../video/RenderJob';
+import { RenderPipeline } from '../pipeline/RenderPipeline';
+/**
+ * Knobs that drive the default segment splitter — a composite that
+ * first cuts on hard sentence boundaries and then enforces a
+ * weighted character budget per segment. Honoured only when no
+ * explicit `SegmentSplitter` is supplied.
+ */
+export interface DefaultSegmentSplitterConfig {
+    separators: ReadonlyArray<string>;
+    maxChars: number;
+    minChars: number;
+    scale: number;
+}
+/**
+ * Knobs that drive the default line splitter — pixel-balanced over a
+ * DOM-probed text measurer. `maxWidthRatio` is multiplied by the
+ * resolved output width to derive the absolute pixel budget per line.
+ * Honoured only when no explicit `LineSplitter` is supplied.
+ */
+export interface DefaultLineSplitterConfig {
+    maxLines: number;
+    minLines: number;
+    maxWidthRatio: number;
+}
+/**
+ * Fluent assembler that produces a {@link RenderPipeline} preloaded with
+ * sensible defaults for every stage of the render flow: an in-browser
+ * Whisper transcriber, a sentence + scaled-char segment splitter, a
+ * pixel-balanced line splitter (built lazily once output size is known),
+ * the structural tagger, no semantic taggers, no effects, and a
+ * MediaBunny-backed video renderer.
+ *
+ * Every `with*` method narrows one slot and leaves the rest at their
+ * defaults; defaults stay in place until explicitly replaced. The only
+ * required input is the source video — `build` throws otherwise.
+ *
+ * Two granularities for styling: single-style callers shape the default
+ * via `withCss`/`withAlignment`/`withRenderingConfig`/`withInlineStyles`
+ * (or replace it wholesale with `withSubtitleStyle`); multi-kind callers
+ * pass a full per-kind map through `withSubtitleStyles`. The default
+ * line splitter only fits the single-style path — `withSubtitleStyles`
+ * disables it unless the caller also supplies their own splitter.
+ *
+ * Tweaking the default splitters' parameters without rebuilding them
+ * goes through the symmetric `withDefaultSegmentSplitterConfig` /
+ * `withDefaultLineSplitterConfig`.
+ */
+export declare class RenderPipelineBuilder {
+    private video;
+    private transcriber;
+    private transcriberOptions;
+    private segmentSplitter;
+    private defaultSegmentSplitterConfig;
+    private lineSplitter;
+    private defaultLineSplitterConfig;
+    private wordSplitter;
+    private semanticTaggers;
+    private effects;
+    private style;
+    private explicitStyles;
+    private outputFormat;
+    private quality;
+    private outputResolution;
+    private outputStream;
+    private overlayHtml;
+    private onAudioDiscarded;
+    private confirmFallbackDecoder;
+    private videoRenderer;
+    private subtitleFrameRenderer;
+    private overlayFrameRenderer;
+    private cssResourceEmbedder;
+    withInputVideo(video: File | Blob): this;
+    withTranscriber(transcriber: Transcriber): this;
+    withTranscriberOptions(options: TranscriberOptions): this;
+    withSegmentSplitter(splitter: SegmentSplitter): this;
+    withDefaultSegmentSplitterConfig(partial: Partial<DefaultSegmentSplitterConfig>): this;
+    withLineSplitter(splitter: LineSplitter): this;
+    withDefaultLineSplitterConfig(partial: Partial<DefaultLineSplitterConfig>): this;
+    withWordSplitter(splitter: WordSplitter): this;
+    addTagger(tagger: Tagger): this;
+    withTaggers(taggers: ReadonlyArray<Tagger>): this;
+    addEffect(effect: Effect): this;
+    withEffects(effects: ReadonlyArray<Effect>): this;
+    withCss(css: string): this;
+    withAlignment(alignment: AlignmentConfig): this;
+    withRenderingConfig(rendering: RenderingConfig): this;
+    withInlineStyles(inlineStyles: InlineStyleMap): this;
+    /** Replaces the single-style default wholesale; subsequent style atajos layer on top of this. */
+    withSubtitleStyle(style: SubtitleStyle): this;
+    /**
+     * Switches to the multi-kind mode: the supplied map is passed to the
+     * video renderer as-is, the single-style default is no longer used,
+     * and the default line splitter is disabled (callers in this mode
+     * must supply their own via `withLineSplitter` if they want one).
+     */
+    withSubtitleStyles(styles: Readonly<Record<string, SubtitleStyle>>): this;
+    withOutputFormat(format: OutputFormat): this;
+    withOutputResolution(width: number, height: number): this;
+    withQuality(quality: RenderQuality): this;
+    withOutputStream(stream: WritableStream<RenderOutputChunk>): this;
+    withOverlayHtml(html: string): this;
+    withOnAudioDiscarded(callback: (reason: AudioDiscardReason) => void): this;
+    withConfirmFallbackDecoder(callback: (info: FallbackDecoderInfo) => Promise<boolean>): this;
+    withVideoRenderer(renderer: VideoRenderer): this;
+    /**
+     * Feeds the default MediaBunny video renderer. Ignored if a full
+     * `VideoRenderer` was supplied via `withVideoRenderer`.
+     */
+    withSubtitleFrameRenderer(renderer: SubtitleFrameRenderer): this;
+    /**
+     * Feeds the default MediaBunny video renderer. Ignored if a full
+     * `VideoRenderer` was supplied via `withVideoRenderer`.
+     */
+    withOverlayFrameRenderer(renderer: OverlayFrameRenderer): this;
+    /**
+     * Feeds the default subtitle frame renderer. Ignored if a full
+     * `SubtitleFrameRenderer` or `VideoRenderer` was supplied.
+     */
+    withCssResourceEmbedder(embedder: CssResourceEmbedder): this;
+    /** Materialises the pipeline. Throws if no input video has been supplied. */
+    build(): RenderPipeline;
+    private buildConfig;
+    private buildDefaultTranscriber;
+    private buildDefaultSegmentSplitter;
+    private buildDefaultVideoRenderer;
+    private buildDefaultSubtitleLayerSource;
+    private resolveSubtitleFrameRenderer;
+}
+//# sourceMappingURL=RenderPipelineBuilder.d.ts.map

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

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