@willcgage/module-schematic 0.82.0 → 0.83.0

package/dist/index.d.cts

@@ -92,6 +92,64 @@ 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;
+/**
+ * A stretch where a pair of parallel tracks runs at something other than the
+ * standard spacing, because a rigid assembly built to another spacing sits in
+ * it (#180).
+ *
+ * The case this exists for: a crossover fixture is machined for ONE track
+ * spacing and cannot be built to another. The Fast Tracks N crossovers are
+ * 1.09″ where Free-moN §2.0 requires 1.125″, so a module with one genuinely has
+ * its two mains 0.035″ closer together across the crossover, opening back to
+ * 1.125″ at the endplates — which the standard fixes. That pinch is real, and
+ * drawing it is more honest than drawing a straight pair.
+ */
+interface LanePinch {
+    /** The lane pulled in. Lane 0 is the reference and never moves. */
+    lane: number;
+    /** Inches from endplate A where the rigid section begins and ends. */
+    fromPos: number;
+    toPos: number;
+    /** Centre-to-centre spacing INSIDE that span, inches. */
+    spacingInches: number;
+}
+/**
+ * How far either side of a rigid section the pair takes to reach it.
+ *
+ * ⚠️ A DRAWING CONVENTION, NOT A MEASUREMENT. Nobody publishes this and it is
+ * not a property of any part — in the real world the builder eases the flex over
+ * whatever room they have. It exists so the pinch renders as a smooth deviation
+ * rather than a kink, and it is deliberately a round number so it never reads as
+ * something that was measured.
+ */
+declare const PINCH_EASE_INCHES = 3;
+/**
+ * The lane offset at a point, honouring any {@link LanePinch} covering it.
+ *
+ * Eases with a smoothstep, whose slope is zero at both ends, so the deviation
+ * leaves and rejoins the straight run tangentially — the way bent flex actually
+ * behaves. A linear ramp would put a visible corner at each end.
+ *
+ * ⚠️ ONLY THE PINCH'S OWN LANE MOVES. The main is the reference every Free-moN
+ * measurement is taken from, so it stays put and the parallel track deviates,
+ * which is also what a builder does.
+ */
+declare function laneOffsetAt(lane: number, pos: number, pinches?: LanePinch[] | null, spacingInches?: number): number;
+/**
+ * The pinches a document's crossovers impose — one per crossover connector that
+ * names a part whose {@link TrackPart.trackSpacing} differs from the standard.
+ *
+ * A crossover with no part named, or one built to the standard spacing, imposes
+ * nothing: an owner who hasn't said what they built gets the straight pair they
+ * had before, which is the only honest default.
+ */
+declare function crossoverPinches(tracks: Array<{
+    role?: string;
+    lane?: number;
+    fromPos?: number | null;
+    toPos?: number | null;
+    crossoverPartId?: string | null;
+}>, library?: TrackPart[], spacingInches?: number): LanePinch[];
 /**
  * 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
@@ -131,6 +189,16 @@ interface SchematicTrack {
      * product's maximum piece length. Present = these are the ONLY joints, so an
      * owner's deliberate cut survives a change elsewhere on the module. */
     flexCuts?: number[] | null;
+    /** `role: "crossover"` only — the crossover product this connector was built
+     * from, a slug from the parts library.
+     *
+     * It sits on the CONNECTOR rather than on the turnouts at its ends because a
+     * crossover is one assembly: the fixture that set its angle also set its
+     * {@link TrackPart.trackSpacing}, and that spacing belongs to the pair of
+     * tracks, not to either turnout. Naming it is what lets the physical view draw
+     * the crossover at the spacing it was actually built to — the Fast Tracks N
+     * fixtures are 1.09″ against Free-moN's 1.125″, and the difference is real. */
+    crossoverPartId?: string | null;
     /** The owner's MEASURED usable length, real inches (#20) — for what the
      * drawing can't know: a bumper post short of the drawn end, a structure
      * fouling the track. Absent = derive it from the clearance points (#19). */
@@ -981,6 +1049,10 @@ interface EditorTrack {
     path?: BenchworkPoint[];
     /** Measured usable length, real inches (#20). Absent = derived (#19). */
     measuredUsableInches?: number;
+    /** `role: "crossover"` only — the crossover product this connector was built
+     * from. Drives the spacing the pair is DRAWN at (see
+     * {@link SchematicTrack.crossoverPartId}). */
+    crossoverPartId?: string;
 }
 /** A module_tracks row as loaded for the editor. */
 interface ModuleTrackRow {
@@ -2426,4 +2498,4 @@ declare function poseOverridesFromDoc(doc: ModuleSchematicDoc): Record<string, {
     heading: number;
 }>;
 
-export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, type BenchworkPoint, type BranchConnector, CLEARANCE_SPACING_INCHES, CODE55_RAIL_HEIGHT_INCHES, DEFAULT_FLEX_PART_ID, 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, FAST_TRACKS_N_ME55, FAST_TRACKS_N_ME55_CROSSOVERS, FLEX_TRACK_PARTS, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type FlexPiece, type FlexPieceEnd, 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 OccupiedSpan, 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 SectionEnd, type SectionEndAssessment, type SectionFootprint, type SectionJointAssessment, type SectionRelativePos, type SignalFacing, type SignalSide, type SpanOverhang, type StoredTrackPart, TIE_HALF_LENGTH_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, type TrackConfig, type TrackPart, type TrackRole, type TurnoutClosure, type TurnoutKind, type UsableCapacity, WHOLE_MODULE_SECTION_ID, asModuleSchematic, assessSectionEnd, assessSectionJoint, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, clearancePointPastFrogInches, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateCentreOffsetInches, endplateFaceSegments, endplateLead, endplateTrackOffsetInches, endplateWidthInches, flexPartFor, flexParts, flexPieces, flexUsage, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, hasNoFarEndplate, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, leadInchesForSize, maxFlexPieceInches, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partOutlineAtFrog, pastFrogInchesForSize, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, resizeFlexPiece, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, spanOverhang, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutFacing, turnoutOccupiedSpan, turnoutPartForSize, usableCapacity };
+export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, type BenchworkPoint, type BranchConnector, CLEARANCE_SPACING_INCHES, CODE55_RAIL_HEIGHT_INCHES, DEFAULT_FLEX_PART_ID, 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, FAST_TRACKS_N_ME55, FAST_TRACKS_N_ME55_CROSSOVERS, FLEX_TRACK_PARTS, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type FlexPiece, type FlexPieceEnd, type FrogCasting, type GeometryType, type ImportedPart, type IndustryLabelMode, type IndustrySpot, type LanePinch, 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 OccupiedSpan, type OutlineFace, PINCH_EASE_INCHES, 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 SectionEnd, type SectionEndAssessment, type SectionFootprint, type SectionJointAssessment, type SectionRelativePos, type SignalFacing, type SignalSide, type SpanOverhang, type StoredTrackPart, TIE_HALF_LENGTH_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, type TrackConfig, type TrackPart, type TrackRole, type TurnoutClosure, type TurnoutKind, type UsableCapacity, WHOLE_MODULE_SECTION_ID, asModuleSchematic, assessSectionEnd, assessSectionJoint, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, clearancePointPastFrogInches, crossoverPinches, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateCentreOffsetInches, endplateFaceSegments, endplateLead, endplateTrackOffsetInches, endplateWidthInches, flexPartFor, flexParts, flexPieces, flexUsage, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, hasNoFarEndplate, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, laneOffsetAt, leadInchesForSize, maxFlexPieceInches, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partOutlineAtFrog, pastFrogInchesForSize, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, resizeFlexPiece, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, spanOverhang, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutFacing, turnoutOccupiedSpan, turnoutPartForSize, usableCapacity };

package/dist/index.d.ts

@@ -92,6 +92,64 @@ 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;
+/**
+ * A stretch where a pair of parallel tracks runs at something other than the
+ * standard spacing, because a rigid assembly built to another spacing sits in
+ * it (#180).
+ *
+ * The case this exists for: a crossover fixture is machined for ONE track
+ * spacing and cannot be built to another. The Fast Tracks N crossovers are
+ * 1.09″ where Free-moN §2.0 requires 1.125″, so a module with one genuinely has
+ * its two mains 0.035″ closer together across the crossover, opening back to
+ * 1.125″ at the endplates — which the standard fixes. That pinch is real, and
+ * drawing it is more honest than drawing a straight pair.
+ */
+interface LanePinch {
+    /** The lane pulled in. Lane 0 is the reference and never moves. */
+    lane: number;
+    /** Inches from endplate A where the rigid section begins and ends. */
+    fromPos: number;
+    toPos: number;
+    /** Centre-to-centre spacing INSIDE that span, inches. */
+    spacingInches: number;
+}
+/**
+ * How far either side of a rigid section the pair takes to reach it.
+ *
+ * ⚠️ A DRAWING CONVENTION, NOT A MEASUREMENT. Nobody publishes this and it is
+ * not a property of any part — in the real world the builder eases the flex over
+ * whatever room they have. It exists so the pinch renders as a smooth deviation
+ * rather than a kink, and it is deliberately a round number so it never reads as
+ * something that was measured.
+ */
+declare const PINCH_EASE_INCHES = 3;
+/**
+ * The lane offset at a point, honouring any {@link LanePinch} covering it.
+ *
+ * Eases with a smoothstep, whose slope is zero at both ends, so the deviation
+ * leaves and rejoins the straight run tangentially — the way bent flex actually
+ * behaves. A linear ramp would put a visible corner at each end.
+ *
+ * ⚠️ ONLY THE PINCH'S OWN LANE MOVES. The main is the reference every Free-moN
+ * measurement is taken from, so it stays put and the parallel track deviates,
+ * which is also what a builder does.
+ */
+declare function laneOffsetAt(lane: number, pos: number, pinches?: LanePinch[] | null, spacingInches?: number): number;
+/**
+ * The pinches a document's crossovers impose — one per crossover connector that
+ * names a part whose {@link TrackPart.trackSpacing} differs from the standard.
+ *
+ * A crossover with no part named, or one built to the standard spacing, imposes
+ * nothing: an owner who hasn't said what they built gets the straight pair they
+ * had before, which is the only honest default.
+ */
+declare function crossoverPinches(tracks: Array<{
+    role?: string;
+    lane?: number;
+    fromPos?: number | null;
+    toPos?: number | null;
+    crossoverPartId?: string | null;
+}>, library?: TrackPart[], spacingInches?: number): LanePinch[];
 /**
  * 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
@@ -131,6 +189,16 @@ interface SchematicTrack {
      * product's maximum piece length. Present = these are the ONLY joints, so an
      * owner's deliberate cut survives a change elsewhere on the module. */
     flexCuts?: number[] | null;
+    /** `role: "crossover"` only — the crossover product this connector was built
+     * from, a slug from the parts library.
+     *
+     * It sits on the CONNECTOR rather than on the turnouts at its ends because a
+     * crossover is one assembly: the fixture that set its angle also set its
+     * {@link TrackPart.trackSpacing}, and that spacing belongs to the pair of
+     * tracks, not to either turnout. Naming it is what lets the physical view draw
+     * the crossover at the spacing it was actually built to — the Fast Tracks N
+     * fixtures are 1.09″ against Free-moN's 1.125″, and the difference is real. */
+    crossoverPartId?: string | null;
     /** The owner's MEASURED usable length, real inches (#20) — for what the
      * drawing can't know: a bumper post short of the drawn end, a structure
      * fouling the track. Absent = derive it from the clearance points (#19). */
@@ -981,6 +1049,10 @@ interface EditorTrack {
     path?: BenchworkPoint[];
     /** Measured usable length, real inches (#20). Absent = derived (#19). */
     measuredUsableInches?: number;
+    /** `role: "crossover"` only — the crossover product this connector was built
+     * from. Drives the spacing the pair is DRAWN at (see
+     * {@link SchematicTrack.crossoverPartId}). */
+    crossoverPartId?: string;
 }
 /** A module_tracks row as loaded for the editor. */
 interface ModuleTrackRow {
@@ -2426,4 +2498,4 @@ declare function poseOverridesFromDoc(doc: ModuleSchematicDoc): Record<string, {
     heading: number;
 }>;
 
-export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, type BenchworkPoint, type BranchConnector, CLEARANCE_SPACING_INCHES, CODE55_RAIL_HEIGHT_INCHES, DEFAULT_FLEX_PART_ID, 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, FAST_TRACKS_N_ME55, FAST_TRACKS_N_ME55_CROSSOVERS, FLEX_TRACK_PARTS, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type FlexPiece, type FlexPieceEnd, 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 OccupiedSpan, 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 SectionEnd, type SectionEndAssessment, type SectionFootprint, type SectionJointAssessment, type SectionRelativePos, type SignalFacing, type SignalSide, type SpanOverhang, type StoredTrackPart, TIE_HALF_LENGTH_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, type TrackConfig, type TrackPart, type TrackRole, type TurnoutClosure, type TurnoutKind, type UsableCapacity, WHOLE_MODULE_SECTION_ID, asModuleSchematic, assessSectionEnd, assessSectionJoint, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, clearancePointPastFrogInches, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateCentreOffsetInches, endplateFaceSegments, endplateLead, endplateTrackOffsetInches, endplateWidthInches, flexPartFor, flexParts, flexPieces, flexUsage, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, hasNoFarEndplate, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, leadInchesForSize, maxFlexPieceInches, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partOutlineAtFrog, pastFrogInchesForSize, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, resizeFlexPiece, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, spanOverhang, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutFacing, turnoutOccupiedSpan, turnoutPartForSize, usableCapacity };
+export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, type BenchworkPoint, type BranchConnector, CLEARANCE_SPACING_INCHES, CODE55_RAIL_HEIGHT_INCHES, DEFAULT_FLEX_PART_ID, 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, FAST_TRACKS_N_ME55, FAST_TRACKS_N_ME55_CROSSOVERS, FLEX_TRACK_PARTS, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type FlexPiece, type FlexPieceEnd, type FrogCasting, type GeometryType, type ImportedPart, type IndustryLabelMode, type IndustrySpot, type LanePinch, 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 OccupiedSpan, type OutlineFace, PINCH_EASE_INCHES, 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 SectionEnd, type SectionEndAssessment, type SectionFootprint, type SectionJointAssessment, type SectionRelativePos, type SignalFacing, type SignalSide, type SpanOverhang, type StoredTrackPart, TIE_HALF_LENGTH_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, type TrackConfig, type TrackPart, type TrackRole, type TurnoutClosure, type TurnoutKind, type UsableCapacity, WHOLE_MODULE_SECTION_ID, asModuleSchematic, assessSectionEnd, assessSectionJoint, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, clearancePointPastFrogInches, crossoverPinches, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateCentreOffsetInches, endplateFaceSegments, endplateLead, endplateTrackOffsetInches, endplateWidthInches, flexPartFor, flexParts, flexPieces, flexUsage, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, hasNoFarEndplate, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, laneOffsetAt, leadInchesForSize, maxFlexPieceInches, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partOutlineAtFrog, pastFrogInchesForSize, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, resizeFlexPiece, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, spanOverhang, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutFacing, turnoutOccupiedSpan, turnoutPartForSize, usableCapacity };

package/dist/index.js

@@ -3,6 +3,46 @@ 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;
+var PINCH_EASE_INCHES = 3;
+function laneOffsetAt(lane, pos, pinches, spacingInches = FREEMO_TRACK_SPACING_INCHES) {
+  const base = (lane ?? 0) * spacingInches;
+  if (!lane || !pinches?.length) return base;
+  const sign = Math.sign(lane);
+  const smooth = (t) => t * t * (3 - 2 * t);
+  let off = base;
+  for (const p of pinches) {
+    if (p.lane !== lane) continue;
+    const a = Math.min(p.fromPos, p.toPos);
+    const b = Math.max(p.fromPos, p.toPos);
+    const target = base - sign * (spacingInches * Math.abs(lane) - p.spacingInches);
+    const e = PINCH_EASE_INCHES;
+    let t = null;
+    if (pos >= a && pos <= b) t = 1;
+    else if (pos > a - e && pos < a) t = smooth((pos - (a - e)) / e);
+    else if (pos > b && pos < b + e) t = smooth(1 - (pos - b) / e);
+    if (t == null) continue;
+    const candidate = base + (target - base) * t;
+    if (Math.abs(candidate - base) > Math.abs(off - base)) off = candidate;
+  }
+  return off;
+}
+function crossoverPinches(tracks, library = BUILT_IN_TRACK_PARTS, spacingInches = FREEMO_TRACK_SPACING_INCHES) {
+  const out = [];
+  for (const t of tracks) {
+    if (t.role !== "crossover" || !t.crossoverPartId) continue;
+    const part = library.find((p) => p.id === t.crossoverPartId);
+    const s = part?.trackSpacing?.inches;
+    if (typeof s !== "number" || !Number.isFinite(s) || s <= 0) continue;
+    if (Math.abs(s - spacingInches) < 1e-9) continue;
+    const lane = t.lane ?? 1;
+    if (!lane) continue;
+    const a = t.fromPos ?? 0;
+    const b = t.toPos ?? 0;
+    if (!Number.isFinite(a) || !Number.isFinite(b) || Math.abs(b - a) < 1e-9) continue;
+    out.push({ lane, fromPos: Math.min(a, b), toPos: Math.max(a, b), spacingInches: s });
+  }
+  return out;
+}
 function endplateWidthInches(ep) {
   const w = ep?.widthInches;
   return typeof w === "number" && w > 0 ? w : FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES;
@@ -941,6 +981,7 @@ function stateToDoc(state, recordNumber) {
         }).scaleFeet,
         ...typeof t.measuredUsableInches === "number" && t.measuredUsableInches >= 0 ? { measuredUsableInches: t.measuredUsableInches } : {},
         ...state.loop && t.inLoop ? { inLoop: true } : {},
+        ...t.crossoverPartId ? { crossoverPartId: t.crossoverPartId } : {},
         ...t.path && t.path.length >= 2 ? { path: t.path } : {}
       }))
     ]),
@@ -1037,6 +1078,9 @@ function docToState(doc, fallbackLength, moduleTracks = []) {
         moduleTrackId,
         trackName: t.trackName ?? nameOf(moduleTrackId),
         ...t.inLoop ? { inLoop: true } : {},
+        // The crossover product this connector was built from — what makes the
+        // physical view draw the pair at the spacing it was really built to.
+        ...typeof t.crossoverPartId === "string" && t.crossoverPartId ? { crossoverPartId: t.crossoverPartId } : {},
         // Authored path kept as-drawn (a physical shape, not rescaled with length).
         ...trackPath(t.path) ? { path: trackPath(t.path) } : {},
         // A MEASURED length is a real-world fact about the physical track, so it
@@ -2652,6 +2696,6 @@ function poseOverridesFromDoc(doc) {
   return out;
 }
 
-export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, CLEARANCE_SPACING_INCHES, CODE55_RAIL_HEIGHT_INCHES, DEFAULT_FLEX_PART_ID, ENDPLATE_FASCIA_CLEAR_INCHES, ENDPLATE_LEAD_INCHES, FAST_TRACKS_N_ME55, FAST_TRACKS_N_ME55_CROSSOVERS, FLEX_TRACK_PARTS, 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, assessSectionEnd, assessSectionJoint, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, clearancePointPastFrogInches, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateCentreOffsetInches, endplateFaceSegments, endplateLead, endplateTrackOffsetInches, endplateWidthInches, flexPartFor, flexParts, flexPieces, flexUsage, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, hasNoFarEndplate, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, leadInchesForSize, maxFlexPieceInches, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partOutlineAtFrog, pastFrogInchesForSize, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, resizeFlexPiece, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, spanOverhang, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutFacing, turnoutOccupiedSpan, turnoutPartForSize, usableCapacity };
+export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, CLEARANCE_SPACING_INCHES, CODE55_RAIL_HEIGHT_INCHES, DEFAULT_FLEX_PART_ID, ENDPLATE_FASCIA_CLEAR_INCHES, ENDPLATE_LEAD_INCHES, FAST_TRACKS_N_ME55, FAST_TRACKS_N_ME55_CROSSOVERS, FLEX_TRACK_PARTS, 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, PINCH_EASE_INCHES, RAIL_GAUGE_INCHES, TIE_HALF_LENGTH_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, WHOLE_MODULE_SECTION_ID, asModuleSchematic, assessSectionEnd, assessSectionJoint, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, clearancePointPastFrogInches, crossoverPinches, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateCentreOffsetInches, endplateFaceSegments, endplateLead, endplateTrackOffsetInches, endplateWidthInches, flexPartFor, flexParts, flexPieces, flexUsage, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, hasNoFarEndplate, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, laneOffsetAt, leadInchesForSize, maxFlexPieceInches, mergeImportedParts, mergeStoredParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partExtent, partExtentForSize, partOutlineAtFrog, pastFrogInchesForSize, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, resizeFlexPiece, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, spanOverhang, stateToDoc, storedPartToTrackPart, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutFacing, turnoutOccupiedSpan, turnoutPartForSize, usableCapacity };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map