@willcgage/module-schematic 0.57.0 → 0.59.0

package/dist/index.d.cts

@@ -132,6 +132,11 @@ interface SchematicTurnout {
      * forces it: the body has nowhere to go but back toward the module, so the
      * derived facing comes out backwards. */
     flipped?: boolean | null;
+    /** The library part this turnout IS — e.g. "atlas-c55-n-7". Binds a drawn
+     * turnout to real geometry: with it the renderer can draw the part's own
+     * outline instead of a shape derived from `size`. Absent means "just a #N",
+     * which is what every turnout authored before the parts library was. */
+    partId?: string | null;
 }
 interface SchematicSignal {
     id: string;
@@ -705,6 +710,8 @@ interface EditorTurnout {
     size?: number;
     /** Rotate the turnout 180° — the points face the other way (#turnout-flip). */
     flipped?: boolean;
+    /** The library part this turnout IS — see SchematicTurnout.partId. */
+    partId?: string;
     /** A curved turnout — the diverging route bows into an arc rather than a
      * straight diagonal. Physical-render only (the operations view is topological). */
     curved?: boolean;
@@ -1299,6 +1306,24 @@ declare function importedPartToTrackPart(part: ImportedPart, sourceName?: string
  * Matching is by manufacturer part number first, then manufacturer + frog number.
  */
 declare function mergeImportedParts(imported: ImportedPart[], library?: TrackPart[], sourceName?: string): TrackPart[];
+/**
+ * A part's drawn outline in TURNOUT-LOCAL coordinates, ready for MR to map onto
+ * a lane: `x` = inches along the through route measured **from the frog**
+ * (negative back toward the points), `y` = lateral offset with the DIVERGING
+ * side positive. That is the same frame {@link turnoutClosure} works in, so a
+ * renderer can swap one for the other.
+ *
+ * ⚠️ **Anchored on OUR measured lead, not the file's frog.** The part is placed
+ * so its points sit `leadInches` back from the frog, because `pos` means the
+ * frog (#132) and our leads are physical measurements while the shipped Atlas
+ * `.xtp`'s frog positions are internally inconsistent. A consequence worth
+ * knowing: if the file's own geometry disagrees, its drawn V will not land on
+ * the frog marker — and that visible gap IS the validation. Don't "fix" it by
+ * anchoring on the file.
+ *
+ * Returns null when the part carries no geometry to draw.
+ */
+declare function partOutlineAtFrog(part: TrackPart, leadInches: number, stepsPerCurve?: number): BenchworkPoint[][] | null;
 /** A turnout's CLOSURE — the diverging route's lateral offset from the through
  * route, from the points (s = 0) to the frog (s = lead) and beyond.
  *
@@ -1329,10 +1354,34 @@ interface TurnoutClosure {
     switchSlope: number;
     /** Slope at and beyond the frog — the frog angle, 1/N. */
     frogSlope: number;
+    /** Total run from the points to where the route arrives PARALLEL at
+     * `arriveAtInches`. Infinity when no target was given (the legacy
+     * straight-forever behaviour). Use this rather than solving for the offset:
+     * solving finds where the route REACHES the lane, not where it arrives
+     * parallel, and the difference is a visible kink. */
+    span: number;
+    /** Length of the easing curve, 0 when not easing. */
+    easeInches: number;
 }
 declare function turnoutClosure(size: number, opts?: {
     leadInches?: number;
     gaugeInches?: number;
+    /**
+     * Lateral offset the diverging route must ARRIVE AT, PARALLEL — normally
+     * one lane spacing, i.e. the track it feeds.
+     *
+     * ⚠️ Without this the route runs straight at the frog angle forever, and a
+     * caller can only solve for where it first REACHES the offset. Reaching is
+     * not arriving: it gets there still climbing at 1/N while the track it
+     * joins runs parallel, so the two meet with an instantaneous change of
+     * direction. That KINK is what reads as "the rails don't line up" — each
+     * rail is offset perpendicular to its own heading, so at a kink the two
+     * rails meet at different points.
+     */
+    arriveAtInches?: number;
+    /** Length of the easing curve. Defaults to one lead, which puts the radius
+     * around 25″ on a #7 — clear of the Free-moN 22″ minimum. */
+    easeInches?: number;
 }): TurnoutClosure;
 declare function divergeSideForHand(kind: TurnoutKind | undefined, stubDir: number, 
 /** The turnout is installed the other way round — the points face the far
@@ -1492,4 +1541,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, 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 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 };

package/dist/index.d.ts

@@ -132,6 +132,11 @@ interface SchematicTurnout {
      * forces it: the body has nowhere to go but back toward the module, so the
      * derived facing comes out backwards. */
     flipped?: boolean | null;
+    /** The library part this turnout IS — e.g. "atlas-c55-n-7". Binds a drawn
+     * turnout to real geometry: with it the renderer can draw the part's own
+     * outline instead of a shape derived from `size`. Absent means "just a #N",
+     * which is what every turnout authored before the parts library was. */
+    partId?: string | null;
 }
 interface SchematicSignal {
     id: string;
@@ -705,6 +710,8 @@ interface EditorTurnout {
     size?: number;
     /** Rotate the turnout 180° — the points face the other way (#turnout-flip). */
     flipped?: boolean;
+    /** The library part this turnout IS — see SchematicTurnout.partId. */
+    partId?: string;
     /** A curved turnout — the diverging route bows into an arc rather than a
      * straight diagonal. Physical-render only (the operations view is topological). */
     curved?: boolean;
@@ -1299,6 +1306,24 @@ declare function importedPartToTrackPart(part: ImportedPart, sourceName?: string
  * Matching is by manufacturer part number first, then manufacturer + frog number.
  */
 declare function mergeImportedParts(imported: ImportedPart[], library?: TrackPart[], sourceName?: string): TrackPart[];
+/**
+ * A part's drawn outline in TURNOUT-LOCAL coordinates, ready for MR to map onto
+ * a lane: `x` = inches along the through route measured **from the frog**
+ * (negative back toward the points), `y` = lateral offset with the DIVERGING
+ * side positive. That is the same frame {@link turnoutClosure} works in, so a
+ * renderer can swap one for the other.
+ *
+ * ⚠️ **Anchored on OUR measured lead, not the file's frog.** The part is placed
+ * so its points sit `leadInches` back from the frog, because `pos` means the
+ * frog (#132) and our leads are physical measurements while the shipped Atlas
+ * `.xtp`'s frog positions are internally inconsistent. A consequence worth
+ * knowing: if the file's own geometry disagrees, its drawn V will not land on
+ * the frog marker — and that visible gap IS the validation. Don't "fix" it by
+ * anchoring on the file.
+ *
+ * Returns null when the part carries no geometry to draw.
+ */
+declare function partOutlineAtFrog(part: TrackPart, leadInches: number, stepsPerCurve?: number): BenchworkPoint[][] | null;
 /** A turnout's CLOSURE — the diverging route's lateral offset from the through
  * route, from the points (s = 0) to the frog (s = lead) and beyond.
  *
@@ -1329,10 +1354,34 @@ interface TurnoutClosure {
     switchSlope: number;
     /** Slope at and beyond the frog — the frog angle, 1/N. */
     frogSlope: number;
+    /** Total run from the points to where the route arrives PARALLEL at
+     * `arriveAtInches`. Infinity when no target was given (the legacy
+     * straight-forever behaviour). Use this rather than solving for the offset:
+     * solving finds where the route REACHES the lane, not where it arrives
+     * parallel, and the difference is a visible kink. */
+    span: number;
+    /** Length of the easing curve, 0 when not easing. */
+    easeInches: number;
 }
 declare function turnoutClosure(size: number, opts?: {
     leadInches?: number;
     gaugeInches?: number;
+    /**
+     * Lateral offset the diverging route must ARRIVE AT, PARALLEL — normally
+     * one lane spacing, i.e. the track it feeds.
+     *
+     * ⚠️ Without this the route runs straight at the frog angle forever, and a
+     * caller can only solve for where it first REACHES the offset. Reaching is
+     * not arriving: it gets there still climbing at 1/N while the track it
+     * joins runs parallel, so the two meet with an instantaneous change of
+     * direction. That KINK is what reads as "the rails don't line up" — each
+     * rail is offset perpendicular to its own heading, so at a kink the two
+     * rails meet at different points.
+     */
+    arriveAtInches?: number;
+    /** Length of the easing curve. Defaults to one lead, which puts the radius
+     * around 25″ on a #7 — clear of the Free-moN 22″ minimum. */
+    easeInches?: number;
 }): TurnoutClosure;
 declare function divergeSideForHand(kind: TurnoutKind | undefined, stubDir: number, 
 /** The turnout is installed the other way round — the points face the far
@@ -1492,4 +1541,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, 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 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 };

package/dist/index.js

@@ -767,7 +767,8 @@ function stateToDoc(state, recordNumber) {
       name: t.name || void 0,
       ...t.size ? { size: t.size } : {},
       ...t.curved ? { curved: true } : {},
-      ...t.flipped ? { flipped: true } : {}
+      ...t.flipped ? { flipped: true } : {},
+      ...t.partId ? { partId: t.partId } : {}
     })),
     ...state.crossings.length > 0 ? {
       crossings: state.crossings.map((x) => ({
@@ -955,7 +956,8 @@ function docToState(doc, fallbackLength, moduleTracks = []) {
       kind: t.kind ?? "right",
       ...t.size ? { size: t.size } : {},
       ...t.curved ? { curved: true } : {},
-      ...t.flipped ? { flipped: true } : {}
+      ...t.flipped ? { flipped: true } : {},
+      ...t.partId ? { partId: t.partId } : {}
     })),
     controlPoints: readControlPoints(d, sc),
     industries: (d.industries ?? []).map((ind) => ({
@@ -1397,6 +1399,44 @@ function mergeImportedParts(imported, library = BUILT_IN_TRACK_PARTS, sourceName
   }
   return out;
 }
+function partOutlineAtFrog(part, leadInches, stepsPerCurve = 16) {
+  const ends = part.ends ?? [];
+  const segs = part.segments ?? [];
+  if (!segs.length || ends.length < 2) return null;
+  let points = ends[0];
+  if (ends.length >= 3) {
+    let bestPair = Infinity;
+    let pairIdx = [1, 2];
+    for (let i = 0; i < ends.length; i++) {
+      for (let j = i + 1; j < ends.length; j++) {
+        const d = Math.hypot(ends[i].x - ends[j].x, ends[i].y - ends[j].y);
+        if (d < bestPair) {
+          bestPair = d;
+          pairIdx = [i, j];
+        }
+      }
+    }
+    const odd = ends.findIndex((_, k) => k !== pairIdx[0] && k !== pairIdx[1]);
+    if (odd >= 0) points = ends[odd];
+  }
+  const a = points.angleDeg * Math.PI / 180;
+  const ux = -Math.sin(a);
+  const uy = -Math.cos(a);
+  const toLocal = (p) => {
+    const dx = p.x - points.x;
+    const dy = p.y - points.y;
+    return { x: dx * ux + dy * uy, y: dx * -uy + dy * ux };
+  };
+  let sign = 1;
+  const offAxis = ends.filter((e) => e !== points).map(toLocal).sort((p, q) => Math.abs(q.y) - Math.abs(p.y))[0];
+  if (offAxis && offAxis.y < 0) sign = -1;
+  return samplePartSegments(segs, stepsPerCurve).map(
+    (poly) => poly.map((p) => {
+      const l = toLocal(p);
+      return { x: l.x - leadInches, y: l.y * sign };
+    })
+  );
+}
 function turnoutClosure(size, opts = {}) {
   const N = size > 0 ? size : 6;
   const g = opts.gaugeInches ?? RAIL_GAUGE_INCHES;
@@ -1404,13 +1444,33 @@ function turnoutClosure(size, opts = {}) {
   const frogSlope = 1 / N;
   const k = (lead / N - g) / (lead * lead);
   const switchSlope = Math.max(0, frogSlope - 2 * k * lead);
+  const target = opts.arriveAtInches;
+  let a = Infinity;
+  let b = 0;
+  if (target != null && target > g) {
+    b = Math.max(0.01, opts.easeInches ?? lead);
+    a = (target - g) / frogSlope - b / 2;
+    if (a < 0) {
+      a = 0;
+      b = 2 * (target - g) / frogSlope;
+    }
+  }
+  const span = target != null && target > g ? lead + a + b : Infinity;
   return {
     lead,
     switchSlope,
     frogSlope,
-    // Past the frog the route is straight at the frog angle — the closure curve
-    // has done its work, so don't keep bending (that's the tangent Option 1).
-    offsetAt: (s) => s <= lead ? switchSlope * s + k * s * s : g + frogSlope * (s - lead)
+    span,
+    easeInches: b,
+    offsetAt: (s) => {
+      if (s <= lead) return switchSlope * s + k * s * s;
+      const past = s - lead;
+      if (past <= a) return g + frogSlope * past;
+      if (target == null) return g + frogSlope * past;
+      const u = Math.min(past - a, b);
+      const eased = g + frogSlope * a + frogSlope * u - frogSlope * u * u / (2 * b);
+      return past - a >= b ? target : eased;
+    }
   };
 }
 function divergeSideForHand(kind, stubDir, flipped) {
@@ -1926,6 +1986,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, 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, 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 };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map