@fieldnotes/core 0.58.0 → 0.59.0

package/dist/index.cjs

@@ -5855,6 +5855,19 @@ function computeBounds(elements, padding) {
     h: maxY - minY + padding * 2
   };
 }
+function resolveExportBounds(region, elements, padding) {
+  if (!region) return computeBounds(elements, padding);
+  const finite = Number.isFinite(region.x) && Number.isFinite(region.y) && Number.isFinite(region.w) && Number.isFinite(region.h);
+  if (!finite || region.w <= 0 || region.h <= 0) {
+    throw new RangeError("region must have finite coordinates and positive w/h");
+  }
+  return {
+    x: region.x - padding,
+    y: region.y - padding,
+    w: region.w + padding * 2,
+    h: region.h + padding * 2
+  };
+}
 function renderGridForBounds(ctx, grid, bounds) {
   const visibleBounds = {
     minX: bounds.x,
@@ -5897,6 +5910,29 @@ function nonNegativeOption(value, fallback, name) {
   }
   return resolved;
 }
+function fitExportScale(bounds, requestedScale, options) {
+  const maxDimension = positiveOption(options.maxDimension, DEFAULT_MAX_DIMENSION, "maxDimension");
+  const maxPixels = positiveOption(options.maxPixels, DEFAULT_MAX_PIXELS, "maxPixels");
+  const fits = (scale) => {
+    const w = Math.ceil(bounds.w * scale);
+    const h = Math.ceil(bounds.h * scale);
+    return w <= maxDimension && h <= maxDimension && w * h <= maxPixels;
+  };
+  if (fits(requestedScale)) return requestedScale;
+  const analytical = Math.min(
+    maxDimension / Math.max(bounds.w, bounds.h),
+    Math.sqrt(maxPixels) / Math.sqrt(bounds.w) / Math.sqrt(bounds.h)
+  );
+  let hi = Math.min(requestedScale, analytical);
+  if (fits(hi)) return hi;
+  let lo = 0;
+  for (let i = 0; i < 40; i++) {
+    const mid = (lo + hi) / 2;
+    if (fits(mid)) lo = mid;
+    else hi = mid;
+  }
+  return lo;
+}
 function assertExportSize(width, height, options) {
   const maxDimension = positiveOption(options.maxDimension, DEFAULT_MAX_DIMENSION, "maxDimension");
   const maxPixels = positiveOption(options.maxPixels, DEFAULT_MAX_PIXELS, "maxPixels");
@@ -5971,10 +6007,23 @@ function loadImages(elements, options = {}) {
   });
 }
 async function exportImage(store, options = {}, layerManager) {
-  const scale = positiveOption(options.scale, 2, "scale");
+  const requestedScale = positiveOption(options.scale, 2, "scale");
+  const scaleMode = options.scaleMode ?? "exact";
+  if (scaleMode !== "exact" && scaleMode !== "fit") {
+    throw new RangeError(`scaleMode must be 'exact' or 'fit'`);
+  }
   const padding = nonNegativeOption(options.padding, 0, "padding");
   validateExportResourceOptions(options);
   validateHtmlExportOptions(options);
+  const format = options.format ?? "png";
+  if (format !== "png" && format !== "jpeg") {
+    throw new RangeError(`format must be 'png' or 'jpeg'`);
+  }
+  if (options.quality !== void 0) {
+    if (!Number.isFinite(options.quality) || options.quality <= 0 || options.quality > 1) {
+      throw new RangeError("quality must be a finite number in (0, 1]");
+    }
+  }
   const background = options.background ?? "#ffffff";
   const filter = options.filter;
   const allElements = store.getAll();
@@ -5982,8 +6031,9 @@ async function exportImage(store, options = {}, layerManager) {
   if (filter) {
     visibleElements = visibleElements.filter(filter);
   }
-  const bounds = computeBounds(visibleElements, padding);
+  const bounds = resolveExportBounds(options.region, visibleElements, padding);
   if (!bounds) return null;
+  const scale = scaleMode === "fit" ? fitExportScale(bounds, requestedScale, options) : requestedScale;
   const width = Math.ceil(bounds.w * scale);
   const height = Math.ceil(bounds.h * scale);
   assertExportSize(width, height, options);
@@ -6085,8 +6135,9 @@ async function exportImage(store, options = {}, layerManager) {
     renderGridForBounds(ctx, grid, bounds);
     ctx.restore();
   }
+  const mimeType = format === "jpeg" ? "image/jpeg" : "image/png";
   return new Promise((resolve) => {
-    canvas.toBlob((blob) => resolve(blob), "image/png");
+    canvas.toBlob((blob) => resolve(blob), mimeType, options.quality);
   });
 }
 
@@ -12366,7 +12417,7 @@ var PingTool = class {
 };
 
 // src/index.ts
-var VERSION = "0.58.0";
+var VERSION = "0.59.0";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ArrowTool,