@willcgage/module-schematic 0.61.0 → 0.63.0

package/dist/index.cjs

@@ -669,7 +669,7 @@ function buildTransition(state) {
 }
 function withPoses(endplates, overrides) {
   return endplates.map(
-    (e) => overrides[e.id] ? { ...e, pose: overrides[e.id] } : e
+    (e) => overrides[e.id] ? { ...e, pose: overrides[e.id], poseAuthored: true } : e
   );
 }
 function withWidths(endplates, widths, offsets = {}) {
@@ -1241,6 +1241,24 @@ var BUILT_IN_TRACK_PARTS = [...ATLAS_CODE55_N];
 function trackPart(id, library = BUILT_IN_TRACK_PARTS) {
   return library.find((p) => p.id === id) ?? null;
 }
+var TIE_HALF_LENGTH_INCHES = 0.319;
+function partExtent(part) {
+  const pts = part?.pointsOffset;
+  const overall = part?.overallLength;
+  if (!pts || !overall) return null;
+  if (pts.source !== "measured" || overall.source !== "measured") return null;
+  const frog = part?.frogOffset;
+  const aheadOfPoints = overall.inches - pts.inches;
+  return {
+    behindPoints: pts.inches,
+    aheadOfPoints,
+    pastFrog: frog && frog.source === "measured" ? overall.inches - frog.inches : aheadOfPoints
+  };
+}
+function partExtentForSize(size, library = BUILT_IN_TRACK_PARTS) {
+  const part = turnoutPartForSize(size, library);
+  return part && part.frogNumber === size ? partExtent(part) : null;
+}
 function turnoutPartForSize(size, library = BUILT_IN_TRACK_PARTS) {
   const turnouts = library.filter((p) => p.kind === "turnout" && p.frogNumber != null);
   if (!turnouts.length) return null;
@@ -2033,10 +2051,26 @@ function trackMeetsEndplateIssues(path, pose, opts) {
 function poseNeedsManual(geometryType) {
   return geometryType === "wye" || geometryType === "other";
 }
+function isAxialPose(p) {
+  const h = norm360(p.heading);
+  return Math.abs(p.y) < 1e-6 && (Math.abs(h) < 1e-6 || Math.abs(h - 180) < 1e-6);
+}
 function poseOverridesFromDoc(doc) {
   const out = {};
   for (const e of doc.endplates ?? []) {
-    if (e.id && e.pose && typeof e.pose.x === "number" && typeof e.pose.y === "number" && typeof e.pose.heading === "number") {
+    if (e.id && e.pose && typeof e.pose.x === "number" && typeof e.pose.y === "number" && typeof e.pose.heading === "number" && // Only an AUTHORED pose overrides derivation (#182) — but docs written
+    // before the flag existed have to keep working, so authorship is inferred
+    // for the two cases that can only BE authored:
+    //   · a placed branch endplate (`at`) — dropping it on the board is the
+    //     gesture, and it has no derivable position at all;
+    //   · an OFF-AXIS pose on A/B — a hand-placed plate is off-axis by
+    //     definition (that's why it needed hand placing, e.g. a wye's B).
+    // What's left is an axial A/B pose, which is exactly the shape plain
+    // derivation produces — residue. Honouring it silently pins the plate so
+    // it stops following the module and goes stale (FMN-0068's B sat at 48 on
+    // a 47.9″ board). Anything saved from now on carries the flag, so this
+    // guesswork only ever applies to old docs.
+    (e.poseAuthored === true || !!e.at || !isAxialPose(e.pose))) {
       out[e.id] = { x: e.pose.x, y: e.pose.y, heading: e.pose.heading };
     }
   }
@@ -2057,6 +2091,7 @@ exports.MAIN_TRACK_ID = MAIN_TRACK_ID;
 exports.N_CAR_LENGTH_INCHES = N_CAR_LENGTH_INCHES;
 exports.N_SCALE_RATIO = N_SCALE_RATIO;
 exports.RAIL_GAUGE_INCHES = RAIL_GAUGE_INCHES;
+exports.TIE_HALF_LENGTH_INCHES = TIE_HALF_LENGTH_INCHES;
 exports.TURNOUT_LEAD_INCHES_PER_FROG = TURNOUT_LEAD_INCHES_PER_FROG;
 exports.WHOLE_MODULE_SECTION_ID = WHOLE_MODULE_SECTION_ID;
 exports.asModuleSchematic = asModuleSchematic;
@@ -2093,6 +2128,8 @@ exports.moduleLengthFromSections = moduleLengthFromSections;
 exports.moduleSections = moduleSections;
 exports.nextId = nextId;
 exports.parseXtpLibrary = parseXtpLibrary;
+exports.partExtent = partExtent;
+exports.partExtentForSize = partExtentForSize;
 exports.partOutlineAtFrog = partOutlineAtFrog;
 exports.pathLengthInches = pathLengthInches;
 exports.poseNeedsManual = poseNeedsManual;