@miragon/modeler-api 1.2.0 → 1.3.0

package/dist/conformance.js

@@ -1,7 +1,7 @@
 import {
   MODELER_API_VERSION,
   apiVersionsCompatible
-} from "./chunk-E6KJB7QH.js";
+} from "./chunk-JK23ZTVG.js";
 
 // src/conformance.ts
 function attachedHost(width = 800, height = 600) {
@@ -28,6 +28,52 @@ var same = (a, b) => JSON.stringify(a) === JSON.stringify(b);
 var hasBounds = (elements) => typeof elements.bounds === "function";
 var isFiniteBox = (box) => box !== void 0 && [box.x, box.y, box.width, box.height].every((n) => typeof n === "number" && Number.isFinite(n)) && box.width >= 0 && box.height >= 0;
 var describeBox = (box) => box === void 0 ? "undefined" : `{ x: ${box.x}, y: ${box.y}, width: ${box.width}, height: ${box.height} }`;
+var hasContentBounds = (m) => typeof m.contentBounds === "function";
+var edgeTolerance = (edge) => Math.max(1e-3, Math.abs(edge) * 2 ** -20);
+var covers = (outer, inner) => {
+  const right = outer.x + outer.width;
+  const bottom = outer.y + outer.height;
+  return inner.x >= outer.x - edgeTolerance(outer.x) && inner.y >= outer.y - edgeTolerance(outer.y) && inner.x + inner.width <= right + edgeTolerance(right) && inner.y + inner.height <= bottom + edgeTolerance(bottom);
+};
+function contentBoxOf(m, when) {
+  let box;
+  try {
+    box = m.contentBounds();
+  } catch (e) {
+    fail(`contentBounds() threw ${when}: ${String(e)}`);
+  }
+  if (box === void 0) return void 0;
+  if (!isFiniteBox(box)) {
+    fail(
+      `contentBounds() ${when} is ${describeBox(box)} \u2014 the content box must be finite with a non-negative size, or undefined when there is nothing to fit`
+    );
+  }
+  return { x: box.x, y: box.y, width: box.width, height: box.height };
+}
+function expectContentAroundElements(m, when) {
+  const box = contentBoxOf(m, when);
+  const listed = m.elements?.list() ?? [];
+  if (box === void 0) {
+    if (listed.length > 0) {
+      fail(
+        `contentBounds() ${when} is undefined while elements.list() reports ${listed.length} element(s) \u2014 undefined means there is nothing to fit`
+      );
+    }
+    return void 0;
+  }
+  if (m.elements && hasBounds(m.elements)) {
+    for (const { id } of listed) {
+      const element = m.elements.bounds(id);
+      if (!isFiniteBox(element)) continue;
+      if (!covers(box, element)) {
+        fail(
+          `contentBounds() ${when} is ${describeBox(box)}, which does not cover elements.bounds('${id}') = ${describeBox(element)} \u2014 the content box holds every element (and reads the live canvas)`
+        );
+      }
+    }
+  }
+  return box;
+}
 function boxesOf(elements, when) {
   const boxes = /* @__PURE__ */ new Map();
   for (const { id } of elements.list()) {
@@ -903,6 +949,58 @@ ${out}`;
         }
       }
     },
+    {
+      name: "contentBounds (when present): a finite box in diagram coordinates around every listed element, live after a new element, unchanged by zoom and scroll",
+      async run(h) {
+        const settle = h.settle ?? defaultSettle;
+        const m = await h.create();
+        let viewer;
+        try {
+          if (!hasContentBounds(m))
+            return skip("the modeler exposes no contentBounds (optional, 1.3) \u2014 nothing to verify");
+          contentBoxOf(m, "before the first import");
+          for (const [index, text] of h.canonicalTexts.entries()) {
+            await importOrFail(m, text, `importText(canonicalTexts[${index}]) rejected`);
+            expectContentAroundElements(m, `after importing canonicalTexts[${index}]`);
+          }
+          await importOrFail(m, h.canonicalTexts[0] ?? "", "importText(canonicalTexts[0]) rejected");
+          await h.mutate(m);
+          await settle();
+          const atRest = expectContentAroundElements(m, "after a user mutation added an element");
+          const unverified = [];
+          if (h.viewState !== void 0) {
+            m.setViewState(h.viewState);
+            const viewed = contentBoxOf(m, "after setViewState");
+            if (!same(viewed, atRest)) {
+              fail(
+                `contentBounds() changed with the view (${describeBox(atRest)} \u2192 ${describeBox(viewed)}) \u2014 the content box is in diagram coordinates, which zoom and scroll leave alone`
+              );
+            }
+          } else {
+            unverified.push(
+              "viewState is undefined \u2014 that the content box is independent of the view was not verified"
+            );
+          }
+          if (!m.elements || !hasBounds(m.elements)) {
+            unverified.push(
+              "the modeler exposes no elements.bounds \u2014 that the content box covers every element was not verified"
+            );
+          }
+          if (h.createReadonly) {
+            viewer = await h.createReadonly();
+            if (hasContentBounds(viewer)) {
+              contentBoxOf(viewer, "on the viewer before the first import");
+              await importOrFail(viewer, h.canonicalTexts[0] ?? "", "the viewer rejected canonicalTexts[0]");
+              expectContentAroundElements(viewer, "on the viewer after an import");
+            }
+          }
+          if (unverified.length > 0) return skip(unverified.join("; "));
+        } finally {
+          m.destroy();
+          viewer?.destroy();
+        }
+      }
+    },
     {
       name: "L6: export is total after imports, user mutations and undo",
       async run(h) {