@jbrowse/bandage-core 6.0.1 → 6.0.3

package/README.md

@@ -23,7 +23,7 @@ npm install @jbrowse/bandage-core
 - Figures: `figureSvg` draws a graph and its lifted walks to a standalone SVG,
   and the `bandage-figure` CLI makes one from a JSON spec with no browser:
   `npx -p @jbrowse/bandage-core bandage-figure spec.json -o figure.svg`. See
-  [docs/figures.md](https://github.com/GMOD/jbrowse-plugin-graphgenomeviewer/blob/main/docs/figures.md)
+  [docs/figures.md](docs/figures.md)
 
 Nothing here imports React, MobX or a JBrowse host. BandageJS's
 [`src/main.ts`](https://github.com/cmdcolin/BandageJS/blob/main/src/main.ts) is
@@ -31,10 +31,26 @@ the worked example.
 
 ## Developing
 
-Lives in the plugin repo as a pnpm workspace package. The plugin imports its
-source directly, so a change here needs no publish to reach the plugin.
+```
+pnpm install
+pnpm test          # unit tests
+pnpm build         # dist/ with declarations
+pnpm test:wasm     # the committed layout engine still loads
+```
+
+The Bandage layout engine is OGDF's FMMM compiled to WASM and committed at
+`src/bandage/bandage-layout.js`; [src/bandage/README.md](src/bandage/README.md)
+says how to rebuild it from `src/bandage/native` and the vendored `vendor/ogdf`.
+A weekly workflow proves the committed artifact still reproduces.
+
+CI also packs the core and runs
+[BandageJS](https://github.com/cmdcolin/BandageJS) and
+[jbrowse-plugin-graphgenomeviewer](https://github.com/GMOD/jbrowse-plugin-graphgenomeviewer)
+against it. An API change lands with the consumer's side on a `core-next` branch
+in that repo, which CI tests in place of `main` until the release.
+
+Release with `pnpm version patch`: it lints, tests, stamps `src/version.ts`,
+writes the changelog with git-cliff and pushes the `v*` tag, and `publish.yml`
+publishes to npm with trusted publishing.
 
-The core releases with the plugin, at the plugin's version: `pnpm version patch`
-at the repo root sets both, and `publish.yml` and `publish-core.yml` each
-publish one from the `v*` tag. `publish-core.yml` also runs by hand to publish a
-version a failed run left behind.
+Both Bandage and OGDF are GPL, which is why this package is GPL-3.0-or-later.

package/dist/alleleProjection/projectAlleles.js

@@ -0,0 +1,10 @@
+import {
+  parsePanSN,
+  projectAlleles
+} from "../chunks/chunk-RVS2QCOX.js";
+import "../chunks/chunk-ES2N6V56.js";
+import "../chunks/chunk-FYQWPEEY.js";
+export {
+  parsePanSN,
+  projectAlleles
+};

package/dist/anchoredNodes.js

@@ -0,0 +1,24 @@
+import {
+  REFERENCE_RANK,
+  backboneNodes,
+  backbonePositions,
+  backboneSpan,
+  firstNodeAtOrAfter,
+  isAnchored,
+  isBackbone,
+  isOffReference,
+  overlapsWindow,
+  referenceSpan
+} from "./chunks/chunk-FYQWPEEY.js";
+export {
+  REFERENCE_RANK,
+  backboneNodes,
+  backbonePositions,
+  backboneSpan,
+  firstNodeAtOrAfter,
+  isAnchored,
+  isBackbone,
+  isOffReference,
+  overlapsWindow,
+  referenceSpan
+};

package/dist/bubbleSpreads.js

@@ -0,0 +1,11 @@
+import {
+  BUBBLE_SPREADS,
+  BUBBLE_SPREAD_VALUES,
+  spreadFor
+} from "./chunks/chunk-UVBGRJQX.js";
+import "./chunks/chunk-6JEWNXCQ.js";
+export {
+  BUBBLE_SPREADS,
+  BUBBLE_SPREAD_VALUES,
+  spreadFor
+};

package/dist/bubbles/bubbleHalos.js

@@ -0,0 +1,11 @@
+import {
+  bubbleHalos
+} from "../chunks/chunk-ISEI2FH3.js";
+import "../chunks/chunk-WOO7QYKB.js";
+import "../chunks/chunk-MFKORG3F.js";
+import "../chunks/chunk-2CVHXFK7.js";
+import "../chunks/chunk-CPMHA4W5.js";
+import "../chunks/chunk-FYQWPEEY.js";
+export {
+  bubbleHalos
+};

package/dist/bubbles/bubbleLine.js

@@ -0,0 +1,14 @@
+import {
+  SATURATED_PATH_COUNT,
+  bubbleDescription,
+  bubbleLabel,
+  parseBubbleLine,
+  sameBubble
+} from "../chunks/chunk-MFKORG3F.js";
+export {
+  SATURATED_PATH_COUNT,
+  bubbleDescription,
+  bubbleLabel,
+  parseBubbleLine,
+  sameBubble
+};

package/dist/bubbles/bubblesFromGraph.js

@@ -0,0 +1,10 @@
+import {
+  bubblesFromGraph
+} from "../chunks/chunk-4S47XRYA.js";
+import "../chunks/chunk-MFKORG3F.js";
+import "../chunks/chunk-HNQPEMYE.js";
+import "../chunks/chunk-CPMHA4W5.js";
+import "../chunks/chunk-FYQWPEEY.js";
+export {
+  bubblesFromGraph
+};

package/dist/bubbles/classifyBubble.js

@@ -0,0 +1,15 @@
+import {
+  BUBBLE_KIND_COLORS,
+  BUBBLE_KIND_NAMES,
+  bubbleSegmentIds,
+  classifyBubble,
+  formatBp
+} from "../chunks/chunk-WOO7QYKB.js";
+import "../chunks/chunk-MFKORG3F.js";
+export {
+  BUBBLE_KIND_COLORS,
+  BUBBLE_KIND_NAMES,
+  bubbleSegmentIds,
+  classifyBubble,
+  formatBp
+};

package/dist/bubbles/popBubble.js

@@ -0,0 +1,9 @@
+import {
+  bubbleSubgraph
+} from "../chunks/chunk-VHW7FDHU.js";
+import "../chunks/chunk-ST2IBUAN.js";
+import "../chunks/chunk-BPLIXMH7.js";
+import "../chunks/chunk-FYQWPEEY.js";
+export {
+  bubbleSubgraph
+};

package/dist/chunks/chunk-2CVHXFK7.js

@@ -0,0 +1,530 @@
+import {
+  ROW_HEIGHT_PX
+} from "./chunk-CPMHA4W5.js";
+
+// src/util/geometry.ts
+function svgPath(points) {
+  const round = (v) => Math.round(v * 100) / 100;
+  return points.map((p, i) => `${i ? "L" : "M"}${round(p.x)},${round(p.y)}`).join("");
+}
+function projectLine(x1, y1, x2, y2, distance) {
+  const d = Math.hypot(y2 - y1, x2 - x1);
+  if (d === 0) {
+    return [x2, y2];
+  }
+  const vx = (x2 - x1) / d;
+  const vy = (y2 - y1) / d;
+  return [x2 + distance * vx, y2 + distance * vy];
+}
+function curvePointAt(c, t) {
+  const u = 1 - t;
+  const a = u * u * u;
+  const b = 3 * u * u * t;
+  const d = 3 * u * t * t;
+  const e = t * t * t;
+  return {
+    x: a * c.x0 + b * c.cx0 + d * c.cx1 + e * c.x1,
+    y: a * c.y0 + b * c.cy0 + d * c.cy1 + e * c.y1
+  };
+}
+function curveMidpoint(curves) {
+  const mid = curves[Math.floor(curves.length / 2)];
+  return mid ? curvePointAt(mid, 0.5) : void 0;
+}
+function curveBounds(curves) {
+  let minX = Infinity;
+  let minY = Infinity;
+  let maxX = -Infinity;
+  let maxY = -Infinity;
+  for (const c of curves) {
+    minX = Math.min(minX, c.x0, c.cx0, c.cx1, c.x1);
+    maxX = Math.max(maxX, c.x0, c.cx0, c.cx1, c.x1);
+    minY = Math.min(minY, c.y0, c.cy0, c.cy1, c.y1);
+    maxY = Math.max(maxY, c.y0, c.cy0, c.cy1, c.y1);
+  }
+  return { minX, minY, maxX, maxY };
+}
+function subCurve(c, t0, t1) {
+  const p0 = curvePointAt(c, t0);
+  const p1 = curvePointAt(c, t1);
+  const dt = (t1 - t0) / 3;
+  const d0 = curveTangentAt(c, t0);
+  const d1 = curveTangentAt(c, t1);
+  return {
+    x0: p0.x,
+    y0: p0.y,
+    cx0: p0.x + d0.x * dt,
+    cy0: p0.y + d0.y * dt,
+    cx1: p1.x - d1.x * dt,
+    cy1: p1.y - d1.y * dt,
+    x1: p1.x,
+    y1: p1.y
+  };
+}
+function curveTangentAt(c, t) {
+  const u = 1 - t;
+  const a = 3 * u * u;
+  const b = 6 * u * t;
+  const d = 3 * t * t;
+  return {
+    x: a * (c.cx0 - c.x0) + b * (c.cx1 - c.cx0) + d * (c.x1 - c.cx1),
+    y: a * (c.cy0 - c.y0) + b * (c.cy1 - c.cy0) + d * (c.y1 - c.cy1)
+  };
+}
+function dashCurves(curves, dashWorld) {
+  const lengths = curves.map(
+    (c) => Math.hypot(c.cx0 - c.x0, c.cy0 - c.y0) + Math.hypot(c.cx1 - c.cx0, c.cy1 - c.cy0) + Math.hypot(c.x1 - c.cx1, c.y1 - c.cy1)
+  );
+  const total = lengths.reduce((a, b) => a + b, 0);
+  const spans = Math.max(3, Math.round(total / dashWorld) | 1);
+  const out = [];
+  for (let i = 0; i < spans; i += 2) {
+    const from = i / spans * total;
+    const to = (i + 1) / spans * total;
+    const dash = [];
+    let start = 0;
+    curves.forEach((c, k) => {
+      const length = lengths[k];
+      const end = start + length;
+      if (length > 0 && end > from && start < to) {
+        dash.push(
+          subCurve(
+            c,
+            Math.max(0, (from - start) / length),
+            Math.min(1, (to - start) / length)
+          )
+        );
+      }
+      start = end;
+    });
+    if (dash.length) {
+      out.push(dash);
+    }
+  }
+  return out;
+}
+function translateCurves(curves, dx, dy) {
+  const out = new Array(curves.length);
+  for (let i = 0; i < curves.length; i++) {
+    const c = curves[i];
+    out[i] = {
+      x0: c.x0 + dx,
+      y0: c.y0 + dy,
+      cx0: c.cx0 + dx,
+      cy0: c.cy0 + dy,
+      cx1: c.cx1 + dx,
+      cy1: c.cy1 + dy,
+      x1: c.x1 + dx,
+      y1: c.y1 + dy
+    };
+  }
+  return out;
+}
+function attachment(segments, side) {
+  const last = segments.length - 1;
+  return side === "end" ? { at: segments[last], inward: segments[last - 1] } : { at: segments[0], inward: segments[1] };
+}
+var TANGENT_SPAN_FACTOR = 0.5;
+var MAX_TANGENT = 80;
+function ownStrand(id) {
+  return id.endsWith("-") ? "-" : "+";
+}
+function strandSides(edge) {
+  const own = (id, strand) => (strand ?? ownStrand(id)) === ownStrand(id);
+  return {
+    from: own(edge.from, edge.fromStrand) ? "end" : "start",
+    to: own(edge.to, edge.toStrand) ? "start" : "end"
+  };
+}
+function spanOf(segments) {
+  let min = Infinity;
+  let max = -Infinity;
+  for (const s of segments) {
+    min = Math.min(min, s.x);
+    max = Math.max(max, s.x);
+  }
+  return { min, max };
+}
+function distanceToSpan(x, span) {
+  return Math.max(0, span.min - x, x - span.max);
+}
+function facingSide(segments, other, tieBreak) {
+  const startGap = distanceToSpan(segments[0].x, other);
+  const endGap = distanceToSpan(segments[segments.length - 1].x, other);
+  return startGap === endGap ? tieBreak : startGap < endGap ? "start" : "end";
+}
+function facingSides(fromSegments, toSegments) {
+  return {
+    from: facingSide(fromSegments, spanOf(toSegments), "end"),
+    to: facingSide(toSegments, spanOf(fromSegments), "start")
+  };
+}
+var laidSides = /* @__PURE__ */ new WeakMap();
+function heldFacingSides(fromSegments, toSegments) {
+  let byTo = laidSides.get(fromSegments);
+  if (!byTo) {
+    byTo = /* @__PURE__ */ new WeakMap();
+    laidSides.set(fromSegments, byTo);
+  }
+  let sides = byTo.get(toSegments);
+  if (!sides) {
+    sides = facingSides(fromSegments, toSegments);
+    byTo.set(toSegments, sides);
+  }
+  return sides;
+}
+var APEX_FRACTION = 0.75;
+var BOW_CLEARANCE = 1.15;
+var ALONG_FRACTION = 0.35;
+var MAX_ROW_BOW_PX = 3 * ROW_HEIGHT_PX;
+function bowAround(p1x, p1y, p2x, p2y, toward, maxBow) {
+  const chord = Math.hypot(p2x - p1x, p2y - p1y);
+  const ux = chord === 0 ? 1 : (p2x - p1x) / chord;
+  const uy = chord === 0 ? 0 : (p2y - p1y) / chord;
+  let reach = 0;
+  let minAlong = Infinity;
+  let maxAlong = -Infinity;
+  for (const p of toward) {
+    const dx = p.x - p1x;
+    const dy = p.y - p1y;
+    const perp = dx * -uy + dy * ux;
+    if (Math.abs(perp) > Math.abs(reach)) {
+      reach = perp;
+    }
+    const along = dx * ux + dy * uy;
+    minAlong = Math.min(minAlong, along);
+    maxAlong = Math.max(maxAlong, along);
+  }
+  const span = toward.length ? maxAlong - minAlong : 0;
+  const uncapped = Math.max(
+    Math.abs(reach) * BOW_CLEARANCE / APEX_FRACTION,
+    span * ALONG_FRACTION
+  );
+  const size = maxBow === void 0 ? uncapped : Math.min(uncapped, maxBow);
+  return reach < 0 ? -size : size;
+}
+function yToXOf({ scaleX, scaleY }) {
+  return scaleY / scaleX;
+}
+var PATH_RIBBON_SPACING = 3;
+function drawnDirection(a, b, yToX) {
+  const dx = b.x - a.x;
+  const dy = (b.y - a.y) * yToX;
+  const len = Math.hypot(dx, dy);
+  return len === 0 ? void 0 : { x: dx / len, y: dy / len };
+}
+function pathRibbonOffsets(fromSegments, toSegments, count, axis, spacing = PATH_RIBBON_SPACING) {
+  const yToX = yToXOf(axis);
+  const dir = drawnDirection(
+    fromSegments[fromSegments.length - 1],
+    toSegments[0],
+    yToX
+  ) ?? drawnDirection(fromSegments[0], fromSegments.at(-1), yToX) ?? drawnDirection(toSegments[0], toSegments.at(-1), yToX) ?? { x: 1, y: 0 };
+  const offsets = [];
+  for (let i = 0; i < count; i++) {
+    const distance = (i - (count - 1) / 2) * spacing;
+    offsets.push({ x: -dir.y * distance, y: dir.x * distance / yToX });
+  }
+  return offsets;
+}
+function scaleYOf(points, yToX) {
+  return points.map((p) => ({ x: p.x, y: p.y * yToX }));
+}
+function unscaleYOf(curves, yToX) {
+  for (const c of curves) {
+    c.y0 /= yToX;
+    c.cy0 /= yToX;
+    c.cy1 /= yToX;
+    c.y1 /= yToX;
+  }
+  return curves;
+}
+var SELF_LOOP_MIN_PX = 12;
+var SELF_LOOP_MAX_PX = 40;
+function selfLoopReach(segments, scale) {
+  let length = 0;
+  for (let i = 1; i < segments.length; i++) {
+    length += Math.hypot(
+      segments[i].x - segments[i - 1].x,
+      segments[i].y - segments[i - 1].y
+    );
+  }
+  const nodePx = length * scale;
+  const reachPx = Math.min(
+    SELF_LOOP_MAX_PX,
+    Math.max(SELF_LOOP_MIN_PX, nodePx / 2)
+  );
+  return reachPx / Math.max(scale, Number.EPSILON);
+}
+function selfLinkOf(edge) {
+  if (edge.from !== edge.to) {
+    return false;
+  }
+  return edge.fromStrand && edge.toStrand && edge.fromStrand !== edge.toStrand ? edge.fromStrand === "+" ? "end" : "start" : true;
+}
+function edgeJoinOf(edge, stranded = false) {
+  const self = selfLinkOf(edge);
+  if (!stranded) {
+    return self;
+  }
+  const sides = strandSides(edge);
+  return self === false ? sides : sides.from === sides.to ? sides.from : true;
+}
+function hairpinCurves(attach, reach, offsetX, offsetY) {
+  const { at, inward } = attach;
+  const dx = inward ? at.x - inward.x : 1;
+  const dy = inward ? at.y - inward.y : 0;
+  const len = Math.hypot(dx, dy) || 1;
+  const ux = dx / len;
+  const uy = dy / len;
+  const px = at.x + offsetX;
+  const py = at.y + offsetY;
+  const nearX = px + ux * reach / 3;
+  const nearY = py + uy * reach / 3;
+  const apexX = px + ux * reach;
+  const apexY = py + uy * reach;
+  const sideX = -uy * reach / 2;
+  const sideY = ux * reach / 2;
+  return [
+    {
+      x0: px,
+      y0: py,
+      cx0: nearX,
+      cy0: nearY,
+      cx1: apexX + sideX,
+      cy1: apexY + sideY,
+      x1: apexX,
+      y1: apexY
+    },
+    {
+      x0: apexX,
+      y0: apexY,
+      cx0: apexX - sideX,
+      cy0: apexY - sideY,
+      cx1: nearX,
+      cy1: nearY,
+      x1: px,
+      y1: py
+    }
+  ];
+}
+function computeEdgeCurves(fromSegments, toSegments, join, offsetX, offsetY, axis, bypassed = [], maxBowIn) {
+  const scale = axis.scaleX;
+  const yToX = yToXOf(axis);
+  const maxBow = maxBowIn ?? (axis.pixelRows ? MAX_ROW_BOW_PX : void 0);
+  if (join === false) {
+    join = heldFacingSides(fromSegments, toSegments);
+  }
+  if (yToX !== 1) {
+    return unscaleYOf(
+      computeEdgeCurves(
+        scaleYOf(fromSegments, yToX),
+        scaleYOf(toSegments, yToX),
+        join,
+        offsetX,
+        offsetY * yToX,
+        { scaleX: scale, scaleY: scale },
+        scaleYOf(bypassed, yToX),
+        // the cap is a y measure and the body works in x units, so it converts
+        // with everything else that crosses this boundary
+        maxBow === void 0 ? void 0 : maxBow * yToX
+      ),
+      yToX
+    );
+  }
+  if (typeof join === "string") {
+    return hairpinCurves(
+      attachment(fromSegments, join),
+      selfLoopReach(fromSegments, scale),
+      offsetX,
+      offsetY
+    );
+  }
+  const loop = join === true;
+  const sides = join === true ? { from: "end", to: "start" } : join;
+  const fromAttach = attachment(fromSegments, sides.from);
+  const toAttach = attachment(toSegments, sides.to);
+  const fromEnd = fromAttach.at;
+  const toStart = toAttach.at;
+  const p1x = fromEnd.x + offsetX;
+  const p1y = fromEnd.y + offsetY;
+  const p2x = toStart.x + offsetX;
+  const p2y = toStart.y + offsetY;
+  if (loop) {
+    let segDirX = 1;
+    let segDirY = 0;
+    if (fromAttach.inward) {
+      const dx = fromEnd.x - fromAttach.inward.x;
+      const dy = fromEnd.y - fromAttach.inward.y;
+      const len = Math.hypot(dx, dy);
+      if (len > 0) {
+        segDirX = dx / len;
+        segDirY = dy / len;
+      }
+    }
+    const ext = selfLoopReach(fromSegments, scale);
+    const perpX = -segDirY;
+    const perpY = segDirX;
+    const midX = (fromEnd.x + toStart.x) / 2 + offsetX + perpX * ext;
+    const midY = (fromEnd.y + toStart.y) / 2 + offsetY + perpY * ext;
+    const cp1x = p1x + segDirX * ext;
+    const cp1y = p1y + segDirY * ext;
+    const cp2x = p2x - segDirX * ext;
+    const cp2y = p2y - segDirY * ext;
+    return [
+      {
+        x0: p1x,
+        y0: p1y,
+        cx0: cp1x,
+        cy0: cp1y,
+        cx1: cp1x + perpX * ext,
+        cy1: cp1y + perpY * ext,
+        x1: midX,
+        y1: midY
+      },
+      {
+        x0: midX,
+        y0: midY,
+        cx0: cp2x + perpX * ext,
+        cy0: cp2y + perpY * ext,
+        cx1: cp2x,
+        cy1: cp2y,
+        x1: p2x,
+        y1: p2y
+      }
+    ];
+  } else {
+    const fromPrev = fromAttach.inward ?? {
+      x: fromEnd.x - (toStart.x - fromEnd.x),
+      y: fromEnd.y - (toStart.y - fromEnd.y)
+    };
+    const toNext = toAttach.inward ?? {
+      x: toStart.x - (fromEnd.x - toStart.x),
+      y: toStart.y - (fromEnd.y - toStart.y)
+    };
+    const dist = Math.hypot(p2x - p1x, p2y - p1y);
+    const tangentProj = (prev, at, towardX, towardY) => {
+      const dx = at.x - prev.x;
+      const dy = at.y - prev.y;
+      const len = Math.hypot(dx, dy);
+      const along = len === 0 ? 0 : (towardX * dx + towardY * dy) / len;
+      return Math.max(
+        0,
+        Math.min(dist * TANGENT_SPAN_FACTOR, MAX_TANGENT, along * 0.5)
+      );
+    };
+    const towardToX = toStart.x - fromEnd.x;
+    const towardToY = toStart.y - fromEnd.y;
+    const [cx1, cy1] = projectLine(
+      fromPrev.x,
+      fromPrev.y,
+      fromEnd.x,
+      fromEnd.y,
+      tangentProj(fromPrev, fromEnd, towardToX, towardToY)
+    );
+    const [cx2, cy2] = projectLine(
+      toNext.x,
+      toNext.y,
+      toStart.x,
+      toStart.y,
+      tangentProj(toNext, toStart, -towardToX, -towardToY)
+    );
+    const bulge = bypassed.length ? bowAround(p1x, p1y, p2x, p2y, bypassed, maxBow) : 0;
+    const chordLen = dist === 0 ? 1 : dist;
+    const ux = (p2x - p1x) / chordLen;
+    const uy = (p2y - p1y) / chordLen;
+    const bulgeX = -uy * bulge;
+    const bulgeY = ux * bulge;
+    const spreadX = ux * Math.abs(bulge);
+    const spreadY = uy * Math.abs(bulge);
+    return [
+      {
+        x0: p1x,
+        y0: p1y,
+        cx0: cx1 + offsetX + bulgeX - spreadX,
+        cy0: cy1 + offsetY + bulgeY - spreadY,
+        cx1: cx2 + offsetX + bulgeX + spreadX,
+        cy1: cy2 + offsetY + bulgeY + spreadY,
+        x1: p2x,
+        y1: p2y
+      }
+    ];
+  }
+}
+function nearerEnd(segments, to) {
+  const start = segments[0];
+  const end = segments.at(-1);
+  return Math.hypot(start.x - to.x, start.y - to.y) < Math.hypot(end.x - to.x, end.y - to.y) ? "start" : "end";
+}
+function routedEdgeCurves(fromSegments, toSegments, route, sides) {
+  const fromAttach = attachment(
+    fromSegments,
+    sides?.from ?? nearerEnd(fromSegments, route[0])
+  );
+  const toAttach = attachment(
+    toSegments,
+    sides?.to ?? nearerEnd(toSegments, route.at(-1))
+  );
+  const points = [fromAttach.at, ...route, toAttach.at];
+  const tangent = (i) => {
+    const p = points[i];
+    const span = (q) => Math.hypot(q.x - p.x, q.y - p.y);
+    const along = (inward, next) => {
+      const len = inward ? span(inward) : 0;
+      const reach = span(next);
+      return len === 0 ? { x: next.x - p.x, y: next.y - p.y } : {
+        x: (p.x - inward.x) / len * reach,
+        y: (p.y - inward.y) / len * reach
+      };
+    };
+    if (i === 0) {
+      return along(fromAttach.inward, points[1]);
+    }
+    if (i === points.length - 1) {
+      const out = along(toAttach.inward, points[i - 1]);
+      return { x: -out.x, y: -out.y };
+    }
+    return {
+      x: (points[i + 1].x - points[i - 1].x) / 2,
+      y: (points[i + 1].y - points[i - 1].y) / 2
+    };
+  };
+  const curves = [];
+  for (let i = 0; i < points.length - 1; i++) {
+    const a = points[i];
+    const b = points[i + 1];
+    const ta = tangent(i);
+    const tb = tangent(i + 1);
+    curves.push({
+      x0: a.x,
+      y0: a.y,
+      cx0: a.x + ta.x / 3,
+      cy0: a.y + ta.y / 3,
+      cx1: b.x - tb.x / 3,
+      cy1: b.y - tb.y / 3,
+      x1: b.x,
+      y1: b.y
+    });
+  }
+  return curves;
+}
+
+export {
+  svgPath,
+  projectLine,
+  curvePointAt,
+  curveMidpoint,
+  curveBounds,
+  dashCurves,
+  translateCurves,
+  ownStrand,
+  strandSides,
+  bowAround,
+  yToXOf,
+  PATH_RIBBON_SPACING,
+  pathRibbonOffsets,
+  selfLinkOf,
+  edgeJoinOf,
+  computeEdgeCurves,
+  routedEdgeCurves
+};