@willcgage/module-schematic 0.74.0 → 0.75.0

package/dist/index.cjs

@@ -577,6 +577,56 @@ function scaleFeetToInches(feet, ratio = N_SCALE_RATIO) {
   return feet * 12 / ratio;
 }
 var N_CAR_LENGTH_INCHES = 3.3;
+var CLEARANCE_SPACING_INCHES = FREEMO_TRACK_SPACING_INCHES;
+function clearancePointPastFrogInches(size, library = BUILT_IN_TRACK_PARTS, clearanceInches = CLEARANCE_SPACING_INCHES) {
+  const N = size > 0 ? size : 6;
+  const lead = leadInchesForSize(N, library);
+  const cl = turnoutClosure(N, { leadInches: lead });
+  let lo = 0;
+  let hi = Math.max(4 * lead, 4 * clearanceInches * N);
+  if (cl.offsetAt(hi) < clearanceInches) return hi - lead;
+  for (let i = 0; i < 60; i++) {
+    const mid = (lo + hi) / 2;
+    if (cl.offsetAt(mid) < clearanceInches) lo = mid;
+    else hi = mid;
+  }
+  return Math.max(0, hi - lead);
+}
+function usableCapacity(input) {
+  const lo = Math.min(input.fromPos, input.toPos);
+  const hi = Math.max(input.fromPos, input.toPos);
+  const drawn = hi - lo;
+  const carLen = input.carLengthInches ?? N_CAR_LENGTH_INCHES;
+  if (typeof input.measuredUsableInches === "number" && input.measuredUsableInches >= 0) {
+    const m = input.measuredUsableInches;
+    return {
+      fromPos: lo,
+      toPos: lo + m,
+      usableInches: m,
+      drawnInches: drawn,
+      givenUpInches: Math.max(0, drawn - m),
+      cars: carCapacity(0, m, carLen),
+      scaleFeet: Math.round(inchesToScaleFeet(m))
+    };
+  }
+  let a = lo;
+  let b = hi;
+  for (const sw of input.governing ?? []) {
+    const c = clearancePointPastFrogInches(sw.size ?? 6, input.library);
+    if (Math.abs(sw.pos - lo) <= Math.abs(sw.pos - hi)) a = Math.max(a, lo + c);
+    else b = Math.min(b, hi - c);
+  }
+  const usable = Math.max(0, b - a);
+  return {
+    fromPos: a,
+    toPos: Math.max(a, b),
+    usableInches: usable,
+    drawnInches: drawn,
+    givenUpInches: Math.max(0, drawn - usable),
+    cars: carCapacity(0, usable, carLen),
+    scaleFeet: Math.round(inchesToScaleFeet(usable))
+  };
+}
 function spanOverhang(input) {
   const lo = Math.min(input.fromPos, input.toPos);
   const hi = Math.max(input.fromPos, input.toPos);
@@ -827,7 +877,17 @@ function stateToDoc(state, recordNumber) {
         toPos: t.toPos,
         moduleTrackId: t.moduleTrackId,
         trackName: t.trackName || void 0,
-        capacityFeet: Math.round(inchesToScaleFeet(Math.abs(t.toPos - t.fromPos))),
+        // ⚠️ USABLE capacity, measured from the governing turnouts' CLEARANCE
+        // POINTS (#19) — not the drawn rail-to-rail length, which counts track
+        // a car can't stand on without fouling the route it diverged from.
+        // FMN-0040's 70″ siding is 21 cars drawn and 17 usable.
+        capacityFeet: usableCapacity({
+          fromPos: t.fromPos,
+          toPos: t.toPos,
+          governing: state.turnouts.filter((sw) => sw.divergeTrack === t.id),
+          measuredUsableInches: t.measuredUsableInches
+        }).scaleFeet,
+        ...typeof t.measuredUsableInches === "number" && t.measuredUsableInches >= 0 ? { measuredUsableInches: t.measuredUsableInches } : {},
         ...state.loop && t.inLoop ? { inLoop: true } : {},
         ...t.path && t.path.length >= 2 ? { path: t.path } : {}
       }))
@@ -926,7 +986,10 @@ function docToState(doc, fallbackLength, moduleTracks = []) {
         trackName: t.trackName ?? nameOf(moduleTrackId),
         ...t.inLoop ? { inLoop: true } : {},
         // Authored path kept as-drawn (a physical shape, not rescaled with length).
-        ...trackPath(t.path) ? { path: trackPath(t.path) } : {}
+        ...trackPath(t.path) ? { path: trackPath(t.path) } : {},
+        // A MEASURED length is a real-world fact about the physical track, so it
+        // rescales with the module exactly as its positions do (#20).
+        ...typeof t.measuredUsableInches === "number" && Number.isFinite(t.measuredUsableInches) ? { measuredUsableInches: sc(t.measuredUsableInches) } : {}
       });
     }
   }
@@ -2364,6 +2427,7 @@ function poseOverridesFromDoc(doc) {
 
 exports.ATLAS_CODE55_N = ATLAS_CODE55_N;
 exports.BUILT_IN_TRACK_PARTS = BUILT_IN_TRACK_PARTS;
+exports.CLEARANCE_SPACING_INCHES = CLEARANCE_SPACING_INCHES;
 exports.CODE55_RAIL_HEIGHT_INCHES = CODE55_RAIL_HEIGHT_INCHES;
 exports.DEFAULT_FLEX_PART_ID = DEFAULT_FLEX_PART_ID;
 exports.ENDPLATE_FASCIA_CLEAR_INCHES = ENDPLATE_FASCIA_CLEAR_INCHES;
@@ -2389,6 +2453,7 @@ exports.buildPassingSiding = buildPassingSiding;
 exports.buildTransition = buildTransition;
 exports.carCapacity = carCapacity;
 exports.checkEndplateWidth = checkEndplateWidth;
+exports.clearancePointPastFrogInches = clearancePointPastFrogInches;
 exports.deriveEndplatePoses = deriveEndplatePoses;
 exports.divergeSideForHand = divergeSideForHand;
 exports.docToState = docToState;
@@ -2458,5 +2523,6 @@ exports.turnoutClosure = turnoutClosure;
 exports.turnoutFacing = turnoutFacing;
 exports.turnoutOccupiedSpan = turnoutOccupiedSpan;
 exports.turnoutPartForSize = turnoutPartForSize;
+exports.usableCapacity = usableCapacity;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map