@willcgage/module-schematic 0.89.0 → 0.90.0

package/dist/index.cjs

@@ -2248,6 +2248,54 @@ function partGeometry(part, library = BUILT_IN_TRACK_PARTS) {
     divergingEndMeasured: de.measured
   };
 }
+function pieceRoutePaths(piece, library = BUILT_IN_TRACK_PARTS) {
+  const part = library.find((p) => p.id === piece.partId);
+  if (!part) return [];
+  const geo = partGeometry(part, library);
+  if (!geo) return [];
+  const joints = placedJoints([piece], library);
+  const at = (id) => joints.find((j) => j.joint === id);
+  const RAD = Math.PI / 180;
+  const c = Math.cos(piece.rotationDeg * RAD);
+  const s = Math.sin(piece.rotationDeg * RAD);
+  const place = (x, y) => {
+    const ly = piece.flipped ? -y : y;
+    return { x: piece.x + x * c - ly * s, y: piece.y + x * s + ly * c };
+  };
+  const out = [];
+  for (const route of geo.routes) {
+    const a = at(route[0]);
+    const b = at(route[1]);
+    if (!a || !b) continue;
+    const ends = [{ x: a.x, y: a.y }, { x: b.x, y: b.y }];
+    const diverging = route.some((r) => r === "diverge" || r === "legA" || r === "legB");
+    if (!diverging || part.kind === "flex") {
+      out.push({ route, points: ends });
+      continue;
+    }
+    const lead = part.lead?.inches ?? 0;
+    const pts0 = part.pointsOffset?.inches ?? 0;
+    const far = geo.joints.find((j) => j.id === route[1]) ?? geo.joints.find((j) => j.id === route[0]);
+    if (!far || !(lead > 0)) {
+      out.push({ route, points: ends });
+      continue;
+    }
+    const isWye = part.kind === "wye";
+    const closure = turnoutClosure(isWye ? part.frogNumber * 2 : part.frogNumber, {
+      leadInches: lead
+    });
+    const mirror = route.includes("legB") ? -1 : 1;
+    const pts = [place(0, 0), place(pts0, 0)];
+    const steps = 12;
+    for (let i = 1; i <= steps; i++) {
+      const x = pts0 + (far.x - pts0) * i / steps;
+      pts.push(place(x, mirror * closure.offsetAt(x - pts0)));
+    }
+    pts[pts.length - 1] = { x: b.x, y: b.y };
+    out.push({ route, points: route[0] === "throat" ? pts : pts.slice().reverse() });
+  }
+  return out;
+}
 function partsPlaceable(library = BUILT_IN_TRACK_PARTS) {
   const placeable = [];
   const blocked = [];
@@ -2332,6 +2380,36 @@ function buildTrackGraph(pieces, library = BUILT_IN_TRACK_PARTS, snapInches = JO
   }
   return { joints, connections, open, conflicts, unplaceable };
 }
+function snapPiece(moving, others, library = BUILT_IN_TRACK_PARTS, withinInches = 0.5) {
+  const mine = placedJoints([moving], library);
+  if (!mine.length) return null;
+  const graph = buildTrackGraph(others, library);
+  const taken = new Set(graph.connections.flatMap((c2) => [c2.a, c2.b]));
+  const open = graph.joints.filter((j) => !taken.has(j.key));
+  let best = null;
+  for (const m of mine)
+    for (const t of open) {
+      const d = Math.hypot(t.x - m.x, t.y - m.y);
+      if (d <= withinInches && (!best || d < best.d)) best = { m, t, d };
+    }
+  if (!best) return null;
+  const RAD = Math.PI / 180;
+  const dRot = norm360(best.t.headingDeg + 180 - best.m.headingDeg);
+  const c = Math.cos(dRot * RAD);
+  const s = Math.sin(dRot * RAD);
+  const ox = moving.x - best.m.x;
+  const oy = moving.y - best.m.y;
+  return {
+    piece: {
+      ...moving,
+      rotationDeg: norm360(moving.rotationDeg + dRot),
+      x: best.t.x + ox * c - oy * s,
+      y: best.t.y + ox * s + oy * c
+    },
+    from: best.m.key,
+    to: best.t.key
+  };
+}
 function walkTrackGraph(graph, pieces, startAt, library = BUILT_IN_TRACK_PARTS) {
   const byKey = new Map(graph.joints.map((j) => [j.key, j]));
   const pieceById = new Map(pieces.map((p) => [p.id, p]));
@@ -3327,6 +3405,7 @@ exports.partOutlineAtFrog = partOutlineAtFrog;
 exports.partsPlaceable = partsPlaceable;
 exports.pastFrogInchesForSize = pastFrogInchesForSize;
 exports.pathLengthInches = pathLengthInches;
+exports.pieceRoutePaths = pieceRoutePaths;
 exports.placedJoints = placedJoints;
 exports.poseNeedsManual = poseNeedsManual;
 exports.poseOverridesFromDoc = poseOverridesFromDoc;
@@ -3349,6 +3428,7 @@ exports.sectionSpansOrWhole = sectionSpansOrWhole;
 exports.sectionedCenterline = sectionedCenterline;
 exports.sectionedEndPose = sectionedEndPose;
 exports.sliceCenterline = sliceCenterline;
+exports.snapPiece = snapPiece;
 exports.spanOverhang = spanOverhang;
 exports.stateToDoc = stateToDoc;
 exports.storedPartToTrackPart = storedPartToTrackPart;