diff --git a/packages/producer/src/services/htmlCompiler.test.ts b/packages/producer/src/services/htmlCompiler.test.ts index 386ae9c5be..04d363465c 100644 --- a/packages/producer/src/services/htmlCompiler.test.ts +++ b/packages/producer/src/services/htmlCompiler.test.ts @@ -426,6 +426,7 @@ describe("detectRenderModeHints", () => { const result = detectRenderModeHints(html); expect(result.reasons.map((reason) => reason.code)).toContain("htmlInCanvas"); + expect(result.recommendScreenshot).toBe(true); }); it("does not flag htmlInCanvas for plain canvas elements without layoutsubtree", () => { diff --git a/packages/producer/src/services/render/captureCost.ts b/packages/producer/src/services/render/captureCost.ts index e01a6f6f4f..2ca5520743 100644 --- a/packages/producer/src/services/render/captureCost.ts +++ b/packages/producer/src/services/render/captureCost.ts @@ -114,14 +114,17 @@ export function resolveRenderWorkerCount( log: ProducerLogger = defaultLogger, measuredCaptureCost?: CaptureCostEstimate, ): number { + // TODO(htmlInCanvas): workaround — Chrome's experimental drawElementImage + // API (CanvasDrawElement) is non-deterministic across concurrent browser + // instances due to paint-cache races and SwiftShader contention. + // Remove this clamp once Chromium stabilizes CanvasDrawElement for + // concurrent use. const reasonCodes = new Set(compiled.renderModeHints.reasons.map((r) => r.code)); if (reasonCodes.has("htmlInCanvas")) { - if (requestedWorkers !== undefined && requestedWorkers > 1) { - log.warn( - "[Render] html-in-canvas (drawElementImage) detected — overriding --workers to 1. " + - "Chrome does not support concurrent drawElementImage across multiple workers and produces flickering artifacts.", - ); - } + log.warn( + "[Render] html-in-canvas (drawElementImage) detected — pinning to 1 worker (Chrome concurrency limitation).", + { requestedWorkers }, + ); return 1; } diff --git a/packages/producer/src/services/renderOrchestrator.test.ts b/packages/producer/src/services/renderOrchestrator.test.ts index c515dea822..e18f213616 100644 --- a/packages/producer/src/services/renderOrchestrator.test.ts +++ b/packages/producer/src/services/renderOrchestrator.test.ts @@ -584,6 +584,7 @@ describe("resolveRenderWorkerCount", () => { ); expect(workers).toBe(1); + expect(log.warn).toHaveBeenCalledOnce(); }); it("overrides explicit --workers when html-in-canvas is detected", () => { diff --git a/packages/producer/src/services/renderOrchestrator.ts b/packages/producer/src/services/renderOrchestrator.ts index a8eaadc7a6..836a1a573d 100644 --- a/packages/producer/src/services/renderOrchestrator.ts +++ b/packages/producer/src/services/renderOrchestrator.ts @@ -1699,7 +1699,10 @@ export async function executeRenderJob( } | undefined; - if (job.config.workers === undefined && totalFrames >= 60) { + const htmlInCanvasDetected = compiled.renderModeHints.reasons.some( + (r) => r.code === "htmlInCanvas", + ); + if (job.config.workers === undefined && totalFrames >= 60 && !htmlInCanvasDetected) { const outcome = await runCaptureCalibration({ cfg, fileServer,