wasm-html-to-image 1.0.19 → 1.0.21

package/dist/core-orchestrate.d.ts

@@ -29,6 +29,8 @@ export interface Orchestration {
      */
     animationLoop: number;
     width: number;
+    /** The caller's explicit `width` (image input skips resize when width/height are both omitted). */
+    widthOption: number | undefined;
     height: number | undefined;
     crop: HtmlToImageOptions["crop"];
     fit: HtmlToImageOptions["fit"];

package/dist/core-orchestrate.js

@@ -34,7 +34,7 @@ export function defaultSpeed(format) {
 }
 /** Build per-call orchestration state (log gate, timings, diag, resolve ctx). */
 export function createOrchestration(module, options) {
-    const { format = "png", quality = 85, speed: speedOption, width, height, crop, fit, value, url, baseUrl, fontMap, userAgent, fallbackFonts, logLevel = LogLevel.None, onLog, diagnostics = false, onDiagnostics, onLayout, resolveResource, mediaType = "screen", textToPaths, css, fonts: preloadFonts, limits = {}, pdfTitle, pdfAuthor, pdfSubject, pdfKeywords, pdfCreator, pdfProducer, pdfMargin, pdfHeader, pdfFooter, } = options;
+    const { format = "png", quality = 85, speed: speedOption, height, crop, fit, value, url, baseUrl, fontMap, userAgent, fallbackFonts, logLevel = LogLevel.None, onLog, diagnostics = false, onDiagnostics, onLayout, resolveResource, mediaType = "screen", textToPaths, css, fonts: preloadFonts, limits = {}, pdfTitle, pdfAuthor, pdfSubject, pdfKeywords, pdfCreator, pdfProducer, pdfMargin, pdfHeader, pdfFooter, } = options;
     // `animation` accepts a boolean (image input: keep frames) or, for HTML
     // input, an object requesting keyframe sampling. The object form turns on
     // the boolean flag for the encode stage and enables the frame path.
@@ -47,6 +47,10 @@ export function createOrchestration(module, options) {
     const animationLoop = Math.max(0, Math.trunc(animationFrames?.loop ?? 0));
     const speed = speedOption ?? defaultSpeed(format);
     const colorSpace = options.colorSpace === "cmyk" ? "cmyk" : "srgb";
+    const width = options.width ?? 800;
+    if (!Number.isFinite(width) || width <= 0) {
+        throw new Error(`wasm-html-to-image: width must be a positive finite number, got ${String(options.width)}`);
+    }
     const scale = options.scale ?? 1;
     if (!Number.isFinite(scale) || scale <= 0 || scale > 16) {
         throw new Error(`wasm-html-to-image: scale must be a number in (0, 16], got ${String(options.scale)}`);
@@ -154,6 +158,7 @@ export function createOrchestration(module, options) {
         animationFrames,
         animationLoop,
         width,
+        widthOption: options.width,
         height,
         crop,
         fit,
@@ -262,7 +267,7 @@ export async function resolveHtmlSource(orch) {
  * `imageBytesFromUnknown` (`unknown` in, no `as` casts).
  */
 export async function runImageInput(module, value, orch) {
-    const { format, quality, speed, animation, animationLoop, width, height, crop, fit, fmtInt, colorSpace, dpiOption, t0, emitLog, logged, loggedBinding, addTime, deliverReport, } = orch;
+    const { format, quality, speed, animation, animationLoop, widthOption, height, crop, fit, fmtInt, colorSpace, dpiOption, t0, emitLog, logged, loggedBinding, addTime, deliverReport, } = orch;
     // Narrowed here: caller selected this branch via `isImageInput(value)`.
     const loadImage = module.converter_load_image;
     if (typeof loadImage !== "function")
@@ -296,10 +301,10 @@ export async function runImageInput(module, value, orch) {
         if (crop) {
             module.converter_crop(inst, crop.x, crop.y, crop.width, crop.height);
         }
-        if (width !== undefined || height !== undefined) {
-            module.converter_resize(inst, width ?? 0, height ?? 0, FIT_INT[fit ?? "contain"]);
+        if (widthOption !== undefined || height !== undefined) {
+            module.converter_resize(inst, widthOption ?? 0, height ?? 0, FIT_INT[fit ?? "contain"]);
         }
-        const outWidth = module.converter_get_width?.(inst) ?? width ?? originalWidth;
+        const outWidth = module.converter_get_width?.(inst) ?? widthOption ?? originalWidth;
         const outHeight = module.converter_get_height?.(inst) ?? height ?? originalHeight;
         const outAnimation = module.converter_is_animation?.(inst) ?? animation;
         const outFormat = module.converter_get_format?.(inst) || format;

package/dist/core.d.ts

@@ -48,7 +48,8 @@ export interface RenderOptions {
     value?: string | string[] | Uint8Array | ArrayBuffer;
     url?: string;
     baseUrl?: string;
-    width: number;
+    /** Layout viewport width in CSS px (HTML) or target width (image resize). Defaults to 800. */
+    width?: number;
     height?: number;
     format?: OutputFormat;
 }