@hyperframes/producer 0.1.0 → 0.1.1

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/benchmark.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env tsx
+/**
+ * Render Benchmark
+ *
+ * Runs each test fixture multiple times and records per-stage timing.
+ * Results are saved to producer/tests/perf/benchmark-results.json.
+ *
+ * Usage:
+ *   pnpm benchmark                    # 3 runs per fixture (default)
+ *   pnpm benchmark -- --runs 5        # 5 runs per fixture
+ *   pnpm benchmark -- --only chat     # single fixture
+ *   pnpm benchmark -- --exclude-tags slow
+ */
+export {};
+//# sourceMappingURL=benchmark.d.ts.map

package/dist/benchmark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark.d.ts","sourceRoot":"","sources":["../src/benchmark.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG"}

package/dist/config.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-exported from @hyperframes/engine with ProducerConfig alias.
+ * @see engine/src/config.ts for implementation.
+ */
+export { type EngineConfig, type EngineConfig as ProducerConfig, DEFAULT_CONFIG, resolveConfig, } from "@hyperframes/engine";
+//# 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;;;GAGG;AACH,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,IAAI,cAAc,EACnC,cAAc,EACd,aAAa,GACd,MAAM,qBAAqB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @hyperframes/producer
+ *
+ * Generic HTML-to-video rendering engine using Chrome's BeginFrame API.
+ * Framework-agnostic: works with GSAP, Lottie, Three.js, CSS animations,
+ * or any web content via configurable page contracts and hooks.
+ */
+export { createRenderJob, executeRenderJob, RenderCancelledError, type RenderConfig, type RenderJob, type RenderStatus, type RenderPerfSummary, type ProgressCallback, } from "./services/renderOrchestrator.js";
+export { createCaptureSession, initializeSession, closeCaptureSession, captureFrame, captureFrameToBuffer, getCompositionDuration, getCapturePerfSummary, prepareCaptureSessionForReuse, type CaptureOptions, type CaptureSession, type CaptureResult, type CapturePerfSummary, type BeforeCaptureHook, } from "./services/frameCapture.js";
+export { createFileServer, type FileServerOptions, type FileServerHandle, } from "./services/fileServer.js";
+export { createVideoFrameInjector } from "./services/videoFrameInjector.js";
+export { resolveConfig, DEFAULT_CONFIG, type ProducerConfig, } from "./config.js";
+export { type ProducerLogger, type LogLevel, createConsoleLogger, defaultLogger, } from "./logger.js";
+export { createRenderHandlers, createProducerApp, startServer, type HandlerOptions, type ServerOptions, type RenderHandlers, } from "./server.js";
+export { quantizeTimeToFrame } from "./utils/parityContract.js";
+export { resolveRenderPaths, type RenderPaths, } from "./utils/paths.js";
+export { prepareHyperframeLintBody, runHyperframeLint, type PreparedHyperframeLintInput, } from "./services/hyperframeLint.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;;;;;;GAMG;AAGH,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,6BAA6B,EAC7B,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAG5E,OAAO,EACL,aAAa,EACb,cAAc,EACd,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,mBAAmB,EACnB,aAAa,GACd,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EACL,kBAAkB,EAClB,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,KAAK,2BAA2B,GACjC,MAAM,8BAA8B,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Pluggable Producer Logger
+ *
+ * Lightweight pluggable logger with zero dependencies.
+ * Default implementation writes to console with level filtering.
+ *
+ * Users can provide their own logger (e.g. Winston, Pino) by
+ * implementing the ProducerLogger interface.
+ */
+export type LogLevel = "error" | "warn" | "info" | "debug";
+export interface ProducerLogger {
+    error(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    debug(message: string, meta?: Record<string, unknown>): void;
+}
+/**
+ * Create a console-based logger with level filtering.
+ *
+ * Messages at or below the configured level are printed;
+ * everything else is silently dropped.
+ */
+export declare function createConsoleLogger(level?: LogLevel): ProducerLogger;
+/** Default logger singleton (level: "info"). */
+export declare const defaultLogger: ProducerLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC9D;AASD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,GAAE,QAAiB,GAAG,cAAc,CA+B5E;AAED,gDAAgD;AAChD,eAAO,MAAM,aAAa,EAAE,cAA4C,CAAC"}

package/dist/parity-harness.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=parity-harness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parity-harness.d.ts","sourceRoot":"","sources":["../src/parity-harness.ts"],"names":[],"mappings":""}

package/dist/perf-gate.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=perf-gate.d.ts.map

package/dist/perf-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perf-gate.d.ts","sourceRoot":"","sources":["../src/perf-gate.ts"],"names":[],"mappings":""}

package/dist/regression-harness.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=regression-harness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"regression-harness.d.ts","sourceRoot":"","sources":["../src/regression-harness.ts"],"names":[],"mappings":""}

package/dist/runtime-conformance.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-conformance.d.ts.map

package/dist/runtime-conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-conformance.d.ts","sourceRoot":"","sources":["../src/runtime-conformance.ts"],"names":[],"mappings":""}

package/dist/server.d.ts

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+/**
+ * @hyperframes/producer — Public Server
+ *
+ * Clean HTTP API for rendering HTML compositions to video.
+ *
+ * Routes:
+ *   POST /render         — blocking render, returns JSON
+ *   POST /render/stream  — SSE streaming render with progress
+ *   POST /lint           — blocking Hyperframe lint
+ *   GET  /health         — health check
+ *   GET  /outputs/:token — download rendered MP4
+ */
+import { Hono, type Context } from "hono";
+import { type ProducerLogger } from "./logger.js";
+export interface HandlerOptions {
+    /** Custom logger. Defaults to console-based defaultLogger. */
+    logger?: ProducerLogger;
+    /** Extract or generate a request ID. Defaults to x-request-id header or random UUID. */
+    getRequestId?: (c: Context) => string;
+    /** Directory for rendered output files. Defaults to PRODUCER_RENDERS_DIR or /tmp. */
+    rendersDir?: string;
+    /** Prefix for output URLs in responses. Default: "/outputs". */
+    outputUrlPrefix?: string;
+    /** TTL for output artifact download tokens (ms). Default: 15 minutes. */
+    artifactTtlMs?: number;
+}
+export interface ServerOptions extends HandlerOptions {
+    /** Port to listen on. Default: 9847. */
+    port?: number;
+}
+export interface RenderHandlers {
+    render: (c: Context) => Promise<Response>;
+    renderStream: (c: Context) => Response | Promise<Response>;
+    lint: (c: Context) => Promise<Response>;
+    health: (c: Context) => Response;
+    outputs: (c: Context) => Response;
+}
+/**
+ * Create route handler functions for the producer server.
+ *
+ * These can be mounted on any Hono app at any path prefix.
+ */
+export declare function createRenderHandlers(options?: HandlerOptions): RenderHandlers;
+/**
+ * Create a Hono app with clean public routes for OSS use.
+ */
+export declare function createProducerApp(options?: HandlerOptions): Hono;
+/**
+ * Start the producer HTTP server with graceful shutdown.
+ */
+export declare function startServer(options?: ServerOptions): import("@hono/node-server").ServerType;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG;AAOH,OAAO,EAAE,IAAI,EAAE,KAAK,OAAO,EAAE,MAAM,MAAM,CAAC;AAU1C,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAKjE,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,wFAAwF;IACxF,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,MAAM,CAAC;IACtC,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAmJD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1C,YAAY,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3D,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,QAAQ,CAAC;IACjC,OAAO,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,QAAQ,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,cAAmB,GAAG,cAAc,CA2MjF;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,cAAmB,GAAG,IAAI,CAWpE;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,aAAkB,0CA8BtD"}

package/dist/services/audioExtractor.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Audio Extractor Service
+ *
+ * Extracts audio from media elements in the composition HTML,
+ * applies timeline positioning, and mixes into a single audio track.
+ */
+export interface AudioElement {
+    id: string;
+    src: string;
+    start: number;
+    duration: number;
+    mediaStart: number;
+    volume: number;
+    tagName: "audio" | "video";
+}
+export interface AudioTrack {
+    id: string;
+    srcPath: string;
+    start: number;
+    duration: number;
+    mediaStart: number;
+    volume: number;
+}
+/**
+ * Parse audio/video elements from HTML to find media with audio.
+ */
+export declare function parseAudioElements(html: string): AudioElement[];
+/**
+ * Process all audio for a composition.
+ *
+ * @param htmlPath - Path to the composition HTML (for parsing media elements)
+ * @param projectDir - Base directory for resolving relative media paths
+ * @param workDir - Temporary working directory for intermediate files
+ * @param outputPath - Final mixed audio output path
+ * @param totalDuration - Total composition duration in seconds
+ * @returns true if audio was produced, false if no audio elements found
+ */
+export declare function processAudio(htmlPath: string, projectDir: string, workDir: string, outputPath: string, totalDuration: number): Promise<boolean>;
+//# sourceMappingURL=audioExtractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audioExtractor.d.ts","sourceRoot":"","sources":["../../src/services/audioExtractor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CA+C/D;AAkKD;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC,CAiElB"}

package/dist/services/audioMixer.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-exported from @hyperframes/engine.
+ * @see engine/src/services/audioMixer.ts for implementation.
+ */
+export { parseAudioElements, processCompositionAudio, type AudioElement, type AudioTrack, type MixResult, } from "@hyperframes/engine";
+//# 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;;;GAGG;AACH,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,SAAS,GACf,MAAM,qBAAqB,CAAC"}

package/dist/services/browserManager.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-exported from @hyperframes/engine.
+ * @see engine/src/services/browserManager.ts for implementation.
+ */
+export { acquireBrowser, releaseBrowser, resolveHeadlessShellPath, buildChromeArgs, ENABLE_BROWSER_POOL, type BuildChromeArgsOptions, type CaptureMode, type AcquiredBrowser, } from "@hyperframes/engine";
+//# sourceMappingURL=browserManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browserManager.d.ts","sourceRoot":"","sources":["../../src/services/browserManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,cAAc,EACd,cAAc,EACd,wBAAwB,EACxB,eAAe,EACf,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAC"}

package/dist/services/chunkEncoder.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-exported from @hyperframes/engine.
+ * @see engine/src/services/chunkEncoder.ts for implementation.
+ */
+export { encodeFramesFromDir, encodeFramesChunkedConcat, muxVideoWithAudio, applyFaststart, detectGpuEncoder, ENCODER_PRESETS, type EncoderOptions, type EncodeResult, type MuxResult, type GpuEncoder, } from "@hyperframes/engine";
+//# sourceMappingURL=chunkEncoder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunkEncoder.d.ts","sourceRoot":"","sources":["../../src/services/chunkEncoder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC"}

package/dist/services/compilationRunner.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Compilation Test Runner
+ *
+ * Orchestrates compilation tests: compiles input HTML, compares to golden files.
+ */
+import { type CompilationValidationResult } from "./compilationTester.js";
+export interface CompilationTestResult {
+    testId: string;
+    passed: boolean;
+    validation: CompilationValidationResult;
+    compilationTimeMs: number;
+    compiledHtmlPath?: string;
+}
+interface TestSuite {
+    id: string;
+    dir: string;
+    srcDir: string;
+    goldenMp4: string;
+    meta: Record<string, unknown>;
+}
+/**
+ * Run compilation test for a test suite.
+ * Compiles src/index.html and compares against compiled.html golden file.
+ */
+export declare function runCompilationTest(suite: TestSuite, keepTemp: boolean): Promise<CompilationTestResult>;
+/**
+ * Generate or update compiled.html golden file for a test suite.
+ * Compiles src/index.html and writes to compiled.html.
+ */
+export declare function updateCompiledGolden(suite: TestSuite): Promise<void>;
+export {};
+//# sourceMappingURL=compilationRunner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compilationRunner.d.ts","sourceRoot":"","sources":["../../src/services/compilationRunner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,2BAA2B,CAAC;IACxC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,qBAAqB,CAAC,CAuEhC;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,IAAI,CAAC,CAuCf"}

package/dist/services/compilationTester.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Compilation Testing Service
+ *
+ * Validates that HTML compilation produces correct timing attributes.
+ * Compares compiled HTML against golden files using semantic attribute matching.
+ */
+export interface CompiledElement {
+    id: string;
+    tagName: "video" | "audio" | "div";
+    src?: string;
+    dataStart: number;
+    dataEnd: number | null;
+    dataDuration: number | null;
+    dataHasAudio?: boolean;
+    dataMediaStart?: number;
+    compositionSrc?: string;
+}
+export interface CompilationValidationResult {
+    passed: boolean;
+    actualElements: CompiledElement[];
+    goldenElements: CompiledElement[];
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Parse HTML and extract all elements with timing attributes.
+ * Includes <video>, <audio>, and <div data-composition-src>.
+ */
+export declare function extractTimedElements(html: string): CompiledElement[];
+/**
+ * Validate compiled HTML against golden HTML.
+ * Returns detailed validation result with errors and warnings.
+ */
+export declare function validateCompilation(actualHtml: string, goldenHtml: string): CompilationValidationResult;
+//# sourceMappingURL=compilationTester.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compilationTester.d.ts","sourceRoot":"","sources":["../../src/services/compilationTester.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,eAAe,EAAE,CAAC;IAClC,cAAc,EAAE,eAAe,EAAE,CAAC;IAClC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAUD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CA8EpE;AA8HD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,2BAA2B,CAsG7B"}

package/dist/services/deterministicFonts.d.ts

@@ -0,0 +1,2 @@
+export declare function injectDeterministicFontFaces(html: string): string;
+//# sourceMappingURL=deterministicFonts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deterministicFonts.d.ts","sourceRoot":"","sources":["../../src/services/deterministicFonts.ts"],"names":[],"mappings":"AA4QA,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAwCjE"}

package/dist/services/fileServer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * File Server for Render Mode
+ *
+ * Lightweight HTTP server that serves the project directory inside Docker.
+ * Key responsibility: inject the verified Hyperframe runtime + render mode extension
+ * into index.html on-the-fly, so Puppeteer can load the composition with
+ * all relative URLs (compositions, CSS, JS, assets) resolving correctly.
+ */
+export interface FileServerOptions {
+    projectDir: string;
+    compiledDir?: string;
+    port?: number;
+    /** Scripts injected into <head> of index.html. Default: verified Hyperframe runtime. */
+    headScripts?: string[];
+    /** Scripts injected before </body> of index.html. Default: render mode extension. */
+    bodyScripts?: string[];
+    /** Strip embedded runtime scripts from HTML before injection. Default: true. */
+    stripEmbeddedRuntime?: boolean;
+}
+export interface FileServerHandle {
+    url: string;
+    port: number;
+    close: () => void;
+}
+export declare function createFileServer(options: FileServerOptions): Promise<FileServerHandle>;
+//# sourceMappingURL=fileServer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fileServer.d.ts","sourceRoot":"","sources":["../../src/services/fileServer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmPH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,gFAAgF;IAChF,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyDtF"}

package/dist/services/frameCapture.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-exported from @hyperframes/engine.
+ * @see engine/src/services/frameCapture.ts for implementation.
+ */
+export { createCaptureSession, initializeSession, closeCaptureSession, captureFrame, captureFrameToBuffer, getCompositionDuration, getCapturePerfSummary, prepareCaptureSessionForReuse, type CaptureOptions, type CaptureResult, type CaptureBufferResult, type CapturePerfSummary, type CaptureSession, type BeforeCaptureHook, } from "@hyperframes/engine";
+//# sourceMappingURL=frameCapture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frameCapture.d.ts","sourceRoot":"","sources":["../../src/services/frameCapture.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,6BAA6B,EAC7B,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,iBAAiB,GACvB,MAAM,qBAAqB,CAAC"}

package/dist/services/htmlCompiler.d.ts

@@ -0,0 +1,59 @@
+/**
+ * HTML Compiler for Producer
+ *
+ * Two-phase compilation that guarantees every media element has data-end:
+ * 1. Static pass via core's compileTimingAttrs() (data-start + data-duration → data-end)
+ * 2. ffprobe resolution for elements without data-duration
+ *
+ * Also handles sub-compositions referenced via data-composition-src,
+ * recursively extracting nested media from sub-sub-compositions.
+ */
+import { type ResolvedDuration, type UnresolvedElement } from "@hyperframes/core";
+import { type VideoElement, type AudioElement } from "@hyperframes/engine";
+import type { Page } from "puppeteer-core";
+export interface CompiledComposition {
+    html: string;
+    subCompositions: Map<string, string>;
+    videos: VideoElement[];
+    audios: AudioElement[];
+    unresolvedCompositions: UnresolvedElement[];
+    width: number;
+    height: number;
+    staticDuration: number;
+}
+/**
+ * Full compilation pipeline for the producer.
+ *
+ * Returns everything the orchestrator needs: compiled HTML, all media elements,
+ * dimensions, and static duration.
+ */
+export declare function compileForRender(projectDir: string, htmlPath: string, downloadDir: string): Promise<CompiledComposition>;
+/**
+ * Discover media elements from the browser DOM after JavaScript has run.
+ * This catches videos/audios whose `src` is set dynamically via JS
+ * (e.g. `document.getElementById("pip-video").src = URL`), which the
+ * static regex parsers miss because the HTML has `src=""`.
+ */
+export interface BrowserMediaElement {
+    id: string;
+    tagName: "video" | "audio";
+    src: string;
+    start: number;
+    end: number;
+    duration: number;
+    mediaStart: number;
+    hasAudio: boolean;
+    volume: number;
+}
+export declare function discoverMediaFromBrowser(page: Page): Promise<BrowserMediaElement[]>;
+/**
+ * Resolve composition durations via Puppeteer by querying window.__timelines.
+ * The page must already have the interceptor loaded and timelines registered.
+ */
+export declare function resolveCompositionDurations(page: Page, unresolved: UnresolvedElement[]): Promise<ResolvedDuration[]>;
+/**
+ * Re-compile after composition durations are resolved.
+ * Injects durations into the HTML and re-parses sub-composition media with proper bounds.
+ */
+export declare function recompileWithResolutions(compiled: CompiledComposition, resolutions: ResolvedDuration[], projectDir: string, downloadDir: string): Promise<CompiledComposition>;
+//# sourceMappingURL=htmlCompiler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"htmlCompiler.d.ts","sourceRoot":"","sources":["../../src/services/htmlCompiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAKL,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAsB,KAAK,YAAY,EAAsB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAG3C,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,sBAAsB,EAAE,iBAAiB,EAAE,CAAC;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB;AAgiBD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,mBAAmB,CAAC,CA+C9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA8ChC;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,iBAAiB,EAAE,GAC9B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAiD7B;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,mBAAmB,EAC7B,WAAW,EAAE,gBAAgB,EAAE,EAC/B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,mBAAmB,CAAC,CA6B9B"}

package/dist/services/hyperframeLint.d.ts

@@ -0,0 +1,13 @@
+import { type HyperframeLintResult } from "@hyperframes/core/lint";
+export interface PreparedHyperframeLintInput {
+    entryFile: string;
+    html: string;
+    source: "projectDir" | "files" | "html";
+}
+export declare function prepareHyperframeLintBody(body: Record<string, unknown>): {
+    prepared: PreparedHyperframeLintInput;
+} | {
+    error: string;
+};
+export declare function runHyperframeLint(prepared: PreparedHyperframeLintInput): HyperframeLintResult;
+//# sourceMappingURL=hyperframeLint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hyperframeLint.d.ts","sourceRoot":"","sources":["../../src/services/hyperframeLint.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,KAAK,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEvF,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,GAAG,OAAO,GAAG,MAAM,CAAC;CACzC;AA2DD,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B;IAAE,QAAQ,EAAE,2BAA2B,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAqC/D;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,2BAA2B,GAAG,oBAAoB,CAE7F"}

package/dist/services/hyperframeRuntimeLoader.d.ts

@@ -0,0 +1,11 @@
+export type ResolvedHyperframeRuntime = {
+    manifestPath: string;
+    runtimePath: string;
+    expectedSha256: string;
+    actualSha256: string;
+    runtimeSource: string;
+};
+export declare function resolveHyperframeManifestPath(): string;
+export declare function getVerifiedHyperframeRuntimeSource(): string;
+export declare function resolveVerifiedHyperframeRuntime(): ResolvedHyperframeRuntime;
+//# sourceMappingURL=hyperframeRuntimeLoader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hyperframeRuntimeLoader.d.ts","sourceRoot":"","sources":["../../src/services/hyperframeRuntimeLoader.ts"],"names":[],"mappings":"AAsBA,MAAM,MAAM,yBAAyB,GAAG;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,wBAAgB,6BAA6B,IAAI,MAAM,CAWtD;AAED,wBAAgB,kCAAkC,IAAI,MAAM,CAE3D;AAED,wBAAgB,gCAAgC,IAAI,yBAAyB,CAoC5E"}

package/dist/services/parallelCoordinator.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-exported from @hyperframes/engine.
+ * @see engine/src/services/parallelCoordinator.ts for implementation.
+ */
+export { calculateOptimalWorkers, distributeFrames, executeParallelCapture, mergeWorkerFrames, getSystemResources, type WorkerTask, type WorkerResult, type ParallelProgress, } from "@hyperframes/engine";
+//# sourceMappingURL=parallelCoordinator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parallelCoordinator.d.ts","sourceRoot":"","sources":["../../src/services/parallelCoordinator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,gBAAgB,GACtB,MAAM,qBAAqB,CAAC"}

package/dist/services/renderOrchestrator.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Render Orchestrator Service
+ *
+ * Coordinates the entire video rendering pipeline:
+ * 1. Parse composition metadata
+ * 2. Pre-extract video frames
+ * 3. Pre-process audio tracks
+ * 4. Parallel frame capture
+ * 5. Video encoding
+ * 6. Final assembly (audio mux + faststart)
+ *
+ * Heavy observability: every stage logs timing, errors include
+ * full context, and failures produce a diagnostic summary.
+ */
+import { type EngineConfig as ProducerConfig, type VideoElement, type AudioElement } from "@hyperframes/engine";
+import { type ProducerLogger } from "../logger.js";
+export type RenderStatus = "queued" | "preprocessing" | "rendering" | "encoding" | "assembling" | "complete" | "failed" | "cancelled";
+export interface RenderConfig {
+    fps: 24 | 30 | 60;
+    quality: "draft" | "standard" | "high";
+    workers?: number;
+    useGpu?: boolean;
+    debug?: boolean;
+    /** Full producer config. When provided, env vars are not read. */
+    producerConfig?: ProducerConfig;
+    /** Custom logger. Defaults to console-based defaultLogger. */
+    logger?: ProducerLogger;
+}
+export interface RenderPerfSummary {
+    renderId: string;
+    totalElapsedMs: number;
+    fps: number;
+    quality: string;
+    workers: number;
+    chunkedEncode: boolean;
+    chunkSizeFrames: number | null;
+    compositionDurationSeconds: number;
+    totalFrames: number;
+    resolution: {
+        width: number;
+        height: number;
+    };
+    videoCount: number;
+    audioCount: number;
+    stages: Record<string, number>;
+    captureAvgMs?: number;
+    capturePeakMs?: number;
+}
+export interface RenderJob {
+    id: string;
+    config: RenderConfig;
+    status: RenderStatus;
+    progress: number;
+    currentStage: string;
+    createdAt: Date;
+    startedAt?: Date;
+    completedAt?: Date;
+    error?: string;
+    outputPath?: string;
+    duration?: number;
+    totalFrames?: number;
+    framesRendered?: number;
+    perfSummary?: RenderPerfSummary;
+    failedStage?: string;
+    errorDetails?: {
+        message: string;
+        stack?: string;
+        elapsedMs: number;
+        freeMemoryMB: number;
+        browserConsoleTail?: string[];
+        perfStages?: Record<string, number>;
+    };
+}
+export type ProgressCallback = (job: RenderJob, message: string) => void;
+export declare class RenderCancelledError extends Error {
+    reason: "user_cancelled" | "timeout" | "aborted";
+    constructor(message?: string, reason?: "user_cancelled" | "timeout" | "aborted");
+}
+export interface CompositionMetadata {
+    duration: number;
+    videos: VideoElement[];
+    audios: AudioElement[];
+    width: number;
+    height: number;
+}
+export declare function createRenderJob(config: RenderConfig): RenderJob;
+/**
+ * Main render pipeline
+ */
+export declare function executeRenderJob(job: RenderJob, projectDir: string, outputPath: string, onProgress?: ProgressCallback, abortSignal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=renderOrchestrator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderOrchestrator.d.ts","sourceRoot":"","sources":["../../src/services/renderOrchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EACL,KAAK,YAAY,IAAI,cAAc,EAInC,KAAK,YAAY,EAkBjB,KAAK,YAAY,EAQlB,MAAM,qBAAqB,CAAC;AAO7B,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAalE,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,eAAe,GACf,WAAW,GACX,UAAU,GACV,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,WAAW,CAAC;AAEhB,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IAClB,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kEAAkE;IAClE,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,8DAA8D;IAC9D,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,0BAA0B,EAAE,MAAM,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC9B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACrC,CAAC;CACH;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAEzE,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,MAAM,EAAE,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAC;gBACrC,OAAO,GAAE,MAA2B,EAAE,MAAM,GAAE,gBAAgB,GAAG,SAAS,GAAG,SAAqB;CAK/G;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAwED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAS/D;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,SAAS,EACd,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,gBAAgB,EAC7B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,IAAI,CAAC,CA+rBf"}

package/dist/services/screenshotService.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-exported from @hyperframes/engine.
+ * @see engine/src/services/screenshotService.ts for implementation.
+ */
+export { beginFrameCapture, pageScreenshotCapture, getCdpSession, injectVideoFramesBatch, syncVideoFrameVisibility, cdpSessionCache, type BeginFrameResult, } from "@hyperframes/engine";
+//# sourceMappingURL=screenshotService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"screenshotService.d.ts","sourceRoot":"","sources":["../../src/services/screenshotService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,sBAAsB,EACtB,wBAAwB,EACxB,eAAe,EACf,KAAK,gBAAgB,GACtB,MAAM,qBAAqB,CAAC"}

package/dist/services/streamingEncoder.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-exported from @hyperframes/engine.
+ * @see engine/src/services/streamingEncoder.ts for implementation.
+ */
+export { spawnStreamingEncoder, createFrameReorderBuffer, type StreamingEncoder, type StreamingEncoderOptions, type StreamingEncoderResult, type FrameReorderBuffer, } from "@hyperframes/engine";
+//# sourceMappingURL=streamingEncoder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"streamingEncoder.d.ts","sourceRoot":"","sources":["../../src/services/streamingEncoder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC"}

package/dist/services/timingCompiler.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Producer-local timing compiler helpers.
+ * Keep this aligned with core timing compiler behavior.
+ */
+export interface UnresolvedElement {
+    id: string;
+    tagName: string;
+    src?: string;
+    start: number;
+    end?: number;
+    duration?: number;
+    mediaStart: number;
+    compositionSrc?: string;
+}
+export interface ResolvedDuration {
+    id: string;
+    duration: number;
+}
+export interface ResolvedMediaElement {
+    id: string;
+    tagName: string;
+    src?: string;
+    start: number;
+    duration: number;
+    mediaStart: number;
+}
+export interface CompilationResult {
+    html: string;
+    unresolved: UnresolvedElement[];
+}
+export declare function compileTimingAttrs(html: string): CompilationResult;
+export declare function injectDurations(html: string, resolutions: ResolvedDuration[]): string;
+/**
+ * Extract video/audio elements that already have data-duration set.
+ * Used by callers to validate declared durations against actual source durations.
+ */
+export declare function extractResolvedMedia(html: string): ResolvedMediaElement[];
+/**
+ * Clamp existing data-duration and data-end on media elements.
+ * For each resolution, replaces the declared duration with the clamped value
+ * and recomputes data-end accordingly.
+ */
+export declare function clampDurations(html: string, clamps: ResolvedDuration[]): string;
+//# sourceMappingURL=timingCompiler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timingCompiler.d.ts","sourceRoot":"","sources":["../../src/services/timingCompiler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,iBAAiB,EAAE,CAAC;CACjC;AA8CD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CA0ClE;AAMD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAiBrF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,EAAE,CA6BzE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAwB/E"}

package/dist/services/videoFrameExtractor.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-exported from @hyperframes/engine.
+ * @see engine/src/services/videoFrameExtractor.ts for implementation.
+ */
+export { parseVideoElements, extractVideoFramesRange, extractAllVideoFrames, getFrameAtTime, createFrameLookupTable, FrameLookupTable, type VideoElement, type ExtractedFrames, type ExtractionOptions, type ExtractionResult, } from "@hyperframes/engine";
+//# sourceMappingURL=videoFrameExtractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"videoFrameExtractor.d.ts","sourceRoot":"","sources":["../../src/services/videoFrameExtractor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,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,qBAAqB,CAAC"}

package/dist/services/videoFrameInjector.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-exported from @hyperframes/engine.
+ * @see engine/src/services/videoFrameInjector.ts for implementation.
+ */
+export { createVideoFrameInjector } from "@hyperframes/engine";
+//# sourceMappingURL=videoFrameInjector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"videoFrameInjector.d.ts","sourceRoot":"","sources":["../../src/services/videoFrameInjector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/utils/ffprobe.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-exported from @hyperframes/engine.
+ * @see engine/src/utils/ffprobe.ts for implementation.
+ */
+export { extractVideoMetadata, extractAudioMetadata, type VideoMetadata, type AudioMetadata, } from "@hyperframes/engine";
+//# sourceMappingURL=ffprobe.d.ts.map

package/dist/utils/ffprobe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffprobe.d.ts","sourceRoot":"","sources":["../../src/utils/ffprobe.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC"}

package/dist/utils/parityContract.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-exported from @hyperframes/engine.
+ * @see engine/src/utils/parityContract.ts for implementation.
+ */
+export { quantizeTimeToFrame, MEDIA_VISUAL_STYLE_PROPERTIES, } from "@hyperframes/engine";
+//# sourceMappingURL=parityContract.d.ts.map

package/dist/utils/parityContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parityContract.d.ts","sourceRoot":"","sources":["../../src/utils/parityContract.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,mBAAmB,EACnB,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Path resolution utilities for the render pipeline.
+ */
+export interface RenderPaths {
+    absoluteProjectDir: string;
+    absoluteOutputPath: string;
+}
+export declare function resolveRenderPaths(projectDir: string, outputPath: string | null | undefined, rendersDir?: string): RenderPaths;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,WAAW;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAKD,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACrC,UAAU,GAAE,MAA4B,GACvC,WAAW,CAQb"}

package/dist/utils/urlDownloader.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-exported from @hyperframes/engine.
+ * @see engine/src/utils/urlDownloader.ts for implementation.
+ */
+export { downloadToTemp, isHttpUrl, } from "@hyperframes/engine";
+//# sourceMappingURL=urlDownloader.d.ts.map

package/dist/utils/urlDownloader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlDownloader.d.ts","sourceRoot":"","sources":["../../src/utils/urlDownloader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,cAAc,EACd,SAAS,GACV,MAAM,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/producer",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "HTML-to-video rendering engine using Chrome's BeginFrame API",
   "type": "module",
   "main": "dist/index.js",
@@ -24,23 +24,7 @@
   "engines": {
     "node": ">=22"
   },
-  "scripts": {
-    "build": "pnpm -w build:hyperframes-runtime:modular && node build.mjs",
-    "typecheck": "tsc --noEmit",
-    "parity:check": "tsx src/parity-harness.ts",
-    "parity:fixtures": "tsx src/parity-fixtures.ts",
-    "parity:fixtures:ci": "tsx src/parity-fixtures.ts",
-    "parity:check:ci": "tsx src/parity-harness.ts --preview-url \"http://127.0.0.1:4173/minimal-wysiwyg.html\" --producer-url \"http://127.0.0.1:4173/minimal-wysiwyg.html?mode=producer\" --checkpoints \"0,0.5,1,1.5\" --allow-mismatch-ratio 0 --emulate-producer-swap true --artifacts-dir \".debug/parity-harness-ci\"",
-    "perf:gate": "tsx src/perf-gate.ts",
-    "check:runtime-conformance": "tsx src/runtime-conformance.ts",
-    "benchmark": "tsx src/benchmark.ts",
-    "test": "tsx src/regression-harness.ts",
-    "test:update": "tsx src/regression-harness.ts --update",
-    "prepublishOnly": "pnpm build"
-  },
   "dependencies": {
-    "@hyperframes/core": "workspace:*",
-    "@hyperframes/engine": "workspace:*",
     "@fontsource/archivo-black": "^5.2.8",
     "@fontsource/eb-garamond": "^5.2.7",
     "@fontsource/ibm-plex-mono": "^5.2.7",
@@ -56,12 +40,27 @@
     "hono": "^4.6.0",
     "linkedom": "^0.18.12",
     "puppeteer": "^24.0.0",
-    "puppeteer-core": "^24.39.1"
+    "puppeteer-core": "^24.39.1",
+    "@hyperframes/core": "^0.1.1",
+    "@hyperframes/engine": "^0.1.1"
   },
   "devDependencies": {
     "@types/node": "^22.10.1",
     "esbuild": "^0.27.2",
     "tsx": "^4.7.0",
     "typescript": "^5.7.2"
+  },
+  "scripts": {
+    "build": "pnpm -w build:hyperframes-runtime:modular && node build.mjs",
+    "typecheck": "tsc --noEmit",
+    "parity:check": "tsx src/parity-harness.ts",
+    "parity:fixtures": "tsx src/parity-fixtures.ts",
+    "parity:fixtures:ci": "tsx src/parity-fixtures.ts",
+    "parity:check:ci": "tsx src/parity-harness.ts --preview-url \"http://127.0.0.1:4173/minimal-wysiwyg.html\" --producer-url \"http://127.0.0.1:4173/minimal-wysiwyg.html?mode=producer\" --checkpoints \"0,0.5,1,1.5\" --allow-mismatch-ratio 0 --emulate-producer-swap true --artifacts-dir \".debug/parity-harness-ci\"",
+    "perf:gate": "tsx src/perf-gate.ts",
+    "check:runtime-conformance": "tsx src/runtime-conformance.ts",
+    "benchmark": "tsx src/benchmark.ts",
+    "test": "tsx src/regression-harness.ts",
+    "test:update": "tsx src/regression-harness.ts --update"
   }
-}
+}