@embedpdf/models 2.5.0 → 2.6.1

package/dist/index.d.ts

@@ -16,6 +16,7 @@ export * from './date';
 export * from './helpers';
 export * from './uuid';
 export * from './compound-task';
+export * from './task-sequence';
 export * from './fonts';
 /**
  * ignore will do nothing when called.

package/dist/index.js

@@ -242,6 +242,66 @@ function boundingRect(rects) {
 function boundingRectOrEmpty(rects) {
   return boundingRect(rects) ?? EMPTY_RECT;
 }
+function normalizeAngle(degrees) {
+  const normalized = degrees % 360;
+  return normalized < 0 ? normalized + 360 : normalized;
+}
+function getRectCenter(rect) {
+  return {
+    x: rect.origin.x + rect.size.width / 2,
+    y: rect.origin.y + rect.size.height / 2
+  };
+}
+function rotatePointAround(point, center, angleDegrees) {
+  const angleRad = angleDegrees * Math.PI / 180;
+  const cos = Math.cos(angleRad);
+  const sin = Math.sin(angleRad);
+  const dx = point.x - center.x;
+  const dy = point.y - center.y;
+  return {
+    x: center.x + dx * cos - dy * sin,
+    y: center.y + dx * sin + dy * cos
+  };
+}
+function rotateVertices(points, center, angleDegrees) {
+  return points.map((v) => rotatePointAround(v, center, angleDegrees));
+}
+function calculateRotatedRectAABBAroundPoint(rect, angleDegrees, center) {
+  const corners = [
+    { x: rect.origin.x, y: rect.origin.y },
+    { x: rect.origin.x + rect.size.width, y: rect.origin.y },
+    { x: rect.origin.x + rect.size.width, y: rect.origin.y + rect.size.height },
+    { x: rect.origin.x, y: rect.origin.y + rect.size.height }
+  ];
+  const rotated = rotateVertices(corners, center, angleDegrees);
+  return rectFromPoints(rotated);
+}
+function calculateRotatedRectAABB(unrotatedRect, angleDegrees) {
+  return calculateRotatedRectAABBAroundPoint(
+    unrotatedRect,
+    angleDegrees,
+    getRectCenter(unrotatedRect)
+  );
+}
+function inferRotationCenterFromRects(unrotatedRect, rotatedAabb, angleDegrees) {
+  const angleRad = angleDegrees * Math.PI / 180;
+  const cos = Math.cos(angleRad);
+  const sin = Math.sin(angleRad);
+  const m00 = 1 - cos;
+  const m01 = sin;
+  const m10 = -sin;
+  const m11 = 1 - cos;
+  const det = m00 * m11 - m01 * m10;
+  const unrotatedCenter = getRectCenter(unrotatedRect);
+  if (Math.abs(det) < 1e-10) return unrotatedCenter;
+  const rotatedCenter = getRectCenter(rotatedAabb);
+  const rhsX = rotatedCenter.x - (cos * unrotatedCenter.x - sin * unrotatedCenter.y);
+  const rhsY = rotatedCenter.y - (sin * unrotatedCenter.x + cos * unrotatedCenter.y);
+  return {
+    x: (m11 * rhsX - m01 * rhsY) / det,
+    y: (-m10 * rhsX + m00 * rhsY) / det
+  };
+}
 function buildUserToDeviceMatrix(rect, rotation, outW, outH) {
   const L = rect.origin.x;
   const B = rect.origin.y;
@@ -1538,7 +1598,7 @@ const STANDARD_FONT_DESCRIPTORS = Object.freeze([
     bold: true,
     italic: false,
     label: "Courier Bold",
-    css: '"Courier-Bold", Courier, monospace'
+    css: "Courier, monospace"
   },
   {
     id: PdfStandardFont.Courier_BoldOblique,
@@ -1546,7 +1606,7 @@ const STANDARD_FONT_DESCRIPTORS = Object.freeze([
     bold: true,
     italic: true,
     label: "Courier Bold Oblique",
-    css: '"Courier-BoldOblique", Courier, monospace'
+    css: "Courier, monospace"
   },
   {
     id: PdfStandardFont.Courier_Oblique,
@@ -1554,7 +1614,7 @@ const STANDARD_FONT_DESCRIPTORS = Object.freeze([
     bold: false,
     italic: true,
     label: "Courier Oblique",
-    css: '"Courier-Oblique", Courier, monospace'
+    css: "Courier, monospace"
   },
   HELVETICA_DESC,
   {
@@ -1563,7 +1623,7 @@ const STANDARD_FONT_DESCRIPTORS = Object.freeze([
     bold: true,
     italic: false,
     label: "Helvetica Bold",
-    css: '"Helvetica-Bold", Arial, sans-serif'
+    css: "Helvetica, Arial, sans-serif"
   },
   {
     id: PdfStandardFont.Helvetica_BoldOblique,
@@ -1571,7 +1631,7 @@ const STANDARD_FONT_DESCRIPTORS = Object.freeze([
     bold: true,
     italic: true,
     label: "Helvetica Bold Oblique",
-    css: '"Helvetica-BoldOblique", Arial, sans-serif'
+    css: "Helvetica, Arial, sans-serif"
   },
   {
     id: PdfStandardFont.Helvetica_Oblique,
@@ -1579,7 +1639,7 @@ const STANDARD_FONT_DESCRIPTORS = Object.freeze([
     bold: false,
     italic: true,
     label: "Helvetica Oblique",
-    css: '"Helvetica-Oblique", Arial, sans-serif'
+    css: "Helvetica, Arial, sans-serif"
   },
   {
     id: PdfStandardFont.Times_Roman,
@@ -1595,7 +1655,7 @@ const STANDARD_FONT_DESCRIPTORS = Object.freeze([
     bold: true,
     italic: false,
     label: "Times Bold",
-    css: '"Times New Roman Bold", Times, serif'
+    css: '"Times New Roman", Times, serif'
   },
   {
     id: PdfStandardFont.Times_BoldItalic,
@@ -1603,7 +1663,7 @@ const STANDARD_FONT_DESCRIPTORS = Object.freeze([
     bold: true,
     italic: true,
     label: "Times Bold Italic",
-    css: '"Times New Roman Bold Italic", Times, serif'
+    css: '"Times New Roman", Times, serif'
   },
   {
     id: PdfStandardFont.Times_Italic,
@@ -1611,7 +1671,7 @@ const STANDARD_FONT_DESCRIPTORS = Object.freeze([
     bold: false,
     italic: true,
     label: "Times Italic",
-    css: '"Times New Roman Italic", Times, serif'
+    css: '"Times New Roman", Times, serif'
   },
   {
     id: PdfStandardFont.Symbol,
@@ -1619,7 +1679,7 @@ const STANDARD_FONT_DESCRIPTORS = Object.freeze([
     bold: false,
     italic: false,
     label: "Symbol",
-    css: "Symbol"
+    css: "Symbol, serif"
   },
   {
     id: PdfStandardFont.ZapfDingbats,
@@ -1627,7 +1687,7 @@ const STANDARD_FONT_DESCRIPTORS = Object.freeze([
     bold: false,
     italic: false,
     label: "Zapf Dingbats",
-    css: "ZapfDingbats"
+    css: "ZapfDingbats, serif"
   }
 ]);
 const idToDescriptor = STANDARD_FONT_DESCRIPTORS.reduce((m, d) => (m[d.id] = d, m), {});
@@ -1659,6 +1719,14 @@ function standardFontLabel(font) {
 function standardFontCss(font) {
   return getStandardFontDescriptor(font).css;
 }
+function standardFontCssProperties(font) {
+  const desc = getStandardFontDescriptor(font);
+  return {
+    fontFamily: desc.css,
+    fontWeight: desc.bold ? "bold" : "normal",
+    fontStyle: desc.italic ? "italic" : "normal"
+  };
+}
 const standardFontFamilySelectOptions = Object.values(PdfStandardFontFamily).filter(
   (f) => f !== "Unknown"
   /* Unknown */
@@ -2015,6 +2083,109 @@ class CompoundTask extends Task {
     return compound;
   }
 }
+class TaskSequence {
+  constructor(parentTask) {
+    this.parentTask = parentTask;
+    this.activeChild = null;
+    this.disposed = false;
+    const origAbort = parentTask.abort.bind(parentTask);
+    parentTask.abort = (reason) => {
+      var _a;
+      this.disposed = true;
+      (_a = this.activeChild) == null ? void 0 : _a.abort(reason);
+      origAbort(reason);
+    };
+  }
+  /**
+   * Execute a child Task and return its result as a Promise.
+   *
+   * If the parent task has been aborted, throws `TaskAbortedError` immediately.
+   * If the parent task is aborted while the child is running, the child is aborted too.
+   */
+  run(factory) {
+    return new Promise((resolve, reject) => {
+      if (this.disposed || this.parentTask.state.stage !== TaskStage.Pending) {
+        reject(new TaskAbortedError("Sequence aborted"));
+        return;
+      }
+      const child = factory();
+      this.activeChild = child;
+      child.wait(
+        (result) => {
+          this.activeChild = null;
+          resolve(result);
+        },
+        (error) => {
+          this.activeChild = null;
+          if (error.type === "abort") {
+            reject(new TaskAbortedError(error.reason));
+          } else {
+            reject(new TaskRejectedError(error.reason));
+          }
+        }
+      );
+    });
+  }
+  /**
+   * Execute a child Task and return its result as a Promise,
+   * forwarding the child's progress events to the parent task
+   * through the provided mapper function.
+   *
+   * If the parent task has been aborted, throws `TaskAbortedError` immediately.
+   * If the parent task is aborted while the child is running, the child is aborted too.
+   */
+  runWithProgress(factory, mapProgress) {
+    return new Promise((resolve, reject) => {
+      if (this.disposed || this.parentTask.state.stage !== TaskStage.Pending) {
+        reject(new TaskAbortedError("Sequence aborted"));
+        return;
+      }
+      const child = factory();
+      this.activeChild = child;
+      child.onProgress((p) => {
+        this.parentTask.progress(mapProgress(p));
+      });
+      child.wait(
+        (result) => {
+          this.activeChild = null;
+          resolve(result);
+        },
+        (error) => {
+          this.activeChild = null;
+          if (error.type === "abort") {
+            reject(new TaskAbortedError(error.reason));
+          } else {
+            reject(new TaskRejectedError(error.reason));
+          }
+        }
+      );
+    });
+  }
+  /**
+   * Execute an async function body that uses `run()` / `runWithProgress()`,
+   * automatically handling abort and error routing to the parent task.
+   *
+   * - If the body throws `TaskAbortedError`, it is silently ignored
+   *   (the parent task was already aborted via the abort override).
+   * - If the body throws `TaskRejectedError` (from a child task rejection
+   *   via `run()` / `runWithProgress()`), its `.reason` is forwarded directly
+   *   to the parent task, bypassing `mapError`.
+   * - Any other thrown error is mapped through `mapError` and used to
+   *   reject the parent task. This handles unexpected runtime exceptions
+   *   in the async body itself.
+   * - On success, the body is responsible for calling `parentTask.resolve()`.
+   */
+  execute(fn, mapError) {
+    fn().catch((err) => {
+      if (err instanceof TaskAbortedError) return;
+      if (err instanceof TaskRejectedError) {
+        this.parentTask.reject(err.reason);
+        return;
+      }
+      this.parentTask.reject(mapError(err));
+    });
+  }
+}
 function ignore() {
 }
 export {
@@ -2077,6 +2248,7 @@ export {
   Task,
   TaskAbortedError,
   TaskRejectedError,
+  TaskSequence,
   TaskStage,
   blendModeLabel,
   blendModeSelectOptions,
@@ -2088,6 +2260,8 @@ export {
   buildUserToDeviceMatrix,
   calculateAngle,
   calculateDegree,
+  calculateRotatedRectAABB,
+  calculateRotatedRectAABBAroundPoint,
   combinePdfColorWithAlpha,
   combineWebColorWithOpacity,
   compareSearchTarget,
@@ -2100,12 +2274,15 @@ export {
   extractWebOpacity,
   flagsToNames,
   getBlendModeInfo,
+  getRectCenter,
   getStandardFontDescriptor,
   getTextAlignmentInfo,
   ignore,
+  inferRotationCenterFromRects,
   isUuidV4,
   makeStandardFont,
   namesToFlags,
+  normalizeAngle,
   pdfAlphaColorToWebAlphaColor,
   pdfAlphaToWebOpacity,
   pdfColorToWebColor,
@@ -2121,12 +2298,15 @@ export {
   restorePosition,
   restoreRect,
   rotateAndTranslatePoint,
+  rotatePointAround,
   rotatePosition,
   rotateRect,
+  rotateVertices,
   scalePosition,
   scaleRect,
   serializeLogger,
   standardFontCss,
+  standardFontCssProperties,
   standardFontFamily,
   standardFontFamilyLabel,
   standardFontFamilySelectOptions,