@willcgage/module-schematic 0.70.0 → 0.71.0

package/dist/index.d.cts

@@ -428,10 +428,18 @@ interface ModuleFootprintInput {
     /** 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. */
+     * centre-line the plate centre is half a track spacing toward Main 2. Single
+     * track crosses at the centre ⇒ 0, and an off-centre track is a signed value.
+     * {@link endplateCentreOffsetInches} computes it from what the owner authored.
+     *
+     * ⚠️ OMITTING an end no longer means 0 — it means "use §2.0", which is a
+     * straddle on a double end. Centring a double plate on Main 1 drew its pair
+     * wholly to one side, which is what the read-only and catalog views did by
+     * passing nothing at all (#190). Pass an explicit number to place a plate. */
     endplateTrackOffsets?: Record<string, number>;
+    /** Whether Main 2 runs BELOW Main 1 (`mainsSwapped`, #131). Only affects which
+     * way an unauthored double plate straddles. */
+    mainsSwapped?: boolean;
     /** Authored benchwork outline (module-local inches), or absent for the band. */
     outline?: BenchworkPoint[] | null;
     /** Authored benchwork HOLE — the inner boundary punched out of `outline` to
@@ -637,23 +645,45 @@ declare function endplateFaceSegments(center: BenchworkPoint[], widthA?: number,
  */
 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.
+ * Where an endplate's CENTRE sits relative to MAIN 1 — the renderer's framing,
+ * and the one number a drawing needs to place the plate.
+ *
+ * ⭐ THE single definition. Two callers had their own: the builder computed it
+ * inline (swap-aware), and the read-only/catalog footprint **passed nothing at
+ * all**, so every plate there was centred on Main 1 — a double end drew its pair
+ * entirely to one side of the plate instead of straddling it (#190).
+ *
+ * §2.0 puts a double end's two tracks 0.5625″ either side of the plate centre,
+ * so the plate centre is half a track spacing away from Main 1 — **toward Main
+ * 2**, which is why the swap matters: with Main 2 below, the plate centre is
+ * below too. An authored offset always wins (an off-centre end is legal since
+ * the 20220628 revision), and is given in the standard's own framing — Main 1's
+ * distance from the plate centre — so it comes back negated here.
  */
-declare function endplateTrackOffsetFor(config: TrackConfig | "none" | undefined, authoredTrackOffset?: number | null): number;
+declare function endplateCentreOffsetInches(input: {
+    config?: TrackConfig | "none" | null;
+    /** Main 1's signed distance from the plate centre, as authored. */
+    authoredTrackOffsetInches?: number | null;
+    /** Whether Main 2 runs below Main 1 (the mains are swapped). */
+    main2Below?: boolean;
+}): number;
 /**
  * Where an endplate's PRIMARY track (Main 1) crosses, as a signed distance from
  * the plate's CENTRE — the standard's own framing. Authored value wins; absent
  * falls back to the §2.0 recommendations: a single track centred (0), a double
  * straddling so its two tracks land ∓ half the track spacing (Main 1 low).
  */
-declare function endplateTrackOffsetInches(authored: number | null | undefined, config: TrackConfig | "none" | undefined): number;
+declare function endplateTrackOffsetInches(authored: number | null | undefined, config: TrackConfig | "none" | undefined, 
+/** Whether Main 2 runs BELOW Main 1 (the mains are swapped). The pair
+ * straddles the plate centre either way, so Main 1 sits on the side AWAY from
+ * Main 2 — low when Main 2 is high, high when it's low. Omitting this
+ * hard-coded "Main 2 is above", which is the assumption behind #190. */
+main2Below?: boolean): 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";
+    /** "narrow" = below the 12″ minimum; "clearance" = a track too near a fascia;
+     * "offcentre" = a double end whose pair doesn't straddle the plate centre. */
+    code: "narrow" | "clearance" | "offcentre";
     /** Plain-language problem, for the author. */
     message: string;
     /** The width that would satisfy this rule, inches. */
@@ -676,6 +706,10 @@ declare function checkEndplateWidth(input: {
     widthInches?: number | null;
     config?: TrackConfig | "none" | null;
     trackOffsetInches?: number | null;
+    /** Whether Main 2 runs BELOW Main 1 (the mains are swapped). Without it a
+     * double end's second track was assumed to be one spacing ABOVE Main 1, so a
+     * swapped pair was measured on the wrong side of the plate (#190). */
+    main2Below?: boolean;
 }): EndplateWidthIssue[];
 /**
  * Whether a module presents NO far endplate — one conforming face only.
@@ -1810,4 +1844,4 @@ declare function poseOverridesFromDoc(doc: ModuleSchematicDoc): Record<string, {
     heading: number;
 }>;
 
-export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, type BenchworkPoint, type BranchConnector, CODE55_RAIL_HEIGHT_INCHES, type DimensionSource, type DrawCrossing, type DrawCrossover, type DrawIndustry, type DrawSignal, type DrawTrack, type DrawTurnout, ENDPLATE_FASCIA_CLEAR_INCHES, ENDPLATE_LEAD_INCHES, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorIndustry, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplatePose, type EndplateTrackIssue, type EndplateWidthIssue, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type FrogCasting, type GeometryType, type ImportedPart, 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 PartAngle, type PartDimension, type PartEnd, type PartExtent, type PartSegment, RAIL_GAUGE_INCHES, type ReturnLoopGeometry, type ReturnLoopShape, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicIndustry, type SchematicSection, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SectionAdjacency, type SectionFootprint, type SectionRelativePos, type SignalFacing, type SignalSide, type StoredTrackPart, TIE_HALF_LENGTH_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, type TrackConfig, type TrackPart, type TrackRole, type TurnoutClosure, type TurnoutKind, WHOLE_MODULE_SECTION_ID, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateLead, endplateTrackOffsetFor, endplateTrackOffsetInches, endplateWidthInches, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, hasNoFarEndplate, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, leadInchesForSize, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partOutlineAtFrog, pastFrogInchesForSize, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutPartForSize };
+export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, type BenchworkPoint, type BranchConnector, CODE55_RAIL_HEIGHT_INCHES, type DimensionSource, type DrawCrossing, type DrawCrossover, type DrawIndustry, type DrawSignal, type DrawTrack, type DrawTurnout, ENDPLATE_FASCIA_CLEAR_INCHES, ENDPLATE_LEAD_INCHES, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorIndustry, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplatePose, type EndplateTrackIssue, type EndplateWidthIssue, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type FrogCasting, type GeometryType, type ImportedPart, 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 PartAngle, type PartDimension, type PartEnd, type PartExtent, type PartSegment, RAIL_GAUGE_INCHES, type ReturnLoopGeometry, type ReturnLoopShape, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicIndustry, type SchematicSection, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SectionAdjacency, type SectionFootprint, type SectionRelativePos, type SignalFacing, type SignalSide, type StoredTrackPart, TIE_HALF_LENGTH_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, type TrackConfig, type TrackPart, type TrackRole, type TurnoutClosure, type TurnoutKind, WHOLE_MODULE_SECTION_ID, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateCentreOffsetInches, endplateFaceSegments, endplateLead, endplateTrackOffsetInches, endplateWidthInches, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, hasNoFarEndplate, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, leadInchesForSize, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partOutlineAtFrog, pastFrogInchesForSize, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutPartForSize };

package/dist/index.d.ts

@@ -428,10 +428,18 @@ interface ModuleFootprintInput {
     /** 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. */
+     * centre-line the plate centre is half a track spacing toward Main 2. Single
+     * track crosses at the centre ⇒ 0, and an off-centre track is a signed value.
+     * {@link endplateCentreOffsetInches} computes it from what the owner authored.
+     *
+     * ⚠️ OMITTING an end no longer means 0 — it means "use §2.0", which is a
+     * straddle on a double end. Centring a double plate on Main 1 drew its pair
+     * wholly to one side, which is what the read-only and catalog views did by
+     * passing nothing at all (#190). Pass an explicit number to place a plate. */
     endplateTrackOffsets?: Record<string, number>;
+    /** Whether Main 2 runs BELOW Main 1 (`mainsSwapped`, #131). Only affects which
+     * way an unauthored double plate straddles. */
+    mainsSwapped?: boolean;
     /** Authored benchwork outline (module-local inches), or absent for the band. */
     outline?: BenchworkPoint[] | null;
     /** Authored benchwork HOLE — the inner boundary punched out of `outline` to
@@ -637,23 +645,45 @@ declare function endplateFaceSegments(center: BenchworkPoint[], widthA?: number,
  */
 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.
+ * Where an endplate's CENTRE sits relative to MAIN 1 — the renderer's framing,
+ * and the one number a drawing needs to place the plate.
+ *
+ * ⭐ THE single definition. Two callers had their own: the builder computed it
+ * inline (swap-aware), and the read-only/catalog footprint **passed nothing at
+ * all**, so every plate there was centred on Main 1 — a double end drew its pair
+ * entirely to one side of the plate instead of straddling it (#190).
+ *
+ * §2.0 puts a double end's two tracks 0.5625″ either side of the plate centre,
+ * so the plate centre is half a track spacing away from Main 1 — **toward Main
+ * 2**, which is why the swap matters: with Main 2 below, the plate centre is
+ * below too. An authored offset always wins (an off-centre end is legal since
+ * the 20220628 revision), and is given in the standard's own framing — Main 1's
+ * distance from the plate centre — so it comes back negated here.
  */
-declare function endplateTrackOffsetFor(config: TrackConfig | "none" | undefined, authoredTrackOffset?: number | null): number;
+declare function endplateCentreOffsetInches(input: {
+    config?: TrackConfig | "none" | null;
+    /** Main 1's signed distance from the plate centre, as authored. */
+    authoredTrackOffsetInches?: number | null;
+    /** Whether Main 2 runs below Main 1 (the mains are swapped). */
+    main2Below?: boolean;
+}): number;
 /**
  * Where an endplate's PRIMARY track (Main 1) crosses, as a signed distance from
  * the plate's CENTRE — the standard's own framing. Authored value wins; absent
  * falls back to the §2.0 recommendations: a single track centred (0), a double
  * straddling so its two tracks land ∓ half the track spacing (Main 1 low).
  */
-declare function endplateTrackOffsetInches(authored: number | null | undefined, config: TrackConfig | "none" | undefined): number;
+declare function endplateTrackOffsetInches(authored: number | null | undefined, config: TrackConfig | "none" | undefined, 
+/** Whether Main 2 runs BELOW Main 1 (the mains are swapped). The pair
+ * straddles the plate centre either way, so Main 1 sits on the side AWAY from
+ * Main 2 — low when Main 2 is high, high when it's low. Omitting this
+ * hard-coded "Main 2 is above", which is the assumption behind #190. */
+main2Below?: boolean): 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";
+    /** "narrow" = below the 12″ minimum; "clearance" = a track too near a fascia;
+     * "offcentre" = a double end whose pair doesn't straddle the plate centre. */
+    code: "narrow" | "clearance" | "offcentre";
     /** Plain-language problem, for the author. */
     message: string;
     /** The width that would satisfy this rule, inches. */
@@ -676,6 +706,10 @@ declare function checkEndplateWidth(input: {
     widthInches?: number | null;
     config?: TrackConfig | "none" | null;
     trackOffsetInches?: number | null;
+    /** Whether Main 2 runs BELOW Main 1 (the mains are swapped). Without it a
+     * double end's second track was assumed to be one spacing ABOVE Main 1, so a
+     * swapped pair was measured on the wrong side of the plate (#190). */
+    main2Below?: boolean;
 }): EndplateWidthIssue[];
 /**
  * Whether a module presents NO far endplate — one conforming face only.
@@ -1810,4 +1844,4 @@ declare function poseOverridesFromDoc(doc: ModuleSchematicDoc): Record<string, {
     heading: number;
 }>;
 
-export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, type BenchworkPoint, type BranchConnector, CODE55_RAIL_HEIGHT_INCHES, type DimensionSource, type DrawCrossing, type DrawCrossover, type DrawIndustry, type DrawSignal, type DrawTrack, type DrawTurnout, ENDPLATE_FASCIA_CLEAR_INCHES, ENDPLATE_LEAD_INCHES, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorIndustry, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplatePose, type EndplateTrackIssue, type EndplateWidthIssue, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type FrogCasting, type GeometryType, type ImportedPart, 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 PartAngle, type PartDimension, type PartEnd, type PartExtent, type PartSegment, RAIL_GAUGE_INCHES, type ReturnLoopGeometry, type ReturnLoopShape, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicIndustry, type SchematicSection, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SectionAdjacency, type SectionFootprint, type SectionRelativePos, type SignalFacing, type SignalSide, type StoredTrackPart, TIE_HALF_LENGTH_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, type TrackConfig, type TrackPart, type TrackRole, type TurnoutClosure, type TurnoutKind, WHOLE_MODULE_SECTION_ID, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateLead, endplateTrackOffsetFor, endplateTrackOffsetInches, endplateWidthInches, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, hasNoFarEndplate, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, leadInchesForSize, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partOutlineAtFrog, pastFrogInchesForSize, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutPartForSize };
+export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, type BenchworkPoint, type BranchConnector, CODE55_RAIL_HEIGHT_INCHES, type DimensionSource, type DrawCrossing, type DrawCrossover, type DrawIndustry, type DrawSignal, type DrawTrack, type DrawTurnout, ENDPLATE_FASCIA_CLEAR_INCHES, ENDPLATE_LEAD_INCHES, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorIndustry, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplatePose, type EndplateTrackIssue, type EndplateWidthIssue, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type FrogCasting, type GeometryType, type ImportedPart, 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 PartAngle, type PartDimension, type PartEnd, type PartExtent, type PartSegment, RAIL_GAUGE_INCHES, type ReturnLoopGeometry, type ReturnLoopShape, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicIndustry, type SchematicSection, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SectionAdjacency, type SectionFootprint, type SectionRelativePos, type SignalFacing, type SignalSide, type StoredTrackPart, TIE_HALF_LENGTH_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, type TrackConfig, type TrackPart, type TrackRole, type TurnoutClosure, type TurnoutKind, WHOLE_MODULE_SECTION_ID, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateCentreOffsetInches, endplateFaceSegments, endplateLead, endplateTrackOffsetInches, endplateWidthInches, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, hasNoFarEndplate, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, leadInchesForSize, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partOutlineAtFrog, pastFrogInchesForSize, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutPartForSize };

package/dist/index.js

@@ -469,8 +469,12 @@ function moduleFootprint(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;
+  const offOf = (i, id) => input.endplateTrackOffsets?.[id] ?? endplateCentreOffsetInches({
+    config: input.endplateConfigs?.[i],
+    main2Below: input.mainsSwapped === true
+  });
+  const offA = offOf(0, "A");
+  const offB = offOf(1, "B");
   const secs = input.sections ?? [];
   const sectionsOwnShape = secs.length > 1 || secs.some((s) => (s.outline?.length ?? 0) >= 3);
   const sectionOutlines = sectionsOwnShape ? sectionFootprints(input, {
@@ -494,13 +498,19 @@ function moduleFootprint(input) {
     sectionOutlines
   };
 }
-function endplateTrackOffsetFor(config, authoredTrackOffset) {
-  const v = -endplateTrackOffsetInches(authoredTrackOffset, config);
+function endplateCentreOffsetInches(input) {
+  const v = -endplateTrackOffsetInches(
+    input.authoredTrackOffsetInches,
+    input.config ?? void 0,
+    input.main2Below
+  );
   return v === 0 ? 0 : v;
 }
-function endplateTrackOffsetInches(authored, config) {
+function endplateTrackOffsetInches(authored, config, main2Below = false) {
   if (typeof authored === "number" && Number.isFinite(authored)) return authored;
-  return config === "double" ? -FREEMO_TRACK_SPACING_INCHES / 2 : 0;
+  if (config !== "double") return 0;
+  const half = FREEMO_TRACK_SPACING_INCHES / 2;
+  return main2Below ? half : -half;
 }
 function checkEndplateWidth(input) {
   const width = endplateWidthInches(input);
@@ -512,8 +522,13 @@ function checkEndplateWidth(input) {
       requiredInches: FREEMO_ENDPLATE_WIDTH_MIN_INCHES
     });
   }
-  const off = endplateTrackOffsetInches(input.trackOffsetInches, input.config ?? void 0);
-  const centres = input.config === "double" ? [off, off + FREEMO_TRACK_SPACING_INCHES] : [off];
+  const off = endplateTrackOffsetInches(
+    input.trackOffsetInches,
+    input.config ?? void 0,
+    input.main2Below
+  );
+  const second = off + (input.main2Below ? -1 : 1) * FREEMO_TRACK_SPACING_INCHES;
+  const centres = input.config === "double" ? [off, second] : [off];
   const worst = Math.max(...centres.map((c) => Math.abs(c)));
   const clearance = width / 2 - worst;
   if (clearance < FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES) {
@@ -524,6 +539,18 @@ function checkEndplateWidth(input) {
       requiredInches: required
     });
   }
+  if (input.config === "double") {
+    const mid = (off + second) / 2;
+    if (Math.abs(mid) > 0.01) {
+      issues.push({
+        code: "offcentre",
+        message: `The two tracks sit ${round2(Math.abs(mid))}\u2033 off the centre of this endplate. The standard recommends they straddle it \u2014 Main 1 at ${round2((input.main2Below ? 1 : -1) * (FREEMO_TRACK_SPACING_INCHES / 2))}\u2033. Clear the offset to use that.`,
+        // Not a width problem — no wider plate fixes it — so hand back the
+        // width unchanged rather than imply one would.
+        requiredInches: width
+      });
+    }
+  }
   return issues;
 }
 var round2 = (n) => Math.round(n * 100) / 100;
@@ -2146,6 +2173,6 @@ function poseOverridesFromDoc(doc) {
   return out;
 }
 
-export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, CODE55_RAIL_HEIGHT_INCHES, ENDPLATE_FASCIA_CLEAR_INCHES, ENDPLATE_LEAD_INCHES, 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, RAIL_GAUGE_INCHES, TIE_HALF_LENGTH_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, WHOLE_MODULE_SECTION_ID, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateLead, endplateTrackOffsetFor, endplateTrackOffsetInches, endplateWidthInches, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, hasNoFarEndplate, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, leadInchesForSize, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partOutlineAtFrog, pastFrogInchesForSize, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutPartForSize };
+export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, CODE55_RAIL_HEIGHT_INCHES, ENDPLATE_FASCIA_CLEAR_INCHES, ENDPLATE_LEAD_INCHES, 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, RAIL_GAUGE_INCHES, TIE_HALF_LENGTH_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, WHOLE_MODULE_SECTION_ID, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateCentreOffsetInches, endplateFaceSegments, endplateLead, endplateTrackOffsetInches, endplateWidthInches, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, hasNoFarEndplate, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, leadInchesForSize, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partOutlineAtFrog, pastFrogInchesForSize, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutPartForSize };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map