@willcgage/module-schematic 0.27.0 → 0.28.0

package/dist/index.d.cts

@@ -48,6 +48,15 @@ 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;
@@ -337,7 +346,14 @@ declare function moduleFootprint(input: ModuleFootprintInput): ModuleFootprint;
  * side of the plate centre (§2.0 RP), and Main 1 sits on the centre-line, so the
  * plate centre is half a track spacing up. A single track crosses at the centre.
  */
-declare function endplateTrackOffsetFor(config: TrackConfig | "none" | undefined): number;
+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. */
@@ -505,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). */
@@ -796,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, type EndplateWidthIssue, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type GeometryType, type IndustryLabelMode, type IndustrySpot, MAIN2_TRACK_ID, MAIN_TRACK_ID, type ModuleFeatures, type ModuleFootprint, type ModuleFootprintInput, type ModuleGeometryInput, type ModuleSchematicDoc, type ModuleTrackRow, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, type OutlineFace, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicIndustry, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SignalFacing, type SignalSide, type TrackConfig, type TrackRole, type TurnoutKind, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateTrackOffsetFor, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleCenterline, moduleFeatures, moduleFootprint, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, samplePath, scaleFeetToInches, stateToDoc, trackPath };
+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,6 +48,15 @@ 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;
@@ -337,7 +346,14 @@ declare function moduleFootprint(input: ModuleFootprintInput): ModuleFootprint;
  * side of the plate centre (§2.0 RP), and Main 1 sits on the centre-line, so the
  * plate centre is half a track spacing up. A single track crosses at the centre.
  */
-declare function endplateTrackOffsetFor(config: TrackConfig | "none" | undefined): number;
+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. */
@@ -505,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). */
@@ -796,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, type EndplateWidthIssue, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type GeometryType, type IndustryLabelMode, type IndustrySpot, MAIN2_TRACK_ID, MAIN_TRACK_ID, type ModuleFeatures, type ModuleFootprint, type ModuleFootprintInput, type ModuleGeometryInput, type ModuleSchematicDoc, type ModuleTrackRow, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, type OutlineFace, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicIndustry, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SignalFacing, type SignalSide, type TrackConfig, type TrackRole, type TurnoutKind, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateTrackOffsetFor, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleCenterline, moduleFeatures, moduleFootprint, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, samplePath, scaleFeetToInches, stateToDoc, trackPath };
+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

@@ -184,8 +184,13 @@ function moduleFootprint(input) {
     outline: authored ? sampleBenchworkOutline(authored) : null
   };
 }
-function endplateTrackOffsetFor(config) {
-  return config === "double" ? FREEMO_TRACK_SPACING_INCHES / 2 : 0;
+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);
@@ -254,6 +259,7 @@ function emptyEditorState(lengthInches) {
     branches: [],
     poseOverrides: {},
     endplateWidths: {},
+    endplateTrackOffsets: {},
     outline: [],
     sectionBreaks: [],
     controlPoints: [],
@@ -336,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) {
@@ -388,7 +398,8 @@ function stateToDoc(state, recordNumber) {
         ],
         state.poseOverrides
       ),
-      state.endplateWidths
+      state.endplateWidths,
+      state.endplateTrackOffsets
     ),
     tracks: [
       state.loop ? (
@@ -547,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,
@@ -573,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,
@@ -1076,6 +1091,6 @@ function poseOverridesFromDoc(doc) {
   return out;
 }
 
-export { FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, MAIN2_TRACK_ID, MAIN_TRACK_ID, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateTrackOffsetFor, endplateWidthInches, geometryTurnDegrees, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, moduleCenterline, moduleFeatures, moduleFootprint, nextId, poseNeedsManual, poseOverridesFromDoc, sampleBenchworkOutline, samplePath, scaleFeetToInches, stateToDoc, trackPath };
+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