@willcgage/module-schematic 0.59.0 → 0.61.0

package/dist/index.d.cts

@@ -394,6 +394,13 @@ declare function samplePath(pts: BenchworkPoint[], segsPerArc?: number): {
     x: number;
     y: number;
 }[];
+/**
+ * Arc length of an authored path, inches — the path's OWN length, independent of
+ * where it sits or which way it runs. A branch route to a third endplate (#181)
+ * has no meaningful extent along the module axis (a square 90° exit projects to
+ * zero), so its own length is the only honest measure of it.
+ */
+declare function pathLengthInches(path: BenchworkPoint[] | null | undefined): number;
 /** Normalise an authored track path from a doc, or null if it isn't a real path
  * (needs ≥ 2 valid points). Keeps per-vertex bulge. */
 declare function trackPath(path: BenchworkPoint[] | null | undefined): BenchworkPoint[] | null;
@@ -951,13 +958,47 @@ interface DrawCrossover {
     toPosFrac: number;
     toLane: number;
 }
-/** A branch endplate — draw a connector stub + arrow + label off the given
- * side (the CATS/US&S off-band idiom, #170). */
+/**
+ * A route leaving the module at a third endplate (#170) — Main 3, whatever the
+ * owner labels it (#181). Drawn as an ELBOW: it diverges from its host main at
+ * `posFrac`, drops to its own `lane`, then runs to `endFrac` and ends at an
+ * endplate face.
+ *
+ * The run is the branch's OWN arc length laid along the strip, not its
+ * projection onto the module axis — a square 90° exit projects to zero, which
+ * is exactly the case that made branches invisible here. Straightening the
+ * route out at its true length is the same idiom this whole view applies to the
+ * main; `posFrac → endFrac` is therefore a real axis, and `lengthInches` maps
+ * onto it, so anything positioned along the branch has somewhere to draw.
+ */
 interface BranchConnector {
+    /** Endplate id — "C", "D", … */
     id: string;
+    /** The endplate's label. MR draws no text (the destination depends on what's
+     * physically attached, so FD derives the panel label at runtime) — this is
+     * the owner's local name, for tooltips and FD's fallback. */
     label: string;
+    /** The route's own name, from the track. */
+    name: string;
+    /** The branch track's id. */
+    trackId: string;
+    /** Whether the route IS a main (a diverging/split main) or a secondary
+     * branch line. Drives drawn weight, not geometry. */
+    kind: "branch" | "main";
+    /** Where it leaves its host main. */
     posFrac: number;
+    /** The host track's lane — a branch need not leave Main 1. Renderers must
+     * start the diverge HERE, not at a hard-coded lane 0. */
+    fromLane: number;
+    /** Which side of the module it exits. */
     side: "up" | "down";
+    /** The branch's own lane, signed by `side` and placed clear of every other
+     * lane (so it never collides) — already folded into laneMin/laneMax. */
+    lane: number;
+    /** Where the run ends, and the endplate face is drawn. */
+    endFrac: number;
+    /** The route's own arc length, inches. */
+    lengthInches: number;
 }
 /** An industry — draw a car-spot span beside its track's lane, on `side`, with
  * a name label + an optional car/length readout (#industries). */
@@ -1383,6 +1424,48 @@ declare function turnoutClosure(size: number, opts?: {
      * around 25″ on a #7 — clear of the Free-moN 22″ minimum. */
     easeInches?: number;
 }): TurnoutClosure;
+/** A frog casting's parts, in TURNOUT-LOCAL inches: `x` = distance past the
+ * points, `y` = lateral offset from the through route. */
+interface FrogCasting {
+    /** The point rail — the acute V, apex at the crossing, opening toward the
+     * diverging end. Three points: through leg, apex, diverging leg. */
+    point: Array<{
+        x: number;
+        y: number;
+    }>;
+    /** The two wing rails flanking the point, each a short polyline. */
+    wings: Array<Array<{
+        x: number;
+        y: number;
+    }>>;
+    /** The apex — where the two inner rails actually cross. */
+    apex: {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * The frog casting at a turnout's crossing.
+ *
+ * The apex is where the two INNER rails cross, which is HALF a gauge off the
+ * through centre-line (the through inner rail sits at +g/2, the diverging inner
+ * rail at d−g/2, and d = g at the frog). Not one full gauge — that is the
+ * diverging CENTRE-line, and putting the casting there floats it clear of the
+ * rails it is made of.
+ *
+ * ⚠️ **The flangeway is EXAGGERATED and that is deliberate.** True scale in N is
+ * about 0.011″ (prototype 1¾″ ÷ 160) — one pixel in a close-up render and
+ * invisible at module zoom. Drawn to scale the wing rails would sit exactly on
+ * the running rails and add nothing. `flangewayInches` defaults to a readable
+ * fraction of the gauge instead; pass the true figure if you ever need it.
+ */
+declare function frogCasting(cl: TurnoutClosure, opts?: {
+    gaugeInches?: number;
+    /** How far the casting runs either side of the apex. */
+    reachInches?: number;
+    /** See the warning above — exaggerated for legibility by default. */
+    flangewayInches?: number;
+}): FrogCasting;
 declare function divergeSideForHand(kind: TurnoutKind | undefined, stubDir: number, 
 /** The turnout is installed the other way round — the points face the far
  * direction, which swaps the side the diverging route leaves on. */
@@ -1541,4 +1624,4 @@ declare function poseOverridesFromDoc(doc: ModuleSchematicDoc): Record<string, {
     heading: number;
 }>;
 
-export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, type BenchworkPoint, type BranchConnector, CODE55_RAIL_HEIGHT_INCHES, type DimensionSource, type DrawCrossing, type DrawCrossover, type DrawIndustry, type DrawSignal, type DrawTrack, type DrawTurnout, ENDPLATE_FASCIA_CLEAR_INCHES, ENDPLATE_LEAD_INCHES, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorIndustry, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplatePose, type EndplateTrackIssue, type EndplateWidthIssue, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type GeometryType, type ImportedPart, type IndustryLabelMode, type IndustrySpot, MAIN2_TRACK_ID, MAIN_TRACK_ID, type ModuleFeatures, type ModuleFootprint, type ModuleFootprintInput, type ModuleGeometryInput, type ModuleSchematicDoc, type ModuleTrackRow, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, type OutlineFace, type PartAngle, type PartDimension, type PartEnd, type PartSegment, RAIL_GAUGE_INCHES, type ReturnLoopGeometry, type ReturnLoopShape, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicIndustry, type SchematicSection, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SectionAdjacency, type SectionFootprint, type SectionRelativePos, type SignalFacing, type SignalSide, TURNOUT_LEAD_INCHES_PER_FROG, type TrackConfig, type TrackPart, type TrackRole, type TurnoutClosure, type TurnoutKind, WHOLE_MODULE_SECTION_ID, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateLead, endplateTrackOffsetFor, endplateTrackOffsetInches, endplateWidthInches, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, leadInchesForSize, mergeImportedParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partOutlineAtFrog, poseNeedsManual, poseOverridesFromDoc, remapPos, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, stateToDoc, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutPartForSize };
+export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, type BenchworkPoint, type BranchConnector, CODE55_RAIL_HEIGHT_INCHES, type DimensionSource, type DrawCrossing, type DrawCrossover, type DrawIndustry, type DrawSignal, type DrawTrack, type DrawTurnout, ENDPLATE_FASCIA_CLEAR_INCHES, ENDPLATE_LEAD_INCHES, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorIndustry, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplatePose, type EndplateTrackIssue, type EndplateWidthIssue, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type FrogCasting, type GeometryType, type ImportedPart, type IndustryLabelMode, type IndustrySpot, MAIN2_TRACK_ID, MAIN_TRACK_ID, type ModuleFeatures, type ModuleFootprint, type ModuleFootprintInput, type ModuleGeometryInput, type ModuleSchematicDoc, type ModuleTrackRow, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, type OutlineFace, type PartAngle, type PartDimension, type PartEnd, type PartSegment, RAIL_GAUGE_INCHES, type ReturnLoopGeometry, type ReturnLoopShape, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicIndustry, type SchematicSection, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SectionAdjacency, type SectionFootprint, type SectionRelativePos, type SignalFacing, type SignalSide, TURNOUT_LEAD_INCHES_PER_FROG, type TrackConfig, type TrackPart, type TrackRole, type TurnoutClosure, type TurnoutKind, WHOLE_MODULE_SECTION_ID, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateLead, endplateTrackOffsetFor, endplateTrackOffsetInches, endplateWidthInches, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, leadInchesForSize, mergeImportedParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partOutlineAtFrog, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, stateToDoc, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutPartForSize };

package/dist/index.d.ts

@@ -394,6 +394,13 @@ declare function samplePath(pts: BenchworkPoint[], segsPerArc?: number): {
     x: number;
     y: number;
 }[];
+/**
+ * Arc length of an authored path, inches — the path's OWN length, independent of
+ * where it sits or which way it runs. A branch route to a third endplate (#181)
+ * has no meaningful extent along the module axis (a square 90° exit projects to
+ * zero), so its own length is the only honest measure of it.
+ */
+declare function pathLengthInches(path: BenchworkPoint[] | null | undefined): number;
 /** Normalise an authored track path from a doc, or null if it isn't a real path
  * (needs ≥ 2 valid points). Keeps per-vertex bulge. */
 declare function trackPath(path: BenchworkPoint[] | null | undefined): BenchworkPoint[] | null;
@@ -951,13 +958,47 @@ interface DrawCrossover {
     toPosFrac: number;
     toLane: number;
 }
-/** A branch endplate — draw a connector stub + arrow + label off the given
- * side (the CATS/US&S off-band idiom, #170). */
+/**
+ * A route leaving the module at a third endplate (#170) — Main 3, whatever the
+ * owner labels it (#181). Drawn as an ELBOW: it diverges from its host main at
+ * `posFrac`, drops to its own `lane`, then runs to `endFrac` and ends at an
+ * endplate face.
+ *
+ * The run is the branch's OWN arc length laid along the strip, not its
+ * projection onto the module axis — a square 90° exit projects to zero, which
+ * is exactly the case that made branches invisible here. Straightening the
+ * route out at its true length is the same idiom this whole view applies to the
+ * main; `posFrac → endFrac` is therefore a real axis, and `lengthInches` maps
+ * onto it, so anything positioned along the branch has somewhere to draw.
+ */
 interface BranchConnector {
+    /** Endplate id — "C", "D", … */
     id: string;
+    /** The endplate's label. MR draws no text (the destination depends on what's
+     * physically attached, so FD derives the panel label at runtime) — this is
+     * the owner's local name, for tooltips and FD's fallback. */
     label: string;
+    /** The route's own name, from the track. */
+    name: string;
+    /** The branch track's id. */
+    trackId: string;
+    /** Whether the route IS a main (a diverging/split main) or a secondary
+     * branch line. Drives drawn weight, not geometry. */
+    kind: "branch" | "main";
+    /** Where it leaves its host main. */
     posFrac: number;
+    /** The host track's lane — a branch need not leave Main 1. Renderers must
+     * start the diverge HERE, not at a hard-coded lane 0. */
+    fromLane: number;
+    /** Which side of the module it exits. */
     side: "up" | "down";
+    /** The branch's own lane, signed by `side` and placed clear of every other
+     * lane (so it never collides) — already folded into laneMin/laneMax. */
+    lane: number;
+    /** Where the run ends, and the endplate face is drawn. */
+    endFrac: number;
+    /** The route's own arc length, inches. */
+    lengthInches: number;
 }
 /** An industry — draw a car-spot span beside its track's lane, on `side`, with
  * a name label + an optional car/length readout (#industries). */
@@ -1383,6 +1424,48 @@ declare function turnoutClosure(size: number, opts?: {
      * around 25″ on a #7 — clear of the Free-moN 22″ minimum. */
     easeInches?: number;
 }): TurnoutClosure;
+/** A frog casting's parts, in TURNOUT-LOCAL inches: `x` = distance past the
+ * points, `y` = lateral offset from the through route. */
+interface FrogCasting {
+    /** The point rail — the acute V, apex at the crossing, opening toward the
+     * diverging end. Three points: through leg, apex, diverging leg. */
+    point: Array<{
+        x: number;
+        y: number;
+    }>;
+    /** The two wing rails flanking the point, each a short polyline. */
+    wings: Array<Array<{
+        x: number;
+        y: number;
+    }>>;
+    /** The apex — where the two inner rails actually cross. */
+    apex: {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * The frog casting at a turnout's crossing.
+ *
+ * The apex is where the two INNER rails cross, which is HALF a gauge off the
+ * through centre-line (the through inner rail sits at +g/2, the diverging inner
+ * rail at d−g/2, and d = g at the frog). Not one full gauge — that is the
+ * diverging CENTRE-line, and putting the casting there floats it clear of the
+ * rails it is made of.
+ *
+ * ⚠️ **The flangeway is EXAGGERATED and that is deliberate.** True scale in N is
+ * about 0.011″ (prototype 1¾″ ÷ 160) — one pixel in a close-up render and
+ * invisible at module zoom. Drawn to scale the wing rails would sit exactly on
+ * the running rails and add nothing. `flangewayInches` defaults to a readable
+ * fraction of the gauge instead; pass the true figure if you ever need it.
+ */
+declare function frogCasting(cl: TurnoutClosure, opts?: {
+    gaugeInches?: number;
+    /** How far the casting runs either side of the apex. */
+    reachInches?: number;
+    /** See the warning above — exaggerated for legibility by default. */
+    flangewayInches?: number;
+}): FrogCasting;
 declare function divergeSideForHand(kind: TurnoutKind | undefined, stubDir: number, 
 /** The turnout is installed the other way round — the points face the far
  * direction, which swaps the side the diverging route leaves on. */
@@ -1541,4 +1624,4 @@ declare function poseOverridesFromDoc(doc: ModuleSchematicDoc): Record<string, {
     heading: number;
 }>;
 
-export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, type BenchworkPoint, type BranchConnector, CODE55_RAIL_HEIGHT_INCHES, type DimensionSource, type DrawCrossing, type DrawCrossover, type DrawIndustry, type DrawSignal, type DrawTrack, type DrawTurnout, ENDPLATE_FASCIA_CLEAR_INCHES, ENDPLATE_LEAD_INCHES, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorIndustry, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplatePose, type EndplateTrackIssue, type EndplateWidthIssue, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type GeometryType, type ImportedPart, type IndustryLabelMode, type IndustrySpot, MAIN2_TRACK_ID, MAIN_TRACK_ID, type ModuleFeatures, type ModuleFootprint, type ModuleFootprintInput, type ModuleGeometryInput, type ModuleSchematicDoc, type ModuleTrackRow, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, type OutlineFace, type PartAngle, type PartDimension, type PartEnd, type PartSegment, RAIL_GAUGE_INCHES, type ReturnLoopGeometry, type ReturnLoopShape, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicIndustry, type SchematicSection, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SectionAdjacency, type SectionFootprint, type SectionRelativePos, type SignalFacing, type SignalSide, TURNOUT_LEAD_INCHES_PER_FROG, type TrackConfig, type TrackPart, type TrackRole, type TurnoutClosure, type TurnoutKind, WHOLE_MODULE_SECTION_ID, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateLead, endplateTrackOffsetFor, endplateTrackOffsetInches, endplateWidthInches, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, leadInchesForSize, mergeImportedParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partOutlineAtFrog, poseNeedsManual, poseOverridesFromDoc, remapPos, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, stateToDoc, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutPartForSize };
+export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, type BenchworkPoint, type BranchConnector, CODE55_RAIL_HEIGHT_INCHES, type DimensionSource, type DrawCrossing, type DrawCrossover, type DrawIndustry, type DrawSignal, type DrawTrack, type DrawTurnout, ENDPLATE_FASCIA_CLEAR_INCHES, ENDPLATE_LEAD_INCHES, type EditorBranch, type EditorControlPoint, type EditorCpSignal, type EditorCrossing, type EditorIndustry, type EditorState, type EditorTrack, type EditorTurnout, type EndplateBConfig, type EndplatePose, type EndplateTrackIssue, type EndplateWidthIssue, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, type FrogCasting, type GeometryType, type ImportedPart, type IndustryLabelMode, type IndustrySpot, MAIN2_TRACK_ID, MAIN_TRACK_ID, type ModuleFeatures, type ModuleFootprint, type ModuleFootprintInput, type ModuleGeometryInput, type ModuleSchematicDoc, type ModuleTrackRow, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, type OutlineFace, type PartAngle, type PartDimension, type PartEnd, type PartSegment, RAIL_GAUGE_INCHES, type ReturnLoopGeometry, type ReturnLoopShape, type SchematicBlock, type SchematicControlPoint, type SchematicCrossing, type SchematicEndplate, type SchematicEndplateTrack, type SchematicIndustry, type SchematicSection, type SchematicSignal, type SchematicTrack, type SchematicTurnout, type SectionAdjacency, type SectionFootprint, type SectionRelativePos, type SignalFacing, type SignalSide, TURNOUT_LEAD_INCHES_PER_FROG, type TrackConfig, type TrackPart, type TrackRole, type TurnoutClosure, type TurnoutKind, WHOLE_MODULE_SECTION_ID, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateLead, endplateTrackOffsetFor, endplateTrackOffsetInches, endplateWidthInches, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, leadInchesForSize, mergeImportedParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partOutlineAtFrog, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, stateToDoc, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutPartForSize };

package/dist/index.js

@@ -115,6 +115,15 @@ function samplePath(pts, segsPerArc = 20) {
   out.push({ x: pts[n - 1].x, y: pts[n - 1].y });
   return out;
 }
+function pathLengthInches(path) {
+  const pts = trackPath(path);
+  if (!pts) return 0;
+  const poly = samplePath(pts);
+  let total = 0;
+  for (let i = 1; i < poly.length; i++)
+    total += Math.hypot(poly[i].x - poly[i - 1].x, poly[i].y - poly[i - 1].y);
+  return total;
+}
 function trackPath(path) {
   const pts = (path ?? []).filter((p) => p && Number.isFinite(p.x) && Number.isFinite(p.y)).map((p) => ({
     x: p.x,
@@ -1473,6 +1482,32 @@ function turnoutClosure(size, opts = {}) {
     }
   };
 }
+function frogCasting(cl, opts = {}) {
+  const g = opts.gaugeInches ?? RAIL_GAUGE_INCHES;
+  const w = opts.reachInches ?? g * 1.5;
+  const fw = opts.flangewayInches ?? g * 0.12;
+  const m = cl.frogSlope;
+  const lead = cl.lead;
+  const apex = { x: lead, y: g / 2 };
+  const point = [
+    { x: lead + w, y: g / 2 },
+    apex,
+    { x: lead + w, y: g / 2 + m * w }
+  ];
+  const wings = [
+    [
+      { x: lead - w, y: g / 2 - fw },
+      { x: lead - w * 0.35, y: g / 2 - fw },
+      { x: lead + w * 0.35, y: g / 2 - fw * 0.5 }
+    ],
+    [
+      { x: lead - w, y: g / 2 + m * -w + fw },
+      { x: lead - w * 0.35, y: g / 2 + m * -w * 0.35 + fw },
+      { x: lead + w * 0.35, y: g / 2 + m * w * 0.35 + fw * 0.5 }
+    ]
+  ];
+  return { point, wings, apex };
+}
 function divergeSideForHand(kind, stubDir, flipped) {
   if (kind !== "left" && kind !== "right") return 0;
   const s = (stubDir >= 0 ? 1 : -1) * (flipped ? -1 : 1);
@@ -1539,7 +1574,7 @@ function moduleFeatures(doc) {
       if (parentLane === 0) {
         const [from, to] = ext;
         const far = Math.abs(to - sw.pos) >= Math.abs(from - sw.pos) ? to : from;
-        const s = divergeSideForHand(sw.kind, far - sw.pos);
+        const s = divergeSideForHand(sw.kind, far - sw.pos, sw.flipped);
         sign = s !== 0 ? s : Math.sign(trk.lane) || 1;
       } else {
         sign = Math.sign(parentLane) || 1;
@@ -1654,15 +1689,43 @@ function moduleFeatures(doc) {
     laneA: trackLane.get(x.tracks?.[0] ?? "") ?? 0,
     laneB: trackLane.get(x.tracks?.[1] ?? "") ?? 1
   }));
+  const main2Lane = trackLane.has(MAIN2_TRACK_ID) ? trackLane.get(MAIN2_TRACK_ID) : null;
+  const baseLanes = [
+    0,
+    main2Lane ?? (doubleMain ? 1 : 0),
+    ...extraTracks.map((t) => t.lane),
+    ...signals.map((s) => s.lane),
+    ...crossings.flatMap((x) => [x.laneA, x.laneB]),
+    ...crossovers.flatMap((x) => [x.fromLane, x.toLane])
+  ];
+  let upLane = Math.max(...baseLanes, 0);
+  let downLane = Math.min(...baseLanes, 0);
   const branchConnectors = doc.endplates.filter(
     (e) => e.id !== "A" && e.id !== "B" && e.at && !!e.trackId && (doc.tracks ?? []).some((t) => t.id === e.trackId)
   ).map((e) => {
+    const trk = (doc.tracks ?? []).find((t) => t.id === e.trackId);
     const sw = (doc.turnouts ?? []).find((t) => t.divergeTrack === e.trackId);
+    const startPos = sw ? sw.pos : e.at.pos;
+    const side = e.at.side === "down" ? "down" : "up";
+    const lane = side === "down" ? --downLane : ++upLane;
+    const runInches = pathLengthInches(trk.path) || Math.abs(e.at.pos - startPos) || FREEMO_ENDPLATE_WIDTH_MIN_INCHES;
+    const toB = e.at.pos >= startPos;
+    const fits = (p) => p >= 0 && p <= len;
+    const ahead = startPos + runInches;
+    const behind = startPos - runInches;
+    const endPos = toB && fits(ahead) ? ahead : !toB && fits(behind) ? behind : fits(toB ? behind : ahead) ? toB ? behind : ahead : ahead;
     return {
       id: e.id,
       label: e.label ?? e.id,
-      posFrac: clampFrac(sw ? sw.pos : e.at.pos),
-      side: e.at.side === "down" ? "down" : "up"
+      name: trk.trackName ?? "",
+      trackId: trk.id,
+      kind: e.kind === "main" ? "main" : "branch",
+      posFrac: clampFrac(startPos),
+      fromLane: sw ? trackLane.get(sw.onTrack) ?? 0 : 0,
+      side,
+      lane,
+      endFrac: clampFrac(endPos),
+      lengthInches: runInches
     };
   });
   const industries = (doc.industries ?? []).flatMap((ind) => {
@@ -1687,15 +1750,7 @@ function moduleFeatures(doc) {
       };
     });
   });
-  const main2Lane = trackLane.has(MAIN2_TRACK_ID) ? trackLane.get(MAIN2_TRACK_ID) : null;
-  const allLanes = [
-    0,
-    main2Lane ?? (doubleMain ? 1 : 0),
-    ...extraTracks.map((t) => t.lane),
-    ...signals.map((s) => s.lane),
-    ...crossings.flatMap((x) => [x.laneA, x.laneB]),
-    ...crossovers.flatMap((x) => [x.fromLane, x.toLane])
-  ];
+  const allLanes = [...baseLanes, ...branchConnectors.map((b) => b.lane)];
   const loop = isLoopDoc(doc);
   const main2 = doc.tracks.find((t) => t.id === MAIN2_TRACK_ID);
   const main2Positioned = !!main2 && (main2.fromPos != null || main2.toPos != null) && !loop;
@@ -1986,6 +2041,6 @@ function poseOverridesFromDoc(doc) {
   return out;
 }
 
-export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, CODE55_RAIL_HEIGHT_INCHES, ENDPLATE_FASCIA_CLEAR_INCHES, ENDPLATE_LEAD_INCHES, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, MAIN2_TRACK_ID, MAIN_TRACK_ID, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, RAIL_GAUGE_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, WHOLE_MODULE_SECTION_ID, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateLead, endplateTrackOffsetFor, endplateTrackOffsetInches, endplateWidthInches, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, leadInchesForSize, mergeImportedParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partOutlineAtFrog, poseNeedsManual, poseOverridesFromDoc, remapPos, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, stateToDoc, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutPartForSize };
+export { ATLAS_CODE55_N, BUILT_IN_TRACK_PARTS, CODE55_RAIL_HEIGHT_INCHES, ENDPLATE_FASCIA_CLEAR_INCHES, ENDPLATE_LEAD_INCHES, FREEMO_ENDPLATE_TRACK_FASCIA_CLEARANCE_INCHES, FREEMO_ENDPLATE_WIDTH_MIN_INCHES, FREEMO_ENDPLATE_WIDTH_RECOMMENDED_INCHES, FREEMO_TRACK_SPACING_INCHES, MAIN2_TRACK_ID, MAIN_TRACK_ID, N_CAR_LENGTH_INCHES, N_SCALE_RATIO, RAIL_GAUGE_INCHES, TURNOUT_LEAD_INCHES_PER_FROG, WHOLE_MODULE_SECTION_ID, asModuleSchematic, benchworkBand, benchworkOutline, buildCrossover, buildPassingSiding, buildTransition, carCapacity, checkEndplateWidth, deriveEndplatePoses, divergeSideForHand, docToState, emptyEditorState, endplateFaceSegments, endplateLead, endplateTrackOffsetFor, endplateTrackOffsetInches, endplateWidthInches, frogCasting, frogNumberFromName, fromSectionRelative, geometryTurnDegrees, importedPartToTrackPart, inchesToScaleFeet, isLoopDoc, isTransitionTurnout, leadInchesForSize, mergeImportedParts, moduleCenterline, moduleFeatures, moduleFootprint, moduleLengthFromSections, moduleSections, nextId, parseXtpLibrary, partOutlineAtFrog, pathLengthInches, poseNeedsManual, poseOverridesFromDoc, remapPos, returnLoop, sampleBenchworkOutline, samplePartSegments, samplePath, scaleFeetToInches, sectionAdjacency, sectionBand, sectionBreaksFromSections, sectionComponents, sectionFootprints, sectionNeighbours, sectionSpans, sectionSpansOrWhole, sectionedCenterline, sectionedEndPose, sliceCenterline, stateToDoc, toSectionRelative, trackMeetsEndplateIssues, trackPart, trackPath, turnoutClosure, turnoutPartForSize };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map