@willcgage/module-schematic 0.60.0 → 0.62.0

package/dist/index.d.cts

@@ -43,6 +43,19 @@ interface SchematicEndplate {
         y: number;
         heading: number;
     };
+    /** Whether that pose was AUTHORED — placed or typed by the owner — rather
+     * than a derived one that found its way into the doc (#182).
+     *
+     * Authorship used to be inferred from `pose` merely existing, so a derived
+     * pose written back silently PINNED the plate: it stopped following the
+     * module and went stale the moment the length changed (FMN-0068 ended up with
+     * endplate B at x=48 on a 47.9″ board). A pose is only an override when the
+     * owner meant it.
+     *
+     * Absent on A/B = derived residue, ignored. Absent on a placed branch
+     * endplate (one with `at`) = still authored — placing it IS the gesture, and
+     * docs predate this flag. */
+    poseAuthored?: boolean;
     /** Free-moN endplate FACE width across the track, inches — the physical size
      * of the standard interface at this end. Free-moN spec: 12″ minimum, 24″
      * recommended. Absent = the recommended default (modules may differ end to
@@ -394,6 +407,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 +971,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). */
@@ -1583,4 +1637,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 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, 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

@@ -43,6 +43,19 @@ interface SchematicEndplate {
         y: number;
         heading: number;
     };
+    /** Whether that pose was AUTHORED — placed or typed by the owner — rather
+     * than a derived one that found its way into the doc (#182).
+     *
+     * Authorship used to be inferred from `pose` merely existing, so a derived
+     * pose written back silently PINNED the plate: it stopped following the
+     * module and went stale the moment the length changed (FMN-0068 ended up with
+     * endplate B at x=48 on a 47.9″ board). A pose is only an override when the
+     * owner meant it.
+     *
+     * Absent on A/B = derived residue, ignored. Absent on a placed branch
+     * endplate (one with `at`) = still authored — placing it IS the gesture, and
+     * docs predate this flag. */
+    poseAuthored?: boolean;
     /** Free-moN endplate FACE width across the track, inches — the physical size
      * of the standard interface at this end. Free-moN spec: 12″ minimum, 24″
      * recommended. Absent = the recommended default (modules may differ end to
@@ -394,6 +407,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 +971,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). */
@@ -1583,4 +1637,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 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, 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,
@@ -658,7 +667,7 @@ function buildTransition(state) {
 }
 function withPoses(endplates, overrides) {
   return endplates.map(
-    (e) => overrides[e.id] ? { ...e, pose: overrides[e.id] } : e
+    (e) => overrides[e.id] ? { ...e, pose: overrides[e.id], poseAuthored: true } : e
   );
 }
 function withWidths(endplates, widths, offsets = {}) {
@@ -1680,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) => {
@@ -1713,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;
@@ -2002,16 +2031,32 @@ function trackMeetsEndplateIssues(path, pose, opts) {
 function poseNeedsManual(geometryType) {
   return geometryType === "wye" || geometryType === "other";
 }
+function isAxialPose(p) {
+  const h = norm360(p.heading);
+  return Math.abs(p.y) < 1e-6 && (Math.abs(h) < 1e-6 || Math.abs(h - 180) < 1e-6);
+}
 function poseOverridesFromDoc(doc) {
   const out = {};
   for (const e of doc.endplates ?? []) {
-    if (e.id && e.pose && typeof e.pose.x === "number" && typeof e.pose.y === "number" && typeof e.pose.heading === "number") {
+    if (e.id && e.pose && typeof e.pose.x === "number" && typeof e.pose.y === "number" && typeof e.pose.heading === "number" && // Only an AUTHORED pose overrides derivation (#182) — but docs written
+    // before the flag existed have to keep working, so authorship is inferred
+    // for the two cases that can only BE authored:
+    //   · a placed branch endplate (`at`) — dropping it on the board is the
+    //     gesture, and it has no derivable position at all;
+    //   · an OFF-AXIS pose on A/B — a hand-placed plate is off-axis by
+    //     definition (that's why it needed hand placing, e.g. a wye's B).
+    // What's left is an axial A/B pose, which is exactly the shape plain
+    // derivation produces — residue. Honouring it silently pins the plate so
+    // it stops following the module and goes stale (FMN-0068's B sat at 48 on
+    // a 47.9″ board). Anything saved from now on carries the flag, so this
+    // guesswork only ever applies to old docs.
+    (e.poseAuthored === true || !!e.at || !isAxialPose(e.pose))) {
       out[e.id] = { x: e.pose.x, y: e.pose.y, heading: e.pose.heading };
     }
   }
   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, frogCasting, 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