@willcgage/module-schematic 0.69.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
@@ -447,6 +455,10 @@ interface ModuleFootprintInput {
     /** A balloon / return loop — the centre-line turns back on itself, so its far
      * end is the THROAT, not an endplate; only endplate A's face is emitted (#loop). */
     loop?: boolean;
+    /** Axial endplate configs (A first, then B), same as
+     * {@link ModuleGeometryInput.endplateConfigs}. `"none"` at B means the module
+     * presents no far endplate, so no face is emitted there (#184/#191). */
+    endplateConfigs?: ("single" | "double" | "none" | null | undefined)[];
 }
 interface OutlineFace {
     /** The endplate face's two corners + midpoint (the track point). */
@@ -633,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. */
@@ -672,7 +706,32 @@ 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.
+ *
+ * ⭐ THE single definition. Three places had grown their own answer to this and
+ * drifted: `deriveEndplatePoses` (which knew about `dead_end` and `"none"`), the
+ * operations preview's end label, and `moduleFootprint`'s endplate faces — the
+ * last two using "is it a loop?" as a stand-in for "has it got two ends?", which
+ * was true until #184 and silently wrong after. Anything asking this must call
+ * THIS.
+ *
+ * Three ways to have one end, and they are genuinely different things: the
+ * geometry is a dead end; it's a balloon loop, whose far end is the throat and
+ * not a plate at all; or the owner said this end has no plate, which is how an
+ * *end of the line* or a *pocket* is authored — ordinary straight boards that
+ * simply stop, so no geometry type would ever say it for them.
+ */
+declare function hasNoFarEndplate(input: {
+    geometryType?: string | null;
+    loop?: boolean;
+    endplateConfigs?: ("single" | "double" | "none" | null | undefined)[];
+}): boolean;
 /**
  * Whether a doc is a balloon loop — **the authored flag, and only that**.
  *
@@ -1785,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, 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
@@ -447,6 +455,10 @@ interface ModuleFootprintInput {
     /** A balloon / return loop — the centre-line turns back on itself, so its far
      * end is the THROAT, not an endplate; only endplate A's face is emitted (#loop). */
     loop?: boolean;
+    /** Axial endplate configs (A first, then B), same as
+     * {@link ModuleGeometryInput.endplateConfigs}. `"none"` at B means the module
+     * presents no far endplate, so no face is emitted there (#184/#191). */
+    endplateConfigs?: ("single" | "double" | "none" | null | undefined)[];
 }
 interface OutlineFace {
     /** The endplate face's two corners + midpoint (the track point). */
@@ -633,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. */
@@ -672,7 +706,32 @@ 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.
+ *
+ * ⭐ THE single definition. Three places had grown their own answer to this and
+ * drifted: `deriveEndplatePoses` (which knew about `dead_end` and `"none"`), the
+ * operations preview's end label, and `moduleFootprint`'s endplate faces — the
+ * last two using "is it a loop?" as a stand-in for "has it got two ends?", which
+ * was true until #184 and silently wrong after. Anything asking this must call
+ * THIS.
+ *
+ * Three ways to have one end, and they are genuinely different things: the
+ * geometry is a dead end; it's a balloon loop, whose far end is the throat and
+ * not a plate at all; or the owner said this end has no plate, which is how an
+ * *end of the line* or a *pocket* is authored — ordinary straight boards that
+ * simply stop, so no geometry type would ever say it for them.
+ */
+declare function hasNoFarEndplate(input: {
+    geometryType?: string | null;
+    loop?: boolean;
+    endplateConfigs?: ("single" | "double" | "none" | null | undefined)[];
+}): boolean;
 /**
  * Whether a doc is a balloon loop — **the authored flag, and only that**.
  *
@@ -1785,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, 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, {
@@ -483,9 +487,10 @@ function moduleFootprint(input) {
   return {
     centerline,
     band: benchworkBand(centerline, widthA, widthB, offA, offB),
-    // A loop's centre-line ends at the throat, not a far endplate — keep only
-    // endplate A's face (the far face would be a spurious plate at the throat).
-    endplateFaces: input.loop ? endplateFaceSegments(centerline, widthA, widthB, offA, offB).slice(0, 1) : endplateFaceSegments(centerline, widthA, widthB, offA, offB),
+    // Only emit a face where the module actually presents one. A loop's
+    // centre-line ends at the THROAT, and an end of the line / pocket simply
+    // stops — a far face there is a plate the module hasn't got (#191).
+    endplateFaces: hasNoFarEndplate(input) ? endplateFaceSegments(centerline, widthA, widthB, offA, offB).slice(0, 1) : endplateFaceSegments(centerline, widthA, widthB, offA, offB),
     outline: sectionOutlines.length || !authored ? null : sampleBenchworkOutline(authored),
     // The donut hole, arc-sampled — only when there's a solid outline to punch it
     // out of (a sectioned module isn't a donut). Renderers cut it from `outline`.
@@ -493,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);
@@ -511,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) {
@@ -523,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;
@@ -531,6 +559,9 @@ function endplateWidthFor(widths, id) {
   const w = widths?.[id];
   return typeof w === "number" && w > 0 ? w : FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES;
 }
+function hasNoFarEndplate(input) {
+  return input.geometryType === "dead_end" || input.loop === true || input.endplateConfigs?.[1] === "none";
+}
 function isLoopDoc(doc) {
   return doc.loop === true;
 }
@@ -1991,7 +2022,7 @@ function deriveEndplatePoses(geo) {
       trackOffsets: offsetsFor(cfg(0), half)
     })
   );
-  const noB = geo.geometryType === "dead_end" || geo.loop === true || geo.endplateConfigs?.[1] === "none";
+  const noB = hasNoFarEndplate(geo);
   const end = sectionedEndPose({ sections: geo.sections });
   if (!noB && end) {
     poses.push(
@@ -2142,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, 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