@hyperframes/engine 0.1.2 → 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 HeyGen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/config.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Engine Configuration
+ *
+ * Typed configuration for the rendering pipeline. Replaces the PRODUCER_*
+ * env var sprawl with a structured interface. Env vars still work as
+ * fallbacks for backward compatibility during migration.
+ */
+/**
+ * Full engine configuration. All fields are wired through the config
+ * object; env vars serve as backward-compatible fallbacks resolved
+ * in `resolveConfig()`.
+ */
+export interface EngineConfig {
+    fps: 24 | 30 | 60;
+    quality: "draft" | "standard" | "high";
+    format: "jpeg" | "png";
+    jpegQuality: number;
+    /** Max worker count. "auto" uses CPU-based heuristic. */
+    concurrency: number | "auto";
+    /** CPU cores allocated per worker. */
+    coresPerWorker: number;
+    /** Minimum frames before parallel workers are used. */
+    minParallelFrames: number;
+    /** Frame count threshold for "large render" heuristics. */
+    largeRenderThreshold: number;
+    chromePath?: string;
+    disableGpu: boolean;
+    enableBrowserPool: boolean;
+    browserTimeout: number;
+    protocolTimeout: number;
+    /** Expected Chromium major version (optional validation). */
+    expectedChromiumMajor?: number;
+    /** Force screenshot capture mode (skip BeginFrame even on Linux). */
+    forceScreenshot: boolean;
+    enableChunkedEncode: boolean;
+    chunkSizeFrames: number;
+    enableStreamingEncode: boolean;
+    /** Timeout for FFmpeg frame encoding (ms). Default: 600_000 */
+    ffmpegEncodeTimeout: number;
+    /** Timeout for FFmpeg mux/faststart processes (ms). Default: 300_000 */
+    ffmpegProcessTimeout: number;
+    /** Timeout for FFmpeg streaming encode (ms). Default: 600_000 */
+    ffmpegStreamingTimeout: number;
+    audioGain: number;
+    frameDataUriCacheLimit: number;
+    playerReadyTimeout: number;
+    renderReadyTimeout: number;
+    /** Verify Hyperframe runtime SHA256 checksums. */
+    verifyRuntime: boolean;
+    /** Custom manifest path for Hyperframe runtime. */
+    runtimeManifestPath?: string;
+    debug: boolean;
+}
+/** Default configuration — sensible for Hyperframes compositions. */
+export declare const DEFAULT_CONFIG: EngineConfig;
+/**
+ * Resolve configuration by merging: defaults ← env vars ← explicit overrides.
+ * Env vars provide backward compatibility during migration; explicit config
+ * takes precedence over everything.
+ */
+export declare function resolveConfig(overrides?: Partial<EngineConfig>): EngineConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAE3B,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IAClB,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IACvC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IAGpB,yDAAyD;IACzD,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,oBAAoB,EAAE,MAAM,CAAC;IAG7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,qEAAqE;IACrE,eAAe,EAAE,OAAO,CAAC;IAGzB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,OAAO,CAAC;IAG/B,+DAA+D;IAC/D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wEAAwE;IACxE,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iEAAiE;IACjE,sBAAsB,EAAE,MAAM,CAAC;IAG/B,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB,EAAE,MAAM,CAAC;IAG/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAG3B,kDAAkD;IAClD,aAAa,EAAE,OAAO,CAAC;IACvB,mDAAmD;IACnD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAG7B,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,qEAAqE;AACrE,eAAO,MAAM,cAAc,EAAE,YAkC5B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAqF7E"}

package/dist/config.js

@@ -0,0 +1,92 @@
+/**
+ * Engine Configuration
+ *
+ * Typed configuration for the rendering pipeline. Replaces the PRODUCER_*
+ * env var sprawl with a structured interface. Env vars still work as
+ * fallbacks for backward compatibility during migration.
+ */
+/** Default configuration — sensible for Hyperframes compositions. */
+export const DEFAULT_CONFIG = {
+    fps: 30,
+    quality: "standard",
+    format: "jpeg",
+    jpegQuality: 80,
+    concurrency: "auto",
+    coresPerWorker: 2.5,
+    minParallelFrames: 120,
+    largeRenderThreshold: 1000,
+    disableGpu: false,
+    enableBrowserPool: false,
+    browserTimeout: 120_000,
+    protocolTimeout: 300_000,
+    forceScreenshot: false,
+    enableChunkedEncode: false,
+    chunkSizeFrames: 360,
+    enableStreamingEncode: false,
+    ffmpegEncodeTimeout: 600_000,
+    ffmpegProcessTimeout: 300_000,
+    ffmpegStreamingTimeout: 600_000,
+    audioGain: 1.35,
+    frameDataUriCacheLimit: 256,
+    playerReadyTimeout: 45_000,
+    renderReadyTimeout: 15_000,
+    verifyRuntime: true,
+    debug: false,
+};
+/**
+ * Resolve configuration by merging: defaults ← env vars ← explicit overrides.
+ * Env vars provide backward compatibility during migration; explicit config
+ * takes precedence over everything.
+ */
+export function resolveConfig(overrides) {
+    const env = (key) => process.env[key];
+    const envNum = (key, fallback) => {
+        const raw = env(key);
+        if (raw === undefined || raw === "")
+            return fallback;
+        const n = Number(raw);
+        return Number.isFinite(n) ? n : fallback;
+    };
+    const envBool = (key, fallback) => {
+        const raw = env(key);
+        if (raw === undefined)
+            return fallback;
+        return raw === "true";
+    };
+    // Env-var layer (backward compat)
+    const fromEnv = {
+        concurrency: env("PRODUCER_MAX_WORKERS") ? Number(env("PRODUCER_MAX_WORKERS")) : undefined,
+        coresPerWorker: envNum("PRODUCER_CORES_PER_WORKER", DEFAULT_CONFIG.coresPerWorker),
+        minParallelFrames: envNum("PRODUCER_MIN_PARALLEL_FRAMES", DEFAULT_CONFIG.minParallelFrames),
+        largeRenderThreshold: envNum("PRODUCER_LARGE_RENDER_THRESHOLD", DEFAULT_CONFIG.largeRenderThreshold),
+        chromePath: env("PRODUCER_HEADLESS_SHELL_PATH"),
+        disableGpu: envBool("PRODUCER_DISABLE_GPU", DEFAULT_CONFIG.disableGpu),
+        enableBrowserPool: envBool("PRODUCER_ENABLE_BROWSER_POOL", DEFAULT_CONFIG.enableBrowserPool),
+        browserTimeout: envNum("PRODUCER_PUPPETEER_LAUNCH_TIMEOUT_MS", DEFAULT_CONFIG.browserTimeout),
+        protocolTimeout: envNum("PRODUCER_PUPPETEER_PROTOCOL_TIMEOUT_MS", DEFAULT_CONFIG.protocolTimeout),
+        expectedChromiumMajor: env("PRODUCER_EXPECTED_CHROMIUM_MAJOR")
+            ? Number(env("PRODUCER_EXPECTED_CHROMIUM_MAJOR"))
+            : undefined,
+        forceScreenshot: envBool("PRODUCER_FORCE_SCREENSHOT", DEFAULT_CONFIG.forceScreenshot),
+        enableChunkedEncode: envBool("PRODUCER_ENABLE_CHUNKED_ENCODE", DEFAULT_CONFIG.enableChunkedEncode),
+        chunkSizeFrames: Math.max(120, envNum("PRODUCER_CHUNK_SIZE_FRAMES", DEFAULT_CONFIG.chunkSizeFrames)),
+        enableStreamingEncode: envBool("PRODUCER_ENABLE_STREAMING_ENCODE", DEFAULT_CONFIG.enableStreamingEncode),
+        ffmpegEncodeTimeout: envNum("FFMPEG_ENCODE_TIMEOUT_MS", DEFAULT_CONFIG.ffmpegEncodeTimeout),
+        ffmpegProcessTimeout: envNum("FFMPEG_PROCESS_TIMEOUT_MS", DEFAULT_CONFIG.ffmpegProcessTimeout),
+        ffmpegStreamingTimeout: envNum("FFMPEG_STREAMING_TIMEOUT_MS", DEFAULT_CONFIG.ffmpegStreamingTimeout),
+        audioGain: envNum("PRODUCER_AUDIO_GAIN", DEFAULT_CONFIG.audioGain),
+        frameDataUriCacheLimit: Math.max(32, envNum("PRODUCER_FRAME_DATA_URI_CACHE_LIMIT", DEFAULT_CONFIG.frameDataUriCacheLimit)),
+        playerReadyTimeout: envNum("PRODUCER_PLAYER_READY_TIMEOUT_MS", DEFAULT_CONFIG.playerReadyTimeout),
+        renderReadyTimeout: envNum("PRODUCER_RENDER_READY_TIMEOUT_MS", DEFAULT_CONFIG.renderReadyTimeout),
+        verifyRuntime: env("PRODUCER_VERIFY_HYPERFRAME_RUNTIME") !== "false",
+        runtimeManifestPath: env("PRODUCER_HYPERFRAME_MANIFEST_PATH"),
+    };
+    // Remove undefined values so they don't override defaults
+    const cleanEnv = Object.fromEntries(Object.entries(fromEnv).filter(([, v]) => v !== undefined));
+    return {
+        ...DEFAULT_CONFIG,
+        ...cleanEnv,
+        ...overrides,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @hyperframes/engine
+ *
+ * Seekable web page to video rendering engine.
+ * Framework-agnostic: works with GSAP, Lottie, Three.js, CSS animations,
+ * or any web content that implements the window.__hf seek protocol.
+ *
+ * ## Error Convention
+ *
+ * Engine services use three error strategies depending on the operation type:
+ *
+ * - **Orchestration services throw on failure.** Browser launch, session init,
+ *   frame capture, and CDP operations propagate errors as thrown exceptions.
+ *   Callers are expected to catch and handle (e.g. frameCapture, browserManager,
+ *   screenshotService, videoFrameExtractor.extractVideoFramesRange).
+ *
+ * - **FFmpeg process wrappers return `{ success, error? }` result objects.**
+ *   Encoding, muxing, audio mixing, and streaming encode operations never reject.
+ *   They resolve with a result that includes `success: boolean` and an optional
+ *   `error` string (e.g. chunkEncoder, audioMixer, streamingEncoder).
+ *
+ * - **Cleanup and teardown functions never throw.** Browser close, session close,
+ *   temp directory removal, and resource release swallow errors via `.catch(() => {})`
+ *   to avoid masking the original failure (e.g. releaseBrowser, closeCaptureSession,
+ *   FrameLookupTable.cleanup).
+ *
+ * - **Optional lookups return `T | undefined` or `T | null`.**
+ *   Functions that may legitimately find nothing (resolveHeadlessShellPath,
+ *   getFrameAtTime, detectGpuEncoder) return a nullable value instead of throwing.
+ *
+ */
+export type { HfProtocol, HfMediaElement, CaptureOptions, CaptureResult, CaptureBufferResult, CapturePerfSummary, } from "./types.js";
+export { resolveConfig, DEFAULT_CONFIG, type EngineConfig } from "./config.js";
+export { acquireBrowser, releaseBrowser, resolveHeadlessShellPath, buildChromeArgs, ENABLE_BROWSER_POOL, type BuildChromeArgsOptions, type CaptureMode, type AcquiredBrowser, } from "./services/browserManager.js";
+export { createCaptureSession, initializeSession, closeCaptureSession, captureFrame, captureFrameToBuffer, getCompositionDuration, getCapturePerfSummary, prepareCaptureSessionForReuse, type CaptureSession, type BeforeCaptureHook, } from "./services/frameCapture.js";
+export { beginFrameCapture, pageScreenshotCapture, getCdpSession, injectVideoFramesBatch, syncVideoFrameVisibility, cdpSessionCache, type BeginFrameResult, } from "./services/screenshotService.js";
+export { encodeFramesFromDir, encodeFramesChunkedConcat, muxVideoWithAudio, applyFaststart, detectGpuEncoder, ENCODER_PRESETS, type GpuEncoder, } from "./services/chunkEncoder.js";
+export type { EncoderOptions, EncodeResult, MuxResult } from "./services/chunkEncoder.types.js";
+export { spawnStreamingEncoder, createFrameReorderBuffer, type StreamingEncoder, type StreamingEncoderOptions, type StreamingEncoderResult, type FrameReorderBuffer, } from "./services/streamingEncoder.js";
+export { parseVideoElements, extractVideoFramesRange, extractAllVideoFrames, getFrameAtTime, createFrameLookupTable, FrameLookupTable, type VideoElement, type ExtractedFrames, type ExtractionOptions, type ExtractionResult, } from "./services/videoFrameExtractor.js";
+export { createVideoFrameInjector } from "./services/videoFrameInjector.js";
+export { parseAudioElements, processCompositionAudio } from "./services/audioMixer.js";
+export type { AudioElement, AudioTrack, MixResult } from "./services/audioMixer.types.js";
+export { calculateOptimalWorkers, distributeFrames, executeParallelCapture, mergeWorkerFrames, getSystemResources, type WorkerTask, type WorkerResult, type ParallelProgress, } from "./services/parallelCoordinator.js";
+export { createFileServer, type FileServerOptions, type FileServerHandle, } from "./services/fileServer.js";
+export { quantizeTimeToFrame, MEDIA_VISUAL_STYLE_PROPERTIES } from "@hyperframes/core";
+export { extractVideoMetadata, extractAudioMetadata, type VideoMetadata, type AudioMetadata, } from "./utils/ffprobe.js";
+export { downloadToTemp, isHttpUrl } from "./utils/urlDownloader.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,YAAY,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAG/E,OAAO,EACL,cAAc,EACd,cAAc,EACd,wBAAwB,EACxB,eAAe,EACf,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,6BAA6B,EAC7B,KAAK,cAAc,EACnB,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,sBAAsB,EACtB,wBAAwB,EACxB,eAAe,EACf,KAAK,gBAAgB,GACtB,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,KAAK,UAAU,GAChB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAEhG,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,GACxB,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,cAAc,EACd,sBAAsB,EACtB,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACvF,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAG1F,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,gBAAgB,GACtB,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EACL,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,mBAAmB,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAEvF,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,55 @@
+/**
+ * @hyperframes/engine
+ *
+ * Seekable web page to video rendering engine.
+ * Framework-agnostic: works with GSAP, Lottie, Three.js, CSS animations,
+ * or any web content that implements the window.__hf seek protocol.
+ *
+ * ## Error Convention
+ *
+ * Engine services use three error strategies depending on the operation type:
+ *
+ * - **Orchestration services throw on failure.** Browser launch, session init,
+ *   frame capture, and CDP operations propagate errors as thrown exceptions.
+ *   Callers are expected to catch and handle (e.g. frameCapture, browserManager,
+ *   screenshotService, videoFrameExtractor.extractVideoFramesRange).
+ *
+ * - **FFmpeg process wrappers return `{ success, error? }` result objects.**
+ *   Encoding, muxing, audio mixing, and streaming encode operations never reject.
+ *   They resolve with a result that includes `success: boolean` and an optional
+ *   `error` string (e.g. chunkEncoder, audioMixer, streamingEncoder).
+ *
+ * - **Cleanup and teardown functions never throw.** Browser close, session close,
+ *   temp directory removal, and resource release swallow errors via `.catch(() => {})`
+ *   to avoid masking the original failure (e.g. releaseBrowser, closeCaptureSession,
+ *   FrameLookupTable.cleanup).
+ *
+ * - **Optional lookups return `T | undefined` or `T | null`.**
+ *   Functions that may legitimately find nothing (resolveHeadlessShellPath,
+ *   getFrameAtTime, detectGpuEncoder) return a nullable value instead of throwing.
+ *
+ */
+// ── Configuration ──────────────────────────────────────────────────────────────
+export { resolveConfig, DEFAULT_CONFIG } from "./config.js";
+// ── Browser management ─────────────────────────────────────────────────────────
+export { acquireBrowser, releaseBrowser, resolveHeadlessShellPath, buildChromeArgs, ENABLE_BROWSER_POOL, } from "./services/browserManager.js";
+// ── Frame capture pipeline ──────────────────────────────────────────────────────
+export { createCaptureSession, initializeSession, closeCaptureSession, captureFrame, captureFrameToBuffer, getCompositionDuration, getCapturePerfSummary, prepareCaptureSessionForReuse, } from "./services/frameCapture.js";
+// ── Screenshot (BeginFrame) ─────────────────────────────────────────────────────
+export { beginFrameCapture, pageScreenshotCapture, getCdpSession, injectVideoFramesBatch, syncVideoFrameVisibility, cdpSessionCache, } from "./services/screenshotService.js";
+// ── Encoding ───────────────────────────────────────────────────────────────────
+export { encodeFramesFromDir, encodeFramesChunkedConcat, muxVideoWithAudio, applyFaststart, detectGpuEncoder, ENCODER_PRESETS, } from "./services/chunkEncoder.js";
+export { spawnStreamingEncoder, createFrameReorderBuffer, } from "./services/streamingEncoder.js";
+// ── Media processing ───────────────────────────────────────────────────────────
+export { parseVideoElements, extractVideoFramesRange, extractAllVideoFrames, getFrameAtTime, createFrameLookupTable, FrameLookupTable, } from "./services/videoFrameExtractor.js";
+export { createVideoFrameInjector } from "./services/videoFrameInjector.js";
+export { parseAudioElements, processCompositionAudio } from "./services/audioMixer.js";
+// ── Parallel rendering ─────────────────────────────────────────────────────────
+export { calculateOptimalWorkers, distributeFrames, executeParallelCapture, mergeWorkerFrames, getSystemResources, } from "./services/parallelCoordinator.js";
+// ── File server ────────────────────────────────────────────────────────────────
+export { createFileServer, } from "./services/fileServer.js";
+// ── Utilities ──────────────────────────────────────────────────────────────────
+export { quantizeTimeToFrame, MEDIA_VISUAL_STYLE_PROPERTIES } from "@hyperframes/core";
+export { extractVideoMetadata, extractAudioMetadata, } from "./utils/ffprobe.js";
+export { downloadToTemp, isHttpUrl } from "./utils/urlDownloader.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAYH,kFAAkF;AAClF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAqB,MAAM,aAAa,CAAC;AAE/E,kFAAkF;AAClF,OAAO,EACL,cAAc,EACd,cAAc,EACd,wBAAwB,EACxB,eAAe,EACf,mBAAmB,GAIpB,MAAM,8BAA8B,CAAC;AAEtC,mFAAmF;AACnF,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,6BAA6B,GAG9B,MAAM,4BAA4B,CAAC;AAEpC,mFAAmF;AACnF,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,sBAAsB,EACtB,wBAAwB,EACxB,eAAe,GAEhB,MAAM,iCAAiC,CAAC;AAEzC,kFAAkF;AAClF,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,eAAe,GAEhB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,qBAAqB,EACrB,wBAAwB,GAKzB,MAAM,gCAAgC,CAAC;AAExC,kFAAkF;AAClF,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,cAAc,EACd,sBAAsB,EACtB,gBAAgB,GAKjB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAGvF,kFAAkF;AAClF,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,GAInB,MAAM,mCAAmC,CAAC;AAE3C,kFAAkF;AAClF,OAAO,EACL,gBAAgB,GAGjB,MAAM,0BAA0B,CAAC;AAElC,kFAAkF;AAClF,OAAO,EAAE,mBAAmB,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAEvF,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAGrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/services/audioMixer.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Audio Mixer Service
+ *
+ * Processes and mixes audio tracks using FFmpeg.
+ */
+import { type EngineConfig } from "../config.js";
+import type { AudioElement, MixResult } from "./audioMixer.types.js";
+export type { AudioElement, AudioTrack, MixResult } from "./audioMixer.types.js";
+export declare function parseAudioElements(html: string): AudioElement[];
+export declare function processCompositionAudio(elements: AudioElement[], baseDir: string, workDir: string, outputPath: string, totalDuration: number, signal?: AbortSignal, config?: Partial<Pick<EngineConfig, "ffmpegProcessTimeout" | "audioGain">>): Promise<MixResult>;
+//# sourceMappingURL=audioMixer.d.ts.map

package/dist/services/audioMixer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioMixer.d.ts","sourceRoot":"","sources":["../../src/services/audioMixer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAc,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEjF,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AASjF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAuD/D;AA+ND,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,YAAY,EAAE,EACxB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,sBAAsB,GAAG,WAAW,CAAC,CAAC,GACzE,OAAO,CAAC,SAAS,CAAC,CA0GpB"}

package/dist/services/audioMixer.js

@@ -0,0 +1,327 @@
+/**
+ * Audio Mixer Service
+ *
+ * Processes and mixes audio tracks using FFmpeg.
+ */
+import { existsSync, mkdirSync, rmSync } from "fs";
+import { join, dirname } from "path";
+import { parseHTML } from "linkedom";
+import { extractAudioMetadata } from "../utils/ffprobe.js";
+import { downloadToTemp, isHttpUrl } from "../utils/urlDownloader.js";
+import { DEFAULT_CONFIG } from "../config.js";
+import { runFfmpeg } from "../utils/runFfmpeg.js";
+export function parseAudioElements(html) {
+    const elements = [];
+    const { document } = parseHTML(html);
+    // Parse <audio> elements
+    const audioEls = document.querySelectorAll("audio[id][src]");
+    for (const el of audioEls) {
+        const id = el.getAttribute("id");
+        const src = el.getAttribute("src");
+        if (!id || !src)
+            continue;
+        const startAttr = el.getAttribute("data-start");
+        const endAttr = el.getAttribute("data-end");
+        const mediaStartAttr = el.getAttribute("data-media-start");
+        const layerAttr = el.getAttribute("data-layer");
+        const volumeAttr = el.getAttribute("data-volume");
+        elements.push({
+            id,
+            src,
+            start: startAttr ? parseFloat(startAttr) : 0,
+            end: endAttr ? parseFloat(endAttr) : 0,
+            mediaStart: mediaStartAttr ? parseFloat(mediaStartAttr) : 0,
+            layer: layerAttr ? parseInt(layerAttr) : 0,
+            volume: volumeAttr ? parseFloat(volumeAttr) : 1.0,
+            type: "audio",
+        });
+    }
+    // Parse <video> elements with data-has-audio="true"
+    const videoEls = document.querySelectorAll('video[id][src][data-has-audio="true"]');
+    for (const el of videoEls) {
+        const id = el.getAttribute("id");
+        const src = el.getAttribute("src");
+        if (!id || !src)
+            continue;
+        const startAttr = el.getAttribute("data-start");
+        const endAttr = el.getAttribute("data-end");
+        const mediaStartAttr = el.getAttribute("data-media-start");
+        const layerAttr = el.getAttribute("data-layer");
+        const volumeAttr = el.getAttribute("data-volume");
+        elements.push({
+            id: `${id}-audio`,
+            src,
+            start: startAttr ? parseFloat(startAttr) : 0,
+            end: endAttr ? parseFloat(endAttr) : 0,
+            mediaStart: mediaStartAttr ? parseFloat(mediaStartAttr) : 0,
+            layer: layerAttr ? parseInt(layerAttr) : 0,
+            volume: volumeAttr ? parseFloat(volumeAttr) : 1.0,
+            type: "video",
+        });
+    }
+    return elements;
+}
+async function extractAudioFromVideo(videoPath, outputPath, options, signal, config) {
+    const ffmpegProcessTimeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG.ffmpegProcessTimeout;
+    const outputDir = dirname(outputPath);
+    if (!existsSync(outputDir))
+        mkdirSync(outputDir, { recursive: true });
+    const args = ["-i", videoPath];
+    if (options?.startTime !== undefined)
+        args.push("-ss", String(options.startTime));
+    if (options?.duration !== undefined)
+        args.push("-t", String(options.duration));
+    args.push("-vn", "-acodec", "pcm_s16le", "-ar", "48000", "-ac", "2", "-y", outputPath);
+    const result = await runFfmpeg(args, { signal, timeout: ffmpegProcessTimeout });
+    if (signal?.aborted) {
+        return {
+            success: false,
+            outputPath,
+            durationMs: result.durationMs,
+            error: "Audio extract cancelled",
+        };
+    }
+    if (!result.success) {
+        return {
+            success: false,
+            outputPath,
+            durationMs: result.durationMs,
+            error: result.exitCode !== null ? `FFmpeg exited with code ${result.exitCode}` : result.stderr,
+        };
+    }
+    return { success: true, outputPath, durationMs: result.durationMs };
+}
+async function prepareAudioTrack(srcPath, outputPath, mediaStart, duration, signal, config) {
+    const ffmpegProcessTimeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG.ffmpegProcessTimeout;
+    const outputDir = dirname(outputPath);
+    if (!existsSync(outputDir))
+        mkdirSync(outputDir, { recursive: true });
+    const args = [
+        "-ss",
+        String(mediaStart),
+        "-t",
+        String(duration),
+        "-i",
+        srcPath,
+        "-acodec",
+        "pcm_s16le",
+        "-ar",
+        "48000",
+        "-ac",
+        "2",
+        "-y",
+        outputPath,
+    ];
+    const result = await runFfmpeg(args, { signal, timeout: ffmpegProcessTimeout });
+    if (signal?.aborted) {
+        return {
+            success: false,
+            outputPath,
+            durationMs: result.durationMs,
+            error: "Audio prepare cancelled",
+        };
+    }
+    return {
+        success: result.success,
+        outputPath,
+        durationMs: result.durationMs,
+        error: !result.success
+            ? result.exitCode !== null
+                ? `FFmpeg exited with code ${result.exitCode}: ${result.stderr.slice(-200)}`
+                : result.stderr
+            : undefined,
+    };
+}
+async function generateSilence(outputPath, duration, signal, config) {
+    const ffmpegProcessTimeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG.ffmpegProcessTimeout;
+    const outputDir = dirname(outputPath);
+    if (!existsSync(outputDir))
+        mkdirSync(outputDir, { recursive: true });
+    const args = [
+        "-f",
+        "lavfi",
+        "-i",
+        "anullsrc=r=48000:cl=stereo",
+        "-t",
+        String(duration),
+        "-acodec",
+        "pcm_s16le",
+        "-y",
+        outputPath,
+    ];
+    const result = await runFfmpeg(args, { signal, timeout: ffmpegProcessTimeout });
+    if (signal?.aborted) {
+        return {
+            success: false,
+            outputPath,
+            durationMs: result.durationMs,
+            error: "Silence generation cancelled",
+        };
+    }
+    return {
+        success: result.success,
+        outputPath,
+        durationMs: result.durationMs,
+        error: !result.success
+            ? result.exitCode !== null
+                ? `FFmpeg exited with code ${result.exitCode}`
+                : result.stderr
+            : undefined,
+    };
+}
+async function mixAudioTracks(tracks, outputPath, totalDuration, signal, config) {
+    const ffmpegProcessTimeout = config?.ffmpegProcessTimeout ?? DEFAULT_CONFIG.ffmpegProcessTimeout;
+    const masterOutputGain = config?.audioGain ?? DEFAULT_CONFIG.audioGain;
+    if (tracks.length === 0) {
+        const result = await generateSilence(outputPath, totalDuration, signal, config);
+        return {
+            success: result.success,
+            outputPath,
+            durationMs: result.durationMs,
+            tracksProcessed: 0,
+            error: result.error,
+        };
+    }
+    const outputDir = dirname(outputPath);
+    if (!existsSync(outputDir))
+        mkdirSync(outputDir, { recursive: true });
+    const inputs = [];
+    const filterParts = [];
+    tracks.forEach((track, i) => {
+        inputs.push("-i", track.srcPath);
+        const delayMs = Math.round(track.start * 1000);
+        const trimDuration = track.end - track.start;
+        filterParts.push(`[${i}:a]atrim=0:${trimDuration},volume=${track.volume},adelay=${delayMs}|${delayMs},apad=whole_dur=${totalDuration}[a${i}]`);
+    });
+    const mixInputs = tracks.map((_, i) => `[a${i}]`).join("");
+    const weights = tracks.map(() => "1").join(" ");
+    const mixFilter = `${mixInputs}amix=inputs=${tracks.length}:duration=longest:dropout_transition=0:normalize=0:weights='${weights}'[mixed]`;
+    const postMixGainFilter = `[mixed]volume=${masterOutputGain}[out]`;
+    const fullFilter = [...filterParts, mixFilter, postMixGainFilter].join(";");
+    const args = [
+        ...inputs,
+        "-filter_complex",
+        fullFilter,
+        "-map",
+        "[out]",
+        "-acodec",
+        "aac",
+        "-b:a",
+        "192k",
+        "-t",
+        String(totalDuration),
+        "-y",
+        outputPath,
+    ];
+    const result = await runFfmpeg(args, { signal, timeout: ffmpegProcessTimeout });
+    if (signal?.aborted) {
+        return {
+            success: false,
+            outputPath,
+            durationMs: result.durationMs,
+            tracksProcessed: 0,
+            error: "Audio mix cancelled",
+        };
+    }
+    if (!result.success) {
+        return {
+            success: false,
+            outputPath,
+            durationMs: result.durationMs,
+            tracksProcessed: 0,
+            error: result.exitCode !== null ? `FFmpeg exited with code ${result.exitCode}` : result.stderr,
+        };
+    }
+    return {
+        success: true,
+        outputPath,
+        durationMs: result.durationMs,
+        tracksProcessed: tracks.length,
+    };
+}
+export async function processCompositionAudio(elements, baseDir, workDir, outputPath, totalDuration, signal, config) {
+    const startMs = Date.now();
+    const tracks = [];
+    const errors = [];
+    if (!existsSync(workDir))
+        mkdirSync(workDir, { recursive: true });
+    await Promise.all(elements.map(async (element) => {
+        if (signal?.aborted) {
+            errors.push(`Cancelled: ${element.id}`);
+            return;
+        }
+        try {
+            let srcPath = element.src;
+            if (!srcPath.startsWith("/") && !isHttpUrl(srcPath)) {
+                srcPath = join(baseDir, srcPath);
+            }
+            if (isHttpUrl(srcPath)) {
+                try {
+                    srcPath = await downloadToTemp(srcPath, workDir);
+                }
+                catch (err) {
+                    errors.push(`Download failed: ${element.id} — ${err instanceof Error ? err.message : String(err)}`);
+                    return;
+                }
+            }
+            if (!existsSync(srcPath)) {
+                errors.push(`Source not found: ${element.id}`);
+                return;
+            }
+            // Fallback: if no duration was specified, probe the actual file
+            if (element.end - element.start <= 0) {
+                const metadata = await extractAudioMetadata(srcPath);
+                const effectiveDuration = metadata.durationSeconds - element.mediaStart;
+                element.end =
+                    element.start + (effectiveDuration > 0 ? effectiveDuration : metadata.durationSeconds);
+            }
+            let audioSrcPath = srcPath;
+            if (element.type === "video") {
+                const extractedPath = join(workDir, `${element.id}-extracted.wav`);
+                const extractResult = await extractAudioFromVideo(srcPath, extractedPath, {
+                    startTime: element.mediaStart,
+                    duration: element.end - element.start,
+                }, signal, config);
+                if (!extractResult.success) {
+                    errors.push(`Extract failed: ${element.id}`);
+                    return;
+                }
+                audioSrcPath = extractedPath;
+            }
+            else {
+                const trimmedPath = join(workDir, `${element.id}-trimmed.wav`);
+                const prepResult = await prepareAudioTrack(srcPath, trimmedPath, element.mediaStart, element.end - element.start, signal, config);
+                if (!prepResult.success) {
+                    errors.push(`Prepare failed: ${element.id}`);
+                    return;
+                }
+                audioSrcPath = trimmedPath;
+            }
+            tracks.push({
+                id: element.id,
+                srcPath: audioSrcPath,
+                start: element.start,
+                end: element.end,
+                mediaStart: element.mediaStart,
+                duration: element.end - element.start,
+                volume: element.volume || 1.0,
+            });
+        }
+        catch (err) {
+            errors.push(`Error: ${element.id} — ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }));
+    const mixResult = await mixAudioTracks(tracks, outputPath, totalDuration, signal, config);
+    try {
+        rmSync(workDir, { recursive: true, force: true });
+    }
+    catch {
+        /* ignore */
+    }
+    return {
+        ...mixResult,
+        durationMs: Date.now() - startMs,
+        error: errors.length > 0 ? `Warnings: ${errors.join(", ")}` : mixResult.error,
+    };
+}
+//# sourceMappingURL=audioMixer.js.map