@willcgage/module-schematic 0.25.0 → 0.27.0

package/dist/index.cjs

@@ -3,6 +3,8 @@
 // src/index.ts
 var FREEMO_ENDPLATE_WIDTH_MIN_INCHES = 12;
 var FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES = 24;
+var FREEMO_TRACK_SPACING_INCHES = 1.125;
+var FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES = 4;
 function endplateWidthInches(ep) {
   const w = ep?.widthInches;
   return typeof w === "number" && w > 0 ? w : FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES;
@@ -144,37 +146,74 @@ function centerlineFractions(center) {
   const total = cum[cum.length - 1] || 1;
   return cum.map((d) => d / total);
 }
-function benchworkBand(center, widthA = FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, widthB = FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES) {
+function benchworkBand(center, widthA = FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, widthB = FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, offsetA = 0, offsetB = 0) {
   if (center.length < 2) return [];
   const n = centerlineNormals(center);
   const f = centerlineFractions(center);
   const half = (i) => (widthA * (1 - f[i]) + widthB * f[i]) / 2;
-  const left = center.map((p, i) => ({ x: p.x + n[i].x * half(i), y: p.y + n[i].y * half(i) }));
-  const right = center.map((p, i) => ({ x: p.x - n[i].x * half(i), y: p.y - n[i].y * half(i) }));
+  const off = (i) => offsetA * (1 - f[i]) + offsetB * f[i];
+  const left = center.map((p, i) => ({
+    x: p.x + n[i].x * (off(i) + half(i)),
+    y: p.y + n[i].y * (off(i) + half(i))
+  }));
+  const right = center.map((p, i) => ({
+    x: p.x + n[i].x * (off(i) - half(i)),
+    y: p.y + n[i].y * (off(i) - half(i))
+  }));
   return [...left, ...right.reverse()];
 }
-function endplateFaceSegments(center, widthA = FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, widthB = FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES) {
+function endplateFaceSegments(center, widthA = FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, widthB = FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, offsetA = 0, offsetB = 0) {
   if (center.length < 2) return [];
   const n = centerlineNormals(center);
-  const face = (i, w) => ({
-    p1: { x: center[i].x + n[i].x * (w / 2), y: center[i].y + n[i].y * (w / 2) },
-    p2: { x: center[i].x - n[i].x * (w / 2), y: center[i].y - n[i].y * (w / 2) },
+  const face = (i, w, o) => ({
+    p1: { x: center[i].x + n[i].x * (o + w / 2), y: center[i].y + n[i].y * (o + w / 2) },
+    p2: { x: center[i].x + n[i].x * (o - w / 2), y: center[i].y + n[i].y * (o - w / 2) },
     mid: { x: center[i].x, y: center[i].y }
   });
-  return [face(0, widthA), face(center.length - 1, widthB)];
+  return [face(0, widthA, offsetA), face(center.length - 1, widthB, offsetB)];
 }
 function moduleFootprint(input) {
   const centerline = moduleCenterline(input);
   const widthA = endplateWidthFor(input.endplateWidths, "A");
   const widthB = endplateWidthFor(input.endplateWidths, "B");
   const authored = benchworkOutline(input);
+  const offA = input.endplateTrackOffsets?.["A"] ?? 0;
+  const offB = input.endplateTrackOffsets?.["B"] ?? 0;
   return {
     centerline,
-    band: benchworkBand(centerline, widthA, widthB),
-    endplateFaces: endplateFaceSegments(centerline, widthA, widthB),
+    band: benchworkBand(centerline, widthA, widthB, offA, offB),
+    endplateFaces: endplateFaceSegments(centerline, widthA, widthB, offA, offB),
     outline: authored ? sampleBenchworkOutline(authored) : null
   };
 }
+function endplateTrackOffsetFor(config) {
+  return config === "double" ? FREEMO_TRACK_SPACING_INCHES / 2 : 0;
+}
+function checkEndplateWidth(input) {
+  const width = endplateWidthInches(input);
+  const issues = [];
+  if (width < FREEMO_ENDPLATE_WIDTH_MIN_INCHES) {
+    issues.push({
+      code: "narrow",
+      message: `Endplate is ${round2(width)}\u2033 wide \u2014 the standard requires at least ${FREEMO_ENDPLATE_WIDTH_MIN_INCHES}\u2033.`,
+      requiredInches: FREEMO_ENDPLATE_WIDTH_MIN_INCHES
+    });
+  }
+  const off = input.trackOffsetInches ?? 0;
+  const centres = input.config === "double" ? [off - FREEMO_TRACK_SPACING_INCHES / 2, off + FREEMO_TRACK_SPACING_INCHES / 2] : [off];
+  const worst = Math.max(...centres.map((c) => Math.abs(c)));
+  const clearance = width / 2 - worst;
+  if (clearance < FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES) {
+    const required = 2 * (worst + FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES);
+    issues.push({
+      code: "clearance",
+      message: `Track sits ${round2(clearance)}\u2033 from the fascia \u2014 the standard requires at least ${FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES}\u2033. Widen this end to ${round2(required)}\u2033` + (off !== 0 ? " or move the track back toward the centre." : "."),
+      requiredInches: required
+    });
+  }
+  return issues;
+}
+var round2 = (n) => Math.round(n * 100) / 100;
 function endplateWidthFor(widths, id) {
   const w = widths?.[id];
   return typeof w === "number" && w > 0 ? w : FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES;
@@ -210,6 +249,7 @@ function emptyEditorState(lengthInches) {
     loopReturn: "same",
     configA: "single",
     configB: "single",
+    mainsSwapped: false,
     extraTracks: [],
     turnouts: [],
     crossings: [],
@@ -230,29 +270,31 @@ function main1Track(state) {
   const bothDouble = state.configA === "double" && state.configB === "double";
   const isDouble = state.configA === "double" || state.configB === "double";
   const sw = state.turnouts.find(isTransitionTurnout);
+  const lane = state.mainsSwapped && isDouble ? 1 : 0;
   if (!isDouble || bothDouble || !sw || sw.onTrack !== MAIN2_TRACK_ID) {
-    return { id: MAIN_TRACK_ID, role: "main", lane: 0, from: "A", to: "B" };
+    return { id: MAIN_TRACK_ID, role: "main", lane, from: "A", to: "B" };
   }
   return state.configA === "double" ? (
     // Double at A: Main 1 runs from A and ends at the turnout.
-    { id: MAIN_TRACK_ID, role: "main", lane: 0, fromPos: 0, toPos: sw.pos }
+    { id: MAIN_TRACK_ID, role: "main", lane, fromPos: 0, toPos: sw.pos }
   ) : (
     // Double at B: Main 1 begins at the turnout and runs to B.
-    { id: MAIN_TRACK_ID, role: "main", lane: 0, fromPos: sw.pos, toPos: state.lengthInches }
+    { id: MAIN_TRACK_ID, role: "main", lane, fromPos: sw.pos, toPos: state.lengthInches }
   );
 }
 function main2Track(state) {
   const bothDouble = state.configA === "double" && state.configB === "double";
   const sw = state.turnouts.find(isTransitionTurnout);
+  const lane = state.mainsSwapped ? 0 : 1;
   if (bothDouble || !sw || sw.divergeTrack !== MAIN2_TRACK_ID) {
-    return { id: MAIN2_TRACK_ID, role: "main", lane: 1, from: "A", to: "B" };
+    return { id: MAIN2_TRACK_ID, role: "main", lane, from: "A", to: "B" };
   }
   return state.configA === "double" ? (
     // Double at A: Main 2 runs from A and ends at the turnout.
-    { id: MAIN2_TRACK_ID, role: "main", lane: 1, fromPos: 0, toPos: sw.pos }
+    { id: MAIN2_TRACK_ID, role: "main", lane, fromPos: 0, toPos: sw.pos }
   ) : (
     // Double at B: Main 2 begins at the turnout and runs to B.
-    { id: MAIN2_TRACK_ID, role: "main", lane: 1, fromPos: sw.pos, toPos: state.lengthInches }
+    { id: MAIN2_TRACK_ID, role: "main", lane, fromPos: sw.pos, toPos: state.lengthInches }
   );
 }
 function buildTransition(state) {
@@ -309,6 +351,7 @@ function stateToDoc(state, recordNumber) {
     lengthInches: state.lengthInches,
     ...state.loop ? { loop: true } : {},
     ...state.loop && state.loopReturn === "main2" ? { loopReturn: "main2" } : {},
+    ...state.mainsSwapped ? { mainsSwapped: true } : {},
     endplates: withWidths(
       withPoses(
         [
@@ -520,6 +563,7 @@ function docToState(doc, fallbackLength, moduleTracks = []) {
     lengthInches: len,
     loop,
     loopReturn: loop && d.loopReturn === "main2" ? "main2" : "same",
+    mainsSwapped: d.mainsSwapped === true,
     configA: configOf("A"),
     // On a loop, a missing B means pure turnback; present = interchange loop.
     configB: loop && !hasB ? "none" : configOf("B"),
@@ -1034,8 +1078,10 @@ function poseOverridesFromDoc(doc) {
   return out;
 }
 
+exports.FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES = FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES;
 exports.FREEMO_ENDPLATE_WIDTH_MIN_INCHES = FREEMO_ENDPLATE_WIDTH_MIN_INCHES;
 exports.FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES = FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES;
+exports.FREEMO_TRACK_SPACING_INCHES = FREEMO_TRACK_SPACING_INCHES;
 exports.MAIN2_TRACK_ID = MAIN2_TRACK_ID;
 exports.MAIN_TRACK_ID = MAIN_TRACK_ID;
 exports.N_CAR_LENGTH_INCHES = N_CAR_LENGTH_INCHES;
@@ -1047,11 +1093,13 @@ exports.buildCrossover = buildCrossover;
 exports.buildPassingSiding = buildPassingSiding;
 exports.buildTransition = buildTransition;
 exports.carCapacity = carCapacity;
+exports.checkEndplateWidth = checkEndplateWidth;
 exports.deriveEndplatePoses = deriveEndplatePoses;
 exports.divergeSideForHand = divergeSideForHand;
 exports.docToState = docToState;
 exports.emptyEditorState = emptyEditorState;
 exports.endplateFaceSegments = endplateFaceSegments;
+exports.endplateTrackOffsetFor = endplateTrackOffsetFor;
 exports.endplateWidthInches = endplateWidthInches;
 exports.geometryTurnDegrees = geometryTurnDegrees;
 exports.inchesToScaleFeet = inchesToScaleFeet;