@tscaps/engine 0.1.1

package/dist/modules/profiling/Profiler.js

@@ -0,0 +1,316 @@
+export 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 = false;
+    /** Sample `performance.memory.usedJSHeapSize` around each call. Chrome-only. */
+    measureMemory;
+    samples = new Map();
+    memDeltas = new Map();
+    memSamples = new Map();
+    originals = new WeakMap();
+    warnOverMs;
+    maxSamplesPerLabel;
+    constructor(opts = {}) {
+        this.measureMemory = opts.measureMemory ?? false;
+        this.warnOverMs = opts.warnOverMs ?? Infinity;
+        this.maxSamplesPerLabel = opts.maxSamplesPerLabel ?? 10000;
+    }
+    /**
+     * 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(target, opts = {}) {
+        this.enabled = true;
+        const className = opts.name ?? target.constructor?.name ?? 'anonymous';
+        const include = toPredicate(opts.include);
+        const exclude = toPredicate(opts.exclude);
+        const wrapped = new Map();
+        const get = (obj, prop, receiver) => {
+            const value = Reflect.get(obj, prop, receiver);
+            if (typeof prop !== 'string' || typeof value !== 'function' || prop === 'constructor') {
+                return value;
+            }
+            const fn = value;
+            if (include && !include(prop))
+                return fn.bind(obj);
+            if (exclude && exclude(prop))
+                return fn.bind(obj);
+            let cached = wrapped.get(prop);
+            if (!cached) {
+                const label = `${className}.${prop}`;
+                cached = this.wrapMethod(fn.bind(obj), label);
+                wrapped.set(prop, cached);
+            }
+            return cached;
+        };
+        return new Proxy(target, { get });
+    }
+    /**
+     * 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, opts = {}) {
+        this.enabled = true;
+        const proto = Klass.prototype;
+        if (!proto)
+            return;
+        const className = opts.name ?? Klass.name ?? 'anonymous';
+        const include = toPredicate(opts.include);
+        const exclude = toPredicate(opts.exclude);
+        let saved = this.originals.get(proto);
+        if (!saved) {
+            saved = new Map();
+            this.originals.set(proto, saved);
+        }
+        const chain = [proto];
+        if (opts.includeInherited) {
+            let p = Object.getPrototypeOf(proto);
+            while (p && p !== Object.prototype) {
+                chain.push(p);
+                p = Object.getPrototypeOf(p);
+            }
+        }
+        for (const target of chain) {
+            for (const key of Object.getOwnPropertyNames(target)) {
+                if (key === 'constructor')
+                    continue;
+                if (include && !include(key))
+                    continue;
+                if (exclude && exclude(key))
+                    continue;
+                const descriptor = Object.getOwnPropertyDescriptor(target, key);
+                if (!descriptor || typeof descriptor.value !== 'function')
+                    continue;
+                if (saved.has(key))
+                    continue;
+                saved.set(key, descriptor);
+                const original = descriptor.value;
+                const label = `${className}.${key}`;
+                const wrappedFn = this.wrapMethod(original, label);
+                Object.defineProperty(target, key, {
+                    ...descriptor,
+                    value: wrappedFn,
+                });
+            }
+        }
+    }
+    /**
+     * Restores a class previously instrumented via {@link wrapClass} to its
+     * original prototype methods.
+     */
+    restoreClass(Klass) {
+        const proto = Klass.prototype;
+        if (!proto)
+            return;
+        const saved = this.originals.get(proto);
+        if (!saved)
+            return;
+        for (const [key, descriptor] of saved) {
+            Object.defineProperty(proto, key, descriptor);
+        }
+        this.originals.delete(proto);
+    }
+    /**
+     * 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, opts = {}) {
+        const classFilter = toPredicate(opts.classFilter);
+        const touched = [];
+        for (const key of Object.keys(ns)) {
+            const value = ns[key];
+            if (!isClass(value))
+                continue;
+            if (classFilter && !classFilter(key))
+                continue;
+            this.wrapClass(value, { ...opts, name: opts.name ?? key });
+            touched.push(key);
+        }
+        return touched;
+    }
+    /** Times an arbitrary function — sync or async. Escape hatch for non-method code. */
+    time(label, fn) {
+        if (!this.enabled)
+            return fn();
+        const start = performance.now();
+        const startMem = this.startMem();
+        try {
+            const result = fn();
+            if (isPromiseLike(result)) {
+                return Promise.resolve(result).finally(() => {
+                    this.record(label, performance.now() - start, this.endMem(startMem));
+                });
+            }
+            this.record(label, performance.now() - start, this.endMem(startMem));
+            return result;
+        }
+        catch (e) {
+            this.record(label, performance.now() - start, this.endMem(startMem));
+            throw e;
+        }
+    }
+    /** Records a manual measurement. Useful for instrumenting points that aren't whole methods. */
+    record(label, durationMs, deltaBytes = null) {
+        if (!this.enabled)
+            return;
+        let arr = this.samples.get(label);
+        if (!arr) {
+            arr = [];
+            this.samples.set(label, arr);
+        }
+        if (arr.length < this.maxSamplesPerLabel)
+            arr.push(durationMs);
+        if (deltaBytes !== null && this.measureMemory) {
+            this.memDeltas.set(label, (this.memDeltas.get(label) ?? 0) + deltaBytes);
+            this.memSamples.set(label, (this.memSamples.get(label) ?? 0) + 1);
+        }
+        if (durationMs >= this.warnOverMs) {
+            console.warn(`[profiler] slow call: ${label} took ${durationMs.toFixed(2)}ms`);
+        }
+    }
+    /** Builds an aggregated report from the samples collected so far. */
+    report() {
+        const stats = [];
+        let totalCalls = 0;
+        let totalMs = 0;
+        for (const [label, samples] of this.samples) {
+            if (samples.length === 0)
+                continue;
+            const sorted = [...samples].sort((a, b) => a - b);
+            const sum = sorted.reduce((acc, v) => acc + v, 0);
+            const memTotal = this.memDeltas.get(label);
+            stats.push({
+                label,
+                count: sorted.length,
+                totalMs: sum,
+                meanMs: sum / sorted.length,
+                minMs: sorted[0],
+                maxMs: sorted[sorted.length - 1],
+                p50Ms: percentile(sorted, 0.5),
+                p95Ms: percentile(sorted, 0.95),
+                p99Ms: percentile(sorted, 0.99),
+                totalDeltaBytes: memTotal ?? null,
+            });
+            totalCalls += sorted.length;
+            totalMs += sum;
+        }
+        return { stats, totalCalls, totalMs };
+    }
+    /** Pretty-prints the report as a sortable `console.table`. */
+    printReport(opts = {}) {
+        const report = this.report();
+        const sortBy = opts.sortBy ?? 'totalMs';
+        const top = opts.top ?? report.stats.length;
+        const sorted = [...report.stats].sort((a, b) => b[sortBy] - a[sortBy]);
+        const rows = sorted.slice(0, top).map((s) => ({
+            label: s.label,
+            count: s.count,
+            totalMs: round(s.totalMs),
+            meanMs: round(s.meanMs),
+            p50: round(s.p50Ms),
+            p95: round(s.p95Ms),
+            p99: round(s.p99Ms),
+            maxMs: round(s.maxMs),
+            memMB: s.totalDeltaBytes !== null ? round(s.totalDeltaBytes / 1024 / 1024) : '—',
+        }));
+        console.groupCollapsed(`[profiler] ${report.totalCalls} calls, ${round(report.totalMs)}ms total`);
+        console.table(rows);
+        console.groupEnd();
+    }
+    reset() {
+        this.samples.clear();
+        this.memDeltas.clear();
+        this.memSamples.clear();
+    }
+    /**
+     * 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() {
+        const w = globalThis;
+        w.gc?.();
+        return readHeapBytes();
+    }
+    wrapMethod(fn, label) {
+        const record = (durationMs, delta) => this.record(label, durationMs, delta);
+        const startMem = () => this.startMem();
+        const endMem = (start) => this.endMem(start);
+        return function wrappedMethod(...args) {
+            const start = performance.now();
+            const mStart = startMem();
+            try {
+                const result = fn.apply(this, args);
+                if (isPromiseLike(result)) {
+                    return Promise.resolve(result).finally(() => {
+                        record(performance.now() - start, endMem(mStart));
+                    });
+                }
+                record(performance.now() - start, endMem(mStart));
+                return result;
+            }
+            catch (e) {
+                record(performance.now() - start, endMem(mStart));
+                throw e;
+            }
+        };
+    }
+    startMem() {
+        if (!this.measureMemory)
+            return null;
+        return readHeapBytes();
+    }
+    endMem(start) {
+        if (start === null)
+            return null;
+        const end = readHeapBytes();
+        return end === null ? null : end - start;
+    }
+}
+function toPredicate(filter) {
+    if (!filter)
+        return null;
+    if (filter instanceof RegExp)
+        return (s) => filter.test(s);
+    return filter;
+}
+function isClass(value) {
+    if (typeof value !== 'function')
+        return false;
+    const candidate = value;
+    if (!candidate.prototype)
+        return false;
+    const name = candidate.name;
+    return !!name && /^[A-Z]/.test(name);
+}
+function isPromiseLike(value) {
+    return !!value && typeof value.then === 'function';
+}
+function percentile(sorted, q) {
+    if (sorted.length === 0)
+        return 0;
+    const idx = Math.min(sorted.length - 1, Math.floor(q * sorted.length));
+    return sorted[idx];
+}
+function round(n) {
+    return Math.round(n * 100) / 100;
+}
+function readHeapBytes() {
+    const perf = performance;
+    return perf.memory ? perf.memory.usedJSHeapSize : null;
+}
+/** Default instance — share across modules to aggregate a single report. */
+export const profiler = new Profiler();
+//# sourceMappingURL=Profiler.js.map

package/dist/modules/profiling/Profiler.js.map

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

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

@@ -0,0 +1,2 @@
+export { Profiler, profiler, type ProfilerOptions, type WrapOptions, type NamespaceWrapOptions, type MethodStat, type ProfilerReport, type PrintOptions, } from '../profiling/Profiler';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/profiling/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,6BAA6B,CAAC"}

package/dist/modules/profiling/index.js

@@ -0,0 +1,2 @@
+export { Profiler, profiler, } from '../profiling/Profiler';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/profiling/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,QAAQ,GAOT,MAAM,6BAA6B,CAAC"}

package/dist/modules/rendering/AlignmentConfig.d.ts

@@ -0,0 +1,21 @@
+export type VerticalAlign = 'top' | 'center' | 'bottom';
+export type HorizontalAlign = 'left' | 'center' | 'right';
+/**
+ * Symmetric box-anchor positioning. `*Offset` is the absolute position of
+ * the anchor point as a fraction of the video's dimensions; `*Align`
+ * decides which edge of the caption box lands on that point:
+ *   top/left   → 0% of own size
+ *   center     → 50%
+ *   bottom/right → 100%
+ *
+ * E.g. `verticalOffset: 1, verticalAlign: 'bottom'` pins the box's bottom
+ * edge to the video's bottom edge. `horizontalOffset: 0.5,
+ * horizontalAlign: 'center'` centers the box horizontally.
+ */
+export interface AlignmentConfig {
+    verticalAlign: VerticalAlign;
+    verticalOffset: number;
+    horizontalAlign: HorizontalAlign;
+    horizontalOffset: number;
+}
+//# sourceMappingURL=AlignmentConfig.d.ts.map

package/dist/modules/rendering/AlignmentConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AlignmentConfig.d.ts","sourceRoot":"","sources":["../../../src/modules/rendering/AlignmentConfig.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACxD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE1D;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,aAAa,CAAC;IAE7B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,eAAe,CAAC;IAEjC,gBAAgB,EAAE,MAAM,CAAC;CAC1B"}

package/dist/modules/rendering/AlignmentConfig.js

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

package/dist/modules/rendering/AlignmentConfig.js.map

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

package/dist/modules/rendering/BoxEdges.d.ts

@@ -0,0 +1,8 @@
+/** Per-side box lengths as CSS length tokens (`"0.5em"`, `"10px"`, `"2cqh"`, …). */
+export interface BoxEdges {
+    readonly top: string;
+    readonly right: string;
+    readonly bottom: string;
+    readonly left: string;
+}
+//# sourceMappingURL=BoxEdges.d.ts.map

package/dist/modules/rendering/BoxEdges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoxEdges.d.ts","sourceRoot":"","sources":["../../../src/modules/rendering/BoxEdges.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB"}

package/dist/modules/rendering/BoxEdges.js

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

package/dist/modules/rendering/BoxEdges.js.map

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

package/dist/modules/rendering/BrowserOverlayFrameRenderer.d.ts

@@ -0,0 +1,12 @@
+import type { OverlayFrame, OverlayFrameRenderer } from '../rendering/OverlayFrameRenderer';
+/**
+ * Renders an HTML snippet as a single SVG `foreignObject` and decodes it
+ * through an `<img>` so the resulting bitmap can be drawn into any 2D
+ * context, including OffscreenCanvas. The SVG-image sandbox keeps the
+ * downstream canvas untainted, which is what the export pipeline relies
+ * on.
+ */
+export declare class BrowserOverlayFrameRenderer implements OverlayFrameRenderer {
+    render(html: string, width: number, height: number): Promise<OverlayFrame>;
+}
+//# sourceMappingURL=BrowserOverlayFrameRenderer.d.ts.map

package/dist/modules/rendering/BrowserOverlayFrameRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserOverlayFrameRenderer.d.ts","sourceRoot":"","sources":["../../../src/modules/rendering/BrowserOverlayFrameRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACrB,MAAM,yCAAyC,CAAC;AAEjD;;;;;;GAMG;AACH,qBAAa,2BAA4B,YAAW,oBAAoB;IAEhE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CA0BjF"}

package/dist/modules/rendering/BrowserOverlayFrameRenderer.js

@@ -0,0 +1,31 @@
+/**
+ * Renders an HTML snippet as a single SVG `foreignObject` and decodes it
+ * through an `<img>` so the resulting bitmap can be drawn into any 2D
+ * context, including OffscreenCanvas. The SVG-image sandbox keeps the
+ * downstream canvas untainted, which is what the export pipeline relies
+ * on.
+ */
+export class BrowserOverlayFrameRenderer {
+    async render(html, width, height) {
+        const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}">
+  <foreignObject width="100%" height="100%">
+    <div xmlns="http://www.w3.org/1999/xhtml" style="position:relative;width:${width}px;height:${height}px;overflow:hidden;">${html}</div>
+  </foreignObject>
+</svg>`;
+        const img = new Image();
+        img.src = `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svg)}`;
+        // decode() resolves only after the image is fully parsed AND ready to
+        // paint. onload fires earlier — for SVG with foreignObject + custom
+        // fonts, that often races ahead of font/style application.
+        try {
+            await img.decode();
+        }
+        catch (e) {
+            throw new Error(`Overlay render failed: ${e instanceof Error ? e.message : String(e)}`, { cause: e });
+        }
+        return {
+            draw: (ctx, dx, dy, dWidth, dHeight) => ctx.drawImage(img, dx, dy, dWidth, dHeight),
+        };
+    }
+}
+//# sourceMappingURL=BrowserOverlayFrameRenderer.js.map

package/dist/modules/rendering/BrowserOverlayFrameRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserOverlayFrameRenderer.js","sourceRoot":"","sources":["../../../src/modules/rendering/BrowserOverlayFrameRenderer.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,MAAM,OAAO,2BAA2B;IAEtC,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,KAAa,EAAE,MAAc;QACtD,MAAM,GAAG,GAAG,kDAAkD,KAAK,aAAa,MAAM;;+EAEX,KAAK,aAAa,MAAM,wBAAwB,IAAI;;OAE5H,CAAC;QAEJ,MAAM,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,GAAG,CAAC,GAAG,GAAG,oCAAoC,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;QAExE,sEAAsE;QACtE,oEAAoE;QACpE,2DAA2D;QAC3D,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC;QACrB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,0BAA0B,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EACtE,EAAE,KAAK,EAAE,CAAC,EAAE,CACb,CAAC;QACJ,CAAC;QAED,OAAO;YACL,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC;SACpF,CAAC;IACJ,CAAC;CACF"}

package/dist/modules/rendering/BrowserSubtitleFrameRenderer.d.ts

@@ -0,0 +1,57 @@
+import type { SubtitleFrame, SubtitleFrameRenderer, SubtitleStyle } from '../rendering/SubtitleFrameRenderer';
+import type { Document } from '../document/Document';
+import type { CssResourceEmbedder } from '../css/CssResourceEmbedder';
+import type { WordSplitter } from '../splitting/WordSplitter';
+import type { VideoFrameSource } from '../rendering/VideoFrameSource';
+/**
+ * Browser-native `SubtitleFrameRenderer` that builds each batch as a
+ * single SVG holding one `foreignObject` per unique visual state, and
+ * decodes it through an `<img>` so the resulting bitmap paints into
+ * any 2D context — including OffscreenCanvas — without tainting the
+ * canvas.
+ *
+ * Inside a batch, timestamps that hit the same visual state collapse
+ * into a single sprite tile; tiles stack along the smaller dimension
+ * axis (portrait → row, landscape → column) so the sprite sheet stays
+ * under whatever sprite-length cap the host's 2D-canvas backend
+ * actually honors. That cap is probed empirically on first `open`
+ * — no public browser API surfaces it directly and reported
+ * limits (WebGL `MAX_TEXTURE_SIZE`, `MAX_VIEWPORT_DIMS`) bear no
+ * stable relationship to what `img.decode` / `drawImage` accept.
+ */
+export declare class BrowserSubtitleFrameRenderer implements SubtitleFrameRenderer {
+    private readonly cssEmbedder;
+    private readonly wordSplitter;
+    private readonly maxBufferPixels;
+    private session;
+    private readonly cssScoper;
+    private readonly cssMinifier;
+    private readonly svgFilterScoper;
+    private width;
+    private height;
+    /**
+     * @param cssEmbedder Inlines external resources (fonts, images)
+     *   referenced by each style's CSS so the resulting stylesheet is
+     *   self-contained inside the sandboxed render SVG.
+     * @param wordSplitter Splits words into letter units when a style's
+     *   `RenderingConfig.splitWordsIntoLetters` is set.
+     * @param maxBufferPixels Per-batch memory budget in pixels. With
+     *   the probed sprite-length cap, drives `getMaxBatchSize`. The
+     *   default sizes a batch to ~80 MB of pixel buffer.
+     */
+    constructor(cssEmbedder: CssResourceEmbedder, wordSplitter: WordSplitter, maxBufferPixels?: number);
+    open(doc: Document, styles: Readonly<Record<string, SubtitleStyle>>, width: number, height: number, videoFrameSource?: VideoFrameSource): Promise<void>;
+    getMaxBatchSize(): Promise<number>;
+    /**
+     * Renders a green field with a red 2×2 marker in the bottom-right
+     * corner at the target size, decodes it, paints it, and reads back
+     * the corner pixel. Some hosts decode oversize SVGs but leave the
+     * far edges of the raster blank — the readback catches that.
+     */
+    private testTileSize;
+    getFrames(timestamps: ReadonlyArray<number>): Promise<Array<SubtitleFrame | null>>;
+    getFrame(timestamp: number): Promise<SubtitleFrame | null>;
+    close(): void;
+    private prepareStyle;
+}
+//# sourceMappingURL=BrowserSubtitleFrameRenderer.d.ts.map

package/dist/modules/rendering/BrowserSubtitleFrameRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserSubtitleFrameRenderer.d.ts","sourceRoot":"","sources":["../../../src/modules/rendering/BrowserSubtitleFrameRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,aAAa,EACd,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAM3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,qCAAqC,CAAC;AA0E9F;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,4BAA6B,YAAW,qBAAqB;IAmBtE,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe;IApBlC,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;IACzD,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,MAAM,CAAqB;IAEnC;;;;;;;;;OASG;gBAEgB,WAAW,EAAE,mBAAmB,EAChC,YAAY,EAAE,YAAY,EAC1B,eAAe,GAAE,MAAkC;IAGhE,IAAI,CACR,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,EAC/C,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,OAAO,CAAC,IAAI,CAAC;IAuBV,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAoBxC;;;;;OAKG;YACW,YAAY;IAiBpB,SAAS,CACb,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,GAChC,OAAO,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAKjC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAMhE,KAAK,IAAI,IAAI;YAOC,YAAY;CAqC3B"}