@willcgage/module-schematic 0.89.0 → 0.91.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,37 @@ 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
+  };
+}
+var danglingDivergeWarning = (id) => `the route diverging at ${id} is not connected to anything`;
 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]));
@@ -2352,6 +2431,7 @@ function walkTrackGraph(graph, pieces, startAt, library = BUILT_IN_TRACK_PARTS)
   const routes = [];
   const turnouts = [];
   const warnings = [];
+  const danglingDiverges = [];
   const queued = /* @__PURE__ */ new Set();
   const pending = [];
   const walk = (startKey, startPos, id, bornAt) => {
@@ -2442,7 +2522,8 @@ function walkTrackGraph(graph, pieces, startAt, library = BUILT_IN_TRACK_PARTS)
     const b = pending.shift();
     const start = link.get(b.joint);
     if (!start) {
-      warnings.push(`the route diverging at ${b.from} is not connected to anything`);
+      warnings.push(danglingDivergeWarning(b.from));
+      danglingDiverges.push(b.from);
       continue;
     }
     const already = routes.find((r2) => r2.pieces.includes(byKey.get(start).piece));
@@ -2463,7 +2544,7 @@ function walkTrackGraph(graph, pieces, startAt, library = BUILT_IN_TRACK_PARTS)
     if (!reached.has(p.id) && !graph.unplaceable.some((u) => u.piece === p.id))
       warnings.push(`${p.id} is not reachable from the endplate \u2014 nothing connects it`);
   for (const c of graph.conflicts) warnings.push(c.reason);
-  return { routes, turnouts, warnings };
+  return { routes, turnouts, warnings, danglingDiverges };
 }
 function resolveGraphAnchor(anchor, walk, pieces, library = BUILT_IN_TRACK_PARTS) {
   const piece = pieces.find((p) => p.id === anchor.piece);
@@ -2484,7 +2565,8 @@ function graphToDoc(pieces, input) {
   const library = input.library ?? BUILT_IN_TRACK_PARTS;
   const graph = buildTrackGraph(pieces, library);
   const walk = walkTrackGraph(graph, pieces, input.startAt, library);
-  const warnings = [...walk.warnings];
+  const dangling = new Set(walk.danglingDiverges.map(danglingDivergeWarning));
+  const warnings = walk.warnings.filter((w) => !dangling.has(w));
   const round = (n) => Math.round(n * 100) / 100;
   const base = input.base ?? {};
   const endplates = base.endplates && base.endplates.length ? base.endplates : [{ id: "A", label: "West" }, { id: "B", label: "East" }];
@@ -3327,6 +3409,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 +3432,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;