flo-mat 3.0.15 → 4.0.1

package/__tests__/cp-node/compare-cp-nodes-by-value.ts

@@ -19,14 +19,16 @@ function compareCpNodesByValue(
         reachCpNodes1.add(cpNode1);
         reachCpNodes2.add(cpNode2);
 
-        if (!comparePossByValue(cpNode1.cp.pointOnShape, cpNode2.cp.pointOnShape)) {
+        if (!comparePossByValue(cpNode1.pointOnShape, cpNode2.pointOnShape)) {
             return false;
         }
         
-        cpNode2.cp.pointOnShape;
+        cpNode2.pointOnShape;
     }
 
-    if (reachCpNodes1.size !== reachCpNodes2.size) { return false; }
+    if (reachCpNodes1.size !== reachCpNodes2.size) {
+        return false;
+    }
 
     return true;
 }

package/__tests__/cp-node/compare-poss-by-value.ts

@@ -1,4 +1,4 @@
-import { PointOnShape } from "../../src/point-on-shape/point-on-shape.js";
+import type { PointOnShape } from "../../src/point-on-shape/point-on-shape.js";
 
 
 function comparePossByValue(
@@ -11,12 +11,12 @@ function comparePossByValue(
     if (pos1.curve.idx !== pos2.curve.idx) { return false; }
     if (pos1.curve.loop.idx !== pos2.curve.loop.idx) { return false; }
     if (pos1.isSource !== pos2.isSource) { return false; }
-
-    for (let i=0; i<pos1.p.length; i++) {
-        if (pos1.p[i] !== pos2.p[i]) {
-            return false;
-        }
-    }
+    if (pos1.circle.center[0] !== pos2.circle.center[0]) { return false; }
+    if (pos1.circle.center[1] !== pos2.circle.center[1]) { return false; }
+    if (pos1.circle.radius !== pos2.circle.radius) { return false; }
+    if (pos1.order !== pos2.order) { return false; }
+    if (pos1.order2 !== pos2.order2) { return false; }
+    if (pos1.t !== pos2.t) { return false; }
 
     return true;
 }

package/__tests__/cp-node/fs/get-all-on-circle.spec.ts

@@ -18,10 +18,10 @@ test('CpNodeFs -> getAllOnCircle', function() {
 
     expect(cpNode === cpNode_.nextOnCircle).toBe(true);
 
-    expect(cpNode_.cp.pointOnShape.p).toEqual([24,8]);
-    expect(cpNode_.cp.pointOnShape.t).toEqual(1);
-    expect(cpNode_.cp.pointOnShape.isSource).toEqual(true);
-    expect(cpNode_.cp.circle).toEqual({ center: [ 24, 8 ], radius: 0 });
+    expect(cpNode_.pointOnShape.p).toEqual([24,8]);
+    expect(cpNode_.pointOnShape.t).toEqual(1);
+    expect(cpNode_.pointOnShape.isSource).toEqual(true);
+    expect(cpNode_.pointOnShape.circle).toEqual({ center: [ 24, 8 ], radius: 0 });
 
     // Real test starts here...
 
@@ -79,14 +79,14 @@ test('CpNodeFs -> getAllOnCircle', function() {
 
         const cpNodes = getAllOnCircle(cpNode1);
         expect(cpNodes.length).toBe(2);
-        expect(cpNodes[0].cp.pointOnShape.p).toEqual([24,8]);
-        expect(cpNodes[1].cp.pointOnShape.p).toEqual([24,8]);
+        expect(cpNodes[0].pointOnShape.p).toEqual([24,8]);
+        expect(cpNodes[1].pointOnShape.p).toEqual([24,8]);
 
         const cpNodesExcl = getAllOnCircle(cpNode1, true);
         expect(cpNodesExcl.length).toBe(1);
         expect(cpNodesExcl[0] === cpNode1).toBe(false);
-        expect(cpNodesExcl[0].cp.pointOnShape.p).toEqual([24,8]);
+        expect(cpNodesExcl[0].pointOnShape.p).toEqual([24,8]);
 
-        expect(cpNodes[0].cp.circle.radius).toBe(0);
+        expect(cpNodes[0].pointOnShape.circle.radius).toBe(0);
     }
 });

package/__tests__/cp-node/fs/is-one-prong.spec.ts

@@ -4,15 +4,15 @@ import { getAllOnLoop } from '../../../src/cp-node/fs/get-all-on-loop.js';
 import { getMats1 } from '../../get-mats1.js';
 
 
-test('isOneProng', function() {
+test('`isOneProng`', function() {
     const { cpNode } = getMats1()[0];
     const allOnLoop = getAllOnLoop(cpNode);
 
     for (const n of allOnLoop) {
         if (isOneProng(n)) {
             // One-prong: nextOnCircle is at the same position
-            const p1 = n.cp.pointOnShape.p;
-            const p2 = n.nextOnCircle.cp.pointOnShape.p;
+            const p1 = n.pointOnShape.p;
+            const p2 = n.nextOnCircle.pointOnShape.p;
             expect(p1[0]).toBe(p2[0]);
             expect(p1[1]).toBe(p2[1]);
         }

package/__tests__/cp-node/fs/is-sharp.spec.ts

@@ -9,6 +9,6 @@ test('isSharp', function() {
     const allOnLoop = getAllOnLoop(cpNode);
 
     for (const n of allOnLoop) {
-        expect(isSharp(n)).toBe(n.cp.circle.radius === 0);
+        expect(isSharp(n)).toBe(n.pointOnShape.circle.radius === 0);
     }
 });

package/__tests__/get-mats1.ts

@@ -15,18 +15,16 @@ function getMats1() {
                 id: 0,
                 isHoleClosing: false,
                 isIntersection: false,
-                cp: {
+                pointOnShape: {
                     circle: {
                         center: [24,8],
                         radius: 0
                     },
-                    pointOnShape: {
-                        curveIdx: 0,
-                        loopIdx: 0,
-                        p: [24, 8],
-                        t: 1,
-                        isSource: true
-                    },
+                    curveIdx: 0,
+                    loopIdx: 0,
+                    p: [24, 8],
+                    t: 1,
+                    isSource: true,
                     order: -1,
                     order2: 0
                 },
@@ -35,28 +33,28 @@ function getMats1() {
                 prevOnCircle: 1,
                 nextOnCircle: 1
             },
-            { id: 1,   isHoleClosing: false, isIntersection: false, cp: { circle: { center: [24, 8],                           radius: 0                    }, pointOnShape: { curveIdx: 0, loopIdx: 0, p: [24, 8],                           t: 1,                    isSource: true  }, order: 1,                     order2: 0 }, prev: 0,   next: 10,  prevOnCircle: 0,   nextOnCircle: 0   },
-            { id: 10,  isHoleClosing: false, isIntersection: false, cp: { circle: { center: [46, -5.21425847941623],           radius: 13.21425847941623    }, pointOnShape: { curveIdx: 1, loopIdx: 0, p: [46, 8],                           t: 1,                    isSource: true  }, order: -1,                    order2: 0 }, prev: 1,   next: 144, prevOnCircle: 11,  nextOnCircle: 11  },
-            { id: 144, isHoleClosing: false, isIntersection: false, cp: { circle: { center: [81.5, -12.641417453935567],       radius: 41.064803841095305   }, pointOnShape: { curveIdx: 1, loopIdx: 0, p: [46, 8],                           t: 1,                    isSource: false }, order: -0.5026547194480646,   order2: 0 }, prev: 10,  next: 147, prevOnCircle: 143, nextOnCircle: 142 },
-            { id: 147, isHoleClosing: false, isIntersection: false, cp: { circle: { center: [81.5, 18.5],                     radius: 35.5                 }, pointOnShape: { curveIdx: 2, loopIdx: 0, p: [46, 18.499999999999996],           t: 0.2282608695652173,   isSource: false }, order: 0,                     order2: 0 }, prev: 144, next: 2,   prevOnCircle: 146, nextOnCircle: 145 },
-            { id: 2,   isHoleClosing: false, isIntersection: false, cp: { circle: { center: [46, 54],                         radius: 0                    }, pointOnShape: { curveIdx: 2, loopIdx: 0, p: [46, 54],                          t: 1,                    isSource: true  }, order: -1,                    order2: 0 }, prev: 147, next: 3,   prevOnCircle: 3,   nextOnCircle: 3   },
-            { id: 3,   isHoleClosing: false, isIntersection: false, cp: { circle: { center: [46, 54],                         radius: 0                    }, pointOnShape: { curveIdx: 2, loopIdx: 0, p: [46, 54],                          t: 1,                    isSource: true  }, order: 1,                     order2: 0 }, prev: 2,   next: 145, prevOnCircle: 2,   nextOnCircle: 2   },
-            { id: 145, isHoleClosing: false, isIntersection: false, cp: { circle: { center: [81.5, 18.5],                     radius: 35.5                 }, pointOnShape: { curveIdx: 3, loopIdx: 0, p: [81.5, 54],                        t: 0.5,                  isSource: false }, order: 0,                     order2: 0 }, prev: 3,   next: 4,   prevOnCircle: 147, nextOnCircle: 146 },
-            { id: 4,   isHoleClosing: false, isIntersection: false, cp: { circle: { center: [117, 54],                        radius: 0                    }, pointOnShape: { curveIdx: 3, loopIdx: 0, p: [117, 54],                         t: 1,                    isSource: true  }, order: -1,                    order2: 0 }, prev: 145, next: 5,   prevOnCircle: 5,   nextOnCircle: 5   },
-            { id: 5,   isHoleClosing: false, isIntersection: false, cp: { circle: { center: [117, 54],                        radius: 0                    }, pointOnShape: { curveIdx: 3, loopIdx: 0, p: [117, 54],                         t: 1,                    isSource: true  }, order: 1,                     order2: 0 }, prev: 4,   next: 146, prevOnCircle: 4,   nextOnCircle: 4   },
-            { id: 146, isHoleClosing: false, isIntersection: false, cp: { circle: { center: [81.5, 18.5],                     radius: 35.5                 }, pointOnShape: { curveIdx: 4, loopIdx: 0, p: [117, 18.499999999999996],          t: 0.7717391304347827,   isSource: false }, order: 0,                     order2: 0 }, prev: 5,   next: 142, prevOnCircle: 145, nextOnCircle: 147 },
-            { id: 142, isHoleClosing: false, isIntersection: false, cp: { circle: { center: [81.5, -12.641417453935567],       radius: 41.064803841095305   }, pointOnShape: { curveIdx: 4, loopIdx: 0, p: [117, 8],                          t: 1,                    isSource: false }, order: -0.8644872659655476,   order2: 0 }, prev: 146, next: 148, prevOnCircle: 144, nextOnCircle: 143 },
-            { id: 148, isHoleClosing: false, isIntersection: false, cp: { circle: { center: [81.68410160768288, -12.970446490933696], radius: 41.07276841516263  }, pointOnShape: { curveIdx: 4, loopIdx: 0, p: [117, 8],                   t: 1,                    isSource: false }, order: -0.8598373023056252,   order2: 0 }, prev: 142, next: 119, prevOnCircle: 150, nextOnCircle: 149 },
-            { id: 119, isHoleClosing: false, isIntersection: false, cp: { circle: { center: [115.9110440340909, -5.952334953607174], radius: 13.994766012811272  }, pointOnShape: { curveIdx: 4, loopIdx: 0, p: [117, 8],                   t: 1,                    isSource: false }, order: -0.07781165936695383,  order2: 0 }, prev: 148, next: 6,   prevOnCircle: 118, nextOnCircle: 118 },
-            { id: 6,   isHoleClosing: false, isIntersection: false, cp: { circle: { center: [139, 8],                          radius: 0                    }, pointOnShape: { curveIdx: 5, loopIdx: 0, p: [139, 8],                          t: 1,                    isSource: true  }, order: -1,                    order2: 0 }, prev: 119, next: 7,   prevOnCircle: 7,   nextOnCircle: 7   },
-            { id: 7,   isHoleClosing: false, isIntersection: false, cp: { circle: { center: [139, 8],                          radius: 0                    }, pointOnShape: { curveIdx: 5, loopIdx: 0, p: [139, 8],                          t: 1,                    isSource: true  }, order: 1,                     order2: 0 }, prev: 6,   next: 118, prevOnCircle: 6,   nextOnCircle: 6   },
-            { id: 118, isHoleClosing: false, isIntersection: false, cp: { circle: { center: [115.9110440340909, -5.952334953607174], radius: 13.994766012811272  }, pointOnShape: { curveIdx: 6, loopIdx: 0, p: [128.3125, -12.4375],         t: 0.1875,               isSource: true  }, order: 0,                     order2: 0 }, prev: 7,   next: 149, prevOnCircle: 119, nextOnCircle: 119 },
-            { id: 149, isHoleClosing: false, isIntersection: false, cp: { circle: { center: [81.68410160768288, -12.970446490933696], radius: 41.07276841516263  }, pointOnShape: { curveIdx: 6, loopIdx: 0, p: [118.08071791640388, -32.003539423017145], t: 0.36700494883501966, isSource: false }, order: 0, order2: 0 }, prev: 118, next: 8,   prevOnCircle: 148, nextOnCircle: 150 },
-            { id: 8,   isHoleClosing: false, isIntersection: false, cp: { circle: { center: [82, -101],                        radius: 0                    }, pointOnShape: { curveIdx: 6, loopIdx: 0, p: [82, -101],                        t: 1,                    isSource: true  }, order: -1,                    order2: 0 }, prev: 149, next: 9,   prevOnCircle: 9,   nextOnCircle: 9   },
-            { id: 9,   isHoleClosing: false, isIntersection: false, cp: { circle: { center: [82, -101],                        radius: 0                    }, pointOnShape: { curveIdx: 6, loopIdx: 0, p: [82, -101],                        t: 1,                    isSource: true  }, order: 1,                     order2: 0 }, prev: 8,   next: 150, prevOnCircle: 8,   nextOnCircle: 8   },
-            { id: 150, isHoleClosing: false, isIntersection: false, cp: { circle: { center: [81.68410160768288, -12.970446490933696], radius: 41.07276841516263  }, pointOnShape: { curveIdx: 0, loopIdx: 0, p: [45.425023320690585, -32.264267964746104],  t: 0.6306030461949899, isSource: false }, order: 0, order2: 0 }, prev: 9,   next: 143, prevOnCircle: 149, nextOnCircle: 148 },
-            { id: 143, isHoleClosing: false, isIntersection: false, cp: { circle: { center: [81.5, -12.641417453935567],         radius: 41.064803841095305   }, pointOnShape: { curveIdx: 0, loopIdx: 0, p: [45.24795284642707, -31.931497590699145],   t: 0.6336559854064299, isSource: false }, order: 0, order2: 0 }, prev: 150, next: 11,  prevOnCircle: 142, nextOnCircle: 144 },
-            { id: 11,  isHoleClosing: false, isIntersection: false, cp: { circle: { center: [46, -5.21425847941623],            radius: 13.21425847941623    }, pointOnShape: { curveIdx: 0, loopIdx: 0, p: [34.33444028251029, -11.421620530924521],   t: 0.8218199951291328, isSource: false }, order: 0, order2: 0 }, prev: 143, next: 0,   prevOnCircle: 10,  nextOnCircle: 10  }
+            { id: 1,   isHoleClosing: false, isIntersection: false, pointOnShape: { circle: { center: [24, 8],                           radius: 0                    }, curveIdx: 0, loopIdx: 0, p: [24, 8],                           t: 1,                    isSource: true  , order: 1,                     order2: 0 }, prev: 0,   next: 10,  prevOnCircle: 0,   nextOnCircle: 0   },
+            { id: 10,  isHoleClosing: false, isIntersection: false, pointOnShape: { circle: { center: [46, -5.21425847941623],           radius: 13.21425847941623    }, curveIdx: 1, loopIdx: 0, p: [46, 8],                           t: 1,                    isSource: true  , order: -1,                    order2: 0 }, prev: 1,   next: 144, prevOnCircle: 11,  nextOnCircle: 11  },
+            { id: 144, isHoleClosing: false, isIntersection: false, pointOnShape: { circle: { center: [81.5, -12.641417453935567],       radius: 41.064803841095305   }, curveIdx: 1, loopIdx: 0, p: [46, 8],                           t: 1,                    isSource: false , order: -0.5026547194480646,   order2: 0 }, prev: 10,  next: 147, prevOnCircle: 143, nextOnCircle: 142 },
+            { id: 147, isHoleClosing: false, isIntersection: false, pointOnShape: { circle: { center: [81.5, 18.5],                     radius: 35.5                 }, curveIdx: 2, loopIdx: 0, p: [46, 18.499999999999996],           t: 0.2282608695652173,   isSource: false , order: 0,                     order2: 0 }, prev: 144, next: 2,   prevOnCircle: 146, nextOnCircle: 145 },
+            { id: 2,   isHoleClosing: false, isIntersection: false, pointOnShape: { circle: { center: [46, 54],                         radius: 0                    }, curveIdx: 2, loopIdx: 0, p: [46, 54],                          t: 1,                    isSource: true  , order: -1,                    order2: 0 }, prev: 147, next: 3,   prevOnCircle: 3,   nextOnCircle: 3   },
+            { id: 3,   isHoleClosing: false, isIntersection: false, pointOnShape: { circle: { center: [46, 54],                         radius: 0                    }, curveIdx: 2, loopIdx: 0, p: [46, 54],                          t: 1,                    isSource: true  , order: 1,                     order2: 0 }, prev: 2,   next: 145, prevOnCircle: 2,   nextOnCircle: 2   },
+            { id: 145, isHoleClosing: false, isIntersection: false, pointOnShape: { circle: { center: [81.5, 18.5],                     radius: 35.5                 }, curveIdx: 3, loopIdx: 0, p: [81.5, 54],                        t: 0.5,                  isSource: false , order: 0,                     order2: 0 }, prev: 3,   next: 4,   prevOnCircle: 147, nextOnCircle: 146 },
+            { id: 4,   isHoleClosing: false, isIntersection: false, pointOnShape: { circle: { center: [117, 54],                        radius: 0                    }, curveIdx: 3, loopIdx: 0, p: [117, 54],                         t: 1,                    isSource: true  , order: -1,                    order2: 0 }, prev: 145, next: 5,   prevOnCircle: 5,   nextOnCircle: 5   },
+            { id: 5,   isHoleClosing: false, isIntersection: false, pointOnShape: { circle: { center: [117, 54],                        radius: 0                    }, curveIdx: 3, loopIdx: 0, p: [117, 54],                         t: 1,                    isSource: true  , order: 1,                     order2: 0 }, prev: 4,   next: 146, prevOnCircle: 4,   nextOnCircle: 4   },
+            { id: 146, isHoleClosing: false, isIntersection: false, pointOnShape: { circle: { center: [81.5, 18.5],                     radius: 35.5                 }, curveIdx: 4, loopIdx: 0, p: [117, 18.499999999999996],          t: 0.7717391304347827,   isSource: false , order: 0,                     order2: 0 }, prev: 5,   next: 142, prevOnCircle: 145, nextOnCircle: 147 },
+            { id: 142, isHoleClosing: false, isIntersection: false, pointOnShape: { circle: { center: [81.5, -12.641417453935567],       radius: 41.064803841095305   }, curveIdx: 4, loopIdx: 0, p: [117, 8],                          t: 1,                    isSource: false , order: -0.8644872659655476,   order2: 0 }, prev: 146, next: 148, prevOnCircle: 144, nextOnCircle: 143 },
+            { id: 148, isHoleClosing: false, isIntersection: false, pointOnShape: { circle: { center: [81.68410160768288, -12.970446490933696], radius: 41.07276841516263  }, curveIdx: 4, loopIdx: 0, p: [117, 8],                   t: 1,                    isSource: false , order: -0.8598373023056252,   order2: 0 }, prev: 142, next: 119, prevOnCircle: 150, nextOnCircle: 149 },
+            { id: 119, isHoleClosing: false, isIntersection: false, pointOnShape: { circle: { center: [115.9110440340909, -5.952334953607174], radius: 13.994766012811272  }, curveIdx: 4, loopIdx: 0, p: [117, 8],                   t: 1,                    isSource: false , order: -0.07781165936695383,  order2: 0 }, prev: 148, next: 6,   prevOnCircle: 118, nextOnCircle: 118 },
+            { id: 6,   isHoleClosing: false, isIntersection: false, pointOnShape: { circle: { center: [139, 8],                          radius: 0                    }, curveIdx: 5, loopIdx: 0, p: [139, 8],                          t: 1,                    isSource: true  , order: -1,                    order2: 0 }, prev: 119, next: 7,   prevOnCircle: 7,   nextOnCircle: 7   },
+            { id: 7,   isHoleClosing: false, isIntersection: false, pointOnShape: { circle: { center: [139, 8],                          radius: 0                    }, curveIdx: 5, loopIdx: 0, p: [139, 8],                          t: 1,                    isSource: true  , order: 1,                     order2: 0 }, prev: 6,   next: 118, prevOnCircle: 6,   nextOnCircle: 6   },
+            { id: 118, isHoleClosing: false, isIntersection: false, pointOnShape: { circle: { center: [115.9110440340909, -5.952334953607174], radius: 13.994766012811272  }, curveIdx: 6, loopIdx: 0, p: [128.3125, -12.4375],         t: 0.1875,               isSource: true  , order: 0,                     order2: 0 }, prev: 7,   next: 149, prevOnCircle: 119, nextOnCircle: 119 },
+            { id: 149, isHoleClosing: false, isIntersection: false, pointOnShape: { circle: { center: [81.68410160768288, -12.970446490933696], radius: 41.07276841516263  }, curveIdx: 6, loopIdx: 0, p: [118.08071791640388, -32.003539423017145], t: 0.36700494883501966, isSource: false , order: 0, order2: 0 }, prev: 118, next: 8,   prevOnCircle: 148, nextOnCircle: 150 },
+            { id: 8,   isHoleClosing: false, isIntersection: false, pointOnShape: { circle: { center: [82, -101],                        radius: 0                    }, curveIdx: 6, loopIdx: 0, p: [82, -101],                        t: 1,                    isSource: true  , order: -1,                    order2: 0 }, prev: 149, next: 9,   prevOnCircle: 9,   nextOnCircle: 9   },
+            { id: 9,   isHoleClosing: false, isIntersection: false, pointOnShape: { circle: { center: [82, -101],                        radius: 0                    }, curveIdx: 6, loopIdx: 0, p: [82, -101],                        t: 1,                    isSource: true  , order: 1,                     order2: 0 }, prev: 8,   next: 150, prevOnCircle: 8,   nextOnCircle: 8   },
+            { id: 150, isHoleClosing: false, isIntersection: false, pointOnShape: { circle: { center: [81.68410160768288, -12.970446490933696], radius: 41.07276841516263  }, curveIdx: 0, loopIdx: 0, p: [45.425023320690585, -32.264267964746104],  t: 0.6306030461949899, isSource: false , order: 0, order2: 0 }, prev: 9,   next: 143, prevOnCircle: 149, nextOnCircle: 148 },
+            { id: 143, isHoleClosing: false, isIntersection: false, pointOnShape: { circle: { center: [81.5, -12.641417453935567],         radius: 41.064803841095305   }, curveIdx: 0, loopIdx: 0, p: [45.24795284642707, -31.931497590699145],   t: 0.6336559854064299, isSource: false , order: 0, order2: 0 }, prev: 150, next: 11,  prevOnCircle: 142, nextOnCircle: 144 },
+            { id: 11,  isHoleClosing: false, isIntersection: false, pointOnShape: { circle: { center: [46, -5.21425847941623],            radius: 13.21425847941623    }, curveIdx: 0, loopIdx: 0, p: [34.33444028251029, -11.421620530924521],   t: 0.8218199951291328, isSource: false , order: 0, order2: 0 }, prev: 143, next: 0,   prevOnCircle: 10,  nextOnCircle: 10  }
         ],
         loops: [
             { idx: 0, beziers: [[[82, -101], [24, 8]], [[24, 8], [46, 8]], [[46, 8], [46, 54]], [[46, 54], [117, 54]], [[117, 54], [117, 8]], [[117, 8], [139, 8]], [[139, 8], [82, -101]]] }
@@ -72,8 +70,7 @@ function getMats1() {
         dullCorners: undefined!,
         lastInsertId: undefined!,
         looseBoundingBoxes: undefined!,
-        maxCoordinate: undefined!,
-        pointToCpNode: undefined!,
+        maxCoordPowerOf2: undefined!,
         sharpCorners: undefined!,
         squaredDiagonalLength: undefined!,
         tightBoundingBoxes: undefined!

package/__tests__/helpers/close-to.ts

@@ -0,0 +1,71 @@
+import type { ObjOrArray } from "./obj-or-array.js";
+
+const { EPSILON: eps, POSITIVE_INFINITY: inf } = Number;
+const abs = Math.abs;
+
+
+/**
+ * @param ulpsOrEps If a number then 2\*\*1 means last bit, 2\*\*2 means last 2 bits, etc... 
+ * else if an array containing a single number then 1 means 1 eps, 2 means 2 eps, etc...
+ */
+function closeTo(ulpsOrEps: number | number[]) {
+    let isUlps = true;
+    if (Array.isArray(ulpsOrEps)) {
+        isUlps = false;
+        ulpsOrEps = ulpsOrEps[0];
+    }
+
+    function check(
+            expected: ObjOrArray<number>,
+            actual: ObjOrArray<number>): boolean {
+
+        if (typeof expected === 'number') {
+            if (typeof actual !== 'number') { return false; }
+            const actual_ = actual as number;
+            if (expected === inf) { return actual_ === inf; }
+            const error = abs((isUlps ? expected : 1)*(ulpsOrEps as number)*eps);
+            
+            return (
+                (actual_ >= expected - error) && 
+                (actual_ <= expected + error)
+            );
+        }
+
+        if (Array.isArray(expected)) {
+            if (!Array.isArray(actual)) { return false; }
+            if (expected.length !== actual.length) { return false; }
+
+            for (let i=0; i<expected.length; i++) {
+                const e = expected[i];
+                const a = actual[i];
+    
+                if (!check(e,a)) { return false; }
+            }
+
+            return true;
+        }
+        
+        if (typeof expected === 'object') {
+            if (typeof actual !== 'object') { return false; }
+            const actual_ = actual as { [key: string]: ObjOrArray<number> };
+            const keys = Object.keys(expected);
+            const keysE = Object.keys(actual_);
+            if (keys.length !== keysE.length) { return false; }
+            for (let key of keys) {
+                const e = expected[key];
+                const a = actual_[key];
+
+                if (!check(e,a)) { return false; }
+            }
+
+            return true;
+        }
+
+        return false;  // unsupported types
+    }
+
+    return check;
+}
+
+
+export { closeTo }

package/__tests__/helpers/jest-extend-nearly.ts

@@ -0,0 +1,39 @@
+import type { MatcherContext, SyncExpectationResult } from 'expect';
+import { closeTo } from "./close-to.js";
+import { ObjOrArray } from "./obj-or-array.js";
+
+
+/**
+ * Jest custom matcher equivalent of the old Chai `nearly` plugin.
+ *
+ * Register once (e.g. in a setup file or at the top of a spec) via:
+ *     expect.extend(nearly);
+ *
+ * Then use as:
+ *     expect(received).toBeNearly(2**4, expectedValue);
+ *     expect(received).not.toBeNearly([2], expectedValue);
+ */
+const nearly = {
+    toBeNearly(
+        this: MatcherContext,
+        received: ObjOrArray<number>,
+        ulpsOrEps: number | number[],
+        value: ObjOrArray<number>,
+    ): SyncExpectationResult {
+        const isUlps = !Array.isArray(ulpsOrEps);
+
+        // Preserve the original argument order: `received` plays the role of
+        // `expected` in `closeTo` (it scales the ulp error), `value` the `actual`.
+        const pass = closeTo(ulpsOrEps)(received, value);
+
+        return {
+            pass,
+            message: () =>
+                `expected \n${JSON.stringify(received)}\n to ${this.isNot ? 'not ' : ''}be nearly ` +
+                `(${ulpsOrEps} ${isUlps ? 'ulps' : 'eps'}) \n${JSON.stringify(value)}`,
+        };
+    },
+};
+
+
+export { nearly }

package/__tests__/helpers/jest.setup.ts

@@ -0,0 +1,6 @@
+import { expect } from '@jest/globals';
+import { nearly } from './jest-extend-nearly.js';
+
+
+// Register custom matchers globally for all test files.
+expect.extend(nearly);

package/__tests__/helpers/obj-or-array.ts

@@ -0,0 +1,8 @@
+
+type ObjOrArray<T> = 
+    | T
+    | ObjOrArray<T>[]
+    | { [key:string]: ObjOrArray<T> };
+
+    
+export { ObjOrArray }

package/__tests__/jest-extensions.d.ts

@@ -0,0 +1,26 @@
+
+declare global {
+    namespace jest {
+        interface Matchers<R, T = {}> {
+            /**
+             * @param ulps If a number then 2\*\*1 means last bit, 2\*\*2 means last 2 bits, etc...
+             * else if an array containing a single number then 1 means 1 eps, 2 means 2 eps, etc...
+             */
+            toBeNearly(ulps: number | number[], value: T): R;
+        }
+    }
+}
+
+
+// Augment the matchers exposed by `@jest/globals` / `expect`.
+declare module 'expect' {
+    interface Matchers<R extends void | Promise<void>, T = unknown> {
+        /**
+         * @param ulps If a number then 2\*\*1 means last bit, 2\*\*2 means last 2 bits, etc...
+         * else if an array containing a single number then 1 means 1 eps, 2 means 2 eps, etc...
+         */
+        toBeNearly(ulps: number | number[], value: T): R;
+    }
+}
+
+export {};

package/__tests__/lib-load.spec.ts

@@ -19,6 +19,6 @@ test('node require', function() {
         expect(result).toBeInstanceOf(Array);
         expect(result[0]).toBeInstanceOf(Object);
         expect(result[0].cpNode).toBeInstanceOf(Object);
-        expect(result[0].cpNode.cp).toBeInstanceOf(Object);
+        expect(result[0].cpNode.pointOnShape).toBeInstanceOf(Object);
 	})();
 });