@willcgage/module-schematic 0.25.0 → 0.27.0

package/dist/index.d.cts

@@ -51,7 +51,17 @@ interface SchematicEndplate {
 }
 /** Free-moN endplate face width, inches — the connection interface size. */
 declare const FREEMO_ENDPLATE_WIDTH_MIN_INCHES = 12;
+/** NB: our own default, NOT from the standard — §1.1 states only the 12″ minimum
+ * ("Endplates shall be 6 inches high and a minimum 12 inches wide"). 24″ is
+ * simply a common real-world width. Don't present it as required. */
 declare const FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES = 24;
+/** Free-moN §2.0 **standard**: "Double track endplates must have a track spacing
+ * of 1.125 inches (1 1/8 inches). Track spacing shall be measured along the
+ * track center line." The one definition both apps read. */
+declare const FREEMO_TRACK_SPACING_INCHES = 1.125;
+/** Free-moN §2.0 **standard**: track crossing an endplate must be "not less than
+ * 4 inches from either fascia" (and perpendicular, straight and level for 4″). */
+declare const FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES = 4;
 /**
  * The authored face width for an endplate, or the recommended default when a
  * module hasn't authored one. The single source of truth both apps read so a
@@ -201,6 +211,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[];
@@ -273,6 +287,13 @@ interface ModuleFootprintInput {
     geometryOffsetInches?: number | null;
     /** Authored endplate face widths by id ("A"/"B"…), inches; default recommended. */
     endplateWidths?: Record<string, number>;
+    /** Where each endplate's CENTRE sits relative to the main centre-line at that
+     * end, inches (signed, along the +normal). Free-moN puts a **double**-track
+     * plate's two tracks 9/16″ either side of its centre, so with Main 1 on the
+     * centre-line the plate centre is half a track spacing up — pass
+     * `FREEMO_TRACK_SPACING_INCHES / 2`. Single track crosses at the centre ⇒ 0
+     * (the default), and an off-centre track is a signed value. */
+    endplateTrackOffsets?: Record<string, number>;
     /** Authored benchwork outline (module-local inches), or absent for the band. */
     outline?: BenchworkPoint[] | null;
     /** Authored mainline centre-line (module-local inches, open path with arcs).
@@ -301,15 +322,49 @@ interface ModuleFootprint {
  * centre-line is derived from the geometry fields (length + type/degrees/offset). */
 declare function moduleCenterline(input: ModuleFootprintInput): BenchworkPoint[];
 /** Benchwork band: the centre-line offset ±half-width, tapering widthA→widthB. */
-declare function benchworkBand(center: BenchworkPoint[], widthA?: number, widthB?: number): BenchworkPoint[];
+declare function benchworkBand(center: BenchworkPoint[], widthA?: number, widthB?: number, offsetA?: number, offsetB?: number): BenchworkPoint[];
 /** The two endplate faces (the band's flat ends): [A end at widthA, B end at widthB]. */
-declare function endplateFaceSegments(center: BenchworkPoint[], widthA?: number, widthB?: number): OutlineFace[];
+declare function endplateFaceSegments(center: BenchworkPoint[], widthA?: number, widthB?: number, offsetA?: number, offsetB?: number): OutlineFace[];
 /**
  * The full single-module physical footprint: centre-line + derived band +
  * endplate faces + the authored outline (arc-sampled), all in module-local
  * inches. Renderers draw `outline ?? band`.
  */
 declare function moduleFootprint(input: ModuleFootprintInput): ModuleFootprint;
+/**
+ * The offset from the main centre-line to an endplate's CENTRE, inches — the
+ * Free-moN geometry. A **double**-track end carries its two tracks 9/16″ either
+ * side of the plate centre (§2.0 RP), and Main 1 sits on the centre-line, so the
+ * plate centre is half a track spacing up. A single track crosses at the centre.
+ */
+declare function endplateTrackOffsetFor(config: TrackConfig | "none" | undefined): number;
+/** A Free-moN conformance problem with an endplate's width/track placement. */
+interface EndplateWidthIssue {
+    /** "narrow" = below the 12″ minimum; "clearance" = a track too near a fascia. */
+    code: "narrow" | "clearance";
+    /** Plain-language problem, for the author. */
+    message: string;
+    /** The width that would satisfy this rule, inches. */
+    requiredInches: number;
+}
+/**
+ * Check an endplate against the two Free-moN **standards** that bound its width:
+ *
+ * - §1.1 "Endplates shall be 6 inches high and a **minimum 12 inches wide**."
+ * - §2.0 "At the endplate, track shall cross near center on the width, **not less
+ *   than 4 inches from either fascia**."
+ *
+ * With the tracks centred (the §2.0 recommendation) a double-track end needs
+ * 4 + 1.125 + 4 = 9.125″ for clearance alone, so the 12″ minimum governs — but an
+ * **off-centre** track can breach the 4″ rule on a plate that is otherwise wide
+ * enough, which is why both are checked. `trackOffsetInches` is the signed
+ * distance from the plate's centre to the main's crossing point (0 = centred).
+ */
+declare function checkEndplateWidth(input: {
+    widthInches?: number | null;
+    config?: TrackConfig | "none" | null;
+    trackOffsetInches?: number | null;
+}): EndplateWidthIssue[];
 /** Whether a doc is a single-endplate turnback (explicit flag or one endplate). */
 declare function isLoopDoc(doc: ModuleSchematicDoc): boolean;
 declare const MAIN_TRACK_ID = "main";
@@ -429,6 +484,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). */
@@ -736,4 +796,4 @@ declare function poseOverridesFromDoc(doc: ModuleSchematicDoc): Record<string, {
     heading: number;
 }>;
 
-export { type BenchworkPoint, type BranchConnector, type DrawCrossing, type DrawCrossover, type DrawIndustry, type DrawSignal, type DrawTrack, type DrawTurnout, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorIndustry, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplatePose, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, type GeometryType, type IndustryLabelMode, type IndustrySpot, MAIN2_TRACK_ID, MAIN_TRACK_ID, type ModuleFeatures, type ModuleFootprint, type ModuleFootprintInput, type ModuleGeometryInput, type ModuleSchematicDoc, type ModuleTrackRow, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, type OutlineFace, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicIndustry, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SignalFacing, type SignalSide, type TrackConfig, type TrackRole, type TurnoutKind, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleCenterline, moduleFeatures, moduleFootprint, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, samplePath, scaleFeetToInches, stateToDoc, trackPath };
+export { type BenchworkPoint, type BranchConnector, type DrawCrossing, type DrawCrossover, type DrawIndustry, type DrawSignal, type DrawTrack, type DrawTurnout, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorIndustry, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplatePose, type EndplateWidthIssue, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type GeometryType, type IndustryLabelMode, type IndustrySpot, MAIN2_TRACK_ID, MAIN_TRACK_ID, type ModuleFeatures, type ModuleFootprint, type ModuleFootprintInput, type ModuleGeometryInput, type ModuleSchematicDoc, type ModuleTrackRow, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, type OutlineFace, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicIndustry, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SignalFacing, type SignalSide, type TrackConfig, type TrackRole, type TurnoutKind, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateTrackOffsetFor, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleCenterline, moduleFeatures, moduleFootprint, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, samplePath, scaleFeetToInches, stateToDoc, trackPath };

package/dist/index.d.ts

@@ -51,7 +51,17 @@ interface SchematicEndplate {
 }
 /** Free-moN endplate face width, inches — the connection interface size. */
 declare const FREEMO_ENDPLATE_WIDTH_MIN_INCHES = 12;
+/** NB: our own default, NOT from the standard — §1.1 states only the 12″ minimum
+ * ("Endplates shall be 6 inches high and a minimum 12 inches wide"). 24″ is
+ * simply a common real-world width. Don't present it as required. */
 declare const FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES = 24;
+/** Free-moN §2.0 **standard**: "Double track endplates must have a track spacing
+ * of 1.125 inches (1 1/8 inches). Track spacing shall be measured along the
+ * track center line." The one definition both apps read. */
+declare const FREEMO_TRACK_SPACING_INCHES = 1.125;
+/** Free-moN §2.0 **standard**: track crossing an endplate must be "not less than
+ * 4 inches from either fascia" (and perpendicular, straight and level for 4″). */
+declare const FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES = 4;
 /**
  * The authored face width for an endplate, or the recommended default when a
  * module hasn't authored one. The single source of truth both apps read so a
@@ -201,6 +211,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[];
@@ -273,6 +287,13 @@ interface ModuleFootprintInput {
     geometryOffsetInches?: number | null;
     /** Authored endplate face widths by id ("A"/"B"…), inches; default recommended. */
     endplateWidths?: Record<string, number>;
+    /** Where each endplate's CENTRE sits relative to the main centre-line at that
+     * end, inches (signed, along the +normal). Free-moN puts a **double**-track
+     * plate's two tracks 9/16″ either side of its centre, so with Main 1 on the
+     * centre-line the plate centre is half a track spacing up — pass
+     * `FREEMO_TRACK_SPACING_INCHES / 2`. Single track crosses at the centre ⇒ 0
+     * (the default), and an off-centre track is a signed value. */
+    endplateTrackOffsets?: Record<string, number>;
     /** Authored benchwork outline (module-local inches), or absent for the band. */
     outline?: BenchworkPoint[] | null;
     /** Authored mainline centre-line (module-local inches, open path with arcs).
@@ -301,15 +322,49 @@ interface ModuleFootprint {
  * centre-line is derived from the geometry fields (length + type/degrees/offset). */
 declare function moduleCenterline(input: ModuleFootprintInput): BenchworkPoint[];
 /** Benchwork band: the centre-line offset ±half-width, tapering widthA→widthB. */
-declare function benchworkBand(center: BenchworkPoint[], widthA?: number, widthB?: number): BenchworkPoint[];
+declare function benchworkBand(center: BenchworkPoint[], widthA?: number, widthB?: number, offsetA?: number, offsetB?: number): BenchworkPoint[];
 /** The two endplate faces (the band's flat ends): [A end at widthA, B end at widthB]. */
-declare function endplateFaceSegments(center: BenchworkPoint[], widthA?: number, widthB?: number): OutlineFace[];
+declare function endplateFaceSegments(center: BenchworkPoint[], widthA?: number, widthB?: number, offsetA?: number, offsetB?: number): OutlineFace[];
 /**
  * The full single-module physical footprint: centre-line + derived band +
  * endplate faces + the authored outline (arc-sampled), all in module-local
  * inches. Renderers draw `outline ?? band`.
  */
 declare function moduleFootprint(input: ModuleFootprintInput): ModuleFootprint;
+/**
+ * The offset from the main centre-line to an endplate's CENTRE, inches — the
+ * Free-moN geometry. A **double**-track end carries its two tracks 9/16″ either
+ * side of the plate centre (§2.0 RP), and Main 1 sits on the centre-line, so the
+ * plate centre is half a track spacing up. A single track crosses at the centre.
+ */
+declare function endplateTrackOffsetFor(config: TrackConfig | "none" | undefined): number;
+/** A Free-moN conformance problem with an endplate's width/track placement. */
+interface EndplateWidthIssue {
+    /** "narrow" = below the 12″ minimum; "clearance" = a track too near a fascia. */
+    code: "narrow" | "clearance";
+    /** Plain-language problem, for the author. */
+    message: string;
+    /** The width that would satisfy this rule, inches. */
+    requiredInches: number;
+}
+/**
+ * Check an endplate against the two Free-moN **standards** that bound its width:
+ *
+ * - §1.1 "Endplates shall be 6 inches high and a **minimum 12 inches wide**."
+ * - §2.0 "At the endplate, track shall cross near center on the width, **not less
+ *   than 4 inches from either fascia**."
+ *
+ * With the tracks centred (the §2.0 recommendation) a double-track end needs
+ * 4 + 1.125 + 4 = 9.125″ for clearance alone, so the 12″ minimum governs — but an
+ * **off-centre** track can breach the 4″ rule on a plate that is otherwise wide
+ * enough, which is why both are checked. `trackOffsetInches` is the signed
+ * distance from the plate's centre to the main's crossing point (0 = centred).
+ */
+declare function checkEndplateWidth(input: {
+    widthInches?: number | null;
+    config?: TrackConfig | "none" | null;
+    trackOffsetInches?: number | null;
+}): EndplateWidthIssue[];
 /** Whether a doc is a single-endplate turnback (explicit flag or one endplate). */
 declare function isLoopDoc(doc: ModuleSchematicDoc): boolean;
 declare const MAIN_TRACK_ID = "main";
@@ -429,6 +484,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). */
@@ -736,4 +796,4 @@ declare function poseOverridesFromDoc(doc: ModuleSchematicDoc): Record<string, {
     heading: number;
 }>;
 
-export { type BenchworkPoint, type BranchConnector, type DrawCrossing, type DrawCrossover, type DrawIndustry, type DrawSignal, type DrawTrack, type DrawTurnout, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorIndustry, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplatePose, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, type GeometryType, type IndustryLabelMode, type IndustrySpot, MAIN2_TRACK_ID, MAIN_TRACK_ID, type ModuleFeatures, type ModuleFootprint, type ModuleFootprintInput, type ModuleGeometryInput, type ModuleSchematicDoc, type ModuleTrackRow, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, type OutlineFace, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicIndustry, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SignalFacing, type SignalSide, type TrackConfig, type TrackRole, type TurnoutKind, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleCenterline, moduleFeatures, moduleFootprint, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, samplePath, scaleFeetToInches, stateToDoc, trackPath };
+export { type BenchworkPoint, type BranchConnector, type DrawCrossing, type DrawCrossover, type DrawIndustry, type DrawSignal, type DrawTrack, type DrawTurnout, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorIndustry, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplatePose, type EndplateWidthIssue, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type GeometryType, type IndustryLabelMode, type IndustrySpot, MAIN2_TRACK_ID, MAIN_TRACK_ID, type ModuleFeatures, type ModuleFootprint, type ModuleFootprintInput, type ModuleGeometryInput, type ModuleSchematicDoc, type ModuleTrackRow, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, type OutlineFace, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicIndustry, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SignalFacing, type SignalSide, type TrackConfig, type TrackRole, type TurnoutKind, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateTrackOffsetFor, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleCenterline, moduleFeatures, moduleFootprint, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, samplePath, scaleFeetToInches, stateToDoc, trackPath };

package/dist/index.js

@@ -1,6 +1,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;
@@ -142,37 +144,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;
@@ -208,6 +247,7 @@ function emptyEditorState(lengthInches) {
     loopReturn: "same",
     configA: "single",
     configB: "single",
+    mainsSwapped: false,
     extraTracks: [],
     turnouts: [],
     crossings: [],
@@ -228,29 +268,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 +349,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 +561,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"),
@@ -1032,6 +1076,6 @@ function poseOverridesFromDoc(doc) {
   return out;
 }
 
-export { FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, MAIN2_TRACK_ID, MAIN_TRACK_ID, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleCenterline, moduleFeatures, moduleFootprint, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, samplePath, scaleFeetToInches, stateToDoc, trackPath };
+export { FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, MAIN2_TRACK_ID, MAIN_TRACK_ID, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateTrackOffsetFor, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleCenterline, moduleFeatures, moduleFootprint, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, samplePath, scaleFeetToInches, stateToDoc, trackPath };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map