@willcgage/module-schematic 0.83.1 → 0.84.0

package/dist/index.cjs

@@ -1651,7 +1651,7 @@ var FAST_TRACKS_N_ME55_CROSSOVERS = [
     secondaryFrogAngle: {
       deg: second,
       source: manufacturer,
-      note: `${spec}. The diamond of a scissors crossover \u2014 2 \xD7 ${deg}\xB0 within the published rounding.`
+      note: `${spec}. The SCISSORS of a double crossover \u2014 the X where its two opposite diverging routes cross \u2014 at 2 \xD7 ${deg}\xB0 within the published rounding.`
     },
     overallLength: {
       inches: dflt,
@@ -2128,6 +2128,107 @@ function turnoutClosure(size, opts = {}) {
     }
   };
 }
+function partGeometryGap(part) {
+  if (part.kind === "flex") return null;
+  if (part.kind === "crossover")
+    return "a crossover fixture builds one HALF of the assembly (piecesPerAssembly), so its published lengths describe a piece, not the finished part \u2014 the geometry of the whole crossover is not yet derivable from them";
+  if (part.kind === "crossing") return "crossing geometry is not modelled yet";
+  if (part.kind === "curved-turnout")
+    return "a curved turnout needs both radii AND its points/frog landmarks; only the radii are published";
+  if (!part.pointsOffset)
+    return "no points offset \u2014 without it there is nowhere for the diverging route to begin";
+  if (!part.overallLength) return "no overall length \u2014 the part has no end to put a joint on";
+  if (part.frogNumber == null) return "no frog number \u2014 the diverging angle is unknown";
+  return null;
+}
+function partGeometry(part, library = BUILT_IN_TRACK_PARTS) {
+  if (partGeometryGap(part)) return null;
+  if (part.kind === "flex") {
+    return {
+      joints: [
+        { id: "a", role: "throat", x: 0, y: 0, angleDeg: 180 },
+        { id: "b", role: "through", x: 0, y: 0, angleDeg: 0 }
+      ],
+      routes: [["a", "b"]],
+      source: "derived",
+      divergingEndMeasured: false
+    };
+  }
+  const N = part.frogNumber;
+  const points = part.pointsOffset;
+  const overall = part.overallLength;
+  const frog = part.frogOffset;
+  const lead = part.lead?.inches ?? (frog ? frog.inches - points.inches : void 0);
+  if (lead == null || !(lead > 0)) return null;
+  const isWye = part.kind === "wye";
+  const effN = isWye ? N * 2 : N;
+  const closure = turnoutClosure(effN, { leadInches: lead });
+  const divergingEnd = () => {
+    const frogX = frog ? frog.inches : points.inches + lead;
+    const slope = closure.frogSlope;
+    const dir = 1 / Math.hypot(1, slope);
+    if (part.divergingLength) {
+      const L = part.divergingLength.inches;
+      return {
+        x: frogX + L * dir,
+        y: closure.offsetAt(frogX - points.inches) + L * slope * dir,
+        measured: true
+      };
+    }
+    return {
+      x: overall.inches,
+      y: closure.offsetAt(overall.inches - points.inches),
+      measured: false
+    };
+  };
+  const weakest = (...ds) => {
+    const rank = ["measured", "manufacturer", "derived", "unverified"];
+    let worst = 0;
+    for (const d of ds) if (d) worst = Math.max(worst, rank.indexOf(d.source));
+    return rank[worst];
+  };
+  const de = divergingEnd();
+  const legAngle = Math.atan(closure.frogSlope) * 180 / Math.PI;
+  if (isWye) {
+    return {
+      joints: [
+        { id: "throat", role: "throat", x: 0, y: 0, angleDeg: 180 },
+        { id: "legA", role: "diverge", x: de.x, y: de.y, angleDeg: legAngle },
+        { id: "legB", role: "divergeB", x: de.x, y: -de.y, angleDeg: -legAngle }
+      ],
+      routes: [
+        ["throat", "legA"],
+        ["throat", "legB"]
+      ],
+      source: weakest(points, overall, frog, part.divergingLength),
+      divergingEndMeasured: de.measured
+    };
+  }
+  return {
+    joints: [
+      { id: "throat", role: "throat", x: 0, y: 0, angleDeg: 180 },
+      { id: "through", role: "through", x: overall.inches, y: 0, angleDeg: 0 },
+      { id: "diverge", role: "diverge", x: de.x, y: de.y, angleDeg: legAngle }
+    ],
+    routes: [
+      ["throat", "through"],
+      ["throat", "diverge"]
+    ],
+    source: weakest(points, overall, frog, part.divergingLength),
+    divergingEndMeasured: de.measured
+  };
+}
+function partsPlaceable(library = BUILT_IN_TRACK_PARTS) {
+  const placeable = [];
+  const blocked = [];
+  for (const p of library) {
+    const why = partGeometryGap(p);
+    if (why) blocked.push({ part: p, why });
+    else if (partGeometry(p, library)) placeable.push(p);
+    else blocked.push({ part: p, why: "dimensions present but inconsistent" });
+  }
+  return { placeable, blocked };
+}
 function frogCasting(cl, opts = {}) {
   const g = opts.gaugeInches ?? RAIL_GAUGE_INCHES;
   const w = opts.reachInches ?? g * 1.5;
@@ -2778,7 +2879,10 @@ exports.nextId = nextId;
 exports.parseXtpLibrary = parseXtpLibrary;
 exports.partExtent = partExtent;
 exports.partExtentForSize = partExtentForSize;
+exports.partGeometry = partGeometry;
+exports.partGeometryGap = partGeometryGap;
 exports.partOutlineAtFrog = partOutlineAtFrog;
+exports.partsPlaceable = partsPlaceable;
 exports.pastFrogInchesForSize = pastFrogInchesForSize;
 exports.pathLengthInches = pathLengthInches;
 exports.poseNeedsManual = poseNeedsManual;