@willcgage/module-schematic 0.26.0 → 0.28.0

package/dist/index.d.cts

@@ -48,10 +48,29 @@ interface SchematicEndplate {
      * recommended. Absent = the recommended default (modules may differ end to
      * end, e.g. a transition). */
     widthInches?: number | null;
+    /** Where this end's PRIMARY track (Main 1) crosses, as a signed distance from
+     * the plate's CENTRE in inches — the standard's own framing ("each track
+     * 0.5625 inches from the center of the endplate"). §2.0 requires only that
+     * every track stay ≥4″ from either fascia; centring is a recommendation the
+     * 20220628 revision relaxed, so an offset is legal — a transition SECTION
+     * commonly offsets its single-track end so the through main lines up with one
+     * of the two tracks at its double end. Absent = the recommended default
+     * (single centred; double straddling at ∓ half the track spacing). */
+    trackOffsetInches?: number | null;
 }
 /** 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
@@ -277,6 +296,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).
@@ -305,15 +331,56 @@ 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, authoredTrackOffset?: number | null): 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;
+/** 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";
@@ -454,6 +521,9 @@ interface EditorState {
     /** Authored endplate face widths by endplate id, inches (Free-moN 12″ min,
      * 24″ recommended). Absent id = the recommended default. */
     endplateWidths: Record<string, number>;
+    /** Authored per-endplate TRACK offsets by id — the primary track's signed
+     * distance from the plate centre, inches. Absent id = the §2.0 default. */
+    endplateTrackOffsets: Record<string, number>;
     /** Benchwork footprint outline — polygon vertices in module-local inches
      * (endplate A's track point at the origin, mainline +x, perpendicular +y up).
      * Empty = no authored outline (fall back to the endplate-width band). */
@@ -745,4 +815,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, endplateTrackOffsetInches, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleCenterline, moduleFeatures, moduleFootprint, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, samplePath, scaleFeetToInches, stateToDoc, trackPath };

package/dist/index.d.ts

@@ -48,10 +48,29 @@ interface SchematicEndplate {
      * recommended. Absent = the recommended default (modules may differ end to
      * end, e.g. a transition). */
     widthInches?: number | null;
+    /** Where this end's PRIMARY track (Main 1) crosses, as a signed distance from
+     * the plate's CENTRE in inches — the standard's own framing ("each track
+     * 0.5625 inches from the center of the endplate"). §2.0 requires only that
+     * every track stay ≥4″ from either fascia; centring is a recommendation the
+     * 20220628 revision relaxed, so an offset is legal — a transition SECTION
+     * commonly offsets its single-track end so the through main lines up with one
+     * of the two tracks at its double end. Absent = the recommended default
+     * (single centred; double straddling at ∓ half the track spacing). */
+    trackOffsetInches?: number | null;
 }
 /** 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
@@ -277,6 +296,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).
@@ -305,15 +331,56 @@ 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, authoredTrackOffset?: number | null): 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;
+/** 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";
@@ -454,6 +521,9 @@ interface EditorState {
     /** Authored endplate face widths by endplate id, inches (Free-moN 12″ min,
      * 24″ recommended). Absent id = the recommended default. */
     endplateWidths: Record<string, number>;
+    /** Authored per-endplate TRACK offsets by id — the primary track's signed
+     * distance from the plate centre, inches. Absent id = the §2.0 default. */
+    endplateTrackOffsets: Record<string, number>;
     /** Benchwork footprint outline — polygon vertices in module-local inches
      * (endplate A's track point at the origin, mainline +x, perpendicular +y up).
      * Empty = no authored outline (fall back to the endplate-width band). */
@@ -745,4 +815,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, endplateTrackOffsetInches, 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,79 @@ 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, authoredTrackOffset) {
+  const v = -endplateTrackOffsetInches(authoredTrackOffset, config);
+  return v === 0 ? 0 : v;
+}
+function endplateTrackOffsetInches(authored, config) {
+  if (typeof authored === "number" && Number.isFinite(authored)) return authored;
+  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;
@@ -215,6 +259,7 @@ function emptyEditorState(lengthInches) {
     branches: [],
     poseOverrides: {},
     endplateWidths: {},
+    endplateTrackOffsets: {},
     outline: [],
     sectionBreaks: [],
     controlPoints: [],
@@ -297,10 +342,14 @@ function withPoses(endplates, overrides) {
     (e) => overrides[e.id] ? { ...e, pose: overrides[e.id] } : e
   );
 }
-function withWidths(endplates, widths) {
+function withWidths(endplates, widths, offsets = {}) {
   return endplates.map((e) => {
     const w = widths[e.id];
-    return typeof w === "number" && w > 0 ? { ...e, widthInches: w } : e;
+    const o = offsets[e.id];
+    let out = e;
+    if (typeof w === "number" && w > 0) out = { ...out, widthInches: w };
+    if (typeof o === "number" && Number.isFinite(o)) out = { ...out, trackOffsetInches: o };
+    return out;
   });
 }
 function stateToDoc(state, recordNumber) {
@@ -349,7 +398,8 @@ function stateToDoc(state, recordNumber) {
         ],
         state.poseOverrides
       ),
-      state.endplateWidths
+      state.endplateWidths,
+      state.endplateTrackOffsets
     ),
     tracks: [
       state.loop ? (
@@ -508,9 +558,12 @@ function docToState(doc, fallbackLength, moduleTracks = []) {
   );
   const poseOverrides = poseOverridesFromDoc(d);
   const endplateWidths = {};
+  const endplateTrackOffsets = {};
   for (const e of d.endplates ?? []) {
     if (typeof e.widthInches === "number" && e.widthInches > 0)
       endplateWidths[e.id] = e.widthInches;
+    if (typeof e.trackOffsetInches === "number" && Number.isFinite(e.trackOffsetInches))
+      endplateTrackOffsets[e.id] = e.trackOffsetInches;
   }
   const outline = (d.outline ?? []).filter((p) => p && Number.isFinite(p.x) && Number.isFinite(p.y)).map((p) => ({
     x: p.x,
@@ -534,6 +587,7 @@ function docToState(doc, fallbackLength, moduleTracks = []) {
     })),
     poseOverrides,
     endplateWidths,
+    endplateTrackOffsets,
     outline,
     sectionBreaks: (d.sectionBreaks ?? []).filter((n) => Number.isFinite(n)).map((n) => sc(n)),
     mainPath,
@@ -1037,6 +1091,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, endplateTrackOffsetInches, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleCenterline, moduleFeatures, moduleFootprint, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, samplePath, scaleFeetToInches, stateToDoc, trackPath };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map