@willcgage/module-schematic 0.74.0 → 0.76.0

package/dist/index.cjs

@@ -31,10 +31,28 @@ function moduleSections(doc) {
       ...typeof len === "number" && Number.isFinite(len) && len > 0 ? { lengthInches: len } : {},
       ...sec.geometryType ? { geometryType: sec.geometryType } : {},
       ...typeof deg === "number" && Number.isFinite(deg) ? { geometryDegrees: deg } : {},
-      ...typeof off === "number" && Number.isFinite(off) ? { geometryOffsetInches: off } : {}
+      ...typeof off === "number" && Number.isFinite(off) ? { geometryOffsetInches: off } : {},
+      // The board's two ends (#130). Written only when actually described —
+      // an absent end is an ordinary internal joint, and an empty object
+      // would claim the owner had said something about it.
+      ...sectionEnd(sec.endA) ? { endA: sectionEnd(sec.endA) } : {},
+      ...sectionEnd(sec.endB) ? { endB: sectionEnd(sec.endB) } : {}
     };
   });
 }
+function sectionEnd(end) {
+  if (!end) return null;
+  const config = end.config === "single" || end.config === "double" || end.config === "none" ? end.config : null;
+  const w = end.widthInches;
+  const o = end.trackOffsetInches;
+  const out = {
+    ...config ? { config } : {},
+    ...typeof w === "number" && Number.isFinite(w) && w > 0 ? { widthInches: w } : {},
+    // Signed, and 0 is meaningful ("explicitly centred", #93) — keep any finite.
+    ...typeof o === "number" && Number.isFinite(o) ? { trackOffsetInches: o } : {}
+  };
+  return Object.keys(out).length ? out : null;
+}
 function sectionFootprints(doc, derive) {
   const spans = derive ? sectionSpans(doc) : [];
   const spanOf = new Map(spans.map((sp) => [sp.id, sp]));
@@ -577,6 +595,92 @@ 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 assessSectionEnd(end, opts = {}) {
+  const config = end?.config ?? "none";
+  const widthInches = endplateWidthInches({ widthInches: end?.widthInches });
+  const trackOffsetInches = endplateTrackOffsetInches(
+    end?.trackOffsetInches,
+    config,
+    opts.main2Below
+  );
+  const described = config === "single" || config === "double";
+  if (!described) {
+    return { described: false, conforming: false, issues: [], config, widthInches, trackOffsetInches };
+  }
+  const issues = checkEndplateWidth({
+    widthInches: end?.widthInches,
+    config,
+    trackOffsetInches: end?.trackOffsetInches,
+    main2Below: opts.main2Below
+  });
+  return { described: true, conforming: issues.length === 0, issues, config, widthInches, trackOffsetInches };
+}
+function assessSectionJoint(west, east, opts = {}) {
+  const w = assessSectionEnd(west, opts);
+  const e = assessSectionEnd(east, opts);
+  let reason = null;
+  if (!w.described || !e.described) {
+    reason = "an internal joint \u2014 neither end has been described as an interface";
+    if (w.described !== e.described)
+      reason = `only the ${w.described ? "west" : "east"} side is described as an endplate`;
+  } else if (!w.conforming || !e.conforming) {
+    const bad = !w.conforming ? w : e;
+    reason = bad.issues[0]?.message ?? "an end doesn't meet the standard";
+  } else if (w.config !== e.config) {
+    reason = `${w.config} meets ${e.config} \u2014 the track counts differ`;
+  }
+  return { west: w, east: e, standardInterface: reason === null, reason };
+}
 function spanOverhang(input) {
   const lo = Math.min(input.fromPos, input.toPos);
   const hi = Math.max(input.fromPos, input.toPos);
@@ -827,7 +931,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 +1040,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 +2481,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;
@@ -2382,6 +2500,8 @@ 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;
+exports.assessSectionEnd = assessSectionEnd;
+exports.assessSectionJoint = assessSectionJoint;
 exports.benchworkBand = benchworkBand;
 exports.benchworkOutline = benchworkOutline;
 exports.buildCrossover = buildCrossover;
@@ -2389,6 +2509,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 +2579,6 @@ exports.turnoutClosure = turnoutClosure;
 exports.turnoutFacing = turnoutFacing;
 exports.turnoutOccupiedSpan = turnoutOccupiedSpan;
 exports.turnoutPartForSize = turnoutPartForSize;
+exports.usableCapacity = usableCapacity;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map