@kitsra/kavio-render 0.1.0

package/LICENSE

@@ -0,0 +1,94 @@
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other
+notices of the licensor in the software. Any use of the licensor's trademarks
+is subject to applicable law.
+
+Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software.
+
+If you or your company make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license for the software
+granted under these terms ends immediately. If your company makes such a claim,
+your patent license ends immediately for work on behalf of your company.
+
+Notices
+
+You must ensure that anyone who gets a copy of any part of the software from
+you also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+No Liability
+
+As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.
+
+Definitions
+
+The licensor is the entity offering these terms, and the software is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+you refers to the individual or entity agreeing to these terms.
+
+your company is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that organization.
+control means ownership of substantially all the assets of an entity, or the
+power to direct its management and policies by vote, contract, or otherwise.
+Control can be direct or indirect.
+
+your licenses are all the licenses granted to you for the software under these
+terms.
+
+use means anything you do with the software requiring one of your licenses.
+
+trademark means trademarks, service marks, and similar rights.

package/dist/assemble-command.d.ts

@@ -0,0 +1,19 @@
+import type { KavioDocument, KavioExportPreset } from "@kitsra/kavio-schema";
+export interface AssembleRenderCommandOptions {
+    /** Composition with props resolved and the export preset already applied. */
+    view: KavioDocument;
+    preset: KavioExportPreset;
+    /** printf-style path to the captured transparent overlay frames, e.g. work/overlay-%05d.png */
+    framePattern: string;
+    /** Output file path. Defaults to `<preset.name>.<ext>`. */
+    outputPath?: string;
+}
+/**
+ * Fuse the FFmpeg planner's base-video, overlay, and audio-mix pieces into a single
+ * runnable `ffmpeg` argument list. Pure: no IO, no process spawning.
+ *
+ * Hybrid (source-video base) and graphics-only (generated color base) differ only
+ * in how the base stream is produced; everything downstream is identical.
+ */
+export declare function assembleRenderCommand(options: AssembleRenderCommandOptions): string[];
+//# sourceMappingURL=assemble-command.d.ts.map

package/dist/assemble-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assemble-command.d.ts","sourceRoot":"","sources":["../src/assemble-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,aAAa,EACb,iBAAiB,EAGlB,MAAM,sBAAsB,CAAC;AAY9B,MAAM,WAAW,4BAA4B;IAC3C,6EAA6E;IAC7E,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,+FAA+F;IAC/F,YAAY,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,MAAM,EAAE,CA2ErF"}

package/dist/assemble-command.js

@@ -0,0 +1,197 @@
+import { extensionForFormat } from "@kitsra/kavio-schema";
+import { buildFilterComplexArgs, planAudioMix, planBaseVideoSequence, planOverlayCompositing } from "@kitsra/kavio-ffmpeg";
+import { renderError } from "./errors.js";
+import { audioEncoder, defaultAudioCodec, defaultVideoCodec, pixelFormat, videoEncoder } from "./encoding.js";
+const VIDEO_OUT_LABEL = "video_out";
+const AUDIO_OUT_LABEL = "audio_out";
+const BASE_LABEL = "base_video";
+/**
+ * Fuse the FFmpeg planner's base-video, overlay, and audio-mix pieces into a single
+ * runnable `ffmpeg` argument list. Pure: no IO, no process spawning.
+ *
+ * Hybrid (source-video base) and graphics-only (generated color base) differ only
+ * in how the base stream is produced; everything downstream is identical.
+ */
+export function assembleRenderCommand(options) {
+    const { view, preset, framePattern } = options;
+    const fps = preset.fps ?? view.composition.fps;
+    const width = preset.width;
+    const height = preset.height;
+    const background = preset.background ?? view.composition.background ?? "black";
+    const outputPath = options.outputPath ?? `${preset.name}.${extensionForFormat(preset.format)}`;
+    const durationSeconds = view.composition.durationFrames / fps;
+    const inputArgs = [];
+    const chains = [];
+    let inputIndex = 0;
+    // --- Base video: source clips, or a synthesized color background --------
+    const videoLayers = view.layers.filter((layer) => layer.type === "video");
+    let baseLabel;
+    if (videoLayers.length > 0) {
+        const segments = videoLayers.map((layer, index) => baseSegment(view, layer, { width, height }, fps, inputIndex + index, background));
+        const basePlan = planBaseVideoSequence({ segments, outputLabel: BASE_LABEL });
+        inputArgs.push(...planInputArgs(basePlan));
+        chains.push(...planFilterChains(basePlan));
+        inputIndex += segments.length;
+        baseLabel = BASE_LABEL;
+    }
+    else {
+        inputArgs.push("-f", "lavfi", "-i", `color=c=${escapeLavfi(background)}:s=${width}x${height}:r=${fps}:d=${formatSeconds(durationSeconds)}`);
+        baseLabel = `${inputIndex}:v`;
+        inputIndex += 1;
+    }
+    // --- Transparent overlay frame sequence ---------------------------------
+    const overlayPlan = planOverlayCompositing({
+        baseLabel,
+        frames: { framePattern, fps, inputIndex, startNumber: 0, outputLabel: "overlay_frames" },
+        outputLabel: VIDEO_OUT_LABEL,
+        shortest: true
+    });
+    inputArgs.push(...planInputArgs(overlayPlan));
+    chains.push(...planFilterChains(overlayPlan));
+    inputIndex += 1;
+    // --- Audio: mix declared tracks, or synthesize silence ------------------
+    const audioTracks = view.audio ?? [];
+    if (audioTracks.length > 0) {
+        const trackOptions = audioTracks.map((track, index) => audioOption(view, track, inputIndex + index));
+        const audioPlan = planAudioMix({ tracks: trackOptions, fps, outputLabel: AUDIO_OUT_LABEL, normalizeLoudness: true });
+        inputArgs.push(...planInputArgs(audioPlan));
+        chains.push(...planFilterChains(audioPlan));
+        inputIndex += trackOptions.length;
+    }
+    else {
+        inputArgs.push("-f", "lavfi", "-i", "anullsrc=channel_layout=stereo:sample_rate=48000");
+        chains.push(silentAudioChain(inputIndex));
+        inputIndex += 1;
+    }
+    return [
+        "-y",
+        ...inputArgs,
+        ...buildFilterComplexArgs(chains),
+        "-map",
+        `[${VIDEO_OUT_LABEL}]`,
+        "-map",
+        `[${AUDIO_OUT_LABEL}]`,
+        ...encodeArgs(preset, fps),
+        "-t",
+        formatSeconds(durationSeconds),
+        outputPath
+    ];
+}
+function baseSegment(view, layer, output, fps, inputIndex, background) {
+    const asset = videoAsset(view, layer.asset, layer.id);
+    const segment = {
+        asset: {
+            src: asset.src,
+            trimStartFrames: asset.trimStartFrames ?? 0,
+            trimEndFrames: asset.trimEndFrames ?? null,
+            loop: asset.loop ?? false
+        },
+        layer: {
+            id: layer.id,
+            asset: layer.asset,
+            durationFrames: layer.durationFrames,
+            fit: layer.fit ?? "cover",
+            ...(layer.crop === undefined ? {} : { crop: layer.crop }),
+            playbackRate: layer.playbackRate ?? 1
+        },
+        output,
+        fps,
+        inputIndex,
+        background
+    };
+    return segment;
+}
+function audioOption(view, track, inputIndex) {
+    const asset = audioAsset(view, track.asset);
+    return {
+        asset: {
+            src: asset.src,
+            trimStartFrames: asset.trimStartFrames ?? 0,
+            trimEndFrames: asset.trimEndFrames ?? null,
+            loop: asset.loop ?? false
+        },
+        track,
+        inputIndex
+    };
+}
+function silentAudioChain(inputIndex) {
+    return {
+        inputLabels: [`${inputIndex}:a`],
+        filters: ["anull"],
+        outputLabel: AUDIO_OUT_LABEL,
+        expression: `[${inputIndex}:a]anull[${AUDIO_OUT_LABEL}]`
+    };
+}
+function encodeArgs(preset, fps) {
+    const codec = preset.codec ?? defaultVideoCodec(preset.format);
+    const args = [
+        "-c:v",
+        videoEncoder(codec),
+        "-crf",
+        String(preset.crf ?? 18),
+        "-pix_fmt",
+        pixelFormat(codec),
+        "-r",
+        String(fps),
+        "-c:a",
+        audioEncoder(preset.audioCodec ?? defaultAudioCodec(preset.format)),
+        "-b:a",
+        preset.audioBitrate ?? "192k"
+    ];
+    if (preset.format === "mp4" || preset.format === "mov") {
+        args.push("-movflags", "+faststart");
+    }
+    return args;
+}
+function planInputArgs(plan) {
+    return plan.steps.filter((step) => step.kind === "input").flatMap((step) => step.args);
+}
+function planFilterChains(plan) {
+    const chains = [];
+    for (const step of plan.steps) {
+        if (step.kind === "filter") {
+            chains.push(...step.chains);
+        }
+    }
+    return chains;
+}
+function videoAsset(view, id, layerId) {
+    const asset = view.assets[id];
+    if (asset === undefined || asset.type !== "video") {
+        throw renderError({
+            code: "ASSET_UNSUPPORTED",
+            stage: "render",
+            message: `Video layer "${layerId}" references missing or non-video asset "${id}".`,
+            path: `assets.${id}`
+        });
+    }
+    return asset;
+}
+function audioAsset(view, id) {
+    const asset = view.assets[id];
+    if (asset === undefined || asset.type !== "audio") {
+        throw renderError({
+            code: "ASSET_UNSUPPORTED",
+            stage: "render",
+            message: `Audio track references missing or non-audio asset "${id}".`,
+            path: `assets.${id}`
+        });
+    }
+    return asset;
+}
+function escapeLavfi(value) {
+    return value
+        .replace(/\\/g, "\\\\")
+        .replace(/'/g, "\\'")
+        .replace(/:/g, "\\:")
+        .replace(/\[/g, "\\[")
+        .replace(/\]/g, "\\]")
+        .replace(/,/g, "\\,")
+        .replace(/;/g, "\\;");
+}
+function formatSeconds(seconds) {
+    if (Number.isInteger(seconds)) {
+        return String(seconds);
+    }
+    return seconds.toFixed(6).replace(/0+$/, "").replace(/\.$/, "");
+}

package/dist/binaries.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Resolve the path to the bundled FFmpeg binary (`ffmpeg-static`) or fall back to
+ * a system `ffmpeg` command available on the PATH. Throws a structured
+ * `BINARY_MISSING` error when neither is available.
+ */
+export declare function resolveFfmpegPath(): Promise<string>;
+//# sourceMappingURL=binaries.d.ts.map

package/dist/binaries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binaries.d.ts","sourceRoot":"","sources":["../src/binaries.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAkCzD"}

package/dist/binaries.js

@@ -0,0 +1,50 @@
+import { stat } from "node:fs/promises";
+import { renderError } from "./errors.js";
+import { execSync } from "node:child_process";
+/**
+ * Resolve the path to the bundled FFmpeg binary (`ffmpeg-static`) or fall back to
+ * a system `ffmpeg` command available on the PATH. Throws a structured
+ * `BINARY_MISSING` error when neither is available.
+ */
+export async function resolveFfmpegPath() {
+    // 1. Try resolving system ffmpeg from the environment PATH
+    try {
+        const systemPath = execSync("which ffmpeg", { stdio: ["ignore", "pipe", "ignore"] })
+            .toString()
+            .trim();
+        if (systemPath.length > 0) {
+            await stat(systemPath);
+            return systemPath;
+        }
+    }
+    catch {
+        // Fall back to ffmpeg-static if system ffmpeg is missing
+    }
+    // 2. Try resolving bundled ffmpeg-static
+    let resolved;
+    try {
+        const mod = (await import("ffmpeg-static"));
+        resolved = mod.default ?? mod;
+    }
+    catch {
+        throw missingFfmpeg();
+    }
+    if (typeof resolved !== "string" || resolved.length === 0) {
+        throw missingFfmpeg();
+    }
+    try {
+        await stat(resolved);
+    }
+    catch {
+        throw missingFfmpeg();
+    }
+    return resolved;
+}
+function missingFfmpeg() {
+    return renderError({
+        code: "BINARY_MISSING",
+        stage: "ffmpeg",
+        message: "Bundled or system FFmpeg is not available.",
+        hint: "Install a system ffmpeg or install render binaries with 'corepack pnpm run install:render-binaries'."
+    });
+}

package/dist/encoding.d.ts

@@ -0,0 +1,8 @@
+import type { KavioAudioCodec, KavioExportCodec, KavioExportFormat, KavioExportPreset } from "@kitsra/kavio-schema";
+export declare function withEffectiveCodecs(preset: KavioExportPreset): KavioExportPreset;
+export declare function defaultVideoCodec(format: KavioExportFormat): KavioExportCodec;
+export declare function defaultAudioCodec(format: KavioExportFormat): KavioAudioCodec;
+export declare function videoEncoder(codec: KavioExportCodec): string;
+export declare function audioEncoder(codec: KavioAudioCodec): string;
+export declare function pixelFormat(codec: KavioExportCodec): string;
+//# sourceMappingURL=encoding.d.ts.map

package/dist/encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../src/encoding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAE9B,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,CAMhF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,gBAAgB,CAW7E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,eAAe,CAU5E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAW5D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAW3D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAS3D"}

package/dist/encoding.js

@@ -0,0 +1,64 @@
+export function withEffectiveCodecs(preset) {
+    return {
+        ...preset,
+        codec: preset.codec ?? defaultVideoCodec(preset.format),
+        audioCodec: preset.audioCodec ?? defaultAudioCodec(preset.format)
+    };
+}
+export function defaultVideoCodec(format) {
+    switch (format) {
+        case "webm":
+            return "vp9";
+        case "mov":
+            return "prores";
+        case "mp4":
+        case "gif":
+        case "png-sequence":
+            return "h264";
+    }
+}
+export function defaultAudioCodec(format) {
+    switch (format) {
+        case "webm":
+            return "opus";
+        case "mp4":
+        case "mov":
+        case "gif":
+        case "png-sequence":
+            return "aac";
+    }
+}
+export function videoEncoder(codec) {
+    switch (codec) {
+        case "hevc":
+            return "libx265";
+        case "vp9":
+            return "libvpx-vp9";
+        case "prores":
+            return "prores_ks";
+        case "h264":
+            return "libx264";
+    }
+}
+export function audioEncoder(codec) {
+    switch (codec) {
+        case "opus":
+            return "libopus";
+        case "mp3":
+            return "libmp3lame";
+        case "pcm":
+            return "pcm_s16le";
+        case "aac":
+            return "aac";
+    }
+}
+export function pixelFormat(codec) {
+    switch (codec) {
+        case "prores":
+            return "yuv422p10le";
+        case "vp9":
+        case "hevc":
+        case "h264":
+            return "yuv420p";
+    }
+}

package/dist/errors.d.ts

@@ -0,0 +1,14 @@
+import type { KavioError, KavioErrorStage } from "@kitsra/kavio-schema";
+export declare const RENDER_ERROR_CODES: readonly ["BINARY_MISSING", "BINARY_INCOMPATIBLE", "ASSET_FETCH_FAILED", "ASSET_UNSUPPORTED", "RENDER_FRAME_FAILED", "RENDER_TIMEOUT", "RENDER_CANCELLED", "RENDER_FAILED", "FFMPEG_FAILED", "FFMPEG_TIMEOUT", "IO_WRITE_FAILED", "IO_TEMP_FAILED"];
+export type RenderErrorCode = (typeof RENDER_ERROR_CODES)[number];
+export interface RenderErrorOptions {
+    code: RenderErrorCode;
+    stage: KavioErrorStage;
+    message: string;
+    path?: string;
+    hint?: string;
+    retryable?: boolean;
+}
+export declare function renderError(options: RenderErrorOptions): KavioError;
+export declare function isRenderError(value: unknown): value is KavioError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAExE,eAAO,MAAM,kBAAkB,qPAarB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,UAAU,CAenE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAOjE"}

package/dist/errors.js

@@ -0,0 +1,34 @@
+export const RENDER_ERROR_CODES = [
+    "BINARY_MISSING",
+    "BINARY_INCOMPATIBLE",
+    "ASSET_FETCH_FAILED",
+    "ASSET_UNSUPPORTED",
+    "RENDER_FRAME_FAILED",
+    "RENDER_TIMEOUT",
+    "RENDER_CANCELLED",
+    "RENDER_FAILED",
+    "FFMPEG_FAILED",
+    "FFMPEG_TIMEOUT",
+    "IO_WRITE_FAILED",
+    "IO_TEMP_FAILED"
+];
+export function renderError(options) {
+    const error = {
+        code: options.code,
+        severity: "error",
+        message: options.message,
+        path: options.path ?? "",
+        stage: options.stage,
+        retryable: options.retryable ?? false
+    };
+    if (options.hint !== undefined) {
+        error.hint = options.hint;
+    }
+    return error;
+}
+export function isRenderError(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        typeof value.code === "string" &&
+        typeof value.stage === "string");
+}

package/dist/ffmpeg-runner.d.ts

@@ -0,0 +1,28 @@
+export interface FfmpegChildStream {
+    on(event: "data", listener: (chunk: unknown) => void): void;
+}
+export interface FfmpegChildProcess {
+    stdout: FfmpegChildStream | null;
+    stderr: FfmpegChildStream | null;
+    on(event: "error", listener: (error: Error) => void): void;
+    on(event: "close", listener: (code: number | null) => void): void;
+    kill(signal?: string): void;
+}
+export type FfmpegSpawn = (command: string, args: readonly string[]) => FfmpegChildProcess;
+export interface FfmpegRunOptions {
+    onProgress?: (chunk: string) => void;
+    signal?: AbortSignal;
+}
+export interface FfmpegRunResult {
+    code: number;
+    stderr: string;
+}
+export interface FfmpegRunner {
+    run(args: readonly string[], options?: FfmpegRunOptions): Promise<FfmpegRunResult>;
+}
+export interface CreateFfmpegRunnerOptions {
+    spawn?: FfmpegSpawn;
+    resolveBinary?: () => string | Promise<string>;
+}
+export declare function createFfmpegRunner(options?: CreateFfmpegRunnerOptions): FfmpegRunner;
+//# sourceMappingURL=ffmpeg-runner.d.ts.map

package/dist/ffmpeg-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffmpeg-runner.d.ts","sourceRoot":"","sources":["../src/ffmpeg-runner.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;CAC7D;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3D,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI,CAAC;IAClE,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,kBAAkB,CAAC;AAE3F,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACpF;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAChD;AAID,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,YAAY,CA2ExF"}

package/dist/ffmpeg-runner.js

@@ -0,0 +1,75 @@
+import { resolveFfmpegPath } from "./binaries.js";
+import { renderError } from "./errors.js";
+const STDERR_TAIL_LENGTH = 800;
+export function createFfmpegRunner(options = {}) {
+    return {
+        async run(args, runOptions = {}) {
+            const spawn = options.spawn ?? (await defaultSpawn());
+            const binary = await (options.resolveBinary ?? resolveFfmpegPath)();
+            return await new Promise((resolve, reject) => {
+                const signal = runOptions.signal;
+                if (signal?.aborted === true) {
+                    reject(cancelledError());
+                    return;
+                }
+                const child = spawn(binary, args);
+                let stderr = "";
+                let settled = false;
+                const settle = (action) => {
+                    if (settled) {
+                        return;
+                    }
+                    settled = true;
+                    if (signal !== undefined) {
+                        signal.removeEventListener("abort", onAbort);
+                    }
+                    action();
+                };
+                function onAbort() {
+                    child.kill("SIGKILL");
+                    settle(() => reject(cancelledError()));
+                }
+                if (signal !== undefined) {
+                    signal.addEventListener("abort", onAbort);
+                }
+                child.stderr?.on("data", (chunk) => {
+                    stderr = `${stderr}${String(chunk)}`.slice(-STDERR_TAIL_LENGTH);
+                });
+                if (runOptions.onProgress !== undefined) {
+                    const onProgress = runOptions.onProgress;
+                    child.stdout?.on("data", (chunk) => onProgress(String(chunk)));
+                }
+                child.on("error", (error) => {
+                    settle(() => reject(renderError({
+                        code: "FFMPEG_FAILED",
+                        stage: "ffmpeg",
+                        message: `Failed to start ffmpeg: ${error.message}`
+                    })));
+                });
+                child.on("close", (code) => {
+                    settle(() => {
+                        if (code === 0) {
+                            resolve({ code: 0, stderr });
+                            return;
+                        }
+                        const message = `ffmpeg exited with code ${code ?? "unknown"}.`;
+                        reject(stderr.length > 0
+                            ? renderError({ code: "FFMPEG_FAILED", stage: "ffmpeg", message, hint: stderr })
+                            : renderError({ code: "FFMPEG_FAILED", stage: "ffmpeg", message }));
+                    });
+                });
+            });
+        }
+    };
+}
+function cancelledError() {
+    return renderError({
+        code: "RENDER_CANCELLED",
+        stage: "ffmpeg",
+        message: "Render cancelled before ffmpeg completed."
+    });
+}
+async function defaultSpawn() {
+    const childProcess = await import("node:child_process");
+    return (command, args) => childProcess.spawn(command, [...args]);
+}

package/dist/harness-server.d.ts

@@ -0,0 +1,15 @@
+import type { KavioDocument } from "@kitsra/kavio-schema";
+export interface RenderHarnessServer {
+    url: string;
+    close(): Promise<void>;
+}
+export interface CreateRenderHarnessServerOptions {
+    composition: KavioDocument;
+}
+/**
+ * Tiny localhost static server that feeds the headless render harness page to
+ * Chromium: the shared harness HTML, `/composition.json`, and the vendored
+ * `@kitsra/kavio-core` and `@kitsra/kavio-browser-renderer` ESM bundles.
+ */
+export declare function createRenderHarnessServer(options: CreateRenderHarnessServerOptions): Promise<RenderHarnessServer>;
+//# sourceMappingURL=harness-server.d.ts.map

package/dist/harness-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-server.d.ts","sourceRoot":"","sources":["../src/harness-server.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAwB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEhF,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,gCAAgC;IAC/C,WAAW,EAAE,aAAa,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,mBAAmB,CAAC,CA0B9B"}