@willcgage/module-schematic 0.84.0 → 0.85.0

package/dist/index.d.cts

@@ -34,6 +34,14 @@ interface SchematicEndplate {
         pos: number;
         side: "up" | "down";
     };
+    /** ⭐ THE ENDPLATE'S EDGE OF THE BENCHWORK (ADR 0001). When present it WINS
+     * over `pose` and over derivation, and position, heading and width are all
+     * read off the polygon — so they cannot drift apart from the board.
+     *
+     * `pose` remains for modules authored before this and for shapes with no
+     * benchwork polygon to bind to. Nothing is auto-converted: guessing which
+     * edge an owner's freehand pose meant would be inventing an intent. */
+    edge?: EndplateEdge | null;
     /** Manual pose override (#175 phase 1b) — the endplate's module-local track
      * point (x, y inches) + outward-normal heading (°). Hand-entered for shapes
      * the geometry fields can't derive (wye, freeform, loop); wins over
@@ -1184,6 +1192,9 @@ interface EditorState {
     /** 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>;
+    /** Endplate EDGE bindings by id (ADR 0001) — an endplate that is part of the
+     * benchwork. Wins over a pose; nothing is auto-converted from one. */
+    endplateEdges?: Record<string, EndplateEdge>;
     /** 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). */
@@ -2414,6 +2425,62 @@ flipped?: boolean | null): -1 | 0 | 1;
  */
 declare function moduleFeatures(doc: ModuleSchematicDoc): ModuleFeatures;
 type GeometryType = "straight" | "corner_45" | "corner_90" | "curve" | "offset" | "dead_end" | "wye" | "other";
+/**
+ * An endplate bound to a BENCHWORK EDGE (ADR 0001).
+ *
+ * Will Gage, 2026-07-26: *"Endplates are a part of the benchwork. We have
+ * separated them causing some challenges."* A {@link SchematicEndplate.pose} is
+ * a point floating in module space, so it can disagree with the board — and has:
+ * a junction plate landed on the module CENTRE LINE rather than the fascia, a
+ * derived pose written back silently PINNED a plate so it went stale when the
+ * length changed (which is the only reason `poseAuthored` exists), and a face
+ * drawn flat across a tapered edge is flush only at its midpoint.
+ *
+ * Bind it to an edge and none of those are expressible. Position, heading and
+ * WIDTH all come from the edge, so they cannot drift apart.
+ */
+interface EndplateEdge {
+    /** The section whose outline owns this edge; absent = the module outline. */
+    section?: string | null;
+    /** Which edge: the segment from vertex `index` to vertex `index + 1`. */
+    index: number;
+    /** Optional span along that edge, 0…1. Absent = the whole edge — which is the
+     * common case, because a board's end IS the endplate. */
+    fromT?: number | null;
+    toT?: number | null;
+}
+/** What an {@link EndplateEdge} resolves to. Everything here is READ OFF the
+ * polygon; nothing is stored, so nothing can go stale. */
+interface EndplateEdgePose {
+    x: number;
+    y: number;
+    /** The edge's OUTWARD normal, degrees. */
+    heading: number;
+    /** The span's length — the face's real width, not a separate number that
+     * might disagree with the board. */
+    widthInches: number;
+    /** The face's two ends. On a tapered board this follows the slope, which a
+     * stored pose + width could never do. */
+    face: [{
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    }];
+}
+/**
+ * Resolve an endplate's edge binding against a benchwork polygon.
+ *
+ * ⚠️ REFUSES A CURVED EDGE. Free-moN §2.0 requires the track crossing an
+ * endplate to be perpendicular, straight and level for 4″ — so an endplate face
+ * is flat by the standard, and a bulged edge is not somewhere one can go. That
+ * is a rule, not a missing feature.
+ *
+ * Returns null when the edge doesn't exist or isn't usable, so a caller can say
+ * why rather than drawing something wrong.
+ */
+declare function endplateEdgePose(outline: BenchworkPoint[] | null | undefined, edge: EndplateEdge): EndplateEdgePose | null;
 interface EndplatePose {
     /** Endplate id — "A"/"B" axial, "C"/"D"… branch. */
     id: string;
@@ -2426,6 +2493,19 @@ interface EndplatePose {
     trackConfig: "single" | "double";
     /** Lateral track offsets from the crossing anchor (0 = centred single). */
     trackOffsets: number[];
+    /** Set when this pose came from an {@link EndplateEdge} — read off the
+     * benchwork rather than stored. Its width and face are the board's own. */
+    boundToEdge?: boolean;
+    /** The face's real width, when bound to an edge. */
+    widthInches?: number;
+    /** The face's two ends, when bound to an edge — follows a tapered board. */
+    face?: [{
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    }];
     /** True when the pose was hand-entered, not derived (wye/loop/other). */
     manual?: boolean;
 }
@@ -2476,6 +2556,12 @@ interface ModuleGeometryInput {
         side: "up" | "down";
         config?: "single" | "double" | null;
     }[];
+    /** ⭐ Endplate EDGE bindings by id (ADR 0001) — an endplate that is part of
+     * the benchwork rather than a point floating beside it. Wins over
+     * `poseOverrides` and over derivation. */
+    endplateEdges?: Record<string, EndplateEdge>;
+    /** The module's benchwork polygon, needed to resolve `endplateEdges`. */
+    outline?: BenchworkPoint[] | null;
     /** Hand-entered pose overrides by endplate id — win over derivation. */
     poseOverrides?: Record<string, {
         x: number;
@@ -2564,4 +2650,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, 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 PartGeometry, type PartJoint, type PartJointRole, 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, partGeometry, partGeometryGap, partOutlineAtFrog, partsPlaceable, 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 EndplateEdge, type EndplateEdgePose, 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 PartGeometry, type PartJoint, type PartJointRole, 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, endplateEdgePose, 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, partGeometry, partGeometryGap, partOutlineAtFrog, partsPlaceable, 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

@@ -34,6 +34,14 @@ interface SchematicEndplate {
         pos: number;
         side: "up" | "down";
     };
+    /** ⭐ THE ENDPLATE'S EDGE OF THE BENCHWORK (ADR 0001). When present it WINS
+     * over `pose` and over derivation, and position, heading and width are all
+     * read off the polygon — so they cannot drift apart from the board.
+     *
+     * `pose` remains for modules authored before this and for shapes with no
+     * benchwork polygon to bind to. Nothing is auto-converted: guessing which
+     * edge an owner's freehand pose meant would be inventing an intent. */
+    edge?: EndplateEdge | null;
     /** Manual pose override (#175 phase 1b) — the endplate's module-local track
      * point (x, y inches) + outward-normal heading (°). Hand-entered for shapes
      * the geometry fields can't derive (wye, freeform, loop); wins over
@@ -1184,6 +1192,9 @@ interface EditorState {
     /** 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>;
+    /** Endplate EDGE bindings by id (ADR 0001) — an endplate that is part of the
+     * benchwork. Wins over a pose; nothing is auto-converted from one. */
+    endplateEdges?: Record<string, EndplateEdge>;
     /** 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). */
@@ -2414,6 +2425,62 @@ flipped?: boolean | null): -1 | 0 | 1;
  */
 declare function moduleFeatures(doc: ModuleSchematicDoc): ModuleFeatures;
 type GeometryType = "straight" | "corner_45" | "corner_90" | "curve" | "offset" | "dead_end" | "wye" | "other";
+/**
+ * An endplate bound to a BENCHWORK EDGE (ADR 0001).
+ *
+ * Will Gage, 2026-07-26: *"Endplates are a part of the benchwork. We have
+ * separated them causing some challenges."* A {@link SchematicEndplate.pose} is
+ * a point floating in module space, so it can disagree with the board — and has:
+ * a junction plate landed on the module CENTRE LINE rather than the fascia, a
+ * derived pose written back silently PINNED a plate so it went stale when the
+ * length changed (which is the only reason `poseAuthored` exists), and a face
+ * drawn flat across a tapered edge is flush only at its midpoint.
+ *
+ * Bind it to an edge and none of those are expressible. Position, heading and
+ * WIDTH all come from the edge, so they cannot drift apart.
+ */
+interface EndplateEdge {
+    /** The section whose outline owns this edge; absent = the module outline. */
+    section?: string | null;
+    /** Which edge: the segment from vertex `index` to vertex `index + 1`. */
+    index: number;
+    /** Optional span along that edge, 0…1. Absent = the whole edge — which is the
+     * common case, because a board's end IS the endplate. */
+    fromT?: number | null;
+    toT?: number | null;
+}
+/** What an {@link EndplateEdge} resolves to. Everything here is READ OFF the
+ * polygon; nothing is stored, so nothing can go stale. */
+interface EndplateEdgePose {
+    x: number;
+    y: number;
+    /** The edge's OUTWARD normal, degrees. */
+    heading: number;
+    /** The span's length — the face's real width, not a separate number that
+     * might disagree with the board. */
+    widthInches: number;
+    /** The face's two ends. On a tapered board this follows the slope, which a
+     * stored pose + width could never do. */
+    face: [{
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    }];
+}
+/**
+ * Resolve an endplate's edge binding against a benchwork polygon.
+ *
+ * ⚠️ REFUSES A CURVED EDGE. Free-moN §2.0 requires the track crossing an
+ * endplate to be perpendicular, straight and level for 4″ — so an endplate face
+ * is flat by the standard, and a bulged edge is not somewhere one can go. That
+ * is a rule, not a missing feature.
+ *
+ * Returns null when the edge doesn't exist or isn't usable, so a caller can say
+ * why rather than drawing something wrong.
+ */
+declare function endplateEdgePose(outline: BenchworkPoint[] | null | undefined, edge: EndplateEdge): EndplateEdgePose | null;
 interface EndplatePose {
     /** Endplate id — "A"/"B" axial, "C"/"D"… branch. */
     id: string;
@@ -2426,6 +2493,19 @@ interface EndplatePose {
     trackConfig: "single" | "double";
     /** Lateral track offsets from the crossing anchor (0 = centred single). */
     trackOffsets: number[];
+    /** Set when this pose came from an {@link EndplateEdge} — read off the
+     * benchwork rather than stored. Its width and face are the board's own. */
+    boundToEdge?: boolean;
+    /** The face's real width, when bound to an edge. */
+    widthInches?: number;
+    /** The face's two ends, when bound to an edge — follows a tapered board. */
+    face?: [{
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    }];
     /** True when the pose was hand-entered, not derived (wye/loop/other). */
     manual?: boolean;
 }
@@ -2476,6 +2556,12 @@ interface ModuleGeometryInput {
         side: "up" | "down";
         config?: "single" | "double" | null;
     }[];
+    /** ⭐ Endplate EDGE bindings by id (ADR 0001) — an endplate that is part of
+     * the benchwork rather than a point floating beside it. Wins over
+     * `poseOverrides` and over derivation. */
+    endplateEdges?: Record<string, EndplateEdge>;
+    /** The module's benchwork polygon, needed to resolve `endplateEdges`. */
+    outline?: BenchworkPoint[] | null;
     /** Hand-entered pose overrides by endplate id — win over derivation. */
     poseOverrides?: Record<string, {
         x: number;
@@ -2564,4 +2650,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, 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 PartGeometry, type PartJoint, type PartJointRole, 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, partGeometry, partGeometryGap, partOutlineAtFrog, partsPlaceable, 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 EndplateEdge, type EndplateEdgePose, 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 PartGeometry, type PartJoint, type PartJointRole, 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, endplateEdgePose, 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, partGeometry, partGeometryGap, partOutlineAtFrog, partsPlaceable, 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

@@ -869,6 +869,10 @@ function withPoses(endplates, overrides) {
     (e) => overrides[e.id] ? { ...e, pose: overrides[e.id], poseAuthored: true } : e
   );
 }
+function withEdges(endplates, edges) {
+  if (!edges) return endplates;
+  return endplates.map((e) => edges[e.id] ? { ...e, edge: edges[e.id] } : e);
+}
 function withWidths(endplates, widths, offsets = {}) {
   return endplates.map((e) => {
     const w = widths[e.id];
@@ -900,46 +904,49 @@ function stateToDoc(state, recordNumber) {
     ...state.loop && state.loopReturn === "main2" ? { loopReturn: "main2" } : {},
     ...state.mainsSwapped ? { mainsSwapped: true } : {},
     endplates: withWidths(
-      withPoses(
-        [
-          ...state.loop ? (
-            // Balloon loop: A is the entry. A standard endplate B on the balloon
-            // makes it an INTERCHANGE (second route connects at the loop, e.g.
-            // Seaford); configB "none" makes it a pure turnback.
-            [
-              { id: "A", label: "Entry", tracks: [{ trackId: MAIN_TRACK_ID, lane: 0, config: state.configA }] },
-              ...state.configB !== "none" ? [{ id: "B", label: "Interchange", tracks: [{ trackId: MAIN_TRACK_ID, lane: 0, config: state.configB }] }] : []
-            ]
-          ) : [
-            { id: "A", label: "West", tracks: [{ trackId: MAIN_TRACK_ID, lane: 0, config: state.configA }] },
-            // ⚠️ `configB: "none"` means the module HAS NO FAR ENDPLATE, and
-            // that is not loop-only (#184). An *end of the line* or a *pocket*
-            // presents one conforming face and the track simply stops. The
-            // standard governs the ends a module offers for joining; it never
-            // required a module to offer two. This used to coerce "none" to
-            // "single" and emit a B regardless, so a single-ended module was
-            // impossible to author.
-            ...state.configB !== "none" ? [
-              {
-                id: "B",
-                label: "East",
-                tracks: [{ trackId: MAIN_TRACK_ID, lane: 0, config: state.configB }]
-              }
-            ] : []
+      withEdges(
+        withPoses(
+          [
+            ...state.loop ? (
+              // Balloon loop: A is the entry. A standard endplate B on the balloon
+              // makes it an INTERCHANGE (second route connects at the loop, e.g.
+              // Seaford); configB "none" makes it a pure turnback.
+              [
+                { id: "A", label: "Entry", tracks: [{ trackId: MAIN_TRACK_ID, lane: 0, config: state.configA }] },
+                ...state.configB !== "none" ? [{ id: "B", label: "Interchange", tracks: [{ trackId: MAIN_TRACK_ID, lane: 0, config: state.configB }] }] : []
+              ]
+            ) : [
+              { id: "A", label: "West", tracks: [{ trackId: MAIN_TRACK_ID, lane: 0, config: state.configA }] },
+              // ⚠️ `configB: "none"` means the module HAS NO FAR ENDPLATE, and
+              // that is not loop-only (#184). An *end of the line* or a *pocket*
+              // presents one conforming face and the track simply stops. The
+              // standard governs the ends a module offers for joining; it never
+              // required a module to offer two. This used to coerce "none" to
+              // "single" and emit a B regardless, so a single-ended module was
+              // impossible to author.
+              ...state.configB !== "none" ? [
+                {
+                  id: "B",
+                  label: "East",
+                  tracks: [{ trackId: MAIN_TRACK_ID, lane: 0, config: state.configB }]
+                }
+              ] : []
+            ],
+            // Branch endplates C, D, … — junction connections at pos, off one side
+            // (#170). A set can carry several (e.g. a second railroad through).
+            ...state.branches.map((b, i) => ({
+              id: String.fromCharCode(67 + i),
+              // C, D, E…
+              label: b.label || `Branch ${i + 1}`,
+              tracks: [{ trackId: MAIN_TRACK_ID, lane: 0, config: b.config }],
+              at: { pos: b.pos, side: b.side },
+              kind: b.kind ?? "branch",
+              ...b.trackId ? { trackId: b.trackId } : {}
+            }))
           ],
-          // Branch endplates C, D, … — junction connections at pos, off one side
-          // (#170). A set can carry several (e.g. a second railroad through).
-          ...state.branches.map((b, i) => ({
-            id: String.fromCharCode(67 + i),
-            // C, D, E…
-            label: b.label || `Branch ${i + 1}`,
-            tracks: [{ trackId: MAIN_TRACK_ID, lane: 0, config: b.config }],
-            at: { pos: b.pos, side: b.side },
-            kind: b.kind ?? "branch",
-            ...b.trackId ? { trackId: b.trackId } : {}
-          }))
-        ],
-        state.poseOverrides
+          state.poseOverrides
+        ),
+        state.endplateEdges
       ),
       state.endplateWidths,
       state.endplateTrackOffsets
@@ -1135,7 +1142,15 @@ function docToState(doc, fallbackLength, moduleTracks = []) {
   const poseOverrides = poseOverridesFromDoc(d);
   const endplateWidths = {};
   const endplateTrackOffsets = {};
+  const endplateEdges = {};
   for (const e of d.endplates ?? []) {
+    if (e.edge && Number.isFinite(e.edge.index) && e.edge.index >= 0)
+      endplateEdges[e.id] = {
+        index: Math.trunc(e.edge.index),
+        ...e.edge.section ? { section: e.edge.section } : {},
+        ...Number.isFinite(e.edge.fromT) ? { fromT: e.edge.fromT } : {},
+        ...Number.isFinite(e.edge.toT) ? { toT: e.edge.toT } : {}
+      };
     if (typeof e.widthInches === "number" && e.widthInches > 0)
       endplateWidths[e.id] = e.widthInches;
     if (typeof e.trackOffsetInches === "number" && Number.isFinite(e.trackOffsetInches))
@@ -1186,6 +1201,7 @@ function docToState(doc, fallbackLength, moduleTracks = []) {
     flexByTrack,
     endplateWidths,
     endplateTrackOffsets,
+    endplateEdges,
     outline,
     outlineInner,
     sectionBreaks: (d.sectionBreaks ?? []).filter((n) => Number.isFinite(n)).map((n) => sc(n)),
@@ -2532,6 +2548,45 @@ function moduleFeatures(doc) {
     laneMax: Math.max(...allLanes)
   };
 }
+function endplateEdgePose(outline, edge) {
+  if (!outline || outline.length < 3) return null;
+  const n = outline.length;
+  const i = Math.trunc(edge.index);
+  if (!Number.isFinite(i) || i < 0 || i >= n) return null;
+  const p0 = outline[i];
+  const p1 = outline[(i + 1) % n];
+  if (p0.bulge) return null;
+  const t0 = Math.max(0, Math.min(1, edge.fromT ?? 0));
+  const t1 = Math.max(0, Math.min(1, edge.toT ?? 1));
+  const a = { x: p0.x + (p1.x - p0.x) * Math.min(t0, t1), y: p0.y + (p1.y - p0.y) * Math.min(t0, t1) };
+  const b = { x: p0.x + (p1.x - p0.x) * Math.max(t0, t1), y: p0.y + (p1.y - p0.y) * Math.max(t0, t1) };
+  const w = Math.hypot(b.x - a.x, b.y - a.y);
+  if (!(w > 0)) return null;
+  let cx = 0;
+  let cy = 0;
+  for (const v of outline) {
+    cx += v.x;
+    cy += v.y;
+  }
+  cx /= n;
+  cy /= n;
+  const mid = { x: (a.x + b.x) / 2, y: (a.y + b.y) / 2 };
+  const ex = (b.x - a.x) / w;
+  const ey = (b.y - a.y) / w;
+  let nx = ey;
+  let ny = -ex;
+  if ((mid.x - cx) * nx + (mid.y - cy) * ny < 0) {
+    nx = -nx;
+    ny = -ny;
+  }
+  return {
+    x: mid.x,
+    y: mid.y,
+    heading: norm360(Math.atan2(ny, nx) * 180 / Math.PI),
+    widthInches: w,
+    face: [a, b]
+  };
+}
 function returnLoop(shape, opts) {
   const L = Math.max(1, opts.leadInches);
   const R = Math.max(1, opts.radius);
@@ -2635,6 +2690,21 @@ function deriveEndplatePoses(geo) {
   const half = geo.trackHalfSpacingInches ?? 1;
   const cfg = (i) => geo.endplateConfigs?.[i] === "double" ? "double" : "single";
   const withOverride = (p) => {
+    const bound = geo.endplateEdges?.[p.id];
+    if (bound) {
+      const outline = (bound.section ? geo.sections?.find((s) => s.id === bound.section)?.outline : geo.outline) ?? geo.outline;
+      const e = endplateEdgePose(outline, bound);
+      if (e)
+        return {
+          ...p,
+          x: e.x,
+          y: e.y,
+          heading: e.heading,
+          widthInches: e.widthInches,
+          face: e.face,
+          boundToEdge: true
+        };
+    }
     const o = geo.poseOverrides?.[p.id];
     return o ? { ...p, x: o.x, y: o.y, heading: norm360(o.heading), manual: true } : p;
   };
@@ -2806,6 +2876,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, 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, partGeometry, partGeometryGap, partOutlineAtFrog, partsPlaceable, 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, endplateEdgePose, 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, partGeometry, partGeometryGap, partOutlineAtFrog, partsPlaceable, 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