@tscaps/engine 0.1.1

package/dist/modules/pipeline/RenderPipelineBuilder.js

@@ -0,0 +1,317 @@
+import { WhisperTranscriber } from '../transcription/WhisperTranscriber';
+import { BrowserAudioDecoder } from '../transcription/BrowserAudioDecoder';
+import { GraphemeWordSplitter } from '../splitting/GraphemeWordSplitter';
+import { CompositeSegmentSplitter } from '../splitting/CompositeSegmentSplitter';
+import { BoundarySegmentSplitter } from '../splitting/BoundarySegmentSplitter';
+import { LimitByScaledCharsSegmentSplitter } from '../splitting/LimitByScaledCharsSegmentSplitter';
+import { StructureTagger } from '../tagging/StructureTagger';
+import { BrowserSubtitleFrameRenderer } from '../rendering/BrowserSubtitleFrameRenderer';
+import { BrowserOverlayFrameRenderer } from '../rendering/BrowserOverlayFrameRenderer';
+import { BrowserCssResourceEmbedder } from '../css/BrowserCssResourceEmbedder';
+import { MediaBunnyVideoRenderer } from '../video/mediabunny/MediaBunnyVideoRenderer';
+import { DefaultCodecPolicy } from '../video/mediabunny/codec/DefaultCodecPolicy';
+import { DefaultVideoFrameDecoderFactory } from '../video/mediabunny/frame/DefaultVideoFrameDecoderFactory';
+import { MediaBunnyCanvasVideoTrackEncoderFactory } from '../video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoderFactory';
+import { DefaultAudioTrackBridgeFactory } from '../video/mediabunny/audio/DefaultAudioTrackBridgeFactory';
+import { MediaBunnyOutputTargetBuilder } from '../video/mediabunny/output/MediaBunnyOutputTargetBuilder';
+import { LayeredFrameCompositor } from '../video/mediabunny/frame/LayeredFrameCompositor';
+import { BatchedSubtitleLayerSource } from '../video/mediabunny/caption/BatchedSubtitleLayerSource';
+import { VideoBoundSubtitleLayerSource } from '../video/mediabunny/caption/VideoBoundSubtitleLayerSource';
+import { ComposedSubtitleLayerSource } from '../video/mediabunny/caption/ComposedSubtitleLayerSource';
+import { RenderPipeline } from '../pipeline/RenderPipeline';
+const DEFAULT_SEGMENT_SPLITTER_CONFIG = {
+    separators: ['.', '?', '!'],
+    maxChars: 40,
+    minChars: 10,
+    scale: 1,
+};
+const DEFAULT_LINE_SPLITTER_CONFIG = {
+    maxLines: 2,
+    minLines: 1,
+    maxWidthRatio: 0.8,
+};
+const DEFAULT_ALIGNMENT = {
+    verticalAlign: 'bottom',
+    verticalOffset: 0.85,
+    horizontalAlign: 'center',
+    horizontalOffset: 0.5,
+};
+const DEFAULT_RENDERING = {
+    splitWordsIntoLetters: false,
+    videoFrame: { required: false, jpegQuality: 1 },
+    padding: null,
+};
+const DEFAULT_SUBTITLE_CSS = `
+  .segment {
+    font-family: system-ui, -apple-system, sans-serif;
+    font-weight: 700;
+    font-size: 5cqh;
+    color: #ffffff;
+    text-align: center;
+    line-height: 1.2;
+    text-shadow: 0 0.1em 0.3em rgba(0, 0, 0, 0.7);
+  }
+  .line { display: block; }
+  .word { display: inline-block; margin: 0 0.15em; }
+`;
+const DEFAULT_SUBTITLE_STYLE = {
+    css: DEFAULT_SUBTITLE_CSS,
+    inlineStyles: {},
+    alignment: DEFAULT_ALIGNMENT,
+    rendering: DEFAULT_RENDERING,
+};
+/**
+ * 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 class RenderPipelineBuilder {
+    video = null;
+    transcriber = null;
+    transcriberOptions = undefined;
+    segmentSplitter = null;
+    defaultSegmentSplitterConfig = { ...DEFAULT_SEGMENT_SPLITTER_CONFIG };
+    lineSplitter = null;
+    defaultLineSplitterConfig = { ...DEFAULT_LINE_SPLITTER_CONFIG };
+    wordSplitter = null;
+    semanticTaggers = [];
+    effects = [];
+    style = DEFAULT_SUBTITLE_STYLE;
+    explicitStyles = null;
+    outputFormat = undefined;
+    quality = undefined;
+    outputResolution = undefined;
+    outputStream = undefined;
+    overlayHtml = undefined;
+    onAudioDiscarded = undefined;
+    confirmFallbackDecoder = undefined;
+    videoRenderer = null;
+    subtitleFrameRenderer = null;
+    overlayFrameRenderer = null;
+    cssResourceEmbedder = null;
+    withInputVideo(video) {
+        this.video = video;
+        return this;
+    }
+    withTranscriber(transcriber) {
+        this.transcriber = transcriber;
+        return this;
+    }
+    withTranscriberOptions(options) {
+        this.transcriberOptions = options;
+        return this;
+    }
+    withSegmentSplitter(splitter) {
+        this.segmentSplitter = splitter;
+        return this;
+    }
+    withDefaultSegmentSplitterConfig(partial) {
+        this.defaultSegmentSplitterConfig = { ...this.defaultSegmentSplitterConfig, ...partial };
+        return this;
+    }
+    withLineSplitter(splitter) {
+        this.lineSplitter = splitter;
+        return this;
+    }
+    withDefaultLineSplitterConfig(partial) {
+        this.defaultLineSplitterConfig = { ...this.defaultLineSplitterConfig, ...partial };
+        return this;
+    }
+    withWordSplitter(splitter) {
+        this.wordSplitter = splitter;
+        return this;
+    }
+    addTagger(tagger) {
+        this.semanticTaggers.push(tagger);
+        return this;
+    }
+    withTaggers(taggers) {
+        this.semanticTaggers = [...taggers];
+        return this;
+    }
+    addEffect(effect) {
+        this.effects.push(effect);
+        return this;
+    }
+    withEffects(effects) {
+        this.effects = [...effects];
+        return this;
+    }
+    withCss(css) {
+        this.style = { ...this.style, css };
+        return this;
+    }
+    withAlignment(alignment) {
+        this.style = { ...this.style, alignment };
+        return this;
+    }
+    withRenderingConfig(rendering) {
+        this.style = { ...this.style, rendering };
+        return this;
+    }
+    withInlineStyles(inlineStyles) {
+        this.style = { ...this.style, inlineStyles };
+        return this;
+    }
+    /** Replaces the single-style default wholesale; subsequent style atajos layer on top of this. */
+    withSubtitleStyle(style) {
+        this.style = style;
+        return 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) {
+        this.explicitStyles = styles;
+        return this;
+    }
+    withOutputFormat(format) {
+        this.outputFormat = format;
+        return this;
+    }
+    withOutputResolution(width, height) {
+        this.outputResolution = { width, height };
+        return this;
+    }
+    withQuality(quality) {
+        this.quality = quality;
+        return this;
+    }
+    withOutputStream(stream) {
+        this.outputStream = stream;
+        return this;
+    }
+    withOverlayHtml(html) {
+        this.overlayHtml = html;
+        return this;
+    }
+    withOnAudioDiscarded(callback) {
+        this.onAudioDiscarded = callback;
+        return this;
+    }
+    withConfirmFallbackDecoder(callback) {
+        this.confirmFallbackDecoder = callback;
+        return this;
+    }
+    withVideoRenderer(renderer) {
+        this.videoRenderer = renderer;
+        return this;
+    }
+    /**
+     * Feeds the default MediaBunny video renderer. Ignored if a full
+     * `VideoRenderer` was supplied via `withVideoRenderer`.
+     */
+    withSubtitleFrameRenderer(renderer) {
+        this.subtitleFrameRenderer = renderer;
+        return this;
+    }
+    /**
+     * Feeds the default MediaBunny video renderer. Ignored if a full
+     * `VideoRenderer` was supplied via `withVideoRenderer`.
+     */
+    withOverlayFrameRenderer(renderer) {
+        this.overlayFrameRenderer = renderer;
+        return this;
+    }
+    /**
+     * Feeds the default subtitle frame renderer. Ignored if a full
+     * `SubtitleFrameRenderer` or `VideoRenderer` was supplied.
+     */
+    withCssResourceEmbedder(embedder) {
+        this.cssResourceEmbedder = embedder;
+        return this;
+    }
+    /** Materialises the pipeline. Throws if no input video has been supplied. */
+    build() {
+        if (this.video === null) {
+            throw new Error('RenderPipelineBuilder: input video is required (call withInputVideo)');
+        }
+        return new RenderPipeline(this.buildConfig(this.video));
+    }
+    buildConfig(video) {
+        const wordSplitter = this.wordSplitter ?? new GraphemeWordSplitter();
+        const cssResourceEmbedder = this.cssResourceEmbedder ?? new BrowserCssResourceEmbedder();
+        const videoRenderer = this.videoRenderer ?? this.buildDefaultVideoRenderer(cssResourceEmbedder, wordSplitter);
+        return {
+            video,
+            transcriber: this.transcriber ?? this.buildDefaultTranscriber(),
+            transcriberOptions: this.transcriberOptions,
+            segmentSplitter: this.segmentSplitter ?? this.buildDefaultSegmentSplitter(),
+            lineSplitter: this.lineSplitter,
+            defaultLineSplitterConfig: this.defaultLineSplitterConfig,
+            structureTagger: new StructureTagger(),
+            semanticTaggers: [...this.semanticTaggers],
+            effects: [...this.effects],
+            defaultStyle: this.style,
+            explicitStyles: this.explicitStyles,
+            videoRenderer,
+            outputFormat: this.outputFormat,
+            quality: this.quality,
+            outputResolution: this.outputResolution,
+            outputStream: this.outputStream,
+            overlayHtml: this.overlayHtml,
+            onAudioDiscarded: this.onAudioDiscarded,
+            confirmFallbackDecoder: this.confirmFallbackDecoder,
+        };
+    }
+    buildDefaultTranscriber() {
+        return new WhisperTranscriber(new BrowserAudioDecoder());
+    }
+    buildDefaultSegmentSplitter() {
+        const config = this.defaultSegmentSplitterConfig;
+        return new CompositeSegmentSplitter([
+            new BoundarySegmentSplitter({ separators: [...config.separators] }),
+            new LimitByScaledCharsSegmentSplitter({
+                maxChars: config.maxChars,
+                minChars: config.minChars,
+                scale: config.scale,
+            }),
+        ]);
+    }
+    buildDefaultVideoRenderer(cssResourceEmbedder, wordSplitter) {
+        return new MediaBunnyVideoRenderer({
+            subtitleLayer: this.buildDefaultSubtitleLayerSource(cssResourceEmbedder, wordSplitter),
+            overlayRenderer: this.overlayFrameRenderer ?? new BrowserOverlayFrameRenderer(),
+            codecPolicy: new DefaultCodecPolicy(),
+            videoFrameDecoderFactory: new DefaultVideoFrameDecoderFactory(),
+            videoTrackEncoderFactory: new MediaBunnyCanvasVideoTrackEncoderFactory(),
+            audioTrackBridgeFactory: new DefaultAudioTrackBridgeFactory(),
+            outputTargetBuilder: new MediaBunnyOutputTargetBuilder(),
+            frameCompositor: new LayeredFrameCompositor(),
+        });
+    }
+    buildDefaultSubtitleLayerSource(cssResourceEmbedder, wordSplitter) {
+        return new ComposedSubtitleLayerSource(new BatchedSubtitleLayerSource(this.resolveSubtitleFrameRenderer(cssResourceEmbedder, wordSplitter)), new VideoBoundSubtitleLayerSource(this.resolveSubtitleFrameRenderer(cssResourceEmbedder, wordSplitter)));
+    }
+    // Each layer source gets its own subtitle frame renderer when the
+    // builder owns the default: the two sources hold independent open()
+    // state that would clash on a shared instance. A consumer-supplied
+    // renderer is reused as-is — sharing is then the consumer's call.
+    resolveSubtitleFrameRenderer(cssResourceEmbedder, wordSplitter) {
+        if (this.subtitleFrameRenderer !== null)
+            return this.subtitleFrameRenderer;
+        return new BrowserSubtitleFrameRenderer(cssResourceEmbedder, wordSplitter);
+    }
+}
+//# sourceMappingURL=RenderPipelineBuilder.js.map

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

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

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

@@ -0,0 +1,6 @@
+export { RenderPipeline } from '../pipeline/RenderPipeline';
+export type { RenderPipelineConfig, OutputResolution, DefaultLineSplitterRuntimeConfig, } from '../pipeline/RenderPipeline';
+export { RenderPipelineBuilder } from '../pipeline/RenderPipelineBuilder';
+export type { DefaultSegmentSplitterConfig, DefaultLineSplitterConfig, } from '../pipeline/RenderPipelineBuilder';
+export type { PipelineProgressEvent, PipelineProgressListener } from '../pipeline/PipelineProgress';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/pipeline/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,gCAAgC,GACjC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,YAAY,EACV,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,yCAAyC,CAAC;AACjD,YAAY,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/modules/pipeline/index.js

@@ -0,0 +1,3 @@
+export { RenderPipeline } from '../pipeline/RenderPipeline';
+export { RenderPipelineBuilder } from '../pipeline/RenderPipelineBuilder';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/pipeline/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAMlE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC"}

package/dist/modules/profiling/Profiler.d.ts

@@ -0,0 +1,115 @@
+type AnyCtor = abstract new (...args: never[]) => unknown;
+export declare class Profiler {
+    /**
+     * Master switch. While `false`, {@link record} and {@link time} are no-ops
+     * (timing source is not even read), so manual `profiler.time(...)` calls
+     * can be left in production code at zero cost. The various `wrap` methods
+     * flip this to `true` automatically.
+     */
+    enabled: boolean;
+    /** Sample `performance.memory.usedJSHeapSize` around each call. Chrome-only. */
+    measureMemory: boolean;
+    private readonly samples;
+    private readonly memDeltas;
+    private readonly memSamples;
+    private readonly originals;
+    private readonly warnOverMs;
+    private readonly maxSamplesPerLabel;
+    constructor(opts?: ProfilerOptions);
+    /**
+     * Wraps `target` in a `Proxy` that times every method call. The returned
+     * value is a stand-in for `target`: pass it where you would have passed
+     * the original. The original instance keeps working unchanged.
+     */
+    wrap<T extends object>(target: T, opts?: WrapOptions): T;
+    /**
+     * Replaces every method on `Klass.prototype` with a timed version. All
+     * instances — past and future — pick up the instrumentation, because the
+     * prototype lookup is dynamic. Use {@link restoreClass} to undo.
+     */
+    wrapClass(Klass: AnyCtor, opts?: WrapOptions): void;
+    /**
+     * Restores a class previously instrumented via {@link wrapClass} to its
+     * original prototype methods.
+     */
+    restoreClass(Klass: AnyCtor): void;
+    /**
+     * Wraps every class exported by a module namespace (`import * as M from '...'`).
+     * Returns the list of class names that were instrumented, for quick sanity
+     * checks. The namespace object itself is not mutated — only the prototypes
+     * of the classes it references.
+     */
+    wrapNamespace(ns: Record<string, unknown>, opts?: NamespaceWrapOptions): string[];
+    /** Times an arbitrary function — sync or async. Escape hatch for non-method code. */
+    time<T>(label: string, fn: () => T): T;
+    /** Records a manual measurement. Useful for instrumenting points that aren't whole methods. */
+    record(label: string, durationMs: number, deltaBytes?: number | null): void;
+    /** Builds an aggregated report from the samples collected so far. */
+    report(): ProfilerReport;
+    /** Pretty-prints the report as a sortable `console.table`. */
+    printReport(opts?: PrintOptions): void;
+    reset(): void;
+    /**
+     * Returns the V8 JS heap size in bytes (Chrome only). Note: this is the JS
+     * isolate's used heap only — it excludes WebCodecs buffers, decoded bitmap
+     * caches, and other native memory held by the renderer process.
+     *
+     * When the runtime was started with `--js-flags="--expose-gc"`, this forces
+     * a synchronous full GC before reading so what's left is the actually-retained
+     * portion. Without that flag, returns the heap as-is.
+     */
+    snapshotHeap(): number | null;
+    private wrapMethod;
+    private startMem;
+    private endMem;
+}
+export interface ProfilerOptions {
+    /** Sample `performance.memory.usedJSHeapSize` around each call. Chrome-only, noisy without `--expose-gc`. */
+    measureMemory?: boolean;
+    /** Log a console warning when a single call exceeds this duration. */
+    warnOverMs?: number;
+    /** Keep at most this many duration samples per label, to bound memory of the profiler itself. */
+    maxSamplesPerLabel?: number;
+}
+export interface WrapOptions {
+    /** Label prefix used in the report. Defaults to the class or constructor name. */
+    name?: string;
+    /** Only instrument method names matching the regex / predicate. */
+    include?: RegExp | ((methodName: string) => boolean);
+    /** Skip method names matching the regex / predicate. Evaluated after `include`. */
+    exclude?: RegExp | ((methodName: string) => boolean);
+    /** Walk the prototype chain past `Klass.prototype` and instrument inherited methods too. */
+    includeInherited?: boolean;
+}
+export interface NamespaceWrapOptions extends WrapOptions {
+    /** Restrict which exported names to treat as instrumentable classes. */
+    classFilter?: RegExp | ((className: string) => boolean);
+}
+export interface MethodStat {
+    label: string;
+    count: number;
+    totalMs: number;
+    meanMs: number;
+    minMs: number;
+    maxMs: number;
+    p50Ms: number;
+    p95Ms: number;
+    p99Ms: number;
+    /** Sum over all calls of (heapAfter - heapBefore). `null` when memory measurement is off or unavailable. */
+    totalDeltaBytes: number | null;
+}
+export interface ProfilerReport {
+    stats: MethodStat[];
+    totalCalls: number;
+    totalMs: number;
+}
+export interface PrintOptions {
+    /** Column to sort rows by, descending. Defaults to `totalMs`. */
+    sortBy?: 'totalMs' | 'meanMs' | 'count' | 'maxMs' | 'p95Ms' | 'p99Ms';
+    /** Show only the first N rows after sorting. */
+    top?: number;
+}
+/** Default instance — share across modules to aggregate a single report. */
+export declare const profiler: Profiler;
+export {};
+//# sourceMappingURL=Profiler.d.ts.map

package/dist/modules/profiling/Profiler.d.ts.map

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