@willcgage/module-schematic 0.25.0 → 0.26.0

package/dist/index.d.cts

@@ -201,6 +201,10 @@ interface ModuleSchematicDoc {
      * tracks unrolled as a ladder past the throat — the default when inLoop
      * tracks exist), "geometric" (drawn balloon, AL&E-style). */
     loopRender?: "bulb" | "fan" | "geometric";
+    /** The two mains' positions are swapped: Main 1 draws above (lane 1), Main 2
+     * on the centre line (lane 0). Absent/false = the default (Main 1 below).
+     * Identities are unchanged — only which lane each is drawn in (#FMN-0043). */
+    mainsSwapped?: boolean;
     endplates: SchematicEndplate[];
     tracks: SchematicTrack[];
     turnouts?: SchematicTurnout[];
@@ -429,6 +433,11 @@ interface EditorState {
     loopReturn: "same" | "main2";
     configA: TrackConfig;
     configB: EndplateBConfig;
+    /** Swap the two mains' POSITIONS: Main 1 draws above (lane 1) and Main 2 on
+     * the centre line (lane 0). The module decides which physical track is which
+     * main — on some modules the upper track is the through/primary main
+     * (#FMN-0043). Identities and references are unchanged; only the lanes swap. */
+    mainsSwapped: boolean;
     extraTracks: EditorTrack[];
     turnouts: EditorTurnout[];
     /** Grade crossings / diamonds (#170). */

package/dist/index.d.ts

@@ -201,6 +201,10 @@ interface ModuleSchematicDoc {
      * tracks unrolled as a ladder past the throat — the default when inLoop
      * tracks exist), "geometric" (drawn balloon, AL&E-style). */
     loopRender?: "bulb" | "fan" | "geometric";
+    /** The two mains' positions are swapped: Main 1 draws above (lane 1), Main 2
+     * on the centre line (lane 0). Absent/false = the default (Main 1 below).
+     * Identities are unchanged — only which lane each is drawn in (#FMN-0043). */
+    mainsSwapped?: boolean;
     endplates: SchematicEndplate[];
     tracks: SchematicTrack[];
     turnouts?: SchematicTurnout[];
@@ -429,6 +433,11 @@ interface EditorState {
     loopReturn: "same" | "main2";
     configA: TrackConfig;
     configB: EndplateBConfig;
+    /** Swap the two mains' POSITIONS: Main 1 draws above (lane 1) and Main 2 on
+     * the centre line (lane 0). The module decides which physical track is which
+     * main — on some modules the upper track is the through/primary main
+     * (#FMN-0043). Identities and references are unchanged; only the lanes swap. */
+    mainsSwapped: boolean;
     extraTracks: EditorTrack[];
     turnouts: EditorTurnout[];
     /** Grade crossings / diamonds (#170). */

package/dist/index.js

@@ -208,6 +208,7 @@ function emptyEditorState(lengthInches) {
     loopReturn: "same",
     configA: "single",
     configB: "single",
+    mainsSwapped: false,
     extraTracks: [],
     turnouts: [],
     crossings: [],
@@ -228,29 +229,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) {
@@ -307,6 +310,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(
         [
@@ -518,6 +522,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"),