Geometry

1export function round(value, precision = 3) {
2  const factor = 10 ** precision;
3  return Math.round(Number(value || 0) * factor) / factor;
4}
5
6export function normalizedRect(rect, frame) {
7  if (!rect || !frame) return null;
8  return {
9    x: round((Number(rect.left ?? rect.x) - Number(frame.left ?? frame.x ?? 0)) / Math.max(Number(frame.width), 1)),
10    y: round((Number(rect.top ?? rect.y) - Number(frame.top ?? frame.y ?? 0)) / Math.max(Number(frame.height), 1)),
11    width: round(Number(rect.width) / Math.max(Number(frame.width), 1)),
12    height: round(Number(rect.height) / Math.max(Number(frame.height), 1)),
13  };
14}
15
16export function placementFor(rect) {
17  if (!rect) return "center";
18  const centerX = Number(rect.x) + (Number(rect.width) / 2);
19  const centerY = Number(rect.y) + (Number(rect.height) / 2);
20  const horizontal = centerX < 0.38 ? "left" : centerX > 0.62 ? "right" : "center";
21  const vertical = centerY < 0.38 ? "top" : centerY > 0.62 ? "bottom" : "center";
22  return vertical === "center" && horizontal === "center" ? "center" : `${vertical}-${horizontal}`;
23}
24
25export function overlapRatio(first, second) {
26  if (!first || !second) return 0;
27  const left = Math.max(first.x, second.x);
28  const top = Math.max(first.y, second.y);
29  const right = Math.min(first.x + first.width, second.x + second.width);
30  const bottom = Math.min(first.y + first.height, second.y + second.height);
31  if (right <= left || bottom <= top) return 0;
32  const intersection = (right - left) * (bottom - top);
33  return round(intersection / Math.max(Math.min(first.width * first.height, second.width * second.height), 0.0001));
34}
35
36export function horizontalRelation(first, second) {
37  if (!first || !second) return "unknown";
38  const gap = 0.025;
39  if (first.x + first.width + gap <= second.x) return "before";
40  if (second.x + second.width + gap <= first.x) return "after";
41  return "overlap";
42}
43